@twinsearth/w2m-dsh-plugin 1.9.17 → 1.9.20

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "The w2m fleet plugins: one account, many machines, any of Windows, macOS or Linux.",
-    "version": "1.9.17"
+    "version": "1.9.20"
   },
   "plugins": [
     {
       "name": "w2m-fleet",
       "source": "./",
       "description": "Read fleet state and dispatch commands across the machines registered to one account. Read-only MCP surface: the five exposed tools cannot change anything.",
-      "version": "1.9.17",
+      "version": "1.9.20",
       "author": {
         "name": "TwinsEarth"
       },
@@ -26,5 +26,5 @@
       ]
     }
   ],
-  "version": "1.9.17"
+  "version": "1.9.20"
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "w2m-fleet",
   "description": "Drive the same project on online Windows, macOS and Linux machines from one account: read fleet state, dispatch commands and read results. The MCP surface is deliberately read-only.",
-  "version": "1.9.17",
+  "version": "1.9.20",
   "author": {
     "name": "TwinsEarth"
   },

package/CHANGELOG.md

@@ -7,6 +7,19 @@
 
 All notable changes to this project are documented here.
 
+## [1.9.20] - 2026-10-28
+
+- 新增浮动滚动浮标（固定在主工作区右上角，不依赖 slot 布局）：
+  · 「⇧3」：单击向上滚动约 3 轮对话；长按 3 秒直接回到第一轮；
+  · 「⤒」：一键到顶。
+- 浮标挂载在插件生命周期内（ctx.effect 卸载时移除），失败只记录、不影响页面启动。
+
+## [1.9.19] - 2026-10-28
+
+- 对话右上角新增「⇧3」按钮：单击向上滚动约 3 轮对话，长按 3 秒直接回到第一轮。
+- 全文搜索高亮修复：改为直接插入本地 mark 元素（黄色背景 rgba(255,235,59,.85) + 绿色文字 rgba(11,122,51,1)），并递归遍历 shadow DOM；不再依赖 CSS Custom Highlight API，命中项一定可见。
+- 同版带上 v1.9.18 的聊天收紧：relay 只接收文字与 /微笑 /火箭 /烟花 指令（图片字段、data:image、Markdown 图片、base64 图片魔数一律 400 拒绝；加密消息按设计豁免）；表情按钮改为指令按钮；长提示词镜像按 3500 B 截断，避免被 4096 B 上限静默丢弃。
+
 ## [1.9.17] - 2026-10-28
 
 - 修复左侧栏 GPW 入口只剩小图标：恢复 🌐 GPW 文字（侧栏 label 仍为空，不会重复）。

package/README.md

