Skip to main content
L

dsh-suggestion

lixiangzhong/dsh-suggestion

Writes a model-generated next-step suggestion into the DSH composer placeholder after each turn; Tab (desktop) or tap (touch devices) fills it into the draft.

Install

dsh plugin --profile web add github:lixiangzhong/dsh-suggestion

README

dsh-suggestion

DSH 插件:每轮任务结束后,用模型生成一句「下一步建议」写进输入框占位文字,Tab 一键填入草稿;手机上改为输入卡片上方一条整行建议(最多 3 行折行),点一下即可采纳。

┌────────────────────────────────────────────────┐
│ 修复 go test 的 3 个失败用例                     │  ← 建议(占位文字)
│                                                │
│  +  发消息…                              ↑     │
└────────────────────────────────────────────────┘

安装

从 npm 安装:

plugin_manager install_bundle target=@lixiangzhong/dsh-suggestion

本地开发(以符号链接方式装进 profile):

plugin_manager install_bundle target=link:/path/to/dsh-suggestion

安装后在 Plugins 页启用 输入框建议(bundle 名 @lixiangzhong/dsh-suggestion,插件行 id dsh-suggestion)。配置见 docs/DETAIL.md。

行为

你在哪会怎样花不花调用
当前会话、草稿为空一轮结束立刻请求,1~3 秒占位出现建议一轮一次
当前会话、草稿里有字不请求,并通知 Host 取消兜底不花
切到别的会话 / 最小化 / 关窗(应用还在跑)Host 在轮次结束 2 秒后自己生成,放进进程内缓存一轮一次
切回那个会话直接命中缓存,立刻看到,不用等模型不花
手机 / 平板(触控设备)不接管占位文字,输入卡片上方出现一条整行建议(最多 3 行折行),点一下填入草稿一轮一次

建议缓存按「会话 + 轮次」分区(不按语言,避免兜底与客户端各生成一次),进程存活期间有效(12 小时);「10 分钟」只约束首次生成,已生成的结果切回多久都能用。模型调用遇到上游错误会自动重试一次。

占位文字是单行显示(宿主用 text-overflow: ellipsis 截断),但按 Tab 填入草稿的是完整建议——可视截断不影响采纳内容。建议长度上限默认 200 字(maxChars 可调)。

触控判定用的是媒体查询 (hover: none) and (pointer: coarse):手机与平板走整行建议条(conversation.input.dock,宿主自己的 activity / usage 把 composer.dock 挤成共享横向行,建议放那里只会剩几个字);带触屏但以鼠标为主的笔记本仍走桌面形态。iPad 外接触控板后刷新一次即可恢复占位形态。

以下状态不被接管,宿主原文案保持原样:新会话空白页、未选择工作区、输入被锁、计划模式、有排队插话。

结构

文件作用
index.jsHost 入口:配置归一化、服务装配、路由注册
lib/route.js鉴权 HTTP 路由:suggest / skip / trace
lib/service.js建议生成、按轮次去重缓存、后台兜底与取消
lib/session-context.js从会话事件折出最后一轮上下文与工具摘要
lib/summary.js早期对话的增量摘要
lib/prompt.js提示词构造与输出归一化
client.js浏览器半边:触发、占位文字接管、Tab 接受、触控建议条、草稿非空时取消兜底

开发

npm test      # node --check + 纯函数单测

无构建步骤:client.js 直接以 window.__ModuleLoader__ 工厂形式加载。

改完代码生效方式不同,容易踩坑,详见 docs/TROUBLESHOOTING.md:

  • Host 半(index.js、lib/*、配置、路由):必须重启 DSH;plugin_manager 返回 applied 只代表配置树更新,不代表模块换了新代码。
  • 客户端半(client.js):内容变化会换 rev,刷新窗口即加载新版本。

License

MIT

Related plugins