ReglowAdmin 智能客服完成度评估与下一步计划

评估日期：2026-06-28评估范围：对照 ReglowAdmin智能客服开发计划.md 中的三大阶段、12项任务

ReglowAdmin 智能客服完成度评估与下一步计划

评估日期：2026-06-28
评估范围：对照 ReglowAdmin智能客服开发计划.md 中的三大阶段、12项任务

一、综合评分

总分：50 分（满分 100 分）

分数分布

阶段总分得分完成率
阶段一（MVP）6050.584%
阶段二（干活+转人工）2500%
阶段三（有温度+能销售）1500%
合计10050.5~50%

二、逐项评估

阶段一：MVP（让机器人能答）—— 84% 完成

任务 1：数据库表设计 + Alembic 迁移 ✅ 10/10

  • 5 张表全部建立：cs_config、cs_knowledge_base、cs_knowledge_chunk、cs_session、cs_message
  • Alembic 迁移文件完善：202606230001_create_customer_service.py
  • 字段设计合理，软删除、时间戳混入、索引设置到位

任务 2：知识库管理（RAG 核心） ⚠️ 7.5/10

  • 已完成：知识库 CRUD、知识块 CRUD、调用 embedding API 向量化、Redis 向量存储与检索、重建索引
  • 未完成：
    • 文件上传功能（txt/md/pdf）—— PRD 明确要求，当前仅支持手动录入
    • 混合检索不完整 —— 仅有向量相似度（cosine），无关键词匹配和元数据过滤
    • 文件结构偏离 —— PRD 规划的 knowledge.py 和 retrieval.py 未独立，逻辑集中在 service.py

任务 3：对话编排服务 ✅ 10/10

  • 已完成：
    • System Prompt 管理（含默认模板）
    • RAG 检索 → 知识拼入 context
    • 多厂商 LLM 切换（复用 ai/controller.py）
    • SSE 流式输出（含 session 信息、逐字流、错误处理）
    • 超额完成：支持多模态（文本+图片），可切换视觉模型

任务 4：客服 SDK 脚本生成器 ⚠️ 7.5/10

  • 已完成：
    • 后端动态生成自包含 JS 脚本 ✅
    • 悬浮按钮 + 聊天窗口（Web Component 风格，不污染宿主） ✅
    • 按钮拖拽定位 ✅
    • Markdown 渲染 ✅
    • 图片上传+预览 ✅
    • SSE 流式对话 ✅
  • 未完成：
    • 小程序端 Taro 组件包 ❌
    • 文件结构偏离 —— sdk-template.js 未独立文件，JS 以字符串嵌入 service.py ❌
    • sdk_builder.py 未创建独立文件 ❌

任务 5：客户端对话 API ⚠️ 8/10

  • 已完成：POST /api/cs/chat SSE 流式输出、会话创建/隔离、消息持久化、图片上传接口
  • 未完成：
    • GET /api/cs/history 独立历史消息接口（客户端用） ❌
    • Redis 频率限制（防刷） ❌

任务 6：后台管理前端 ⚠️ 7.5/10

  • 已完成：
    • 配置管理页（创建/编辑/删除/查看 SDK 脚本/模型选择联动） ✅
    • 知识库管理页（创建/编辑/删除/管理知识块/重建索引） ✅
    • 对话记录页（会话列表/消息详情/情绪列预留） ✅
    • 单页 Tab 切换架构，功能完整 ✅
  • 未完成：
    • 文件上传功能 ❌
    • 文件结构偏离 —— 未按 PRD 规划拆分为 kb/、config/、history/、workspace/ 子目录 ❌
    • 坐席工作台 workspace/ 属于阶段二，当前未开始 ❌

阶段二：能干活 + 能转人工 —— 0% 完成

任务 7：Function Calling 工具层 ❌ 0/9

完全未实现。8 个业务工具（query_product、check_stock、query_order、calc_price、create_ticket、transfer_human、apply_coupon、create_refund）均未开发，文件 tools.py 不存在。

任务 8：智能转人工 ❌ 0/8

完全未实现。无转人工触发逻辑、无会话摘要生成、无 WebSocket 通知，文件 transfer.py 和 ws.py 均不存在。

任务 9：坐席工作台 ❌ 0/8

完全未实现。前端 workspace/ 目录不存在，无人工接管、AI 辅助回复、工单管理等功能。

