--- name: baoyu-sales-copilot description: 宝锐销售Copilot — AI赋能的大客户销售工具设计与迭代。当用户提到"Copilot""销售参谋""作战准备""拜访执行""待办推进""经验库""三表一书改造""访前准备中心升级""沉淀回写""IMA集成""订单管理""物流""顺丰""shipment""下单人""合同编号""工作台""日报""KPI""role"时使用，涵盖四步闭环、数据源接入、Tab架构、CRUD模式、IMA知识库打通、顺丰API集成、订单管理页面。 --- # 宝锐销售Copilot ## 核心理念 "让销售拜访前知道问什么、拜访中知道说什么、拜访后知道联合谁推进—— AI做参谋，人不被替代，每一次赢单与丢单都变成团队的弹药， 让诊断原料大客户增长更可预测、更可持续。" ## 产业链分类 ⚠️ 铁律 **上游诊断原料企业 = 竞品，中游IVD试剂企业 = 客户。不得混淆。** 详见 `references/ivd-industry-classification.md`。 核心竞品（6家直接竞争）：菲鹏生物、诺唯赞、翌圣生物、全式金、瀚海新酶、康为世纪。 IMA中圣湘/艾德/安图/明德/硕世年报属于客户情报，非竞品。 ## 知识底座架构（2026-07-29） ``` Sales 提问 → Hermes Copilot ├── IMA KB（索引层：列表/搜索文件名）→ 匹配本地文件读取内容 ├── 本地知识库（内容层：~/Desktop/Hermes输出-工作类/知识库-copilot/） └── CloudBase（数据层：客户/订单/价格/KPI） ``` ### 本地知识库结构（2026-07-29 重组） ``` 知识库-copilot/ ├── 🏛 公用/ │ ├── 管理知识/ (71) ← 制度/战略/LTC/销售方法论/公司PPT │ ├── 市场动态/ (5) ← 行业报告/招股书/PitchBook/冻干PCR报告 │ └── 读书笔记/ (5) ← 影响力/优势谈判/营销管理/金线 ├── 🧬 诊断原料/ │ ├── 产品资料/ 竞品信息/ 推荐策略/ 技术FAQ/ │ ├── 话术库/ 价格策略/ │ └── 案例/ (18) 🔗 → 客户管理/（软链接，原文件不动） └── 🔬 生命科学/ ├── 产品资料/ 竞品信息/ 推荐策略/ 技术FAQ/ ├── 话术库/ 价格策略/ └── 案例/ (11) 🔗 → 客户管理/（软链接） ``` **软链接策略**：拜访卡/市场调研卡原文件在 `客户管理/` 下（保持工作台路径不变），通过软链接归入案例目录供 Copilot 读取。 ### IMA 诊断原料 KB 分类（2026-07-29 新建） | 文件夹 | 内容 | ~文件数 | |--------|------|--------| | 📰 行业动态 | 政策法规/展会新闻/技术趋势 | 35 | | 📋 竞品情报 | 年报/券商研报/竞品动态 | 20 | | 🧪 产品资料 | 产品册/百问百答/产品PPT | 15 | | 🔬 技术文章 | PCR/NGS/CRISPR/单细胞等 | 35 | | 📖 销售管理 | 制度/方法论/模板/工具 | 30 | | 🎓 培训材料 | 入职课件/冻干/工作指引 | 20 | | 🗂️ 待归档 | 零散会议记录/图片 | 10 | → IMA 定位为**索引层**（文件名/标题搜索），内容读取靠本地 `知识库-copilot/` 同名文件。**知识库不对外暴露**，Hermes 本地访问。 ## 四步闭环（分析→传递→跟进→沉淀） | 步骤 | 做什么 | 知识库赋能 | Copilot Tab映射 | |------|--------|-----------|---------------| | 🔍 **分析** | 看清客户：画像/痛点/竞品/机会 | 从IMA搜索匹配案例，从产品库推荐货号 | 🎯 作战准备 | | 📢 **传递** | 说对话：技术沟通/价值主张/异议处理 | 从话术库调取场景话术，从竞品库获取对比数据 | 📝 拜访执行 | | ✅ **跟进** | 推落地：行动项/时间线/协同人 | 从成功案例提取"下一步"模板 | 📋 待办推进 | | 📖 **沉淀** | 回写知识库：成败原因/关键动作/可复用打法 | **每次拜访结束必须沉淀，形成飞轮** | 📖 经验库 | ## 四Tab架构与数据源 | Tab | 功能 | 数据源 | 集成内容 | |-----|------|--------|---------| | 🎯 作战准备 | 客户搜索 + 5种材料生成 + AI诊断 + TOP5 + 归档 | `customer_list.json` + `opportunity_sandbox.json` | **完整继承访前准备中心**（材料checkboxes/生成指令/复制/已发送/CSV导出/文件检测） | | 📝 拜访执行 | 动态作战卡（三角色问题）+ 反馈记录 + IMA知识库匹配 | 商机数据规则引擎 + `/api/ima` 搜索 | 选客户时自动搜索IMA知识库匹配相关经验 | | 📋 待办推进 | 独立CRUD（销售/技术/交付），超期标记 | localStorage(`copilot_todos`)，不与其他工作台共享 | 点击完成/删除，按角色分类 | | 📖 经验库 | CRUD（赢单/丢单/话术）+ IMA回写 | localStorage(`copilot_knowledge`) + `/api/ima` `create_note` | 新建经验卡 → 一键回写IMA知识库 | ## 📦 订单管理 Tab（销售工作台集成） 2026-07-24 上线。整合于 `工具/销售工作台.html`，Tab ID: `orders`。 ### 访前材料生成标准流程 1. `web_search` 搜索客户公司 + 创始人信息 2. `web_extract` 获取年报/问询函/高管资料 3. 结合 ERP/MCP 数据（如已有采购记录） 4. 生成两个 HTML 文件： **拜访卡**（四Tab 交互式）→ `客户管理/拜访卡/{客户简称}_拜访卡.html` - 🔍 访前准备：公司概况/关键联系人表/竞争态势/拜访策略（含沟通要点+注意事项） - 📝 访中记录：技术交流清单（checkbox + 文本框）/笔记 - 📋 访后跟进：行动项表格（优先级/负责人/截止日）/邮件模板 - 📖 复盘沉淀：结构化沉淀卡（下拉选择竞品/优势/劣势）+ 标签 + IMA回写按钮 **客户调研报告** → `客户管理/{客户简称}_客户调研.html` - 六章：公司概况 → 产品布局 → 财务状况 → 原料匹配（高/中/低三级彩色卡片） → 拜访策略 → 信息来源 ### 配色规范 宝锐蓝 `#1852B6`，暗色 `#0F3A8A`，浅色 `#E8F0FE`。卡片白底圆角 + `box-shadow:0 1px 3px rgba(0,0,0,.06)`。字体 `-apple-system,'PingFang SC','Microsoft YaHei'`。 ### LTC从"销售流程"到"公司级操作系统" - LTC ≠ 销售流程，LTC = 公司级业务流骨架（任正非："LTC承载公司最大的人、财、物"） - 华为三大主流程同根：IPD（研发） + LTC（销售+交付） + ITR（质量），三张皮同一套管理哲学 - 每个部门在价值链上有上游和下游，部门之间的空白就是LTC要填的 ### 升级后架构与端点 - `/api/chat`：入参扩展 `messages`（多轮，截断16条）+ `files`（base64，本地解析）+ 返回 `sources` 溯源 - `/api/history`：GET（读，`?name=&viewer=&vrole=`）/ POST（存），权限：admin/gm 全见，sales 仅自己 - `/api/save_doc`：写 HTML/md 到 `客户管理/`（`os.path.basename` 防路径穿越） - `/api/ima_review`：submit（写待审核队列 `数据/ima_pending_review.json` + 飞书通知 admin）→ list → approve（调 IMA import_doc+add_knowledge）/ reject - `/api/archive_experience`：POST `{messages, user}` → 调 `ai_chat.archive_experience()` 把**整段多轮问答链（含补充追问）**提炼成结构化经验（标题+问题背景/涉及客户/货号/关键结论/建议动作 + 原始问答链），返回 `{title, content}` 供前端预览 ### 0. 角色 vs 字段（2026-07-30 最大踩坑 ⚠️ 铁律） 销售订单中"销售员"是角色(role)不是字段(field)。MQL返回的`owner`=殷士海(系统记录人)，真实销售员在`get_workitem_brief(fields=['role_7dd6e0'])`的role_members中。不要重复犯——先读此条目再写MQL。 ### 2. IMA API路径 - 知识库：`openapi/wiki/v1`（不是 `openapi/v1/knowledge`） - 笔记：`openapi/v1/note` - add_knowledge用 `note_info: {content_id: doc_id}` 而非顶层 `doc_id` ### 30. 客诉Tab多维度筛选器模式 - 筛选器：📂区域 | 📍状态 | ⚡优先级 | 📋类型 | ⏱天数 | 👤处理人 - 使用 `complaint*Filter` 全局变量 + `onchange="...;render()"` 模式 - 状态/优先级/类型为空时自动隐藏（三元判断 `list.length`） - 天数分段：30+ / 14~30 / 7~14 / <7 - 处理人筛选匹配 `operator` 数组 + `creator` 字段 - 客诉清单飞书链接：`https://project.feishu.cn/br-shgl/workObjectView/khts/{id}?scope=workspaces` ### 32. 客户透视SVG柱状图+下钻模式（2026-07-25） - 维度选择器：`` - 使用三元判断：`(list.length ? '