DeepSeek Harness 插件手记(dsh-selection-toolbar)

划词工具栏 dsh-selection-toolbar：把 Claude Code 的 /btw 搬进了 DSH

DeepSeek Harness 从发布至今已经有一段时间了，也读了一些 DSH 的解析文章，非常认同「一切皆插件」的观点。它提出的两种可组合性——空间可组合性（谁依赖谁，由系统管理）与时间可组合性（插件离开时，撤销它留下的改变）——让我在使用 DSH 的时候感受到了强大，等后续再细细研究整个框架。

这周我在用 DSH 为插件添加功能的时候，它已经跑了 18 分钟。在它进行任务的时候，我想在会话窗口仅仅询问下进度，或者让它回答我小小的疑惑——但我没敢。

不是不知道答案会是什么，是问了怕打断。主任务排着队呢；等我问完，agent 也回完了，事后还要回头把想问的内容从对话历史里再手动挑出来。

所以做了个划词工具栏。划一下，工具栏浮上来，几个按钮。其中最常用的不是翻译、不是总结，是一个叫 /btw 的「顺便问」。

它来自 Claude Code。灵感同源，做法不同——子代理的反面：子代理替你做事，/btw 只替你看一眼。它不占对话、不动任务，是悬浮在主任务旁边的一块便签式问答区。因为之前用 Claude Code 的 /btw 比较多，于是也想给自己的 dsh-selection-toolbar 加上同样的功能。

• 划选一段文字（它就是侧问的「划选内容」，会随问题一起交给模型）。比如，划选回复里的任意一句。
• 点击工具栏的 /btw——按钮行原地切换为侧问控制台。
• 输入问题，回车发送；等待时显示脉冲动画，可随时「取消」。
• 答案就地渲染（支持代码块、加粗、列表），可 复制 原始 markdown、再问一个 或 清空历史。
• 翻看之前的侧问：输入态点击历史条目（或空输入按 ↑）；回答态直接按 ↑。↑/↓ 切换条目，Backspace / Esc 返回最新；历史只读，只能整体清空。
• Esc、点击遮罩或弹窗外，随时关闭；再次划词点 /btw 即可重开。

侧问只看到三样东西：最近 N 条会话内容（N 即设置里的「侧问上下文条数」，5–50、默认 20；自动注入，无需任何勾选）+ 你划选的内容 + 你的问题。没有工具、不能联网、不能读文件；答案若不在给定内容里，模型会直说「当前会话内容里没有」而不是编造。答案下方的统计行显示实际注入了多少上下文（条数 + 字数），注入为空时明确警示——不让你对着一个「没读过上下文」的答案猜原因。

• 「不进入对话」由构造保证：host 半端收到请求后，读一次会话日志、序列化、发起一次性的 llm.stream 调用，把完整答案原路返回。全程不创建会话、不写任何消息、不注册任何工具——侧问在主线上的存在感是零。
• 静态 bundle 的约束倒出的架构：静态插件包没有动态插件那套 package-private host RPC，所以 host 半端用 webServer 注册精确路由 POST /plugins/dsh-selection-toolbar/btw，client 同源 fetch、JSON 往返。
• 上下文有预算：条数（5–50 可调）与字符（24k）双预算、逐条截断、超出折叠为一条省略标记——长会话里侧问也不会悄悄烧掉大量 token。
• 阅读不被打扰：以固定定位（fixed）实现的居中模态，滚动既不移动也不关闭它；输入/等待态高度紧凑自适应，阅读与翻历史时锁定 440×480，翻不同长度的记录不跳版。
• 失败可见：服务缺失、会话读不到、模型失败、120s 超时等错误都以可读文案显示在弹窗内，且不会弄丢你已输入的问题。

插件会出现在设置 → 插件 → 插件列表，是与内置 终端 / 网页搜索 同款的原生风格折叠卡片，包含：

• 弹窗出现延时——选中后延迟多久弹出（0–500 ms）
• 功能开关——可逐个开关工具栏按钮（复制 · 引用 · 询问 · 解释 · 翻译 · 总结 · /btw），关闭的按钮会立即从弹窗消失；「全部开启」一键恢复
• 答案去向——逐个动作选择「进主线」（作为消息进入当前对话）或「走侧问」（走 /btw，答案只显示在弹窗）
• 侧问上下文条数——顺便问携带的最近消息条数（5–50，默认 20）
• 恢复默认——重置所有选项

选项保存在浏览器（localStorage），对弹窗即时生效，无需刷新。

在 DeepSeek Harness 会话里划选文本，选区上方浮现一个小工具栏：复制 · 引用 · 询问 · 解释 · 翻译 · 总结 · /btw。AI 动作默认复用当前会话——选中文本作为普通用户消息注入当前对话，模型带着完整上下文作答；也可以在设置里把任意动作改为走 /btw 侧问。

选中文本以 markdown 引用块（> …）插入输入框光标处；多段落时只有内容行带 > ，空行保持空白（连续空行折叠为一），不会出现一整片孤立的 >。

会直接打开内联输入框，回车发送「你的问题 + 选中文本」；留空直接发送原文。

会有提示：发送「请解释下面这段内容：」+ 选中文本。

发送「请把下面这段内容翻译成中文：」+ 选中文本。

发送「请用简洁的语言总结下面这段内容：」+ 选中文本。

项目地址：https://github.com/suiyideali/dsh-selection-toolbar，从 GitHub 安装：

或本地 checkout：

host 半端依赖 @deepseek-ai/dsh-settings 与 @deepseek-ai/schemastery（已在 package.json 声明），从本地路径安装前请先装好 checkout 的依赖；从 GitHub 安装会自动解析这些依赖。装完后重启 web 应用以加载新的 client bundle。

dsh-selection-toolbar 已经发布在 GitHub，一行命令就能装上。划词即问，不污染主线——希望它也能解决你用 AI 写代码时的那点憋屈。

如果你也在折腾 DSH 插件，欢迎交流；下一篇打算聊聊这个静态 bundle 是怎么借到 host 的模型通路的。

如果你觉得今天这篇有收获，欢迎点赞、在看、转发三连，我们下篇见。

THANKS FOR READING