前言¶
给智能体做长线项目时，一个常见问题是知识留不下来：实体、概念、决策散落在一次次会话里，下次开工要么靠模型硬记，要么人工搬运笔记。Claude 生态的 claude-obsidian 用一套以提示词为中心的 vault 工作流验证了「让智能体自己维护 wiki」的可行性，但 dsh 用户无法直接复用。下面介绍的 dsh-plugin-wiki-skills 做的就是这个移植：把 claude-obsidian 衍生的知识库技能套件打包成 DeepSeek Harness 插件，让 dsh 智能体具备建 wiki、摄入资料、查询回答、健康检查、写回洞见的完整链路。
这是什么¶
dsh-plugin-wiki-skills 由 Lion-1209 维护，当前版本 0.2.2，MIT 许可。核心是五个技能：wiki、wiki-ingest、wiki-query、wiki-lint、save，外加 think、obsidian-markdown、obsidian-bases、defuddle 四个支撑技能。vault 设计遵循 Andrej Karpathy 描述的 LLM Wiki 模式。
工程上，插件以只读 bundled provider 挂载到 ctx.skills 注册表，通过 dsh.bundle patch 插入一行 wiki-skills，不做侵入式修改。
核心功能¶
五个核心技能按职责划分：
wiki：Vault setup、scaffolding、cross-project referencing、hot-cache management；wiki-ingest：将来源摄入 vault，抽取实体/概念、建立交叉引用、记录日志；wiki-query：基于 vault 回答，检索顺序为 hot cache → index → pages，并附引用；wiki-lint：健康检查，覆盖 orphans、dead links、frontmatter gaps、stale index entries；save：将对话洞见写回 vault。
支撑技能方面：think 提供 10 原则推理循环（OBSERVE…GROW），所有 wiki 技能都映射在这套循环之上；obsidian-markdown 是 Obsidian Flavored Markdown 语法参考（wikilinks、callouts、embeds）；obsidian-bases 是 Obsidian Bases 参考，用于对 note 属性做数据视图；defuddle 负责在摄入前清洗抓取的网页，输出无广告的可读文本。
实现细节有三点值得注意：
1、注册名为 wiki-skills 的单个 provider，候选 rank 为 bundled-rank (600)；
2、每个技能声明 resourceBase: directory，正文可以引用 references/ 下的同级文件；
3、frontmatter 格式错误时在发现阶段直接报错，而不是静默跳过某个技能。
出处与适配范围¶
五个技能改编自 AgriciDaniel（AI Marketing Hub）的 claude-obsidian（MIT 许可，见仓库中的 ORIGINAL_LICENSE），基于其 v1 时代以提示词为中心的版本，经 ZCode 适配后再度适配到 dsh。
本适配版的改动：移除上游推广页脚（Community Footer）与未打包子技能（autoresearch、canvas）的路由行；为每个技能加上 dsh 适配说明。上游的 autoresearch、canvas、wiki-cli、wiki-fold、wiki-mode、wiki-retrieve 技能未打包，research 与 canvas 工作流仍是上游功能；上游产品脚本（transport detection、wiki-mode.py、wiki-lock.sh、DragonScale address allocation、.vault-meta/）同样未打包，机械核心由配套包 dsh-plugin-wiki-tools 的原生工具承担。
安装与启用¶
运行环境要求 Node.js >=22.19.0（engines 约束），依赖 yaml ^2.8.0。
安装只需一条命令：
dsh plugin --profile web add dsh-plugin-wiki-skills
这条命令把插件装进 web profile。包内声明了 dsh.bundle patch，加载时会向 ctx.skills 注册表插入一行 wiki-skills，以只读 bundled provider 的形式提供技能。
典型用法¶
建议与 dsh-plugin-wiki-tools 配对使用，后者提供原生的 wiki_query / wiki_write / wiki_lint 工具，承担这套技能的机械核心。
按各技能的路由，一套典型链路是：先用 wiki 搭建 vault 并做 scaffolding；网页等来源先经 defuddle 清洗，再用 wiki-ingest 抽取实体与概念、建立交叉引用；需要答案时由 wiki-query 按 hot cache → index → pages 的顺序检索并附引用；定期跑 wiki-lint 检查 orphans、dead links 等问题；会话中的洞见用 save 写回。
如果是参与开发，先做依赖安装，再跑测试：
npm install
node --test
适用场景与注意¶
适合在 dsh 上维护长期项目的智能体开发者，尤其希望知识沉淀为 Obsidian vault（技能直接引用了 Obsidian Flavored Markdown 与 Bases）的场景。使用前注意三点：
1、bundled-rank (600) 意味着同名的 project、runtime、user 技能优先于本套件，想覆盖默认行为可以写同名技能；
2、research 与 canvas 工作流不包含在本插件内；
3、插件以当前 dsh 进程权限运行，安装前建议自行检查源码与许可证。许可证方面，本打包为 MIT，打包的技能内容衍生自 claude-obsidian（同样 MIT），详见 ORIGINAL_LICENSE。
结尾¶
经过上面的步骤，dsh 智能体就能拥有一套来源清晰、可查询、可体检的持久知识库，且整套移植保留了上游的归属说明。项目地址与收录页：
- GitHub：https://github.com/Lion-1209/dsh-plugin-wiki-skills
- 社区目录页：https://www.skillhub.cn/plugins/Lion-1209/dsh-plugin-wiki-skills
社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
