# 反馈沉淀流水线（Feedback Pipeline）

> 目的：把官方库讨论区（deepseek-ai/deepseek-harness）的新反馈**持续、低成本、可追踪**地沉淀进白皮书。
> 机制：每周固定节奏执行一次"扫描 → 评估 → 沉淀 → 记录"四步循环。

## 节奏

- **每周五**：执行一轮沉淀（约 30-60 分钟，可委派 worktree）
- **触发补充**：响应讨论区帖子时若发现新知识，顺手记录到"待沉淀"（反馈日志）

## 四步流程

### ① 扫描（5 分钟）

```bash
# 拉取官方库新帖（本周新增 + 我们未响应的高互动帖）
gh api graphql -f query='query { repository(owner: "deepseek-ai", name: "deepseek-harness") { discussions(first: 30) { nodes { number title category { name } comments { totalCount } } } } }'
```

筛选标准：本周新增帖 / comments 增长明显 / 我们响应过的帖中他人回复含新信息。

### ② 评估（10 分钟）

新知识分类：

| 类别 | 判据 | 沉淀目标 |
|---|---|---|
| **FAQ 候选** | 高频问题 / 有明确 workaround | docs/faq.md |
| **章节补充** | 深度踩坑 / 新边界 / 根因分析 | 对应章（2-14） |
| **生态收录** | 社区项目 / 插件 / 工具 | docs/07-ecosystem.md |
| **成本/安全** | token 消耗 / 安全边界 | 第 13/14 章 |
| **无需收录** | 闲聊 / 过时 / 重复已有内容 | —（忽略） |

### ③ 沉淀（20-40 分钟）

- 按类别更新对应文件（保持手册"实测 + 诚实"风格）
- 引用真实帖号（`#xxx` 链接）
- 标注推断内容（"（推断，待实测）"）
- 已收录内容的帖子响应中**回贴告知**（"已收录进手册 X 处"——激励社区贡献）

### ④ 记录（5 分钟）

更新 `docs/research/feedback-log.md`：

```markdown
## 2026-08-21 轮
| 来源帖 | 分类 | 沉淀位置 | 状态 |
|---|---|---|---|
| #xxxx | FAQ 候选 | faq.md 第 4 节 | ✅ 已沉淀 |
| #xxxx | 章节补充 | 03-profiles.md 3.4 | ✅ 已沉淀 |
```

## 沉淀优先级

1. **作者授权的**（如 #380 六坑收录）——最高优先，标注致谢
2. **高频复现的**（同问题 3+ 帖）——FAQ/对应章
3. **根因清晰的**（带源码定位/修复分支）——章节深入
4. **生态资产**（插件/工具/教程）——生态章节 + 社区案例征集

## 透明度

- 每次沉淀后，在**我们的 Discussion**（案例征集帖/进展帖）发一条"本周沉淀摘要"
- 让社区知道"反馈会被收录"——这是持续获取优质反馈的激励