@clowder-ai/companion 0.1.0-alpha.2 → 0.1.0-alpha.20

package/renderer/conversation.mjs

@@ -7,66 +7,167 @@ export class CompanionConversation {
     this.active = false;
     this.generation = 0;
     this.phase = 'idle';
+    this.audioMode = null;
+    this.retryMode = null;
     this.muted = false;
     this.silent = false;
+    this.failed = false;
+    this.recovering = false;
+    this.retiredCallId = null;
   }
   show(message) {
     this.message = message;
-    this.render({ phase: this.phase, identity: this.identity, muted: this.muted, silent: this.silent, message });
+    this.render({ phase: this.phase, identity: this.identity, audioMode: this.audioMode, retryMode: this.retryMode,
+      muted: this.muted, silent: this.silent, failed: this.failed, recovering: this.recovering,
+      callId: this.callId, message });
   }
   current(generation) { return this.active && generation === this.generation; }
-  listening() { return this.muted ? '麦克风已静音' : '正在听，直接说话就好'; }
-  async begin() {
+  listening() {
+    if (this.audioMode === 'receive_only') return '只听模式 · 麦克风未启用';
+    return this.muted ? '麦克风已静音' : '正在听，直接说话就好';
+  }
+  retrying(prefix) {
+    return this.audioMode === 'receive_only'
+      ? `${prefix} · 麦克风未启用，点击只听重试`
+      : `${prefix} · 点击语音通话重试`;
+  }
+  stoppedMessage() {
+    return this.audioMode === 'receive_only'
+      ? '只听已结束 · 麦克风未启用'
+      : '语音通话已结束 · 麦克风已关闭';
+  }
+  expectHostStop() {
+    if (!this.active) return false;
+    this.expectedHostStop = { generation: this.generation, pending: true };
+    return true;
+  }
+  async settleExpectedHostStop(callStopped) {
+    const expected = this.expectedHostStop;
+    if (!expected || expected.generation !== this.generation) return;
+    if (callStopped === false) {
+      this.expectedHostStop = undefined;
+      return;
+    }
+    if (callStopped === null) {
+      expected.pending = false;
+      return;
+    }
+    this.expectedHostStop = undefined;
+    if (!this.active) return;
+    this.failed = false;
+    await this.releaseLocal(this.stoppedMessage());
+  }
+  async begin(mode = 'duplex') {
     if (this.active || this.stopping || this.changingDocuments) return;
+    if (mode === 'receive_only' && !this.identity?.audio?.supportedModes?.includes(mode)) return;
+    if (!['duplex', 'receive_only'].includes(mode)) return;
     this.active = true;
+    this.audioMode = mode;
+    this.retryMode = null;
+    this.failed = false;
+    this.recovering = false;
     this.phase = 'connecting';
+    this.callId = null;
+    this.expectedHostStop = undefined;
     const generation = ++this.generation;
     // Must reach the isolated preload while the click still has user activation.
     const preparation = this.client.prepare();
     this.show('正在连接…');
-    this.deadline = setTimeout(() => { if (this.current(generation)) void this.end('连接超时 · 点击开始聊天重试'); }, 60_000);
+    this.deadline = setTimeout(() => { if (this.current(generation)) void this.end(this.retrying('连接超时'), true); }, 60_000);
     try {
       const peer = this.createPeer(event => {
         if (!this.current(generation)) return;
-        if (event.type === 'connected') { clearTimeout(this.deadline); this.phase = 'talking'; this.show(this.listening()); }
-        if (event.type === 'recovering') this.show('连接暂时中断 · 正在等待恢复');
-        if (event.type === 'recovered') this.show(this.listening());
+        if (event.type === 'error' && !this.callId && event.callId === this.retiredCallId) return;
+        if (event.type === 'connected') {
+          if (this.callId && this.callId !== event.callId) return;
+          this.callId = event.callId;
+          this.recovering = false;
+          clearTimeout(this.deadline); this.phase = 'talking'; this.show(this.listening());
+        }
+        if (event.type === 'error' && (!event.callId || !this.callId || event.callId === this.callId)) {
+          void this.end(explainError(event), true);
+          return;
+        }
+        if (!this.callId || event.callId !== this.callId) return;
+        if (event.type === 'recovering') {
+          this.recovering = true;
+          this.show('恢复后通话继续，无需重新连接');
+        }
+        if (event.type === 'recovered') {
+          this.recovering = false;
+          this.show(this.listening());
+        }
         if (event.type === 'transcript' || event.type === 'turn-done') this.transcript(event);
-        if (event.type === 'error') void this.end(explainError(event));
       });
       this.peer = peer;
-      peer.muteMic(this.muted); peer.muteSpeaker(this.silent);
+      if (mode === 'duplex') peer.muteMic(this.muted);
+      peer.muteSpeaker(this.silent);
       // Submit capture intent while this same click is active. The Host waits
       // for its matching preparation before creating the media document.
-      const [identity] = await Promise.all([preparation, peer.connect()]);
+      const [identity] = await Promise.all([preparation, peer.connect(mode === 'receive_only' ? mode : undefined)]);
       if (!this.current(generation)) { await peer.close(); return; }
       if (identity.phase !== 'ready') throw { code: 'unavailable' };
+      if (mode === 'receive_only' && !identity.audio?.supportedModes?.includes(mode)) throw { code: 'unavailable' };
       this.identity = identity;
       this.show(this.message);
     } catch (error) {
-      if (this.current(generation)) await this.end(explainError(error));
+      if (this.current(generation)) await this.end(explainError(error), true);
     }
   }
   async releaseLocal(message) {
     this.active = false;
+    this.expectedHostStop = undefined;
+    if (this.callId) this.retiredCallId = this.callId;
     ++this.generation;
     this.pendingText = undefined;
     clearTimeout(this.deadline);
     const peer = this.peer;
     this.peer = undefined;
+    const releasedMode = this.audioMode;
+    this.audioMode = null;
+    this.retryMode = this.failed ? releasedMode : null;
     this.phase = 'idle';
+    this.recovering = false;
+    this.callId = null;
     this.show(message);
     await Promise.allSettled([peer?.close(), this.stopScreen()]);
   }
-  async end(message = '语音已结束 · 麦克风已关闭') {
+  async end(message, failed = false) {
     if (this.stopping) return this.stopping;
+    const receiveOnly = this.audioMode === 'receive_only';
+    message ??= this.stoppedMessage();
+    this.failed = failed;
     const local = this.releaseLocal(message);
     const operation = Promise.all([local, this.client.stop()]);
     this.stopping = operation;
     try { await operation; }
-    catch { this.show('麦克风已关闭 · 连接收尾尚未确认'); }
+    catch { this.show(receiveOnly ? '麦克风未启用 · 连接收尾尚未确认' : '麦克风已关闭 · 连接收尾尚未确认'); }
     finally { if (this.stopping === operation) this.stopping = undefined; }
   }
+  async hostStopped(reason) {
+    // Stop echoes must not erase a more useful local failure or manual ending.
+    if (!this.active) return;
+    if (reason === 'revoked' && this.expectedHostStop?.generation === this.generation) {
+      this.expectedHostStop = undefined;
+      this.failed = false;
+      await this.releaseLocal(this.stoppedMessage());
+      return;
+    }
+    const receiveOnly = this.audioMode === 'receive_only';
+    const messages = receiveOnly ? {
+      locked: '屏幕已锁定 · 只听已停止，解锁后可点击只听继续',
+      suspended: '电脑已休眠 · 只听已停止，可点击只听继续',
+      hidden: '猫猫已收起 · 只听已停止',
+    } : {
+      locked: '屏幕已锁定 · 语音通话已停止，解锁后可点击语音通话继续',
+      suspended: '电脑已休眠 · 语音通话已停止，可点击语音通话继续',
+      hidden: '猫猫已收起 · 语音通话已停止',
+    };
+    this.failed = !Object.hasOwn(messages, reason);
+    await this.releaseLocal(messages[reason] ?? (receiveOnly
+      ? '只听连接已中断 · 麦克风未启用，点击只听重试'
+      : '语音通话已中断 · 麦克风已关闭，点击语音通话重试'));
+  }
   async refresh() {
     if (this.refreshing) return;
     this.refreshing = true;
@@ -75,12 +176,21 @@ export class CompanionConversation {
       const identity = await this.client.state();
       if (generation !== this.generation) return;
       this.identity = identity;
+      if (this.active && identity.audio?.activeMode) this.audioMode = identity.audio.activeMode;
       if (this.active && ['closed', 'failed', 'idle'].includes(identity.phase)) {
-        await this.end('连接已结束 · 点击开始聊天继续');
-      } else this.show(this.message ?? '点开始聊天，直接对我说话');
+        if (this.expectedHostStop?.generation === this.generation) {
+          this.expectedHostStop = undefined;
+          this.failed = false;
+          await this.releaseLocal(this.stoppedMessage());
+        } else await this.end(this.retrying('语音连接已中断'), true);
+      } else {
+        if (this.expectedHostStop?.generation === this.generation && !this.expectedHostStop.pending)
+          this.expectedHostStop = undefined;
+        this.show(this.message ?? '点击语音通话，直接对我说话');
+      }
     } catch (error) {
       if (generation === this.generation) {
-        if (this.active) await this.end(explainError(error));
+        if (this.active) await this.end(explainError(error), true);
         else this.show(explainError(error));
       }
     } finally { this.refreshing = false; }
@@ -95,29 +205,39 @@ export class CompanionConversation {
       const identity = await changing;
       await local;
       this.identity = identity;
-      this.show(allowed ? '资料查询已开启 · 点击开始聊天继续' : '资料查询已暂停 · 点击开始聊天继续');
+      this.show(allowed ? '资料查询已开启 · 点击语音通话继续' : '资料查询已暂停 · 点击语音通话继续');
     } catch (error) { this.show(explainError(error)); }
     finally { this.changingDocuments = false; }
   }
   async send(text) {
     text = text.trim();
-    if (!text || !this.active || this.phase !== 'talking' || this.sending) return false;
+    if (!text || !this.identity || this.phase === 'connecting' || this.stopping || this.sending) return false;
     if (!this.pendingText || this.pendingText.text !== text) this.pendingText = { text, id: this.uuid() };
     const input = this.pendingText;
     const generation = this.generation;
     this.sending = true;
     try {
-      await this.client.text(input.text, input.id);
+      const receipt = await this.client.text(input.text, input.id);
+      if (receipt?.delivery !== 'accepted') {
+        if (generation === this.generation) this.show(explainError({ code: 'unconfirmed' }));
+        return false;
+      }
       if (this.pendingText === input) this.pendingText = undefined;
-      if (!this.current(generation)) return false;
-      this.transcript({ type: 'transcript', role: 'user', text, typed: true });
-      this.show(this.listening());
+      // Voice may have ended; an accepted message still retires this draft.
+      // Keep the newer voice status rather than announcing that we are listening.
+      if (generation !== this.generation) return true;
+      this.transcript({ type: 'typed', role: 'user', text, receipt });
+      this.show(this.active ? this.listening() : '已发送 · 回答会留在同一段聊天中');
       return true;
     } catch (error) {
-      if (this.current(generation)) this.show(explainError(error));
+      if (generation === this.generation) this.show(explainError(error));
       return false;
     } finally { this.sending = false; }
   }
-  muteMic() { this.muted = !this.muted; this.peer?.muteMic(this.muted); this.show(this.phase === 'talking' ? this.listening() : this.message); }
+  muteMic() {
+    if (this.audioMode === 'receive_only') return;
+    this.muted = !this.muted; this.peer?.muteMic(this.muted);
+    this.show(this.phase === 'talking' ? this.listening() : this.message);
+  }
   muteSpeaker() { this.silent = !this.silent; this.peer?.muteSpeaker(this.silent); this.show(this.message); }
 }