@@ -14,7 +14,7 @@ English | [中文](#中文说明)
 
 ## Install
 
-Five routes in. They all end with **16 tools registered** in your agent. Pick one.
+Five routes in. They all end with **18 tools registered** in your agent. Pick one.
 
 ### 1. DSH plugin (recommended — zero configuration)
 
@@ -136,7 +136,7 @@ hand-maintained host list.
 ### Tools
 
 `w2m_status` · `w2m_devices` · `w2m_run` · `w2m_wait` · `w2m_history` · `w2m_stats` · `w2m_report` ·
-`w2m_memory` · `w2m_approvals` · `w2m_cancel` · `w2m_council` · `w2m_chat` · `w2m_update` `w2m_tasks` · `w2m_reduce`
+`w2m_memory` · `w2m_approvals` · `w2m_cancel` · `w2m_council` · `w2m_chat` · `w2m_update` `w2m_tasks` · `w2m_reduce` · `w2m_joint_plan` · `w2m_joint_status`
 - `w2m_intent` — map a structured intent (run-tests, node-version, git-status, git-head, fleet-facts, shard-probe) onto an allow-listed command; unknown intents are refused by name, never guessed.
 
 ### Environment a dispatched command receives (1.1.15+)
@@ -261,7 +261,7 @@ MIT.
 
 ### 安装
 
-五种方式，最终都会在你的 agent 里注册 **16 tools registered**。任选其一。
+五种方式，最终都会在你的 agent 里注册 **18 tools registered**。任选其一。
 
 #### 1. DSH 插件（推荐，零配置）
 

package/bin/w2m-joint.mjs

@@ -163,7 +163,7 @@ if (command === 'dispatch') {
     // decision 2: one approval authorises exactly one dispatch.
     const consumed = consumeApproval({ stateDir, planSha: args.plan, approvalSha: gate.approval.approval.approval_sha256 });
     if (consumed.ok !== true) fail(consumed.code ?? 'APPROVAL_CONSUME_FAILED', consumed.detail ?? null);
-    const sent = await dispatchPlanToRelay({ rabbitUrl: relayUrl, token, plan: gate.plan, approval: gate.approval.approval });
+    const sent = await dispatchPlanToRelay({ rabbitUrl: relayUrl, token, plan: gate.plan, approval: gate.approval.approval, auditFile: stateDir + '/joint-dev/audit.jsonl' });
     print({ ...sent, plan_sha256: gate.plan.plan_sha256, relay: relayUrl });
     process.exit(sent.ok === true ? 0 : 1);
   }

package/codex/mcp-servers.toml

@@ -12,6 +12,6 @@
 
 [mcp_servers.w2m-fleet]
 command = "npx"
-args = ["-y", "-p", "@twinsearth/w2m-dsh-plugin@1.9.17", "w2m-mcp"]
+args = ["-y", "-p", "@twinsearth/w2m-dsh-plugin@1.9.20", "w2m-mcp"]
 startup_timeout_sec = 20
 tool_timeout_sec = 60

package/docs/acceptance/1.9.19/RELEASE-1919.json

@@ -0,0 +1,21 @@
+{
+  "version": "1.9.19",
+  "case": "RELEASE-1919",
+  "kind": "positive",
+  "machines": [
+    "b53a37f4-1464-4512-9259-33a7df091e3e"
+  ],
+  "executed_at": "2026-10-28T05:08:27.700Z",
+  "executor": "lead",
+  "task_id": "pre-release-1919-1793164107702",
+  "requirement": "V1.9.19：对话向上滚动按钮（点击 3 轮/长按 3 秒到首轮）+ 搜索命中绿字黄底（DOM mark，含 shadow DOM）",
+  "result": {
+    "outcome": "ok",
+    "assertions": {
+      "scroll": "header ⇧3: click scrollBy 3 turns, hold 3s scrollTo top",
+      "search": "mark.w2mSearchMark with rgba yellow background + rgba green text, shadow-root aware",
+      "chat": "text-only guard retained from v1.9.18 work",
+      "tests": "client-bundle 26/26"
+    }
+  }
+}

package/docs/acceptance/1.9.20/RELEASE-1920.json

@@ -0,0 +1,22 @@
+{
+  "version": "1.9.20",
+  "case": "RELEASE-1920",
+  "kind": "positive",
+  "machines": [
+    "b53a37f4-1464-4512-9259-33a7df091e3e"
+  ],
+  "executed_at": "2026-10-28T07:38:58.684Z",
+  "executor": "lead",
+  "task_id": "pre-release-1920-1793173138685",
+  "requirement": "V1.9.20：主工作区右上角浮动滚动浮标（⇧3 单击 3 轮/长按 3 秒到顶 + ⤒ 一键到顶）",
+  "result": {
+    "outcome": "ok",
+    "assertions": {
+      "float": "fixed top-right DOM controls installed from mount(), removed by ctx.effect",
+      "click": "scrollBy ~3 turns on the largest scrollable conversation surface",
+      "longpress": "pointerdown 3s -> scrollTo top",
+      "oneclick": "top button scrolls to first turn",
+      "tests": "client-bundle 26/26"
+    }
+  }
+}

package/docs/acceptance-ops/2026-10-28/AG-SMOKE.json

@@ -0,0 +1,24 @@
+{
+  "kind": "ops-smoke",
+  "case": "AG-SMOKE",
+  "executed_at": "2026-10-28T05:02:36.913Z",
+  "executor": "lead",
+  "task_id": "01M60E2W38FFKXKRZS95JSVWFM",
+  "setup": "relay 43.142.74.71:8787 upgraded to 1.9.16; operator token used from ~/.w2m/operator-token; read via local device token",
+  "attempt": "broadcast executor_machine_id=ToFuture command_argv=[\"node\",\"-v\"] at 2.0.0-tree relay",
+  "observed": {
+    "dispatch": "POST /v1/task 200; executor lease on ToFuture=offered; DSH/macmini and 15 other devices=observing",
+    "final": "aggregate=refused; ToFuture lease=refused (agent allow-list), outcome=refused; observers did not execute"
+  },
+  "conclusions": {
+    "selection_routing": "PASS at relay level: only the named executor gets an executing lease; every other device is observing",
+    "execution": "NOT PROVEN: the target agent refused the command (allow-list)",
+    "ag_matrix": "PARTIAL: A/B/C/D routing smoke only; E/F/G and real execution blocked"
+  },
+  "blockers": [
+    "agent allow-list does not include node -v on ToFuture",
+    "running DSH process still predates the operator-token change (restart required)",
+    "macmini/DSH plugin versions unknown/unverified; same-version requirement not yet met",
+    "S4 data plane (agent putBlobBytes reroute + no-sink degradation) not implemented"
+  ]
+}

package/lib/client.js

@@ -495,6 +495,8 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
         // v1.6.10: the transcript is selectable text; screenshots get a preview and a copy affordance.
         '.w2mChatTab{padding:4px 10px;border-radius:6px;border:1px solid rgba(127,127,127,.35);background:transparent;color:inherit;font:inherit;cursor:pointer}',
   '.w2mChat_panelFull{position:fixed;inset:5vh 8vw;width:auto;max-height:90vh;z-index:70}',
+  '.w2mChat_sticker{font-size:16px;line-height:1}',
+  '.w2mChat_stickerBig{font-size:28px;line-height:1.1}',
   '.w2mChat_emojiRow{display:flex;gap:4px;padding:4px 8px;flex-wrap:wrap}',
   '.w2mChat_emoji{padding:2px 4px;border:0;background:transparent;font-size:16px;line-height:1;cursor:pointer}',
   '.w2mFleetStatus{display:flex;gap:16px;align-items:center;padding:2px 12px;font-size:11px;opacity:.8;white-space:nowrap}',
@@ -504,6 +506,11 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
   '.w2mSearchBox{display:flex;align-items:center;gap:4px;padding:2px 4px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-background-secondary)}',
   '.w2mSearchInput{height:24px;min-width:220px;border:0;background:transparent;color:inherit;font:inherit;outline:none}',
   '.w2mSearchCount{font-size:11px;opacity:.75;min-width:34px;text-align:center}',
+  '.w2mSearchControls{display:inline-flex;align-items:center;gap:4px}',
+  '.w2mScrollFloatWrap{position:fixed;right:18px;top:72px;z-index:2147483000;display:flex;flex-direction:column;gap:6px}',
+  '.w2mScrollFloatBtn{width:34px;height:34px;border-radius:50%;border:1px solid currentColor;background:transparent;color:inherit;opacity:.72;font-size:13px;line-height:1;cursor:pointer}',
+  '.w2mScrollFloatBtn:hover{opacity:1}',
+  '.w2mScrollUp{font-size:12px;padding:2px 6px;border:1px solid rgba(128,128,128,.4);border-radius:4px;background:transparent;color:inherit;cursor:pointer}',
   '::highlight(w2m-conversation-search){background-color:rgba(255,235,59,.85);color:rgba(11,122,51,1)}',
   '.w2mSearchMark{background-color:rgba(255,235,59,.85);color:rgba(11,122,51,1);border-radius:2px}',
   '.w2mSearchBtn{height:24px;min-width:24px;border:0;border-radius:4px;background:transparent;color:inherit;cursor:pointer}',
@@ -964,112 +971,216 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
      * Custom Highlight API (no DOM mutation, so React's tree stays intact), then scrolls to the
      * focused match. Matches stay yellow until the query changes or the box closes.
      */
-    const SEARCH_HIGHLIGHT = 'w2m-conversation-search';
-    function clearSearchHighlight() {
-      try { if (typeof CSS !== 'undefined' && CSS.highlights) CSS.highlights.delete(SEARCH_HIGHLIGHT); } catch { /* unsupported */ }
+function searchRoots() {
+  const roots = [];
+  const seen = new Set();
+  const visit = (node) => {
+    if (!node || seen.has(node)) return;
+    seen.add(node);
+    if (node.nodeType === 1 || node.nodeType === 11) {
+      if (node.shadowRoot) { roots.push(node.shadowRoot); visit(node.shadowRoot); }
+      const kids = node.children ?? [];
+      for (let i = 0; i < kids.length; i += 1) visit(kids[i]);
     }
-    function ConversationSearch() {
-      const [open, setOpen] = React.useState(false);
-      const [query, setQuery] = React.useState('');
-      const [count, setCount] = React.useState(0);
-      const [cursor, setCursor] = React.useState(-1);
-      const rangesRef = React.useRef([]);
-      const inputRef = React.useRef(null);
-      React.useEffect(() => { if (open && inputRef.current && inputRef.current.focus) inputRef.current.focus(); }, [open]);
-      const collect = React.useCallback(() => {
-        if (query === '' || typeof document === 'undefined') return [];
-        const needle = query.toLowerCase();
-        const ranges = [];
-        try {
-          const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, {
-            acceptNode(node) {
-              const parent = node.parentElement;
-              if (parent === null) return NodeFilter.FILTER_REJECT;
-              const tag = parent.tagName;
-              if (tag === 'SCRIPT' || tag === 'STYLE' || tag === 'TEXTAREA' || tag === 'INPUT') return NodeFilter.FILTER_REJECT;
-              if (parent.closest && parent.closest('[data-w2m-search]') !== null) return NodeFilter.FILTER_REJECT;
-              return node.nodeValue && node.nodeValue.trim() !== '' ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_REJECT;
-            },
-          });
-          let node = walker.nextNode();
-          while (node !== null && ranges.length < 500) {
-            const text = node.nodeValue.toLowerCase();
-            let index = text.indexOf(needle);
-            while (index >= 0) {
-              const range = document.createRange();
-              range.setStart(node, index);
-              range.setEnd(node, index + query.length);
-              ranges.push(range);
-              index = text.indexOf(needle, index + query.length);
-              if (ranges.length >= 500) break;
-            }
-            node = walker.nextNode();
-          }
-        } catch { /* finding is best effort */ }
-        return ranges;
-      }, [query]);
-      const paint = React.useCallback(() => {
-        const ranges = collect();
-        rangesRef.current = ranges;
-        setCount(ranges.length);
-        try {
-          if (typeof CSS !== 'undefined' && CSS.highlights && typeof Highlight === 'function') {
-            CSS.highlights.set(SEARCH_HIGHLIGHT, new Highlight(...ranges));
-          }
-        } catch { /* older engine: the count still helps */ }
-        if (ranges.length > 0) {
-          setCursor(0);
-          try {
-            const parent = ranges[0].startContainer.parentElement;
-            if (parent && parent.scrollIntoView) parent.scrollIntoView({ block: 'center', behavior: 'smooth' });
-          } catch { /* scroll is best effort */ }
-        } else setCursor(-1);
-        return ranges.length;
-      }, [collect]);
-      React.useEffect(() => {
-        if (!open) { clearSearchHighlight(); setCount(0); setCursor(-1); return undefined; }
-        paint();
-        return () => clearSearchHighlight();
-      }, [open, query, paint]);
-      const step = (backwards) => {
-        const ranges = rangesRef.current;
-        if (ranges.length === 0) { paint(); return; }
-        const next = (cursor + (backwards ? -1 : 1) + ranges.length) % ranges.length;
-        setCursor(next);
+  };
+  if (typeof document !== 'undefined' && document.body) { roots.push(document.body); visit(document.body); }
+  return roots;
+}
+function clearSearchMarks() {
+  if (typeof document === 'undefined') return;
+  const marks = document.querySelectorAll('mark.w2mSearchMark');
+  for (const mark of marks) {
+    const parent = mark.parentNode;
+    if (parent === null) continue;
+    parent.replaceChild(document.createTextNode(mark.textContent ?? ''), mark);
+    if (parent.normalize) parent.normalize();
+  }
+}
+function paintSearchMarks(query) {
+  clearSearchMarks();
+  if (typeof document === 'undefined' || query === '') return 0;
+  const needle = query.toLowerCase();
+  let total = 0;
+  for (const root of searchRoots()) {
+    let walker;
+    try {
+      walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
+        acceptNode(node) {
+          const parent = node.parentElement;
+          if (parent === null) return NodeFilter.FILTER_REJECT;
+          const tag = parent.tagName;
+          if (tag === 'SCRIPT' || tag === 'STYLE' || tag === 'TEXTAREA' || tag === 'INPUT') return NodeFilter.FILTER_REJECT;
+          if (parent.closest && parent.closest('[data-w2m-search]') !== null) return NodeFilter.FILTER_REJECT;
+          if (parent.closest && parent.closest('mark.w2mSearchMark') !== null) return NodeFilter.FILTER_REJECT;
+          return node.nodeValue && node.nodeValue.trim() !== '' ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_REJECT;
+        },
+      });
+    } catch { continue; }
+    const nodes = [];
+    let node = walker.nextNode();
+    while (node !== null) { nodes.push(node); node = walker.nextNode(); }
+    for (const textNode of nodes) {
+      const text = textNode.nodeValue ?? '';
+      const lower = text.toLowerCase();
+      const hits = [];
+      let index = lower.indexOf(needle);
+      while (index >= 0) { hits.push(index); index = lower.indexOf(needle, index + query.length); }
+      for (let k = hits.length - 1; k >= 0; k -= 1) {
         try {
-          const parent = ranges[next].startContainer.parentElement;
-          if (parent && parent.scrollIntoView) parent.scrollIntoView({ block: 'center', behavior: 'smooth' });
-        } catch { /* scroll is best effort */ }
-      };
-      if (!open) {
-        return h('button', {
-          type: 'button',
-          className: 'w2mSearchToggle',
-          title: '搜索本对话',
-          'aria-label': '搜索本对话',
-          onClick: () => setOpen(true),
-        }, '🔍');
+          const range = document.createRange();
+          range.setStart(textNode, hits[k]);
+          range.setEnd(textNode, hits[k] + query.length);
+          const mark = document.createElement('mark');
+          mark.className = 'w2mSearchMark';
+          mark.setAttribute('style', 'background-color:rgba(255,235,59,.85);color:rgba(11,122,51,1)');
+          range.surroundContents(mark);
+          total += 1;
+        } catch { /* a range that crosses elements cannot be wrapped; skip it */ }
       }
-      return h('div', { className: 'w2mSearchBox', 'data-w2m-search': 'box' }, [
-        h('input', {
-          key: 'q',
-          ref: inputRef,
-          className: 'w2mSearchInput',
-          value: query,
-          placeholder: '搜索本对话全部内容',
-          onChange: (event) => setQuery(event.target.value),
-          onKeyDown: (event) => {
-            if (event.key === 'Enter') { event.preventDefault(); step(event.shiftKey); }
-            if (event.key === 'Escape') { setOpen(false); setQuery(''); }
-          },
-        }),
-        h('span', { key: 'count', className: 'w2mSearchCount' }, count === 0 ? (query === '' ? '' : '0') : whenCount(count, cursor)),
-        h('button', { key: 'prev', type: 'button', className: 'w2mSearchBtn', title: '上一个', onClick: () => step(true) }, '↑'),
-        h('button', { key: 'next', type: 'button', className: 'w2mSearchBtn', title: '下一个', onClick: () => step(false) }, '↓'),
-        h('button', { key: 'close', type: 'button', className: 'w2mSearchBtn', title: '关闭搜索', onClick: () => { setOpen(false); setQuery(''); clearSearchHighlight(); } }, '×'),
-      ]);
     }
-    function whenCount(total, at) {
+  }
+  return total;
+}
+function findScrollSurface() {
+  if (typeof document === 'undefined') return null;
+  let best = null;
+  for (const root of searchRoots()) {
+    let all = [];
+    try { all = root.querySelectorAll ? [...root.querySelectorAll('*')] : []; } catch { continue; }
+    for (const el of all) {
+      if (el.scrollHeight <= el.clientHeight + 40) continue;
+      const style = typeof getComputedStyle === 'function' ? getComputedStyle(el) : null;
+      const overflow = style === null ? '' : style.overflowY;
+      if (overflow !== 'auto' && overflow !== 'scroll') continue;
+      if (best === null || el.scrollHeight > best.scrollHeight) best = el;
+    }
+  }
+  return best;
+}
+function scrollChatTurns() {
+  const surface = findScrollSurface();
+  if (surface !== null) surface.scrollBy({ top: -Math.round(Math.max(240, surface.clientHeight * 1.8)), behavior: 'smooth' });
+  else if (typeof window !== 'undefined') window.scrollBy({ top: -Math.round(window.innerHeight * 1.8), behavior: 'smooth' });
+}
+function scrollChatTop() {
+  const surface = findScrollSurface();
+  if (surface !== null) surface.scrollTo({ top: 0, behavior: 'smooth' });
+  else if (typeof window !== 'undefined') window.scrollTo({ top: 0, behavior: 'smooth' });
+}
+/** Floating scroll controls: fixed top-right of the workspace, independent of any slot layout. */
+function installFloatingScrollButtons() {
+  if (typeof document === 'undefined' || document.body === null) return null;
+  const wrap = document.createElement('div');
+  wrap.className = 'w2mScrollFloatWrap';
+  wrap.setAttribute('data-w2m-scroll-float', 'true');
+  const makeButton = (label, title) => {
+    const button = document.createElement('button');
+    button.type = 'button';
+    button.className = 'w2mScrollFloatBtn';
+    button.textContent = label;
+    button.title = title;
+    button.setAttribute('aria-label', title);
+    wrap.appendChild(button);
+    return button;
+  };
+  const up = makeButton('\u21E73', '向上滚动 3 轮（长按 3 秒到第一轮）');
+  const top = makeButton('\u2912', '一键到顶');
+  let holdTimer = null;
+  let longFired = false;
+  const clearHold = () => { if (holdTimer !== null) { clearTimeout(holdTimer); holdTimer = null; } };
+  up.addEventListener('pointerdown', (event) => {
+    if (event && typeof event.preventDefault === 'function') event.preventDefault();
+    longFired = false;
+    clearHold();
+    holdTimer = setTimeout(() => { longFired = true; scrollChatTop(); }, 3000);
+  });
+  for (const type of ['pointerup', 'pointerleave', 'pointercancel']) up.addEventListener(type, clearHold);
+  up.addEventListener('click', () => { if (longFired) { longFired = false; return; } scrollChatTurns(); });
+  top.addEventListener('click', () => scrollChatTop());
+  document.body.appendChild(wrap);
+  return () => { clearHold(); wrap.remove(); };
+}
+function ConversationSearch() {
+  const [open, setOpen] = React.useState(false);
+  const [query, setQuery] = React.useState('');
+  const [count, setCount] = React.useState(0);
+  const [cursor, setCursor] = React.useState(-1);
+  const inputRef = React.useRef(null);
+  const holdRef = React.useRef(null);
+  const longFiredRef = React.useRef(false);
+  React.useEffect(() => { if (open && inputRef.current && inputRef.current.focus) inputRef.current.focus(); }, [open]);
+  React.useEffect(() => {
+    if (!open) { clearSearchMarks(); setCount(0); setCursor(-1); return undefined; }
+    const total = paintSearchMarks(query);
+    setCount(total);
+    setCursor(total > 0 ? 0 : -1);
+    const first = document.querySelector('mark.w2mSearchMark');
+    if (first && first.scrollIntoView) first.scrollIntoView({ block: 'center', behavior: 'smooth' });
+    return () => clearSearchMarks();
+  }, [open, query]);
+  const step = (backwards) => {
+    const marks = [...document.querySelectorAll('mark.w2mSearchMark')];
+    if (marks.length === 0) { paintSearchMarks(query); return; }
+    const next = (cursor + (backwards ? -1 : 1) + marks.length) % marks.length;
+    setCursor(next);
+    if (marks[next] && marks[next].scrollIntoView) marks[next].scrollIntoView({ block: 'center', behavior: 'smooth' });
+  };
+  const scrollTurns = () => {
+    const surface = findScrollSurface();
+    if (surface !== null) surface.scrollBy({ top: -Math.round(Math.max(240, surface.clientHeight * 1.8)), behavior: 'smooth' });
+    else if (typeof window !== 'undefined') window.scrollBy({ top: -Math.round(window.innerHeight * 1.8), behavior: 'smooth' });
+  };
+  const scrollFirstTurn = () => {
+    const surface = findScrollSurface();
+    if (surface !== null) surface.scrollTo({ top: 0, behavior: 'smooth' });
+    else if (typeof window !== 'undefined') window.scrollTo({ top: 0, behavior: 'smooth' });
+  };
+  if (!open) {
+    return h('span', { className: 'w2mSearchControls' }, [
+      h('button', {
+        key: 'up',
+        type: 'button',
+        className: 'w2mScrollUp',
+        title: '向上滚动 3 轮（长按 3 秒到第一轮）',
+        'aria-label': '向上滚动 3 轮，长按 3 秒到第一轮',
+        onMouseDown: () => {
+          longFiredRef.current = false;
+          holdRef.current = setTimeout(() => { longFiredRef.current = true; scrollFirstTurn(); }, 3000);
+        },
+        onMouseUp: () => { if (holdRef.current) { clearTimeout(holdRef.current); holdRef.current = null; } },
+        onMouseLeave: () => { if (holdRef.current) { clearTimeout(holdRef.current); holdRef.current = null; } },
+        onClick: () => { if (longFiredRef.current) { longFiredRef.current = false; return; } scrollTurns(); },
+      }, '⇧3'),
+      h('button', {
+        key: 'find',
+        type: 'button',
+        className: 'w2mSearchToggle',
+        title: '搜索本对话',
+        'aria-label': '搜索本对话',
+        onClick: () => setOpen(true),
+      }, '🔍'),
+    ]);
+  }
+  return h('div', { className: 'w2mSearchBox', 'data-w2m-search': 'box' }, [
+    h('input', {
+      key: 'q',
+      ref: inputRef,
+      className: 'w2mSearchInput',
+      value: query,
+      placeholder: '搜索本对话全部内容',
+      onChange: (event) => setQuery(event.target.value),
+      onKeyDown: (event) => {
+        if (event.key === 'Enter') { event.preventDefault(); step(event.shiftKey); }
+        if (event.key === 'Escape') { setOpen(false); setQuery(''); }
+      },
+    }),
+    h('span', { key: 'count', className: 'w2mSearchCount' }, count === 0 ? (query === '' ? '' : '0') : whenCount(count, cursor)),
+    h('button', { key: 'prev', type: 'button', className: 'w2mSearchBtn', title: '上一个', onClick: () => step(true) }, '↑'),
+    h('button', { key: 'next', type: 'button', className: 'w2mSearchBtn', title: '下一个', onClick: () => step(false) }, '↓'),
+    h('button', { key: 'close', type: 'button', className: 'w2mSearchBtn', title: '关闭搜索', onClick: () => { setOpen(false); setQuery(''); clearSearchMarks(); } }, '×'),
+  ]);
+}
+function whenCount(total, at) {
       return (at >= 0 ? at + 1 : 0) + '/' + total;
     }
 
@@ -1667,7 +1778,22 @@ function TargetSelect({ sessionId, locked: _locked, t }) {
     }
 
     function FleetChat({ sessionId, viewMode }) {
-      const CHAT_EMOJIS = ['👍', '✅', '🚀', '😄', '❤️', '🎉', '🔧', '📌'];
+      // v1.9.18: chat emotes are local slash commands, never image bytes. The relay only sees text.
+const CHAT_COMMANDS = ['/微笑', '/火箭', '/烟花'];
+// v1.9.18: the sticker pack is local to the plugin. Commands travel as text; rendering never requests bytes.
+const CHAT_STICKER_GLYPHS = { '/微笑': '\u{1F60A}', '/火箭': '\u{1F680}', '/烟花': '\u{1F386}' };
+const CHAT_STICKER_RE = /(\/微笑|\/火箭|\/烟花)/g;
+function renderChatText(text) {
+  const raw = String(text ?? '');
+  const whole = CHAT_STICKER_GLYPHS[raw.trim()];
+  if (whole !== undefined) return h('span', { className: 'w2mChat_stickerBig', 'data-sticker': raw.trim(), title: raw.trim() }, whole);
+  const parts = raw.split(CHAT_STICKER_RE);
+  if (parts.length === 1) return raw;
+  return parts.map((part, index) => (CHAT_STICKER_GLYPHS[part] !== undefined
+    ? h('span', { key: 'st' + index, className: 'w2mChat_sticker', 'data-sticker': part, title: part }, CHAT_STICKER_GLYPHS[part])
+    : part));
+}
+const CHAT_EMOJIS = CHAT_COMMANDS;
       const [open, setOpen] = React.useState(false);
       const [messages, setMessages] = React.useState([]);
       const [usage, setUsage] = React.useState(null);
@@ -1973,7 +2099,7 @@ function TargetSelect({ sessionId, locked: _locked, t }) {
                       var kind = messageKind(message, localMachineId);
                       return h('div', { key: message?.message_id ?? `${message?.machine_id}:${message?.at_ms}`, className: 'w2mChat_msg is-' + kind, onClick: () => { const selection = typeof window.getSelection === 'function' ? String(window.getSelection() ?? '') : ''; if (selection !== '') return; setReplyTo({ id: message?.message_id ?? null, threadId: message?.thread_id ?? null, text: typeof message?.text === 'string' ? message.text : '' }); } },
                         h('div', { className: 'w2mChat_meta' }, h(WhaleAvatar, { machineId: message?.machine_id }), `${machineLabel(message)} · ${timeLabel(message)}`, kind === 'session' ? ' · 来自会话' : '', h('button', { key: 'copy', type: 'button', className: 'w2mChat_copy', title: '复制这条消息', onClick: (event) => { event.stopPropagation(); copyText(String(message?.text ?? '')); } }, '⧉'), message?.thread_id ? h('span', { className: 'w2mChat_thread' }, '#' + message.thread_id) : null),
-                        h('div', { className: 'w2mChat_text' }, message?.text ?? ''));
+                        h('div', { className: 'w2mChat_text' }, renderChatText(message?.text ?? '')));
                       }),
                     ].filter((node) => node !== null))),
 
