@twinsearth/w2m-dsh-plugin 2.2.6 → 3.1.0

package/lib/client.js

@@ -488,6 +488,14 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
         '.w2mGpw_tag[data-d="deny"]{border-color:var(--dsw-alias-state-danger-primary);color:var(--dsw-alias-state-danger-primary)}',
         '.w2mGpw_note{font-size:12px;color:var(--dsw-alias-label-secondary)}',
         '.w2mGpw_hint{font-size:11px;color:var(--dsw-alias-label-tertiary)}',
+        '.w2mDc_level{display:flex;flex-direction:column;gap:4px}',
+        '.w2mDc_ticket{display:flex;flex-direction:column;gap:4px;padding:5px 7px;border-radius:var(--dsw-radius-md);border:.5px solid var(--dsw-alias-border-default);background:var(--dsw-alias-bg-layer-2)}',
+        '.w2mDc_head{display:flex;align-items:center;gap:6px;min-width:0}',
+        '.w2mDc_title{flex:1;min-width:0;font-size:12px;line-height:18px;font-weight:600;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+        '.w2mDc_meta{font-size:11px;color:var(--dsw-alias-label-tertiary)}',
+        '.w2mDc_context{font-size:12px;color:var(--dsw-alias-label-secondary);white-space:pre-wrap;word-break:break-word;max-height:88px;overflow:auto}',
+        '.w2mDc_actions{display:flex;flex-wrap:wrap;gap:6px}',
+        '.w2mDc_advice{font-size:12px;color:var(--dsw-alias-label-secondary);padding:4px 6px;border-left:2px solid var(--dsw-alias-state-business-primary);white-space:pre-wrap}',
         '.w2mGpw{margin-top:6px;padding-top:6px;border-top:.5px solid var(--dsw-alias-border-default);display:flex;flex-direction:column;gap:4px;max-height:320px;overflow:auto}',
         '.w2mGpw_title{font-size:11px;font-weight:600;color:var(--dsw-alias-label-primary)}',
         '.w2mGpw_block{display:flex;flex-direction:column;gap:2px;margin:2px 0 6px}',
@@ -838,6 +846,7 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
               ]),
             ])) : []),
           ]),
