知识枢纽查询引擎。在 /write 工作流中主动检索课程知识库，支持三层查询漏斗： (1) 轻量索引扫描 knowledge_hub.yaml (2) 精准关键词检索 search_knowledge.py (3) 精确段落提取 view_file(StartLine, EndLine) 亦负责将网络搜索结果存档为 notes/，保持 hub 持续增长。 触发词：「查教材」「找定义」「有无资料」「搜一下 X」以及 /write 工作流自动触发。
配套规则：知识检索的饱和度门限和素材覆盖率定义见
.agent/rules/rule_content_depth.md§1。
何时触发：进入 /write 的 Step 2.3，或用户明确要求查找知识。
Step 1.1 加载 hub（整个写作周期仅一次）
view_file("<课程>/knowledge/knowledge_hub.yaml")
Step 1.2 按知识点匹配
扫描所有 entries 的 tags 和 summary 字段，找出命中条目。
Step 1.3 决策
| 条目类型 | summary 够用？ |
|---|
| 行动 |
|---|
textbook / note | ✅ 是 | 直接引用 summary 写作 |
textbook / note | ❌ 否 | 进入 §2 精准检索 |
tracking (pending) | — | 进入 §3 网络搜索 + §4 存档 |
| 无命中 | — | 追加 tracking，进入 §3 |
何时触发：hub summary 不足以满足写作需求时。
# 同时搜索 hub 摘要层 + textbook 章节层
python .agent/skills/librarian/scripts/search_knowledge.py \
--course "<课程名>" "<关键词1>" "<关键词2>"
解读结果：
[
{
"type": "hub",
"id": "affordance-01",
"summary": "Norman 对可供性的经典定义...",
"query_hint": "search_knowledge.py 'affordance'"
},
{
"type": "textbook",
"book": "Interaction Design...",
"chapter": "3.2 Conceptual Models",
"path": "knowledge/textbook/.../chapter_05_Chapter_3.md",
"lines": [45, 120]
}
]
→ 对 textbook 类型结果，取 path 和 lines 进入 §2.1。
# 仅提取有效行范围，加 20 行缓冲
view_file(
AbsolutePath="<课程>/knowledge/textbook/...",
StartLine=45,
EndLine=140 # end_line + 20
)
禁止 省略 StartLine/EndLine 读整章。每次读取 ≤ 100 行。
激活 narrative_archaeologist 3-Pass Protocol 进行搜索。
或直接执行：
search_web("<关键词> site:nngroup.com OR site:interactions.acm.org OR filetype:pdf")
read_url_content("<最佳候选 URL>")
质量门限（采用前必须满足所有条件）：
结构：
## 核心要点
（2-5 条要点）
## 可用叙事角度
（供 script_format 使用的故事/案例角度）
## 原始引用
> "..."
## 与课程的关联
（说明此知识点与哪个教学单元/知识点对应）
python .agent/skills/librarian/scripts/archive_web.py \
--course "<课程名>" \
--id "<唯一ID，连字符格式>" \
--title "<标题>" \
--tags "<tag1,tag2,tag3>" \
--source-url "<URL>" \
--summary "<30-60字中文摘要>" \
--content-file <笔记文件路径>
结果验证：脚本输出 "status": "ok" 且 knowledge_hub.yaml 中条目 type 变为 note。
若 hub 和 textbook 均无命中，追加到 <课程>/knowledge/tracking.md：
| T<序号> | <主题> | "<搜索关键词>" | <URL 或 —> | 🔍 待搜索 |
| 需求 | 工具 |
|---|---|
| 加载全部摘要 | view_file(...knowledge_hub.yaml) |
| 关键词检索 | search_knowledge.py --course X "关键词" |
| 读教材段落 | view_file(path, StartLine=N, EndLine=M) |
| 存档网络内容 | archive_web.py --course X --id Y ... |
| 网络搜索 | search_web(...) + read_url_content(...) |
scripts/search_index.py：旧教材索引搜索（仍可用，已由 search_knowledge.py 统一封装）scripts/search_knowledge.py：统一知识搜索入口（新）scripts/archive_web.py：网络内容存档工具（新）