@twinsearth/w2m-dsh-plugin 2.0.1 → 2.0.3

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": "2.0.1"
+    "version": "2.0.3"
   },
   "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": "2.0.1",
+      "version": "2.0.3",
       "author": {
         "name": "TwinsEarth"
       },
@@ -26,5 +26,5 @@
       ]
     }
   ],
-  "version": "2.0.1"
+  "version": "2.0.3"
 }

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": "2.0.1",
+  "version": "2.0.3",
   "author": {
     "name": "TwinsEarth"
   },

package/CHANGELOG.md

@@ -7,6 +7,23 @@
 
 All notable changes to this project are documented here.
 
+## [2.0.3] - 2026-10-28
+
+- 滚动按钮移到会话正文列右上角（黑框位置）：按官方浮动圆钮规格 34px、无边框、elevation 阴影、
+  label-primary 图标色（亮色显示为黑色，暗色自动反白）、hover/active/focus-visible 状态。
+- 位置由会话滚动区实时计算（正文列右缘 + 顶部内缩 8px），窗口缩放与侧栏变化时重新对齐。
+- 关键修复：自动完成 DSH 官方“加载更早”——会话是虚拟列表，不点“加载更早”时 scrollTop 到顶即止，
+  这是之前“点击无效/无法到顶”的真正原因。现在滚动前若已在顶部会先点一次“加载更早”等待 350ms，
+  “连续点击 3 次到顶”会循环点击“加载更早”直到它消失，再把滚动区钉在顶部。
+- 交互：点一次向上滚动约 3 轮；1.2 秒内连续点击 3 次回到第一轮。
+
+## [2.0.2] - 2026-10-28
+
+- 滚动按钮移到右下角，与 DSH 官方浮动滚动控件对齐（同右边缘、位于其上方；官方控件出现前后都会重新对齐）。
+- 修复点击无反应：滚动容器改为“试滚探针”（scrollTop ±1 实际是否被浏览器接受）寻找，
+  不再依赖 overflow 样式；命中后直接写 scrollTop。
+- 交互改为：点一次向上滚动约 3 轮；1.2 秒内连续点击 3 次回到第一轮；不再使用长按。
+
 ## [2.0.1] - 2026-10-28
 
 - 修复右上角滚动按钮无效：滚动容器识别改为“命中测试 + 递归 shadow root + 允许 overflow:hidden 的程序化滚动容器”，

package/codex/mcp-servers.toml

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

package/docs/acceptance/2.0.2/RELEASE-2020.json

@@ -0,0 +1,21 @@
+{
+  "version": "2.0.2",
+  "case": "RELEASE-2020",
+  "kind": "positive",
+  "machines": [
+    "b53a37f4-1464-4512-9259-33a7df091e3e"
+  ],
+  "executed_at": "2026-10-28T10:09:24.639Z",
+  "executor": "lead",
+  "task_id": "pre-release-2020-1793182164640",
+  "requirement": "v2.0.2：滚动按钮移至右下与官方控件对齐；探针式滚动容器识别修复点击无效；改为点击 3 轮、连续 3 次到顶",
+  "result": {
+    "outcome": "ok",
+    "assertions": {
+      "position": "fixed bottom-right, aligned above the shell floating scroll control",
+      "resolver": "probe scrollTop ±1 acceptance; no overflow-style dependency",
+      "interaction": "click 1/2 scroll 3 turns; third click within 1.2s jumps to top",
+      "tests": "client-bundle 26/26, lint 0 errors"
+    }
+  }
+}

package/docs/acceptance/2.0.3/RELEASE-2030.json

@@ -0,0 +1,22 @@
+{
+  "version": "2.0.3",
+  "case": "RELEASE-2030",
+  "kind": "positive",
+  "machines": [
+    "b53a37f4-1464-4512-9259-33a7df091e3e"
+  ],
+  "executed_at": "2026-10-28T10:35:33.753Z",
+  "executor": "lead",
+  "task_id": "pre-release-2030-1793183733754",
+  "requirement": "v2.0.3：滚动按钮移到会话区右上黑框位置并变黑；自动点击“加载更早”解除虚拟列表阻断；点击 3 轮、连续 3 次到顶",
+  "result": {
+    "outcome": "ok",
+    "assertions": {
+      "position": "conversation column top-right, 8px inset from surface top, right edge aligned",
+      "style": "34px circle, no border, elevation shadow, label-primary icon via theme tokens",
+      "load_earlier": "auto-click before scrolling at top and repeatedly during scroll-to-top",
+      "interaction": "click 3 turns; 3 clicks within 1.2s to top",
+      "tests": "client-bundle 26/26, lint 0 errors"
+    }
+  }
+}

