前言¶
在 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