dsh-quote-comment 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# dsh-quote-comment
+
+在 DSH 会话里**用鼠标选中任意内容 → 选区旁浮出「添加评论」按钮 → 点击即把选中文本作为一枚原子引用 chip 插入聊天输入框**，光标落在 chip 之后，直接接着写你的评论。
+
+chip 上只显示一行摘要（悬停看全文），发送时由本插件的 codec 展开成 Markdown 引用（每行 `> `）——**输入框里干净，模型收到的是完整的被引内容**。
+
+这就是「快速引用选中内容与模型交流」：不用手打 `> `，也不用复制粘贴。
+
+## 交互细节
+
+| 动作 | 行为 |
+| --- | --- |
+| 在会话正文里选中文字 | 选区右下方浮出「添加评论」胶囊按钮（悬停显示选区预览） |
+| 点击按钮 | 选中文本作为引用 chip 插入输入框（chip 显示 40 字摘要），光标落在 chip 之后；按钮消失、选区清空、焦点回到输入框 |
+| 发送消息 | chip 按 `codec.serialize` 展开成 Markdown 引用块（每行 `> `，空行写成 `>`，末尾一空行） |
+| 滚动 / 缩放窗口 | 按钮跟随选区位置 |
+| 按 Esc | 收起按钮 |
+| 在输入框内选中文字 | 不出现按钮（只有会话正文里的选中才算） |
+| 插入通道 | ① 官方引用通道 `actx.bail("slash/input-insert-reference")` → ② 官方 `inputActions.insertText(text, captureInsertion())` → ③ 合成 `paste` 事件 → ④ 写入剪贴板并提示「已复制，请粘贴」 |
+
+## 实现要点
+
+- 纯客户端插件：宿主半身 `lib/index.js` 只打印一行日志，全部行为在 `lib/client.js`（无构建步骤，直接就是浏览器可加载的 UMD 包装，`window.__ModuleLoader__.load({ id: "dsh-quote-comment" })`）。
+- 浮层挂在官方 `shell.overlay` 槽位（`{ kind: "list", scope: "root" }`，由 `@deepseek-ai/dsh-client-ui-layout` 的 AppFrame 渲染，z-index 20 的 `pointer-events:none` 全屏层，直接子元素恢复 `pointer-events:auto`），不占用会话排版、不需要会话作用域。
+- **引用 chip 走官方引用通道**（与官方 `@` 引用同一条路）：`captureInsertion()` 取 span → 在会话作用域上 `actx.bail(actx, "slash/input-insert-reference", { reference, span })`（会话作用域经 `sessions.binding(sessionId).ctx` 取，`sessionId` 来自 `uiSession.current.getSnapshot().key`）→ ui-conversation 的 `SessionInputShell.insertReference` 把它落成 Lexical 的 `reference-chip` 节点（`data-composer-chip="quote-comment"`），并自动补一个尾随空格。
+- **chip 只带 `source` 名字，序列化靠插件自己注册的属主**：`ctx.get("inputTriggers").registerSource({ trigger: "#", name: "quote-comment", candidates: () => [], codec: { clipboardText, serialize } })`，提交消息时 inputTriggers 按名字找到本插件、调用 `codec.serialize(ref)` 把 `ref`（原始选中文本）展开成引用块。**没有这个属主，发送会被 `no serializer for reference source "quote-comment"` 挡住**，所以注册失败时（服务缺失/名字被占）自动退回纯文本路径。
+- 兜底写输入框走官方 `inputActions`（ui-conversation 经 `uiSession` 服务以 `props.inputActions` 暴露）：`insertText(text, captureInsertion())`。输入框是 Lexical 编辑器，`document.execCommand("insertText")` 对它不可靠，所以再兜底用合成 `paste` 事件。
+- 会话正文判定用官方 DOM 锚点：`[data-chat-flow]` / `[data-chat-flow-key]` / `[data-chat-anchor-key]` / `[data-conversation-scroll]`，并排除 `[data-composer-seat]`（输入区）与插件自己的 `[data-quote-comment-root]`。
+
+## 安装到 desktop profile
+
+profile 目录：`%USERPROFILE%\.dsh\profiles\desktop`（本机 `C:\Users\wangj\.dsh\profiles\desktop`）。
+
+```powershell
+$src = 'C:\Users\wangj\Documents\deepseek-harness\default-workspace\dsh-quote-comment'
+$profile = "$env:USERPROFILE\.dsh\profiles\desktop"
+
+# 1) 把源码目录链接进 profile 的 node_modules（junction，改动即时生效，不用重新拷贝）
+New-Item -ItemType Junction -Path "$profile\node_modules\dsh-quote-comment" -Target $src
+```
+
+2. 在 `$profile\package.json` 里登记两处（插件生效必须同时出现）：
+
+```json
+{
+  "dependencies": {
+    "dsh-quote-comment": "link:C:/Users/wangj/Documents/deepseek-harness/default-workspace/dsh-quote-comment"
+  },
+  "dsh": {
+    "profile": {
+      "bundles": [
+        "@deepseek-ai/dsh-base",
+        "@deepseek-ai/dsh-web-app",
+        "@deepseek-ai/dsh-experimental-agent-team-profile",
+        "dshmarket",
+        "billion-context",
+        "@vectorize-io/hindsight-coding-agents",
+        "dsh-cost-meter",
+        "dsh-quote-comment"
+      ]
+    }
+  }
+}
+```
+
+3. 重启 DSH（客户端 bundle 在启动时组图，改完要重启；重启后刷新页面）。
+
+卸载：把 `bundles` 与 `dependencies` 里的 `dsh-quote-comment` 去掉，删掉 `node_modules\dsh-quote-comment` 这个 junction，重启即可。
+
+## 自测
+
+```powershell
+& "C:\Users\wangj\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe" test\smoke.mjs
+```
+
+`test/smoke.mjs` 用迷你 DOM + 迷你 React 在 Node 里驱动 `lib/client.js`，覆盖 49 项断言：模块契约、选区浮出按钮、定位、**官方引用 chip 通道（属主注册、reference 载荷、codec 序列化、摘要截断）**、无 chip 服务时回退 `inputActions.insertText`、多行引用格式、输入区选中不触发、`paste` 兜底、剪贴板兜底。
+
+`test/install-check.mjs` 另做 16 项安装自检（profile 登记、加载器清单契约、bundle 形态、宿主半身）。
+
+## 重启后验收（30 秒）
+
+1. 退出并重开 DeepSeek Harness（客户端 bundle 只在启动时组图，`rev` 由内容哈希推导，改代码后重启即换新 URL，不会吃到旧缓存），刷新页面。
+2. 在任意会话的模型回答里**用鼠标选中一段文字** → 选区右下方出现「添加评论」胶囊按钮。
+3. 点它 → 输入框里出现一枚**引用 chip**（气泡图标 + 选中内容摘要），光标在 chip 之后，接着写你的评论即可；发送后模型看到的是完整的 `> ` 引用块。
+
+想确认插件是否真的加载了，可在 DevTools Console 里跑：
+
+```js
+document.querySelectorAll('[data-quote-comment-root]').length            // 1 = 浮层已挂载
+document.querySelector('[data-composer-chip="quote-comment"]') !== null  // true = chip 插入成功
+```
+
+若按钮不出现，按顺序排查：插件是否在 profile 的 `dependencies` + `dsh.profile.bundles` 两处都登记（跑 `node test/install-check.mjs`）；重启是否真的发生（宿主日志里应有 `[dsh-quote-comment] host half loaded`）；选中的是否在会话正文而非输入框内。
+
+若出现的是 `> 选中内容` 这样的纯文本而不是 chip，说明官方引用通道没走通（回退链生效）：此时功能仍可用，但可以检查 `ctx.get("inputTriggers")` / `ctx.get("sessions")` 是否改名。
+
+## 已知边界
+
+- 只处理鼠标选区（`selectionchange` / `mouseup`）；键盘跨消息选中同样覆盖（走 `selectionchange`）。
+- chip 的 `appearance` 用官方三种图标里唯一的对话图标 `session`（另两种是 `file` / `folder`）；`ref` 存的是原始选中文本，所以 chip 是「文本引用」而不是「会话引用」，点击 chip 不会打开别的会话（官方引用源才提供 `openReference`）。
+- 引用块用 Markdown `> `，与模型交流时语义明确，也不会触发输入框的 `/` 命令菜单。
+- 插件注册的属主触发字符是 `#` 且不提供补全候选：输入 `#` 不会弹出额外菜单项。若日后与别的插件撞名（`(trigger,name)` 唯一），插件会自动改用纯文本路径而不会报错。
+- 若 DSH 后续改了 `shell.overlay` 槽位名、`inputActions` 方法名、`slash/input-insert-reference` 事件名或输入框锚点，需要同步更新 `lib/client.js` 顶部的选择器/常量与 `resolveInputActions()`。

