Add files via upload

docs/zh-CN/release-process.md

@@ -0,0 +1,169 @@
+# 发布流程
+
+本文用于维护者或部署者发布、升级和回滚 CyberStrikeAI。
+
+## 版本准备
+
+发布前检查：
+
+- `README.md` 和 `README_CN.md` 的功能说明是否更新。
+- `docs/` 是否补充新功能文档。
+- `config.yaml` 示例是否包含新增配置。
+- OpenAPI 是否包含新增接口。
+- 中英文 i18n 是否同步。
+- 高风险功能是否有安全说明。
+
+## 测试
+
+至少运行：
+
+```bash
+go test ./internal/...
+```
+
+如果修改了入口、构建或命令：
+
+```bash
+go test ./cmd/...
+go build -o cyberstrike-ai ./cmd/server
+```
+
+如果修改前端，手动验证：
+
+- 登录。
+- 对话流式输出。
+- 设置保存和应用。
+- 工具列表。
+- 相关页面无控制台错误。
+
+## 构建
+
+```bash
+go build -o cyberstrike-ai ./cmd/server
+```
+
+发布包应包含：
+
+- `cyberstrike-ai`
+- `web/templates/`
+- `web/static/`
+- `config.yaml` 示例。
+- `tools/`
+- `roles/`
+- `skills/`
+- `agents/`
+- `docs/`
+- `README.md` / `README_CN.md`
+- `LICENSE`
+
+不要把本地 `data/`、真实 `config.yaml` 密钥、上传附件和日志打进公开发布包。
+
+## 升级检查清单
+
+升级前：
+
+- 停服务。
+- 备份 `config.yaml`。
+- 备份 `data/`。
+- 备份自定义 `tools/roles/skills/agents/knowledge_base`。
+- 记录当前版本和启动方式。
+
+升级后：
+
+- 启动服务。
+- 登录。
+- 测试模型。
+- 检查工具列表。
+- 检查知识库状态。
+- 检查外部 MCP。
+- 检查 C2/WebShell 是否按预期启用或关闭。
+- 查看日志和审计。
+
+## 回滚
+
+触发回滚的常见情况：
+
+- 服务无法启动。
+- 数据库迁移失败。
+- 核心对话功能不可用。
+- 高风险功能行为异常。
+
+回滚步骤：
+
+1. 停止新版本。
+2. 恢复旧二进制或旧代码。
+3. 恢复升级前 `config.yaml`。
+4. 恢复升级前 `data/`。
+5. 启动旧版本并验证。
+
+如果新版已修改数据库结构，必须恢复数据库备份，不能只替换二进制。
+
+## Changelog 建议
+
+每个版本记录：
+
+- 新增功能。
+- 行为变更。
+- 配置变更。
+- 数据库变更。
+- 安全修复。
+- 兼容性说明。
+- 升级注意事项。
+
+高风险模块的变更要单独标出，例如 C2、WebShell、终端、外部 MCP、HITL。
+
+## 发布风险分级
+
+| 改动 | 风险 | 必测 |
+| --- | --- | --- |
+| 文档、图片 | 低 | 链接和渲染 |
+| 前端页面 | 中 | 登录、页面状态、API 错误 |
+| Handler/API | 中 | OpenAPI、权限、错误码 |
+| 配置结构 | 高 | 旧配置兼容、ApplyConfig |
+| 数据库结构 | 高 | 旧库迁移、回滚策略 |
+| Agent/MCP/HITL | 高 | 工具调用、审批、流式中断 |
+| C2/WebShell/Terminal | 极高 | 授权环境、审计、禁用开关 |
+
+发布说明里要按风险级别提示用户，而不是只列功能点。
+
+## 配置兼容策略
+
+新增配置字段要遵循：
+
+- 省略时有安全默认值。
+- 旧配置能启动。
+- 示例 `config.yaml` 有注释。
+- Web 设置页不会把未知字段误删。
+- 热应用和重启两种路径都验证。
+
+如果新增字段默认开启高风险功能，应重新考虑默认值。
+
+## 数据库变更策略
+
+SQLite 迁移要考虑：
+
+- 用户可能从很老版本直接升级。
+- 迁移中断后再次启动是否幂等。
+- 新字段是否允许空值。
+- 索引是否会锁表太久。
+- 是否需要数据回填。
+
+发布说明必须写清楚“升级前备份 data/”。
+
+## Release 验收脚本思路
+
+最小自动化：
+
+```bash
+go test ./internal/...
+go test ./cmd/...
+go build -o cyberstrike-ai ./cmd/server
+```
+
+手动冒烟：
+
+```text
+登录 -> 模型测试 -> 新建对话 -> 工具列表 -> HITL -> 知识库 -> 外部 MCP -> 关闭/开启 C2
+```
+
+对高风险模块，宁可多做一个授权靶场测试，也不要只靠单测放行。