斜杠菜单模糊匹配lovstudio/dsh-better-command

dsh-better-command

Lovstudio 为 DeepSeek Harness Web 界面打造的斜杠菜单匹配升级。该插件提供 slashMatcher 服务——一个对分隔符透明、支持缩写的候选排序器——/ 菜单的来源（ui-commands 和 ui-skill）在生成候选时会查询它。挂载该插件后，dshp 可匹配 dsh-plugin-creator，dbc 可匹配 dsh-better-command，dsh-p 可匹配 dsh-plugin-creator。

这是一个 Lovstudio 插件，并非 DeepSeek-AI 官方包，以 @lovstudio 作用域分发。

功能说明

斜杠管线会在每次按键时向每个 / 来源请求菜单候选。harness 的命令来源按有序子序列匹配进行过滤；技能来源按字面名称前缀过滤——因此像 dsh-plugin-creator 这样的技能无法通过输入 dshp 触达。官方 harness 构建未暴露匹配器扩展点，因此该插件在运行时自行挂载：它访问 inputTriggers 注册表，并针对 command 和 skill 来源，将 candidates 替换为一个包装器，该包装器会获取来源的完整列表并用插件的匹配器对其进行排序。选择、空格和回车的判定逻辑不受影响。该匹配器同时以 slashMatcher 服务的形式发布，供希望直接查询它的来源使用。

- -、_、. 和空白字符在名称和查询中均透明（dshp 可匹配 dsh-plugin-creator）。
- 词首缩写会在边界处得分（dbc 可匹配 dsh-better-command）。
- 匹配不区分大小写且仅针对名称；描述永不参与匹配。
- 排序层级：字面前缀 > 去除分隔符后的前缀 > 边界加权的子序列得分；得分相同时保持来源顺序。

该插件完全自包含：它不导入任何 @deepseek-ai 运行时符号（服务契约是结构上的镜像），其浏览器端部分在组合后由客户端模块系统提供给页面。

安装

前置条件：Node.js 22.19+ 或 24+，pnpm 11（corepack enable 或 npm i -g pnpm）——dsh plugin 会在 profile 目录内转发给 pnpm。

从 DeepSeek Harness 源码检出安装（推荐——你同时获得 harness 源码）：

git clone --depth 1 --branch dsh-v0.1.2-rc.1 https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness && pnpm install && pnpm run build
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-better-command#v0.1.2
pnpm dsh web

无需检出（npx；仅限已编译的 harness）：

npx @deepseek-ai/dsh plugin --profile web add -w github:lovstudio/dsh-better-command#v0.1.2
npx @deepseek-ai/dsh web

web 是 dsh web 启动时使用的 profile。该标签固定到一个提交，其 lib/ 已预构建并提交，因此你的机器上无需编译任何内容。已于 2026-09-04 针对 dsh-v0.1.2-rc.1 验证。使用 dsh plugin --profile web remove @lovstudio/dsh-better-command 卸载。

使用

1. 启动 Web UI：dsh web。
2. 在编辑器中输入 / 并开始输入缩写：/dshp、/dbc、/dsh-p。
3. 菜单会显示默认过滤器会遗漏的带连字符的命令和技能。

本地开发

将此检出目录放在 DeepSeek Harness 仓库之外。在此处安装并构建它，然后将该包链接到一个隔离的开发配置中：

pnpm install
pnpm run watch

DSH_HOME=/Users/mark/.dsh-lov-dev pnpm --dir /path/to/deepseek-harness dsh plugin --profile web add -w link:/path/to/dsh-better-command

浏览器模块系统会使用生成的 lib/client.js，而 Harness Client HMR 监听器会检测到重新构建。包清单、补丁和 bundle 成员关系的更改需要重启配置。该包的构建不会导入 Harness tsconfig 或工作区源路径。

说明

- 该附件读取 InputTriggerService.live.sources，这是 dsh-client-ui-input-trigger 的一个 TypeScript 私有字段。它经过特性检测：在改变了该结构的 harness 构建上，插件会记录一条控制台警告并保持不生效。已针对 dsh-v0.1.2-rc.1 验证。
- 卸载（或处置）该插件会完全恢复内置过滤器。
- 匹配是每次按键时的浏览器计算；它永远不会到达模型请求或会话日志。

许可证

MIT