dsh-wikilink
中文版 README：README.zh.md · 简体中文文档入口
Obsidian-style [[wikilink]] mentions for the DeepSeek Harness web GUI. Type [[ in the composer and a note-title picker floats up: fuzzy search your workspace notes as you type — including out-of-order (subsequence) matches (「曼食」 finds 曼谷街头美食文化观察) and space-separated multi-term matches (「曼谷 美食」 finds 曼谷街头美食文化观察 / 曼谷笔记：美食 / 曼谷朱拉隆功夜市美食探索). Press Enter to attach, and the referenced note content ships to the model when the message is sent.
composer: summarize [[曼谷 美. ← picker over the open token
┌────────────────────────────────────────────────────────┐
│ 📄 曼谷街头美食文化观察：鱼鳔老太太摊位的夜间消费场景 │
│ 📄 曼谷笔记：美食 │
│ 📄 曼谷朱拉隆功夜市美食探索：KINNKUNG海鲜馆的惊喜体验 │
└────────────────────────────────────────────────────────┘
draft: summarize [[曼谷笔记：美食]] ← readable plain-text token
model: <note path="5-存档/06-专题档案/数字游民/曼谷笔记：美食.md" title="曼谷笔记：美食">…content…</note> ← injected at send time
Type [[query and the picker opens exactly on the double bracket; Enter replaces the token with [[title]] and the caret lands after ]] (Obsidian-style). A single [ in prose never triggers it.
No harness patches needed
Earlier versions patched the installed @deepseek-ai client bundles to make the [[ trigger work (the harness input pipeline only recognizes / and @). Since v0.2 the picker is fully self-drawn: the plugin watches the draft itself, renders its own floating menu on the public conversation.input.overlay slot, and writes the closed [[title]] back through the public input actions. No patches, no re-apply step — install, restart, done.
Install
Compatibility: v0.2.1+ requires dsh ≥ 0.1.2-rc.1. dsh 0.1.2-rc.1 removed the settingsNamespace() factory from @deepseek-ai/dsh-settings; the plugin registers its wikilink namespace as a plain string literal since v0.2.1 (it still runs on older dsh releases — the string form was always the underlying wire format).
dsh plugin --profile web add https://github.com/zhaoscsc/dsh-wikilink/archive/refs/heads/main.tar.gz
Restart the web server so the host half and the served client bundle pick up the plugin. The enable switch lives in Settings → Wikilinks.
Configuration
Host-side tunables on the plugin row in the profile patch layer:
- id: dsh-wikilink
config:
maxIndexedFiles: 100000 # hard cap on indexed entries (large vaults need this)
maxFileBytes: 262144 # hard cap on one attached note; larger files are refused
ignoreDirs: ['.git', 'node_modules'] # directory basenames the walk skips
The index is cached per session for 30 seconds; an index-status strip above the composer reports indexing in progress / done (with the note count) / failed.
Model experience
| Aspect | Effect |
|---|
| Token cost | One attached note adds its complete content (up to maxFileBytes) to the request. |
| Tool calls | None — the content is already in the prompt. |
| Message format | Each note serializes as <note path="…" title="…">…</note>, injected as a user-role message with source wikilink-mention. |
| Resolution | [[dir/title]] resolves by exact path; [[title]] resolves only when the title is unique; unresolvable or ambiguous tokens stay plain prose. |
Matching
Four tiers over the note title (then the relative path): contiguous substring > subsequence (out-of-order) > path substring > path subsequence. Queries split on whitespace must all match (AND). Both query and titles are NFC-normalized.
Real examples from a travel-note vault:
| Query | Result |
|---|
[[曼谷 美食]] | 曼谷街头美食文化观察：鱼鳔老太太摊位的夜间消费场景 · 曼谷笔记：美食 · 曼谷朱拉隆功夜市美食探索 |
[[曼食]] (out-of-order) | 曼谷街头美食文化观察（matches across skipped characters) |
[[鱼鳔]] | 曼谷街头美食文化观察：鱼鳔老太太摊位的夜间消费场景 |
Known limitations
- The picker triggers on the last unclosed
[[/【【 anywhere in the draft, with the query running to the draft end — the public input state carries no caret info, so caret-not-at-end doesn't trigger.
- The self-drawn menu is styled and key-handled by the plugin itself, so it evolves independently from the
/ and @ pipeline menus.
- The workspace index is cached per session for 30 seconds; files created later appear on the next menu open after that window.
- A note literally named
.md is skipped (its empty title would fail the wire schema).
- IME caveat: some Chinese input methods (Sogou, WeChat, Baidu, system Pinyin, …) have a symbol auto-completion feature (smart punctuation / bracket auto-pairing) that auto-inserts a closing bracket when you type
[ or 【 ([ → [], 【 → 【】). That breaks the double-open detection and the picker never opens. Disable symbol auto-completion in the input method settings (it may be called smart punctuation / bracket auto-pairing / symbol suggestion).
Development
node build.mjs # esbuild is vendored under ./node_modules; zod is inlined into the client bundle
See DEV.md for the architecture (self-drawn picker — no harness patches) and the build/dev loop.
Changelog
- v0.2.1 — Adapt to dsh 0.1.2-rc.1:
@deepseek-ai/dsh-settings dropped the settingsNamespace() factory, so the plugin now registers the wikilink namespace as a plain string literal.
- v0.2.0 — Zero-patch self-drawn picker (no harness patches needed); fuzzy and subsequence title matching; fullwidth
【【 trigger support.
License
MIT