@@ -2288,6 +2414,16 @@ function TargetSelect({ sessionId, locked: _locked, t }) {
       } catch (error) {
         console.error('@twinsearth/w2m-dsh-plugin: the conversation search control was not mounted', error);
       }
+      // v1.9.20: floating scroll controls, fixed top-right of the workspace. DOM nodes, not slot
+      // entries, so they appear whichever conversation view is active; ctx.effect disposes them.
+      try {
+        const disposeFloat = installFloatingScrollButtons();
+        if (typeof disposeFloat === 'function' && typeof ctx.effect === 'function') {
+          ctx.effect(() => disposeFloat, 'w2m: floating scroll buttons');
+        }
+      } catch (error) {
+        console.error('@twinsearth/w2m-dsh-plugin: the floating scroll controls were not mounted', error);
+      }
       // v1.9.6: fleet chat as a real conversation View tab (after Chat and Rules), rendering the
       // full chat page in the main workspace.
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/w2m-dsh-plugin",
-  "version": "1.9.17",
+  "version": "1.9.20",
   "description": "Run one project across your own Windows and macOS machines from a single DeepSeek account, through 11 w2m_* tools. Four coordination modes (replicate, split, broadcast, pipeline) and six aggregate verdicts (consistent, divergent, divergent-platform, failed, partial, unverifiable). P2P hole punching by default, with a bundled relay, STUN responder and ledger fallback, so the fleet needs no third-party service. Joining needs a pairing code plus autoStartAgent: true; installing alone does not join.",
   "type": "module",
   "exports": {
@@ -64,7 +64,7 @@
     "pack": "node scripts/pack.mjs",
     "reachability": "node scripts/reachability-check.mjs",
     "reachability:classify": "node scripts/reachability-classify.mjs",
-    "test": "node --test --test-force-exit test/relay.test.mjs test/broadcast.test.mjs test/blake2s.test.mjs test/agent.test.mjs test/plan-sec-cmd.test.mjs test/authority.test.mjs test/blocks.test.mjs test/approval-index.test.mjs test/fleet-sync.test.mjs test/fleet-merge.test.mjs test/fleet-memory-e2e.test.mjs test/fleet-concurrency.test.mjs test/fleet-merge-race.test.mjs test/health.test.mjs test/storage.test.mjs test/exit-channel.test.mjs test/council.test.mjs test/council-session.test.mjs test/log-bounds.test.mjs test/test-report.test.mjs test/fleet-scale.test.mjs test/fleet-state.test.mjs test/crypto-blake2s.test.mjs test/installed-version.test.mjs test/permission.test.mjs test/machine-test-packet.test.mjs test/field-authority.test.mjs test/approval-gate.test.mjs test/authority-choice.test.mjs test/reachability-check.test.mjs test/reachability-classify.test.mjs test/accepted-orphans.test.mjs test/acceptance-doc.test.mjs test/layer-model.test.mjs test/cwd-containment.test.mjs test/cwd-outside-project.test.mjs test/memory.test.mjs test/tools.test.mjs test/claims.test.mjs test/fleet-target.test.mjs test/client-bundle.test.mjs test/schedule.test.mjs test/auto-update.test.mjs test/update-source.test.mjs test/update-install.test.mjs test/update-wiring.test.mjs test/signing.test.mjs test/stress.test.mjs test/shared-config.test.mjs test/metrics.test.mjs test/metrics-route.test.mjs test/tool-cards.test.mjs test/p2p-stun.test.mjs test/p2p-transport.test.mjs test/p2p-signaling.test.mjs test/p2p-node.test.mjs test/p2p-transport-fields.test.mjs test/p2p-plugin.test.mjs test/p2p-crypto.test.mjs test/stun-server.test.mjs test/loader-entry.test.mjs test/mdns-wire.test.mjs test/mdns-discover.test.mjs test/chatops-approval.test.mjs test/chatops-policy.test.mjs test/chatops-file-safety.test.mjs test/chatops-outbound-queue.test.mjs test/chatops-commands.test.mjs test/chatops-bridge.test.mjs test/chatops-config-route.test.mjs test/chatops-apply.test.mjs test/chatops-ilink-contract.test.mjs test/chatops-fleet.test.mjs test/chatops-account.test.mjs test/chatops-auth.test.mjs test/chatops-fleet-scope.test.mjs test/chatops-handoff.test.mjs test/chatops-fleet-wiring.test.mjs test/chatops-fleet-live.test.mjs test/chatops-takeover.test.mjs test/chatops-device-signing.test.mjs test/chatops-relay-verify.test.mjs test/chatops-durability.test.mjs test/chatops-run-command.test.mjs test/secrets-guard.test.mjs test/chatops-ilink-fleet-bridge.test.mjs test/agent-plugins.test.mjs test/memory-layer.test.mjs test/mcp-server.test.mjs test/portable-plugins.test.mjs test/mcp-http.test.mjs test/mcp-http-live.test.mjs test/vision.test.mjs test/ilink-shape.test.mjs test/chatops-fleet-join.test.mjs test/admission.test.mjs test/admission-routes.test.mjs test/join-degradation.test.mjs test/account-identity.test.mjs test/join-challenge.test.mjs test/exec-env-injection.test.mjs test/account-join.test.mjs test/fleet-messages.test.mjs test/message-shards.test.mjs test/fleet-messages-http.test.mjs test/message-notify.test.mjs test/update-channels.test.mjs test/update-prerelease.test.mjs test/session-watch.test.mjs test/session-readonly.test.mjs test/session-sync.test.mjs test/fleet-chat-identity.test.mjs test/identity-reader.test.mjs test/intents.test.mjs test/dataflow.test.mjs test/council-fleet.test.mjs test/fleet-memory.test.mjs test/memory-view.test.mjs test/schema-spec.test.mjs test/fleet-weight-parity.test.mjs test/task-deps.test.mjs test/dataflow-wiring.test.mjs test/task-graph.test.mjs test/ask-store.test.mjs test/turn.test.mjs test/fleet-members.test.mjs test/redact.test.mjs test/policy-matrix.test.mjs test/envelope-signature.test.mjs test/chat-crypto.test.mjs test/reduce-suggestion.test.mjs test/merge-hint.test.mjs test/fleet-chat-route.test.mjs test/maintenance.test.mjs test/maintenance-ferry.test.mjs test/grant.test.mjs test/grant-gate.test.mjs test/worktree.test.mjs test/patch-artifact.test.mjs test/merge-queue.test.mjs test/m3-workflow.test.mjs test/project-room.test.mjs test/project-attribution.test.mjs test/project-locks.test.mjs test/project-reviews.test.mjs test/project-notifications.test.mjs test/blob-sessions.test.mjs test/outbox.test.mjs test/reliability-metrics.test.mjs test/evidence.test.mjs test/grant-issue.test.mjs test/project-refs.test.mjs test/exec-capability.test.mjs test/secondary-link.test.mjs test/bootstrap-cli.test.mjs test/bootstrap.test.mjs test/windows-hidden-task.test.mjs test/relay-failover.test.mjs test/npm-update.test.mjs test/agent-start-nonblocking.test.mjs test/fleet-chat-capture.test.mjs test/capture-route.test.mjs test/update-resolver.test.mjs test/agent-identity-safe.test.mjs test/re-pair-stale-token.test.mjs test/gpw-folder-policy.test.mjs test/gpw-activation.test.mjs test/gpw-hardening.test.mjs test/gpw-tamper-gate.test.mjs test/gpw-persistence.test.mjs test/gpw-colors.test.mjs test/gpw-recent-fold.test.mjs test/gpw-auto-approve.test.mjs test/data-plane.test.mjs test/sealed-object.test.mjs test/joint-dev-dispatch.test.mjs test/joint-dev-loop.test.mjs test/joint-dev-audit.test.mjs test/joint-dev-redline.test.mjs test/relay-redline-guard.test.mjs test/relay-p0-projection.test.mjs test/guarded-dispatch.test.mjs test/p0-single-matcher.test.mjs test/path-policy.test.mjs test/path-policy-fs.test.mjs test/gpw-inheritance-table.test.mjs test/gpw-policy-adapter.test.mjs test/target-policy.test.mjs test/relay-redline-audit.test.mjs test/relay-repair-ledger.test.mjs test/relay-purge-blobs.test.mjs test/relay-scrub.test.mjs test/joint-dev-plan-store.test.mjs test/relay-basepath-blobs.test.mjs test/operator-token.test.mjs test/relay-health-capabilities.test.mjs test/joint-relay-dispatch.test.mjs test/operator-token-route.test.mjs test/relay-scrub-task-projection.test.mjs test/operator-key-approval.test.mjs test/relay-offer-journal.test.mjs",
+    "test": "node --test --test-force-exit test/relay.test.mjs test/broadcast.test.mjs test/blake2s.test.mjs test/agent.test.mjs test/plan-sec-cmd.test.mjs test/authority.test.mjs test/blocks.test.mjs test/approval-index.test.mjs test/fleet-sync.test.mjs test/fleet-merge.test.mjs test/fleet-memory-e2e.test.mjs test/fleet-concurrency.test.mjs test/fleet-merge-race.test.mjs test/health.test.mjs test/storage.test.mjs test/exit-channel.test.mjs test/council.test.mjs test/council-session.test.mjs test/log-bounds.test.mjs test/test-report.test.mjs test/fleet-scale.test.mjs test/fleet-state.test.mjs test/crypto-blake2s.test.mjs test/installed-version.test.mjs test/permission.test.mjs test/machine-test-packet.test.mjs test/field-authority.test.mjs test/approval-gate.test.mjs test/authority-choice.test.mjs test/reachability-check.test.mjs test/reachability-classify.test.mjs test/accepted-orphans.test.mjs test/acceptance-doc.test.mjs test/layer-model.test.mjs test/cwd-containment.test.mjs test/cwd-outside-project.test.mjs test/memory.test.mjs test/tools.test.mjs test/claims.test.mjs test/fleet-target.test.mjs test/client-bundle.test.mjs test/schedule.test.mjs test/auto-update.test.mjs test/update-source.test.mjs test/update-install.test.mjs test/update-wiring.test.mjs test/signing.test.mjs test/stress.test.mjs test/shared-config.test.mjs test/metrics.test.mjs test/metrics-route.test.mjs test/tool-cards.test.mjs test/p2p-stun.test.mjs test/p2p-transport.test.mjs test/p2p-signaling.test.mjs test/p2p-node.test.mjs test/p2p-transport-fields.test.mjs test/p2p-plugin.test.mjs test/p2p-crypto.test.mjs test/stun-server.test.mjs test/loader-entry.test.mjs test/mdns-wire.test.mjs test/mdns-discover.test.mjs test/chatops-approval.test.mjs test/chatops-policy.test.mjs test/chatops-file-safety.test.mjs test/chatops-outbound-queue.test.mjs test/chatops-commands.test.mjs test/chatops-bridge.test.mjs test/chatops-config-route.test.mjs test/chatops-apply.test.mjs test/chatops-ilink-contract.test.mjs test/chatops-fleet.test.mjs test/chatops-account.test.mjs test/chatops-auth.test.mjs test/chatops-fleet-scope.test.mjs test/chatops-handoff.test.mjs test/chatops-fleet-wiring.test.mjs test/chatops-fleet-live.test.mjs test/chatops-takeover.test.mjs test/chatops-device-signing.test.mjs test/chatops-relay-verify.test.mjs test/chatops-durability.test.mjs test/chatops-run-command.test.mjs test/secrets-guard.test.mjs test/chatops-ilink-fleet-bridge.test.mjs test/agent-plugins.test.mjs test/memory-layer.test.mjs test/mcp-server.test.mjs test/portable-plugins.test.mjs test/mcp-http.test.mjs test/mcp-http-live.test.mjs test/vision.test.mjs test/ilink-shape.test.mjs test/chatops-fleet-join.test.mjs test/admission.test.mjs test/admission-routes.test.mjs test/join-degradation.test.mjs test/account-identity.test.mjs test/join-challenge.test.mjs test/exec-env-injection.test.mjs test/account-join.test.mjs test/fleet-messages.test.mjs test/message-shards.test.mjs test/fleet-messages-http.test.mjs test/message-notify.test.mjs test/update-channels.test.mjs test/update-prerelease.test.mjs test/session-watch.test.mjs test/session-readonly.test.mjs test/session-sync.test.mjs test/fleet-chat-identity.test.mjs test/identity-reader.test.mjs test/intents.test.mjs test/dataflow.test.mjs test/council-fleet.test.mjs test/fleet-memory.test.mjs test/memory-view.test.mjs test/schema-spec.test.mjs test/fleet-weight-parity.test.mjs test/task-deps.test.mjs test/dataflow-wiring.test.mjs test/task-graph.test.mjs test/ask-store.test.mjs test/turn.test.mjs test/fleet-members.test.mjs test/redact.test.mjs test/policy-matrix.test.mjs test/envelope-signature.test.mjs test/chat-crypto.test.mjs test/reduce-suggestion.test.mjs test/merge-hint.test.mjs test/fleet-chat-route.test.mjs test/maintenance.test.mjs test/maintenance-ferry.test.mjs test/grant.test.mjs test/grant-gate.test.mjs test/worktree.test.mjs test/patch-artifact.test.mjs test/merge-queue.test.mjs test/m3-workflow.test.mjs test/project-room.test.mjs test/project-attribution.test.mjs test/project-locks.test.mjs test/project-reviews.test.mjs test/project-notifications.test.mjs test/blob-sessions.test.mjs test/outbox.test.mjs test/reliability-metrics.test.mjs test/evidence.test.mjs test/grant-issue.test.mjs test/project-refs.test.mjs test/exec-capability.test.mjs test/secondary-link.test.mjs test/bootstrap-cli.test.mjs test/bootstrap.test.mjs test/windows-hidden-task.test.mjs test/relay-failover.test.mjs test/npm-update.test.mjs test/agent-start-nonblocking.test.mjs test/fleet-chat-capture.test.mjs test/capture-route.test.mjs test/update-resolver.test.mjs test/agent-identity-safe.test.mjs test/re-pair-stale-token.test.mjs test/gpw-folder-policy.test.mjs test/gpw-activation.test.mjs test/gpw-hardening.test.mjs test/gpw-tamper-gate.test.mjs test/gpw-persistence.test.mjs test/gpw-colors.test.mjs test/gpw-recent-fold.test.mjs test/gpw-auto-approve.test.mjs test/data-plane.test.mjs test/sealed-object.test.mjs test/joint-dev-dispatch.test.mjs test/joint-dev-loop.test.mjs test/joint-dev-audit.test.mjs test/joint-dev-redline.test.mjs test/relay-redline-guard.test.mjs test/relay-p0-projection.test.mjs test/guarded-dispatch.test.mjs test/p0-single-matcher.test.mjs test/path-policy.test.mjs test/path-policy-fs.test.mjs test/gpw-inheritance-table.test.mjs test/gpw-policy-adapter.test.mjs test/target-policy.test.mjs test/relay-redline-audit.test.mjs test/relay-repair-ledger.test.mjs test/relay-purge-blobs.test.mjs test/relay-scrub.test.mjs test/joint-dev-plan-store.test.mjs test/relay-basepath-blobs.test.mjs test/operator-token.test.mjs test/relay-health-capabilities.test.mjs test/joint-relay-dispatch.test.mjs test/operator-token-route.test.mjs test/relay-scrub-task-projection.test.mjs test/operator-key-approval.test.mjs test/relay-offer-journal.test.mjs test/joint-r5-wiring.test.mjs test/p1-hardening.test.mjs test/joint-merge-engine.test.mjs test/artifact-ref-dir-sink.test.mjs test/chat-sticker-guard.test.mjs test/relay-task-progress.test.mjs",
     "test:acceptance-doc": "node --test --test-force-exit test/acceptance-doc.test.mjs",
     "test:account-identity": "node --test --test-force-exit test/account-identity.test.mjs",
     "test:account-join": "node --test --test-force-exit test/account-join.test.mjs",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "twinsearth-w2m-dsh",
-  "version": "1.9.17",
+  "version": "1.9.20",
   "description": "Run one project across your own Windows and macOS machines from a single DeepSeek account, through 12 w2m_* tools. Four coordination modes (replicate, split, broadcast, pipeline) and six aggregate verdicts (consistent, divergent, divergent-platform, failed, partial, unverifiable). P2P hole punching by default, with a bundled relay, STUN responder and ledger fallback, so the fleet needs no third-party service. Joining needs a pairing code plus autoStartAgent: true; installing alone does not join.",
   "license": "MIT",
   "keywords": [