dsh-obsidian: DeepSeek Harness 的 Obsidian 单插件

前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。dsh-obsidian 是一个把 Obsidian 变成「自组织 AI 第二大脑」的 DeepSeek Harness 单插件。它合并了 dsh-plugin-wiki-skills 和 dsh-plugin-wiki-tools 两个上游插件，旨在解决上游插件因 DSH 框架快速迭代而频繁破坏 API，以及拆分插件对个人用户不友好的问题。该插件提供统一的版本管理和清晰的 v2.x 升级路线。

核心功能¶

插件通过注册在 ctx.tools 和 ctx.skills 上提供能力。

工具（Tools）¶

工具名	作用
`wiki_query`	BM25 检索，返回片段与链接图；quick 模式返回 hot + index
`wiki_write`	单页写入，包含 type 路由、frontmatter 补全、index/log 记账与 source-hash 去重
`wiki_lint`	健康检查：检测重复、死链、孤儿页、frontmatter 缺失、空章节及失效的 index/hot
`wiki_scaffold`	初始化 LLM Wiki 目录结构（默认 dry-run）
`wiki_rename`	重命名页面（含机器页保护）
`wiki_list`	列出所有页面标题

技能（Skills）¶

技能名	作用
`wiki`	vault 脚手架与路由
`wiki-ingest`	将来源捕获进 vault
`wiki-query`	带引用地从 vault 回答问题
`wiki-lint`	健康检查工作流
`save`	归档对话洞察
`think`	10 原则推理循环
`obsidian-markdown`	Obsidian Flavored Markdown 支持
`obsidian-bases`	Bases 支持
`defuddle`	上下文去重
`obsidian-cli`	CLI 集成

安装与配置¶

前置条件¶

DSH 0.x 或更新（需包含 dsh plugin CLI）。
Node.js 版本 ≥ 22.19。
磁盘上有一个现有的 Obsidian vault。

安装步骤¶

在终端执行安装命令：

    dsh plugin --profile web add @qiqiangvae/dsh-obsidian

编辑你的 DSH profile 配置文件（例如 ~/.dsh/profiles/web/cordis.patch.yml），添加如下内容：

    - id: dsh-obsidian
      config:
        vaultPath: /absolute/path/to/your/obsidian/vault
        # 可选配置：
        # typeFolders: { domain: "wiki/areas" }
        # maxQueryResults: 10

重启 DSH 服务：

    dsh web

（可选）初始化全新 vault 目录结构：

    # 在 DSH CLI 中运行
    wiki_scaffold 工具，参数 { template: "default", apply: true }

锁定版本¶

若需锁定具体版本：

dsh plugin --profile web add @qiqiangvae/dsh-obsidian@0.1.0

技术细节¶

依赖与许可¶

依赖：@deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/schemastery。
许可证：MIT。
Scoped 包名：非 scoped 的 dsh-obsidian 已被其他无关 vault 文件系统插件占用，因此本包使用 @qiqiangvae/dsh-obsidian 作为唯一标识。

开发¶

插件基于 TypeScript 开发。开发时需执行 pnpm run build 将 src/ 编译至 lib/，随后在 DSH 中运行 dsh plugin --profile web add link:$(pwd) 进行本地调试。

注意事项¶

权限：插件以当前 DSH 进程的权限运行，请确保配置的 vaultPath 对进程可访问。
生态：该插件属于 DeepSeek Harness 生态，与 DeepSeek / 幻方无官方从属关系。
源码审查：在安装任何插件前，建议阅读源码与 ATTRIBUTION.md 以确认许可证兼容性与功能边界。