@twinsearth/w2m-dsh-plugin 1.9.19 → 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.19"
+    "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.19",
+      "version": "1.9.20",
       "author": {
         "name": "TwinsEarth"
       },
@@ -26,5 +26,5 @@
       ]
     }
   ],
-  "version": "1.9.19"
+  "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.19",
+  "version": "1.9.20",
   "author": {
     "name": "TwinsEarth"
   },

package/CHANGELOG.md

@@ -7,6 +7,13 @@
 
 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 秒直接回到第一轮。

package/codex/mcp-servers.toml

@@ -12,6 +12,6 @@
 
 [mcp_servers.w2m-fleet]
 command = "npx"
-args = ["-y", "-p", "@twinsearth/w2m-dsh-plugin@1.9.19", "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.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/lib/client.js

@@ -507,6 +507,9 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
   '.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}',
@@ -968,21 +971,21 @@ 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.
      */
-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]);
-    }
-  };
-  if (typeof document !== 'undefined' && document.body) { roots.push(document.body); visit(document.body); }
-  return roots;
-}
+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]);
+    }
+  };
+  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');
@@ -1054,6 +1057,49 @@ function findScrollSurface() {
   }
   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('');
@@ -2368,6 +2414,16 @@ const CHAT_EMOJIS = CHAT_COMMANDS;
       } 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.19",
+  "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": {

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.19",
+  "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": [

package/src/plugin/tools.mjs

@@ -286,7 +286,7 @@ const MAX_STAGES = 16;
  * `package.json` during `scripts/pack.mjs` rather than hand-maintained, and `W2M_PLUGIN_VERSION`
  * overrides it at runtime for tests and packagers.
  */
-const PLUGIN_VERSION = '1.9.19';
+const PLUGIN_VERSION = '1.9.20';
 
 /** How long any single HTTP call may take before it is aborted, in milliseconds. */
 const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;