dsh-client-ui-quote 0.12.3-lab.32 → 0.12.3-lab.34

package/CHANGELOG.md

@@ -6,10 +6,11 @@
 
 - 侧边对话默认内置隐藏线程，不再需要安装 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。
 - 侧边线程记忆与清单：新增 `dsh-client-ui-quote:v1:sidechat-target` 记录隐藏线程的父会话；读取线程时用 subagent 地址 `{parentSessionId, childSessionId, mode:"continuable"}`；线程列表同时扫描会话列表里的 `Side:` 子会话，所以 better-sidebar（或旧版本）创建的线程也能在本插件里打开、带回和导出。
-- 离线断言 **656 组**（check 12 + capsule 443 + panel 159 + host 42）；新增原生页签的地址解析、标题、资源 retain/release、页签注册与卸载断言，以及宿主半的种子复制 / 继承切点 / 回合收口 / 悬挂工具调用截断 / `agents.create` 参数 / 探针与围栏断言。
+- 离线断言 **659 组**（check 12 + capsule 446 + panel 159 + host 42）；新增原生页签的地址解析、标题、资源 retain/release、页签注册与卸载断言，以及宿主半的种子复制 / 继承切点 / 回合收口 / 悬挂工具调用截断 / `agents.create` 参数 / 探针与围栏断言。
 
 ### Fixed
 
+- 胶囊的悬停卡片也加了「复制为 Markdown」：同一个 `quoteRowMarkdown` 载荷，无论这条引用有没有坐标都能用（有坐标时出处行就是 `引自第 N 轮 · 助手`）。
 - 引用清单每行多一个「复制」：把**单条**引用复制成 Markdown（原文块引用或代码围栏、评论、`引自第 N 轮 · 助手` 出处），可以直接粘进 PR / issue / 别的会话。之前只有整页导出，单条引用拿不出去——这是竞品调研里唯一明确的能力缺口（Aider `/copy-context`、Zed/Cline 的「带出处」都是这个形态）。
 - 侧聊页打开后是一片「探索未至之境」欢迎页、输入框里也没有引用：宿主把「一个 turn 都没有」的会话算成 blank，blank 会话渲染欢迎页而不是聊天页（没有输入框，`prefillDraft` 无处可落）。种子现在把隐性上下文包进一个**已收口的小回合**（`turn/start` → `step/start` → 上下文消息 → `step/end` → `turn/end{done}`），会话不再是 blank，页签进正常聊天态。
 - 侧边对话只剩**一项**：浮层里「侧边对话」与「另开侧边对话」两个按钮长得一样、语义要读第二行才分得清，现在只留「侧边对话」，一条主会话一条线程（早期按引用分线程的记录仍会识别并复用）。

package/README.md

@@ -10,15 +10,15 @@
 
 1. 安装：`dsh plugin --profile web add dsh-client-ui-quote`；桌面版在应用内插件页搜索同名包。
 2. 在消息、文件预览、终端或 diff 里**选中一段文字**，浮层选「评论」或「添加到对话」。
-3. 发送后回原文看高亮，悬停胶囊可**跳回**；右侧栏「引用清单」（`Alt+L`）可搜索、导出、审阅。
+3. 发送后回原文看高亮，悬停胶囊可**跳回**、可**复制为 Markdown**；右侧栏「引用清单」（`Alt+L`）可搜索、导出、审阅。
 
