# 宝锐销售工作台 · 案例与 Skill 全景

> 整理日期：2026-09-05｜来源：竹间三层文档架构（L1 心法 + L2 宪章 + L3 任务 + R 层规范）+ 全部 Skill 清单

---

## 一、工作台概览

宝锐生物营销中心的一体化销售作战室，服务两条业务线（诊断原料 + 生命科学）、约 30 名销售人员与管理层。

**五大核心模块**：

| 模块 | 功能 | 数据源 |
|------|------|--------|
| KPI 看板 | 当月 / 当季 / 当年三层递进，部门+个人达成率 | kpi_dashboard.json / kpi_progress.json |
| 客户管理 | 客户 360、集团归集、区域归属 | workbench_data.json / customer_360.json |
| 订单追踪 | 订单明细、顺丰物流状态 | shipment_status.json |
| 数据管理 | ERP 上传、AI 对话历史、Token 用量 | 多源 |
| 测试反馈 | 科研测试正/负案例留痕 | test_feedback.json |

**双通道部署**：CloudBase 外网（`工具/index.html` → `/workbench/index.html`）+ 飞书内嵌（`工具/app.html`，da/ls 业务线分流）。

**角色分权**：admin/gm 看全部 → manager 看本部门 → sales 只看自己。

---

## 二、架构案例（竹间三层文档架构）

```
L1 宝锐工作台.md  ← 核心心法（8 条规矩 + KPI 口径 + 人员架构 + 数据家底）
L2 PROJECT.md     ← 项目宪章（为什么做 / 边界 / 技术选型 / 文件结构）
L3 TASK.md        ← 当前任务队列（进行中 + 已完成）
R   RULES.md      ← 共同规范（R1 ERP管线 / R2 KPI / R3 部署 / R4 角色 / R5 页面）
```

**技术选型原则（克制）**：零依赖 HTML（CSS/JS 全内联）、Chart.js 本地化不碰 CDN、JSON 驱动页面 fetch 渲染、CloudBase 静态托管、Tailscale Funnel 出外网。理由统一：少一个外部依赖，少一个明天挂掉的理由。

**八条铁律（P1–P8）**：金额只认 ERP｜页面零依赖｜数据有权威等级（ERP > 月度报告 > MCP > 推算）｜权限门儿清｜修东西按 CAPA｜出问题先体检｜改完必测｜渐进迭代。

---

## 三、功能模块案例（已落地页面）

| 页面 | 用途 | 状态 |
|------|------|------|
| 工具/index.html | CloudBase 工作台主页面（看板/客户/订单/数据管理） | 在线 |
| 工具/app.html | 飞书内嵌版（da/ls 业务线分流） | 在线 |
| 工具/landing.html | 分流首页 | 在线 |
| 工具/科研测试反馈.html | 测试案例库（正/负） | 在线 |
| 工具/admin.html | 超管用户管理页 | 在线 |
| 工具/宝锐统一工作平台.html | 统一入口 | 在线 |
| AI 助手 Tab | Hermes Agent 四步闭环 + 上传解析 + Token 统计 | 在线 |
| 扩展工具 | 作战室 / 客户360 / 拜访卡 / 拜访纪要 / 价格表 / 备货预测 | 按需生成 |

---

## 四、工作流案例（自动化管线）

### 1. ERP 数据管线
```
上传 ERP Excel → 质检(openpyxl values_only) → 识别月份(ZHBR前缀) → 提取KPI → merge → 部署
铁律：合计行过滤 / 测试单去重 / 宝锐系内部采购剔除 / 代号映射(大客户1=黄明月等)
```

### 2. MCP 数据刷新管道（飞书项目 → 看板）
```
_full_refresh_offset.py 拉 4 类数据(客诉/客户/活动/订单, OFFSET翻页)
→ merge_workbench_data.py 合并 14 文件 → workbench_data.json
→ cb_sync_data.sh 部署 CloudBase
铁律：OFFSET 翻页(禁 session_id 无限循环) / 大表 timeout 重试 / 核对条数 vs 基准
```

### 3. KPI 刷新（销售额）
```
refresh_kpi_mcp.py：MQL拉全月订单 → get_workitem_brief查销售员(带缓存) → kpi_progress.json → 部署
→ merge_workbench_data.py(内嵌KPI) → 部署 workbench_data.json
```

