前言¶
在 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 插件，通過瀏覽器端的智能匹配邏輯，顯著提升了 / 菜單的可用性。對於需要頻繁通過簡寫調用複雜命名命令的開發者，這是一個實用的增強工具。
