划词引用回复 mar1259/dsh-plugin-codex-annotate

dsh-plugin-codex-annotate · 划词引用回复

给 DeepSeek Harness 的 Web UI 加一个 Codex 风格的「划词追问」：选中助手回复里的任意文字，右键选择 在此回答，写下你的问题或补充；可以连续攒下多条注释，最后一次性发出。发出的消息自带精确出处（消息 id、轮次、段号、小节、字符区间或代码行号）和原文，并在气泡里折叠成一条 📎 N 条注释 的附件条。

面向 DSH 0.2.1-rc.2 的 Web 客户端构建，依赖若干尚未承诺稳定的 DOM / React 内部细节（见兼容性）。

特性

- 划词右键即用：右键菜单里新增「在此回答」，与「复制」并列；没有选中文字时不拦截系统菜单。
- 精确定位：消息 id、轮次、段号、所在小节标题、字符区间；代码块记录语言与行号。
- 先确认、后统一发送：每次确认只暂存一条注释，输入框工具行显示 📎 N 条注释，点开可逐条删除或清空，最后一次性发送。
- 气泡内折叠：发出的消息把引用部分收成 📎 N 条注释 ▾，点击展开原文，展开后仍可正常划选复制。
- 纯本地：没有任何网络请求或遥测；引用内容就是一条普通用户消息，fork / 回放 / 搜索 / 上下文压缩都照常工作。

环境

- DeepSeek Harness 0.2.1-rc.2（Web UI 或桌面版）
- 无构建步骤：仓库里的 client.js 就是浏览器直接加载的模块

安装

要求 DSH 已安装且 dsh 在 PATH 中。从 GitHub 直接安装：

dsh plugin --profile desktop add github:mar1259/dsh-plugin-codex-annotate

desktop 是桌面版的 profile 名；Web 版通常用 web，换成你实际启动的 profile 即可。
固定到某个 commit，避免仓库后续改动影响现有环境：

dsh plugin --profile desktop add github:mar1259/dsh-plugin-codex-annotate#<commit-sha>

本地 clone 安装：

git clone https://github.com/mar1259/dsh-plugin-codex-annotate.git
dsh plugin --profile desktop add ./dsh-plugin-codex-annotate

卸载：

dsh plugin --profile desktop remove dsh-plugin-codex-annotate

本仓库是纯 JS，没有 prepare / build 脚本，git 安装不需要 pnpm 的 allowBuilds 许可。

安装或更新客户端 bundle 后，刷新页面（或重启 DSH）才会加载新的 JS 代际。

使用

1. 在助手回复中选中一段文字 → 右键 → ❝ 在此回答。
2. 在弹出的输入框里写下回复 → 点 确认（或按 Enter）。
3. 继续划词、继续确认；输入框工具行左侧出现 📎 N 条注释 胶囊。
4. 点胶囊 → 浮层里可逐条删除、清空，或直接 发送。
5. 发送后，所有注释与回复合成一条用户消息；气泡里显示为 📎 N 条注释 ▾，点击展开。

发出的消息长这样

段落选区：

回复引用 · 助手消息 #4f2a1c · 第 3 轮 · 第 2 段「方案 A」· 字符 12–58 「建议把鉴权放到网关层，避免每个服务重复实现。」

那网关自己挂了怎么办？

代码选区：

回复引用 · 助手消息 #4f2a1c · 第 3 轮 · 代码块 ts · 第 12–18 行

for (const x of xs) { ... }

多条注释会按顺序拼接在同一个消息里，每条一个引用块 + 一段回复。

工作原理

| 部件 | 挂载点 | 作用 |
| 右键菜单 + 引用编辑器 + 注释列表 | shell.overlay | 全帧浮层：拦截助手选区上的 contextmenu，渲染菜单/编辑器/列表 |
| 待发送胶囊 | conversation.input.left | 输入框工具行左侧，显示 📎 N 条注释 |
| 发送桥 | conversation.input.overlay | 从会话作用域拿到 inputActions，把文本写入输入框并提交 |
| 气泡折叠 | 注入 CSS + DOM 标记 | 给用户气泡内的引用 打标记，折叠成附件条 |

- 消息身份不依赖 CSS 类名：从选区节点沿 React fiber 链读取 sessionId / messageId / 轮次，读不到时退回 data-chat-flow-kind 属性。
- 发送走宿主自己的输入管线：insertText（追加到草稿末尾）或 setDraft，随后 submit()，因此排队、steer、附件等行为与手动发送一致。
- 引用内容始终是消息正文的一部分，没有被藏进自定义事件； 折叠只是视觉呈现。

兼容性与已知限制

- 依赖 DSH 客户端内部结构：__reactFiber$*、data-chat-flow-kind / data-chat-turn、用户消息里 的渲染方式。升级 DSH 后可能需要适配。
- 目前只支持助手回复正文；跨消息选择、工具调用卡片、流式输出中的消息不会出现菜单项。
- 待发送注释只存在内存里，刷新页面会清空。
- 在助手选区的右键菜单会替换系统菜单，当前只提供「复制」与「在此回答」两项；其他区域仍使用系统菜单。
- 长引用会截断：正文 300 字、代码 12 行，超出会标注「已截断」。
- 若输入框在确认到发送之间被改动，发送会中止并提示重试，避免覆盖你的草稿。

隐私

插件不做任何网络请求，不收集遥测，也不读写工作区文件。引用的原文与你的回复会作为普通消息文本，经 DSH 原有的发送链路交给模型。

开发

仓库就是包目录，没有构建产物：

client.js # 浏览器半边：菜单、编辑器、注释列表、气泡折叠 index.js # Host 半边：空 apply，仅用于打包 cordis.patch.yml # Bundle 补丁：插入一行 codex-annotate package.json # dsh.bundle / dsh.client 清单
locale/{zh,en}.json# 插件管理器显示的标题与描述
icon.svg # 插件图标

语法自检：

node --check client.js
node --check index.js

贡献者

- mar1259 — 作者、产品方向与测试
- DeepSeek Harness Agent — AI 结对实现（架构、客户端代码、文档）

提交记录中用 Co-authored-by: DeepSeek Harness Agent <agent@dsh.invalid> 标注 AI 协作；这是保留域名的占位邮箱，不对应任何公开账号。

License

MIT © 2026 mar1259

Codex 风格的选择注释，用于 DeepSeek Harness Web UI。在助手回复里选中文字，右键，选 Reply here，写下你的备注，确认——备注会累积成输入框工具行里的 📎 N notes 标签，然后一次性全部发出。发出的消息会引用精确位置（消息 id、轮次、块、小节、字符范围或代码行），并折叠进聊天气泡里可展开的附件行。

安装：

dsh plugin --profile desktop add github:mar1259/dsh-plugin-codex-annotate

已在 DSH 0.2.1-rc.2 上测试。插件依赖客户端内部实现（__reactFiber$、data-chat-flow-kind、渲染出的 blockquote），所以 DSH 升级后可能需要适配。不联网，无遥测。MIT 协议。