47 lines
2.5 KiB
Markdown
47 lines
2.5 KiB
Markdown
# yedir-ai 发布就绪检查清单
|
||
|
||
本文档用于在商业化部署、开源发布或创建 PR 前做最终核对。它记录的是当前仓库的可验证交付边界，不替代真实 CI 结果。
|
||
|
||
## 必跑检查
|
||
|
||
```bash
|
||
pnpm install --frozen-lockfile
|
||
pnpm check:quality
|
||
pnpm audit:security
|
||
AUTH_TRUST_HOST=true PORT=3001 pnpm dev
|
||
SMOKE_BASE_URL=http://127.0.0.1:3001 pnpm smoke:routes
|
||
```
|
||
|
||
预期：
|
||
|
||
- `pnpm check:quality` 通过 lint、日志脱敏门禁、公开交付面品牌治理、CI hygiene、环境变量示例卫生、secret hygiene、package metadata、测试门禁卫生、轻量 helper 回归测试、类型检查、diff hygiene 和 tracked 污染物检查。
|
||
- `pnpm audit:security` 输出已审计；若仍有 critical/high，必须在 [dependency-risk-register.md](dependency-risk-register.md) 中记录 remediation 或风险接受状态。
|
||
- `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` 为准。
|
||
- 分支、提交、PR 和验证要求以根目录 `CONTRIBUTING.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 后确认。
|
||
- 当前依赖 audit baseline 仍需分批 remediation；详见 [dependency-risk-register.md](dependency-risk-register.md)。
|
||
- Enhance、Angle Edit、Prompt Optimizer 等历史接口仍可继续分批纳入日志门禁。
|
||
- Canvas/Agent 少数大型历史模块仍可继续领域化拆分，但不阻塞当前交付基线。
|
||
- License 以仓库根目录 `LICENSE` 为准；如商业分发策略变化，应单独进行法律审查。
|