@twinsearth/w2m-dsh-plugin 2.2.0 → 2.2.2

package/lib/client.js

@@ -66,6 +66,37 @@ window.__ModuleLoader__.load({
 
     const React = require('react');
 
+    /**
+     * Render a popup under `document.body`.
+     *
+     * DSH 0.2.2-rc.1 puts `container-type: inline-size` on the composer row. Layout containment makes
+     * that row the containing block for `position: fixed` descendants, so a menu rendered inside the
+     * composer slot is positioned relative to the row (and can be clipped) instead of the viewport.
+     * A portal keeps the viewport coordinates the menus already compute. `react-dom` is a platform
+     * seed in the Web shell; the lazy require keeps this bundle loadable where only React is present,
+     * and the inline fallback preserves the old behavior if the portal cannot be created.
+     *
+     * @param {object|null} node - menu element.
+     * @returns {object|null} portal element, or the original node.
+     */
+    let portalRuntime;
+    let portalUnavailable = false;
+    function portalNode(node) {
+      if (node === null || portalUnavailable) return node;
+      if (typeof document === 'undefined' || document.body === null || document.body === undefined) return node;
+      try {
+        if (portalRuntime === undefined) portalRuntime = require('react-dom');
+        if (typeof portalRuntime?.createPortal !== 'function') {
+          portalUnavailable = true;
+          return node;
+        }
+        return portalRuntime.createPortal(node, document.body);
+      } catch {
+        portalUnavailable = true;
+        return node;
+      }
+    }
+
     // -------------------------------------------------------------------------------------------
     // Wire
     // -------------------------------------------------------------------------------------------
@@ -103,6 +134,7 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
         costAll: '本次会话的派发会送到所有在线机器',
         costOne: '本次会话的派发会送到 {name}',
         unconfirmed: '（未确认在线）',
+        mentionFailed: '目标已切换，但输入框未能同步 @ 标记；请稍后重新选择该机器',
         targetLabel: '目标机器：{name}',
         unreachable: '无法连接插件',
         routeMissing: '这个 Harness 没有提供插件目标路由',
@@ -176,6 +208,7 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
         costAll: 'Work from this session goes to every online machine',
         costOne: 'Work from this session goes to {name}',
         unconfirmed: ' (not confirmed online)',
+        mentionFailed: 'the target changed, but the composer could not add the @ handle; pick the machine again in a moment',
         targetLabel: 'target machine: {name}',
         unreachable: 'the plugin could not be reached',
         routeMissing: 'this host does not serve the W2M target route',
@@ -1748,7 +1781,336 @@ function UpdateSettingsSection() {
   ]);
 }
 