-「侧边对话」默认**不需要 `dsh-better-sidebar`**：本插件的宿主半会建一个隐藏子会话（主会话的对话摘要作为一条**隐性上下文**注入，不在侧聊里铺开）（`origin: "subagent"`，不出现在会话列表），用宿主内置的 `subagentchat` 页签打开——仍然只写草稿，不替你发送。宿主半不可用时自动退回 fork + 本插件页签；想优先用 better-sidebar，把 `sideChatBackend` 设成 `"better"`。
+「侧边对话」默认**不需要 `dsh-better-sidebar`**：本插件的宿主半会建一个 `origin: "subagent"` 的隐藏子会话（不出现在会话列表），再把主会话**最近几轮的原话**作为一条**隐性上下文**注进去——模型有背景，侧聊里却不会把整段历史铺出来。页签用宿主内置的 `subagentchat` 打开，**仍然只写草稿，不替你发送**。宿主半不可用时自动退回 fork + 本插件页签；想优先用 better-sidebar，把 `sideChatBackend` 设成 `"better"`。
 
 选中正文 → 浮层动作 → 引用变成输入框里的行内胶囊（不是纯文本），评论也放在同一颗芯片里；发送之后，引用和评论**合成一颗胶囊**留在消息里，不会摊成一屏 `>` 行。第三项「侧边对话」则把引用写进右侧栏一条**独立的侧边线程的输入框**（一条主会话一条线程，反复点就反复追加），问什么由你写，主会话一点都不动。评论框里**引用正文本身也可编辑**（选多了当场裁）；从**文件预览、终端或 diff**划选的引用以**围栏代码块**的线格式发给模型，模型看到的是真正的代码块。引用落进草稿后，**原句在来源消息里留下高亮与序号**，输入框上方出现 **`引用 ×N`** 的聚合条；发送块里的坐标行前面还带一段人可读的 **`引自第 N 轮 · 助手`**，模型不用解码就知道这段话从哪来。
 
 ## 定位
 
-2026-10 的 DSH 划词引用赛道已经不缺「选中→塞进输入框」：npm 上至少十几款插件在做同一件事，浮层形态高度同质。本插件的差异在引用**发送之后**——胶囊、原文高亮、跳回、清单审阅、侧线程回流、逐条徽章，以及预览/终端/diff 引用的 `path#Lx-Ly` 线格式。同类里值得放在一起看的有：`dsh-annotation`（最短路径批注）、`dsh-sidenote`（原生侧栏多侧聊）、`CiteCiter`（每次划选一个持久 Topic）、`dsh-quote-annotate-pro`（常显引用块 + 回合尾引用）、`dsh-select-quote`（待发批注持久化）、`dsh-selection-toolbar`（文本+图片）、`@u2a5f/dsh-selection-annotations`（独立 JSON 块）。哪些长处已经吸收、哪些不照抄，见「与同类插件的差异」。
+2026-10 的 DSH 划词引用赛道已经不缺「选中→塞进输入框」：npm 上至少十几款插件在做同一件事，浮层形态高度同质。本插件的差异在引用**发送之后**——胶囊、原文高亮、跳回、单条复制、清单审阅、侧线程回流、逐条徽章，以及预览/终端/diff 引用的 `path#Lx-Ly` 线格式。两条不随波逐流的取向：**所有路径只写草稿、绝不代发**（调研的 12 个主流工具里，只有 inline edit 会自动执行，选区引用一律进草稿）；**侧聊是隐性上下文**（父会话历史只给模型看、不铺在界面上），与 Cursor 的 side chat 同构。同类里值得放在一起看的有：`dsh-annotation`（最短路径批注）、`dsh-sidenote`（原生侧栏多侧聊）、`CiteCiter`（每次划选一个持久 Topic）、`dsh-quote-annotate-pro`（常显引用块 + 回合尾引用）、`dsh-select-quote`（待发批注持久化）、`dsh-selection-toolbar`（文本+图片）、`@u2a5f/dsh-selection-annotations`（独立 JSON 块）。哪些长处已经吸收、哪些不照抄，见「与同类插件的差异」。
 
 ## 界面
 
@@ -139,7 +139,7 @@ link 的优点是改完刷新即生效；**日常运行请用方式一**，不
 
 本机切换这三档（这台开发机专用的辅助脚本，不在仓库里）：`node .dsh-quote-work/profile-mode.mjs link|lab|stable|status`。换完在窗口里 `Ctrl+Shift+R` 生效；只有宿主半有改动时才需要重启桌面端。
 
