unnnnoooo/dsh-cue-plugin

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.)

Usage

1. In the composer's tool row, click the cue button.
2. Pick a target session by title, then select its user nodes — click to
toggle, drag to box-select, or 全选 / 清空 for batch. Agent replies are
shown collapsed and are never selectable; only user messages become nodes.
3. Confirm (cue 这些结点): the selection becomes chips in the composer,
captured at cue time — the context snapshot is built by fixed client
code the moment you confirm and shipped inside each chip. Consecutive nodes
merge into one chip automatically.
4. Send the message. On the host, an agent/pre-step listener parses the
dsh-cue: mentions, rewrites them to a readable marker
([cue 引用：@标题 #seq…]) so the model knows a reference happened, and
prepends a wrapped session-reference recall message:

Cued nodes from

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

The recall message rides the harness's first-class cross-session form
(source.kind: 'session-reference' + form: 'recall'), so the transcript
渲染一个持久的“Session recall”节点，带有来源标签以及保留/省略计数——模型和用户都能将引用的上下文与原生对话区分开来。

设计说明

- 在提示时捕获，而非发送时。 浏览器在用户确认的那一刻读取源会话；宿主从不重新读取源会话，模型也从不执行提取。
- 去重。 每个选中的节点都附带一个小型上下文窗口（其自身加上前面的用户/代理轮次，宽度为 3）；相邻选区的窗口会被合并，因此连续节点的上下文绝不会重复。
- 一个包，两半。 lib/index.js 是宿主那一半（pre-step 钩子）；lib/client.js 是浏览器那一半（composer 触发器、选择器、chips），通过 dsh.client manifest 和 window.__ModuleLoader__.load 注册。

已知限制

- 除了 harness 原生的“Session recall”上下文行之外，没有自定义提示卡。独立包无法追加自定义会话事件（日志白名单属于 harness 核心，且仅日志事件无法通过公共 append API 标记为 ignorable），因此 recall 行就是持久化的呈现方式。
- 读取由不同 harness 版本写入的会话可能会失败（日志格式不跨版本兼容）；选择器会改为显示友好的错误。
- @cue 触发器只注册一个编解码器；选择器本身是按钮驱动的，而非菜单驱动的。

构建

pnpm install
pnpm build   # tsc --noEmit typecheck + tsdown → lib/index.js, lib/client.js

lib/ 已被提交，因此 git 安装会直接使用预构建的包（安装机器上不会运行 prepare/构建步骤）。