Files
kefu/deploy/knowledge-v2.md
T
2026-09-21 10:34:06 +08:00

44 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 知识中心第二版:整理与审核流程
状态: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`。截图和数据均来自独立模拟环境。