tuogusa/dsh-word-complete

dsh-word-complete

DeepSeek Harness Web 对话输入框的词自动补全插件（Notepad++ Word Completion 风格，host + client 一体包）：输入时从当前会话出现过的词中弹出补全建议，键盘 ↑/↓ 选择、回车确认。

效果

- 在输入框输入词前缀时（英文 ≥ 2 个字符、中文/日文/韩文 ≥ 1 个字符），光标上方弹出最多 8 条建议词；建议以当前输入内容开头（前缀匹配），并按接近程度升序排列：完全匹配（当前输入词本身）最前，其次附加字符更少（更接近），再词频更高。例如输入 ds 会联想 dsh、dsh_workspace、dsh-word-complete，而不会出现 adds、cards、words 这类输入在后面的词；
- 建议词来源：当前会话中用户与助手消息里出现过的词（英文/数字/下划线序列、中文、日文、韩文分词，过滤纯数字与超短词）；
- 键盘交互：↑/↓ 循环选择、回车确认插入、ESC 关闭；鼠标悬停高亮、点击确认；
- 确认后光标自动移到插入词末尾；回车确认后按 Backspace 会立即重新弹出（编辑刚插入的词）；空格键完全放行，不影响正常输入；
- 弹出窗口跟随光标逐字移动，出现在“当前输入的字符上方”；上方空间不足时自动翻转到光标下方。

行为细节

| 场景 | 行为 |
|---|---|
| 词前紧邻 / 或 \ | 不弹出（可能是斜杠命令、文件路径或 URL） |
| 建议相关性 | 只出现以当前输入内容开头的词；adds/cards/words 这类输入在后面的词不显示 |
| 英文前缀不足 2 字符 | 不弹出（避免干扰） |
| 中文 1 字 | 即弹出 |
| 输入法组合（composition）期间 | 不弹出，组合结束恢复 |
| 确认/ESC 后 | 窗口关闭，直到输入新的可打印字符或 Backspace/Delete 才重新激活 |
| 选中词与当前前缀完全相同（已输完整词） | 视为“确认当前词”：直接关闭窗口，光标保持在词尾 |
| 词表为空（新会话） | 回退到本地持久化索引（历史会话累计词表），冷启动也有建议 |

架构与技术要点

- host 端（lib/index.js）：监听会话事件增量统计词频（user/message、assistant/message），内存缓存 + 增量持久化到 $DSH_HOME/word-complete.json（最近 30 个会话），通过 webServer 提供 GET /api/word-complete/words?sessionId=；
- client 端（lib/client.js，手写 bundle）：注册到官方 slot conversation.input.overlay（slash 菜单同款弹层槽位），session scope 注入 useInput；
- 插入走官方事件：actx.bail("slash/input-insert-text", { text, span })——带 draftRev CAS 校验与撤销支持，不 hack 任何内部状态；
- 光标位置测量：用 Range API 在官方 auto-grow 镜像 [data-input-mirror] 的文本节点上定位 caret 偏移——镜像与 textarea 共享完全相同的排版规则（font-family DshChipCell、padding、pre-wrap）并随滚动容器一起移动，测量结果即真实视口坐标，无需复制样式、无需滚动修正；
- 窗口定位：createPortal 渲染到 document.body + position: fixed，脱离 slot 锚点与 transform 祖先的干扰；随输入/光标/滚动/窗口尺寸实时重测。

安装

dsh plugin --profile web add github:tuogusa/dsh-word-complete

兼容 Profile：web（DSH Web GUI）。安装后重启 DSH 并 Ctrl+Shift+R 强刷浏览器。

更新

方式一：CLI 更新（推荐）
dsh plugin --profile web update dsh-word-complete

方式二：重新从 GitHub 源安装/更新
dsh plugin --profile web add github:tuogusa/dsh-word-complete

说明：dsh plugin 是 pnpm 的前置转发器，update 会按当前依赖声明重新解析该包；通过 github:tuogusa/dsh-word-complete 安装时，会更新到仓库默认分支的最新提交。

验证

仓库自带离线验证脚本（33 项断言：分词、词频合并、持久化、bundle 形状、插入事件、前缀检测、前缀匹配排序）：

node verify.mjs

结构

cordis.patch.yml     bundle patch（loader 行）
lib/index.js         host 端：词频统计 + 持久化 + REST API
lib/client.js        client 端：补全 UI + 键盘交互 + 光标定位
docs/DESIGN.md       设计说明（架构、测量与交互决策依据）
verify.mjs           离线验证脚本

License

MIT