发布检查清单

发布检查的目标不是把所有变更都跑一遍重型流程，而是让验证覆盖真实影响面。

快速选择

变更类型	最小验证
仅文档	检查 diff，构建受影响 docs，跑链接和搜索检查
公开站点	services/jarvis-site build 和 tests
前端可见功能	前端构建、相关测试、真实页面验收
后端 API 或会话行为	后端关键测试、健康检查、必要时真实验收
桌面安装包	桌面构建、签名/更新路径、真机验证
发布列车	按发布运行手册走版本同步、候选和最终发布器

文档快速路径

cd services/docs-site
npm run check

npm run check 包含 Starlight build、Pagefind 检查、内部链接检查和导航 slug 检查。

如果文档会进入公开站点，再运行：

cd services/jarvis-site
npm run build
npm test

前端可见变更

• 确认 Node 版本满足项目要求。
• 运行前端构建。
• 用浏览器或 Playwright 检查实际布局。
• 确认移动端和桌面视口都没有文字重叠或横向 overflow。

后端和 Session OS 变更

• 先跑受影响的 pytest 或 marker。
• 重启或 reload 后检查 /api/v1/health。
• 涉及 SSE、工具调用、编码会话终端或 prompt 注入时，做真实验收。

发布和安装包

正式发布必须遵守仓库发布运行手册。不要从个人分支直接发布 tag；源码变更必须先合入 main 并经过规定路径。

脱敏检查

提交前检查 staged diff，确认没有：

• API 密钥、token、cookie；
• 个人绝对路径；
• 私有服务器地址；
• 私有日志或会话正文；
• KB 内容。

相关页面

• 部署轨道
• 重启与健康检查
• 排障