客户会话与档案
新建、搜索、切换客户；同一客户的不同订单可新建独立分支。摘要、关键数据和历史分析均按会话隔离。
打开客户工作台 →
HUMAN IN THE LOOP
AI 帮你分析，
AI 帮你分析，
最终操作由人确认。
系统把客户会话、聊天识别、知识检索、回复建议和复盘训练串在一起。它不会替客服点击发送，也不会在切换客户后继续使用上一位客户的结果。
01
WHAT IT DOES
功能介绍
不同功能各有明确入口。网页保存业务数据并执行 AI，Windows Agent 只负责本地采集、转发和展示结果。
选中文字与截图分析
在聊天软件中选中文字，或截取聊天区域。Agent 将内容绑定到操作开始时的账号、客户和配置版本，AI结果同时留档到对应客户工作台。
查看 Agent 设置 →AI 回复建议
结合当前问题、已确认事实、相关知识和已审核训练生成建议。结果弹窗标明所属客户，只允许人工复制。
了解结果流程 →知识库
管理员可上传产品、工艺、报价规则、SOP 和售后资料。系统结构化保存并在真实回答中显示命中情况。
进入管理后台 →AI 训练与复盘
管理员批注真实回复、审核客服优秀话术并验证训练效果。训练学习表达和规则，不跨客户复用私有事实。
进入 AI 训练 →语音与连续识屏
录音可转写、分角色、生成询盘复盘；OBS 用于连续识别聊天画面。两者都必须绑定当前客户会话。
打开语音分析 →02
QUICK START
第一次使用
四步开始接待
- 登录自己的网页账号并绑定 Agent。
- 新建客户，或从平台客户列表切换客户。
- 核对客户名称、账号和聊天左右位置。
- 按快捷键分析，人工核对后复制建议。
先准备可靠知识
- 在管理后台上传或新增知识资料。
- 确认资料启用状态和版本。
- 用接待助手输入真实问题验证命中。
- 对不合适回复批注、审核并再次验证。
先完成运行条件
- 配置 HTTPS、数据库、Redis 和模型环境变量。
- 执行当前版本要求的 MySQL 升级脚本。
- 确认健康检查和网页登录正常。
- 发布 Agent 清单后再验证检查更新。
最重要的一步开始分析前必须看到 Agent 和网页显示同一位当前客户。显示“未选择客户”时，不要继续截图或提交文字。
03
CUSTOMER CONTEXT
客户档案、分支与同步
网页建立档案客户称呼、账号、背景和消息位置
→
平台生成会话每个订单分支都有独立会话标识
→
Agent 同步列表可搜索、切换或为所选客户新建分支
→
分析记录回写摘要、关键事实和回复记录回到网页
同一客户，多笔订单
不要把不同订单持续写在一个分支里。在 Agent 客户列表选中该客户后，点击“为所选客户新建分支”。
切换后旧结果失效
正在进行的截图、OCR 或 AI 分析仍属于原客户；切换后返回的旧结果会被拒绝，不能覆盖新客户。
网页是最终数据源
Agent 只保留有限、受保护的运行缓存。客户档案、上下文、知识和训练以服务器数据为准。
同步失败要明确处理
如果客户列表为空或提示数据库未就绪，先由管理员执行桌面客户会话相关升级脚本，不能改用本地名单冒充同步成功。
04
WINDOWS AGENT
桌面 Agent 怎么用
顶部用颜色、图标和中文显示已连接、正在重连、登录失效或设备停用。客户卡片始终显示当前客户；未选客户时主分析按钮禁用。
在 Agent“账号分析与本机设置”中选择平台已配置的 DeepSeek 或 Faro 模型。选择同步到当前绑定账号，该账号从网页和 Agent 发起的新任务统一使用，不影响其他业务员。
可在 Agent“本机设置与快捷键”或网页设备页录入键盘组合，也支持 Mouse4 / Mouse5 鼠标侧键。保存后由服务器校验并由 Agent 回报注册结果；发生冲突时更换组合。
进度依次显示读取、截图、OCR、上传、平台分析、完成。失败时显示中文原因和短错误码，不会把失败写成完成。
结果使用独立桌面窗口，可拖到屏幕任意位置并记住上次位置，不受 Agent 主窗口限制。固定或尚未关闭时，新结果会追加在当前客户的受保护历史下方；主界面“历史消息”可再次打开。停留时间可在本机设置选择 30 秒、60 秒、2 分钟、5 分钟或手动关闭。点击复制只复制、不发送；客户或设置版本变化后旧结果仅可查看、不能复制。
查看 Agent、服务器、协议、Windows、本地 OCR、绑定和同步状态。诊断内容已脱敏，可复制给管理员排查。
发现新版本后会先询问是否下载。确认后校验版本、文件大小和 SHA-256，再启动安装；正常升级保留原账号绑定。
Agent 不包含知识训练、模型密钥或自动发送逻辑；不会自动把 AI 建议粘贴到微信、1688、企业微信或浏览器输入框。
05
ANALYSIS FLOW
从聊天内容到建议结果
选中文字分析
- 适合单条客户问题，速度快、内容准确
- 单人聊天默认把选中文字作为客户消息并直接分析，不再二次确认
- 多人聊天时先在本机设置开启“多人会话模式”，再确认客户/客服和具体参与者
- 点击按钮会短暂隐藏助手并把焦点还给原聊天窗口；也可以直接使用自定义快捷键或鼠标侧键
- 明确标记为客服的消息只记上下文；客户消息生成的建议同时保存在客户工作台
- 训练规则二次校验失败且平台再次确认属于低风险时，弹窗才显示“严格人工 / 上下文低风险建议”；建议数量可选 1–3 条，默认 1 条
- 价格、交期、产能、规格、库存、折扣和售后承诺等高风险内容可以进行风险分析；未命中知识时只显示橙色“高风险·仅供参考”承接话术，具体事实仍须人工核对
- 读取或上传失败会显示明确错误；切换客户后旧选区结果自动作废
截图分析聊天
- 适合需要结合多条对话判断的场景
- 按快捷键后拖框，只选择聊天区域
- 优先使用 Windows 本地 OCR，识别不可用时安全回退服务端
- 原始截图确认上传或永久拒绝后会清理
系统不会做的事不会自动发送不会跨客户沿用结果不会凭空承诺商业事实
06
KNOWLEDGE & TRAINING
知识库和 AI 学习
告诉 AI“业务事实是什么”
产品参数、材质工艺、报价规则、交期说明、FAQ、售后红线和接待 SOP。资料可启用、停用、修改并保留版本。
告诉 AI“应该怎样表达”
管理员把真实问题和人工标准回答保存为训练样本，可标注语气、技能和原因；未经审核的候选不会直接进入生产回复。
确认知识和规则真的被使用
接待演练会显示命中的知识、训练样本、规则执行分数和修正情况。保存成功不等于训练已经生效。
DeepSeek 与中转站可按账号切换
部署管理员把两套密钥和允许模型写在服务端 .env。每个业务员可在本人网页或已绑定 Agent 中选择，只同步本人账号且只影响新任务；两套线路都使用相同知识检索、训练规则和高风险门禁。
权限边界知识维护和 AI 训练只在网页管理端进行。Agent 只允许为当前绑定账号提交服务端白名单中的模型选择；不能读取模型密钥、训练模型、修改知识或改变业务规则。
07
ACCESS & SAFETY
权限与安全边界
| 功能 | 客服 / 业务员 | 训练管理员 | 安全规则 |
|---|---|---|---|
| 客户会话 | 管理本人授权会话 | 可在独立管理员接待空间使用 Agent | 管理员接待数据不与全部业务员会话合并 |
| 截图 / 选中文字 | 可使用 | 按服务器授权使用 | 未选客户或登录失效时自动禁用 |
| 分析模型 | 切换本人账号的新任务模型 | 配置服务端线路、默认值和允许列表 | 账号间隔离；进行中任务不被中途切换 |
| 复制 AI 建议 | 人工核对后复制 | 可测试和复盘 | 永不自动发送或自动粘贴 |
| 知识库 | 在回答中受控使用 | 新增、修改、启停和验证 | 高风险事实无知识时不得确认，只能给人工核对的参考承接话术 |
| AI 训练 | 可提交反馈 | 批注、审核、发布训练样本 | 客户私有事实不得跨会话学习 |
08
TROUBLESHOOTING
常见问题
Agent 没有显示网页里创建的客户
先确认 Agent 和网页登录的是同一授权账号，然后在客户列表点击“刷新平台列表”。若提示 HYA-E1503 或数据库表尚未就绪，请管理员依次执行 deploy/mysql56-v0.6.32-upgrade.sql 和 deploy/mysql56-pairing-sync-upgrade.sql，重建 Web 容器后再试。
为什么显示“未选择客户”，分析按钮不能点
这是防串客保护。请先新建或切换客户，等待平台确认并显示客户名称。不能通过本地临时名单绕过服务器确认。
快捷键没有反应或与其他软件冲突
到网页“桌面设备”页重新录入组合键，也可以使用 Mouse4 / Mouse5。保存后打开“关于与诊断”查看注册数量；冲突时关闭占用程序或更换组合。
按“分析已选文字”后提示没有识别到文字
先在原聊天窗口拖选可复制的文字，保持该窗口在前台，然后松开鼠标和 Ctrl / Alt / Shift 后再按快捷键。图片里的文字应使用“截图分析聊天”。若仍失败，请尝试复制一次确认该聊天软件允许复制，并在 Agent 诊断页查看快捷键注册状态。
怎样切换 DeepSeek 或 Faro 中转站模型
先由部署管理员在服务端 .env 配置两套密钥、默认模型和模型白名单。业务员可在本人网页工作台或 Agent“账号分析与本机设置”中选择；选择会同步到同一账号，不影响其他账号，正在进行中的任务仍使用启动时锁定的模型。Faro 使用 OpenAI 兼容地址 https://faroapi.com/v1，模型 ID 必须按模型广场原样填写。网页和 Agent 都不会显示密钥；切换不会绕过知识库。
任务一直显示正在分析
先看连接状态和诊断页。处理完成、失败或旧客户结果被拒绝时，任务栏都应明确收尾；若长时间不变，请复制脱敏诊断和短错误码，不要发送客户原文或密钥。
检查更新提示有新版，安装后绑定会丢吗
正常的受控更新会保留 Agent 数据目录和账号绑定。点击更新后必须完成清单、版本、大小和 SHA-256 校验；校验失败时不会替换当前版本。
卸载后重新安装为什么还要求绑定
这是正常的初始化流程。用户主动卸载会完全退出 Agent，并清除本机设备ID、绑定凭据、日志和缓存；重新安装会生成新的设备身份。普通版本更新不会清除绑定。需要手动结束时，可在 Agent“更多”或托盘菜单选择“完全退出助手”。
直接访问更新清单为什么返回 401
更新清单不是公开下载地址，必须由已绑定设备携带授权信息访问。请在 Agent“关于与诊断”里点击检查更新，不要把 401 当成服务异常。
AI 为什么没有直接给出价格或交期
价格、交期、库存、产能、折扣、赔付等属于高风险事实。没有匹配的已启用知识时，系统仍会分析风险和当前客户上下文，并用橙色“高风险·仅供参考”显示非承诺性承接话术；具体业务事实必须人工核实，系统不会自动发送。
保存了知识，为什么回答仍未命中
确认资料已启用、标题和正文包含客户实际会问的关键词，并在接待演练查看命中明细。生产环境还要确认数据库连接和最新知识版本正常。