package/dsh.bundle.patch.yml

@@ -0,0 +1,4 @@
+# dsh bundle patch：把本插件插入 profile 的层叠栈（生成一条 Loader 条目）。
+- insert:
+    - id: dsh-quote-comment
+      name: 'dsh-quote-comment'

package/lib/client.js

@@ -0,0 +1,560 @@
+/**
+ * dsh-quote-comment —— 浏览器侧半身。
+ *
+ * 交互：在会话正文里用鼠标选中一段文本 → 选区右下角浮出「添加评论」按钮 →
+ * 点击后把选中文本作为一个**原子引用 chip** 插进聊天输入框（chip 上只显示一行摘要，
+ * 鼠标悬停看全文），光标落在 chip 之后，用户接着写自己的评论。
+ * 发送时 chip 由本插件的 codec 展开成 Markdown 引用（每行前缀 `> `），
+ * 也就是说输入框里干净，模型收到的是完整的被引内容。
+ *
+ * 实现要点：
+ * - 通过 `dsh.client` 声明由 client-modules 组图，本文件是自执行 UMD 包装，
+ *   模块 id 必须等于包名。
+ * - 浮层挂在官方 `shell.overlay` 槽位（`{ kind: "list", scope: "root" }`，
+ *   ui-layout 的 AppFrame 渲染，容器 `position:absolute; inset:0; pointer-events:none`，
+ *   其直接子元素恢复 `pointer-events:auto`，故按钮自身可点）。
+ * - chip 走官方引用通道（与官方 `@` 引用同一条路）：
+ *   `captureInsertion()` 取 span → 在 session scope 上
+ *   `actx.bail(actx, "slash/input-insert-reference", { reference, span })`，
+ *   由 ui-conversation 的 `SessionInputShell.insertReference` 落成 `reference-chip` 节点。
+ *   chip 只带 `source` 名字，提交时 inputTriggers 按名字找属主的 codec 序列化成模型文本，
+ *   所以本插件必须在 `inputTriggers.registerSource` 里注册同名属主（见 `ensureSource`），
+ *   否则发送会被 `no serializer for reference source "quote-comment"` 挡住。
+ * - 输入框是 Lexical：`document.execCommand` 不可靠，故 chip 失败时逐级兜底
+ *   `inputActions.insertText` → 合成 paste 事件 → 剪贴板。
+ */
+
+window.__ModuleLoader__.load({ id: "dsh-quote-comment", factory: (require) => {
+var module = { exports: {} };
+var exports = module.exports;
+
+"use strict";
+
+var React = require("react");
+
+/** 会话正文区锚点（由官方 dsh-client-ui-chat / ui-conversation 渲染）。 */
+var TRANSCRIPT_SELECTOR = "[data-chat-flow],[data-chat-flow-key],[data-chat-anchor-key],[data-conversation-scroll]";
+/** 输入区（输入框里的选中不该出现按钮）与本插件自己的浮层。 */
+var EXCLUDED_SELECTOR = "[data-composer-seat],[data-quote-comment-root]";
+var STYLE_TAG_ID = "dsh-quote-comment/style.css";
+var OWN_UI_ATTR = "data-quote-comment-root";
+/** 本插件在 inputTriggers 里注册的引用属主名（chip 的 `source` 就是这个名字）。 */
+var SOURCE_NAME = "quote-comment";
+/** 属主的触发字符；本插件不提供补全菜单，用一个不和官方 `/`、`@` 抢的字符。 */
+var TRIGGER_CHAR = "#";
+/** chip 图标种类：官方只认 session/file/folder，对话场景用 session（气泡）。 */
+var CHIP_APPEARANCE = "session";
+/** chip 单行摘要最多显示多少字符。 */
+var LABEL_MAX = 40;
+
+var CSS = [
+  ".dqc-root{position:fixed;z-index:30;pointer-events:auto;transform:translateX(-50%);}",
+  ".dqc-btn{display:inline-flex;align-items:center;gap:5px;padding:4px 11px;border-radius:999px;",
+  "border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.35));",
+  "background:var(--dsw-alias-bg-base,#fff);color:var(--dsw-alias-label-primary,#1f1f1f);",
+  "font-family:inherit;font-size:13px;line-height:18px;white-space:nowrap;cursor:pointer;",
+  "box-shadow:0 6px 18px rgba(0,0,0,.18);transition:background-color .12s ease,transform .12s ease;}",
+  ".dqc-btn:hover{background:var(--dsw-alias-interactive-bg-hover-solid,rgba(127,127,127,.14));}",
+  ".dqc-btn:active{transform:scale(.97);}",
+  ".dqc-btn svg{width:14px;height:14px;flex:none;}",
+  ".dqc-btn[data-status=copied],.dqc-btn[data-status=failed]{opacity:.9;}"
+].join("");
+
+/** 元素节点归一：文本节点取 parentElement。 */
+function elementOf(node) {
+  if (node === null || node === undefined) return null;
+  if (node.nodeType === 1) return node;
+  return node.parentElement || null;
+}
+
+/** 选区是否落在会话正文里（且不在输入区 / 不在本插件自己的 UI 上）。 */
+function insideTranscript(node) {
+  var element = elementOf(node);
+  if (element === null || typeof element.closest !== "function") return false;
+  if (element.closest(EXCLUDED_SELECTOR) !== null) return false;
+  return element.closest(TRANSCRIPT_SELECTOR) !== null;
+}
+
+/** 事件目标是否属于本插件自己的浮层。 */
+function ownUi(node) {
+  var element = elementOf(node);
+  if (element === null || typeof element.closest !== "function") return false;
+  return element.closest("[" + OWN_UI_ATTR + "]") !== null;
+}
+
+/** 选区最后一个可见行的视口矩形（用于给按钮定位）。 */
+function lastRect(range) {
+  var rects = typeof range.getClientRects === "function" ? range.getClientRects() : null;
+  if (rects !== null) {
+    for (var index = rects.length - 1; index >= 0; index -= 1) {
+      var candidate = rects[index];
+      if (candidate && (candidate.width > 0 || candidate.height > 0)) return candidate;
+    }
+  }
+  var single = typeof range.getBoundingClientRect === "function" ? range.getBoundingClientRect() : null;
+  if (single && (single.width > 0 || single.height > 0)) return single;
+  return null;
+}
+
+/** 读取当前选区；不是「会话正文里的非折叠选中」时返回 null。 */
+function readSelection() {
+  var selection = window.getSelection();
+  if (!selection || selection.rangeCount === 0 || selection.isCollapsed) return null;
+  var text = selection.toString();
+  if (text.trim() === "") return null;
+  var range = selection.getRangeAt(0);
+  if (!insideTranscript(range.startContainer) && !insideTranscript(range.endContainer)) return null;
+  var rect = lastRect(range);
+  if (rect === null) return null;
+  var half = 62;
+  var x = rect.left + rect.width / 2;
+  x = Math.min(Math.max(x, half + 8), Math.max(half + 8, window.innerWidth - half - 8));
+  var y = rect.bottom + 10;
+  if (y > window.innerHeight - 44) y = Math.max(10, rect.top - 40);
+  return { text: text, x: Math.round(x), y: Math.round(y) };
+}
+
+/** 把选中文本变成输入框里的引用块：每行 `> ` 前缀，尾部留一空行给用户写评论。 */
+function quoteOf(raw) {
+  var lines = String(raw).replace(/\r\n?/g, "\n").split("\n");
+  while (lines.length > 0 && lines[lines.length - 1].trim() === "") lines.pop();
+  while (lines.length > 0 && lines[0].trim() === "") lines.shift();
+  var body = lines
+    .map(function (line) {
+      var trimmed = line.replace(/[ \t]+$/, "");
+      return trimmed.trim() === "" ? ">" : "> " + trimmed;
+    })
+    .join("\n");
+  return body + "\n\n";
+}
+
+/** 压平空白并按需截断（chip 摘要 / 按钮 title 共用）。 */
+function excerptOf(raw, max) {
+  var flat = String(raw).replace(/\s+/g, " ").trim();
+  return flat.length > max ? flat.slice(0, max) + "…" : flat;
+}
+
+/** 按钮 title 里显示的选区预览（压平空白）。 */
+function previewOf(raw) {
+  return excerptOf(raw, 120);
+}
+
+/** 引用块里第一行非空文本（兜底路径用它判断插入是否真的发生）。 */
+function firstLineOf(block) {
+  var lines = String(block).split("\n");
+  for (var index = 0; index < lines.length; index += 1) {
+    var line = lines[index].replace(/^>\s?/, "").trim();
+    if (line !== "") return line;
+  }
+  return "";
+}
+
+/** 输入框承载元素（Lexical 的 contenteditable）。 */
+function composerHost() {
+  var seat = document.querySelector("[data-composer-seat]");
+  if (seat === null) return null;
+  return seat.querySelector('[contenteditable="true"]') || seat.querySelector("textarea");
+}
+
+/** 输入框当前文本（仅用于兜底路径的成功判定）。 */
+function composerText() {
+  var host = composerHost();
+  if (host === null) return "";
+  if (typeof host.value === "string") return host.value;
+  return host.textContent || "";
+}
+
+/** 把焦点交回输入框（insertText 已把光标落在插入文本之后）。 */
+function focusComposer() {
+  var host = composerHost();
+  if (host === null || typeof host.focus !== "function") return;
+  try {
+    host.focus({ preventScroll: true });
+  } catch (error) {
+    try {
+      host.focus();
+    } catch (ignored) {
+      /* 忽略 */
+    }
+  }
+}
+
+function installStyle() {
+  if (typeof document === "undefined") return;
+  if (document.querySelector("style[data-plugin-css=" + JSON.stringify(STYLE_TAG_ID) + "]") !== null) return;
+  var tag = document.createElement("style");
+  tag.dataset.plugin = "dsh-quote-comment";
+  tag.dataset.pluginCss = STYLE_TAG_ID;
+  tag.textContent = CSS;
+  document.head.append(tag);
+}
+
+function removeStyle() {
+  if (typeof document === "undefined") return;
+  var tag = document.querySelector("style[data-plugin-css=" + JSON.stringify(STYLE_TAG_ID) + "]");
+  if (tag !== null && tag.parentNode !== null) tag.parentNode.removeChild(tag);
+}
+
+/** 「添加评论」的图标（气泡 + 加号）。 */
+function iconNode() {
+  return React.createElement(
+    "svg",
+    { viewBox: "0 0 16 16", "aria-hidden": "true", focusable: "false" },
+    React.createElement("path", {
+      d: "M2.5 3.1h11a.9.9 0 0 1 .9.9v5.6a.9.9 0 0 1-.9.9H8.2l-3 2.2a.4.4 0 0 1-.6-.3v-1.9H2.5a.9.9 0 0 1-.9-.9V4a.9.9 0 0 1 .9-.9Z",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: "1.2",
+      strokeLinejoin: "round"
+    }),
+    React.createElement("path", { d: "M8 5.1v3M6.5 6.6h3", fill: "none", stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round" })
+  );
+}
+
+/**
+ * 装载客户端半身。
+ * @param ctx - 客户端 Cordis 上下文。硬依赖只有 `slots`（`exports.inject`）；
+ *   `inputTriggers` / `sessions` / `uiSession` 都在用时惰性 `ctx.get()` 解析，
+ *   拿不到就自动退回纯文本路径，不会因此加载失败。
+ */
+function apply(ctx) {
+  installStyle();
+  ctx.effect(function () {
+    return function () {
+      removeStyle();
+    };
+  }, "dsh-quote-comment: styles");
+
+  /** 引用属主状态：ready = 已注册；broken = (trigger,name) 被占或字符非法，此后只走纯文本路径。 */
+  var sourceReady = false;
+  var sourceBroken = false;
+  var sourceDisposer = null;
+
+  /** uiSession 主视图 binding 的快照（`{ key, ctx, hooks, props }`，key 即 sessionId）。 */
+  function uiSessionSnapshot() {
+    try {
+      var service = typeof ctx.get === "function" ? ctx.get("uiSession") : ctx.uiSession;
+      if (!service || !service.current || typeof service.current.getSnapshot !== "function") return null;
+      return service.current.getSnapshot() || null;
+    } catch (error) {
+      return null;
+    }
+  }
+
+  /** 取当前会话的输入框 action 面：uiSession → current binding → props.inputActions。 */
+  function resolveInputActions() {
+    var snapshot = uiSessionSnapshot();
+    var actions = snapshot && snapshot.props ? snapshot.props.inputActions : undefined;
+    return actions || null;
+  }
+
+  /** 当前主视图会话 id（chip 落笔要知道把事件发到哪个 session scope）。 */
+  function currentSession() {
+    var snapshot = uiSessionSnapshot();
+    if (snapshot === null) return null;
+    var id = snapshot.key;
+    if (id === undefined || id === null || id === "") id = snapshot.props ? snapshot.props.sessionId : null;
+    if (id === undefined || id === null || id === "") return null;
+    return { id: String(id), ctx: snapshot.ctx || null };
+  }
+
+  /** 会话作用域 ctx：与官方 ui-commands 一样经 `sessions.binding(sessionId).ctx` 取。 */
+  function sessionScope(session) {
+    var sessions = typeof ctx.get === "function" ? ctx.get("sessions") : ctx.sessions;
+    if (sessions && typeof sessions.binding === "function") {
+      try {
+        var binding = sessions.binding(session.id);
+        if (binding && binding.ctx && typeof binding.ctx.bail === "function") return binding.ctx;
+      } catch (error) {
+        /* 落到快照里的 ctx */
+      }
+    }
+    if (session.ctx && typeof session.ctx.bail === "function") return session.ctx;
+    return null;
+  }
+
+  /**
+   * 注册本插件自己的引用属主（inputTriggers source）。
+   * chip 只带 source 名字，提交时 inputTriggers 按名字找 codec 还原成模型可见文本；
+   * 没有属主就会被 `no serializer for reference source "quote-comment"` 挡住发送。
+   * 服务或名字不可用时返回 false → 调用方退回纯文本路径（不注册也能用）。
+   */
+  function ensureSource() {
+    if (sourceReady) return true;
+    if (sourceBroken) return false;
+    var triggers = typeof ctx.get === "function" ? ctx.get("inputTriggers") : ctx.inputTriggers;
+    if (!triggers || typeof triggers.registerSource !== "function") return false;
+    try {
+      var disposer = triggers.registerSource({
+        trigger: TRIGGER_CHAR,
+        name: SOURCE_NAME,
+        showGroupTitle: false,
+        candidates: function () {
+          return [];
+        },
+        codec: {
+          clipboardText: function (ref) {
+            return quoteOf(ref);
+          },
+          serialize: function (ref) {
+            return Promise.resolve(quoteOf(ref));
+          }
+        }
+      });
+      sourceDisposer = typeof disposer === "function" ? disposer : null;
+      sourceReady = true;
+      return true;
+    } catch (error) {
+      sourceBroken = true;
+      return false;
+    }
+  }
+
+  ctx.effect(function () {
+    ensureSource();
+    return function () {
+      if (sourceDisposer !== null) {
+        try {
+          sourceDisposer();
+        } catch (error) {
+          /* 忽略 */
+        }
+        sourceDisposer = null;
+      }
+      sourceReady = false;
+    };
+  }, "dsh-quote-comment: reference source");
+
+  /**
+   * 官方引用通道：把选中文本作为原子 chip 插进输入框。
+   * span 由 inputActions.captureInsertion() 给出，事件由 session scope 的 bail 派发；
+   * ui-conversation 的 `slash/input-insert-reference` 监听器返回 true 才算落笔成功。
+   */
+  function insertThroughReference(rawText) {
+    if (!ensureSource()) return false;
+    var session = currentSession();
+    if (session === null) return false;
+    var actx = sessionScope(session);
+    if (actx === null) return false;
+    var actions = resolveInputActions();
+    if (!actions || typeof actions.captureInsertion !== "function") return false;
+    try {
+      var span = actions.captureInsertion();
+      if (span === null || span === undefined) return false;
+      var reference = {
+        source: SOURCE_NAME,
+        ref: String(rawText),
+        label: excerptOf(rawText, LABEL_MAX),
+        appearance: CHIP_APPEARANCE,
+        clipboardText: quoteOf(rawText)
+      };
+      return actx.bail(actx, "slash/input-insert-reference", { reference: reference, span: span }) === true;
+    } catch (error) {
+      return false;
+    }
+  }
+
+  /** 官方路径：captureInsertion() 取 span，insertText(text, span) 落笔。 */
+  function insertThroughActions(text) {
+    var actions = resolveInputActions();
+    if (!actions || typeof actions.captureInsertion !== "function" || typeof actions.insertText !== "function") return false;
+    for (var attempt = 0; attempt < 2; attempt += 1) {
+      try {
+        var span = actions.captureInsertion();
+        if (actions.insertText(text, span) === true) return true;
+      } catch (error) {
+        return false;
+      }
+    }
+    return false;
+  }
+
+  /** 兜底路径：合成 paste 事件交给 Lexical 自己处理，之后读文本判定是否成功。 */
+  function insertThroughPaste(text) {
+    var host = composerHost();
+    if (host === null) return false;
+    var marker = firstLineOf(text);
+    try {
+      host.focus();
+      var data = new DataTransfer();
+      data.setData("text/plain", text);
+      host.dispatchEvent(new ClipboardEvent("paste", { clipboardData: data, bubbles: true, cancelable: true }));
+    } catch (error) {
+      return false;
+    }
+    return marker !== "" && composerText().indexOf(marker) !== -1;
+  }
+
+  function copyToClipboard(text) {
+    try {
+      if (navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
+        var pending = navigator.clipboard.writeText(text);
+        if (pending && typeof pending.catch === "function") pending.catch(function () {});
+        return true;
+      }
+    } catch (error) {
+      /* 忽略：走失败提示 */
+    }
+    return false;
+  }
+
+  /** 交付选中文本：引用 chip → 官方 action → 合成 paste → 剪贴板，返回结果状态。 */
+  function deliver(rawText) {
+    var text = quoteOf(rawText);
+    if (text.trim() === "") return "failed";
+    if (insertThroughReference(rawText)) return "inserted";
+    if (insertThroughActions(text)) return "inserted";
+    if (insertThroughPaste(text)) return "inserted";
+    if (copyToClipboard(text)) return "copied";
+    return "failed";
+  }
+
+  function Overlay() {
+    var activeState = React.useState(null);
+    var active = activeState[0];
+    var setActive = activeState[1];
+    var statusState = React.useState(null);
+    var status = statusState[0];
+    var setStatus = statusState[1];
+    var latest = React.useRef(null);
+    var hideTimer = React.useRef(null);
+
+    React.useEffect(function () {
+      var dragging = false;
+      var frame = 0;
+
+      function push(candidate, clearStatus) {
+        latest.current = candidate;
+        setActive(candidate);
+        if (clearStatus !== false) setStatus(null);
+      }
+
+      function schedule(clearStatus) {
+        if (frame !== 0) return;
+        frame = window.requestAnimationFrame(function () {
+          frame = 0;
+          push(readSelection(), clearStatus);
+        });
+      }
+
+      function onSelectionChange() {
+        if (dragging) return;
+        schedule(true);
+      }
+
+      function onMouseDown(event) {
+        if (ownUi(event.target)) return;
+        dragging = true;
+        push(null);
+      }
+
+      function onMouseUp(event) {
+        dragging = false;
+        if (ownUi(event.target)) return;
+        schedule(true);
+      }
+
+      function onScroll() {
+        if (latest.current !== null) schedule(false);
+      }
+
+      function onResize() {
+        if (latest.current !== null) schedule(false);
+      }
+
+      function onKeyDown(event) {
+        if (event.key === "Escape") push(null);
+      }
+
+      document.addEventListener("selectionchange", onSelectionChange);
+      document.addEventListener("mousedown", onMouseDown, true);
+      document.addEventListener("mouseup", onMouseUp, true);
+      document.addEventListener("keydown", onKeyDown, true);
+      window.addEventListener("scroll", onScroll, true);
+      window.addEventListener("resize", onResize);
+
+      return function () {
+        document.removeEventListener("selectionchange", onSelectionChange);
+        document.removeEventListener("mousedown", onMouseDown, true);
+        document.removeEventListener("mouseup", onMouseUp, true);
+        document.removeEventListener("keydown", onKeyDown, true);
+        window.removeEventListener("scroll", onScroll, true);
+        window.removeEventListener("resize", onResize);
+        if (frame !== 0) window.cancelAnimationFrame(frame);
+        if (hideTimer.current !== null) {
+          window.clearTimeout(hideTimer.current);
+          hideTimer.current = null;
+        }
+      };
+    }, []);
+
+    function onPick(event) {
+      if (event) {
+        event.preventDefault();
+        event.stopPropagation();
+      }
+      var candidate = latest.current;
+      if (candidate === null) return;
+      var outcome = deliver(candidate.text);
+      if (outcome === "inserted") {
+        latest.current = null;
+        setActive(null);
+        setStatus(null);
+        try {
+          var selection = window.getSelection();
+          if (selection && typeof selection.removeAllRanges === "function") selection.removeAllRanges();
+        } catch (error) {
+          /* 忽略 */
+        }
+        focusComposer();
+        return;
+      }
+      setStatus(outcome);
+      if (hideTimer.current !== null) window.clearTimeout(hideTimer.current);
+      hideTimer.current = window.setTimeout(function () {
+        hideTimer.current = null;
+        latest.current = null;
+        setActive(null);
+        setStatus(null);
+      }, 1800);
+    }
+
+    if (active === null) return null;
+
+    var label = status === "copied" ? "已复制，请粘贴" : status === "failed" ? "插入失败，请手动复制" : "添加评论";
+
+    return React.createElement(
+      "div",
+      {
+        className: "dqc-root",
+        "data-quote-comment-root": "true",
+        style: { top: active.y + "px", left: active.x + "px" }
+      },
+      React.createElement(
+        "button",
+        {
+          type: "button",
+          className: "dqc-btn",
+          "data-status": status === null ? undefined : status,
+          title: previewOf(active.text),
+          onMouseDown: function (event) {
+            event.preventDefault();
+          },
+          onClick: onPick
+        },
+        iconNode(),
+        React.createElement("span", null, label)
+      )
+    );
+  }
+
+  ctx.slots.inject("shell.overlay", function () {
+    return ctx.slots.register({ name: "shell.overlay", id: "quote-comment", order: 100 }, Overlay);
+  });
+}
+
+exports.inject = ["slots"];
+exports.apply = apply;
+
+return module.exports;
+}});

package/lib/index.js

@@ -0,0 +1,18 @@
+/**
+ * 宿主侧（Node）半身。
+ *
+ * 本插件的全部行为都在浏览器里：`lib/client.js` 通过 `dsh.client` 声明被
+ * client-modules 组进 `window.__DSH_BOOT__` 图并单独服务。宿主半身存在只是
+ * 为了让 profile 的层叠栈里有一条可加载的 Loader 条目——client-modules 只服务
+ * “有活跃 Loader 条目”的包的客户端 bundle。
+ */
+
+export const name = 'dsh-quote-comment';
+
+/**
+ * 装载宿主半身：不做任何事，只在日志里留一行便于确认条目已挂载。
+ * @param ctx - 宿主 Cordis 上下文。
+ */
+export function apply(ctx) {
+  ctx.logger?.info?.('[dsh-quote-comment] host half loaded (client UI only)');
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "dsh-quote-comment",
+  "version": "0.1.0",
+  "description": "选中会话内容即浮出「添加评论」按钮，点击把选中文本作为引用插入聊天输入框。",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "README.md",
+    "dsh.bundle.patch.yml"
+  ],
+  "keywords": [
+    "deepseek",
+    "harness",
+    "dsh",
+    "dsh-plugin",
+    "quote",
+    "comment",
+    "selection"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./dsh.bundle.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true
+    }
+  }
+}