前言¶
在 DeepSeek Harness Web 环境下,开发者或用户在长对话中经常需要重复输入特定的术语、变量名或函数名。手动敲击不仅效率低,还容易打断输入思路。dsh-word-complete 旨在解决这一痛点,提供一个基于当前会话上下文的智能补全方案。
插件定位¶
这是一个针对 DSH Web 客户端环境的词自动补全插件。它不依赖外部字典,而是基于当前会话的历史消息统计词频,当输入前缀时提供补全建议。插件由 tuogusa 维护,采用 MIT 许可证。
核心功能¶
- 前缀匹配规则:输入时仅对满足长度要求的文本弹出建议。英文前缀需 ≥ 2 字符,中文/日文/韩文 ≥ 1 字符。输入斜杠
/或反斜杠\时不触发补全。 - 排序逻辑:建议列表按接近程度升序排列。完全匹配(当前输入词本身)优先,其次是附加字符更少的词,最后是词频更高的词。
- 交互方式:支持键盘 ↑/↓ 选择、回车确认、ESC 关闭。支持鼠标悬停高亮与点击确认。
- 光标跟随:建议窗口跟随光标逐字移动。出现在当前输入字符上方,上方空间不足时自动翻转到光标下方。
- 技术实现:Host 端负责统计词频并持久化最近 30 个会话,Client 端负责渲染 UI。文本插入通过官方事件
actx.bail("slash/input-insert-text")实现,支持撤销操作。
典型用法¶
- 输入联想:在输入框输入
ds,系统会联想dsh、dsh_workspace、dsh-word-complete等以ds开头的历史词。 - 回车与编辑:确认插入后,光标自动跳到词尾。此时按 Backspace 删除刚插入的词,窗口会立即重新弹出建议。
- 特殊字符处理:输入
/或\不会触发补全。空格键完全放行,不影响正常输入。
安装与启用¶
该插件仅支持 Web Profile。安装命令如下:
dsh plugin --profile web add github:tuogusa/dsh-word-complete
安装后重启 DSH 并使用 Ctrl+Shift+R 刷新浏览器。
更新¶
# 方式一:CLI 更新(推荐)
dsh plugin --profile web update dsh-word-complete
# 方式二:重新从 GitHub 源安装/更新
dsh plugin --profile web add github:tuogusa/dsh-word-complete
注意事项¶
- 插件遵循 MIT 许可证。
- 如果当前会话词表为空,插件会回退到本地持久化索引(最近 30 个会话的累计词表)。
- 建议安装前检查源码与许可证,确保符合工作环境要求。
总结¶
dsh-word-complete 通过利用当前会话的上下文信息,实现了轻量级、高效的输入辅助。对于需要在 DSH Web 中频繁输入特定术语的用户,这是一个实用的工具。
官方目录:https://www.skillhub.cn/plugins/tuogusa/dsh-word-complete
GitHub:https://github.com/tuogusa/dsh-word-complete