Lion-1209/dsh-plugin-wiki-tools

dsh-plugin-wiki-tools

npm version
npm weekly downloads
License: MIT
Awesome DSH Plugin

用于 Obsidian wiki vault 的原生 DeepSeek Harness 工具：wiki_query、wiki_write 和 wiki_lint 实现了 wiki 技能套件的机械核心——路径路由、frontmatter 补全、索引/日志记账、来源增量追踪和健康检查——让模型把回合花在综合上，而不是文件系统杂务上。

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

搭配 dsh-plugin-wiki-skills 使用可获得提示词级技能（wiki、wiki-ingest、wiki-query、wiki-lint、save），搭配 dsh-wiki-web 可在同一 vault 上获得自托管 Web UI——在浏览器中浏览、BM25 搜索、链接图谱和 lint 仪表盘，无需 Obsidian。

如果这套工具链为你维护 wiki vault 节省了时间，一个 ⭐ 能帮助其他 dsh 用户发现它。如果这个工具帮到了你，欢迎点个 Star。

归属

vault 布局和操作契约遵循 LLM Wiki 模式（Andrej Karpathy），并由 claude-obsidian（MIT，© 2026 AgriciDaniel）具体实现。本包是机械核心的独立纯 ESM 实现；它不包含来自 claude-obsidian 的任何代码或技能文本。

工具

| 工具 | 功能 |
| --- | --- |
| wiki_query | 快速模式原样返回 hot.md + index.md（技能的读取顺序）；标准模式是对内容页面进行全文搜索，带片段和入站/出站链接图谱 |
| wiki_write | 写入一个页面并完成完整记账：类型→文件夹路由、frontmatter 补全（更新时保留 created 和未知字段）、文件名唯一性保护、主索引条目、日志条目；使用 source_path 时，记录来源哈希并跳过未更改的来源，除非指定 force |
| wiki_lint | 健康检查：重复文件名、失效 wikilink、孤立页面、frontmatter 缺失、空章节、过期索引条目、过期热缓存——仅报告，附带建议，写入 wiki/meta/Lint Report .md |

安装与配置

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

vaultPath 是必填项。在你从配置文件的 cordis.patch.yml 中设置它之前，启动会大声失败：

- id: wiki-tools
config:
vaultPath: /absolute/path/to/vault
optional: reroute page types to your vault's folders; index section
标题遵循映射后的文件夹名（例如 "## Areas"）
typeFolders:
domain: wiki/areas

vault 是包含 wiki/ 和 .raw/ 的目录——先用 wiki 技能的 SCAFFOLD 操作搭建它。maxQueryResults（默认 10）为可选项。wiki_write 会按该 section 自身的风格（:  或  — ）刷新已有的索引条目，因此使用 em-dash 的 vault 能保持一致。

设计说明

- vault 是位于任何会话工作区之外的主机本地用户数据（跨项目引用正是其目的），因此这些工具通过 node:fs 针对显式配置的绝对根目录进行读写——而非 dsh 文件系统接缝。
- 写入按目标文件在进程内串行化；文件名在整个 vault 范围内保证唯一，因为 wikilink 按裸名称解析。
- 通过 defineTool 注册到 ctx.tools；无论 vault 内容如何，schema 保持稳定。

开发

npm install
node --test

许可证

MIT

中文

Obsidian wiki vault 的 DeepSeek Harness 原生工具：wiki_query、wiki_write、wiki_lint 实现知识库技能套件的机械核心（路径路由、frontmatter 补全、索引/日志簿记、来源增量追踪、健康检查），让模型把轮次花在综合而非文件操作上。与 dsh-plugin-wiki-skills（提示词技能）和 dsh-wiki-web（同一 vault 的自托管 Web 界面：浏览、BM25 搜索、链接图谱、lint 仪表盘，无需 Obsidian）配套使用。

出处

vault 布局与操作契约遵循 LLM Wiki 模式（Karpathy），形态来自 claude-obsidian（AgriciDaniel，MIT）。本包为独立的纯 ESM 实现，不含 claude-obsidian 的代码或技能文本。

安装与配置

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

vaultPath 为必填项：在你的 profile cordis.patch.yml 里覆盖 wiki-tools 行的 config 指向 vault 根目录（含 wiki/ 与 .raw/，先用 wiki 技能的 SCAFFOLD 操作搭建），否则启动时会明确报错并给出示例。