dsh-plugin-wiki-tools

DeepSeek Harness (DSH) 的核心思想是「一切皆插件」。在构建基于 Obsidian 的知识库时，路径路由、文件去重、索引维护等机械性操作会消耗模型宝贵的轮次。dsh-plugin-wiki-tools 提供了原生工具集，实现了 Wiki 技能套件的机械核心，包括路径路由、来源增量追踪、索引簿记和健康检查，将文件系统操作从提示词逻辑中剥离，让模型专注于内容综合。

插件定位¶

本插件由 Lion-1209 维护，是 Obsidian vault 的原生 DeepSeek Harness 工具。它实现了知识库技能套件的基础设施，包括类型到文件夹的路由、Frontmatter 补全、唯一性校验、主索引更新以及来源差异追踪。

核心功能¶

wiki_query¶

提供两种查询模式：
* 快速模式：直接返回 hot.md 和 index.md 的原文内容，即技能读取的标准顺序。
* 标准模式：对内容页进行全文搜索，返回搜索片段、入链和出链图谱。

wiki_write¶

负责页面写入及完整的簿记工作：
1. 根据 type 自动路由到对应文件夹。
2. 自动补全 Frontmatter（更新时保留 created 和未知字段）。
3. 确保文件名在 vault 范围内唯一。
4. 自动更新主索引条目和日志条目。
5. 支持 source_path 参数记录来源哈希，仅在内容变更时写入（除非使用 force 强制覆盖）。

wiki_lint¶

对 Wiki 健康状况进行检查，结果仅报告并给出建议，输出到 wiki/meta/Lint Report <日期>.md：
* 重复文件名
* 死链
* 孤立页面
* Frontmatter 缺失
* 空章节
* 过期的索引条目
* 过期的热缓存

安装与配置¶

安装¶

使用官方命令安装插件：

dsh plugin --profile web add dsh-plugin-wiki-tools

配置¶

vaultPath 是必填项。在 profile 的 cordis.patch.yml 中覆盖 wiki-tools 配置项，指向 vault 根目录（需包含 wiki/ 和 .raw/ 目录），否则插件启动时会失败：

- id: wiki-tools
  config:
    vaultPath: /absolute/path/to/vault
    # 可选：重定向页面类型到特定文件夹
    typeFolders:
      domain: wiki/areas

技术细节与依赖¶

• 环境要求：Node 版本需 >= 22.19.0。
• 文件系统访问：Vault 是宿主机本地用户数据，独立于 DSH 会话工作区，旨在支持跨项目引用。
• 并发控制：针对每个目标文件的写入在进程内串行化执行，文件名通过 vault 级别去重保护。
• 架构参考：Vault 布局和操作契约遵循 LLM Wiki 模式（Andrej Karpathy），形态源于 claude-obsidian。

典型用法¶

1. 与技能套件配合：与 dsh-plugin-wiki-skills 配合使用，后者提供提示词级别的技能（如 wiki、wiki-ingest、wiki-query、wiki-lint、save），本插件处理机械层。
2. 与 Web UI 配合：与 dsh-wiki-web 配合，可在浏览器中浏览、BM25 搜索、查看链接图谱和 Lint 仪表盘，无需 Obsidian 客户端。
3. 前置准备：在配置 vaultPath 前，需先用 wiki 技能的 SCAFFOLD 操作搭建 vault 结构。

总结¶

本插件通过将机械性文件操作标准化，降低了维护 Obsidian Wiki 的心智负担，适合需要高度自动化知识库管理的 DSH 用户。

• 目录页
• GitHub 仓库