输入框历史补全feihe027/dsh-client-ui-quickfill

dsh-client-ui-quickfill

给 DSH Web 输入框加上终端式历史与快速补全：像 shell 的 scrollback 一样翻阅历史 prompt、即时搜索、一键填充。

- 翻阅：Alt+↑ / Alt+↓ 循环历史（多行草稿也能用）；单行草稿时裸 ↑/↓ 同样循环。第一次按 ↑ 应用 zsh up-line-or-search：若草稿是某条历史的前缀，直接跳转最新匹配并只在该前缀内翻页。
- 搜索：Ctrl+R（macOS 为 Cmd+R）打开历史搜索面板——输入即模糊匹配（子序列），↑/↓ 选择，再按 Ctrl+R 跳到下一条（reverse-i-search），Enter 回填，Esc 关闭。
- 补全：输入时最新一条以草稿开头的历史以灰色幽灵实时显示在光标后（fish 式 autosuggestion）；Tab 或行尾 → 接受为一次普通（可撤销）草稿写入。
- 保护：翻回最新（或按 Esc）时原样恢复正在输入的内容与光标位置；相邻重复 prompt 只留一条、空白 prompt 不记录；IME 组词（拼音）期间按键全部放行。
- 可选跨会话池：opt-in 的全局历史（localStorage）让搜索、前缀定位与补全命中所有会话的 prompt（zsh SHARE_HISTORY 语义）；默认关闭（隐私）。

安装（社区用户）

需要 pnpm（npm install -g pnpm）：

dsh plugin --profile web add dsh-client-ui-quickfill

然后把插件加进 profile 的组合包列表（~/.dsh/profiles/web/package.json）：

"dependencies": {
"dsh-client-ui-quickfill": "^0.1.0"
}

重启 dsh web 服务——节点端启动时扫描 bundle、应用其 cordis.patch.yml 并编入 window.__DSH_BOOT__ 引导图，只有重启会让新 bundle 生效。

插件是自注册 bundle：patch 层会自动插入 ui-quickfill 浏览器名册行，无需手写 cordis.patch.yml。

构建与测试（贡献者）

npm install   # 链接 peer 依赖
npm test      # 冒烟测试：历史派生 / 匹配 / 前缀步进 / 幽灵补全 / 全局池
npm pack      # 检查发布文件集

本地开发：在 web-test profile 的依赖里写 "dsh-client-ui-quickfill": "file:../../dsh-client-ui-quickfill"，或把目录符号链接进 ~/.dsh/profiles/node_modules 后重启。

数据存储（全部浏览器本地，无服务端）

| localStorage 键 | 内容 |
| --- | --- |
| dsh-quickfill.global-history | 跨会话 prompt 池（全局唯一、上限 500 条，最新在后） |
| dsh-quickfill.settings | 开关（global） |

- 全局历史默认关闭（隐私——prompt 可能含敏感内容）。数据只存本机浏览器、不离开设备；会话数据本就在 ~/.dsh 磁盘上，属于同信任域本地缓存。
- 开启后当前会话全部历史一次性并入池中，此后新发送的 prompt 自动追加；会话内条目始终排在前。
- 清除：DevTools → Application → Local Storage → 删除对应键。

已知限制

- macOS 上 Cmd+R 同时是浏览器刷新快捷键，拦截并不总是可靠；Windows/Linux 无此问题。
- 历史来自当前已加载的会话快照，超长会话靠 loadOlder 拉取。
- 斜杠命令已认领（claimed）或发送中时 Ctrl+R 会被吞掉（防刷新丢草稿）——先 Esc 再搜索。
- 幽灵层复制 composer 的字体度量，主题重度覆盖字体/字距时可能偏差 1–2px；多行与空草稿故意不启用补全。
- 分屏多 composer：textarea 定位按座位作用域（[data-conversation-scroll]）锁定，理论上互不干扰——尚未在分屏形态实测。

许可证

MIT —— 见 LICENSE。

English

See README.md.