项目进度追踪
当前阶段：P3 — 体验增强
Phase 1-3 — 全部完成 ✅
P0 — 全局优化（全部完成 ✅）
| 子项 |
说明 |
状态 |
| P0a |
i18n 基础设施 + 翻译文件 + LanguageProvider + useT hook |
✅ |
| P0b |
UI 统一 — Design Token + 共享组件库 |
✅ |
| P0c |
逐页翻译 + 语言切换 — 沙盒页面 useT 化 |
✅ |
| P0d |
会员定价页重构（用量可视化） |
✅ |
| P0e |
模型选择器升级（卡片式 + 能力标签） |
✅ |
| P0f |
会话分享链接 — HMAC 签名 + 分享查看页 |
✅ |
P1 — 学习技能包（全部完成 ✅）
| 子项 |
说明 |
状态 |
| 后端 |
SkillsModule + 8 技能定义 + 过滤/详情 API |
✅ |
| 前端 |
/skills 市场 + /skills/[id] 详情 + header 入口 |
✅ |
| 沙盒集成 |
替代硬编码 SCENES，从 API 动态加载，?skill=xxx 支持 |
✅ |
P2 — CSS 统一（全部完成 ✅）
| 子项 |
说明 |
状态 |
| Mobile variables.css |
Design Token 变量定义（Web/Mobile 统一） |
✅ |
| Mobile 全站 18 页 |
批量替换 hardcoded color → CSS vars |
✅ |
| PC 响应式 |
header/compare/sandbox/member/workshop 移动端修复 |
✅ |
P3 — 体验增强（全部完成 ✅）
| 优先级 |
项目 |
说明 |
状态 |
| P4a |
多模态 — 图片上传 + 沙盒 Vision |
✅ 完成 |
|
| P4b |
代码语法高亮 |
highlight.js + CodeBlock 组件 |
✅ |
| P3c |
会话重命名 |
PATCH endpoint + 双击编辑 |
✅ |
| — |
SDK / 共享 UI 包 |
远期规划 |
📋 |
参考来源
- opencode 源码克隆到
/tmp/opencode-source/（21 packages, 147MB）
P4 — 支付闭环（进行中 🔄）
| 子项 |
说明 |
状态 |
| P4a |
Mock 支付自动完成 — PaymentService.completeMockPayment() + OrdersService 检测 mock 结果后自动调用 |
✅ |
| P4b |
会员页面 mock 提示优化 — 显示"订阅成功"而非"请扫码支付" |
✅ |
| P4c |
真实微信支付证书部署 — 商户证书/密钥已安装到 backend/cert/key/，参数与 .env 一致 |
✅ |
| P4d |
下单切 NATIVE 扫码支付 — 默认 tradeType: 'NATIVE'，前端展示二维码 Modal + 轮询支付状态 |
✅ |
| P4e |
JSAPI 支付集成 — 检测微信环境 + openid，在 Mini Program web-view 内自动调起 WeixinJSBridge；其他场景 NATIVE 兜底 |
✅ |
| — |
订阅到期提醒 / 自动续费 |
📋 远期 |
| — |
获取公众号 appid 后补充 Web OAuth 流程 |
📋 待定 |
P5 — 运营助手（已完成 ✅）
| 子项 |
说明 |
状态 |
| P5a |
新增 POST /admin/ai-assistant/chat 端点 — 管理员专用 AI 聊天，使用 AdminGuard |
✅ |
| P5b |
新增 AdminAiAssistantService — 19 个可执行工具定义（查看数据/用户管理/评论审核/状态切换等） |
✅ |
| P5c |
新增 POST /admin/ai-assistant/action 端点 — 工具执行 + AI 自然语言总结 |
✅ |
| P5d |
前端运营助手改造 — Tool Calling 架构，AI 自动识别用户意图→调用工具→解释结果→展示 |
✅ |
| P5e |
system prompt 动态注入可用工具列表，覆盖仪表盘/用户/订单/评论/Banner/通知/配置/角色/企业版等 |
✅ |
关键决策
frontend/src/lib/models.ts 作为模型列表单数据源- 所有颜色使用 CSS 变量（
text-foreground/text-muted-foreground/bg-card/bg-muted/border-border）
nest build 正常产出（--tsc 遗漏 prisma 模块）- 沙盒 JWT 认证保留
- Mock 支付自动完成闭环，无需手动触发回调；真实微信支付上线后自动切换
- 运营助手采用 Tool Calling 架构：system prompt 描述工具 → AI 返回 JSON 工具调用 → 后端执行 → 结果喂回 AI 总结 → 展示给用户
2026-05-27 Session
Changes Made
- Fixed OpenAI default model: Changed
OPENAI_MODEL in .env from meituan/longcat-flash-lite (invalid, returned 400) to deepseek/deepseek-v4-flash (confirmed working on qnaigc API). The "通用模式" (general model) now returns real AI responses instead of mock fallback.
- Fixed empty content handling: Updated
OpenAICompatibleProvider.chat() to fall back to reasoning_content when content is empty (SenseNova models return content in reasoning_content). Same fix applied in chatStream() for delta content.
Verification
- Backend successfully registers:
OpenAI 兼容接口已注册: deepseek/deepseek-v4-flash
- 5 test chat requests to
POST /api/v1/sandbox/chat with model:"general" all returned 201 in 1.3-12.7s (vs. previous mock/fallback)
- No more
AIGatewayService "调用失败" errors in logs for OpenAI provider
- Backend runs under PM2 (v7.0.1), managed via
pm2 restart backend --update-env
Known Issues
- SenseNova API (
token.sensenova.cn) still returns 404 "model is not found" for deepseek-v4-flash et al — models might need different naming on that endpoint
- Server: backend
node dist/main.js on port 4000, frontend Next.js on port 3000, both managed by PM2
2026-05-27 后续优化
彻底修复 CSS 丢失问题
根本原因：PM2 用 npm run dev（next dev）运行前端，每次重启都会重新编译，.next 缓存被销毁导致 CSS 丢失。
解决方案：改用 output: 'export' 静态导出 + 独立 HTTP 服务器。
| 文件 |
变更 |
frontend/server.js |
新增 — Node.js 静态文件服务器，支持 Next.js 静态导出 URL 模式（/about → about.html），CSS/JS 缓存一年，HTML 不缓存 |
ecosystem.config.js |
前端从 npm run dev 改为 node server.js，NODE_ENV=production |
frontend/package.json |
predev 改为仅删 out/，不再删 .next/ |
部署流程：
npm run build → 生成 out/ 静态目录- PM2 运行
node server.js → 直接提供静态文件
- 重启后 CSS 不变，无需重新编译
当前状态：
- 前端
localhost:3000 (static server, 无编译延迟)
- 后端
localhost:4000 (NestJS)
- 所有路由正常 (/, /about, /sandbox 均为 200)
- CSS 持久化，重启后不丢失
yuzhiran-dev
417fb266d4