package/renderer/decision-view.mjs

@@ -0,0 +1,124 @@
+function unified(page) {
+  return page?.version === 1 && Array.isArray(page.items);
+}
+
+function knownRows(page) {
+  if (unified(page)) return page.items.length;
+  return (page?.approvals?.length ?? 0) + (page?.otherNeedsMe?.length ?? 0);
+}
+
+function authenticationRequired(page) {
+  if (!unified(page)) return false;
+  const sources = Object.values(page.sources ?? {});
+  return sources.length > 0 && sources.every(source => source.status === 'unauthenticated');
+}
+
+/** Exact totals exist only on a complete, consistent unified read. Legacy pages never invent a sum. */
+export function decisionBadge(page) {
+  if (!page) return { visible: true, label: '?', title: '待办暂不可读', state: 'unavailable' };
+  if (unified(page)) {
+    if (page.status === 'partial') {
+      return { visible: true, label: page.items.length > 0 ? '•' : '!', title: '仅部分读取', state: 'partial' };
+    }
+    if (page.status === 'unavailable') {
+      return authenticationRequired(page)
+        ? { visible: true, label: '!', title: '需要登录', state: 'authentication' }
+        : { visible: true, label: '!', title: '待办暂不可读', state: 'unavailable' };
+    }
+    if (Number.isInteger(page.totalCount)) {
+      return page.totalCount === 0
+        ? { visible: false, label: '0', title: '暂无待办', state: 'empty' }
+        : { visible: true, label: String(page.totalCount), title: `待办 · ${page.totalCount} 件`, state: 'available' };
+    }
+    return { visible: true, label: page.items.length > 0 ? '•' : '!', title: '数量未确认', state: 'uncertain' };
+  }
+  if (page.status !== 'available')
+    return { visible: true, label: '?', title: '待办暂不可读', state: 'unavailable' };
+  const hasKnownRows = knownRows(page) > 0
+    || page.approvalCount > 0 || page.needsMeCount > 0 || page.otherNeedsMeCount > 0;
+  if (hasKnownRows) return { visible: true, label: '有待办', title: '有待办', state: 'available' };
+  return { visible: false, label: '0', title: '现在没有待办', state: 'empty' };
+}
+
+function approvalMeta(approval) {
+  const state = {
+    open: '待你决定', accepted: '已接纳 · 待核结果', rejected: '已拒绝',
+    closed_without_decision: '已关闭',
+  };
+  const materialization = approval.materializationState === 'outcome_unknown' ? '结果未知'
+    : approval.materializationState === 'failed' ? '执行失败'
+      : approval.linkedNeedsMe ? '已关联待办' : '原处卡片';
+  return `审批 · ${state[approval.resolution] ?? '状态待核'} · ${materialization}`;
+}
+
+function navigation(item) {
+  const priorities = item.kind === 'approval'
+    ? [['approval_card', '打开审批'], ['action', '打开处理入口'], ['origin', '打开原处']]
+    : [['action', '打开处理入口'], ['origin', '打开原处'], ['approval_card', '打开审批']];
+  const selected = priorities.find(([target]) => item.navigation.targets.includes(target));
+  return selected ? { variantRef: item.variantRef, target: selected[0], label: selected[1] } : undefined;
+}
+
+export function decisionRows(page) {
+  if (unified(page)) {
+    if (page.status === 'unavailable') return [];
+    return page.items.map(item => ({
+      title: item.summary || '待处理事项',
+      meta: item.kind === 'approval' ? approvalMeta(item.approval)
+        : item.kind === 'judgment' ? '等你判断 · 请在原处处理' : '需要修复 · 请在原处处理',
+      variantRef: item.variantRef,
+      navigation: navigation(item),
+      previewable: false,
+    }));
+  }
+  if (!page || page.status !== 'available') return [];
+  return [
+    ...(page.approvals ?? []).map(item => ({
+      title: item.summary || '待决策事项',
+      meta: approvalMeta(item),
+      proposalId: item.proposalId,
+      previewable: item.sourceFeatureId === 'F221'
+        && /^[A-Za-z0-9_-]{1,200}$/.test(item.proposalId)
+        && item.resolution === 'open' && item.materializationState === 'not_started',
+    })),
+    ...(page.otherNeedsMe ?? []).map(item => ({ title: item.summary || '待处理事项', meta: '其他待处理 · 请向猫猫询问详情' })),
+  ];
+}
+
+export function decisionPresentation(page) {
+  const badge = decisionBadge(page);
+  if (!page) return { badge, message: '待办暂不可读 · 请稍后刷新', reloadLabel: '重试', pending: null, hasMore: false, renderRows: false };
+  if (unified(page)) {
+    const pending = Number.isInteger(page.totalCount) ? page.totalCount > 0 : page.items.length > 0 ? true : null;
+    if (page.status === 'partial') return {
+      badge, message: '仅部分读取 · 其余待办未能读取', reloadLabel: '重试', pending,
+      hasMore: page.page.hasMore, renderRows: true,
+    };
+    if (page.status === 'unavailable') return {
+      badge, message: authenticationRequired(page) ? '待办需要登录 · 请登录后重试' : '待办暂不可读 · 请稍后重试',
+      reloadLabel: '重试', pending: null, hasMore: false, renderRows: false,
+    };
+    if (page.totalCount === 0) return {
+      badge, message: '暂无待办', reloadLabel: '刷新', pending: false,
+      hasMore: page.page.hasMore, renderRows: true,
+    };
+    return {
+      badge,
+      message: Number.isInteger(page.totalCount)
+        ? `已读取 ${page.totalCount} 件待办`
+        : '已显示读取到的待办 · 数量未确认',
+      reloadLabel: '刷新', pending,
+      hasMore: page.page.hasMore, renderRows: true,
+    };
+  }
+  if (page.status !== 'available') return {
+    badge, message: '待办暂不可读 · 请稍后刷新', reloadLabel: '重试', pending: null, hasMore: false, renderRows: false,
+  };
+  return {
+    badge,
+    message: badge.state === 'empty' ? '现在没有待你处理的事项' : '已显示读取到的待办 · 暂无总数',
+    reloadLabel: '刷新', pending: badge.state === 'empty' ? false : true,
+    hasMore: page.page.hasMoreApprovals || page.page.hasMoreNeedsMe,
+    renderRows: true,
+  };
+}

