# 知识中心第二版：整理与审核流程

状态：2026-09-16 已部署生产并验收通过。部署记录见 knowledge-v2-deployed.md。

## 本版变化

- 「全部账号」页面增加首次使用步骤和「选择账号开始整理」入口。选定具体账号后进入整理向导，只有一个归档来源时自动选中。
- 创建任务前可预览消息数量、会话数量、身份明确的有效文本数量及本次处理上限。修改整理范围后必须重新预览。
- 加工任务显示实际计划消息数、进度、客服来源及结束原因；支持暂停、继续、取消，阻止重复创建相同的未完成任务。
- 知识列表支持按当前页选择条目，集中查看脱敏来源和适用条件，逐条确认后批量审核；支持批量发布、驳回和停用。
- 批量操作逐条显示成功、失败和未执行项，可停止后续操作；不会自动重试结果不确定的请求。
- 加强状态检查：过期知识不能审核或发布，只有已发布知识可停用，有有效已发布知识才能开启客服检索。
- 修复完整问答恰好位于消息上限末尾时被丢弃的问题；修复账号选择器无法记住「旧版未归属数据」的问题。

## 验证

- 后端：`test_knowledge test_model_gateway`，64 项通过。
- 前端批量操作：3 项测试通过，覆盖版本保留、部分失败、停止后续请求和状态检查。
- 前端类型检查、生产构建通过。
- Chrome 实际流程通过：登录 → 选择账号 → 预览范围 → 创建加工任务 → 查看进度 → 编辑适用条件 → 逐条确认与批量审核 → 批量发布 → 检索命中。浏览器运行错误为 0。
- 40 万条模拟消息、12003 个模拟会话：范围预览约 3.7–5.3 秒，优化后的任务快照计数约 2.5 秒。均为本机模拟数据结果，实际生产耗时取决于磁盘和并发。

## 数据兼容与发布

无需新增数据库列；新统计存放在任务原有 `options_json`。旧任务可继续处理，缺少总数时页面只显示已读条数。

服务器需同时更新知识 API、Store、Worker 和管理端静态资源，重启 API、网关和知识 Worker。网关会加载同一份 Store。发布前仍应备份数据库、密钥、源码和现有镜像；参考第一版部署记录。

发布包：`deploy/knowledge-v2-20260916/payload.tar.gz`，文件校验清单为同目录 `manifest.json`。基于当前第一版镜像构建，不新增依赖，不包含数据库、账号凭据或密钥。

发布本身不会自动整理生产归档、发布知识或开启客服检索。

## 界面验收

范围预览：

![整理范围预览](C:/kefu/deploy/knowledge-v2-qa/02-job-preview.png)

批量审核：

![逐条核对来源的批量审核](C:/kefu/deploy/knowledge-v2-qa/04-batch-review.png)

验收记录位于 `deploy/knowledge-v2-qa/browser-result.json` 与 `benchmark-result.json`。截图和数据均来自独立模拟环境。