阶段三：有温度 + 能销售 —— 0% 完成

任务 10：情绪识别与共情 ❌ 0/5

未实现。数据库 emotion 字段已预留但对话流程中未调用情绪识别。prompts/emotion.py 未创建。

任务 11：销售话术与推荐 ❌ 0/5

未实现。prompts/sales.py 不存在，无需求挖掘、智能推荐、促单话术。

任务 12：评测与运营 ❌ 0/5

未实现。evaluation.py 未创建，无指标看板、评测集、知识回流。此外，customer_service 模块无任何单元测试。

三、质量补充评估

优点

  • 阶段一核心链路完整：知识库 → RAG 检索 → 多厂商 LLM → SSE 流式 → SDK 嵌入，闭环可运行
  • 多模态支持（文本+图片+视觉模型切换）超出了阶段一 PRD 预期
  • SDK 的浮动按钮拖拽、图片预览等体验细节到位
  • 前端模型选择联动（服务商 → 文本模型/视觉模型/向量化模型）做得细致

待改善

  • 缺少初始化数据脚本：init_data.py 中无菜单/权限注册，导致管理员角色无法直接访问客服模块
  • SDK 缺少独立模板文件和 builder：当前 JS 以长字符串硬编码在 service.py 中，维护困难
  • 无知识库文档上传：PRD 要求的 txt/md/pdf 导入未实现
  • 无检索质量保障：混合检索缺少关键词匹配，无元数据过滤
  • 零测试覆盖：整个 customer_service 模块无任何单元测试或集成测试

四、下一步计划

优先级 P0：补完阶段一缺陷（预计工作量：中）

#任务目标
1知识库文件上传支持上传 txt/md/pdf，自动切分+向量化。后端新增 knowledge.py，前端知识库页新增上传入口
2补充菜单/权限初始化在 init_data.py 中注册"智能客服"菜单及 7 个权限项（cs:config/list/create/update/delete, cs:kb/list/create/update/delete, cs:session/list）
3SDK 模板独立化将 JS 代码拆到 static/sdk-template.js，创建 sdk_builder.py，使用 Jinja2 或 f-string 注入变量
4客户端历史消息接口新增 GET /api/cs/history?session_id=xxx，用于 SDK 端加载历史
5频率限制基于 cs_rate_key 对 /api/cs/chat 添加 Redis 滑动窗口限流
6混合检索增强在 search_knowledge 中增加关键词匹配（TF-IDF 或 BM25），提升检索召回率

优先级 P1：启动阶段二核心功能（预计工作量：大）

#任务目标
7Function Calling 工具层创建 tools.py，实现 4 个只读工具（query_product、check_stock、query_order、calc_price），对接现有业务模块
8智能转人工创建 transfer.py + ws.py，实现 5 类触发条件、LLM 会话摘要生成、WebSocket 通知
9坐席工作台（基础版）前端 workspace/IndexView.vue，实现对话列表 + 人工接管对话（WebSocket 双向通信）

优先级 P2：阶段二完善 + 阶段三启动（预计工作量：大）

#任务目标
10写入类工具 + 安全分级扩展 tools.py，实现 create_ticket、apply_coupon、create_refund，加入确认流程
11坐席工作台（增强版）AI 辅助回复、知识库快速搜索、工单管理
12情绪识别创建 prompts/emotion.py，在对话流程中前置情绪识别，自动进入安抚模式/预警转人工
13小程序 SDK开发 Taro 组件包，复用后端 SSE 接口

优先级 P3：运营 + 评测（预计工作量：中）

#任务目标
14单元测试覆盖 service.py、repository.py、controller.py，目标覆盖率 >70%
15评测体系创建 evaluation.py + 评测集管理，关键指标：一次性解决率、转人工率、满意度
16销售话术创建 prompts/sales.py，Few-shot 注入需求挖掘+推荐话术

五、建议

  1. P0 优先执行：上述 6 个 P0 任务补齐后，阶段一可达 95% 以上，可正式上线。
  2. P1 是价值拐点：Function Calling + 转人工完成后，智能客服从"只能答"升级为"能办事"，用户感知变化巨大。
  3. 不要跳步：PRD 的阶段依赖是科学的，在没有工具层和转人工的情况下，做情绪识别和销售话术收益有限。
新辉（ReglowAdmin）通用后台管理系统产品需求文档
ReglowAdmin 智能客服开发计划