前言¶
在使用 DeepSeek Harness Web 进行开发或交互时,输入框缺乏智能建议是常见的体验断层。与 Claude Code 等工具不同,DSH Web 界面本身不提供输入预测功能。dsh-suggest-ghost 插件通过挂载机制,在回合结束后自动预测下一句提示词,或在输入过程中根据历史记录进行前缀补全,模拟类似 IDE 或聊天工具的自动补全体验。
是什么¶
dsh-suggest-ghost 是一个纯插件挂载组件,不修改 DSH 核心代码。它通过监听回合事件和客户端 DOM overlay,实现两种自动补全模式:
- LLM 下一条建议:在草稿为空时,利用辅助 LLM 调用预测用户下一步输入。默认继承主请求路由,不额外配置。
- 历史前缀补全:在草稿非空时,类似
zsh autosuggestions,从会话历史中查找前缀匹配项进行补全。
幽灵文本采用 DOM overlay 近似渲染,跟随输入框字体与滚动,不依赖官方 setGhost 能力,且在中文输入法组合期间不会拦截按键。
核心功能¶
- 幽灵文本显示:草稿为空时,建议内容以幽灵文本形式显示在输入框中;输入过程中从历史找前缀补全。
- 快捷采纳:
Tab键一键采纳整条建议,→键逐词采纳。 - 全程有界:对输入字节、输出 token 和超时时间均设置封顶,防止资源耗尽。
- 模式切换:根据输入框草稿状态自动在 LLM 建议和历史前缀补全间切换。
安装与启用¶
安装该插件需要 DeepSeek Harness 内核版本 0.2.0-rc.2 或更低版本。安装命令如下:
dsh plugin --profile web add dsh-suggest-ghost
安装完成后重启 DSH Web,页面刷新即可使用。
配置¶
所有设置位于 Settings -> Plugins 面板中的 Suggest ghost 卡片。
UI 设置¶
- LLM 下一条建议:启用开关、输出令牌上限、建议字符上限、参考回合数、转录字符预算、超时(毫秒)、采纳快捷键、provider/model 路由(留空继承主请求)。
- 历史前缀补全:启用开关、跨会话搜索、最大历史条目、最少输入字符、逐词采纳。
- 热度管理:管理跨会话高频短语列表,支持固定(不淘汰)、删除、手工新增和清空。
代码级配置¶
也可以通过 cordis.patch.yml 覆盖初始值:
- id: suggest-ghost
config:
maxInputBytes: 4096
maxOutputTokens: 512
timeoutMs: 60000
maxRecentTurns: 3
maxTranscriptChars: 12000
contextSummaryEnabled: true
contextSummaryChars: 1500
maxSuggestionChars: 240
acceptKey: Tab
llmEnabled: true
兼容性与依赖¶
该插件需要 DSH 内核 0.2.0-rc.2 或更低版本。从 0.2.0 开始,peer 依赖检查变为加载期硬拒绝,不满足版本会直接跳过插件加载。
在 0.1.7 版本中,DSH 移除了 settings.yaml 体系,本插件的数据通道随之迁移至新的 Config 结构。客户端通过 remote.settings.describe() 读取配置,host 端通过 ctx.settings.update() 推送 _push 字段。
使用示例¶
- 历史前缀补全:在输入框输入“列出 do”,插件自动补全这条历史消息的剩余部分。
- LLM 下一条建议:回合结束后,如果输入框为空,插件会根据上下文预测下一步输入,灰色显示建议内容。
- 采纳建议:按
Tab键采纳整条建议,按→键逐词采纳。
注意事项¶
- 版本要求:必须使用 0.2.0-rc.2 或更低版本的 DSH 内核。
- 重启生效:重启 DSH Web 后立即可用,历史记录存储在会话日志中。
- 输入法干扰:在中文输入法组合期间,插件不会拦截按键,避免打断输入。
- 许可证:默认为 MIT 许可证。
结语¶
dsh-suggest-ghost 通过轻量级的 DOM overlay 和智能补全策略,为 DeepSeek Harness Web 用户提供了实用的输入辅助能力。无论是利用 LLM 进行预测,还是利用历史记录进行快速补全,都能显著提升交互效率。
插件目录:https://www.skillhub.cn/plugins/dsh-plugin-collection/dsh-suggest-ghost
GitHub 仓库:https://github.com/dsh-plugin-collection/dsh-suggest-ghost