ShadowBruceMeaningLau/dsh-course-logic-extractor

README 摘要

dsh-course-logic-extractor 「课程逻辑提取器」agent 预设的 dsh 插件版：读取一门课程/论文的资料（大纲、讲义、课件、字幕、习题、论文 PDF 等），还原它的设计逻辑——先教什么、后教什么、每个环节为什么放在那里、环节之间如何衔接，交付自洽的逻辑链分析报告 + 学习路线图 + 流程画布，让学习者在正式深入之前先看清全局。 安装后，预设 course-logic-extractor 会自动出现在 DSH 的预设选择器中，随插件分发到任何机器。 功能特性 - 三种输入模式 ：直接分析（给资料路径）· 论文模式（双视角：研究逻辑 + 学习逻辑）· 自主找资料（无资料时按学习需求走迭代确认制流程） - 入口分流（意图理解） ：按用户首条消息直接判断——给资料路径走标准流程、给学习需求（任何表达「想获得知识/技能/理解」的意图都算，不必出现「学」字，目的不是必要条件）走自主流程、两者都没给则先介绍本 agent 用法 - 自主找资料（迭代确认制） ：阶段一确定 能力点清单 （多层树形结构：一级并列 + 从属子能力点；过大能力点分解至可学习可检验的叶子；叶子标注前置/后置依赖与 掌握标准 ；依赖图必产）→ 阶段二确定 资料清单 （先问学习形态偏好：书籍自学/视频为主/AI 决定/其他；七列固定：覆盖能力点｜名称｜来源｜链接/位置｜形态｜价值评估｜状态）→ 资料落地（本地优先 → 网络下载 → 缺失由用户决断）；每阶段以用户明确表态「完全确定」为唯一出口，规划留档于 0-规划/ - 材料管线 ：PDF 渲染（MuPDF）→ OCR 转录（GLM-OCR）→ 质量对账 → 直出归档 → 优化稿可选 （直出后主动询问用户是否需要；仅为便于 Obsidian 阅读的易读性增强，与其他产出物无关，不需要可直接读 PDF 原件） - 交付物 ：逻辑链分析（七节 + frontmatter + 自检）· 学习路线图 · 流程图 canvas 集（ 1-报告/画布/ ）· 证据层 · 材料层（含质量报告） - 工程保障 ：单元测试（node:test）、CI（GitHub Actions 自动跑测试 + tag 自动发 Release） 安装 重启 dsh web （或任何使用 agent presets 的界面）。新建会话时在预设选择器里选「课程逻辑提取器」即可。 OCR 密钥（必需，否则转录功能不可用） OCR 走智谱 GLM-OCR（ glm-ocr ，专用端点 layout parsing ）。两种配置方式任选其一： 1. 环境变量： ZHIPU API KEY ；或 2. 配置文件： /.dsh/free-vision.json 增加字段 {"zhipuApiKey": "…"} 免费申请：https://open.bigmodel.cn 。…

分类