dsh-client-ui-quote 0.12.3-lab.26 → 0.12.3-lab.27
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +7 -2
- package/README.md +45 -40
- package/lib/client.js +425 -65
- package/lib/index.js +510 -6
- package/package.json +3 -3
- package/test/capsule.mjs +266 -6
- package/test/host.mjs +352 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,8 +4,13 @@
|
|
|
4
4
|
|
|
5
5
|
### Added
|
|
6
6
|
|
|
7
|
-
-
|
|
8
|
-
-
|
|
7
|
+
- 侧边对话默认内置隐藏线程，不再需要安装 dsh-better-sidebar：宿主半注册 `POST /ui-quote/api/sidechat.start`（同源围栏），从在线父会话复制种子，用宿主 `agents.create` 建 `origin: "subagent"` 子会话，并在宿主内置 `subagentchat` 页签打开；descriptor 与会话标题使用与 better-sidebar 共享的 `Side: ` 约定，装不装它都不冲突。宿主半不可用（旧宿主 / 父会话不在线 / 创建被拒）时自动退回 `sessions.fork` + 本插件原生 `quote-sidechat` 页签；`sideChatBackend: "better"` 才优先走 better-sidebar。
|
|
8
|
+
- 侧边线程记忆与清单：新增 `dsh-client-ui-quote:v1:sidechat-target` 记录隐藏线程的父会话；读取线程时用 subagent 地址 `{parentSessionId, childSessionId, mode:"continuable"}`；线程列表同时扫描会话列表里的 `Side:` 子会话，所以 better-sidebar（或旧版本）创建的线程也能在本插件里打开、带回和导出。
|
|
9
|
+
- 离线断言 **638 组**（check 12 + capsule 436 + panel 153 + host 37）；新增原生页签的地址解析、标题、资源 retain/release、页签注册与卸载断言，以及宿主半的种子复制 / 回合收口 / 悬挂工具调用截断 / `agents.create` 参数 / 探针与围栏断言。
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- 正文以 ``` 或 `~~~` 开头的普通引用在回读时丢了首行：识别代码引用只看首行围栏，却没有要求块尾有配对的收尾围栏，于是引用一段 Markdown 源码时那行被当围栏剥掉（只有一行的引用会整条消失，胶囊、悬停卡片与引用清单都少字）。现在围栏必须成对才算传输层——写出去的代码引用收尾围栏始终成对，旧消息解析不变；不成对的孤围栏按正文还原。
|
|
9
14
|
|
|
10
15
|
## 0.12.2 — 2026-10-22
|
|
11
16
|
|
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
2. 在消息、文件预览、终端或 diff 里**选中一段文字**，浮层选「评论」或「添加到对话」。
|
|
13
13
|
3. 发送后回原文看高亮，悬停胶囊可**跳回**；右侧栏「引用清单」（`Alt+L`）可搜索、导出、审阅。
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
「侧边对话」默认**不需要 `dsh-better-sidebar`**：本插件的宿主半会建一个继承主会话上下文的隐藏子会话（`origin: "subagent"`，不出现在会话列表），用宿主内置的 `subagentchat` 页签打开——仍然只写草稿，不替你发送。宿主半不可用时自动退回 fork + 本插件页签；想优先用 better-sidebar，把 `sideChatBackend` 设成 `"better"`。
|
|
16
16
|
|
|
17
17
|
选中正文 → 浮层动作 → 引用变成输入框里的行内胶囊（不是纯文本），评论也放在同一颗芯片里；发送之后，引用和评论**合成一颗胶囊**留在消息里，不会摊成一屏 `>` 行。第三项「侧边对话」则把引用写进右侧栏一条**独立的侧边线程的输入框**（一条主会话一条线程，反复点就反复追加），问什么由你写，主会话一点都不动。评论框里**引用正文本身也可编辑**（选多了当场裁）；从**文件预览、终端或 diff**划选的引用以**围栏代码块**的线格式发给模型，模型看到的是真正的代码块。引用落进草稿后，**原句在来源消息里留下高亮与序号**，输入框上方出现 **`引用 ×N`** 的聚合条；发送块里的坐标行前面还带一段人可读的 **`引自第 N 轮 · 助手`**，模型不用解码就知道这段话从哪来。
|
|
18
18
|
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
| --- | --- |
|
|
43
43
|
| **评论** | 浮层就地变成评论框（`写一句评论…` + `取消` / `添加到对话`）。评论框里**引用正文也在自己的输入框里、可以改**——选多了就当场裁掉。评论框打开期间，原选区用 Chromium 的 `CSS.highlights` 保持高亮，焦点进了输入框也不会丢参照；不支持该 API 的宿主静默退化，评论框里仍有原文。`Enter` 提交、`Esc` 关闭、引用或评论为空时确认按钮禁用；输入法组合输入不会误触发。 |
|
|
44
44
|
| **添加到对话** | 直接把引用加进输入框，不弹评论框。输入框里已经写好的文字会留在原位：引用落到草稿**最上方**，你的文字另起一行接在下面，光标停在末尾，接着写正式提问即可。 |
|
|
45
|
-
| **侧边对话** |
|
|
45
|
+
| **侧边对话** | 把引用写进一条**独立的侧边对话**的输入框。默认走**内置隐藏线程**：本插件的宿主半用 `agents.create` 建一个继承主会话历史的 `origin: "subagent"` 子会话（会话列表不显示它），用宿主内置的 `subagentchat` 页签打开——聊天记录、输入框、流式输出与工具调用全是 DSH 原生的。宿主半不可用（旧宿主 / 父会话不在线 / 创建被拒）时自动退回 `sessions.fork` + 本插件 `quote-sidechat` 页签；把 `sideChatBackend` 设成 `"better"` 才优先走 dsh-better-sidebar。**不装 better-sidebar 也有隐藏线程**；装了也不会冲突，两边共享 `Side: ` 持久约定但路由、存储与 descriptor 各自独立。所有后端都**什么都不发送**，线程独立运行、不污染主会话，页签自动在右侧栏打开。同一条主会话只开一条线程，之后每次点都在同一条线程的草稿后面接着追加。鲸鱼蓝（`#4d6bfe`）的图标是它在浮层里的标识。**一条引用一条线程**：浮层里还有一项「另开侧边对话」，给这条引用单独开一条线程；之后对同一条引用再选侧边对话，回到的就是它自己的那条。引用清单页底部会列出这个会话的**全部侧边线程**，每条都能重新打开。 |
|
|
46
46
|
| **键盘直达** | `Alt+Q` 引用 / `Alt+C` 评论 / `Alt+B` 侧边对话——同一个浮层的三个动作，不弹浮层直接办。走 DSH 的快捷键服务注册，所以出现在设置里、可改键、与宿主键位冲突会在注册时报错；没有选区时返回 `pass`，按键不会被吞掉。 |
|
|
47
47
|
| **原文侧高亮** | 引用落进草稿或发出后，被引用的原句回到**来源消息**里留下淡黄高亮与**序号角标**（序号就是坐标里的同句序号，和 `「引用N」` 对得上）。支持 `CSS.highlights` 的宿主由浏览器**直接绘制高亮**，滚动、流式输出、虚拟列表重排都跟手，不靠逐帧重画去追；不支持时才退回浮层矩形（只画序号徽章）。行不在视口里、文字已经变了、宿主不给 `Range` 时就静默跳过，**不改宿主的 DOM**（高亮不包 `mark`，也不搬节点）。表格单元格、表格行、段落、列表项、`<br>` 这些块级边界按浏览器选区报告的 `\t` / `\n` 对齐，所以跨单元格、跨行、跨段落的引用也能画回来。 |
|
|
48
48
|
| **聚合引用条** | 输入框上方一条 **`引用 ×N`**：每颗芯片一个摘要胶囊，点一下跳回原文（跳不到就把光标放到芯片上，一次退格删掉），悬停就是完整卡片；每条末尾有 **`✎` 编辑**与 **`×` 移除**：编辑把原引用与评论回填进注释框，确认后旧芯片让位、新芯片原地插入；移除优先走宿主自己的 `consumeToken`（按芯片的 detect 区间与 `draftRev` 做 CAS 精确删除，不会碰错别的文本），宿主没有这个读取面或同名芯片无法区分时才退回「聚焦芯片 + 退格」并提示。**整条索引存在本机**：宿主会跨刷新恢复草稿里的芯片，插件的索引也一起恢复，所以刷新后条、卡片与「打开文件」都还在。主会话与侧边线程各自的输入框各有一条；芯片删光时条自己消失。整条带 `role=toolbar`，每颗胶囊的可访问名是完整引用+评论，不是截断后的标签。 |
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
| **清单多选插入** | 引用清单每行一个勾选框，`插入所选` 一次把多条引用写进输入框——每条各成一颗芯片、各自带坐标，不合并；芯片通路不可用时退回一段包含多个引用块的文本。这一栏是只读导航 + 批量插入，不做就地删除——删除与编辑在**草稿上方的聚合条**里做（宿主暴露了按区间消费 token 的 `consumeToken`；旧宿主没有这个读取面时才退回退格路径）。 |
|
|
52
52
|
| **审阅工作台** | 清单页把引用当**对象**管：每行一个 **`待处理 / 已解决`** 状态钮（点一下切换，行整体随之变淡），页首的 `只看未解决 (N)` 一键筛出没处理完的；每行可以打 **`#标签`**（回车添加、点 × 移除、点标签按它筛选，页首列出全部标签及数量）；勾选若干行后 `标记已解决 (N)` 批量落章，`插入所选` 批量送回输入框。状态与标签按引用坐标归一键（老引用退回按原文），记在本机 `localStorage`（`dsh-client-ui-quote:v1:quote-meta`，上限 800 条）——跨刷新仍在，不跨设备同步、不进模型上下文；`导出 Markdown` 的标题行会带上 `已解决` 与标签标记，没标过的行输出和从前逐字相同。 |
|
|
53
53
|
| **跳回原文** | 悬停卡片底部的 `跳回原文`：把引用当初所在的那条消息**停到视野上方 24px**（和宿主自己跳轮次一样的位置）并闪一下。坐标（消息行锚点 + 轮次 + 同句序号）在插入时**写进消息自己的文本**——一段只在线上存在的 `※ 引自第 N 轮 · 助手 │q1:…` 行（base64url 的 JSON），显示、胶囊、清单导出里都剥掉；它随消息本身走，所以跨刷新、跨窗口、以及清单页里根本没被本插件看着选中的引用都跳得回去。只在**引用自己那条会话的面板里**找，不跨会话误跳；被虚拟列表藏起来的行会让位给同轮次的可见行；压根没挂载的行靠滚动搜索一屏一屏地找出来——先往上找（引用总在比它更早的消息里），一路到顶还没找到就从最新处再来一遍；都找不到就明说（`原文已变`——消息还在、那段文字不在了；或 `原文不在当前视图里`）。 |
|
|
54
|
-
| **引用清单** | 右侧栏的一个**页面**：本会话发出去的引用与评论的清单。搜索框按引用/评论过滤、点一条跳回原文、`导出 Markdown` 落一个文件、历史没读完时可 `加载更早的消息`。它作为**页面类型**注册进右侧栏（`ctx.sidebarRightTabs.register`），并在指南页留下一个胶囊作入口；`Alt+L` 同样能打开。数据来自会话自己的事件日志（`ctx.sessions.retain` → `session.eventSource`），不依赖屏幕上有没有那条消息；**本机还留一份索引**：上下文压缩把消息裁掉之后，这些引用仍然列得出来。清单可以导出 **Markdown**（给人读）或 **JSON**（给工具读：版本化的 schema，带每条引用的来源坐标、文件、审阅状态与标签）；每行带着**自己那份坐标**（从消息文本的 `※ … │q1:…`
|
|
54
|
+
| **引用清单** | 右侧栏的一个**页面**：本会话发出去的引用与评论的清单。搜索框按引用/评论过滤、点一条跳回原文、`导出 Markdown` 落一个文件、历史没读完时可 `加载更早的消息`。它作为**页面类型**注册进右侧栏（`ctx.sidebarRightTabs.register`），并在指南页留下一个胶囊作入口；`Alt+L` 同样能打开。数据来自会话自己的事件日志（`ctx.sessions.retain` → `session.eventSource`），不依赖屏幕上有没有那条消息；**本机还留一份索引**：上下文压缩把消息裁掉之后，这些引用仍然列得出来。清单可以导出 **Markdown**（给人读）或 **JSON**（给工具读：版本化的 schema，带每条引用的来源坐标、文件、审阅状态与标签）；每行带着**自己那份坐标**（从消息文本的 `※ … │q1:…` 行读出来），所以没被本插件看着选过的引用也能跳。页面底部还有一行**宿主自检**：芯片精确删除是否可用、侧聊走内置隐藏线程 / fork / better-sidebar，不开控制台就能判断。 |
|
|
55
55
|
| **侧边线程回流** | 同一个页面底部是这条会话的**侧边线程**：显示它最后问的那个问题与消息条数，并给两个动作——**`带回主会话`** 把线程最后「问题 + 答案」写成主会话输入框里的草稿（**不发送**，你自己按发送），**`导出 Markdown`** 把整条线程落成一个文件。线程内容同样从它自己的事件日志读；没有线程时这一节只说明「还没有侧边线程」。 |
|
|
56
56
|
| **改这条引用** | 悬停卡片里的 `改这条引用`：把那条引用当初的**引用与评论都原样放回评论框**（引用正文、评论各占一个输入框，都能改），你改完按 `⏎` 就发出一条**新的**引用（DSH 没有编辑已发送消息的 API，这是唯一诚实的做法）。旧胶囊随即挂上 **`已修订`** 标记，卡片里直接显示改后的评论；**连正文一起改过的**，卡片里也把改后的原文亮出来。标记按引用原文记在本机，跨刷新仍在。 |
|
|
57
57
|
| **逐条回应** | 评论框里的一格**勾选项**（默认关）：勾上，这条引用的块尾就多一行**只有模型读得到的指令**——请按出现顺序把引用记为「引用1」「引用2」…并在回复中逐条对应。**指令随界面语言**：英文界面下要求模型用 `「Quote N」`，模型的回复里 `「引用N」` 与 `「Quote N」` 都会被认成徽章。模型的回复里每个这样的标签会变成一枚**小徽章**：悬停就是那条引用的完整卡片（含 `跳回原文` 与 `改这条引用`），点了就跳；编号超出这条消息引用数的标签保持纯文本。指令行与围栏一样只是**线上形态**，胶囊、卡片、导出里都不出现。 |
|
|
@@ -77,7 +77,7 @@
|
|
|
77
77
|
| `replyByDefault` | `false` | 「让模型逐条回应」是否默认勾上。 |
|
|
78
78
|
| `attribution` | `true` | 是否把可读的来源头（`引自第 N 轮 · 助手`）写进发给模型的线格式；关掉后仍保留可跳回的坐标。 |
|
|
79
79
|
| `highlight` | `true` | 是否绘制原文侧高亮。 |
|
|
80
|
-
| `sideChatBackend` | `"native"` |
|
|
80
|
+
| `sideChatBackend` | `"native"` | 侧边对话后端：`"native"`（默认）优先用宿主半的内置隐藏线程，失败后退回 fork + 本插件页签；`"better"` 优先用 dsh-better-sidebar 的侧聊。两种设置都不要求装 better-sidebar。 |
|
|
81
81
|
|
|
82
82
|
调试句柄在浏览器控制台里可用：
|
|
83
83
|
|
|
@@ -139,11 +139,11 @@ link 的优点是改完刷新即生效；**日常运行请用方式一**，不
|
|
|
139
139
|
|
|
140
140
|
本机切换这三档（这台开发机专用的辅助脚本，不在仓库里）：`node .dsh-quote-work/profile-mode.mjs link|lab|stable|status`。换完在窗口里 `Ctrl+Shift+R` 生效；只有宿主半有改动时才需要重启桌面端。
|
|
141
141
|
|
|
142
|
-
两条线的断言入口相同：`npm test`（
|
|
142
|
+
两条线的断言入口相同：`npm test`（638 项：check 12 + capsule 436 + panel 153 + host 37）；`.github/workflows/test.yml` 在每次 push / PR 上用 Node 18/20/22 各跑一遍，`publish.yml` 里 `prepublishOnly` 再跑一次才发。
|
|
143
143
|
|
|
144
144
|
**推送通道**：`git push` 优先，但本机 `github.com:443` **时通时不通**（2026-10-19 实测：短时可用、随后连续超时，每次失败等约 21 秒）。日常用工作区根的 `promote.ps1`：先试 git，失败自动转 REST 兜底（`.dsh-quote-work/publish-release.mjs`、`.dsh-quote-work/push-branch.mjs`，`-Channel rest` 可跳过探测），并核对远端 SHA。**别混用两条通道**：REST 重建的提交时区归一到 `+0000`，内容相同但 SHA 不同，同一分支混推会分叉（`git status` 看着干净，远端却多一条平行提交）；恢复就先 `git fetch`、确认 `git diff <本地> <远端>` 为空，再把本地线 reset 到远端。
|
|
145
145
|
|
|
146
|
-
两条线的完整流程（含「main 只做快进」、推 lab 与 main 的顺序、分叉事故的复盘）见工作区根目录的 `PLUGIN-WORKFLOW.md`，一键执行用 `pwsh -File promote.ps1 -Repo dsh-client-ui-quote
|
|
146
|
+
两条线的完整流程（含「main 只做快进」、推 lab 与 main 的顺序、分叉事故的复盘）见工作区根目录的 `PLUGIN-WORKFLOW.md`，一键执行用 `pwsh -File promote.ps1 -Repo dsh-client-ui-quote`。仓库内的 `skills/release/SKILL.md` 把「推 lab / 同步 main / 发版 / 失败处理 / 验收」固化成逐步清单；日常执行以这份清单为准，`PLUGIN-WORKFLOW.md` 保留两条线的总览与事故复盘。
|
|
147
147
|
|
|
148
148
|
**发布运维备忘**（给未来的自己）：
|
|
149
149
|
|
|
@@ -254,14 +254,14 @@ DSH 的输入框是 Lexical，没有 Kimi 的 `quote` 节点，但有一个通
|
|
|
254
254
|
|
|
255
255
|
第三项是本插件自己的扩展（Kimi 的浮层只有两项），融合了三家 agent 同类组件的优点：**Kimi Code 的 `/btw` 侧边聊天**——一键在侧边栏开一条继承主会话上下文的线程；**Qoder 的「在侧边任务中提问」**——同一会话进行中的创建请求自动并入第一次，失败只弹一条提示，绝不大张旗鼓；**WorkBuddy 的划选引用**——引用是线程里持久的内容，而不是一次性的草稿附件。与前两家不同的是**问什么由你来写**：引用只落进那条线程的输入框，不会被当成第一条消息替你发出去。样式上第三项用 DeepSeek 的鲸鱼蓝（`#4d6bfe`）画图标与悬停色，白底浅色主题是主基调，深色主题同一色相。
|
|
256
256
|
|
|
257
|
-
-
|
|
258
|
-
-
|
|
259
|
-
-
|
|
260
|
-
-
|
|
257
|
+
- **内置隐藏线程（默认）**：本插件的宿主半注册 `POST /ui-quote/api/sidechat.start`（同源围栏 `connection.requestRejection`，探针返回可用性）。正式调用时从在线父会话的事件日志复制种子（开着的回合补 `turn/end{interrupted}` 收口；有悬挂工具调用就截到回合前），用宿主 `agents.create` 建一个 **`origin: "subagent"`** 的子会话；descriptor 与会话标题都用 `Side: <引用首行>`。会话列表隐藏它，页签用宿主内置的 `subagentchat` 页打开（`dsh-resource://subagentchat/session/<child>?parent=<sessionId>&mode=continuable`），引用写进它的草稿。草稿第一行是可见的 `Side conversation boundary.` 说明，**同一段草稿里只写一次**（发送后下一段草稿会再带一次，作为提醒），避免模型把继承历史当成新任务。
|
|
258
|
+
- **父会话在线时可继续**：隐藏线程是 `continuable` 子会话，父会话在线时内置页自己的输入框、流式输出与工具调用都能用；父会话关闭后该页按宿主规则只读，重新打开父会话即可继续。这个限制来自宿主的内置 `subagentchat` 页，不是本插件的额外依赖。
|
|
259
|
+
- **共享 `Side:` 约定**：与 dsh-better-sidebar 的侧聊线程使用同一套持久约定（`origin: "subagent"` + `Side: ` 标题）。装不装 better-sidebar 都不冲突：它的自动打开会忽略这类标题；它的侧聊列表也会列出我们的线程，我们的引用清单也会扫到它的 `Side:` 线程。路由、存储键与 descriptor provider（`ui-quote`）全部独立。
|
|
260
|
+
- **回退链**：宿主半不可用（旧宿主、`agents.create` 失败、父会话不在线）→ `sessions.fork` + 本插件 `quote-sidechat` 页签（线程以普通 fork 出现在会话列表）→ better-sidebar（仅显式 `sideChatBackend: "better"` 或最后兜底）→ 无。所有后端都只写草稿、不发送。
|
|
261
261
|
- **写进输入框**：页签打开后，`ctx.get("conversation").input.shell(childId)` 拿到子会话的输入框外壳（`SessionInputShell`），用 `setDraft(...)` 把引用的**纯块引用**形态（`>` 逐行前缀，不带 `❝` 标记——那两个标记是主会话胶囊增强器的识别符，侧边线程用不上）写成草稿：输入框里已经有你写的内容时，引用接在下面、空行隔开；**不发送，也不碰别的东西**。子会话的输入框要等页签挂载后才存在（`shell(id)` 在此之前会抛「resolved no binding」），所以这里按 200ms 轮询等它出现；外壳在而 `setDraft` 不在（版本对不上）则立刻放弃，不空等 5 秒。
|
|
262
|
-
- **一条主会话一条线程**：线程 id
|
|
262
|
+
- **一条主会话一条线程**：线程 id 按主会话记住，优先读本插件自己的 `dsh-client-ui-quote:v1:sidechat-thread`；隐藏线程的父会话记在 `dsh-client-ui-quote:v1:sidechat-target`。旧版 better-sidebar 的 `dsh-sidebar:v1:sidechat-thread` 只作为旧线程迁移的只读回退，不再优先于我们自己的记忆。第二次点第三项不再新建线程，只把新引用接进同一条线程的输入框。
|
|
263
263
|
- **防重复**：同一会话的请求还在途中时，再次点击直接并入第一次（模块级 `Map<sessionId, Promise>` 记账，结算后自行清除）。
|
|
264
|
-
-
|
|
264
|
+
- **失败路径**：隐藏线程创建被拒（父会话不在线 / 宿主服务缺失）→ 自动退回 `sessions.fork`，不重复建线程；`sessions.fork` 拒绝、或页签两种地址都打不开 → toast「侧边对话没有打开，请重试。」；线程已开、草稿没能写进去 → toast「侧边对话已打开，但引用没能写进它的输入框」。
|
|
265
265
|
|
|
266
266
|
### 引用清单（右侧栏页面）
|
|
267
267
|
|
|
@@ -273,7 +273,7 @@ DSH 的输入框是 Lexical，没有 Kimi 的 `quote` 节点，但有一个通
|
|
|
273
273
|
- **导出**走浏览器：`URL.createObjectURL(new Blob([md], { type: "text/markdown;charset=utf-8" }))` + 一个带 `download` 的 `<a>`——宿主没有给客户端插件任何写盘的接口，这是 DSH 里现成的做法（`dsh-session-log-export` 的客户端半边就是这么下载的）。没有 `Blob` 时退回 `data:` URL。
|
|
274
274
|
- **注册形状**（两侧都必须声明，id 是同一个）：`ctx.sidebarRightTabs.register({ id: "dsh-client-ui-quote/list", kind: "quote-list", title, guide: [{ id: "quotes", commandId: "ui-quote.list", order: 20, title, description }] })` 声明**页面类型**（页面类型不写 `patterns`，按 kind 打开），`ctx.slots.register({ name: "sidebar.right.pane.tab", key: "dsh-client-ui-quote/list" }, Body)` 提供**页体**，标题座位 `sidebar.right.pane.tab.title`（同一个 key）提供页签文字。`guide` 数组是发现入口：右侧栏默认页就是指南页，里面每个 `guide` 条目一个胶囊，点开即 `openTab(kind)`。打开动作是 `ctx.get("sidebarRight").openTab("quote-list")`，`Alt+L` 与指南胶囊都走它。
|
|
275
275
|
- **页体拿到的 props**：座位注入的 `inject: (sessionId) => ({ sessionId, load, loadOlder, jump, save, loadThread, back, exportThread })`，页体本身只负责渲染——解析、过滤、Markdown、单行标签都是可离线断言的纯函数。
|
|
276
|
-
- **侧边线程回流**（页面底部那一节）：线程 id
|
|
276
|
+
- **侧边线程回流**（页面底部那一节）：线程 id 从本插件自己的线程记忆与 `sidechat-target` 表反向查出主会话，再用会话列表里的 `Side:` 子会话补扫；旧版 better-sidebar 的 `dsh-sidebar:v1:sidechat-thread` 只作为迁移回退。线程内容用同一个 `withSession` 读取（隐藏线程用 subagent 地址 `{parentSessionId, childSessionId, mode:"continuable"}`，fork 用 session id；`retain` → `ready` → `binding.session.eventSource` → `release`）。`带回主会话` 取线程**最后一条提问**与它之后的**最后一条回答**（提问以 `>` 块引用形式带上，超过 4000 字截断并标注），写进主会话的草稿——用的是第三项那条链路同一个 `prefillDraft`，所以也是「**写草稿、不发送**」，草稿里原有内容保留、回流内容空行接在下面。`导出 Markdown` 把整条线程每条消息按顺序落成文件。
|
|
277
277
|
|
|
278
278
|
### 与 Kimi Code 的对应关系（历史参照）
|
|
279
279
|
|
|
@@ -295,7 +295,7 @@ transcript 侧的 `.dshq-cap` 胶囊：一颗胶囊同时装引用与评论，`
|
|
|
295
295
|
| 同类 | 它做什么 | 我们的取舍 |
|
|
296
296
|
| --- | --- | --- |
|
|
297
297
|
| `@changfenhuang/dsh-annotation`（3513/月，148★） | 最短路径「选中→批注→逐条回应」；文件预览也能批注 | 保留评论+引用同一颗胶囊，多出清单/侧线程/修订；它的低摩擦值得学 |
|
|
298
|
-
| `dsh-sidenote`（3752/月） | 原生侧栏 + 多侧聊 + 划选注释 + 结论回流/存为正式会话 |
|
|
298
|
+
| `dsh-sidenote`（3752/月） | 原生侧栏 + 多侧聊 + 划选注释 + 结论回流/存为正式会话 | 已做「一条引用一条线程」与线程清单；默认就是内置隐藏线程（宿主半种子 + 内置 subagentchat 页），fork 是退路 |
|
|
299
299
|
| `@kirkchinese/dsh-citeciter`（2028/月） | 每次划选一个持久只读 Topic + 草稿自动保存/多窗口合并 | 不做完整 Topic 系统；「新开线程」与草稿持久化已补 |
|
|
300
300
|
| `dsh-quote-annotate-pro`（2126/月） | 发送后引用块常显 3 行 + 自动编号 + 回合尾引用 | 坚持胶囊+悬停卡；回合尾引用已补，常显块不做默认 |
|
|
301
301
|
| `dsh-select-quote`（1212/月） | 待发批注按会话持久化，逐条编辑/删除/清空 | 聚合条已支持逐条编辑/移除、完整无障碍名与跨刷新恢复；删除优先用宿主 `consumeToken` 精确区间 |
|
|
@@ -306,7 +306,7 @@ transcript 侧的 `.dshq-cap` 胶囊：一颗胶囊同时装引用与评论，`
|
|
|
306
306
|
**2026-10-20 复扫补记**（同一份 6,084 条市场快照，补读上轮未收录的 11 款）：
|
|
307
307
|
|
|
308
308
|
- `dsh-sidecard-ask`（3,217/月，10-10 上架）：把「划词 → 独立子代理作答 → 侧边卡片」做成完整承载链（better-sidebar → 原生右栏/内置浮层兜底），说明侧边问答已是独立赛道；我们的侧边对话仍是引用附属，不扩成通用问答。
|
|
309
|
-
- `dsh-side-chat-plus`（1,920/月）与 `dsh-sidenote` 0.6
|
|
309
|
+
- `dsh-side-chat-plus`（1,920/月）与 `dsh-sidenote` 0.6：都把侧聊放进原生右栏；我们的「一条引用一条线程」仍是差异化，默认已改成宿主半创建的隐藏子会话 + 宿主内置 `subagentchat` 页（fork 与 better-sidebar 都是退路/增强）。
|
|
310
310
|
- `dsh-quote-reply`（GitHub 安装）：把引用放到输入框上方的独立层，经 `systemPrompt.context` 注入、回合尾显示「引用(N)」；我们坚持把坐标写进消息文本，换取导出/审阅/跨刷新，不改架构。
|
|
311
311
|
- `dsh-selection-quote`（594/月）与 `dsh-xwide-annotation`（1,148/月）：分别补了右键菜单/持续选区高亮与每条颜色/大纲；我们的清单已是大纲，颜色不是主线，右键菜单也不比现有浮层快。
|
|
312
312
|
- `dsh-code-quote`（776/月，粘贴 `路径:行` + 代码 → chip + pre-step 快照）与 `dsh-quote-to-agent`（引用分派子代理）是相邻赛道，不并入；`dsh-web-annotator`/`dsh-image-annotate` 进一步证明图片/网页批注应独立成插件。
|
|
@@ -317,7 +317,7 @@ transcript 侧的 `.dshq-cap` 胶囊：一颗胶囊同时装引用与评论，`
|
|
|
317
317
|
- **「引用 + 评论合成单一可交互胶囊」**：仍是本插件独有；`dsh-annotation` 证明「选中→批注→逐条回应」有需求，差异在我们的**胶囊 + 清单 + 线程**组合，而不是单点机制。
|
|
318
318
|
- **待发引用管理**：`dsh-select-quote` 的按会话持久化、逐条编辑/删除/清空是这一格的老大；本插件现在补齐了**逐条编辑**（`✎` 回填原引用与评论，旧芯片让位、新芯片原地插入）与**跨刷新恢复**（芯片索引落本机，宿主恢复草稿芯片后它们重新算是我们的引用），我们不提供「一键清空全部」——按条删除更不容易误伤，删除与编辑都在草稿上方的聚合条里做。
|
|
319
319
|
- **代码引用回跳**：`@u2a5f` 已经读源文件算精确行号，`dsh-annotation` 能对文件预览批注并恢复；我们的卡片/清单现在显示 `文件预览 · path#Lx-Ly` 并能打开预览定位起始行、标出被引的行，还差 Markdown 预览的读源行号（要声明 `remote`，风险大于收益，先不做）。
|
|
320
|
-
- **多侧线程/原生侧栏**：`dsh-sidenote`/`CiteCiter` 已把多 Topic
|
|
320
|
+
- **多侧线程/原生侧栏**：`dsh-sidenote`/`CiteCiter` 已把多 Topic、草稿保存做完整；我们现在是**一条引用一条线程**（浮层里「另开侧边对话」，清单页列出全部线程），默认后端是**宿主半创建的隐藏子会话**（`origin: "subagent"` + 宿主内置 `subagentchat` 页，不出现在会话列表），fork 与 better-sidebar 是退路/增强。
|
|
321
321
|
- **图片/截图**：`dsh-selection-toolbar` 与 Kimi 桌面端已经支持；我们仍是纯文本引用。
|
|
322
322
|
- **「原地编辑已发送的批注」**：DSH 仍没有编辑已发送消息的 API（侦察确认 `editMessage`/`updateMessage`/`rewriteMessage` 全树 0 命中），本插件走**追加式修订**；`dsh-plugin-message-edit` 走的是另一条路（原地保存 + 分支重生成 + 版本时间线），两条路线不冲突。
|
|
323
323
|
|
|
@@ -326,7 +326,7 @@ transcript 侧的 `.dshq-cap` 胶囊：一颗胶囊同时装引用与评论，`
|
|
|
326
326
|
1. **语义而不是机制**：引用与评论是同一颗节点（对齐 Kimi 的 `quote` 节点 `{text, comment}`），一颗芯片 → 一个块 → 一颗胶囊 → 一张卡片 → 一次复制；机制（reference chip、DOM 增强）谁都能抄，这条链子不好抄。
|
|
327
327
|
2. **引用是带坐标的活对象**：`跳回原文` 在自己的会话面板里找行、按宿主的方式对齐到 24px，行被虚拟列表藏起来或没挂载都能找回来；坐标以「人可读来源头 + base64 尾巴」随消息走——前者让模型知道出处，后者让插件跨刷新回读。base64 确实占一点 prompt，这是用「不依赖本地表」换来的取舍。
|
|
328
328
|
3. **引用有下落**：清单页（搜索 / 跳转 / 导出 Markdown）+ 侧边线程回流（结论写回主会话草稿 / 导出线程），这两件事在同类里仍是少数。
|
|
329
|
-
4. **工程化**：
|
|
329
|
+
4. **工程化**：638 项离线断言（含真跑 `sessions.retain` / `setDraft` / `agents.create` 参数 / 下载链路）、每个宿主契约都在 README 里写明出处、每个版本都有可回读的 release。同类里做到同等断言规模的仍是少数。
|
|
330
330
|
|
|
331
331
|
反过来也要说清楚：**本插件不做的**——不做翻译/解释/改写/飞书投递类选区动作；不做图片/截图引用（**明确取舍**：图片引用要的是另一套胶囊/卡片/附件语义，是第二个产品的量级，塞进这里只会把「文本引用带坐标」这条主线冲淡；`dsh-selection-toolbar` 与 Kimi 桌面端已经做了，真要做建议独立成插件）；不做完整 Topic 系统；不做常显大块引用。它只把「引用」这一件事做穿——但「做穿」包括发送后的管理、来源闭环和审阅，不只是浮层。
|
|
332
332
|
|
|
@@ -355,27 +355,30 @@ transcript 侧的 `.dshq-cap` 胶囊：一颗胶囊同时装引用与评论，`
|
|
|
355
355
|
package.json DSH 插件清单（bundle patch + client 半 + icon + locale 导出）
|
|
356
356
|
icon.svg 插件页卡片图标（相对路径、≤ 256 KiB 的 SVG）
|
|
357
357
|
cordis.patch.yml 组合包层补丁：插入 ui-quote 这个 loader 条目
|
|
358
|
-
lib/index.js host
|
|
359
|
-
lib/client.js
|
|
358
|
+
lib/index.js host 半：只提供隐藏侧聊线程的创建路由（/ui-quote/api/sidechat.start）
|
|
359
|
+
lib/client.js 客户端全部功能：vendor-CJS 工厂 + 浮层（三项动作）+ 输入框芯片 + 发送后胶囊 + 原文高亮/聚合条 + 侧边对话接线 + 引用清单页（含多选插入）
|
|
360
360
|
.github/workflows/test.yml push / PR 的 Node 18/20/22 测试门
|
|
361
|
+
skills/release/SKILL.md 推送与发版清单（lab 日常推送 / main 快进 / promote.ps1 -Tag / Release 验收）
|
|
361
362
|
locale/zh.json 插件页卡片文案（中文）
|
|
362
363
|
locale/en.json 插件页卡片文案（英文）
|
|
363
364
|
test/check.mjs 离线自检（清单 + 组件契约）
|
|
364
365
|
test/dom.mjs 给离线自检用的最小 DOM / MutationObserver 垫片
|
|
365
|
-
test/capsule.mjs 离线自检（发送后胶囊 + 悬停卡片 + 跳回原文 + 键位 + 改这条引用 + 代码引用 + 文件路径打开 + 聊天代码块划选 + 选区保结构 + 回合级引用 + 逐条回应双语 + 草稿引用编辑/持久化 + 聚合条移除/无障碍 + 行范围标记 + 浮层不随座位失效，
|
|
366
|
+
test/capsule.mjs 离线自检（发送后胶囊 + 悬停卡片 + 跳回原文 + 键位 + 改这条引用 + 代码引用 + 文件路径打开 + 聊天代码块划选 + 选区保结构 + 回合级引用 + 逐条回应双语 + 草稿引用编辑/持久化 + 聚合条移除/无障碍 + 行范围标记 + 浮层不随座位失效，436 项断言）
|
|
366
367
|
test/panel.mjs 离线自检（引用清单：解析 / 搜索 / Markdown / 读取 / 导出 / 页面注册 + 文件路径打开 + 侧边线程回流 + 审阅工作台（状态 / 标签 / 批量）+ JSON 导出 + 本地索引，153 项断言）
|
|
368
|
+
test/host.mjs 离线自检（宿主半：标签 / 种子复制 / 开回合收口 / 悬挂工具调用截断 / 嵌套 descriptor 替换 / agents.create 参数 / 探针 / 围栏 / 路由注册与卸载，37 项断言）
|
|
367
369
|
test/capsule.html 真浏览器里跑同一套胶囊断言（51 项，可选）
|
|
368
370
|
```
|
|
369
371
|
|
|
370
|
-
|
|
372
|
+
客户端功能完全在浏览器侧：`lib/client.js` 用 `window.__ModuleLoader__.load({ id, factory })` 注册，只 `require("react")`
|
|
371
373
|
（平台基线模块），不依赖 react-dom、CSS 文件或 host 半参与序列化；浮层样式是运行时注入的内联 `<style>`，
|
|
372
|
-
胶囊样式是 `<style data-plugin="dsh-client-ui-quote"
|
|
374
|
+
胶囊样式是 `<style data-plugin="dsh-client-ui-quote">`。`lib/index.js` 是唯一的宿主半边，只注册隐藏侧聊线程的创建路由与种子，
|
|
375
|
+
不参与浮层/胶囊/线格式；它只 import Node 内置模块，运行时全部通过 `ctx.get` 取宿主服务，没有 npm 依赖。
|
|
373
376
|
|
|
374
377
|
## 自检
|
|
375
378
|
|
|
376
379
|
```bash
|
|
377
380
|
node --check lib/client.js
|
|
378
|
-
npm test # = node test/check.mjs && node test/capsule.mjs && node test/panel.mjs
|
|
381
|
+
npm test # = node test/check.mjs && node test/capsule.mjs && node test/panel.mjs && node test/host.mjs
|
|
379
382
|
```
|
|
380
383
|
|
|
381
384
|
`test/check.mjs` 用桩 `window.__ModuleLoader__` / 桩 `react` / 桩 host ctx 加载 bundle，断言模块 id、服务声明、
|
|
@@ -413,7 +416,7 @@ React 重渲染不会出现第二颗、引用变了就地重建、消息被删
|
|
|
413
416
|
修订不改写引用原文本身、清空引用正文时确认按钮禁用、改后的正文随新芯片发出；
|
|
414
417
|
**浮层不跟着座位生死**（`conversation.input.overlay` 没挂载也能选中出栏、挂上两个会话座位既不叠加也不丢监听、
|
|
415
418
|
座位不在时用输入框自己的 `actions` 落芯片、无处可插时给 toast 而不是静默返回、effect 卸载/重装后监听恰好一份）；
|
|
416
|
-
（共
|
|
419
|
+
（共 436 项，含文件路径与逐条回应的线上形态、`parseCodeSource`/`fileAddressFor` 与「卡片/清单点击打开 session 文件并带上起始行」、**表格单元格 / 表格行 / 段落 / 列表项 / `<br>` 边界的引用高亮**、**输入框已有文字时引用置顶并将原文另起一行**、聊天代码块划选的语言探测与跨界降级、选区的链接/行内代码保真与纯文本回退、回合级引用的取文与坐标、英文逐条指令与「Quote N」徽章、草稿芯片索引的跨刷新恢复与聚合条编辑/移除、回复徽章的建立/重建/卸载与悬停卡片复用、原生 `quote-sidechat` 页签的注册 / 地址 / 标题 / retain-release、内置 subagentchat 的降级与复用，以及评论框两个输入区的自适应高度——引用正文那格曾经在被挂进栏之前就量高，读到 0 后被写成 `height:0`，首行因此被裁掉）。
|
|
417
420
|
`test/capsule.html` 是同一套断言的真浏览器版（51 项），用 `file://` 打开即可（页面会把结果写进标题与 `#probe-out`）。这一版修好了它**缺失的 `<body>` 标签**——脚本在 `<head>` 里执行时 `document.body` 为 null，这个页面以前在真浏览器里是直接坏的；并补上真 `Range` 的链接/行内代码断言（真浏览器的 `cloneContents()` 返回的是 DocumentFragment，不是元素——序列化器只认元素的话，链接在真浏览器里会退化成纯文本；离线桩现在也用真片段，不再放过这一类），另外补了 `CSS.highlights` 选区保持与关闭清理。
|
|
418
421
|
|
|
419
422
|
`test/panel.mjs` 单独跑引用清单页与侧边线程回流（153 项）：只认**持久**的 `user/message`（`transient`、助手消息、`data: null` 都跳过）、
|
|
@@ -427,28 +430,29 @@ Markdown 的标题/编号/块引用/评论行/时间戳与空列表兜底、超
|
|
|
427
430
|
以及单行的 markup（有坐标 → `jumpable` 且点击回调收到整行，无坐标 → `plain`）与页体外壳（标题、搜索框占位符、底部的侧边线程一节）。
|
|
428
431
|
侧边线程那一节另有 35 项：`sessionMessagesFromEntries` 认两种角色的文本存放位置（用户消息在 `event.data`、助手在 `event.data.message`）、工具结果与空消息不算、
|
|
429
432
|
顺序与 seq/时间透传；`threadConclusion` 取「最后一条提问 + 它之后的最后一条回答」、提问写成 `>` 块引用、只有提问/只有回答/空线程的三种退化、
|
|
430
|
-
超长截断并标注；`threadMarkdown` 的标题/编号/角色/时间与空线程兜底；`mainSessionForThread`
|
|
433
|
+
超长截断并标注；`threadMarkdown` 的标题/编号/角色/时间与空线程兜底；`mainSessionForThread` 反向查本插件线程表、`sidechat-target` 与旧的 better-sidebar 表；
|
|
431
434
|
`readSessionMessages` 真读一遍且 release；`loadThreadSummary` 给出问题与条数、没有线程时 `threadId` 为 null；
|
|
432
435
|
`bringThreadBack` 把结论写成**草稿**（原有草稿保留、空行隔开）、外壳没有 `setDraft` 时如实失败、没有线程时不乱写；
|
|
433
436
|
`exportThread` 的文件名与整条线程内容、以及 MIME 是 Markdown。
|
|
434
437
|
|
|
435
|
-
|
|
438
|
+
`test/host.mjs` 不需要浏览器：它直接 import 宿主半，用桩 `agents` / `agentPresets` / `sessionTitle` / `webServer` 驱动。断言包括：`Side: ` 标签的前缀与截断、父日志逐字复制、开着的回合补 `step/end` + `turn/end{interrupted}`、悬挂工具调用截到回合前并丢掉尾部 inbox splice、嵌套侧聊的父 descriptor 原位替换、seq 连续、窗口化日志拒绝；`agents.create` 收到 `origin: "subagent"` / `parentSession` / `isSeeded` / `inheritedEventCount` / 父会话当前模型路由 / preset setup / 清空继承 inbox / 固定标题；探针、409、503、403、405、404 与 `apply` 的注册/卸载全部有断言。
|
|
439
|
+
|
|
440
|
+
合计 **638 组**（check 12 + capsule 436 + panel 153 + host 37），`npm test` 全绿。
|
|
436
441
|
|
|
437
442
|
## 已知限制
|
|
438
443
|
|
|
439
|
-
-
|
|
440
|
-
|
|
441
|
-
|
|
444
|
+
- **内置隐藏线程依赖宿主内部契约**（app.asar 0.2.1-rc.3 实测）：宿主半 `lib/index.js` 用 `ctx.inject(["webServer"])` 注册 `POST /ui-quote/api/sidechat.start`，在宿主服务就绪后从父会话 `snapshotEvents()` 复制种子，再用 `ctx.get("agents").create({ meta: { parentSession, isSeeded: true, origin: "subagent", delegationDepth, agentPreset }, seed, inheritedEventCount, agentOptions, setup })` 建子会话；descriptor 为 `{version: 3, mode: "continuable", provider: "ui-quote", label}`，标题 `Side: <引用首行>`。`webServer` / `connection.requestRejection` / `agents` 缺失时探针失败，客户端退回 fork；`agents.create` 失败只影响这一条线程。
|
|
445
|
+
隐藏线程是 `continuable` 子会话，**父会话在线时可继续**；父会话关闭后宿主内置 `subagentchat` 页按自己的规则只读，重新打开父会话即可继续。宿主升级改了 `agents.create` / 种子格式时，线程创建会失败并自动退回 `sessions.fork`，不会白屏或报错。
|
|
446
|
+
想优先用 dsh-better-sidebar（实测 0.28.0）的侧聊 UI，把 `sideChatBackend` 设成 `"better"`；它仍走自己的 `POST /sidebar/api/sidechat.start`，父会话未运行时会收到 409。两边共享 `Side: ` 标题约定，装不装都不会互相抢自动打开的焦点。
|
|
442
447
|
- **「改这条引用」是追加，不是原地编辑**：DSH 的 transcript 只追加（侦察确认全树没有 `editMessage` / `updateMessage` / `rewriteMessage` / 回收 API，只有**尚未进入会话**的队列条目可改）。所以修订发出一条新引用（评论、引用正文都可改），旧胶囊只挂 `已修订` 标记——标记存在**本机** `localStorage`（`dsh-client-ui-quote:v1:quote-revised`，按 **`ref + 引用原文`** 归一键、上限 60 条），同一句话从两个不同位置引用时互不影响；没有 ref 的旧引用仍按原文键读写。它不会跨标签页、跨设备同步，也不进入模型上下文；模型看到的是那条改后的新引用。正文改过后键仍是旧原文：`已修订` 挂在**旧**胶囊上（它的卡片里显示改后的原文与评论），改后的新胶囊不挂标。
|
|
443
|
-
-
|
|
448
|
+
- **代码引用的识别靠首行围栏**：块首是 `> ❝ ``` `、块尾有配对的收尾围栏时，这块按代码解析（围栏剥掉、胶囊等宽）。因此一条**普通**引用如果正文恰好以 ``` 或 `~~~` 开头（比如在 Markdown 文件预览里引用了源码），只要它没有配对的收尾围栏，就仍然按正文读回——首行不会被当成围栏吃掉，引用与清单里都是原文。写成代码引用时收尾围栏始终成对，所以正文自带 ``` 的代码引用改用 `~~~` 也不会与这条规则打架。
|
|
444
449
|
- **标记形状的正文会被转义**：一行以 `❝` / `❞` / `※` 或反斜杠开头时，写入线格式前加一个反斜杠、回读时还原。因此引用一段本身含 `❞` 或 `※ │q1:` 形状的文档，不会再被当成评论分隔符或坐标行截断/丢行；旧版本发出的消息没有这层转义，仍按旧规则解析。
|
|
445
450
|
- **文件预览的路径与行号是探测来的**：路径优先读宿主预览头部的路径标签（`[data-textpreview-path]` 的 `title`，实测 0.2.0-rc.2 的侧栏文档预览就是这个形状），其次探一组候选属性；行号只在预览按行渲染时可得（`data-textpreview-line`，纯文本视图有、高亮代码视图没有）。两者都拿不到就不带（引用形态与从前完全一样）；终端来源的引用没有路径可言。路径与行号写进围栏信息位，`sanitizePath` 把带空白或围栏字符的值挡掉。有路径时卡片/清单会显示并打开它；**Markdown 预览不提供源码行锚点**，打开后不会滚到行，切到纯文本/代码视图后再导航。导航只用起始行，行范围的结束行只用于显示。
|
|
446
451
|
- **聊天代码块的识别也依赖宿主 DOM**：选区两端都在同一个 `pre` 里才算代码块，语言从 `code`/`pre` 的 `language-*`/`lang-*` class 或 `data-language` 属性读；宿主换了渲染形状（不用 `pre`、语言标在别处）时，划选安静退化成普通块引用——引用本身不丢，只是少了围栏和语言。宿主若在 `pre` 里渲染行号沟槽，选区带进来的行号文本要靠评论框当场裁掉。
|
|
447
452
|
- **Diff 引用的路径与行号同样是探测来的**：先在 diff 卡片里找 `data-diff-path` / `data-file-path` / `data-diff-file` 等头标签（优先读 `title`），再退回祖先属性；行号读 `data-line-number` / `data-diff-line` / `data-line`。宿主换一套 diff DOM 时只会丢路径/行号，引用本身仍按代码块发。
|
|
448
453
|
- **多选插入按清单当前顺序写**：每条引用各成一颗芯片；宿主编辑器拒绝 chip 写入时整批退回一段文本块，不会重复插入已成功的条目。搜索框一变就清空勾选，避免“看不见的选中项”被插进去。
|
|
449
454
|
- **回复徽章依赖模型守格式**：模型没按指令输出 `「引用N」` 就没有徽章——无损，只是少了联动；输出越界的编号（数错了）保持纯文本。徽章的编号以回复**之前最近的一条带胶囊的消息**为准；切分的是助手消息的文本节点，DSH 若改了助手消息的渲染形态，徽章增强器要跟着调（与胶囊的 `isQuoteRun` 同一条既有限制）。
|
|
450
|
-
- 依赖 DSH 客户端的内部接口（`conversation.input.overlay` 槽位、`inputTriggers.registerSource`、`conversation.input.shell(id).insertReference` / `consumeToken`、scoped `slash/input-insert-reference`、`sessions.fork
|
|
451
|
-
`reference-chip` 节点），DSH 升级有可能失效。
|
|
455
|
+
- 依赖 DSH 客户端的内部接口（`conversation.input.overlay` 槽位、`inputTriggers.registerSource`、`conversation.input.shell(id).insertReference` / `consumeToken`、scoped `slash/input-insert-reference`、`sessions.fork` / `sessions.retain(address)`、`sidebarRight.openResource`、`resources.register`、`SessionProvider` / `conversation.content` 的 embedded 视图、`reference-chip` 节点），以及宿主半的 `webServer.register` / `connection.requestRejection` / `agents.create` / `subagent/descriptor` 种子格式；DSH 升级有可能失效，失效时各后端按上面的回退链降级。
|
|
452
456
|
- **引用清单页依赖右侧栏的两个服务**（`sidebarRightTabs` 与 `sidebarRight`，实测 0.2.0-rc.2）；宿主没有它们时页面不注册、`Alt+L` 给一条 toast
|
|
453
457
|
（「引用清单打不开：右侧栏服务不可用」）而不是报错。它的数据来自会话事件日志，**历史是分页的**：只列已加载的消息，更早的要按 `加载更早的消息`；
|
|
454
458
|
如果会话做过原生上下文压缩/裁剪，被裁掉的那些消息里的引用也不会出现在清单里。导出是浏览器下载（宿主没有给客户端插件写盘接口），
|
|
@@ -466,17 +470,17 @@ Markdown 的标题/编号/块引用/评论行/时间戳与空列表兜底、超
|
|
|
466
470
|
|
|
467
471
|
- **回合级引用依赖宿主的回合尾槽位**：宿主把每条回合的尾部做成一个列表子槽位（`conversation.chat.turnTail`，`kind:"list"`、`scope:"session"`），本插件往里加一条。宿主没有这个槽位时按钮不出现——功能缺失，其它能力不受影响。
|
|
468
472
|
- **引用清单的本机索引只在本机**：它兜的是「上下文压缩把消息裁掉」这一种丢失，记录不进模型上下文、不跨设备、不跨浏览器；没读过的引用它当然也不知道。
|
|
469
|
-
-
|
|
473
|
+
- **侧边对话有一条内置主路 + 三条退路**：默认是宿主半创建的内置隐藏线程（`origin: "subagent"` + 宿主 `subagentchat` 页，会话列表不显示）；父会话不在线 / 宿主半不可用时退回 `sessions.fork` + 本插件 `quote-sidechat` 页签（线程作为普通 fork 出现在会话列表）；再不行才走 dsh-better-sidebar（仅显式 `sideChatBackend: "better"` 或最后兜底）。隐藏线程与 better-sidebar 共享 `Side: ` 标题约定，所以两边的线程列表可以互相看见，但存储键、路由与 descriptor provider 各自独立。未在侧聊里提问前执行「带回主会话」，可能取到复制过来的最后一轮，先在侧聊里问一句即可。所有后端都不可用时浮层里没有侧边对话那两行。
|
|
470
474
|
|
|
471
475
|
## 下一步
|
|
472
476
|
|
|
473
477
|
这一轮补掉了最后一个明确的代码缺口（宿主 `consumeToken` 精确删芯片）；剩下的是取舍与人工动作：
|
|
474
478
|
|
|
475
|
-
-
|
|
479
|
+
- **侧边对话的冷启动续聊**：内置隐藏线程已经解决「不装 better-sidebar 也能把线程藏出会话列表」；剩余的是父会话关闭后的继续提问——宿主内置 `subagentchat` 页在父会话离线时只读，要完全对齐 better-sidebar 需要再搬一套 `agents.resume` / prompt 路由与自己的输入框，属于下一阶段。
|
|
476
480
|
- **Markdown 预览的行号**：要精修就得读源文件，而客户端必须声明 `remote` 才能拿到它；声明错会让 client bundle 在不匹配的宿主上**静默失效**（`dsh-quote-annotate` 上游就是这么死的）。所以先不声明——文件仍然打开，只是落在顶部而不是行上。
|
|
477
481
|
- **表格/列表/LaTeX 的结构保真**：链接与行内代码已做；表格要还原成 Markdown 表格，列表要还原成缩进，成本明显更高，留到有人真的需要时再做。
|
|
478
482
|
- **图片/截图引用**：明确不做（理由见「本插件不做的」）。真要做请独立成插件：图片引用要的是另一套胶囊/卡片/附件语义。
|
|
479
|
-
- **真机验证**：这一轮的宿主契约全部来自 `app.asar` 的一手文档，功能路径有
|
|
483
|
+
- **真机验证**：这一轮的宿主契约全部来自 `app.asar` 的一手文档，功能路径有 638 项离线断言；隐藏线程的 `agents.create` / 种子格式已在**隔离的 DSH web 实例**（临时 `DSH_HOME`，端口 8791，CLI 0.2.1-rc.3）里确认：宿主半通过 `ctx.inject(["webServer"])` 晚到注册，`POST /ui-quote/api/sidechat.start` 的探针返回 `{"ok":true,"value":{"available":true,"version":1}}`，说明 `agents` 服务与同源围栏都就绪。本轮又在**运行中的桌面端**（link 模式，重启后加载 `lib/index.js`）核对过一次：`/ui-quote/api/*` 下任意路径都先被围栏拦成 `403 {"code":"forbidden"}`，而同样方法打一个不存在的顶层路径是 `404`，说明前缀路由确实挂上了、并且先过围栏。原生侧聊页签的 `SessionProvider` / `conversation.content` 嵌入契约还需要在真实窗口里重开一次侧边对话确认（离线桩只覆盖注册、地址、标题与 retain/release，不渲染宿主组件）。真浏览器（1600×2000 视口）同一套断言本轮复核 **51/51**。欢迎页的交互点击被安全闸门拦下，因此下面五条仍需在真实窗口逐项点：聚合条编辑、回合尾的两个按钮、打开文件与行范围标记、另开侧边对话、JSON 导出。
|
|
480
484
|
- **市场收录与首屏**：README 已有截图、徽章、「30 秒上手」与 24 秒静态轮播 GIF；还差把插件提交到 dsh.market / dsh-plugin.org / dsh.pub / awesome-deepseek-harness —— 这些需要外部账号，是人工动作。
|
|
481
485
|
|
|
482
486
|
## 变更记录
|
|
@@ -494,10 +498,11 @@ Markdown 的标题/编号/块引用/评论行/时间戳与空列表兜底、超
|
|
|
494
498
|
**dsh-client-ui-quote** — select any sentence in a DSH conversation and quote it into the composer, Kimi-Code style.
|
|
495
499
|
The floating bar opens **under** the selection (above it only when there is no room below) and offers **Comment**,
|
|
496
500
|
**Add to conversation**, and — the plugin's own addition — **Side chat**: the quote is written into the composer of one
|
|
497
|
-
independent side thread per main session
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
+
independent side thread per main session. By default the plugin's own host half creates a **hidden** child session
|
|
502
|
+
(`origin: "subagent"`, seeded from the parent's log, absent from the session list) and opens it in DSH's built-in
|
|
503
|
+
`subagentchat` page; when the host half cannot create it, the plugin falls back to a fork in its own native page, and
|
|
504
|
+
dsh-better-sidebar stays opt-in via `sideChatBackend: "better"`. Either way it inherits the main session's context and
|
|
505
|
+
opens as a tab in DSH's native right sidebar, drawn in DeepSeek's whale blue. Nothing is sent — the question that
|
|
501
506
|
thread answers stays yours to write, and clicking again appends the next quote to the same thread's draft. The quoted
|
|
502
507
|
text itself is editable in the comment box (trim the selection, correct a revision's wording), and a selection from the
|
|
503
508
|
file preview or the terminal travels to the model as a fenced code block. The quote — and the comment, kept together in the same
|
|
@@ -511,7 +516,7 @@ Screenshots: [floating bar](docs/screenshots/bar.png) · [comment box](docs/scre
|
|
|
511
516
|
Install with `dsh plugin --profile desktop add dsh-client-ui-quote` (published on npm; DSH >= 0.2.0-rc.2, web/desktop client).
|
|
512
517
|
Test with `npm test`. MIT licensed.
|
|
513
518
|
|
|
514
|
-
Kimi Code is where the interaction started, not the whole comparison. As of 2026-10 the DSH market has at least a dozen quote/annotation plugins — `dsh-annotation`, `dsh-sidenote`, `CiteCiter`, `dsh-quote-annotate-pro`, `dsh-select-quote`, `dsh-selection-toolbar`, and others. The floating bar is table stakes; the differentiator here is what happens after the quote is sent: a source highlight and ordinal, jump-back, a searchable review list, side-thread bring-back, revisions, and per-quote reply badges. The draft's `引用 ×N` bar removes a quote through the host's `consumeToken` span CAS (exact occurrence coordinates, draft-revision guarded), falling back to the editor's own Backspace path on hosts without that face, with a manual-backspace hint if neither applies. A preview/diff quote's file now appears as a clickable `path#Lx-Ly` line in the hover card and the quote list; clicking it opens the right sidebar's document preview at the range's first line through `sidebarRight.openResource`, focusing an already-open tab instead of duplicating it. A selection inside one rendered chat code block is quoted as a fenced block carrying the renderer's language, and degrades to a plain blockquote when the selection crosses the block boundary. A quote that is still in the draft can be edited or removed from the aggregate bar, and the chip index is kept locally so a reload does not lose the bar, the hover card or the file it points at. A code quote shows its source (`文件预览 · src/app.ts · L12-L48`) and opens the sidebar's document preview at that line. Side chats are bound per quote — the overlay offers “Open another side chat”, and the quote list shows every thread of the session; by default the same flow
|
|
519
|
+
Kimi Code is where the interaction started, not the whole comparison. As of 2026-10 the DSH market has at least a dozen quote/annotation plugins — `dsh-annotation`, `dsh-sidenote`, `CiteCiter`, `dsh-quote-annotate-pro`, `dsh-select-quote`, `dsh-selection-toolbar`, and others. The floating bar is table stakes; the differentiator here is what happens after the quote is sent: a source highlight and ordinal, jump-back, a searchable review list, side-thread bring-back, revisions, and per-quote reply badges. The draft's `引用 ×N` bar removes a quote through the host's `consumeToken` span CAS (exact occurrence coordinates, draft-revision guarded), falling back to the editor's own Backspace path on hosts without that face, with a manual-backspace hint if neither applies. A preview/diff quote's file now appears as a clickable `path#Lx-Ly` line in the hover card and the quote list; clicking it opens the right sidebar's document preview at the range's first line through `sidebarRight.openResource`, focusing an already-open tab instead of duplicating it. A selection inside one rendered chat code block is quoted as a fenced block carrying the renderer's language, and degrades to a plain blockquote when the selection crosses the block boundary. A quote that is still in the draft can be edited or removed from the aggregate bar, and the chip index is kept locally so a reload does not lose the bar, the hover card or the file it points at. A code quote shows its source (`文件预览 · src/app.ts · L12-L48`) and opens the sidebar's document preview at that line. Side chats are bound per quote — the overlay offers “Open another side chat”, and the quote list shows every thread of the session; by default the same flow creates a hidden seeded subagent thread through the plugin's host half and opens it in the host's built-in chat, with a fork in the plugin's own page as the fallback and better-sidebar as an opt-in backend. Built-in threads share better-sidebar's durable `Side: ` convention, so the two plugins can see each other's threads without sharing storage, routes or descriptors. The quote list exports Markdown and JSON, keeps a local index so a context compaction cannot empty it, and a small whitelisted set of switches plus a `window.__dshQuote` handle sits behind it all. The Chinese section above carries the current 2026-10 market comparison; this plugin is not a Kimi Code clone.
|
|
515
520
|
|
|
516
521
|
Two wire-only extras ride on the same pipeline: a per-quote reply toggle in the comment box (the block carries a
|
|
517
522
|
transport-only instruction, the model answers `「引用N」` by `「引用N」`, and each label becomes a badge that reopens
|