-两条线的断言入口相同：`npm test`（656 项：check 12 + capsule 443 + panel 159 + host 42）；`.github/workflows/test.yml` 在每次 push / PR 上用 Node 18/20/22 各跑一遍，`publish.yml` 里 `prepublishOnly` 再跑一次才发。
+两条线的断言入口相同：`npm test`（659 项：check 12 + capsule 446 + panel 159 + host 42）；`.github/workflows/test.yml` 在每次 push / PR 上用 Node 18/20/22 各跑一遍，`publish.yml` 里 `prepublishOnly` 再跑一次才发。
 
 **推送通道**：`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 到远端。
 
@@ -326,7 +326,7 @@ transcript 侧的 `.dshq-cap` 胶囊：一颗胶囊同时装引用与评论，`
 1. **语义而不是机制**：引用与评论是同一颗节点（对齐 Kimi 的 `quote` 节点 `{text, comment}`），一颗芯片 → 一个块 → 一颗胶囊 → 一张卡片 → 一次复制；机制（reference chip、DOM 增强）谁都能抄，这条链子不好抄。
 2. **引用是带坐标的活对象**：`跳回原文` 在自己的会话面板里找行、按宿主的方式对齐到 24px，行被虚拟列表藏起来或没挂载都能找回来；坐标以「人可读来源头 + base64 尾巴」随消息走——前者让模型知道出处，后者让插件跨刷新回读。base64 确实占一点 prompt，这是用「不依赖本地表」换来的取舍。
 3. **引用有下落**：清单页（搜索 / 跳转 / 导出 Markdown）+ 侧边线程回流（结论写回主会话草稿 / 导出线程），这两件事在同类里仍是少数。
-4. **工程化**：656 项离线断言（含真跑 `sessions.retain` / `setDraft` / `agents.create` 参数 / 下载链路）、每个宿主契约都在 README 里写明出处、每个版本都有可回读的 release。同类里做到同等断言规模的仍是少数。
+4. **工程化**：659 项离线断言（含真跑 `sessions.retain` / `setDraft` / `agents.create` 参数 / 下载链路）、每个宿主契约都在 README 里写明出处、每个版本都有可回读的 release。同类里做到同等断言规模的仍是少数。
 
 反过来也要说清楚：**本插件不做的**——不做翻译/解释/改写/飞书投递类选区动作；不做图片/截图引用（**明确取舍**：图片引用要的是另一套胶囊/卡片/附件语义，是第二个产品的量级，塞进这里只会把「文本引用带坐标」这条主线冲淡；`dsh-selection-toolbar` 与 Kimi 桌面端已经做了，真要做建议独立成插件）；不做完整 Topic 系统；不做常显大块引用。它只把「引用」这一件事做穿——但「做穿」包括发送后的管理、来源闭环和审阅，不只是浮层。
 
@@ -437,7 +437,7 @@ Markdown 的标题/编号/块引用/评论行/时间戳与空列表兜底、超
 
 `test/host.mjs` 不需要浏览器：它直接 import 宿主半，用桩 `agents` / `agentPresets` / `sessionTitle` / `webServer` 驱动。断言包括：`Side: ` 标签的前缀与截断；种子固定三件事（`session/end-seed{inherited:true}` → 一条 `source.kind="session-context"` 的 `user/message` → `subagent/descriptor`）、`inheritedEventCount` 恒为 0、上下文字段只收用户与助手的原话（最新在后、8000 字上限、跳过 `runtime-context` 与工具事件）、空日志也有可读文案；descriptor 排在切点之后且 seq 连续；`agents.create` 收到 `origin: "subagent"` / `parentSession` / `isSeeded` / `inheritedEventCount` / 父会话当前模型路由 / preset setup / 清空继承 inbox / 固定标题；探针、409、503、403、405、404 与 `apply` 的注册/卸载全部有断言。
 
