# knowledge.html · 知识库

## 用途与角色

售后知识沉淀与复用：问题关闭后自动沉淀知识，建单/工单/AI 问答时被引用。知识管理员=质量岗兼任（规格书 2.1 质量职责的自然延伸）。**M2 里程碑页面**。

## 区块

| 区块 | 内容 | 数据来源 |
|---|---|---|
| 统计条 | 条目数 / 本月新增（其中 AI 沉淀）/ 待审核草稿 / 本月被引用 | 知识表聚合 |
| 自动沉淀闭环卡 | 流程说明（关闭→AI 草稿→查重合并→人审核→发布→引用计数） | — |
| 知识条目表 | 编号/现象+根因/方案摘要/适用机型/来源/置信度/被引用/状态 | 知识表 |
| AI 待审核卡 | 草稿列表＋来源单据＋相似度提示＋[采纳/编辑/驳回] | AI 生成草稿 |
| 高频引用 Top5 | 条形 | 引用计数 |

## 知识条目字段（S12 知识表，V0.2 后新增）

编号 KB-#### · 现象 · 根因 · 方案（临时/根治分列）· 适用机型/批次 · 来源单据（4D/工单/ECN，可回溯）· 置信度（引用与验证次数推导）· 状态（草稿/已发布/已过期）· 变更历史。

## 行为契约

1. **自动沉淀（AI 智能体：知识管理员）**：问题单关闭事件触发 → AI 读取 4D 根因/纠正措施、工单处理动作、ECN 验证判据 → 生成草稿并与既有条目做相似度匹配（≥70% 建议合并，标注合并到哪个条目哪一段）。
2. **人审核**：采纳发布 / 编辑后发布 / 驳回（填理由，回流 AI 改写或人工重写）。**未审核草稿不进入任何引用通道**。
3. **引用通道**（采纳即引用计数 +1）：建单页「同类历史提示」、工单「建议携带备件」、AI 助手问答（回答附知识条目链接）。
4. **过期机制**：机型停产或方案被新 ECN 替代 → 标「已过期」并保留归档，不删除。
5. 人工新建：技术/质量可直接创建（走同一审核流）。

## 接口草案

- `GET /api/loop/kb?q=&model=&category=&source=&status=&page=`
- `POST /api/loop/kb/drafts/{id}/approve|reject|edit`
- `GET /api/loop/kb/top-cited?n=5`
- 事件订阅：`issue.closed` → 生成草稿（规则引擎转发给智能体）

## 权限

- 查询：全角色；发布/编辑/驳回：知识管理员（质量）＋技术；驳回理由必填。

## 边界与空态

- 冷启动（库为空）：引导页＋「从近 12 个月已关闭单批量回溯沉淀」按钮（AI 批处理+抽样人审）。
- 草稿积压 >10 条：HUB 给知识管理员生成提醒任务。

## 验收要点

- 关闭一张带 4D 的单 → 24h 内出现对应草稿且含来源单据回溯链接。
- 未审核草稿在建单提示与 AI 回答中不可见；采纳后立即可见且引用计数生效。