前言¶
在 DSH 里同时维护多个项目、插件和文档时，路径和说明往往散落在各处：对话里提到过，磁盘上也有，但缺少一个始终贴着工作区、可搜索又可手改的总览。用通用笔记或云盘可以记链接，数据却容易离开当前工作区，也和 DSH 侧边栏脱节。下面介绍社区插件 dsh-knowledge-base（npm 包名 dsh-workspace-kb）：把当前工作区整理成可搜索、可编辑的知识库，挂在 DSH Desktop 侧边栏，索引与笔记只写在本地 .knowledge-base/entries.json，不上传。
这是什么¶
维护者为 sd0426301x-dotcom。在 SkillHub 插件目录 中分类为「记忆」；简介为：Local-first, editable knowledge base for the DSH workspace, shown in the sidebar.
插件定位是「工作区知识索引 + 轻量笔记」，不是云同步工具，也不是完整笔记软件。它不联网、不上传、无遥测，也不需要 API Key；只读取你选择的工作区，数据留在本机。
核心功能¶
本地优先存储¶
条目、分类与笔记写入工作区根目录下的 .knowledge-base/entries.json。原项目、文档与图片仍在原路径，不会被移动或改写。备份知识库时，单独备份该 JSON 即可（默认被 .gitignore 忽略）。
自动归类与手改¶
新建条目时分类默认自动推断：
- 路径指向工作区内新文件夹时，用文件夹名建分类；
- 无路径时，按标题或说明中的关键词归类；
- 仍无匹配时，按短标题建分类（例如「量子计算」）。
也可在面板里新建、编辑、重命名或删除条目与分类；左侧分类栏底部可「＋ 新建分类」，选中分类后可「重命名分类」。自建分类在仍有条目时不可删除。
打开即扫描¶
每次打开知识库会重新扫描工作区，新项目与新插件会出现。无后台文件监听；需要时点右上角刷新。核心文件中的 Markdown、源码、JSON 可预览，图片可直接查看。
工作区内插件自动收录¶
将插件源码放在下列任一目录下：
<工作区>\插件\<插件名>\
<工作区>\plugins\<插件名>\
打开知识库时会生成卡片，标题与说明优先读 README，其次读 package.json。仅源码在工作区内的插件会被收录；只装进 DSH profile 的插件不会自动出现，此类条目归到「插件与开发」相关分类逻辑（README 写明自动卡片归「插件与开发」）。
环境与隐私¶
- 操作系统：README 写明目前只验证了 Windows 10/11；Linux/macOS 未验证。
- DSH：DSH Desktop，开发与验证版本为 0.2.1-rc.2 系列。
- Node.js：仅安装脚本需要；DSH 自带运行时通常可用。
插件以当前 DSH 进程权限读取工作区；安装前请自行查看仓库源码与 MIT 许可证。
安装与启用¶
不要运行 dsh plugin add dsh-knowledge-base。npm 上的 dsh-knowledge-base 是另一个「文档知识库」插件，会出现在对话页签；本仓库包名为 dsh-workspace-kb，须按仓库说明从本机目录安装。
-
获取源码：从 GitHub 仓库 使用 Code → Download ZIP，或从 Releases 下载 ZIP 解压到本机目录（README 亦给出
git clone示例，可按习惯选用其一）。 -
在解压或克隆目录中运行安装脚本：
node tools/install.mjs
脚本会在 DSH profile 的 node_modules 中建立指向本仓库的链接；若 profile 尚未将该包列为 bundle，会向 cordis.patch.yml 追加加载配置。
- 完全退出 DSH Desktop 再打开（不要用 Ctrl+R 刷新代替）。Host 在进程启动时加载，重启后侧边栏「插件」下会出现书本图标与「知识库」；侧栏收起时，左侧中间有书签小标签，展开即可见。
安装脚本找不到 profile¶
默认读取 %DSH_HOME%\profiles\desktop，或环境变量 DSH_PROFILE_DIR 指定的目录。若 DSH 使用其他 profile，先设置再安装：
$env:DSH_PROFILE_DIR = "C:\Users\<你>\.dsh\profiles\desktop"
node tools/install.mjs
检查与卸载¶
node tools/install.mjs --status
node tools/install.mjs --uninstall
若该包曾通过 DSH 插件管理器以 bundle 方式启用，卸载后还需在插件管理器中停用，或从 profile 的 dsh.profile.bundles 中移除。
典型用法¶
新建条目：右上角「＋ 新建」，只填标题也可保存；分类默认自动。
固定工作区根：默认使用当前 DSH 工作区（workingDirectory.defaultDirectory）。取不到或需固定目录时，可设环境变量：
$env:DSH_KB_ROOT = "D:\your-workspace"
或在插件行配置后重启 DSH：
- id: knowledge-base
config:
root: 'D:\your-workspace'
日常维护：打开面板即重扫；改 Host 代码需重启 DSH，仅改 UI 时刷新页面即可。
适用场景与注意¶
适合需要在 DSH 侧边栏长期维护「当前工作区地图」的开发者：项目入口、文档路径、自研插件卡片与简短笔记集中在一处，且数据不出本机。
已知限制（来自 README）：
- 侧边栏入口通过页面脚本注入并复用 DSH 侧栏 DOM，绑定当前 DSH Desktop 侧栏结构；其他 DSH 版本可能需要适配。
- 不是云同步，也无完整笔记产品级的组织方式。
- 无实时文件监听，依赖打开知识库或手动刷新。
DSH 生态强调「一切皆插件」；SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。本插件在目录页星标为 0，版本以仓库 package.json 为准（当前资料为 1.0.1）。
