# 0917课程-知识库问答 · 专家载体建设方案（定稿版）

**日期**：2026-09-16 ｜ **状态**：方案逻辑已校正，待批准执行  
**载体形态**：WorkBuddy 专家包  
**一句话定位**：一个只从乐享「北森0917」文件夹取数的问答专家——逐句挂来源、查无即拒答、冲突不裁决、不联网、不脑补。

---

## 一、已锁定的全部决策（协商记录）

| # | 决策项   | 结论                                               |
| - | ----- | ------------------------------------------------ |
| 1 | 使用边界  | 公司同事均可用的固定入口                                     |
| 2 | 数据来源  | **仅乐享「北森0917」文件夹**（弃用 ima/多库方案）                  |
| 3 | 严格度   | 全场景一刀切：逐句引用 + 无命中拒答，不分级                          |
| 4 | 冲突处理  | 系统标记冲突、并列呈现，留人类裁决，模型不择优                          |
| 5 | 源头错误  | 不算模型幻觉，但必须可见（标注，不掩盖）                             |
| 6 | 引用粒度  | 行内标注 `[来源：文档名]` + 文末原文链接（API 无页码，实测确认）           |
| 7 | 白名单维护 | **动态刷新，用户零维护**（每次会话自动拉取文件夹内容重建）                  |
| 8 | 验收标准  | 拒答正确率 100%（无折扣）；引用准确率首轮 ≥95%、迭代到 ≥99%；冲突标注率 100% |
| 9 | 升级路径  | 协议内核与外壳解耦，未来可升 B 版（独立网页入口挂 ECS）复用同一内核            |
| 10 | 输出结构  | 四条铁律：①结论先行（先结论后论据）②紧扣题目（问什么答什么，不扩大不缩小）③条理清晰（分点分层）④简明扼要（正文 ≤300 字；引用标注/链接/必要表格数据不计入） |

---

## 二、专家包架构（M1–M5）

```
0917课程-知识库问答专家/
├── SKILL.md（M1 身份与红线）
│     · 四条硬约束：来源唯一 / 逐句溯源 / 查无拒答 / 冲突不裁决
│     · 禁联网、禁模型参数知识补内容、禁调和矛盾结论
├── references/
│   ├── protocol.md（M2 问答协议）
│   │     · 引用模板：[来源：文档名] + 文末链接 https://mcp.lexiang-app.com/pages/{entry_id}
│   │     · 拒答话术：「知识库暂无此内容」+ 入口预期管理文案
│   │     · 冲突标注格式：⚠️ 并列呈现 + 各自来源，不裁决
│   │     · 生成红线：只允许改写命中片段；挂不上来源的句子一律删除
│   │     · 输出结构铁律：结论先行 / 紧扣题目 / 分点分层 / 正文≤300字（引用标注、链接、必要表格不计入）
│   ├── whitelist.md（M3 白名单与检索规范）
│   │     · 文件夹 ID：9daf1851531a4a8cb3bd500cb3b1a80f（space: 赵展辉的个人知识库）
│   │     · 每次会话开始：entry_list_children 实时重建白名单
│   │     · 检索：space 内向量检索 → target_id ∈ 白名单过滤 → 空集即拒答
│   │     · 附指令：「同步白名单」「检查文件索引状态」的实现方式
│   └── test-suite.md（M4 试题集与验收）
│         · 20–30 题：真实业务问题 + 故意无答案的陷阱题
│         · 指标：拒答正确率 100% / 引用准确率 ≥95%→99% / 冲突标注率 100% / 输出结构合规率 100%（结论先行+≤300字）
└── （M5 预留）protocol.md 独立成文，B 版网页入口直接复用
```

---

## 三、运行时数据流（专家每次回答的内部流程）

```
用户提问
   ↓
① 刷新白名单：entry_list_children 拉取「北森0917」当前文件清单
   （新上传的文件自动进入白名单，删除的自动移出）
   ↓
② 向量检索（space_id 圈定个人知识库，关键词检索兜底）
   ↓
③ 白名单过滤：target_id ∉ 白名单 的结果全部丢弃
   ↓
④ 命中判定
   ├─ 白名单内 0 条命中 ──→ 输出「知识库暂无此内容」（拒答 = 正确输出）
   └─ 有命中 ──→ ⑤ 生成：仅改写命中片段
                  每个关键论断后跟 [来源：文档名]，挂不上来源的句子删除
   ↓
⑥ 冲突检测：多文档结论不一致 → ⚠️ 并列呈现，不裁决
   ↓
⑦ 输出前自检：逐句核对来源 → 文末附可点开的原文链接 → 出答案
```

