聊天文本标注 ynnmuraii/dsh-plugin-chat-annotations

dsh-plugin-chat-annotations

在 DeepSeek Harness 聊天里给任意文本加标注：选中一段文字，附上评论（也可以不附），标注会随你下一条消息一起送到智能体——作为结构化内容部分，而不是字段装饰。

版本说明。 基于 DeepSeek Harness 0.1.1-rc.2 构建并验证。它挂载的 UI 一直在变；在更新的 Harness 版本上，如果发现哪里变了，请重新验证并更新插件。

功能

- 选中并标注 —— 在任意消息里选中文本，点击 Add to chat，选区上方会出现带编号的标记。
- 非破坏性高亮 —— 聊天记录归 React 所有，插件从不改动它。高亮用 CSS Custom Highlight API 绘制，所以被标注的文本始终完好（删除标注 → 文本不受影响）。
- 评论弹窗 —— 每条标注可附评论，随标记一起保存。
- 标注胶囊 —— 输入框上方悬浮一个计数器（例如 ◫ 2 annotations）；悬停即可列出每条标注及其摘录和评论。
- 随请求发送 —— 标注会作为额外的文本内容部分追加到 session.prompt，智能体就能把它们当作消息的一部分看到。输入框为空时按 Enter，插件会单独发送标注块——不用打任何字。
- 自动清理 —— 发送成功后，标记、胶囊和高亮全部清空，腾出缓冲区给下一轮。
- 滚动安全标记 —— 文本滚出聊天视口（或滚进输入面板）时，标记会隐藏，而不是飘在 UI 上。

安装

从打包好的 tarball 安装

build the bundle (from this repo)
pnpm install --config.strictDepBuilds=false --config.minimumReleaseAge=0
pnpm build
pnpm pack # produces dsh-lab-dsh-plugin-chat-annotations-0.0.0.tgz

install into your profile (run from anywhere; profile path is $DSH_HOME/profiles/<name>)
dsh plugin --profile web add file:/absolute/path/to/dsh-lab-dsh-plugin-chat-annotations-0.0.0.tgz --config.strictDepBuilds=false

然后重启你的 dsh web 服务器（或者直接刷新浏览器标签页——客户端 bundle 在页面加载时会重新读取）。

从 GitHub 安装

dsh plugin --profile web add github:ynnmuraii/dsh-plugin-chat-annotations

验证是否加载成功

打开 Web UI。会话打开后，输入框上方会出现标注胶囊（◫ 0 annotations）。如果没有出现，检查启动页（HARNESS / Failed to load plugins）和服务器日志。

用法

1. 打开会话，在任意消息里选中一个词或一句话。
2. 点击 Add to chat —— 文本上方出现带编号的蓝色标记。
3. （可选）在弹窗里输入评论并点击 Save；或者点 Cancel 关闭，只保留标记。
4. 编辑或删除：点击标记 → 弹窗 → Save / 垃圾桶图标。
5. 发送消息。标注上下文会追加到请求中自动完成。如果输入框为空，直接按 Enter 即可——注释块会单独发送。
6. 发送后，注释自动清空。

注释如何到达智能体

插件拦截 session.prompt 流量，在消息末尾追加一个额外的文本内容部分：

content: [
{ type: "text", text: "your message..." },
{ type: "text", text: "[User annotations]\n1. Selected text: «excerpt» — Comment: ..." } ]

不需要输入任何文字：有待发送的注释且输入框为空时，按 Enter 会把注释块作为唯一内容发送。

开发

pnpm install --config.strictDepBuilds=false --config.minimumReleaseAge=0
pnpm typecheck
pnpm test # vitest + jsdom (6 tests: lifecycle, selection, renumbering, clip)
pnpm build # tsc ESM host + CJS client wrapped for __ModuleLoader__.load

- src/index.ts —— 宿主端（Cordis 插件入口，greet 工具）。
- src/client.ts —— 浏览器端：工具栏、标记、胶囊、弹窗、流量拦截。
- tests/index.spec.ts —— jsdom 行为测试。

目录结构

src/
index.ts host entry (name / inject / apply)
client.ts browser half (registered via __ModuleLoader__.load)
tests/ vitest + jsdom
scripts/
build-client.mjs wraps the CJS client emit into the module-loader contract
pack-smoke.mjs installs the tarball and executes the built entry

兼容性

目标：next（@deepseek-ai/dsh 0.1.1-rc.2，cordis 4.0.1）。
已通过 pnpm lab verify chat-annotations --target next 验证（inspect、install、typecheck、test、build、pack、pack-smoke、composed profile）。