### 4. 顺丰物流 watchdog
```
pull_orders.py(MCP拉订单) → shipment_pipeline.py(顺丰轨迹逐条查询)
→ sf_delivery_watchdog.py(状态判定opCode优先 → diff → 飞书卡片推送按销售员)
铁律：opCode优先(80=签收) / 逐条查询禁批量 / checkPhoneNo=收件人手机后4位
```

### 5. CloudBase 部署
```
tcb hosting deploy 工具/index.html /workbench/index.html -e bier-sales-d0gatbvlx288724e9
CDN 缓存 2-5 分钟；cb_sync_data.sh 只同步 JSON，HTML 需单独部署
```

### 6. AI 助手 Token 统计（2026-09 新增）
```
_call_hermes 提取 usage → handle 按业务员 name 记录 → 数据/ai_token_usage.json
→ /api/token_usage 端点(admin/gm看全部) → 数据管理Tab「Token用量」卡片
支持历史估算回填(estimated标记 + est_count)
```

### 7. 拜访纪要生成（2026-09 新增）
```
手写笔记照片 → PaddleOCR识别(手写优于macOS Vision优于tesseract)
→ 8板块提炼 → 可编辑HTML(✏️编辑/💾保存/↩恢复) → 存客户管理/拜访纪要/
```

---

## 五、Skill 案例清单（分类索引）

### A. 工作台基建与运维（13）
- `baoyu-workbench` — 工作台主控
- `baoyu-workbench-frontend-pitfalls` — 前端铁律（DOM重建/focus顺序/空状态/字段映射）
- `baoyu-workbench-test-page` — 测试页/精简版（无飞书限制）
- `baoyu-workbench-auth` — 认证与密码（CloudBase登录/飞书限制/超管）
- `baoyu-workbench-health-check` — 五维体检（服务/Cron/数据/Gateway/前端）
- `baoyu-workbench-mcp` — MCP数据管道（多项目查询/字段展开/飞书链接）
- `baoyu-workbench-mcp-pipeline` — MCP管道（MQL/字段映射/缓存/陷阱）
- `baoyu-workbench-ops` — 运维参考（简报/MCP活动/部署pitfalls/Funnel）
- `baoyu-workbench-theming` — 品牌化（白色顶栏 Logo 注入）
- `baoyu-workbench-data-pipeline` — 数据管道（每日上传→处理→JSON→渲染）
- `baoyu-workbench-patterns` — 构建模式（零依赖Tab式仪表盘）
- `baoyu-cloudbase-deployment` — CloudBase部署（静态托管/匿名鉴权/Tunnel）
- `baoyu-cloudbase-workbench` — CloudBase工作台（托管+鉴权+权限+飞书免登）

### B. 页面规范与权限（6）
- `baoyu-html-table-standard` — 表格标准化（可筛选/排序/索引）
- `baoyu-html-self-contained` — 自包含化（fetch/localStorage → 完全自包含）
- `baoyu-html-audit` — HTML审计（审查/评估工具页面）
- `baoyu-workbench-business-lines` — da/ls 双线架构（line字段/课题组/TABS过滤/权限）
- `baoyu-password-management` — 密码管理（CloudBase user_roles/Sales改密）
- `baoyu-sales-data-isolation` — 数据隔离（新增销售员全流程/权限校准）

### C. 数据管道与 ERP（4）
- `mcp-real-time-pipeline` — MCP实时管道（后端缓存+API+前端降级）
- `mcp-pipeline-patterns` — MCP管道模式（MQL/字段解析/串联）
- `baoyu-erp-dashboard-patterns` — ERP→HTML看板（测试单/AR/多源合并）
- `baoyu-erp-product-catalog` — 产品清单自动提取（订单→产品清单）
- `baoyu-erp-crossref-backfill` — ERP交叉回填（跟踪清单↔ERP）

### D. 销售数据分析（15）
- `baoyu-sales-deep-analysis` — 多年度订单深度分析（多Sheet Excel报告）
- `baoyu-customer-analysis` — 客户/集团维度订单分析
- `baoyu-customer-handover` — 岗位三年经营分析（ERP+回款+商机+货号）
- `baoyu-customer-pricing` — 客户价格表（ERP→JSON→授权查询）
- `baoyu-customer-profile` — 客户360档案卡（六大维度）
- `baoyu-customer-workbench` — 客户管理工作台（档案/跟进/订单）
- `baoyu-dashboard-update` — 综合管理仪表盘更新
- `baoyu-overdue-analysis` — 逾期应收账回款分析
- `baoyu-work-report-analysis` — 工作汇报分析（三部门KPI趋势）
- `baoyu-resignation-handover-analysis` — 离职交接风险分析（10表Excel）
- `baoyu-monthly-report` — 月度经营报告（KPI+活动+客诉+物流）
- `baoyu-management-reporting` — 管理报告（飞书Excel导出）
- `baoyu-test-feedback-analysis` — 测试反馈分析（CRM导出→洞察）
- `baoyu-sales-todo-dashboard` — 待办中心（四类待办自动提取）
- `baoyu-stock-forecast` — 备货预测（华为体系+客户分层）