+          h(DecisionCenterSection, { key: 'decision-center' }),
           pending.length === 0 ? null : h('div', { key: 'pending', className: 'w2mGpw_block' }, [
             h('div', { key: 'title', className: 'w2mGpw_title' }, t('gpwPending')),
             ...pending.map((item) => h('div', { key: item.id, className: 'w2mGpw_recent' }, [
@@ -855,6 +864,590 @@ const PLUGIN_UPDATE_ROUTE = '/api/w2m/plugin-update';
       ]);
     }
 
+    /**
+     * 决策中心（v3.0.0，移植自 dsh-Fang 的决策收件箱）：GPW 设置页与 GPW 浮标渲染同一个面板。
+     *
+     * 数据面就是本包自己的 `/api/w2m/decisions*`（见 src/decision-center/routes.mjs）：4 秒轮询，
+     * 红票置顶、黄/蓝展开、绿/灰默认折叠；解决/放弃/批量都走服务层，UI 不猜状态。
+     * AI 建议只做「推荐」，不替人做决定。
+     */
+    function DecisionCenterSection() {
+      const LEVELS = [
+        ['red', '紧急决策', '会阻塞 Agent'],
+        ['yellow', '建议决策', '影响方向/进度'],
+        ['blue', '日常建议', '可按推荐处理'],
+        ['green', '通知与汇报', '默认折叠'],
+        ['gray', '已归档 / 过期', '只读'],
+      ];
+      const [state, setState] = React.useState({ status: 'loading', items: [], error: '', busy: '', ai: null, advice: {}, collapsed: { green: true, gray: true }, open: true });
+      const load = React.useCallback(async () => {
+        try {
+          const [listResponse, aiResponse] = await Promise.all([
+            fetch('/api/w2m/decisions?includeArchived=1', { credentials: 'same-origin' }),
+            fetch('/api/w2m/decisions/ai', { credentials: 'same-origin' }).catch(() => null),
+          ]);
+          if (!listResponse.ok) {
+            setState((prev) => ({ ...prev, status: listResponse.status === 404 ? 'absent' : 'error', error: 'HTTP ' + listResponse.status }));
+            return;
+          }
+          const body = await listResponse.json();
+          const aiBody = aiResponse !== null && aiResponse.ok ? await aiResponse.json() : null;
+          setState((prev) => ({
+            ...prev,
+            status: 'ready',
+            items: Array.isArray(body?.items) ? body.items : [],
+            error: '',
+            ai: aiBody,
+          }));
+        } catch (error) {
+          setState((prev) => ({ ...prev, status: 'error', error: String(error?.message ?? error) }));
+        }
+      }, []);
+      React.useEffect(() => {
+        let alive = true;
+        void load();
+        const timer = setInterval(() => { if (alive) void load(); }, 4000);
+        return () => { alive = false; clearInterval(timer); };
+      }, [load]);
+      const post = async (path, body) => {
+        const response = await fetch(path, {
+          method: 'POST',
+          credentials: 'same-origin',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify(body ?? {}),
+        });
+        const payload = await response.json().catch(() => null);
+        if (!response.ok || payload?.ok === false) throw new Error(payload?.error ?? 'HTTP ' + response.status);
+        return payload;
+      };
+      const act = async (kind, ticket, option) => {
+        setState((prev) => ({ ...prev, busy: ticket.id, error: '' }));
+        try {
+          await post('/api/w2m/decisions/' + kind, kind === 'resolve'
+            ? { id: ticket.id, option, by: 'w2m-gpw' }
+            : { id: ticket.id, by: 'w2m-gpw' });
+        } catch (error) {
+          setState((prev) => ({ ...prev, error: String(error?.message ?? error) }));
+        } finally {
+          setState((prev) => ({ ...prev, busy: '' }));
+          await load();
+        }
+      };
+      const advise = async (ticket) => {
+        setState((prev) => ({ ...prev, busy: 'ai:' + ticket.id, error: '' }));
+        try {
+          const payload = await post('/api/w2m/decisions/ai/advise', { id: ticket.id });
+          const text = payload?.advice?.text ?? payload?.advice ?? payload?.ticket?.advice ?? '（无建议文本）';
+          setState((prev) => ({ ...prev, advice: { ...prev.advice, [ticket.id]: typeof text === 'string' ? text : JSON.stringify(text) } }));
+        } catch (error) {
+          setState((prev) => ({ ...prev, error: String(error?.message ?? error) }));
+        } finally {
+          setState((prev) => ({ ...prev, busy: '' }));
+        }
+      };
+      const toggle = (level) => setState((prev) => ({ ...prev, collapsed: { ...prev.collapsed, [level]: !prev.collapsed[level] } }));
+      const pending = state.items.filter((item) => item.status === 'pending');
+      const title = '决策中心' + (pending.length > 0 ? ' · ' + pending.length + ' 待处理' : '');
+      const ticketRow = (ticket) => {
+        const options = Array.isArray(ticket.options) ? ticket.options : [];
+        return h('div', { key: ticket.id, className: 'w2mDc_ticket' }, [
+          h('div', { key: 'head', className: 'w2mDc_head' }, [
+            h('span', { key: 'dot', className: 'w2mGpw_dot', 'data-c': ticket.level ?? 'blue' }),
+            h('span', { key: 'title', className: 'w2mDc_title', title: ticket.title ?? '' }, ticket.title ?? '(未命名)'),
+            h('span', { key: 'meta', className: 'w2mDc_meta' }, (ticket.source?.agentRole ?? ticket.sourceRole ?? '') + (ticket.status !== 'pending' ? ' · ' + ticket.status : '')),
+          ]),
+          ticket.context ? h('div', { key: 'ctx', className: 'w2mDc_context' }, String(ticket.context)) : null,
+          h('div', { key: 'actions', className: 'w2mDc_actions' }, [
+            ...options.slice(0, 4).map((option) => h('button', {
+              key: 'opt:' + option.value,
+              type: 'button',
+              className: 'w2mGpw_btn',
+              disabled: state.busy !== '' || ticket.status !== 'pending',
+              onClick: () => void act('resolve', ticket, option.value),
+            }, option.label ?? option.value)),
+            ticket.status === 'pending' ? h('button', {
+              key: 'ai',
+              type: 'button',
+              className: 'w2mGpw_btn',
+              disabled: state.busy !== '',
+              onClick: () => void advise(ticket),
+            }, 'AI 建议') : null,
+            ticket.status === 'pending' ? h('button', {
+              key: 'abandon',
+              type: 'button',
+              className: 'w2mGpw_btn',
+              disabled: state.busy !== '' || options.length > 0,
+              onClick: () => void act('abandon', ticket),
+            }, '放弃') : null,
+          ]),
+          state.advice[ticket.id] ? h('div', { key: 'advice', className: 'w2mDc_advice' }, state.advice[ticket.id]) : null,
+        ]);
+      };
+      if (state.status === 'absent') {
+        return h('div', { className: 'w2mGpw_block' }, [
+          h('div', { key: 't', className: 'w2mGpw_title' }, '决策中心'),
+          h('div', { key: 'h', className: 'w2mGpw_hint' }, '决策中心插件未启用：在 profile 的 dsh.profile.bundles 或 patch 中启用 @twinsearth/w2m-dsh-plugin/decision-center'),
+        ]);
+      }
+      return h('div', { className: 'w2mGpw_block' }, [
+        h('div', { key: 'head', className: 'w2mGpw_row' }, [
+          h('span', { key: 't', className: 'w2mGpw_title' }, title),
+          h('button', { key: 'toggle', type: 'button', className: 'w2mGpw_btn', onClick: () => setState((prev) => ({ ...prev, open: !prev.open })) }, state.open ? '收起' : '展开'),
+          h('button', { key: 'reload', type: 'button', className: 'w2mGpw_btn', onClick: () => void load() }, '刷新'),
+        ]),
+        state.error !== '' ? h('div', { key: 'error', className: 'w2mGpw_note' }, '决策中心不可用：' + state.error) : null,
+        state.status === 'loading' ? h('div', { key: 'loading', className: 'w2mGpw_hint' }, '正在读取决策队列…') : null,
+        state.open ? h('div', { key: 'levels' }, LEVELS.map(([level, label, hint]) => {
+          const tickets = state.items.filter((item) => (item.level ?? 'blue') === level && (level === 'gray' ? item.status !== 'pending' : true));
+          if (tickets.length === 0) return null;
+          const collapsed = state.collapsed[level] === true;
+          return h('div', { key: level, className: 'w2mDc_level' }, [
+            h('div', { key: 'h', className: 'w2mGpw_row' }, [
+              h('span', { key: 'dot', className: 'w2mGpw_dot', 'data-c': level }),
+              h('span', { key: 'label', className: 'w2mGpw_title' }, label + ' · ' + tickets.length),
+              h('span', { key: 'hint', className: 'w2mGpw_hint' }, hint),
+              h('button', { key: 'fold', type: 'button', className: 'w2mGpw_small', onClick: () => toggle(level) }, collapsed ? '＋' : '－'),
+            ]),
+            collapsed ? null : h('div', { key: 'list', className: 'w2mDc_level' }, tickets.map(ticketRow)),
+          ]);
+        })) : null,
+      ]);
+    }
+
+    /**
+     * 队列日志（v3.1.0，移植自 @twinsearth/dsh-fang-queue-journal 0.1.5）。
+     *
+     * 草稿/队列的持久化镜像是宿主服务 `/api/w2m/composer/journal*`（见 src/queue-journal/index.mjs）；
+     * 恢复必须由用户显式点击，本模块自身从不发送消息。Fang 的独立模块入口在这里展开成同一个客户端
+     * bundle 内的工厂函数，React 与 h 复用外层。
+     */
+    function createQueueJournalModule() {
+
+    const DEBOUNCE_MS = 250
+    const FALLBACK_MS = 15_000
+
+    /** 从 URL 里尝试取会话 id（兼容多种路由形态）。 */
+    function sessionKeyFromUrl() {
+      const hash = String(location.hash || '').replace(/^#/, '')
+      const fromHash = /sessions?\/([^/?#]+)/.exec(hash)
+      const fromPath = /sessions?\/([^/?#]+)/.exec(location.pathname)
+      const q = new URLSearchParams(location.search).get('session') || new URLSearchParams(location.search).get('sessionId')
+      return String(q || fromHash?.[1] || fromPath?.[1] || '').slice(0, 200)
+    }
+
+    /** 从 DOM 上找宿主暴露的会话 id（DSH 可能在容器上打 data 属性）。 */
+    function sessionKeyFromDom() {
+      const selectors = ['[data-session-id]', '[data-sessionid]', '[data-current-session]', '[data-active-session]']
+      for (const selector of selectors) {
+        const el = document.querySelector(selector)
+        const _value = el?.getAttribute(selector.replace(/[[\]]/g, '').split('=')[0]) || ''
+        const attr = selector.slice(1, -1)
+        const v = el?.getAttribute(attr)
+        if (v) return String(v).slice(0, 200)
+      }
+      return ''
+    }
+
+    /** 本页实例键：sessionStorage 里稳定存在，避免多会话挤在同一个 key。 */
+    function instanceKey() {
+      try {
+        const cached = sessionStorage.getItem('fang-queue-journal-instance')
+        if (cached) return cached
+        const generated = 'page:' + Math.random().toString(36).slice(2, 10) + ':' + Date.now().toString(36)
+        sessionStorage.setItem('fang-queue-journal-instance', generated)
+        return generated
+      } catch { return 'page:unknown' }
+    }
+
+    let activeKey = ''
+    let activeSessionId = ''
+    function resolveKey() {
+      // 优先级：slot 给的 SessionId > DOM > URL > 本页实例键（绝不使用 "/"）
+      if (activeSessionId) return activeSessionId
+      const fromUrl = sessionKeyFromUrl()
+      const fromDom = sessionKeyFromDom()
+      const key = String(fromDom || fromUrl || instanceKey())
+      activeKey = key === '/' || key === '' ? instanceKey() : key
+      return activeKey
+    }
+
+    async function fangToken() { return 'w2m-same-origin' }
+
+    async function journalRequest(method, entry, keyOverride) {
+      const token = await fangToken()
+      if (!token) return null
+      const key = keyOverride || resolveKey()
+      const res = await fetch(method === 'POST' ? '/api/w2m/composer/journal' : '/api/w2m/composer/journal?key=' + encodeURIComponent(key), {
+        method,
+        headers: { 'content-type': 'application/json', 'x-fang-auth': token },
+        body: method === 'POST'
+          ? JSON.stringify({ key, sessionId: activeSessionId || undefined, sessionKey: key, path: location.hash || location.pathname, ...entry })
+          : undefined,
+      })
+      if (!res.ok) return null
+      try { return await res.json() } catch { return null }
+    }
+
+    async function journalHistory(limit = 10) {
+      const token = await fangToken()
+      if (!token) return []
+      try {
+        const res = await fetch('/api/w2m/composer/journal/history?limit=' + Number(limit) + '&sessionKey=' + encodeURIComponent(resolveKey()), {
+          headers: { accept: 'application/json', 'x-fang-auth': token },
+        })
+        if (!res.ok) return []
+        const body = await res.json()
+        return Array.isArray(body?.items) ? body.items : []
+      } catch { return [] }
+    }
+
+    async function queueRestore(sessionId, items) {
+      const token = await fangToken()
+      if (!token) return { ok: false, error: 'auth-unavailable' }
+      const res = await fetch('/api/w2m/composer/queue', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', 'x-fang-auth': token },
+        body: JSON.stringify({
+          sessionId,
+          items: items.slice(0, 100).map((item) => ({ text: String(item?.text ?? '').slice(0, 4000) })),
+        }),
+      })
+      let body = null
+      try { body = await res.json() } catch { /* non-json */ }
+      if (!res.ok) return { ok: false, error: body?.error || 'http-' + res.status, detail: body?.detail || '' }
+      return { ok: true, queued: Number(body?.queued) || 0, failed: Number(body?.failed) || 0 }
+    }
+
+    function findComposer() {
+      const nodes = [...document.querySelectorAll('textarea, [contenteditable="true"]')]
+        .filter((el) => {
+          if (el.closest?.('[data-fang-entry]')) return false
+          const r = el.getBoundingClientRect()
+          return r.width > 80 && r.height > 16
+        })
+      return nodes.sort((a, b) => {
+        const ra = a.getBoundingClientRect()
+        const rb = b.getBoundingClientRect()
+        return (rb.width * rb.height) - (ra.width * ra.height)
+      })[0] || null
+    }
+
+    function readComposer(el) {
+      if (!el) return ''
+      return el.tagName === 'TEXTAREA' ? String(el.value || '') : String(el.innerText || '')
+    }
+
+    function writeComposer(text) {
+      const el = findComposer()
+      if (!el) return false
+      el.focus()
+      if (el.tagName === 'TEXTAREA') {
+        const setter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value')?.set
+        if (setter) setter.call(el, text)
+        else el.value = text
+        el.dispatchEvent(new Event('input', { bubbles: true }))
+      } else {
+        try {
+          document.execCommand('selectAll', false, null)
+          document.execCommand('insertText', false, text)
+        } catch { /* fall back */ }
+        if (!String(el.innerText || '').includes(text.slice(0, 20))) {
+          el.textContent = text
+          el.dispatchEvent(new InputEvent('input', { bubbles: true, inputType: 'insertText', data: text }))
+        }
+      }
+      el.focus()
+      return true
+    }
+
+    function setDraftViaApi(props, text) {
+      try {
+        if (props?.inputActions && typeof props.inputActions.setDraft === 'function') {
+          props.inputActions.setDraft(String(text || ''))
+          return true
+        }
+      } catch { /* fall back to the DOM */ }
+      return writeComposer(String(text || ''))
+    }
+
+    const QUEUE_COUNT_RE = /(\d+)\s*(条排队消息|queued messages|件のキュー済みメッセージ|mensagens na fila|messages en file d'attente|nachrichten in der warteschlange|сообщения в очереди|mensajes en cola|mensagens na fila)/i
+    const QUEUE_ACTION_LABELS = /^(插话发送|编辑排队消息|删除排队消息|保存排队消息|取消编辑|发送中…|排队消息图片|queued message image|edit queued message|remove queued message|save queued message|cancel edit|sending…|steer)$/i
+
+    /** 从 QueueDock 行里去掉操作按钮，只留消息正文。 */
+    function queueRowText(row) {
+      try {
+        const clone = row.cloneNode(true)
+        for (const node of clone.querySelectorAll('button, [role="button"]')) node.remove()
+        const lines = String(clone.innerText || clone.textContent || '')
+          .split(/\r?\n/)
+          .map((line) => line.trim())
+          .filter((line) => line && !QUEUE_ACTION_LABELS.test(line))
+        return lines.join(' ').trim()
+      } catch { return '' }
+    }
+
+    /**
+     * DSH QueueDock 的 CSS 是 hashed class（F07MqG_*），不能靠 class*=queue。
+     * 以 header 的“N 条排队消息”文案定位，再通过 aria-controls 找到列表。
+     */
+    function scanQueueDock() {
+      const out = []
+      const seen = new Set()
+      const pushText = (text) => {
+        const value = String(text || '').trim()
+        if (!value || value.length > 4000 || seen.has(value)) return
+        seen.add(value)
+        out.push({ text: value, at: Date.now() })
+      }
+      const docks = document.querySelectorAll('[data-queue-dock]')
+      for (const dock of docks) {
+        for (const row of dock.querySelectorAll('li')) pushText(queueRowText(row))
+      }
+      if (docks.length > 0) return out
+
+      const headers = [...document.querySelectorAll('button[aria-controls], [role="button"][aria-controls]')]
+        .filter((el) => QUEUE_COUNT_RE.test(String(el.textContent || '')))
+      for (const header of headers) {
+        const listId = header.getAttribute('aria-controls')
+        const list = (listId ? document.getElementById(listId) : null) || header.parentElement?.querySelector('ul')
+        if (!list) continue
+        for (const row of list.querySelectorAll('li')) pushText(queueRowText(row))
+      }
+      return out
+    }
+
+    function scanQueue() {
+      const found = scanQueueDock()
+      if (found.length > 0) return found.slice(-100)
+      const seen = new Set()
+      const out = []
+      const nodes = document.querySelectorAll('[class*="queue" i], [data-testid*="queue" i], [aria-label*="queue" i], [class*="pending" i], [data-testid*="pending" i], [aria-label*="排队"], [title*="排队"]')
+      for (const el of nodes) {
+        const text = String(el.innerText || '').trim()
+        if (!text || text.length > 4000 || seen.has(text)) continue
+        seen.add(text)
+        out.push({ text, at: Date.now() })
+      }
+      return out.slice(-100)
+    }
+
+    /** 回读校验：确认服务端存下来的队列文本与本地一致（并检测 "????" 乱码）。 */
+    async function verifySaved(expectedQueue) {
+      const body = await journalRequest('GET')
+      const saved = Array.isArray(body?.entry?.queue) ? body.entry.queue.map((item) => String(item?.text || '')) : []
+      const expected = expectedQueue.map((item) => String(item?.text || ''))
+      const sameLength = saved.length === expected.length
+      const sameText = sameLength && saved.every((text, index) => text === expected[index])
+      const looksMojibake = saved.some((text) => /\?{3,}/.test(text) && !/\?{3,}/.test(expected[saved.indexOf(text)] || ''))
+      return { ok: sameText && !looksMojibake, sameLength, sameText, looksMojibake, saved }
+    }
+
+    function JournalDock(props) {
+      const sessionId = String(props?.sessionId || '')
+      const [entry, setEntry] = React.useState(null)
+      const [history, setHistory] = React.useState([])
+      const [status, setStatus] = React.useState('')
+      const [showQueue, setShowQueue] = React.useState(false)
+      const [showHistory, setShowHistory] = React.useState(false)
+
+      React.useEffect(() => {
+        activeSessionId = sessionId
+        setEntry(null)
+        setShowQueue(false)
+        setShowHistory(false)
+        let alive = true
+        journalRequest('GET').then(async (body) => {
+          if (alive) setEntry(body?.entry ?? null)
+        }).catch(() => {})
+        journalHistory(10).then((items) => { if (alive) setHistory(items) }).catch(() => {})
+        return () => { alive = false }
+      }, [sessionId])
+
+      const queue = Array.isArray(entry?.queue) ? entry.queue : []
+      const hasEntry = Boolean(entry && (entry.draft || queue.length))
+
+      if (!hasEntry && history.length === 0) return null
+
+      const restoreItems = async (items, draft) => {
+        const draftText = String(draft || '')
+        const draftOk = draftText ? setDraftViaApi(props, draftText) : true
+        if (!draftOk) { setStatus('未找到输入框，请先打开会话'); return }
+        if (items.length === 0) {
+          await journalRequest('POST', { draft: '', queue: [] })
+          setEntry(null)
+          setStatus('草稿已放入官方输入框')
+          return
+        }
+        if (!sessionId) { setStatus('草稿已恢复；队列需要先选中会话'); return }
+        const restored = await queueRestore(sessionId, items)
+        if (!restored.ok) {
+          setStatus(restored.error === 'session-not-live'
+            ? '草稿已恢复；会话未运行，队列保留待重试'
+            : '草稿已恢复；队列恢复失败：' + restored.error)
+          return
+        }
+        await journalRequest('POST', { draft: '', queue: [] })
+        setEntry(null)
+        setStatus(`已恢复 ${restored.queued} 条排队消息${restored.failed ? `（${restored.failed} 条失败）` : ''}`)
+      }
+
+      const rowText = (item) => {
+        const text = String(item?.text || '').replace(/\s+/g, ' ').trim()
+        return text.length > 140 ? text.slice(0, 137) + '…' : text
+      }
+
+      const snapshotLabel = (snap) => {
+        const at = String(snap?.updatedAt || '')
+        const count = Array.isArray(snap?.queue) ? snap.queue.length : 0
+        return `${at ? at.replace('T', ' ').slice(0, 16) : '?'} · ${count} 条`
+      }
+
+      return h('div', {
+        'data-fang-entry': 'queue-journal',
+        style: {
+          display: 'inline-flex', flexDirection: 'column', gap: 6, margin: '2px 0', maxWidth: '100%',
+          padding: '3px 6px', border: '1px solid rgba(127,127,127,.3)', borderRadius: 9,
+          fontSize: 12, background: 'rgba(127,127,127,.06)',
+        },
+      },
+      h('div', { style: { display: 'inline-flex', alignItems: 'center', gap: 6 } },
+        hasEntry ? h('button', {
+          type: 'button',
+          title: `恢复草稿${queue.length ? `，并把这 ${queue.length} 条排队消息放回官方输入队列` : ''}`,
+          'aria-label': '恢复全部草稿与队列',
+          onClick: () => { void restoreItems(queue, entry?.draft) },
+          style: { height: 26, padding: '0 8px', borderRadius: 7, cursor: 'pointer' },
+        }, queue.length ? `恢复全部 (${queue.length + (entry?.draft ? 1 : 0)})` : '恢复草稿') : null,
+        hasEntry && queue.length > 0 ? h('button', {
+          type: 'button', title: '展开保存的排队消息列表', 'aria-expanded': showQueue ? 'true' : 'false',
+          onClick: () => setShowQueue((value) => !value),
+          style: { height: 26, padding: '0 8px', borderRadius: 7, cursor: 'pointer' },
+        }, `队列 ${queue.length}`) : null,
+        history.length > 0 ? h('button', {
+          type: 'button', title: '从历史快照中挑选一份恢复（主记录被覆盖时的兜底）',
+          'aria-expanded': showHistory ? 'true' : 'false',
+          onClick: () => setShowHistory((value) => !value),
+          style: { height: 26, padding: '0 8px', borderRadius: 7, cursor: 'pointer' },
+        }, `历史 ${history.length}`) : null,
+        hasEntry ? h('button', {
+          type: 'button', title: '清除本地保存的草稿与排队快照', 'aria-label': '清除草稿',
+          onClick: async () => { await journalRequest('POST', { draft: '', queue: [] }); setEntry(null); setStatus('已清除记录') },
+          style: { height: 26, padding: '0 8px', borderRadius: 7, cursor: 'pointer' },
+        }, '清除') : null,
+      ),
+      showQueue && queue.length > 0 ? h('div', {
+        role: 'list', style: { display: 'grid', gap: 4, maxHeight: 180, overflow: 'auto', padding: '2px 0' },
+      }, ...queue.map((item, index) => h('div', {
+        role: 'listitem', key: `${index}:${item?.at || ''}`, title: String(item?.text || ''),
+        style: { padding: '3px 6px', border: '1px solid rgba(127,127,127,.22)', borderRadius: 6, whiteSpace: 'nowrap', overflow: 'hidden', textOverflow: 'ellipsis' },
+      }, `${index + 1}. ${rowText(item)}`))) : null,
+      showHistory && history.length > 0 ? h('div', {
+        role: 'list', style: { display: 'grid', gap: 4, maxHeight: 200, overflow: 'auto', padding: '2px 0' },
+      }, ...history.slice(0, 10).map((snap, index) => h('div', {
+        role: 'listitem', key: `h${index}:${snap?.updatedAt || ''}`,
+        style: { display: 'flex', alignItems: 'center', gap: 6, padding: '3px 6px', border: '1px solid rgba(127,127,127,.22)', borderRadius: 6 },
+      }, h('span', { style: { flex: 1, whiteSpace: 'nowrap', overflow: 'hidden', textOverflow: 'ellipsis' } }, snapshotLabel(snap)),
+      h('button', {
+        type: 'button', title: '把这份快照里的队列放回官方队列',
+        onClick: async () => { await restoreItems(Array.isArray(snap?.queue) ? snap.queue : [], '') },
+        style: { height: 22, padding: '0 6px', borderRadius: 6, cursor: 'pointer' },
+      }, '恢复')))) : null,
+      h('span', {
+        role: 'status', 'aria-live': 'polite',
+        style: status ? { padding: '1px 2px', opacity: .8 } : { position: 'absolute', width: 1, height: 1, overflow: 'hidden', clip: 'rect(0 0 0 0)', whiteSpace: 'nowrap' },
+      }, status))
+    }
+
+    let saveTimer = null
+    let lastSignature = ''
+    let flushTimer = null
+
+    function commitSave() {
+      const text = readComposer(findComposer())
+      const queue = scanQueue()
+      const signature = JSON.stringify({ key: resolveKey(), text, queue: queue.map((item) => item.text) })
+      if (signature === lastSignature) return
+      lastSignature = signature
+      void (async () => {
+        const saved = await journalRequest('POST', { draft: text, queue })
+        if (!saved) return
+        const check = await verifySaved(queue)
+        if (!check.ok) {
+          // 回读不一致（或被截断/乱码）：重试一次，并把诊断留在控制台
+          try { window.console?.warn?.('[fang-queue-journal] 回读校验未通过', check) } catch { /* ignore */ }
+          const retried = await journalRequest('POST', { draft: text, queue })
+          if (retried) await verifySaved(queue)
+        }
+      })()
+    }
+
+    function scheduleSave() {
+      if (saveTimer) clearTimeout(saveTimer)
+      saveTimer = setTimeout(() => { saveTimer = null; commitSave() }, DEBOUNCE_MS)
+    }
+
+    /** 关闭/切页前同步 flush：fetch keepalive 保证请求活着离开页面。 */
+    function flushNow() {
+      const text = readComposer(findComposer())
+      const queue = scanQueue()
+      const signature = JSON.stringify({ key: resolveKey(), text, queue: queue.map((item) => item.text) })
+      if (signature === lastSignature) return
+      lastSignature = signature
+      void (async () => {
+        const token = await fangToken()
+        if (!token) return
+        try {
+          fetch('/api/w2m/composer/journal', {
+            method: 'POST',
+            keepalive: true,
+            headers: { 'content-type': 'application/json', 'x-fang-auth': token },
+            body: JSON.stringify({ key: resolveKey(), sessionKey: resolveKey(), sessionId: activeSessionId || undefined, draft: text, queue, path: location.hash || location.pathname }),
+          })
+        } catch { /* ignore */ }
+      })()
+    }
+
+    return {
+      inject: ['slots'],
+      apply(ctx) {
+        ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
+          name: 'conversation.composer.dock',
+          id: 'fang-queue-journal',
+          order: 90,
+        }, JournalDock))
+
+        // ① 草稿输入：捕获阶段监听，避免被宿主 stopPropagation 吞掉
+        document.addEventListener('input', (event) => {
+          const target = event.target
+          if (!target || (target.tagName !== 'TEXTAREA' && target.getAttribute?.('contenteditable') !== 'true')) return
+          scheduleSave()
+        }, true)
+
+        // ② 队列变化：只盯 QueueDock（body 全量只用 childList，避免 characterData 风暴）
+        try {
+          const queueObserver = new MutationObserver(() => scheduleSave())
+          queueObserver.observe(document.body, { childList: true, subtree: true })
+          // 有 [data-queue-dock] 时再额外盯 characterData（行文本可能原地更新）
+          const docksObserver = new MutationObserver(() => scheduleSave())
+          for (const dock of document.querySelectorAll('[data-queue-dock]')) {
+            docksObserver.observe(dock, { childList: true, subtree: true, characterData: true })
+          }
+          queueObserver.__docksObserver = docksObserver
+        } catch { /* DOM unavailable */ }
+
+        // ③ 15s 兜底（覆盖“宿主重渲染后新 dock 未被观察到”的情况）
+        flushTimer = setInterval(() => scheduleSave(), FALLBACK_MS)
+        try { flushTimer?.unref?.() } catch { /* browser timer */ }
+
+        // ④ 关闭/切页前 flush
+        const onPageHide = () => flushNow()
+        const onVisibility = () => { if (document.visibilityState === 'hidden') flushNow() }
+        window.addEventListener('pagehide', onPageHide)
+        document.addEventListener('visibilitychange', onVisibility)
+        window.addEventListener('beforeunload', onPageHide)
+      },
+    }
+    }
     /** v1.9.4: the left sidebar entry: globe + GPW, between Plugins and Automation. */
     function GpwSidebarIcon() {
       return h('button', {
@@ -3352,6 +3945,16 @@ const CHAT_EMOJIS = CHAT_COMMANDS;
 
 
 
+      // v3.1.0: 队列日志（移植自 @twinsearth/dsh-fang-queue-journal）：把草稿与队列镜像存到
+      // /api/w2m/composer/journal*，恢复只由用户点击触发。
+      try {
+        if (typeof document !== 'undefined' && ctx !== null && typeof ctx === 'object' && ctx.slots !== undefined) {
+          createQueueJournalModule().apply({ slots: ctx.slots });
+        }
+      } catch (error) {
+        console.error('@twinsearth/w2m-dsh-plugin: the queue journal was not mounted; the rest of the page is unaffected', error);
+      }
+
       // v1.9.9: in-conversation search, in the session header next to Pin.
       try {
         slots.inject('conversation.session.header.actions', () => slots.register({

package/lib/decision-center.js

@@ -0,0 +1,11 @@
+/**
+ * Package-facing entry for W2M's decision center: `@twinsearth/w2m-dsh-plugin/decision-center`.
+ *
+ * The documented subpath a profile row names to mount the center. A seam, not a second
+ * implementation -- the code lives in `src/decision-center/`, and `mount.mjs` is where the ported
+ * plugin module and its HTTP routes become one mountable unit.
+ *
+ * Like GPW, it is deliberately **not** re-exported from `lib/index.js`: the package root installs by
+ * default, and a human-attention queue must not arrive because someone installed a fleet tool.
+ */
+export { apply, inject, name, Config, _internals } from '../src/decision-center/mount.mjs';

package/lib/queue-journal.js

@@ -0,0 +1,15 @@
+/**
+ * Package-facing entry for W2M's queue journal: `@twinsearth/w2m-dsh-plugin/queue-journal`.
+ *
+ * The documented subpath a profile row names to enable draft/queue persistence. The host logic is
+ * `src/queue-journal/index.mjs`; the composer UI ships in the package's one client bundle
+ * (`lib/client.js`), the same shape GPW and the decision center use.
+ */
+export {
+  apply,
+  inject,
+  name,
+  QUEUE_JOURNAL_ROUTE_PREFIX,
+  QUEUE_JOURNAL_SERVICE,
+  QUEUE_RESTORE_ROUTE_PATH,
+} from '../src/queue-journal/index.mjs';