ai-chatbot/docs/release-readiness.md

yedir-ai 发布就绪检查清单

本文档用于在商业化部署、开源发布或创建 PR 前做最终核对。它记录的是当前仓库的可验证交付边界，不替代真实 CI 结果。

必跑检查

pnpm install --frozen-lockfile
pnpm check:quality
AUTH_TRUST_HOST=true PORT=3001 pnpm dev
SMOKE_BASE_URL=http://127.0.0.1:3001 pnpm smoke:routes

预期：

• pnpm check:quality 通过 lint、日志脱敏门禁、类型检查、diff hygiene 和 tracked 污染物检查。
• pnpm smoke:routes 验证 / 返回 200。
• /classic 和 /chat/test-id 重定向到 /。
• /settings 未登录重定向到 /login?callbackUrl=%2Fsettings。

发布边界

• 旧 Chat UI 已移除；/api/chat 保留为 Canvas/Agent 内部生成 API。
• /settings 本地 AI 设置已组件化，保存 key、SWR key 和业务 API 保持稳定。
• 首页采用轻量壳优先渲染，个性化和公开数据渐进加载。
• 高风险日志链路已纳入 pnpm check:logs，禁止回流裸 console.*。
• CI 基础门禁与本地 pnpm check:quality 使用同一套污染物检查脚本。
• 安全披露、敏感信息和日志规则以根目录 SECURITY.md 为准。

不应在发布包中出现

• .env.local、真实密钥、OAuth code、Cookie、Authorization、签名 URL。
• .DS_Store、swap 文件、.claude/ worktree、migration backup、tsconfig.tsbuildinfo。
• 新增公开入口指向 /classic 或 /chat/[id]。
• 生产日志中输出完整 prompt、base64、图片 URL、第三方完整响应体或对象存储路径。

已知后续专项

• 远端 GitHub Actions 实跑结果需要在 push/PR 后确认。
• Enhance、Angle Edit、Prompt Optimizer 等历史接口仍可继续分批纳入日志门禁。
• Canvas/Agent 少数大型历史模块仍可继续领域化拆分，但不阻塞当前交付基线。
• License 以仓库根目录 LICENSE 为准；如商业分发策略变化，应单独进行法律审查。