package/lib/client.js

@@ -507,9 +507,12 @@ 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:16px;top:64px;z-index:2147483000;display:flex;flex-direction:column;align-items:center}',
-  '.w2mScrollFloatBtn{width:32px;height:32px;display:flex;align-items:center;justify-content:center;border-radius:8px;border:1px solid rgba(128,128,128,.4);background:transparent;color:inherit;opacity:.72;line-height:1;cursor:pointer;padding:0}',
-  '.w2mScrollFloatBtn:hover{opacity:1}',
+  '.w2mScrollFloatWrap{position:fixed;top:120px;right:16px;bottom:auto;left:auto;z-index:20;display:flex;align-items:center;justify-content:center;pointer-events:none}',
+  '.w2mScrollFloatBtn{box-sizing:border-box;width:34px;height:34px;padding:0;border:0;border-radius:100px;display:inline-flex;align-items:center;justify-content:center;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-button-floating-fill);box-shadow:0 0 0 .5px var(--dsw-alias-border-l3,rgba(0,0,0,.12)),0 3px 8px 0 rgba(0,0,0,.031),0 0 16px 0 rgba(0,0,0,.02);opacity:1;line-height:1;cursor:pointer;pointer-events:auto;transition:background-color 150ms ease,transform 150ms ease}',
+  '.w2mScrollFloatBtn:hover{background:var(--dsw-alias-button-floating-hover)}',
+  '.w2mScrollFloatBtn:active{background:var(--dsw-alias-button-ghost-active-fill);transform:scale(.96)}',
+  '.w2mScrollFloatBtn:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}',
+  '.w2mScrollFloatBtn svg{display:block;width:16px;height:16px;stroke-width:1.5}',
   '::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}',
@@ -1040,13 +1043,30 @@ function paintSearchMarks(query) {
   }
   return total;
 }
