fishcg/dsh-input-prediction

dsh-input-prediction

在 DSH 的输入框上做两件事：灰字续写（Tab 接受）和回复后推荐（点一下就发）。

---

English

A DSH plugin that predicts what you are about to type, using the current conversation and your own writing style as context.

• Ghost completion — while you pause in the composer, the most likely continuation of your draft is rendered as grey text behind the caret. Press Tab to accept it; the text lands in the input box as a normal, undoable edit and you can keep editing.
• Follow-up suggestions — after each assistant turn, 1–3 candidate next messages appear just above the input box (in the official conversation.input.dock slot). Click one to send it directly.
• Settings panel — Settings → Built-in plugins → “输入预测”: toggle ghost completion, toggle suggestions, choose how many suggestions (1–3). Choices are stored in $DSH_HOME/input-prediction.settings.json and apply immediately.

Install

# from the plugin marketplace: Settings → Plugin marketplace → search “input-prediction”
dsh plugin --profile desktop add dsh-input-prediction
# or straight from GitHub
dsh plugin --profile desktop add https://github.com/fishcg/dsh-input-prediction

Both halves hot-reload; no build step, no dependencies. Requires DSH >= 0.2.0-rc.2.

Configuration

Everything has a working default. The most common knob: reasoningEffort must stay off (a completion is a dozen characters long — reasoning tokens would eat the whole budget and return empty text). See the Chinese section below for the full config table.

License

MIT © 2026 fishcg

---

它做什么

两件事，都围着输入框转：

1. 灰字补全 —— 在输入框里用灰字补上你接下来最可能打的那句话，按 Tab 接受，文字落进输入框，还能继续改。
2. 回复后推荐 —— 每轮回答写完，在输入框正上方给 1–3 条你可能要发的下一条，点一下直接发送。

┌──────────────────────────────────────────────────────────┐
│ 我想查询 example-app 应用是否正常                         │  ← 「正常」是灰字
└──────────────────────────────────────────────────────────┘
   ↑ 你打到这里                ↑ 模型续写的，Tab 一下就到手

        ┌──────────────────────────────────────────┐
        │ 顺便把日志级别调成 debug  然后跑一遍看看   │  ← 点一下直接发送
        └──────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────┐
│ 发消息或创建任务, / 调用指令, @ 文件或对话                  │
└──────────────────────────────────────────────────────────┘

• 灰字只画在光标后面，不动你的草稿；点推荐等价于你自己打完按 Enter（同一条提交链，可撤销地写进草稿再提交）。
• 预测依据是当前会话上下文 + 你平时说话的口吻（把你最近几条消息单独喂给模型当样本）。
• Tab 走 DSH 官方的插入通道（captureInsertion + insertText，带版本守卫），所以是一次可撤销的普通编辑，不是替换草稿。
• 拿不准时模型会输出空串——宁可不提示，也不猜一句驴唇不对马嘴的。

安装

# 从插件市场：设置 → 插件市场 → 搜「输入预测」
dsh plugin --profile desktop add dsh-input-prediction          # npm
dsh plugin --profile desktop add https://github.com/fishcg/dsh-input-prediction   # GitHub

# 本地开发（本机就是这样装的）
dsh plugin --profile desktop add link:/Users/fish/dsh-input-prediction

插件由两个半区组成：

客户端半区是手写 CJS + 纯 DOM（不 import 任何 @deepseek-ai 的值，只经 exports.inject 取服务、require('react') 取平台 React），零构建。

回复后推荐（建议气泡）

• 时机：这一轮回答结束之后（内核 uiSession.sessionStatus 的 running 从 true 变 false）且草稿为空时请求一次；页面刚打开、草稿为空时也会为最近一轮补一次。
• 回答进行中不出候选：还在思考、正在跑工具、正在流式输出时，候选（renderChips()/requestChips() 里的 turnRunning()）一律收起、不请求。灰字不受这条限制，见下节。
• 点一下 = 直接发送：候选按钮 → setDraft(text) → 等编辑器投影落地（60ms 轮询，最多 1.5s）→ submit()。不成功会记 client:chip-send-failed，不会发出空消息。
• 收起：右下角的 × 收起本批（记 client:chips-dismissed）；开始打字、正在回答、切换会话也会自动隐藏。
• 一轮一次：同一「对话版本」只请求一次，结果按 contextEpoch 校验，过期结果直接丢弃（不会把上一轮的候选贴到新对话上）。
• 候选文本不超过 chipMaxChars（默认 40 字），最多 chipCount 条。

设置面板

入口：设置 → 内置插件 → 「输入预测」标签页（客户端注册到官方槽 settings.plugins.tab，order: 20）。

• 面板里改的值写进 $DSH_HOME/input-prediction.settings.json（settingsFile 可改路径），立即生效，不用刷新页面，也不用重启桌面端。
• 优先级：用户偏好文件 > patch 里的默认值。也就是说 cordis.patch.yml 里的 completionEnabled/chipsEnabled/chipCount 只是「出厂默认」，用户在面板里选过之后以文件为准（删掉那个 json 就回到默认）。
• 写盘是「写 .tmp 再 renameSync」，不会写坏。

怎么确认它在跑

tail -f /tmp/dsh-input-prediction.log        # 把 debugLog 打开时才有

