dsh-selection-toolbar（划词工具栏）[![awesome

English | 中文

在 DeepSeek Harness 会话里划选文本，选区上方浮现一个小工具栏： 复制 · 引用 · 询问 · 解释 · 翻译 · 总结 · /btw。

AI 动作默认复用当前会话——选中文本作为普通用户消息注入当前对话， 模型带着完整上下文作答；也可以在设置里把任意动作改为走 /btw 侧问。

功能

动作	行为
复制	选中文本复制到剪贴板。
引用	选中文本以 markdown 引用块（> …）插入输入框光标处；多段落时只有内容行带 > ，空行保持空白（连续空行折叠为一），不会出现一整片孤立的 >。
询问	打开内联输入框，回车发送「你的问题 + 选中文本」；留空直接发送原文。
解释	发送「请解释下面这段内容：」+ 选中文本。
翻译	发送「请把下面这段内容翻译成中文：」+ 选中文本。
总结	发送「请用简洁的语言总结下面这段内容：」+ 选中文本。
/btw	顺便问（侧问）：点击后按钮行切换为侧问输入框，回车提问。答案由 host 侧基于最近会话内容一次性生成，只显示在弹窗里——不进入对话、不写入会话历史、不使用工具（Claude Code /btw 语义）。主任务执行中也可用：路由独立于会话队列，问完即止，不打断主任务。控制台以居中模态打开，不随页面滚动（输入态高度紧凑自适应，阅读/翻历史时锁定 440×480）。支持复制答案、再问一个、清空历史；输入态历史区最多展示 5 条，回答态不堆叠历史——按 ↑ 即可只读翻阅全部历史（↑/↓ 切换，Backspace / Esc 返回最新）。答案下方显示实际注入的上下文统计（条数 + 字数），注入为空时给出警示。

弹窗在 Escape / 滚动 / 点击别处时收起；询问输入框打字期间不会被误关 （聚焦输入框会折叠页面选区，但弹窗逻辑会忽略这次折叠）。

/btw 控制台的例外：控制台不贴着划词位置，而是以居中模态打开 （带半透明遮罩）：输入/等待态高度随内容紧凑自适应；阅读答案或翻阅历史时 锁定 440×480（小屏按视口收缩），翻阅不同长度的记录不会跳动。 position: fixed 使它不随页面滚动移动或关闭。点击遮罩或弹窗外、按 Escape 关闭；输入框内 Esc 关闭、↑（空输入时）进入历史翻阅，翻阅时 ↑/↓ 切换条目、Backspace 或 Esc 返回最新。答案无论何时关闭都已存入 本会话的侧问历史（localStorage，手动清空）。

/btw 顺便问（侧问）

灵感来自 Claude Code 的 /btw——「子代理的反面」：子代理替你做事， /btw 只替你看一眼。它不占对话、不动任务，是悬浮在主任务旁边的 一块便签式问答区。

解决的痛点

• 划词杂问不想污染主线：看到一段看不懂的术语、报错或日志，顺手问一句， 但不想让这条「顺便一问」混进对话历史、干扰后续任务的上下文。
• 任务执行中随时插问：agent 正在跑长任务，你盯着中间输出想问 「这一步为什么这么做？」——侧问走独立路由，不排队、不插话、不打断 主任务，问完即止。
• 即用即弃的轻量问答：答案只活在弹窗里，关闭后仅剩一条本地历史， 不产生任何会话副作用。

使用方式

1. 划选一段文字（它就是侧问的「划选内容」，会随问题一起交给模型）。
2. 点击工具栏的 /btw——按钮行原地切换为侧问控制台。
3. 输入问题，回车发送；等待时显示脉冲动画，可随时「取消」。
4. 答案就地渲染（支持代码块、加粗、列表、表格），可 复制 原始 markdown、 再问一个 或 清空历史。
5. 翻看之前的侧问：输入态点击历史条目（或空输入按 ↑）；回答态直接按 ↑。 ↑/↓ 切换条目，Backspace / Esc 返回最新；历史只读，只能整体清空。
6. 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。
• 阅读不被打扰：position: fixed 居中模态，滚动既不移动也不关闭它； 输入/等待态高度紧凑自适应，阅读与翻历史时锁定 440×480，翻不同长度的 记录不跳版。
• 失败可见：服务缺失、会话读不到、模型失败、120s 超时等错误都以 可读文案显示在弹窗内，且不会弄丢你已输入的问题。

设置

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

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

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

安装

从 GitHub：

dsh plugin --profile web add github:suiyideali/dsh-selection-toolbar

或本地 checkout：

cd dsh-selection-toolbar && pnpm install   # 或：npm install
dsh plugin --profile web add /path/to/dsh-selection-toolbar

host 半端依赖 @deepseek-ai/dsh-settings 与 @deepseek-ai/schemastery （已在 package.json 声明），从本地路径安装前请先装好 checkout 的依赖； 从 GitHub 安装会自动解析这些依赖。

装完后重启 web 应用以加载新的 client bundle。

依赖

• dsh web（已在 v0.1.0-rc.6 与 v0.1.0-rc.8 上测试）
• profile 需已挂载 @deepseek-ai/dsh-client-runtime（web profile 默认 自带）。自 rc.8 起设置卡片通过按设置命名空间分发的 settings.plugin.item keyed 槽注册，插件的小型 host 半端会注册 dsh-selection-toolbar 命名空间，设置 → 插件 才会派发这张卡片； rc.6 下同一份注册满足旧的 list 槽契约。
• /btw 侧问依赖 host 侧核心服务 webServer / sessionQuery / agentDefaultModel / llm（均为 dsh host 组合自带，无新增 npm 依赖）。 服务缺失时路由不注册，侧问弹窗内会给出可读错误。

架构说明

• 行为纯 client、附一个极小的 host 半端：AI 动作通过 client 侧 sessions 服务的 binding(id).session.prompt(...) 发送——与 composer 自身同一条通路，排队与错误面都是原生的。host 半端只负责注册设置 命名空间（见「依赖」），让 rc.8+ 能派发设置卡片；卡片本身的选项值 仍存在浏览器 localStorage（client-only 设计）。
• /btw 侧问通道：静态 bundle 没有动态插件那套 package-private host RPC（factory 只收 require），所以 host 半端通过 webServer 注册精确 路由 POST /plugins/dsh-selection-toolbar/btw（exact 路由优先于 /plugins bundle 前缀），client 用同源 fetch 以 JSON 往返。handler 读 sessionQuery.readSession 取会话日志，经 lib/transcript.js 序列化最近 N 条（用户/助手消息、工具调用与结果，逐条带截断），拼进一次性 llm.stream 调用，完整答案返回后由弹窗渲染。全程不创建会话、不写 任何消息、不给模型任何工具——「即用即弃」由构造保证。
• 侧问路由的信任域：与 dsh web 应用本体相同（localhost、与页面同源）， 不做额外鉴权；浏览器侧断开（关闭弹窗）会中止进行中的模型调用。 答案由当前默认模型（agentDefaultModel）生成，计入正常 token 消耗。
• 引用插入走 conversation.input.dock 槽位官方标准 prop inputActions.setDraft，刻意避开 sessions.scope() + 事件 bail（动态 插件 facade 的跨 Context 守卫禁止那条路）；markdown 引用块与其它 引用回复插件一致。
• 选区限定在消息列表（[data-chat-flow]）内，排除输入框/输入区/ contenteditable 区域。
• 弹窗生命周期：沿用 Escape / 点击别处收起、询问输入聚焦不误关的 既有约束；/btw 控制台打开期间「滚动即收」显式放宽——控制台以居中模态 打开，滚动既不移动也不关闭它（见功能一节），其余动作行为不变。
• 固定动作拼接固定前缀；询问问法截 2k 字符、选中文本截 20k 字符， 防止注入超大消息；侧问请求体上限 512 KB。

License

MIT