dsh-wikilink:在 DeepSeek Harness Web GUI 中用 [[wikilink]] 引用笔记

前言

在 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。

核心功能

在 composer 输入 [[ 后,会打开笔记标题选择器。输入过程中可以模糊搜索 workspace 笔记。

匹配包括四级:

1、顺序子串
2、乱序子序列
3、路径子串
4、路径子序列

空格分隔的多词查询按 AND 匹配。选中某条结果后,composer 中会生成 [[title]] 令牌。

发送时注入 prompt

发送消息时,插件会将所引用笔记内容注入 prompt。该过程不调用工具,笔记内容直接进入 prompt。

单个附件笔记最多注入完整内容,受 maxFileBytes 上限约束。每条笔记会序列化为:

<note path=... title=...>...</note>

该笔记作为 user-role message 注入,sourcewikilink-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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