dsh-cue-plugin

跨会话结点引用（cue）插件 / Cross-session node reference plugin for DeepSeek Harness.

---

中文

在对话 A 中，从对话 B 里挑选「结点」（用户消息），把它们的上下文快照注入到 A 给模型阅读——模型不需要自己去翻找任何内容。

安装

dsh plugin add github:unnnnoooo/dsh-cue-plugin

（本地路径同样支持：dsh plugin add ./path/to/dsh-cue-plugin。）

用法

1. 在输入框工具条点击 cue 按钮。

2. 按标题选择目标会话，再勾选它的用户结点——单击切换、拖拽框选，或用 全选 / 清空 批量操作。agent 回复折叠展示且不可选，只有用户消息会成为结点。

3. 点 cue 这些结点 确认：所选结点立即变成输入框里的 chip，上下文快照在 确认这一刻 由固定程序捕获并写进 chip 载荷；相邻的结点自动合并成一个 chip。

4. 发送消息。宿主端 agent/pre-step 监听器解析 dsh-cue: 引用，把它改写为 可读标记 [cue 引用：@标题 #序号…]（让模型知道这是一次引用），并在前面注入 包装好的 session-reference 召回消息：

   ## Cued nodes from 
   
   用户 cue 引用了以下结点，请把它们作为跨会话参考上下文阅读：
   ...
   

   这条消息使用 harness 原生的跨会话形式（source.kind: 'session-reference' + form: 'recall'），转录中会呈现为持久的「Session recall」行，带来源标题和 保留/省略条数——模型和用户都能一眼把它和本会话内容区分开。

设计要点

• 捕获在 cue 时，不在发送时。 用户确认的瞬间由浏览器端读取源会话；宿主端 从不重读源会话，模型也从不自己做提取。
• 去重。 每个选中结点附带一个小上下文窗口（自身 + 前 3 条用户/agent 记录）； 相邻选区的窗口自动合并，连续结点的上下文绝不重复。
• 一个包，两半。 lib/index.js 是宿主半（pre-step 钩子）；lib/client.js 是浏览器半（工具条按钮、选择器、chips），通过 dsh.client 清单和 window.__ModuleLoader__.load 注册。

已知限制

• 除 harness 原生的「Session recall」上下文行外，没有自定义卡片。独立插件包 无法追加自定义会话事件（日志白名单属于 harness 核心，且公开的 append API 无法给仅日志事件标记 ignorable），所以召回行就是持久化呈现。
• 读取其它 harness 版本写入的会话可能失败（日志格式不跨版本）；选择器会给出 友好的错误提示。
• @cue 触发器只注册了 codec；选择器本身由按钮驱动，不走 @ 菜单。

构建

pnpm install
pnpm build   # tsc --noEmit 类型检查 + tsdown → lib/index.js, lib/client.js

lib/ 已提交，git 安装直接使用预构建产物（安装方无需任何构建步骤）。

---

English

In conversation A, pick user nodes from conversation B and inject their captured context into A for the model — without the model having to search for anything itself.

Install

dsh plugin add github:unnnnoooo/dsh-cue-plugin

(Local checkout works too: dsh plugin add ./path/to/dsh-cue-plugin.)