Native tools for an Obsidian wiki vault: wiki_query, wiki_write, wiki_rename, wiki_scaffold, wiki_archive, and wiki_lint cover BM25 search with link-graph context, bookkeeping writes with sha256 source tracking, vault-wide renames, mode scaffolds, source archiving, and health checks — with cross-process locks and optional git auto-commit.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-plugin-wiki-tools
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:Lion-1209/dsh-plugin-wiki-tools
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
English | 中文
Native DeepSeek Harness tools for an Obsidian wiki vault: wiki_query, wiki_write, and wiki_lint implement the mechanical core of the wiki skill suite — path routing, frontmatter completion, index/log bookkeeping, source delta tracking, and health checks — so the model spends its turns on synthesis instead of filesystem chores.
dsh plugin --profile web add dsh-plugin-wiki-tools
Pair with dsh-plugin-wiki-skills for the prompt-level skills (wiki, wiki-ingest, wiki-query, wiki-lint, save), and with dsh-wiki-web for a self-hosted web UI over the same vault — browse, BM25 search, link graph, and lint dashboard in the browser, no Obsidian required.
If this toolchain saves you time maintaining a wiki vault, a ⭐ helps other dsh users find it. 如果这个工具帮到了你,欢迎点个 Star。
Attribution
The vault layout and operation contracts follow the LLM Wiki pattern (Andrej Karpathy) as embodied by claude-obsidian (MIT, © 2026 AgriciDaniel). This package is an independent plain-ESM implementation of the mechanical core; it contains no code or skill text from claude-obsidian.
Tools
| Tool | What it does |
|---|---|
wiki_query |
Quick mode returns hot.md + index.md verbatim (the skill's read order); standard mode is full-text search over content pages with snippets and the inbound/outbound link graph |
wiki_write |
Writes one page with complete bookkeeping: type→folder routing, frontmatter completion (keeps created and unknown fields on update), filename-uniqueness guard, master-index entry, log entry; with source_path, records the source hash and skips unchanged sources unless force |
wiki_lint |
Health check: duplicate filenames, dead wikilinks, orphan pages, frontmatter gaps, empty sections, stale index entries, stale hot cache — report only, with suggestions, written to wiki/meta/Lint Report <date>.md |
Install and configure
dsh plugin --profile web add dsh-plugin-wiki-tools
vaultPath is required. The boot fails loud until you set it from your profile's cordis.patch.yml:
- id: wiki-tools
config:
vaultPath: /absolute/path/to/vault
# optional: reroute page types to your vault's folders; index section
# headings follow the mapped folder name (e.g. "## Areas")
typeFolders:
domain: wiki/areas
The vault is the directory holding wiki/ and .raw/ — scaffold it first with the wiki skill's SCAFFOLD operation. maxQueryResults (default 10) is optional. wiki_write refreshes existing index entries in the section's own style (: or —), so em-dash vaults stay consistent.
Design notes
- The vault is host-local user data outside any session workspace (cross-project referencing is the point), so the tools read and write through
node:fsagainst the explicitly configured absolute root — not a dsh filesystem seam. - Writes serialize per target file in-process; filenames are guarded unique vault-wide because wikilinks resolve by bare name.
- Registers on
ctx.toolsviadefineTool; schemas stay stable regardless of vault contents.
Develop
npm install
node --test
License
中文
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 操作搭建),否则启动时会明确报错并给出示例。
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37587
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37004
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8181
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5867
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2153
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 1490
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.