# 协议版与知识中心整合

2026-09-16 将 C:\kefu 的近期功能整合到 C:\wechat_rpa。保留协议版 v1.4.16 的客户端、视觉/协议模式、原账号发送、回执去重、联系人验证跳过及企业微信版本适配。

## 已接入

- 智能体角色、规则与全部授权账号视图：原有后端能力保留，补齐完整管理前端。
- 归档性能：分页与游标、租户过滤、账号统计按需读取、导出查询优化。
- 知识加工：范围预览、规则/指定模型整理、任务进度、暂停/继续/取消、失败换模型续跑与增量整理。
- 异常处理：模型字段异常保留脱敏问答为待审草稿，已驳回知识支持删除。
- 全量审核：指定账号或全部授权账号，跨全部页面后台处理；通过后进入待发布，异常保留原因。
- 检索：只引用有效且已发布的知识；账号隔离、来源与版本复核、引用留痕、可读错误提示。
- 协议回复：经过模型网关的回复接入知识检索，保留任务 ID、知识引用和裁判风险；高风险回复进入原有审核流程。
- 客户端「管理知识」打开后台知识中心，数量来自云端已发布知识。知识入口使用正确的 hash 路由。

## 使用方式

使用当前已配置的后台时，退出并重新启动本目录的源码客户端；在客户端同步后台配置后，进入「AI 人格与能力 → 管理知识」。选择账号，整理聊天、审核、发布，再开启该账号「客服使用知识」。协议模式通过该账号的模型网关使用知识，本机直连模型不经过服务端知识检索。

在管理端「知识与审核」可一键审核此账号或全部授权账号，不需要逐页全选。审核通过仅为待发布，发布后才会参与检索。

本目录也能独立运行完整后台：

```powershell
cd C:\wechat_rpa
python run_backend.py --db C:\wechat_rpa\backend.db
```

启动管理 API、模型网关、知识 Worker。管理页面位于 `http://127.0.0.1:8766/#/knowledge/center`，无需为前端另起开发服务。已保留当前配置和数据库；本次验收仅使用临时测试数据库，没有启动此命令处理真实任务。

前端源码与生产资源位于 `admin-web`。再次修改前端时先安装其 pnpm 工作区依赖，再执行 `pnpm --filter @vben/web-antd typecheck`、`pnpm --filter @vben/web-antd build`。已附带本次通过浏览器验收的 dist。

Linux 服务端部署入口为 [deploy/im-admin/README.md](deploy/im-admin/README.md)。知识功能说明见 [KNOWLEDGE.md](KNOWLEDGE.md)。

## 验证

- 知识、任务、模型输出、全量审核、检索和网关：96 项通过。
- 新增协议与知识联动、独立管理端及桌面状态：7 项通过。
- 管理后台、归档、性能、智能体和路由：326 项通过。
- 协议、联系人、版本适配、打包规则和 Qt：221 项中 217 项通过，4 项因未安装可选 Unicorn CPU 模拟器跳过。
- 客户端登录、归档上传、回复安全、防自回复：496 项通过。
- 合计 1142 项通过、4 项跳过。协议发送使用模拟传输，没有向真实客户发送测试消息。
- 独立管理页：正常检索仅命中已发布知识；空白、单字、超长问题与后端错误显示正确，无页面脚本异常。
- 跨账号页面验收：77 条模拟草稿中 75 条通过进入待发布、2 条保留异常原因，发布数仍为 0；关闭弹窗后任务继续。

## 交付与回退

本次交付是源码、前端生产资源和部署配置。现有 dist 中已打包的 EXE/安装包未重建，线上服务器未部署；已有运行中的进程需重启才加载新源码。

修改前文件备份：`backups/integration-20260916-151604`。改动清单与 SHA-256 见 `INTEGRATION_MANIFEST_20260916.json`，测试结果见 `INTEGRATION_VERIFICATION_20260916.json`。原数据库、密钥、聊天归档和个人配置没有被本次整合覆盖。

需要回退时先停止使用本目录源码的服务和客户端，再按清单恢复备份中的原文件。不要覆盖运行数据。知识功能使用后不要恢复旧数据库，否则会丢失之后新增的聊天与知识。