### E. 拜访与商机（6）
- `baoyu-visit-card` — 客户拜访卡（四Tab交互式，LTC+铁三角+一纸禅）
- `baoyu-visit-minutes` — 拜访纪要（PaddleOCR识别→8板块可编辑HTML）
- `baoyu-life-science-visit-card` — 生命科学拜访卡（课题组PI实验室）
- `baoyu-life-science-opps` — 商机/课题组档案（三级分层：大学→课题组→详情）
- `baoyu-visitor-prep` — 来访准备（学术型/高校/客户三类场景）
- `baoyu-market-research-card` — 市场调研卡（客户终端赛道竞争格局）

### F. 方法论与市场（15）
- `baoyu-ltc-methodology` — LTC方法论（华为LTC→宝锐落地）
- `baoyu-competitor-analysis` — 竞品/竞争格局分析
- `baoyu-market-analysis-report` — 行业纵深市场分析报告
- `baoyu-market-intel-agent` — 市场情报周报（7家竞品cron采集）
- `baoyu-product-benchmarking` — 产品参数横向比对
- `baoyu-product-gap-analysis` — 产品缺口分析与优先级
- `baoyu-product-intro-card` — 产品简介卡片（PDF→暗色HTML）
- `baoyu-product-naming` — 产品命名/卖点/商标合规
- `baoyu-product-selling-points` — 竞争力库写入规范
- `baoyu-enterprise-tool-adoption` — 企业工具选型调研
- `baoyu-promotion-campaign` — 促销/营销活动方案
- `baoyu-survey-report` — 客户满意度调研（4模式）
- `baoyu-technical-literature-deepdive` — 技术文献调研与缺口
- `baoyu-contract-review` — 合同/协议/专利授权审核
- `baoyu-market-sizing-verification` — 市场数字验证

### G. AI 助手与销售工具（5）
- `baoyu-ai-assistant-scenarios` — AI助手场景路由与回答框架
- `baoyu-ai-assistant-workflow` — AI助手四步闭环主动参谋
- `baoyu-sales-copilot` — 销售Copilot（大客户销售工具设计）
- `baoyu-war-room` — 诊断原料作战室（角色分权HTML）
- `baoyu-gift-order-system` — 礼品下单系统维护

### H. 内容与多媒体（7）
- `baoyu-presentation` — PPT汇报（pptxgenjs高管简报风格）
- `baoyu-promotional-flyer` — A4促销传单
- `baoyu-music-studio` — 多媒体工作室（歌词/音乐/图像）
- `baoyu-social-media-launch` — 社媒起号（小红书+视频号）
- `baoyu-comic` — 知识漫画
- `baoyu-infographic` — 信息图（21布局×21风格）

### I. 架构与协作（5）
- `baoyu-architecture-framework` — 三层文档架构（L1/L2/L3）
- `three-agent-framework` — 三Agent协作框架
- `hermes-pitfalls-learned` — Hermes开发陷阱（file://协议/缩进等）
- `sf-express-tracking` — 顺丰物流追踪（轨迹/状态/推送/排除名单）
- `feishu-project-mcp` / `meegle` — 飞书项目MCP（48个工具）

---

## 六、关键铁律速查

**数据**：金额只认 ERP；宝锐系内部采购剔除；测试单去重；月份=ZHBR 前缀第5-6位。

**管线**：OFFSET 翻页（禁 session_id）；大表 timeout 重试；`0` 是合法金额（`or ''` 会吞 0）。

**部署**：cb_sync_data.sh 只同步 JSON；HTML 单独 tcb deploy；CDN 缓存 2-5 分钟。

**推送**：顺丰 opCode 优先（80=签收）；逐条查询禁批量；creatorEmail 用拼音邮箱字段。

**前端**：DOM 重建先 render 后 focus；函数重复声明会白屏；空数据必须有提示。

---

*本文档为工作台知识全景索引，详细实现见各 Skill 及 L1/L2/L3/R 四层文档。*