**实测背书**（2026-09-16 五轮测试，详见《白名单机制实测报告.md》）：  
库内问题 5/5 片段精准命中交付记录/央国企专刊；库外问题（炼钢）被白名单干净拦截并正确拒答；库外噪音文档 0 泄漏。

---

## 四、建设流程（分阶段，可直接执行）

### 阶段 0：检索底座实测 ✅ 已完成

- [x] 文件夹定位、3 文件白名单确认
- [x] 正向命中 / 拒答路径 / PDF 召回 / 噪音拦截 四向验证
- [x] 引用格式定稿（无页码降级为链接）
- [ ] 补测：《2026年1-8月排课数据》索引完成后内容级召回（自动化例行检查即可触发）

### 阶段 1：专家包创建（AI 执行，约一次会话完成）

- [x] 用 expert-manager 创建专家包骨架（kb-qa-0917，含头像，校验通过已注册）
- [x] 写入 M1（agent.md 四条硬约束 + 动态白名单工作流 + 统计题全量计算规则）
- [x] 写入 M2（引用模板 / 拒答话术 / 冲突标注 / 生成红线 / 输出结构铁律）
- [x] 写入 M3（检索规范 + 「同步白名单」「检查索引状态」两个内置指令）
- [ ] 用户同步到 WorkBuddy 企业版，同事可开始试用

### 阶段 2：试题集验收（AI 出题 + 用户供真题）

- [ ] 用户提供 10–20 个真实业务问题（华昕/北森/日常业务均可）
- [ ] AI 补充 10 个陷阱题（白名单外、易脑补、易混淆题型）
- [ ] 全量跑测，出具验收报告：拒答正确率 / 引用准确率 / 冲突标注率
- [ ] 不达标项 → 修订 M1/M2 措辞 → 复测，直至达标
- ✔ 试测已过：T01–T03 真题 3/3 通过（闪燕主讲课 / 田楷 2025 天数 / 关键对话 2025 上海天数），统计类问题已增补"下载原始文件全量计算"规则写入专家协议

### 阶段 3：固化与运营 ✅ 已完成（2026-09-16）

- [x] 验收现状归档（《0917知识库问答专家-运营手册.md》第一节），专家转正式运行
- [x] 例行检查自动化：每日 09:00 检查「北森0917」文件索引状态（有效至 2026-10-16）
- [x] 白名单外知识的入库路径：用户往「北森0917」文件夹放文件即完成扩容（已固化进运营手册第二节/第三节）

---

## 五、用户动作清单（全程仅 3 类动作）

| 场景       | 你的动作                   | 频率        |
| -------- | ---------------------- | --------- |
| 扩充知识     | 在乐享把文件上传/拖入「北森0917」文件夹 | 随时，无其他操作  |
| 怀疑白名单未刷新 | 对专家说「同步白名单」            | 极少，兜底用    |
| 验收供题     | 给 10–20 个真实业务问题        | 一次性（阶段 2） |

**唯一需要知道的特性**：新文件上传后有索引建立窗口期（分钟级~更久），窗口期内专家对该文件拒答——这是零幻觉机制正常工作，不是故障；可用「检查文件索引状态」确认。

---

## 六、风险登记（已识别，均有对策）

| 风险                       | 状态    | 对策                                |
| ------------------------ | ----- | --------------------------------- |
| 排课数据 xls 索引未完成           | 待补测   | 例行检查索引状态，完成后补一轮召回测试               |
| 相关度分数 0.5–7.7 与文档（0–1）不符 | 已实测确认 | 命中阈值不在配置里拍脑袋，阶段 2 用真题标定           |
| 模型漏挂来源（首测必有漏网）           | 预期内   | 「无来源即删句」写死进 M2，阶段 2 复测压到 ≥99%     |
| 个人知识库其他文档（炼钢手册等）干扰       | 已拦截   | 白名单过滤实测 0 泄漏                      |
| 个人凭证跑公司入口                | 结构性约束 | A 版（专家）阶段无问题；升 B 版对外时再解决企业凭据/后端代理 |

---

## 七、验收口径（一句话版）

> 该答的答得准（每句可点开核对），该拒的拒得掉（陷阱题 100% 拒），冲突看得见（标注不裁决）——三条全绿，专家上线。