+/**
+ * Probe-scroll: assign a tiny scrollTop and see whether the browser keeps it.
+ *
+ * Overflow styles lie (a shell can scroll an overflow:hidden element), and a virtualised list may
+ * report equal scrollHeight and clientHeight until it is scrolled. The original scrollTop is
+ * restored immediately.
+ */
 function isScrollableElement(el) {
   if (el === null || el === undefined || el === document.body || el === document.documentElement) return false;
-  if (typeof el.scrollHeight !== 'number' || typeof el.clientHeight !== 'number') return false;
+  if (typeof el.scrollTop !== 'number' || typeof el.scrollHeight !== 'number' || typeof el.clientHeight !== 'number') return false;
   if (el.scrollHeight <= el.clientHeight + 8) return false;
-  const style = typeof getComputedStyle === 'function' ? getComputedStyle(el) : null;
-  const overflow = style === null ? '' : style.overflowY;
-  return overflow === '' || overflow === 'auto' || overflow === 'scroll' || overflow === 'overlay' || overflow === 'hidden';
+  const rect = typeof el.getBoundingClientRect === 'function' ? el.getBoundingClientRect() : null;
+  if (rect !== null && (rect.width < 200 || rect.height < 120)) return false;
+  const before = el.scrollTop;
+  try {
+    el.scrollTop = before + 1;
+    if (el.scrollTop !== before) { el.scrollTop = before; return true; }
+    el.scrollTop = Math.max(0, before - 1);
+    if (el.scrollTop !== before) { el.scrollTop = before; return true; }
+    el.scrollTop = before;
+    return false;
+  } catch {
+    return false;
+  }
 }
 function findScrollSurface() {
   if (typeof document === 'undefined') return null;
@@ -1055,49 +1075,81 @@ function findScrollSurface() {
     let current = node;
     while (current !== null && current !== undefined) {
       if (isScrollableElement(current)) { found.add(current); return; }
-      current = current.parentElement ?? (current.parentNode instanceof ShadowRoot ? current.parentNode.host : null);
+      current = current.parentElement ?? (current.parentNode && current.parentNode.host ? current.parentNode.host : null);
     }
   };
   if (typeof document.elementFromPoint === 'function' && typeof window !== 'undefined') {
-    const points = [[window.innerWidth / 2, window.innerHeight / 2], [window.innerWidth / 2, window.innerHeight * 0.72], [window.innerWidth * 0.72, window.innerHeight * 0.4]];
+    const points = [[window.innerWidth / 2, window.innerHeight / 2], [window.innerWidth / 2, window.innerHeight * 0.7], [window.innerWidth * 0.7, window.innerHeight * 0.4]];
     for (const point of points) {
       try { addAncestors(document.elementFromPoint(point[0], point[1])); } catch { /* ignore */ }
     }
   }
-  if (found.size === 0) {
-    for (const root of searchRoots()) {
-      let all = [];
-      try { all = root.querySelectorAll ? [...root.querySelectorAll('*')] : []; } catch { continue; }
-      for (const el of all) if (isScrollableElement(el)) found.add(el);
-    }
+  for (const root of searchRoots()) {
+    let all = [];
+    try { all = root.querySelectorAll ? [...root.querySelectorAll('*')] : []; } catch { continue; }
+    for (const el of all) if (isScrollableElement(el)) found.add(el);
   }
   let best = null;
+  let bestArea = 0;
   for (const el of found) {
-    if (best === null || el.clientHeight * el.scrollHeight > best.clientHeight * best.scrollHeight) best = el;
+    const rect = typeof el.getBoundingClientRect === 'function' ? el.getBoundingClientRect() : null;
+    const area = rect === null ? 0 : rect.width * rect.height;
+    if (best === null || area > bestArea) { best = el; bestArea = area; }
   }
   return best;
 }
-function scrollChatTurns() {
-  const surface = findScrollSurface();
-  const step = Math.round(Math.max(240, (surface !== null ? surface.clientHeight : window.innerHeight) * 1.8));
-  if (surface !== null) {
-    const before = surface.scrollTop;
-    surface.scrollTop = before - step;
-    if (surface.scrollTop === before) surface.scrollBy({ top: -step, behavior: 'smooth' });
-    return;
+/**
+ * The shell virtualises history: scrolling up stops at the loaded window and only the "load
+ * earlier" row fetches more. A scroll control that ignores that row can never reach the top, which
+ * is exactly why the previous version looked like a no-op. Find and press it before scrolling.
+ */
+function findLoadEarlierButton() {
+  if (typeof document === 'undefined') return null;
+  for (const root of searchRoots()) {
+    let nodes = [];
+    try { nodes = root.querySelectorAll ? [...root.querySelectorAll('button, [role="button"], a, span, div')] : []; } catch { continue; }
+    for (const el of nodes) {
+      const text = String(el.textContent ?? '').trim();
+      if (text === '' || text.length > 24) continue;
+      if (!/加载更早|加载更多|更早|load earlier|load more/i.test(text)) continue;
+      const rect = typeof el.getBoundingClientRect === 'function' ? el.getBoundingClientRect() : null;
+      if (rect === null || rect.width < 8 || rect.height < 8) continue;
+      if (typeof el.click === 'function') return el;
+    }
   }
-  if (typeof window !== 'undefined') window.scrollBy({ top: -step, behavior: 'smooth' });
+  return null;
+}
+function clickLoadEarlier() {
+  const el = findLoadEarlierButton();
+  if (el === null) return false;
+  try { el.click(); return true; } catch { return false; }
 }
-function scrollChatTop() {
+const waitFor = (ms) => new Promise((resolve) => { setTimeout(resolve, ms); });
+async function scrollChatTurns() {
   const surface = findScrollSurface();
-  if (surface !== null) {
-    surface.scrollTop = 0;
-    surface.scrollTo({ top: 0, behavior: 'smooth' });
-    return;
+  const viewport = typeof window !== 'undefined' ? window.innerHeight : 800;
+  const step = Math.round(Math.max(240, (surface !== null ? surface.clientHeight : viewport) * 1.8));
+  if (surface !== null && surface.scrollTop <= 8 && clickLoadEarlier()) await waitFor(350);
+  const after = surface ?? findScrollSurface();
+  if (after !== null) after.scrollTop = Math.max(0, after.scrollTop - step);
+  else if (typeof window !== 'undefined') window.scrollBy({ top: -step, behavior: 'smooth' });
+}
+async function scrollChatTop() {
+  // Load history until the "load earlier" row is gone, then pin the surface to the top.
+  for (let i = 0; i < 60; i += 1) {
+    const surface = findScrollSurface();
+    if (surface !== null) surface.scrollTop = 0;
+    if (!clickLoadEarlier()) break;
+    await waitFor(280);
+  }
+  for (let i = 0; i < 8; i += 1) {
+    const surface = findScrollSurface();
+    if (surface !== null) surface.scrollTop = 0;
+    else if (typeof window !== 'undefined') window.scrollTo({ top: 0, behavior: 'smooth' });
+    await waitFor(70);
   }
-  if (typeof window !== 'undefined') window.scrollTo({ top: 0, behavior: 'smooth' });
 }
-/** One floating button, styled after the shell's own back-to-top control. */
+/** One black circular button, anchored to the conversation column's top-right corner. */
 function installFloatingScrollControl() {
   if (typeof document === 'undefined' || document.body === null) return null;
   const wrap = document.createElement('div');
@@ -1106,17 +1158,15 @@ function installFloatingScrollControl() {
   const button = document.createElement('button');
   button.type = 'button';
   button.className = 'w2mScrollFloatBtn';
-  button.title = '向上滚动 3 轮（长按 3 秒回到第一轮）';
-  button.setAttribute('aria-label', button.title);
+  button.title = '向上滚动 3 轮（连续点击 3 次回到第一轮）';
+  button.setAttribute('aria-label', '向上滚动');
+  button.setAttribute('aria-description', '单次点击向上滚动三轮，连续点击三次回到第一轮');
   button.addEventListener('contextmenu', (event) => event.preventDefault());
   const ns = 'http://www.w3.org/2000/svg';
   const svg = document.createElementNS(ns, 'svg');
   svg.setAttribute('viewBox', '0 0 24 24');
-  svg.setAttribute('width', '18');
-  svg.setAttribute('height', '18');
   svg.setAttribute('fill', 'none');
   svg.setAttribute('stroke', 'currentColor');
-  svg.setAttribute('stroke-width', '2');
   svg.setAttribute('stroke-linecap', 'round');
   svg.setAttribute('stroke-linejoin', 'round');
   const shaft = document.createElementNS(ns, 'path');
@@ -1126,20 +1176,54 @@ function installFloatingScrollControl() {
   svg.appendChild(shaft);
   svg.appendChild(head);
   button.appendChild(svg);
-  let holdTimer = null;
-  let longFired = false;
-  const clearHold = () => { if (holdTimer !== null) { clearTimeout(holdTimer); holdTimer = null; } };
-  button.addEventListener('pointerdown', (event) => {
-    if (event && typeof event.preventDefault === 'function') event.preventDefault();
-    longFired = false;
-    clearHold();
-    holdTimer = setTimeout(() => { longFired = true; scrollChatTop(); }, 3000);
+  let clicks = 0;
+  let resetTimer = null;
+  const reset = () => { if (resetTimer !== null) { clearTimeout(resetTimer); resetTimer = null; } clicks = 0; };
+  button.addEventListener('click', () => {
+    clicks += 1;
+    if (resetTimer !== null) clearTimeout(resetTimer);
+    if (clicks >= 3) { reset(); void scrollChatTop(); return; }
+    void scrollChatTurns();
+    resetTimer = setTimeout(reset, 1200);
   });
-  for (const type of ['pointerup', 'pointerleave', 'pointercancel']) button.addEventListener(type, clearHold);
-  button.addEventListener('click', () => { if (longFired) { longFired = false; return; } scrollChatTurns(); });
   wrap.appendChild(button);
   document.body.appendChild(wrap);
-  return () => { clearHold(); wrap.remove(); };
+  const place = () => {
+    const surface = findScrollSurface();
+    if (surface === null) {
+      wrap.style.top = '120px';
+      wrap.style.right = '16px';
+      return;
+    }
+    const rect = surface.getBoundingClientRect();
+    wrap.style.top = Math.max(8, Math.round(rect.top + 8)) + 'px';
+    wrap.style.right = Math.max(12, Math.round(window.innerWidth - rect.right)) + 'px';
+  };
+  place();
+  for (const delay of [120, 600, 1500]) setTimeout(place, delay);
+  window.addEventListener('resize', place);
+  let observer = null;
+  let observed = null;
+  const observe = () => {
+    if (typeof ResizeObserver !== 'function') return;
+    const surface = findScrollSurface();
+    if (surface === observed) return;
+    if (observer !== null) observer.disconnect();
+    observed = surface;
+    observer = new ResizeObserver(() => place());
+    if (surface !== null) observer.observe(surface);
+  };
+  observe();
+  const reObserve = setTimeout(observe, 800);
+  const poll = setInterval(place, 1000);
+  return () => {
+    reset();
+    clearTimeout(reObserve);
+    clearInterval(poll);
+    window.removeEventListener('resize', place);
+    if (observer !== null) observer.disconnect();
+    wrap.remove();
+  };
 }
 function ConversationSearch() {
   const [open, setOpen] = React.useState(false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/w2m-dsh-plugin",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "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": "2.0.1",
+  "version": "2.0.3",
   "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 = '2.0.1';
+const PLUGIN_VERSION = '2.0.3';
 
 /** How long any single HTTP call may take before it is aborted, in milliseconds. */
 const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;