-合计 **656 组**（check 12 + capsule 443 + panel 159 + host 42），`npm test` 全绿。
+合计 **659 组**（check 12 + capsule 446 + panel 159 + host 42），`npm test` 全绿。
 
 ## 已知限制
 
@@ -481,7 +481,7 @@ Markdown 的标题/编号/块引用/评论行/时间戳与空列表兜底、超
 - **Markdown 预览的行号**：要精修就得读源文件，而客户端必须声明 `remote` 才能拿到它；声明错会让 client bundle 在不匹配的宿主上**静默失效**（`dsh-quote-annotate` 上游就是这么死的）。所以先不声明——文件仍然打开，只是落在顶部而不是行上。
 - **表格/列表/LaTeX 的结构保真**：链接与行内代码已做；表格要还原成 Markdown 表格，列表要还原成缩进，成本明显更高，留到有人真的需要时再做。
 - **图片/截图引用**：明确不做（理由见「本插件不做的」）。真要做请独立成插件：图片引用要的是另一套胶囊/卡片/附件语义。
-- **真机验证**：这一轮的宿主契约全部来自 `app.asar` 的一手文档，功能路径有 656 项离线断言；隐藏线程的 `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 导出。
+- **真机验证**：这一轮的宿主契约全部来自 `app.asar` 的一手文档，功能路径有 659 项离线断言；隐藏线程的 `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 导出。
 - **市场收录与首屏**：README 已有截图、徽章、「30 秒上手」与 24 秒静态轮播 GIF；还差把插件提交到 dsh.market / dsh-plugin.org / dsh.pub / awesome-deepseek-harness —— 这些需要外部账号，是人工动作。
 
 ## 变更记录

package/lib/client.js

@@ -78,9 +78,9 @@ window.__ModuleLoader__.load({
 			openFileFailed: "打不开这个文件预览",
 			copy: "复制",
 			copied: "已复制",
+			copyMarkdown: "复制为 Markdown",
 			failed: "插入失败，请重试",
 			sideChat: "侧边对话",
-			sideChatNew: "另开侧边对话",
 			sideChatFailed: "侧边对话没有打开，请重试",
 			sideChatDraftFailed: "侧边对话已打开，但引用没能写进它的输入框",
 			sideChatNoHost: "这个 DSH 版本缺少原生侧边对话页需要的接口",
@@ -165,9 +165,9 @@ window.__ModuleLoader__.load({
 			openFileFailed: "Could not open that file preview",
 			copy: "Copy",
 			copied: "Copied",
+			copyMarkdown: "Copy as Markdown",
 			failed: "Could not insert, try again",
 			sideChat: "Side chat",
-			sideChatNew: "Open another side chat",
 			sideChatFailed: "The side chat did not open, try again",
 			sideChatDraftFailed: "The side chat opened, but the quote could not be written into it",
 			sideChatNoHost: "This DSH build lacks the host pieces for the native side chat page",
@@ -699,10 +699,10 @@ background:none;color:inherit;font:inherit;font-size:11px;line-height:1.5;opacit
 overflow-wrap:anywhere;cursor:pointer}
 #dsh-quote-popover .dshq-pop-source:hover,#dsh-quote-popover .dshq-pop-source:focus-visible{opacity:1;text-decoration:underline}
 #dsh-quote-popover .dshq-pop-actions{display:flex;flex-wrap:wrap;gap:6px;margin:10px 0 0}
-#dsh-quote-popover .dshq-pop-jump{margin:0;padding:3px 9px;font:inherit;font-size:11px;line-height:1.6;
+#dsh-quote-popover .dshq-pop-jump,#dsh-quote-popover .dshq-pop-copy{margin:0;padding:3px 9px;font:inherit;font-size:11px;line-height:1.6;
 cursor:pointer;border:1px solid var(--dshq-border);border-radius:6px;background:transparent;color:inherit;
 opacity:.72}
-#dsh-quote-popover .dshq-pop-jump:hover{opacity:1}
+#dsh-quote-popover .dshq-pop-jump:hover,#dsh-quote-popover .dshq-pop-copy:hover{opacity:1}
 #dsh-quote-popover .dshq-pop-jump[data-lost="true"]{opacity:.95;font-style:italic}
 #dsh-quote-popover .dshq-pop-revised{padding-left:9px;opacity:.8;
 border-left:2px solid color-mix(in srgb,currentColor 28%,transparent)}
@@ -2614,6 +2614,31 @@ box-shadow:0 1px 3px rgba(0,0,0,.25)}
 				});
 				actions.append(revise);
 			}
