dsh-suggestion-chips
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Basarisiz
- exec() — Shell command execution in lib/client.js
- exec() — Shell command execution in lib/normalize.js
- rm -rf — Recursive force deletion command in lib/normalize.js
- rm -rf — Recursive force deletion command in test/normalize.test.mjs
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Clickable suggestion chips + Tab ghost text under every DeepSeek Harness reply — stance-ranked, L0 deterministic fallback, high-risk safe gate · 回复建议按钮与 Tab 幽灵投影,高危操作安全门禁
dsh-suggestion-chips(建议胶囊)
中文 · English
给 DeepSeek Harness 的每条回复末尾加一排可点的建议胶囊(Suggestion Chips)。点一下,那句话就直接作为你的消息发出去——不用自己打。每条建议右侧还有一个小按钮(输入框图标):点它只把这句话放进输入框,你改完再发。针对破坏性高危操作自动提供 ⚠ 警示并强制拦截一键直发,支持历史轮次采纳闭环状态指示。
它解决的是"我读完了,接下来想让它干 A 还是 B"这件事:与其自己组织语言,不如直接点。
和"输入框补全"不是一回事
生态里已经有几个"下一句建议"插件(dsh-suggest-prompt、dsh-prompt-for-me、dsh-suggest-ghost、dsh-input-assist),它们都是输入框里的 ghost text:靠另跑一次模型调用去猜你要说什么,给一条,按 Tab 采纳,然后还要自己按回车。
这个插件换了个思路:
| 输入框补全类 | 本插件(dsh-suggestion-chips) | |
|---|---|---|
| 位置 | 输入框内 | 回复下方(轮次尾部) |
| 条数 | 1 条 | 默认最多 5 条,直接铺开(上限调更高时多出的会自动折叠) |
| 内容来源 | 插件猜你想说什么 | 模型按上下文主动给,若未调用则由内置 Level 0 确定性提取器秒级从正文兜底(中英场景都认) |
| 额外开销 | 要多跑一次模型调用(另起一次请求去猜) | 不额外调用——0 额外 Token 消耗,名单走 presentationMeta 不回灌上下文 |
| 采纳 | Tab,再自己按回车 | 点一下就发出(高危操作自动降级为安全填入);想先改再发点右侧填入按钮 |
| 不想要它 | 得忽略或按 Esc | 不看就行,它不占输入框 |
安装
dsh plugin --profile desktop add dsh-suggestion-chips
装完重启 DSH 并刷新一次页面——host 只在启动时读插件清单,客户端代码也要重新加载。这两步缺一不可(踩过)。
它怎么工作
- Host 侧:注册一个
suggest_actions工具。模型写完回复后调用一次,参数里带 1-5 条建议;工具立刻返回并直接结束这一轮(宿主的concludeTurn(),可通过config.concludeTurn: false关闭),不再多跑一步模型。 - 客户端侧画两处:
tool.call.toolview挂一个静默采集器:渲染时按(sessionId, turn / seq)把建议记进插件实例内存,并通过订阅通知轮次尾部,自己不画任何东西;conversation.chat.turnTail(轮次尾部)挂展示器:按当前轮次的turn(或事件seq区间)读取并订阅建议、画按钮,不同轮次之间互不串轮。
- 为什么放轮次尾部:DSH 的"过程组折叠"会把思考与工具调用收成一行,画在工具卡片里的东西默认看不见;轮次尾部在折叠范围之外,所以过程收起来按钮照样露着(这条是读了官方源码才定的,见下)。
- 点按钮走的是
conversation.input.shell(sessionId).actions:写进会话输入框 → 提交。和用户自己敲键盘回车是同一条路。
省 token 与原生化(0.2.0)
| 0.1.14 | 0.2.0 | |
|---|---|---|
| 工具说明(每次请求都带) | 3,822 字符,约 956 token(DSH 计量器记的是 969) | 1,465 字符,约 366 token |
| 工具结果(留在上下文里) | 一句话 + 整份建议名单的 JSON | 一句话(3 suggestion(s) shown under your reply.) |
| 调用之后 | 模型还要再跑一步才收尾 | 这一轮在这一步结束(concludeTurn) |
| 子 agent | 也声明这个工具 | 不声明(会话头 origin: subagent 时跳过) |
| 客户端状态 | 模块级单槽 Map(sessionId),无订阅,多轮偶发串轮 |
apply(ctx) 托管按轮次 (sessionId, turn / seq) 响应式存储,ctx.effect 卸载清理 |
名单还在,只是换了条路:走 output.presentationMeta,随会话日志落盘、只给界面读,模型看不见。说明也补上了「什么时候别给」:任务做完、或卡在只有用户能拍板的选择上才给;能自己做的先做完;计划模式里不给(点按钮只算口头同意,替代不了计划审批)。
建议的「立场」和「推荐」
这一轮加了两样东西:一个管"几条建议别是同一个角度",一个管"哪条最该先做"。
立场:每条建议背后都要标一个立场,五档——先验证(更小的一步,先确认再往下)、常规推进(顺这条路的正常下一步)、更用力(还是这条路,但更快、更敢冒险)、换一条路(当前做法不走了)、可以不做(这事本身不必做)。同一轮里一个立场只能出现一次,重复的直接丢掉,空出的位置留给别的角度——所以"三条其实是一回事"这种列表到不了你面前。最多五条(五档立场各一条);只想到两条时就给两条,不硬凑。
立场不会显示在按钮上,它是给模型定的格式约束。为什么不在提示里嘱咐一句"请给不同角度的建议"就算了:嘱咐是可以不听的,格式约束绕不过去。
推荐:哪条最该先做,由模型单独标出来,跟它排在第几位无关——标了的那条会被自动提到第一位,旁边挂一个「推荐」小标签。它的底色和别的按钮一样,只有鼠标停在上面时才变深一点。反过来,「可以不做」那条不管给在第几位,都会被压到最后;其余几条保持模型给的顺序。几条确实差不多时,也可以一个都不标。
把鼠标停在按钮上(键盘操作是聚焦到它),按钮会就地展开,显示点下去真正会发出去的那句话;移开就收回去。这一步是为了让"看到的"和"发出去的"对得上——按钮上是摘要,真正发出去的那句常常更长。这段全文长在按钮外面,所以展开之后点它不会误发,想选中文字复制随便点。
几条按钮一样宽:宽度按最长的那条标签定,不按各自内容伸缩——箭头排成一列好扫读,指令写得长也不会把按钮撑开。
每条右侧有个填入按钮(0.1.11 起,输入框图标):点它不发送,只把这句话放进输入框、把光标叫回来,你可以先改几个字再按回车。它处理的是"这句话大方向对、但我想换个说法"的情况。放进去之前会先清空输入框——点一下就是"用这句重新开始",不会跟上一次的草稿混在一起。
默认全部铺开:单轮上限就是立场档数(5 条),界面上一次全显示。折叠那段逻辑还留着,但阈值(5)与上限相等,正常情况下不会触发;把上限配到 6 时,多出来的那条会自动收进下面一行"还有 N 条"里,点开就地铺开、展开后照样能点。展开状态不记忆——翻回去再回来,它又是收起的。
界面上的几个字(「推荐」「还有 N 条」「收起」)跟着界面语言走:中文界面显示中文,其它语言显示英文。
不带立场的建议照常显示(向后兼容)。
「开新会话」按钮
会话长到该断的时候,与其自己复制结论、手动新建会话、再粘贴过去,不如给一条带 opensNewSession: true 的建议:点一下,新建会话(落在同一个工作目录)→ 切过去 → 把这段文本放进新会话的输入框。
- 只填草稿,不自动发送。自动发送会立刻起一轮模型调用,等于替用户花钱;填进输入框,用户还能补一句再回车。
- 一个会话只保留一条这类建议,给多了也只会剩第一条。
- 按钮上带一个「新会话」小标签,和普通建议区分开。
- 失败会在按钮下方说明原因(会话服务没起来、切不到前台、输入框一直没准备好),不会静默。
和官方「派生会话」(fork)不是一回事:fork 复制的是整段历史前缀,新会话的上下文和原来一样长,省不下 token;这条带过去的只有你写的那段文字。要接着原样跑就用 fork,要省 token 就用它。
已知限制
- 需要 DSH 0.1.7 这一线(用到了
conversation.chat.turnTail、conversation.input.shell、tool.call.toolview)。「调用即收尾」「子 agent 不声明」「名单走 presentationMeta」用的是 0.2.2 的宿主接口;旧宿主上前两条自动退回旧行为(多跑一步、全局声明)。 - 0.1.x 产生的旧会话翻回去照样有按钮:界面先读
meta,读不到再从结果正文里找名单。刷新页面后也一样(0.2.1 起会从会话事件流回放名单,不再依赖那个会话的工具有没有被渲染过)。 - 模型没调用
suggest_actions时,内置 Level 0 提取器会从正文里兜底:编号选项、确认型问句、工程收尾三种模式,中英场景都认。模型有权不给(做完的事、卡在只有用户能拍板时该给,中间步骤不给),所以「这一轮没有按钮」本身不是故障。 - 按钮文字由模型给:太长会显得笨重,建议每条不超过 20 字。
- 普通建议点击直接发送,没有二次确认——这是设计意图。高危动作会被拦截,自动降级为填入输入框,核对后手动发送;想先改再发,点右侧的填入按钮。
- 一次点击有约 0.9 秒的防连点。
开发者备注
实现细节、踩过的坑、以及"为什么不用另外三个位置"都在仓库注释里;conversation.chat.turnTail 这个落点是从官方 72 个 slot 扩展点里筛出来的。
许可
MIT
配置
改单轮上限,别写在 profile 的 cordis.patch.yml 里——那份 patch 先于插件的插入行应用,同 id 的行这时还不存在,会被静默忽略(2026-09-26 在另一个插件上实测过)。正确的位置是插件自己的 bundle patch:
- insert:
- id: suggestion-chips
name: 'dsh-suggestion-chips'
config:
displayMode: both # 呈现形态: both (默认双形态联动) | chips (仅尾部胶囊) | tab (仅输入框 Tab 幽灵) | none (关闭)
maxActions: 5 # 单轮最多给几条(1–6),超出的丢掉;界面就按这个数显示
concludeTurn: true # 默认为 true(调用即结束本轮);若需保留该轮分支按钮或避免仅保留最终回复模式下被折叠,可设为 false
不写 config 时 displayMode 默认 "both",maxActions 用默认值 5(等于立场档数),concludeTurn 用默认值 true。改完要重启一次 DSH——配置在启动时读。
双形态与分工定位(0.3.0)
both(双形态联动,默认):尾部胶囊展示全局立体分支,输入框在草稿为空时自动投影置顶推荐项(recommended: true)的幽灵文本,按Tab键秒级采纳进草稿,同时尾部对应胶囊自动打勾标记为「已采纳」;chips(仅胶囊):仅在回复尾部展示建议按钮,输入框保持原生状态;tab(仅 Tab 幽灵):聊天界面彻底隐藏尾部按钮,仅在输入框提供 Claude Code 风格的 Tab 幽灵预测;- 安全与输入法保护:高危操作在输入框带有警示徽标且按下 Tab 强制只填草稿不发送;中文拼音输入期间彻底冻结按键拦截。全功能支持中英文双语环境自适应。
2026-09-29 修正:默认值原来是 3,而界面折叠阈值也是 3——两级上限一样,"还有 N 条"永远没东西可展开,模型给出的第四、五个不同动作在 host 侧就被砍了。现在默认 5,折叠那行才真正用得上。
开发
pnpm test # 49 个单测,零外部依赖(node:test)
代码分工:
lib/normalize.js—— 清洗规则、工具说明与按轮次响应式存储(空白、去重、立场、排序、上限、readHostActions、createSuggestionStore),纯函数、可单测lib/index.js—— 注册工具、读配置(严格遵守 DSH 函数插件 4 导出契约:Config、apply、inject、name);清洗后的名单经presentationMeta交给界面,模型只拿一句话lib/client.js—— 浏览器侧。由apply(ctx)持有按(sessionId, turn / seq)索引的响应式存储并在ctx.effect卸载时清理,把 host 交回来的名单按轮次记下来、画出来,规则一条都不重复test/native.test.mjs—— 0.2.0 的原生化回归:4 导出契约、说明长度、只回一句话、concludeTurn开关、子 agent 不声明、旧日志兜底、按轮次存储与客户端槽位生命周期
边界行为都有测试锁定:非数组、坏 JSON、空白 label、重复 label、重复立场、非法立场、超限条数、maxActions 越界。UI 侧另有:按钮最多 520px 宽、文案最多两行(悬停显示全文)、点击后 0.9 秒防连点、标了"推荐"的那条会高亮、右侧填入按钮只填草稿不发送(填入前先清空原有草稿)。多轮会话按 turn(或事件 seq 区间)精确对应各自的建议,互不串轮。
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi