前言¶
在 DeepSeek Harness (DSH) 的开发流程中，/ 菜单是快速调用命令和技能的核心入口。然而，默认的过滤器机制较为基础：命令源依赖有序子序列匹配，技能源依赖字面名称前缀。这导致通过简写（如 dshp）难以找到以连字符分隔的技能或命令。
dsh-better-command 插件通过提供更智能的匹配服务，解决了这个问题。它旨在提升 / 菜单的候选者排名质量，使得开发者可以通过更自然的缩写快速定位目标。
插件定位¶
这是由 Lovstudio 维护的 DSH 插件，并非 DeepSeek-AI 官方包。它提供了 slashMatcher 服务，这是一个分隔符透明且缩写感知的候选者排名器。当插件挂载后，/ 菜单（ui-commands 和 ui-skill）会在候选阶段调用该服务。
核心功能¶
该插件通过运行时替换机制增强匹配能力：
- 分隔符透明：在名称和查询中，连字符
-、下划线_、点号.和空格被视为透明字符。例如，输入dshp可以匹配dsh-plugin-creator。 - 缩写感知与边界权重：支持单词首字母缩写，且单词开头的缩写得分更高。例如，输入
dbc可以匹配dsh-better-command，输入dsh-p可以匹配dsh-plugin-creator。 - 多级过滤与排名：优先匹配字面名称前缀，其次匹配去除分隔符后的前缀，最后按有序子序列匹配。排名相同时保持源顺序。
- 全量重排：插件会替换原始候选者源，获取完整的命令/技能列表，并使用自身的匹配器进行重新排名。
安装与启用¶
插件依赖 Node.js 22.19+ 或 24+ 以及 pnpm 11。安装命令如下：
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-better-command#v0.1.2
安装完成后，启动 Web 界面即可生效：
pnpm dsh web
典型用法¶
启用插件后，在输入框中输入 / 并开始输入简写：
- 在 composer 中输入
/并开始输入缩写，例如/dshp、/dbc或/dsh-p。 - 菜单会自动浮现出默认过滤器无法检索到的连字符命令和技能。
注意事项¶
- 完全自包含：插件不导入任何
@deepseek-ai运行时符号（仅做结构镜像），因此不依赖 DSH 的运行时类型定义。 - 特性检测与兼容性：插件通过读取
InputTriggerService.live.sources进行功能检测。如果 Harness 构建的内部形状发生变化，插件会在控制台记录警告并保持不活跃，不会导致崩溃。 - 隐私与性能：匹配计算完全在浏览器端进行，逐键计算，绝不会发送到模型请求或记录到会话日志中。
- 卸载恢复：卸载或销毁该插件后，DSH 会确切地恢复为默认的内置过滤器行为。
- 版本验证：该插件已在 2026-09-04 针对
dsh-v0.1.2-rc.1进行了验证。
结语¶
dsh-better-command 是一个轻量级、隐私友好的 DSH 插件，通过浏览器端的智能匹配逻辑，显著提升了 / 菜单的可用性。对于需要频繁通过简写调用复杂命名命令的开发者，这是一个实用的增强工具。