+			// Copy this one quote as Markdown — the unit someone pastes into a PR,
+			// an issue or another chat. Offered whether or not it has coordinates.
+			const copyMarkdown = el(doc, "button", {
+				type: "button",
+				class: "dshq-pop-copy",
+				text: translateFor(info.sessionId, "copyMarkdown")
+			});
+			copyMarkdown.addEventListener("click", (event) => {
+				event.stopPropagation();
+				writeClipboard(
+					quoteRowMarkdown({
+						quote: info.quote,
+						comment: info.comment,
+						code: info.code === true,
+						fence: typeof info.path === "string" ? info.path : "",
+						time: "",
+						ref: info.ref
+					})
+				);
+				copyMarkdown.textContent = translateFor(info.sessionId, "copied");
+				setTimeout(() => {
+					copyMarkdown.textContent = translateFor(info.sessionId, "copyMarkdown");
+				}, 1200);
+			});
+			actions.append(copyMarkdown);
 			if (actions.childNodes.length > 0) node.append(actions);
 			// The ref a card was filled with lets a later failure update its jump
 			// control in place instead of waiting for the next hover.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-client-ui-quote",
-  "version": "0.12.3-lab.32",
+  "version": "0.12.3-lab.34",
   "description": "Turn any DSH selection into a reviewable quote — comment / add to chat / side chat, source highlights and jump-back, a searchable review list, side threads, revisions, and per-quote reply badges.",
   "icon": "icon.svg",
   "license": "MIT",

package/test/capsule.mjs

@@ -393,6 +393,28 @@ check("leaving the pill closes the hover card", pop().dataset.visible === "false
 dom.document.querySelector(".dshq-cap-copy").dispatch("click", { target: null, stopPropagation() {} });
 check("the copy button copies the quote", dom.clipboard.length === 1 && dom.clipboard[0] === quote, JSON.stringify(dom.clipboard[0]));
 
+// One quote, out of the card, as Markdown (the unit pasted into a PR). The
+// card is reopened because the pill's own copy button ran in between.
+caps()[0].dispatch("mouseenter", {});
+const popCopy = pop().querySelector(".dshq-pop-copy");
+check(
+	"the hover card offers copying the quote as Markdown",
+	popCopy !== null && popCopy.textContent === "复制为 Markdown",
+	JSON.stringify(popCopy?.textContent)
+);
+popCopy?.dispatch("click", { target: null, stopPropagation() {} });
+check(
+	"it copies a blockquote of that quote",
+	dom.clipboard[dom.clipboard.length - 1] ===
+		quote
+			.split("\n")
+			.map((line) => "> " + line)
+			.join("\n"),
+	JSON.stringify(dom.clipboard[dom.clipboard.length - 1])
+);
+check("the card's copy button says 已复制 after clicking", popCopy?.textContent === "已复制", JSON.stringify(popCopy?.textContent));
+caps()[0].dispatch("mouseleave", {});
+
 // ---- React re-renders ----------------------------------------------------
 dom.document.body.append(dom.document.createElement("div")); // unrelated churn
 dom.document.deliver();