前言¶
在 DSH 上做长期学习任务时，进度和笔记往往散落在对话、文件或外部工具里，很难按「阶段—主题—节点」串起来，也不方便在更换环境前做备份。若只靠通用记忆插件，通常缺少按路线图维度的完成态、笔记关联和可视化浏览。
下面介绍社区插件 dsh-studio-knowledge（维护者 1997liuyh-boop）：在 Desktop 中提供 Knowledge studio，用分阶段主题、进度、笔记和本地知识图，把个人学习路线收拢在一处，并支持 JSON 导入导出。插件归类为「记忆」类能力，当前 GitHub 星标为 0；源码 MIT 许可，版本 0.2.3（以 package.json 为准）。
这是什么¶
dsh-studio-knowledge 是 DSH 的 Studio 型插件，定位接近仓库自述：Personal learning-roadmap studio with staged topics, progress, notes and a local knowledge graph（个人学习路线工作室，含分阶段主题、进度、笔记与本机知识图）。
它解决的是：在 DSH 进程内维护路线图、按阶段查看主题与完成状态、记录笔记，并在图视图中查看节点之间的关联；进度按路线图、阶段、节点隔离存储，不与其他 studio 或项目混在一起。
核心功能¶
以下能力均来自仓库 README 与 package.json 说明，未在文档中出现的特性不写进正文。
示例路线图与分阶段浏览¶
- 内置六阶段示例 「My learning plan」，可直接作为起点。
- 按阶段浏览主题、完成状态与笔记。
- 提供 graph view，用于查看节点之间的链接关系。
进度与笔记的导入导出¶
- 支持以 JSON 导入、导出进度与笔记。
- 路线定义不会在导入时被静默覆盖（route definitions are not silently imported），避免误操作改掉自定义路线图结构。
自定义路线图（源码侧）¶
- 可添加受源码管理的路线图：唯一 ID、描述、资源链接与主题列表。
- 进度键值为 路线图 + 阶段 + 节点，与其他 studio / 项目隔离。
运行与依赖关系¶
- 主入口：
main: lib/index.js；客户端导出：exports./client: lib/client.js。 - 通过
dsh.bundle.patch: ./cordis.patch.yml参与 bundle；前端为 web 平台，并注入@deepseek-ai/dsh-client-ui-slots。 peerDependencies含dsh-studio-projects、dsh-worktable（均为 optional）；engines.dsh要求与当前 DSH 发行版匹配（见package.json）。
安装与启用¶
安装顺序在 README 中写得很明确：先装 control bundle（dsh-studio-library），再装本 studio。须在 完全退出 Desktop 后，用官方 Desktop 插件管理器执行下列命令（将 <Desktop install directory> 换成本机安装路径）：
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "github:1997liuyh-boop/dsh-studio-library#v0.1.3"
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "github:1997liuyh-boop/dsh-studio-knowledge#v0.2.3"
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop list
安装后按 README 核对：main: lib/index.js、exports./client: lib/client.js、dsh.bundle.patch: ./cordis.patch.yml，以及构建产物中的 static 入口。然后 重启 Desktop，在界面中打开 「Knowledge studio」。
若从源码构建，README 要求 Node.js 22 与 npm；自定义路线图需在 studios/knowledge/src/roadmaps.ts 中维护并重新 build（npm run build 对应 node scripts/build.mjs）。
典型用法¶
- 从示例起步：重启后进入 Knowledge studio，基于内置六阶段「My learning plan」熟悉阶段、主题与图视图。
- 记录与回顾：在对应阶段/主题下更新完成状态与笔记；用图视图查看节点链接，而不是只在列表里点选。
- 备份与迁移：在清空本机 DSH 数据或换机前，用 JSON 导出进度与笔记；迁移后再 导入。注意路线定义不会被静默导入，若路线图本身有改动，需在源码或仓库约定流程中单独处理。
- 扩展路线图（进阶）：在克隆或下载的源码树中编辑
studios/knowledge/src/roadmaps.ts，赋予路线图唯一 ID、描述、资源链接与主题列表，执行 build 后再由 Desktop 加载对应插件版本。
适用场景与注意¶
适合谁
- 需要在 DSH Desktop 内做 结构化自学（分阶段、可勾选进度、笔记与知识图）的开发者或个人用户。
- 希望进度与笔记 留在本机、并能用 JSON 做备份的用户。
权限与信任
DSH 插件在 当前 DSH 进程权限 下运行。安装前应阅读 GitHub 仓库 源码与 MIT 许可证；外部路线图内容与外链须自行确认使用权（README 明确：External links and roadmap content must be used with permission）。外部内容的权利归属见仓库 UPSTREAM.json。
数据与限制
- 进度与笔记为 本地 数据；README 提醒：清 DSH 数据前务必先导出 JSON。
- 社区目录 SkillHub 插件页 与 GitHub 为信息发布渠道；DSH 生态强调「一切皆插件」，该站点与 DeepSeek / 幻方无官方从属关系，不宜当作官方应用商店。
结尾¶
dsh-studio-knowledge 把学习路线、阶段进度、笔记和节点关系图收进同一个 Studio，并用 JSON 做可迁移的进度备份；与仅依赖对话记忆的用法相比，更适合长期、可复盘的学习项目。