-function TargetSelect({ sessionId, locked: _locked, t }) {
+    /**
+     * The `@machine` token the target control writes into the composer.
+     *
+     * This is a *visible handle*, not the dispatch decision: the host-side selection store remains
+     * the source of truth, and `w2m_run` reads it from the host process. The token exists so the
+     * operator can see which machine the next turn is aimed at after the menu closes.
+     *
+     * A name that is not a single safe word is quoted, because DSH's own `@` trigger runs to the
+     * next whitespace. A name containing a quote cannot be represented safely and yields null:
+     * the selection still works, it simply gets no token.
+     *
+     * @param {string|null|undefined} name The machine's display name.
+     * @returns {string|null} `@name`, `@"name with spaces"`, or null.
+     */
+    function targetTokenForName(name) {
+      if (typeof name !== 'string') return null;
+      const trimmed = name.trim();
+      if (trimmed === '' || /[\r\n"]/.test(trimmed)) return null;
+      return /^[A-Za-z0-9_-]+$/.test(trimmed) ? `@${trimmed}` : `@"${trimmed}"`;
+    }
+
+    /** Occurrence offsets are clipboard offsets; sort them so both maps walk one order. */
+    function sortedOccurrences(occurrences) {
+      return (Array.isArray(occurrences) ? occurrences : [])
+        .filter((entry) => entry !== null && typeof entry === 'object'
+          && Number.isInteger(entry.offset) && Number.isInteger(entry.length) && entry.length > 0)
+        .slice()
+        .sort((left, right) => left.offset - right.offset);
+    }
+
+    /**
+     * Clipboard offset → editor (detect) offset.
+     *
+     * A reference chip is one U+FFFC in the editor but its whole clipboard text in the draft, so
+     * the two coordinate spaces diverge after every chip. Positions inside a chip are clamped to
+     * its editor position; a token boundary never lands there.
+     */
+    function clipboardToDetect(offset, occurrences) {
+      let shift = 0;
+      for (const occurrence of sortedOccurrences(occurrences)) {
+        if (offset <= occurrence.offset) break;
+        if (offset < occurrence.offset + occurrence.length) return occurrence.offset - shift + 1;
+        shift += occurrence.length - 1;
+      }
+      return offset - shift;
+    }
+
+    /** Editor (detect) offset → clipboard offset; the inverse of {@link clipboardToDetect}. */
+    function detectToClipboard(offset, occurrences) {
+      let shift = 0;
+      for (const occurrence of sortedOccurrences(occurrences)) {
+        const start = occurrence.offset - shift;
+        if (offset <= start) break;
+        if (offset < start + 1) return occurrence.offset;
+        shift += occurrence.length - 1;
+      }
+      return offset + shift;
+    }
+
+    /** Find a token in the draft, requiring a word boundary on both sides. */
+    function targetTokenSpan(draft, token) {
+      if (typeof draft !== 'string' || typeof token !== 'string' || token === '') return null;
+      let from = 0;
+      while (from <= draft.length) {
+        const start = draft.indexOf(token, from);
+        if (start < 0) return null;
+        const before = start === 0 ? '' : draft.charAt(start - 1);
+        const after = draft.charAt(start + token.length);
+        const beforeOk = start === 0 || /\s/.test(before);
+        const afterOk = after === '' || /\s/.test(after) || /[.,;:!?，。；：！？、]/.test(after);
+        if (beforeOk && afterOk) return { start, end: start + token.length };
+        from = start + 1;
+      }
+      return null;
+    }
+
+    /**
+     * The editor span that removes one token without leaving a double word gap.
+     *
+     * Letting a token go and leaving its separating space turns "@alpha run" into " run", which is
+     * visibly not the draft the operator typed. Only one ASCII space is eaten, and a newline is
+     * never eaten: the plugin owns the token, not the paragraph around it.
+     */
+    function targetTokenRemoval(draft, span, occurrences) {
+      let clipboardEnd = span.end;
+      if (draft.charAt(clipboardEnd) === ' ') clipboardEnd += 1;
+      return {
+        start: clipboardToDetect(span.start, occurrences),
+        end: clipboardToDetect(clipboardEnd, occurrences),
+      };
+    }
+
+    /**
+     * Plan the one editor edit that keeps the visible token in step with a target change.
+     *
+     * Rules (all deliberately conservative):
+     *   · switching A → B replaces the old `@A` instead of leaving two targets in the draft;
+     *   · the new token is only inserted when the host accepted the selection;
+     *   · clearing the selection removes only the token this plugin inserted;
+     *   · an existing `@B` is never duplicated;
+     *   · a name that cannot be represented as a token is left alone rather than guessed.
+     *
+     * @returns {{kind: 'none'|'present'|'remove'|'replace'|'insert', text?: string,
+     *   start?: number, end?: number, reason?: string}}
+     */
+    function planTargetMention(input = {}) {
+      const draft = typeof input.draft === 'string' ? input.draft : '';
+      const occurrences = sortedOccurrences(input.occurrences);
+      const caret = input.caret !== null && typeof input.caret === 'object' ? input.caret : {};
+      const nextToken = targetTokenForName(input.nextName);
+      const previousToken = targetTokenForName(input.previousName);
+      const previousSpan = previousToken === null ? null : targetTokenSpan(draft, previousToken);
+
+      if (nextToken === null) {
+        if (previousSpan === null) return { kind: previousToken === null ? 'none' : 'present', reason: 'no-token' };
+        return {
+          kind: 'remove',
+          ...targetTokenRemoval(draft, previousSpan, occurrences),
+          draftRev: Number.isInteger(caret.draftRev) ? caret.draftRev : 0,
+        };
+      }
+
+      const nextSpan = targetTokenSpan(draft, nextToken);
+      if (nextSpan !== null) {
+        if (previousSpan !== null && previousToken !== nextToken) {
+          return {
+            kind: 'remove',
+            ...targetTokenRemoval(draft, previousSpan, occurrences),
+            draftRev: Number.isInteger(caret.draftRev) ? caret.draftRev : 0,
+          };
+        }
+        return { kind: 'present' };
+      }
+
+      if (previousSpan !== null) {
+        return {
+          kind: 'replace',
+          text: nextToken,
+          start: clipboardToDetect(previousSpan.start, occurrences),
+          end: clipboardToDetect(previousSpan.end, occurrences),
+          draftRev: Number.isInteger(caret.draftRev) ? caret.draftRev : 0,
+        };
+      }
+
+      const start = Number.isInteger(caret.start) ? caret.start : 0;
+      const end = Number.isInteger(caret.end) ? caret.end : start;
+      // Inserting at a non-collapsed selection must not consume what the operator selected:
+      // the selection is where their caret is, not text this control owns. Anchor at its end.
+      const at = end;
+      const clipboardAt = detectToClipboard(at, occurrences);
+      const lead = clipboardAt > 0 && !/\s/.test(draft.charAt(clipboardAt - 1)) ? ' ' : '';
+      const tail = /\s/.test(draft.charAt(clipboardAt)) ? '' : ' ';
+      return {
+        kind: 'insert',
+        text: lead + nextToken + tail,
+        start: at,
+        end: at,
+        draftRev: Number.isInteger(caret.draftRev) ? caret.draftRev : 0,
+      };
+    }
+
+    /** Put the caret back in the composer after the menu closes; best effort, never fatal. */
+    function focusComposer() {
+      if (typeof document === 'undefined') return;
+      try {
+        const node = document.querySelector('[data-composer-input]');
+        if (node !== null && typeof node.focus === 'function') node.focus({ preventScroll: true });
+      } catch { /* a detached or re-rendered editor is not an error */ }
+    }
+
+    /** A composition without the input seat keeps the control working, minus the token edit. */
+    function useNoComposerInput() {
+      return null;
+    }
+
+    /** Stable selector: the whole input snapshot, never a fresh derived object. */
+    function selectComposerInput(snapshot) {
+      return snapshot;
+    }
+
+    /**
+     * v2.2.1: the settings-page fleet pin.
+     *
+     * The operator pastes an old fleet key, sees the fleet id it derives, compares that with the
+     * expected id, and only then saves. The host route writes an independent `fleet-config.json`
+     * with a backup; this component never edits `cordis.patch.yml` and never displays the key back.
+     */
+    function FleetConfigSection() {
+      const [state, setState] = React.useState(null);
+      const [keyInput, setKeyInput] = React.useState('');
+      const [expectedId, setExpectedId] = React.useState('');
+      const [preview, setPreview] = React.useState(null);
+      const [confirmed, setConfirmed] = React.useState(false);
+      const [error, setError] = React.useState(null);
+      const [busy, setBusy] = React.useState(false);
+      const [saved, setSaved] = React.useState(null);
+
+      const call = async (init) => {
+        try {
+          const response = await fetch('/api/w2m/fleet-config', {
+            credentials: 'same-origin',
+            headers: { accept: 'application/json', ...(init?.body === undefined ? {} : { 'content-type': 'application/json' }) },
+            ...init,
+          });
+          let body = null;
+          try { body = await response.json(); } catch { body = null; }
+          if (response.status === 404) return { ok: false, routeMissing: true, error: 'this host does not serve the fleet-config route' };
+          if (response.ok !== true || body?.ok === false) {
+            return { ok: false, error: body?.error ?? body?.code ?? `HTTP ${response.status}`, body };
+          }
+          return { ok: true, body };
+        } catch (err) {
+          return { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+      };
+
+      const load = React.useCallback(async () => {
+        const result = await call({ method: 'GET' });
+        if (result.ok) setState(result.body);
+        else setError(result.routeMissing ? '当前 DSH 没有编队绑定路由（插件版本过旧或未挂载）' : (result.error ?? '读取失败'));
+      }, []);
+      React.useEffect(() => { load(); }, [load]);
+
+      const previewKey = async () => {
+        const key = keyInput.trim();
+        if (key === '') return;
+        setBusy(true);
+        setError(null);
+        setSaved(null);
+        setConfirmed(false);
+        try {
+          const result = await call({ method: 'POST', body: JSON.stringify({ action: 'preview', fleet_key: key, expected_fleet_id: expectedId.trim() }) });
+          if (!result.ok) { setPreview(null); setError(result.error ?? '无法计算 fleet_id'); return; }
+          setPreview(result.body);
+        } finally { setBusy(false); }
+      };
+
+      const save = async () => {
+        const key = keyInput.trim();
+        if (key === '' || preview === null || confirmed !== true) return;
+        setBusy(true);
+        setError(null);
+        try {
+          const result = await call({
+            method: 'POST',
+            body: JSON.stringify({ action: 'save', fleet_key: key, expected_fleet_id: preview.fleet_id }),
+          });
+          if (!result.ok) { setError(result.error ?? '保存失败'); return; }
+          setSaved(result.body);
+          setKeyInput('');
+          setPreview(null);
+          setConfirmed(false);
+          await load();
+        } finally { setBusy(false); }
+      };
+
+      const expectedMismatch = preview !== null && expectedId.trim() !== ''
+        && String(preview.fleet_id).toLowerCase() !== expectedId.trim().toLowerCase();
+      const mono = { fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace', wordBreak: 'break-all' };
+      return h('div', { className: 'w2mGpw_admin' }, [
+        h('div', { key: 'head', className: 'w2mGpw_adminHead' }, [
+          h('h1', { key: 'h', className: 'w2mGpw_adminTitle' }, '编队绑定'),
+          h('div', { key: 'sub', className: 'w2mGpw_adminSub' },
+            '把本机固定到指定编队。保存到独立的 fleet-config.json（0600），不改 cordis.patch.yml；保存后重启 DSH 才生效。'),
+        ]),
+        error === null ? null : h('div', { key: 'err', className: 'w2mGpw_adminNote' }, error),
+        h('div', { key: 'current', className: 'w2mGpw_adminCard' }, [
+          h('div', { key: 's', className: 'w2mGpw_adminSub' }, state === null
+            ? '读取中…'
+            : state.configured === true
+              ? `已配置 · policy ${String(state.policy ?? '?')} · 指纹 ${String(state.fingerprint ?? '').slice(0, 12)}`
+              : '未配置：当前按 fleetKeyPolicy 的默认策略绑定'),
+          state?.fleet_id ? h('div', { key: 'id', style: mono }, 'fleet_id: ' + state.fleet_id) : null,
+          state?.path ? h('div', { key: 'p', className: 'w2mGpw_adminSub' }, '文件：' + state.path) : null,
+        ]),
+        h('div', { key: 'form', className: 'w2mGpw_adminCard' }, [
+          h('div', { key: 'row', className: 'w2mGpw_adminToolbar' }, [
+            h('input', {
+              key: 'k',
+              className: 'w2mGpw_adminInput',
+              type: 'password',
+              value: keyInput,
+              placeholder: '旧 fleet key（保存后只显示指纹，不回显）',
+              onChange: (event) => { setKeyInput(event.target.value); setPreview(null); setConfirmed(false); },
+            }),
+            h('button', { key: 'c', type: 'button', className: 'w2mGpw_adminBtn', disabled: busy || keyInput.trim() === '', onClick: previewKey }, '计算 fleet_id'),
+          ]),
+          h('div', { key: 'row2', className: 'w2mGpw_adminToolbar', style: { marginTop: '8px' } }, [
+            h('input', {
+              key: 'e',
+              className: 'w2mGpw_adminInput',
+              value: expectedId,
+              placeholder: '期望的 fleet_id（可选，例如 004945ed…）',
+              onChange: (event) => { setExpectedId(event.target.value); setConfirmed(false); },
+            }),
+          ]),
+          preview === null ? null : h('div', { key: 'preview', style: { marginTop: '12px' } }, [
+            h('div', { key: 'l', className: 'w2mGpw_adminSub' }, '这个 key 算出的 fleet_id：'),
+            h('div', { key: 'id', style: { ...mono, margin: '4px 0 8px' } }, String(preview.fleet_id)),
+            expectedMismatch
+              ? h('div', { key: 'bad', className: 'w2mGpw_adminNote' }, '与期望值不一致，不能保存。请核对 key 或期望值。')
+              : h('label', { key: 'ok', className: 'w2mGpw_adminSub', style: { display: 'flex', gap: '8px', alignItems: 'center' } }, [
+                  h('input', {
+                    key: 'c',
+                    type: 'checkbox',
+                    checked: confirmed,
+                    disabled: expectedMismatch,
+                    onChange: (event) => setConfirmed(event.target.checked),
+                  }),
+                  h('span', { key: 't' }, '我确认这是目标编队，保存并固定'),
+                ]),
+            h('button', {
+              key: 'save',
+              type: 'button',
+              className: 'w2mGpw_adminBtn',
+              style: { marginTop: '8px' },
+              disabled: busy || confirmed !== true || expectedMismatch,
+              onClick: save,
+            }, '保存并固定到该编队'),
+          ]),
+          saved === null ? null : h('div', { key: 'saved', className: 'w2mGpw_adminNote' }, [
+            h('div', { key: 'a' }, '已保存。重启 DSH 后生效；本页不会自动重启。'),
+            h('div', { key: 'b', style: mono }, 'fleet_id: ' + String(saved.fleet_id ?? '')),
+            saved.backup ? h('div', { key: 'c' }, '备份：' + saved.backup) : null,
+          ]),
+        ]),
+      ]);
+    }
+
+    function TargetSelect({ sessionId, locked: _locked, t, inputActions, useInput }) {
       const [open, setOpen] = React.useState(false);
       // v1.5.1: relay folding. The snapshot carries the pool; when it holds more than three nodes
       // the menu shows a summary and this toggle reveals the folded ones.
@@ -1756,11 +2118,29 @@ function TargetSelect({ sessionId, locked: _locked, t }) {
       const [reloadSeq, setReloadSeq] = React.useState(0);
       const [state, setState] = React.useState(null);
       const [error, setError] = React.useState(null);
+      // A write/edit refusal is not a fleet-read failure: the menu is closed when it happens, so
+      // keeping it beside `error` (which a successful read clears) is what makes it survive the
+      // reopen that shows it to the operator.
+      const [notice, setNotice] = React.useState(null);
       const [busy, setBusy] = React.useState(false);
       const anchorRef = React.useRef(null);
       const menuRef = React.useRef(null);
       const [placement, setPlacement] = React.useState(null);
 
+      // v2.3.0: the target control also writes a visible `@machine` token. `inputActions` and
+      // `useInput` are standard session props (dsh-client-ui-conversation provides them to every
+      // session slot); a host that does not carry them still gets the selector, just no token.
+      const useComposerInput = typeof useInput === 'function' ? useInput : useNoComposerInput;
+      const input = useComposerInput(selectComposerInput);
+      const inputRef = React.useRef(input);
+      inputRef.current = input;
+      // Session switches are per mount in the shell, but a write can still land after the prop
+      // changed under a reused component. The ref reads the current value at resolve time; the
+      // sequence makes the last click win when two writes are in flight.
+      const sessionRef = React.useRef(sessionId);
+      sessionRef.current = sessionId;
+      const writeSeq = React.useRef(0);
+
       // The host half is the source of truth, so every read replaces the mirror rather than merging
       // into it: a stale "online" must not outlive the answer that disproved it.
       React.useEffect(() => {
@@ -1832,7 +2212,7 @@ function TargetSelect({ sessionId, locked: _locked, t }) {
       const machines = Array.isArray(state?.machines) ? state.machines : [];
       // v1.5.1: the relay pool the host probed, already folded. `null` means a single-relay host.
       const relayFold = state?.relays ?? null;
-      const problem = error ?? fleetProblem(state, t);
+      const problem = notice ?? error ?? fleetProblem(state, t);
       const disabled = typeof sessionId !== 'string' || sessionId === '';
       const label = state === null ? (provisionalLabel(state) ?? t('machine')) : labelOf(state, t);
       const selectedMachine = machines.find((machine) => machine.machine_id === chosen) ?? null;
@@ -1846,26 +2226,97 @@ function TargetSelect({ sessionId, locked: _locked, t }) {
         ? t('costAll')
         : `${t('costOne', { name: label })}${selectedOnline === true ? '' : t('unconfirmed')}`);
 
+      /**
+       * Apply the one editor edit that mirrors a target change.
+       *
+       * Ordering matters: the host write happens first, so a token is never left claiming a target
+       * the host refused. The edit is best effort — a composer that is submitting, or a host
+       * without `inputActions`, keeps the selection and simply loses the visible handle.
+       */
+      const applyTargetMention = (nextName, previousName) => {
+        if (inputActions === null || typeof inputActions !== 'object'
+          || typeof inputActions.insertText !== 'function'
+          || typeof inputActions.captureInsertion !== 'function') {
+          focusComposer();
+          return;
+        }
+        const capture = inputActions.captureInsertion();
+        if (capture === null || typeof capture !== 'object') {
+          focusComposer();
+          return;
+        }
+        const current = inputRef.current ?? {};
+        // `captureInsertion()` is the editor's current revision; `inputRef.current` is the last
+        // published snapshot. If they disagree, the draft these offsets were computed from is not
+        // the draft the editor holds, and `draftRev` would let a stale offset through.
+        if (Number.isInteger(current.draftRev) && current.draftRev !== capture.draftRev) {
+          focusComposer();
+          return;
+        }
+        const plan = planTargetMention({
+          draft: typeof current.draft === 'string' ? current.draft : '',
+          occurrences: current.occurrences,
+          caret: capture,
+          nextName,
+          previousName,
+        });
+        if (plan.kind === 'insert' || plan.kind === 'replace' || plan.kind === 'remove') {
+          const text = plan.kind === 'remove' ? '' : plan.text;
+          const applied = inputActions.insertText(text, {
+            start: plan.start,
+            end: plan.end,
+            draftRev: capture.draftRev,
+          });
+          if (applied !== true) {
+            setNotice(t('mentionFailed'));
+            setOpen(true);
+          } else {
+            setNotice(null);
+          }
+        } else {
+          setNotice(null);
+        }
+        focusComposer();
+      };
+
       const choose = (machineId, machineName) => {
         setOpen(false);
-        if (machineId === chosen) return;
+        const previousName = selectedMachine?.name ?? state?.selected?.name ?? null;
+        if (machineId === chosen) {
+          // Clicking the current target restores a token the operator deleted, but never turns
+          // the click into a destructive "clear" gesture: clearing is the All-machines row.
+          setNotice(null);
+          applyTargetMention(machineId === null ? null : previousName, null);
+          return;
+        }
+        const seq = (writeSeq.current += 1);
+        const at = sessionId;
         setBusy(true);
         writeSelection(sessionId, machineId, machineName).then((result) => {
+          if (seq !== writeSeq.current) return; // a later click owns the answer
+          if (at !== sessionRef.current) return; // the session changed while the write was in flight
           setBusy(false);
           if (result.ok) {
             setState(result.state);
             setError(null);
+            setNotice(null);
+            if (machineId === null) {
+              applyTargetMention(null, previousName);
+              return;
+            }
+            applyTargetMention(result.state?.selected?.name ?? machineName ?? null, previousName);
             return;
           }
           // The write is refused for a reason the operator can act on (the machine went away, the
-          // fleet could not be read), so it is shown where they are looking rather than swallowed.
-          setError(result.error);
-          setReloadSeq((seq) => seq + 1);
+          // fleet could not be read). Reopen the menu so `notice` is actually in front of them.
+          setNotice(result.error);
+          setOpen(true);
+          setReloadSeq((reload) => reload + 1);
         });
       };
 
       const menu = open && placement !== null
-        ? h('div', {
+        ? portalNode(h('div', {
             className: cls('menu'),
             role: 'listbox',
             'aria-label': t('targetLabel', { name: label }),
@@ -1961,7 +2412,7 @@ function TargetSelect({ sessionId, locked: _locked, t }) {
                 ? h('div', { key: 'hint', className: cls('relayHint') }, t('relayFold', { count: relayFold.hidden_count }))
                 : null,
             ]),
-          ])
+          ]))
         : null;
 
       return h(React.Fragment, null, [
@@ -2686,7 +3137,7 @@ const CHAT_EMOJIS = CHAT_COMMANDS;
       };
 
       const menu = open && placement !== null
-        ? h('div', {
+        ? portalNode(h('div', {
             className: 'w2mCap_menu',
             role: 'menu',
             'aria-label': t('capMenuLabel'),
@@ -2698,7 +3149,7 @@ const CHAT_EMOJIS = CHAT_COMMANDS;
             h('button', { key: 'temp', type: 'button', className: 'w2mCap_option', 'data-active': capability?.state === 'temporary' ? 'true' : 'false', onClick: () => choose('temporary', 24 * 60 * 60 * 1000) }, t('capTemporary')),
             h('button', { key: 'perm', type: 'button', className: 'w2mCap_option', 'data-active': capability?.state === 'permanent' ? 'true' : 'false', onClick: () => choose('permanent') }, t('capPermanent')),
             error === null ? null : h('div', { key: 'err', className: 'w2mCap_note', role: 'status' }, error),
-          ])
+          ]))
         : null;
 
       return h(React.Fragment, null, [
@@ -2848,6 +3299,20 @@ const CHAT_EMOJIS = CHAT_COMMANDS;
         } catch (error) {
           console.error('@twinsearth/w2m-dsh-plugin: the GPW settings tab was not mounted', error);
         }
+        // v2.2.1: the supported alternative to editing cordis.patch.yml. The section is its own
+        // settings card so an operator can find "where do I put the old fleet key?" without
+        // touching a profile file.
+        try {
+          slots.inject('settings.section', () => slots.register({
+            name: 'settings.section',
+            id: 'w2m-fleet',
+            order: 11,
+            label: () => '编队绑定',
+            inject: () => ({ t }),
+          }, FleetConfigSection));
+        } catch (error) {
+          console.error('@twinsearth/w2m-dsh-plugin: the fleet-binding settings section was not mounted', error);
+        }
         // v1.9.4: the update controls belong on the plugin's own page (same page as Uninstall),
         // not only in the global settings list.
         try {
@@ -3008,11 +3473,14 @@ const CHAT_EMOJIS = CHAT_COMMANDS;
     exports.apply = apply;
     exports.inject = inject;
     exports.TargetSelect = TargetSelect;
+    exports.targetTokenForName = targetTokenForName;
+    exports.planTargetMention = planTargetMention;
     exports.GpwLauncher = GpwLauncher;
     exports.GpwPrompt = GpwPrompt;
       exports.FleetChat = FleetChat;
     exports.injectStyle = injectStyle;
     exports.makeTranslator = makeTranslator;
+    exports.portalNode = portalNode;
     return module.exports;
   },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/w2m-dsh-plugin",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "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": {
@@ -71,7 +71,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/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/gpw-modes.test.mjs test/joint-cli.test.mjs test/joint-command-hash.test.mjs test/joint-dispatch-audit.test.mjs test/tools-cancel-auth.test.mjs test/fleet-mirror.test.mjs test/sink-git-ssh.test.mjs test/agent-sse-watchdog.test.mjs test/version-gate.test.mjs test/joint-merge-cli.test.mjs test/joint-progress.test.mjs test/project-room-truncation.test.mjs test/chat-crypto-aad.test.mjs test/agent-artifact-delivery.test.mjs test/dataplane-sink-route.test.mjs test/artifact-sink-e2e.test.mjs test/project-room-persistence.test.mjs test/project-room-disk-persistence.test.mjs test/project-stream-route.test.mjs test/chat-v2-gate.test.mjs test/xiangqi.test.mjs test/xfer-foundation.test.mjs test/xfer-ferry.test.mjs test/xfer-publish.test.mjs test/xfer-want-block.test.mjs test/p2p-cipher-diag.test.mjs test/chacha-fallback.test.mjs test/fleet-binding.test.mjs test/xfer-channel.test.mjs test/p2p-race.test.mjs test/path-scheduler.test.mjs test/transport.test.mjs test/iroh-sidecar.test.mjs test/discovery.test.mjs test/p2p-rtt.test.mjs test/artifact-ref-v3.test.mjs test/xfer-recovery.test.mjs test/xfer-router.test.mjs test/remote-s2-capture.test.mjs test/view-capture.test.mjs test/view-frame-channel.test.mjs test/remote-view-route.test.mjs test/remote-media.test.mjs test/view-session-key.test.mjs test/remote-requests.test.mjs test/relay-target.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/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/gpw-modes.test.mjs test/joint-cli.test.mjs test/joint-command-hash.test.mjs test/joint-dispatch-audit.test.mjs test/tools-cancel-auth.test.mjs test/fleet-mirror.test.mjs test/sink-git-ssh.test.mjs test/agent-sse-watchdog.test.mjs test/version-gate.test.mjs test/joint-merge-cli.test.mjs test/joint-progress.test.mjs test/project-room-truncation.test.mjs test/chat-crypto-aad.test.mjs test/agent-artifact-delivery.test.mjs test/dataplane-sink-route.test.mjs test/artifact-sink-e2e.test.mjs test/project-room-persistence.test.mjs test/project-room-disk-persistence.test.mjs test/project-stream-route.test.mjs test/chat-v2-gate.test.mjs test/xiangqi.test.mjs test/xfer-foundation.test.mjs test/xfer-ferry.test.mjs test/xfer-publish.test.mjs test/xfer-want-block.test.mjs test/p2p-cipher-diag.test.mjs test/chacha-fallback.test.mjs test/fleet-binding.test.mjs test/fleet-home.test.mjs test/fleet-config.test.mjs test/fleet-config-route.test.mjs test/xfer-channel.test.mjs test/p2p-race.test.mjs test/path-scheduler.test.mjs test/transport.test.mjs test/iroh-sidecar.test.mjs test/discovery.test.mjs test/p2p-rtt.test.mjs test/artifact-ref-v3.test.mjs test/xfer-recovery.test.mjs test/xfer-router.test.mjs test/remote-s2-capture.test.mjs test/view-capture.test.mjs test/view-frame-channel.test.mjs test/remote-view-route.test.mjs test/remote-media.test.mjs test/view-session-key.test.mjs test/remote-requests.test.mjs test/relay-target.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": "2.2.0",
+  "version": "2.2.2",
   "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": [