前言¶
在 DeepSeek Harness 的 web GUI 裏，把 workspace 筆記作爲上下文交給模型，通常要先找到文件，再把正文複製到 composer。zhaoscsc/dsh-wikilink 提供另一個入口：在 composer 輸入 [[，按 Obsidian 風格選擇筆記標題，發送消息時自動把所選筆記內容注入 prompt。
DSH 插件生態常被概括爲“一切皆插件”。這裏的插件目錄頁屬於社區目錄，與 DeepSeek / 幻方無官方從屬關係，不等同於官方應用商店。下面按能力、安裝、用法和注意事項介紹這個插件。
這是什麼¶
zhaoscsc/dsh-wikilink 是用於 DSH web GUI 的插件，由 zhaoscsc 維護，許可證爲 MIT。它把“從 workspace 筆記中挑一條內容加入 prompt”的操作，變成在 composer 中輸入 [[、選擇標題、發送消息的短路徑。
自 v0.2 起，插件自繪 picker，無需 patch harness/client bundle。
核心功能¶
[[wikilink]] 提及¶
在 composer 輸入 [[ 後，會打開筆記標題選擇器。輸入過程中可以模糊搜索 workspace 筆記。
匹配包括四級：
1、順序子串
2、亂序子序列
3、路徑子串
4、路徑子序列
空格分隔的多詞查詢按 AND 匹配。選中某條結果後，composer 中會生成 [[title]] 令牌。
發送時注入 prompt¶
發送消息時，插件會將所引用筆記內容注入 prompt。該過程不調用工具，筆記內容直接進入 prompt。
單個附件筆記最多注入完整內容，受 maxFileBytes 上限約束。每條筆記會序列化爲：
<note path=... title=...>...</note>
該筆記作爲 user-role message 注入，source 爲 wikilink-mention。
安裝與啓用¶
先執行安裝命令：
dsh plugin --profile web add https://github.com/zhaoscsc/dsh-wikilink/archive/refs/heads/main.tar.gz
這條命令把插件加入 web profile。安裝後需要重啓 web server，使宿主端和被 served 的 client bundle 加載插件。
然後在設置中啓用：
Settings → Wikilinks
打開其中的啓用開關。
典型用法¶
1、在 composer 中輸入 [[。
2、繼續輸入查詢詞。picker 會在雙括號處打開，並顯示可匹配的筆記標題。
3、按 Enter 將 token 替換爲 [[title]]，光標落在 ]] 後。
4、發送消息。所引用筆記的內容按前面的 <note path=... title=...>...</note> 形式注入 prompt。
使用時的行爲邊界：
- 單個
[不會觸發 picker。 - picker 觸發於 draft 中最後一個未閉合
[[或【【。 - 查詢會運行到 draft 末尾；如果 caret 不在末尾，則不觸發。
- 索引按會話緩存 30 秒。之後新建文件會在該窗口結束並下次打開 picker 後出現。
- composer 上方會顯示索引狀態。
主機側配置¶
可以在 profile patch layer 的 dsh-wikilink 行配置以下字段：
maxIndexedFiles
maxFileBytes
ignoreDirs
maxIndexedFiles：限制索引條目數量。maxFileBytes：限制單個附件筆記可注入內容的字節上限。ignoreDirs：用於跳過指定目錄。
適用場景與注意¶
這個插件適合在 DSH web GUI 中經常引用 workspace 筆記的人：它把找筆記、複製正文、粘貼進 prompt 的步驟壓縮爲一次 [[ 選擇。
使用前需要注意：
- 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證。
- 文件名爲
.md的筆記會被跳過。 - 部分中文輸入法的符號自動補全會把
[或【自動補全爲成對方括號，導致 picker 不打開。若遇到這種情況，需要關閉該輸入法設置。
鏈接¶
dsh-wikilink 的價值集中在一個點：在 DSH web GUI 中，用 [[wikilink]] 快速把 workspace 筆記帶進 prompt。
GitHub：https://github.com/zhaoscsc/dsh-wikilink
目錄頁：https://www.skillhub.cn/plugins/zhaoscsc/dsh-wikilink