日志按行 JSON，看到这些就说明链路是通的：

页面控制台（如果开着 DevTools）另有一份：[input-prediction] 前缀。

配置

配置写在 cordis.patch.yml 里（或 profile 的 cordis.patch.yml 里同 id 覆盖）：

- insert:
    - id: dsh-input-prediction
      name: dsh-input-prediction
      config:
        enabled: true
        provider: ''
        model: ''
        reasoningEffort: 'off'
        maxTokens: 160
        temperature: 0.3
        contextMessages: 16
        contextChars: 600
        maxSuggestionChars: 60
        styleHint: ''
        # —— 下面这些是「出厂默认」，用户偏好文件优先 ——
        completionEnabled: true
        chipsEnabled: true
        chipCount: 3
        chipMaxChars: 40
        chipsMaxTokens: 320
        chipsTemperature: 0.7
        settingsFile: ''
        debugLog: ''

配置改动要重新载入一次 patch 层才生效：动一下 profile 的 cordis.patch.yml（保存即触发一次 live reload，已验证会重新读入本插件的 bundle patch），或者重启 DSH 桌面端。

交互细节

• 触发（灰字）：草稿至少打了一个字、停顿约 320ms 后发一次预测；相邻请求至少间隔 650ms；切换会话/发送消息/回答结束都会重新评估。
• 回答进行中也预测灰字：内核 uiSession.sessionStatus 的 running 为真时（思考、跑工具、流式输出），只要草稿非空就照常预测、照常画——用户打了第一个字就该看到提示，不必等回答写完；草稿为空的那条门禁仍然生效，所以回答期间不会凭空猜「下一条」。turnRunning() 拿不到内核状态时退回 [data-streaming]。
• 展示（灰字）：只有「光标在草稿末尾 + 草稿非空 + 输入框已聚焦 + 没开斜杠菜单 + 不在中文输入法组合中 + 建议非空」时才画；灰字会换行：光标这一行写满（右边剩不到 24px）就从下一行行首接着画，最多占 MAX_GHOST_LINES（3）行或到卡片下沿为止；塞不下的部分不显示——显示多少就插入多少。草稿空着时那块地方归占位文案和推荐候选，不画灰字。
• Tab：仅当上面这些条件都成立时才被接管（preventDefault），否则 Tab 保持原样。斜杠/@ 菜单打开时 Tab 仍然是「选中菜单项」。
• 切换会话：tick() 发现当前会话变了就 bumpContext()——灰字、候选、缓存、上下文版本全部作废，不会把上一个会话的推荐带过来。
• 缓存：同一「会话 + 上下文版本 + 草稿」60 秒内不重复请求；空结果同样进缓存，所以对着空输入框发呆不会反复问模型；请求失败有 15 秒冷却。
• 上下文版本（contextEpoch）：草稿从非空变空（发出去了）、回答开始/结束、页面重新绑定会话时都会 +1，旧提示与旧候选一并作废。

排障

开发

两个半区都能热重载，不必重启桌面端：

• 客户端：lib/client.js 是每次请求现取的（no-cache），改完约 1 秒页面就会加载新版本（client:ready 会再报一次）。热重载会留下旧实例，所以代码里有「实例卫生」（INSTANCE_SLOT 令牌 + sweepStaleDom() + sweepForeignDom() + isStale()），新实例上线时会清掉旧实例画的浮层。

• 宿主：默认不监听模块改动。要让 lib/index.js 改完即生效，在 profile 的 cordis.patch.yml 里加：

  - id: hmr
    name: "@deepseek-ai/dsh-hmr"
    config:
      base: /Users/fish/dsh-input-prediction
      root: ["."]
  

  它靠 @deepseek-ai/dsh-hmr 的 partialReload()：插件模块既是改动文件又是入口模块，于是 apply() 会重跑。这台机器上开发完已经删掉了（profile 里不留开发期配置）；要再改宿主半区，把这段加回去、或者重启一次桌面端即可。

• 安全：所有路由都走同源 + 回环 Host + 宿主信任栅栏（ctx.connection.requestRejection），所以只能从页面里调用——用 curl 打永远是 401（这也正好可以当「路由有没有注册」的探针：404 = 没注册，401 = 注册了但被拦）。

卸载

dsh plugin --profile desktop remove dsh-input-prediction
rm -f ~/.dsh/input-prediction.settings.json    # 顺手删掉用户偏好

已知边界

• 灰字只在光标位于草稿末尾时预测；光标在中间时不打扰。
• 灰字一次只预测「紧接着的后续文字」，不做多行/多候选。
• 输入法（IME）组合期间不显示、不接管 Tab。
• 灰字超长时按可用宽度截断显示，Tab 插入的是截断后的文本。
• 推荐气泡挂官方槽位 conversation.input.dock（composer 卡片正上方、卡片外、占布局），用一个 5 行的 React 壳（ChipsDock）当挂载点，气泡本身仍是命令式 DOM。所以它不会和同位置的面板（genui / btw / 排队条）叠在一起；槽位没挂上时（slots 服务拿不到）会退化成自绘浮层，这时才可能重叠。
• 推荐候选只按当前对话生成，不读你的历史会话库。

License

MIT © 2026 fishcg