package/renderer/errors.mjs

@@ -1,8 +1,8 @@
 const messages = {
-  permission_required: '请点击开始聊天，或在系统提示中允许本次使用',
-  session_required: '连接已结束 · 点击开始聊天继续',
-  busy: '上一段交流正在收尾 · 稍后再开始',
-  selection_changed: '猫猫球的选择已更新 · 点击开始聊天继续',
+  permission_required: '请点击语音通话，或在系统提示中允许本次使用',
+  session_required: '连接已结束 · 点击语音通话继续',
+  busy: '会话暂时被占用，请稍后重试',
+  selection_changed: '猫猫球的选择已更新 · 点击语音通话继续',
   carrier_unavailable: '实时语音暂不可用 · 可以打开聊天继续交流',
   cancelled: '操作已取消',
   unconfirmed: '发送尚未确认 · 文字已保留，可检查聊天记录后重试',

package/renderer/index.html

@@ -1,31 +1,173 @@
 <!doctype html>
 <html lang="zh-CN">
-<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-<title>猫猫球</title><link rel="stylesheet" href="./theme.css"><link rel="stylesheet" href="./style.css"></head>
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>猫猫球</title><link rel="stylesheet" href="./style.css"></head>
 <body>
-  <section id="details" hidden>
-    <header><strong id="chat-name">猫猫</strong><span>本次交流</span><button type="button" id="collapse" aria-label="收起文字">收起 ⌄</button></header>
-    <div id="transcript" role="log" aria-live="polite"><p class="empty">可以直接说，也可以写一句。</p></div>
-    <form id="compose"><input id="message" aria-label="给猫猫写一句" placeholder="写一句…" maxlength="8000"><button type="submit" aria-label="发送">↑</button></form>
-  </section>
-  <div id="pet" aria-label="猫猫，拖动可以移动" role="img"></div>
-  <section id="dock" aria-label="和猫猫交流">
-  <p id="identity">猫猫球</p>
-  <div class="voice-state"><div id="orb" aria-hidden="true"></div><p id="status" role="status">点开始聊天，直接对我说话</p></div>
-  <div id="idle"><button type="button" id="begin" disabled>开始聊天</button></div>
-  <div id="controls" hidden>
-    <button type="button" id="mic" aria-label="关闭麦克风" title="关闭麦克风"><svg aria-hidden="true" viewBox="0 0 24 24"><rect x="9" y="3" width="6" height="12" rx="3"/><path d="M5 11a7 7 0 0 0 14 0M12 18v4M8 22h8"/></svg><span>静音</span></button>
-    <button type="button" id="speaker" aria-label="关闭播音" title="关闭播音"><svg aria-hidden="true" viewBox="0 0 24 24"><path d="m11 4-6 5H2v6h3l6 5zM15 8a6 6 0 0 1 0 8M18 4a11 11 0 0 1 0 16"/></svg><span>关声音</span></button>
-    <button type="button" id="write" aria-label="展开文字交流" aria-expanded="false" title="写一句 / 看文字"><svg aria-hidden="true" viewBox="0 0 24 24"><path d="M13 5H6a2 2 0 0 0-2 2v11a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2v-7M15 4l5 5M9 15l1-5 8-8 4 4-8 8z"/></svg><span>文字</span></button>
-    <button type="button" id="end" aria-label="结束语音" title="结束本次通话"><svg aria-hidden="true" viewBox="0 0 24 24"><path d="m7 7 10 10M7 17 17 7"/></svg><span>结束</span></button>
-  </div>
-  <div id="access">
-    <button type="button" id="history">打开聊天</button>
-    <button type="button" id="share" hidden title="选择窗口或屏幕后共享给当前模型；不共享系统声音">共享屏幕</button>
-    <button type="button" id="documents" title="资料查询设置；不包含屏幕共享">资料查询</button>
-  </div>
-  <p id="screen-status" role="status" hidden></p>
-  <p id="connection-scope"></p>
-  </section>
+  <svg class="icon-definitions" aria-hidden="true">
+    <symbol id="i-mic" viewBox="0 0 24 24"><rect x="9" y="3" width="6" height="12" rx="3"/><path d="M5 11a7 7 0 0 0 14 0M12 18v3M8 21h8"/></symbol>
+    <symbol id="i-mic-off" viewBox="0 0 24 24"><path d="M9 9v2a3 3 0 0 0 4.8 2.4M15 10V6a3 3 0 0 0-5.7-1.3M5 11a7 7 0 0 0 11.2 5.6M19 11a7 7 0 0 1-.7 3M12 18v3M8 21h8M3 3l18 18"/></symbol>
+    <symbol id="i-listen" viewBox="0 0 24 24"><path d="M4 13v-1a8 8 0 0 1 16 0v1M4 13h3v7H6a2 2 0 0 1-2-2v-5ZM20 13h-3v7h1a2 2 0 0 0 2-2v-5Z"/></symbol>
+    <symbol id="i-keyboard" viewBox="0 0 24 24"><rect x="2.5" y="5" width="19" height="14" rx="3"/><path d="M6 9h.01M10 9h.01M14 9h.01M18 9h.01M6 12h.01M10 12h.01M14 12h.01M18 12h.01M7 15h10"/></symbol>
+    <symbol id="i-history" viewBox="0 0 24 24"><path d="M3 11a9 9 0 1 1 2.6 7.4M3 4v7h7M12 7v5l3 2"/></symbol>
+    <symbol id="i-screen" viewBox="0 0 24 24"><rect x="3" y="4" width="18" height="13" rx="2.5"/><path d="M8 21h8M12 17v4"/></symbol>
+    <symbol id="i-book" viewBox="0 0 24 24"><path d="M12 6c-3-2-6-2-9-1v14c3-1 6-1 9 1 3-2 6-2 9-1V5c-3-1-6-1-9 1v14"/></symbol>
+    <symbol id="i-moon" viewBox="0 0 24 24"><path d="M20.5 14A8.5 8.5 0 0 1 10 3.5 8.5 8.5 0 1 0 20.5 14Z"/></symbol>
+    <symbol id="i-end" viewBox="0 0 24 24"><rect x="6" y="6" width="12" height="12" rx="3"/></symbol>
+    <symbol id="i-subtitles" viewBox="0 0 24 24"><rect x="2.5" y="4.5" width="19" height="15" rx="3"/><path d="M6 10h5M6 14h7M15 10h3M15 14h3"/></symbol>
+    <symbol id="i-expand" viewBox="0 0 24 24"><path d="M8 3H3v5M16 3h5v5M8 21H3v-5M16 21h5v-5"/></symbol>
+  </svg>
+  <main id="desktop" aria-label="猫猫球">
+    <div id="anchor">
+      <button id="pet" aria-label="猫猫：点击或右键打开名片，拖动移动" aria-expanded="false" aria-controls="actions menu chat transcript settings decisions">
+        <svg id="living-sit" viewBox="0 0 600 600" aria-hidden="true" hidden>
+          <defs>
+            <mask id="living-eye-left" maskUnits="userSpaceOnUse" x="0" y="0" width="600" height="600"><image href="./skins/xianxian-living/layers/whiteL.webp" width="600" height="600"/></mask>
+            <mask id="living-eye-right" maskUnits="userSpaceOnUse" x="0" y="0" width="600" height="600"><image href="./skins/xianxian-living/layers/whiteR.webp" width="600" height="600"/></mask>
+          </defs>
+          <g data-layer="tail"><image href="./skins/xianxian-living/layers/tail.webp" width="600" height="600"/></g>
+          <image href="./skins/xianxian-living/layers/body.webp" width="600" height="600"/>
+          <g data-layer="head">
+            <g data-layer="ear-left"><image href="./skins/xianxian-living/layers/earL.webp" width="600" height="600"/></g>
+            <g data-layer="ear-right"><image href="./skins/xianxian-living/layers/earR.webp" width="600" height="600"/></g>
+            <image href="./skins/xianxian-living/layers/head.webp" width="600" height="600"/>
+            <g mask="url(#living-eye-left)"><image data-layer="iris-left" href="./skins/xianxian-living/layers/irisL.webp" width="600" height="600"/></g>
+            <g mask="url(#living-eye-right)"><image data-layer="iris-right" href="./skins/xianxian-living/layers/irisR.webp" width="600" height="600"/></g>
+            <image data-layer="closed" href="./skins/xianxian-living/layers/closed.webp" width="600" height="600"/>
+            <image data-layer="mouth" href="./skins/xianxian-living/layers/mouth.webp" width="600" height="600"/>
+            <image data-layer="scared" href="./skins/xianxian-living/layers/scared.webp" width="600" height="600"/>
+          </g>
+        </svg>
+        <video id="living-video" muted playsinline preload="metadata" aria-hidden="true" hidden></video>
+        <video id="living-video-transition" muted playsinline preload="metadata" aria-hidden="true" hidden></video>
+      </button>
+      <div id="indicators">
+        <button id="share-badge" hidden aria-label="停止共享" title="停止共享"><svg viewBox="0 0 24 24" aria-hidden="true"><rect x="3" y="4" width="18" height="13" rx="2"/><path d="M8 21h8M12 17v4"/></svg></button>
+        <button id="pending-badge" hidden aria-label="查看待决事项" title="查看待决事项"><span id="pending-count">?</span></button>
+      </div>
+    </div>
+    <section id="bubble" class="floating" aria-label="最新消息" hidden>
+      <p id="bubble-first" hidden></p><p id="bubble-second" hidden></p>
+    </section>
+    <section id="actions" class="floating call-bar" aria-label="当前通话" hidden>
+      <div class="call-status-line"><span class="status-dot" aria-hidden="true"></span><strong id="call-state">通话中</strong><span id="call-mic-state">麦克风已开启</span></div>
+      <p id="call-work" class="call-work" hidden></p>
+      <div id="call-share-context" class="call-share-context" hidden><svg class="icon" aria-hidden="true"><use href="#i-screen"/></svg><span><strong id="call-share-target"></strong><small>仅共享此窗口</small></span></div>
+      <div class="call-recent" aria-label="最新消息">
+        <small class="call-recent-label">最新消息</small>
+        <p id="call-bubble-first" hidden></p><p id="call-bubble-second" hidden></p>
+      </div>
+      <div id="active-actions" class="action-row call-actions">
+        <button id="mic" data-action="mute"><svg class="icon" aria-hidden="true"><use id="mic-icon" href="#i-mic"/></svg><span class="label">静音</span></button>
+        <button data-action="share" id="share"><svg class="icon" aria-hidden="true"><use href="#i-screen"/></svg><span class="label">共享画面</span></button>
+        <button data-action="transcript"><svg class="icon" aria-hidden="true"><use href="#i-subtitles"/></svg><span>字幕</span></button>
+        <button id="end" class="destructive" data-action="stop"><span>挂断</span></button>
+      </div>
+      <p id="status" role="status" hidden></p>
+    </section>
+    <section id="menu" class="floating name-card" aria-label="猫猫名片" hidden>
+      <div id="menu-call-context" class="call-context" hidden>
+        <span class="status-dot" aria-hidden="true"></span><strong id="menu-call-state"></strong><span id="menu-call-mic-state"></span>
+        <small id="menu-call-work" hidden></small>
+        <button data-action="stop" class="destructive compact">挂断</button>
+        <div id="menu-share-context" class="call-share-line" hidden><svg class="icon" aria-hidden="true"><use href="#i-screen"/></svg><span><strong id="menu-share-target"></strong><small>仅共享此窗口</small></span></div>
+      </div>
+      <strong id="menu-name" class="menu-title">猫猫</strong>
+      <div class="name-card-actions">
+        <button id="begin" class="primary" data-action="begin"><svg class="icon" aria-hidden="true"><use href="#i-mic"/></svg><span class="label">语音通话</span></button>
+        <button id="listen" data-action="listen" hidden><svg class="icon" aria-hidden="true"><use href="#i-listen"/></svg><span class="label">只听</span></button>
+        <button data-action="write"><svg class="icon" aria-hidden="true"><use href="#i-keyboard"/></svg><span>聊天</span></button>
+      </div>
+      <p id="menu-status" role="status" hidden></p>
+      <button data-action="decisions"><span aria-hidden="true">◇</span><span>待办</span><span id="menu-pending" class="menu-status">—</span></button>
+      <button data-action="history"><svg class="icon" aria-hidden="true"><use href="#i-history"/></svg><span>打开聊天</span></button>
+      <button id="menu-play" data-action="play" hidden><span aria-hidden="true">✦</span><span>逗宪宪</span></button>
+      <div class="menu-divider" role="separator"></div>
+      <button id="speaker" data-action="speaker" hidden><svg class="icon" aria-hidden="true"><use href="#i-mic"/></svg><span class="label">关闭播音</span></button>
+      <button id="menu-settings" data-action="settings"><span aria-hidden="true">⚙</span><span>设置</span><span class="menu-status">›</span></button>
+      <button id="menu-share" data-action="share" title="语音通话连接后可共享画面"><svg class="icon" aria-hidden="true"><use href="#i-screen"/></svg><span class="label">共享画面</span></button>
+      <button id="documents" data-action="documents" aria-pressed="true"><svg class="icon" aria-hidden="true"><use href="#i-book"/></svg><span>资料查询</span><span class="menu-status">开启</span></button>
+      <div class="menu-divider" role="separator"></div>
+      <button data-action="hide" class="quiet-action" title="可从 Clowder 的聊聊入口叫回来"><svg class="icon" aria-hidden="true"><use href="#i-moon"/></svg><span>收起猫猫</span></button>
+    </section>
+    <section id="chat" class="floating" aria-label="和猫猫写几句" hidden>
+      <div id="chat-call-context" class="call-context" hidden>
+        <span class="status-dot" aria-hidden="true"></span><strong id="chat-call-state"></strong><span id="chat-call-mic-state"></span>
+        <small id="chat-call-work" hidden></small>
+        <div class="call-context-actions"><button id="chat-mic" data-action="mute">静音</button><button id="chat-share" data-action="share"><span class="label">共享画面</span></button><button data-action="stop" class="destructive compact">挂断</button></div>
+        <div id="chat-share-context" class="call-share-line" hidden><svg class="icon" aria-hidden="true"><use href="#i-screen"/></svg><span><strong id="chat-share-target"></strong><small>仅共享此窗口</small></span></div>
+      </div>
+      <header><strong id="chat-name">和猫猫写几句</strong><button data-action="dismiss" aria-label="收起文字">收起</button></header>
+      <div id="chat-transcript" role="log" aria-live="polite"><p class="empty">想说什么，就写在这里。</p></div>
+      <form id="compose"><textarea id="message" aria-label="给猫猫输入消息" placeholder="输入消息…" rows="2" maxlength="8000"></textarea><button type="submit" class="primary">发送</button></form>
+      <small id="chat-status" role="status"></small>
+      <small><span id="connection-scope">语音与文字共用同一段聊天</span> <button id="history">在 Cat Café 中查看完整聊天 ↗</button></small>
+    </section>
+    <section id="transcript" class="floating call-transcript" data-expanded="false" aria-label="这次通话的字幕" hidden>
+      <div id="transcript-call-context" class="call-context transcript-call-context">
+        <span class="status-dot" aria-hidden="true"></span><strong id="transcript-call-state"></strong><span id="transcript-call-mic-state"></span>
+        <small id="transcript-call-work" hidden></small>
+        <div class="call-context-actions">
+          <button id="transcript-return" class="transcript-return" type="button" data-action="transcript-return"><span aria-hidden="true">‹</span><span>返回通话</span></button>
+          <button id="transcript-mic" data-action="mute" aria-label="静音"><svg class="icon" aria-hidden="true"><use id="transcript-mic-icon" href="#i-mic"/></svg></button>
+          <button id="transcript-expand" data-action="transcript-expand"><svg class="icon" aria-hidden="true"><use href="#i-expand"/></svg><span id="transcript-expand-label">展开</span></button>
+          <button data-action="stop" class="destructive compact">挂断</button>
+        </div>
+        <div id="transcript-share-context" class="call-share-line" hidden><svg class="icon" aria-hidden="true"><use href="#i-screen"/></svg><span><strong id="transcript-share-target"></strong><small>仅共享此窗口</small></span></div>
+      </div>
+      <div id="call-transcript-log" role="log" aria-live="polite"></div>
+      <button id="call-unread" class="new-content" type="button" hidden></button>
+      <form id="call-compose"><input id="call-message" aria-label="通话中给猫猫发消息" placeholder="发消息给猫猫…" maxlength="8000"><button type="submit" class="primary">发送</button></form>
+      <small id="call-transcript-status" role="status"></small>
+      <small class="call-transcript-foot">完整记录会留在 Cat Café 聊天中</small>
+    </section>
+    <section id="settings" class="floating settings-panel" aria-label="猫猫球设置" hidden>
+      <div id="settings-call-context" class="call-context" hidden>
+        <span class="status-dot" aria-hidden="true"></span><strong id="settings-call-state"></strong><span id="settings-call-mic-state"></span>
+        <small id="settings-call-work" hidden></small>
+        <div class="call-context-actions"><button id="settings-mic" data-action="mute">静音</button><button id="settings-share" data-action="share"><span class="label">共享画面</span></button><button data-action="stop" class="destructive compact">挂断</button></div>
+        <div id="settings-share-context" class="call-share-line" hidden><svg class="icon" aria-hidden="true"><use href="#i-screen"/></svg><span><strong id="settings-share-target"></strong><small>仅共享此窗口</small></span></div>
+      </div>
+      <header class="settings-head"><button id="settings-back" type="button" aria-label="返回名片">‹</button><strong id="settings-title">设置</strong></header>
+      <p id="settings-loading" class="settings-loading" hidden>正在读取设置…</p>
+      <div id="settings-page-main" class="settings-page">
+        <button id="settings-partner-open" class="settings-row" type="button" data-setting-control data-drilldown><span>陪伴者</span><span id="settings-partner-value" class="settings-value">—</span></button>
+        <button id="settings-look-open" class="settings-row" type="button" data-setting-control data-drilldown><span>外观</span><span id="settings-look-value" class="settings-value">—</span></button>
+        <button id="settings-behavior" class="settings-row setting-switch" type="button" role="switch" aria-checked="false" data-setting-control><span><strong>自主活动</strong><small>空闲时自行走动</small></span><i aria-hidden="true"></i></button>
+        <button id="settings-proactive" class="settings-row setting-switch" type="button" role="switch" aria-checked="false" data-setting-control><span><strong>主动提示</strong><small>有待办时在猫旁显示数量</small></span><i aria-hidden="true"></i></button>
+        <button id="settings-documents" class="settings-row setting-switch" type="button" role="switch" aria-checked="false" data-setting-control><span><strong>资料查询</strong><small>允许陪伴者在通话中查询家里的资料</small></span><i aria-hidden="true"></i></button>
+        <footer class="settings-footer"><button id="settings-reset" type="button" data-setting-control>重置位置</button><button id="settings-disable-open" type="button" data-setting-control>停用桌面猫猫球…</button></footer>
+      </div>
+      <div id="settings-page-partner" class="settings-page" hidden>
+        <p class="settings-copy">在桌面陪伴和回复你的猫。更换陪伴者将结束当前语音通话。</p>
+        <div id="settings-roster" class="settings-roster"></div>
+        <label id="settings-tone-field" class="settings-field"><span>人设基调</span><textarea id="settings-tone" rows="2" maxlength="200" data-setting-control></textarea><small><span>适用于所有陪伴者 · 下次语音通话生效</span><span id="settings-tone-count">0 / 200</span></small></label>
+      </div>
+      <div id="settings-page-look" class="settings-page" hidden>
+        <p class="settings-eyebrow">皮肤</p><p class="settings-copy">仅改变外观，不更换陪伴者。</p>
+        <div class="settings-skins">
+          <button id="settings-skin-xianxian-codex" type="button" data-setting-control>宪宪 v1</button>
+          <button id="settings-skin-yanyan-codex" type="button" data-setting-control>砚砚 v1</button>
+          <button id="settings-skin-ragdoll-v1" type="button" data-setting-control>布偶猫</button>
+          <button id="settings-skin-yarn-ball" type="button" data-setting-control>猫猫球</button>
+        </div>
+        <label id="settings-size-field" class="settings-field settings-size"><span>大小</span><div><small>小</small><input id="settings-size" type="range" min="48" max="192" step="1" data-setting-control><small>大</small></div></label>
+      </div>
+      <div id="settings-page-confirm" class="settings-page settings-confirm" hidden>
+        <strong id="settings-confirm-title"></strong><p id="settings-confirm-copy"></p>
+        <div><button id="settings-confirm-cancel" type="button">取消</button><button id="settings-confirm-apply" type="button" data-setting-control>确认更改</button></div>
+      </div>
+      <div id="settings-page-unavailable" class="settings-page settings-empty" hidden><p id="settings-unavailable-copy"></p><button id="settings-unavailable-retry" type="button">重试</button></div>
+      <div id="settings-page-disabled" class="settings-page settings-empty" hidden><p>桌面猫猫球已停用。可在 Cat Café 的“设置 › 插件”中重新启用。</p></div>
+      <p id="settings-notice" class="settings-notice" role="status" hidden></p>
+      <div class="settings-notice-actions"><button id="settings-retry" type="button" hidden>重试</button><button id="settings-reread" type="button" hidden>重新读取</button></div>
+    </section>
+    <p id="announcement" class="sr-only" role="status"></p>
+    <section id="decisions" class="floating" aria-label="待办" hidden>
+      <header><strong>待办</strong><button id="decision-reload" type="button">刷新</button></header>
+      <p id="decision-status" role="status">正在读取待办…</p>
+      <ul id="decision-list"></ul>
+      <button id="decision-more" type="button" hidden>查看更多</button>
+      <small>这里只查看原处事项。要决定时请打开对应卡片。</small>
+    </section>
+  </main>
   <script type="module" src="./surface.mjs"></script>
 </body></html>