knowledge-framework-builder

name	knowledge-framework-builder
version	1.0.0
description	课程知识框架梳理工具 — 把课程主题或教材资料提炼成结构化知识脉络图，支持三档深度输出与多格式导出。 UseWhen: 1. 用户需要把课程/教材/笔记整理成知识框架或思维导图 2. 用户需要了解某门课的知识脉络、核心知识点、概念依赖关系 3. 用户提到"知识框架"、"知识脉络"、"章节脉络"、"课程梳理"、"知识梳理"、"核心知识点"、"重点提炼" 4. 用户提到"前置课程"、"概念依赖"、"教材目录梳理"、"教材结构图"、"笔记重组" 5. 用户提到"学科地图"、"学习地图"、"复习框架"、"考点框架"、"Markmap 生成"、"OPML 导出" 6. 用户提到 syllabus to mind map、study framework、textbook outline、course mind map、knowledge framework
display_name	知识框架梳理
display_name_en	Knowledge Framework Builder
description_zh	课程知识框架梳理工具，支持输入课程主题或教材资料（Markdown / DOCX / PDF / 图片截图 / URL），自动生成三档深度知识脉络图（框架 / 重点讲解 / 全节点讲解），含核心知识点提炼、概念依赖关系图、防幻觉溯源标注，多格式输出（Markdown / Markmap / Mermaid / OPML / PDF）。
description_en	Course knowledge framework builder that ingests a course topic or teaching materials (Markdown, DOCX, PDF, images, URLs) and outputs a three-depth knowledge map (skim / guided / deep), with key-point extraction, concept dependency graph, hallucination-prevention provenance, and multi-format export (Markdown, Markmap, Mermaid, OPML, PDF).
author	TPD

知识框架梳理（Knowledge Framework Builder）

面向大学生 / 教师 / 自学者的三档深度 + 核心知识点提炼 + 概念依赖 + 节点级防幻觉溯源的知识脉络图生成 Skill。 支持多种输入格式（Markdown / DOCX / PDF / 图片截图 / URL），多种输出格式（Markdown / Markmap / Mermaid / OPML / PDF）。

---

何时触发

• 用户说："帮我把『大学英语 / 高数 / 机器学习 / 408』梳理成知识框架 / 知识脉络"
• 用户说："这本书的目录给你，帮我画成思维导图 / 重组成知识框架"
• 用户贴了一份 Markdown / DOCX 笔记 + 提了"帮我整理成框架"
• 用户问："这门课先学什么再学什么？/ XX 概念依赖什么？/ 哪些是核心知识点？"
• 用户说："我看书越看越乱 / 知识点太散记不住 / 想要一张清晰的知识框架"

不触发：

• 视频 / 音频内容（不支持，请先转为文字）
• 整本书 RAG 问答（超出范围，建议分章节提交）
• 通用 brainstorm 思维导图（请补充具体课程主题）
• 单次超过 1 门课程（请分课提交）

💡 支持多种输入格式：Markdown / DOCX / 纯文本 / PDF（文本层）/ 图片截图（OCR 识别）/ URL 网页。图像层 PDF / 扫描件质量较低时会提示用户确认，但不强制拒绝。

---

核心原则

1. 三档深度自动切换：用户不选档，Skill 按输入内容自动判断：

   • 仅提供课程主题 → skim（3-5 层知识框架 + AI 推荐 3 个延伸问题）
   • 含重点话题 / 学习目标 / 初学者标记 → skim + guided（追加 5-10 重点节点 200-500 字讲解 + 核心知识点提炼与总结）
   • 含 deep_explain: true → skim + guided + deep（追加叶子节点讲解；单批 ≤ 15，分批生成，超出时询问继续）
   • preferences.depth_hint 可强制覆盖（force_skim / force_guided / force_deep）

2. 节点级防幻觉溯源：含数字 / 专名 / 公式 / 名词的节点，

   • 用户材料模式：必须能 ngram 匹配到原文 → 标注来源文件 + 章节 + 原文片段
   • 纯主题模式：所有节点标注为 AI 推断，顶部强制 ⚠️ banner："本框架完全为 AI 推断，建议核对教材"
   • 推断字段（如"难点提示""易混点""考点分布"）必须单独标注

3. 概念依赖关系必须"克制"挖掘：

   • 限制条数：≤ 总节点数 × 0.3（防止过度连线）
   • 每条必带置信度（高 / 中 / 低），保守策略下只输出高置信度
   • 类型必须是 6 类之一：前置条件 / 归纳关系 / 细化关系 / 对比关系 / 应用关系 / 工具关系
   • 严禁生成 "A 和 B 有关系" 这种空话；每条必须给出具体依赖原因

4. 重点节点选择必须可解释：

   • 频次策略：用户材料中出现次数 ≥ 阈值（仅材料模式有效）
   • 中心度策略：依赖图中入度 / 出度排名前 N（默认，最稳健）
   • 混合策略：两种各取一半

5. 节点讲解 200-500 字：按用户水平调整：

   • 初学者 → 多用比喻 + 例子 + 类比生活
   • 中级（默认）→ 平衡术语和解释
   • 高级 → 直接用术语 + 强调难点和易混点

6. 多格式输出：

   • 默认输出 Markdown + Markmap（最通用，浏览器双击即开）