@my-life-buddies/cli 0.13.3 → 0.15.0

package/dist/web/widgets.js

@@ -1,126 +1,280 @@
-/* Client reference: my-life-buddies-ios dev 547818d, DadaConversationWidgets / DadaHostedWidgetPage. */
+/* Client reference: my-life-buddies-ios dev ff1845b (2026-09-16).
+   Native point sizes share the phone's scale; Web content remains in an opaque sandbox. */
 (() => {
-  const previewUrl = path => window.previewApiUrl?.(path) ?? path;
-  const el = (tag, className, text) => { const n = document.createElement(tag); n.className = className; if (text !== undefined) n.textContent = text; return n; };
+  const el = (tag, className = '', text) => {
+    const node = document.createElement(tag); node.className = className;
+    if (text !== undefined) node.textContent = text;
+    return node;
+  };
+  const button = (label, action, className = '') => {
+    const node = el('button', className, label); node.type = 'button'; node.addEventListener('click', action); return node;
+  };
+  const menuIcon = name => {
+    const paths = {
+      share: 'M12 15V3m-4 4 4-4 4 4M7 11H5v10h14V11h-2',
+      pin: 'm9 3 6 0-1 6 4 4v2H6v-2l4-4ZM12 15v6',
+      unpin: 'm3 3 18 18M9 3h6l-1 6 4 4v2M6 15h6m0 0v6',
+      trash: 'M4 7h16M9 7V4h6v3M6 7l1 14h10l1-14M10 11v6m4-6v6',
+    };
+    const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+    svg.setAttribute('viewBox', '0 0 24 24'); svg.setAttribute('aria-hidden', 'true');
+    const path = document.createElementNS(svg.namespaceURI, 'path'); path.setAttribute('d', paths[name]);
+    svg.append(path); return svg;
+  };
   window.createSimulatorWidgets = ({ api, avatar }) => {
     const shortcut = document.querySelector('#widget-shortcut');
     const overlay = document.querySelector('#widget-overlay');
     const phone = document.querySelector('.phone-screen');
-    let items = [], scope = '', generation = 0, ready = false, loading = false, lastRefresh = 0, selected, focusBefore, openRevision = 0;
-    let failed = false, renderSignature = '', frameObserver;
-    function close() {
-      frameObserver?.disconnect(); frameObserver = undefined;
-      const wasOpen = !overlay.hidden;
-      openRevision++; selected = undefined; overlay.hidden = true; overlay.replaceChildren();
+    const device = document.querySelector('.phone');
+    let reopenId, conversationScope;
+    let items = [], scope = '', generation = 0, ready = false, loading = false, lastRefresh = 0;
+    let failed = false, signature = '', selected, focusBefore, openRevision = 0, frameObserver;
+    let collapseTimer, closeTimer, loadTimer, documentFrame, documentToken, documentReady;
+    let phase = 'normal', choices, pill, busy = false, refreshPromise;
+    let documentLifecycle = false, canDelete = false;
+    const timers = () => { clearTimeout(loadTimer); frameObserver?.disconnect(); frameObserver = undefined; documentFrame = undefined; documentReady = undefined; };
+    const scale = () => device.clientWidth / 415;
+    const resize = new ResizeObserver(() => { phone.style.setProperty('--widget-unit', `${scale()}px`); });
+    resize.observe(device);
+    function setPhase(value) { phase = value; shortcut.dataset.phase = value; pill?.setAttribute('aria-expanded', String(value === 'choosing')); }
+    function scheduleCollapse() {
+      clearTimeout(collapseTimer);
+      if (!ready || !items.length || selected || document.hidden || phase !== 'normal') return;
+      collapseTimer = setTimeout(() => setPhase('collapsed'), 5000);
+    }
+    function closeChoices(reset = true) {
+      choices?.remove(); choices = undefined;
+      if (reset) { setPhase('normal'); scheduleCollapse(); }
+    }
+    function finishClose() {
+      overlay.hidden = true; overlay.replaceChildren(); delete overlay.dataset.state;
       for (const child of phone.children) if (child !== overlay) child.inert = false;
-      if (wasOpen) focusBefore?.focus?.();
+      if (focusBefore?.isConnected) focusBefore.focus(); focusBefore = undefined; setPhase('normal'); scheduleCollapse();
+    }
+    function close(immediate = false) {
+      if (busy && !immediate) return;
+      clearTimeout(closeTimer); timers(); openRevision++; selected = undefined;
+      if (immediate || overlay.hidden) { finishClose(); return; }
+      overlay.dataset.state = 'closing';
+      closeTimer = setTimeout(finishClose, window.matchMedia('(prefers-reduced-motion:reduce)').matches ? 100 : 220);
     }
-    function button(label, action, className = '') { const n = el('button', className, label); n.type = 'button'; n.addEventListener('click', action); return n; }
     function render() {
-      const signature = JSON.stringify([ready, items, failed]);
-      if (signature === renderSignature) return;
-      renderSignature = signature;
-      shortcut.replaceChildren(); shortcut.hidden = !ready || (!items.length && !failed);
+      const next = JSON.stringify([ready, items, failed]);
+      if (next === signature) return;
+      signature = next;
+      const choosing = phase === 'choosing';
+      closeChoices(false); shortcut.replaceChildren(); shortcut.hidden = !ready || (!items.length && !failed);
       if (shortcut.hidden) return;
       if (!items.length) { shortcut.append(button('重新加载小挂件', () => refresh(true), 'widget-pill')); return; }
-      const pill = button('', () => {
-        if (items.length === 1) { void open(items[0]); return; }
-        const old = shortcut.querySelector('.widget-choices');
-        if (old) { old.remove(); pill.setAttribute('aria-expanded', 'false'); return; }
-        const choices = el('div', 'widget-choices'); choices.setAttribute('role', 'menu');
-        for (const item of items) { const b = button(item.title + ' ›', () => { choices.remove(); pill.setAttribute('aria-expanded', 'false'); void open(item); }); b.setAttribute('role', 'menuitem'); choices.append(b); }
-        shortcut.append(choices); pill.setAttribute('aria-expanded', 'true'); choices.firstChild?.focus();
+      const title = items.length === 1 ? items[0].title : '全部小挂件';
+      pill = button('', () => {
+        clearTimeout(collapseTimer);
+        if (items.length === 1) { open(items[0]); return; }
+        if (choices) { closeChoices(); return; }
+        setPhase('choosing');
+        choices = el('div', 'widget-choices'); choices.setAttribute('role', 'menu'); choices.setAttribute('aria-label', '会话小挂件列表');
+        for (const item of items) {
+          const row = button('', () => { closeChoices(false); open(item); }); row.setAttribute('role', 'menuitem');
+          row.append(el('span', '', item.title), el('span', 'widget-arrow', '›')); choices.append(row);
+        }
+        shortcut.append(choices); choices.firstChild?.focus();
       }, 'widget-pill');
+      pill.setAttribute('aria-label', title);
       const image = avatar(); image.classList.add('widget-pill-avatar');
-      pill.append(image, el('span', 'widget-pill-title', items.length === 1 ? items[0].title : '全部小挂件'));
-      if (items.length > 1) { pill.append(el('span', 'widget-chevron', '⌄')); pill.setAttribute('aria-haspopup', 'menu'); pill.setAttribute('aria-expanded', 'false'); }
-      shortcut.append(pill);
+      pill.append(image, el('span', 'widget-pill-title', title));
+      if (items.length > 1) { pill.append(el('span', 'widget-chevron', '›')); pill.setAttribute('aria-haspopup', 'menu'); }
+      shortcut.append(pill); setPhase(choosing ? 'normal' : phase);
     }
     async function refresh(force = false) {
-      if (!ready || loading || (!force && Date.now() - lastRefresh < 1500)) return;
+      if (!ready) return;
+      if (loading) return refreshPromise;
+      if (!force && Date.now() - lastRefresh < 1500) return;
       loading = true; const mine = generation;
       try {
-        const value = await api('/api/simulator/widgets');
+        refreshPromise = api('/api/simulator/widgets');
+        const value = await refreshPromise;
         if (mine !== generation || !ready) return;
+        const previousIDs = items.map(item => item.id).join(',');
         items = value.widgets || []; failed = false;
-        if (selected && !items.some(item => item.id === selected.id)) close();
+        documentLifecycle = value.capabilities?.documentLifecycle === true;
+        canDelete = value.capabilities?.deleteWidget === true;
+        if (selected && !items.some(item => item.id === selected.id)) close(true);
+        if (previousIDs !== items.map(item => item.id).join(',')) { setPhase('normal'); scheduleCollapse(); }
+        // Revoked ownership must also remove an already open owner menu.
+        if (selected && items.find(item => item.id === selected.id)?.role !== 'owner') {
+          overlay.querySelector('.widget-options')?.remove();
+          overlay.querySelector('.widget-confirm-backdrop')?.remove();
+          overlay.querySelector('.widget-native-share')?.remove();
+          const more = overlay.querySelector('.widget-more'); if (more) more.hidden = true;
+        }
       } catch { if (mine === generation) failed = true; }
       finally { if (mine === generation) { loading = false; lastRefresh = Date.now(); render(); } }
     }
+    function notify(text, error = false) {
+      overlay.querySelector('.widget-pin-note')?.remove();
+      const note = el('div', `widget-pin-note${error ? ' is-error' : ''}`, text); note.setAttribute('role', 'status'); overlay.append(note);
+      setTimeout(() => note.remove(), 4000);
+    }
+    function showConfirmation(card, item, mine, current) {
+      const shade = el('div', 'widget-confirm-backdrop');
+      const dialog = el('section', 'widget-confirm'); dialog.setAttribute('role', 'alertdialog'); dialog.setAttribute('aria-label', '删除小挂件？');
+      dialog.append(el('h4', '', '删除小挂件？'), el('p', '', '将删除小挂件和其中的数据，所有会话里的引用及首页固定都会失效。此操作不可恢复。'));
+      const actions = el('div', 'widget-confirm-actions');
+      const cancel = button('取消', () => { if (!busy) { shade.remove(); card.querySelector('.widget-more')?.focus(); } });
+      const remove = button('删除', async () => {
+        if (busy) return;
+        busy = true; cancel.disabled = true; remove.disabled = true; remove.textContent = '正在删除…';
+        try {
+          await api(`/api/simulator/widgets/${encodeURIComponent(item.id)}`, {method:'DELETE'});
+          if (mine !== openRevision || current !== generation) return;
+          items = items.filter(value => value.id !== item.id); render(); busy = false; close();
+        } catch {
+          if (mine !== openRevision || current !== generation) return;
+          shade.remove(); notify('操作失败，请稍后重试', true);
+        } finally { if (mine === openRevision && current === generation) busy = false; }
+      }, 'widget-destructive');
+      actions.append(cancel, remove); dialog.append(actions); shade.append(dialog); card.append(shade); cancel.focus();
+    }
+    function showShare(card) {
+      // Sharing chooses real conversations in the App; the simulator never fabricates recipients.
+      const notice = el('div', 'widget-native-share');
+      notice.append(el('h4', '', '在搭搭 App 中分享'), el('p', '', '使用真机预览打开这个搭子，在小挂件的「分享」中选择聊天。'));
+      notice.append(button('打开真机预览', () => { close(true); document.querySelector('#pair-device').click(); }), button('返回小挂件', () => notice.remove()));
+      card.append(notice); notice.querySelector('button').focus();
+    }
+    function ownerMenu(card, item, mine, current) {
+      const old = card.querySelector('.widget-options'); if (old) { old.remove(); return; }
+      const currentItem = items.find(value => value.id === item.id);
+      if (currentItem?.role !== 'owner' || busy) return;
+      const menu = el('div', 'widget-options'); menu.setAttribute('role', 'menu');
+      const share = button('分享', () => { menu.remove(); showShare(card); });
+      const pin = button(currentItem.isPinned ? '从首页取消固定' : '固定到首页', async () => {
+        if (busy) return; busy = true; menu.querySelectorAll('button').forEach(node => { node.disabled = true; });
+        try {
+          await api(`/api/simulator/widgets/${encodeURIComponent(item.id)}/pin`, {method:currentItem.isPinned ? 'DELETE' : 'PUT'});
+          if (mine !== openRevision || current !== generation) return;
+          currentItem.isPinned = !currentItem.isPinned; menu.remove(); notify(currentItem.isPinned ? '已固定到首页' : '已从首页取消固定');
+        } catch {
+          if (mine === openRevision && current === generation) { menu.remove(); notify('操作失败，请稍后重试', true); }
+        } finally { if (mine === openRevision && current === generation) busy = false; }
+      });
+      const remove = button('删除小挂件', () => { menu.remove(); showConfirmation(card, item, mine, current); }, 'widget-destructive');
+      share.prepend(menuIcon('share')); pin.prepend(menuIcon(currentItem.isPinned ? 'unpin' : 'pin')); remove.prepend(menuIcon('trash'));
+      for (const row of [share, pin, ...(canDelete ? [remove] : [])]) { row.setAttribute('role', 'menuitem'); menu.append(row); }
+      card.append(menu); share.focus();
+    }
     async function open(item) {
       if (!item.type || !ready) return;
       const mine = ++openRevision, current = generation;
       if (overlay.hidden) focusBefore = document.activeElement;
-      frameObserver?.disconnect();
+      clearTimeout(collapseTimer); clearTimeout(closeTimer); closeChoices(false); timers(); busy = false;
       selected = item; document.querySelector('#message-input').blur();
-      overlay.replaceChildren(); overlay.hidden = false;
+      overlay.replaceChildren(); overlay.hidden = false; overlay.dataset.state = 'opening';
       const card = el('section', 'widget-modal'); card.setAttribute('role', 'dialog'); card.setAttribute('aria-modal', 'true'); card.setAttribute('aria-label', item.title);
       const header = el('header', 'widget-modal-header');
-      const dismiss = button('×', close); dismiss.setAttribute('aria-label', '关闭小挂件');
-      const more = button('···', () => {
-        const old = card.querySelector('.widget-options'); if (old) { old.remove(); return; }
-        const menu = el('div', 'widget-options'); menu.setAttribute('role', 'menu');
-        const currentItem = items.find(value => value.id === item.id);
-        if (currentItem) menu.append(button(currentItem.isPinned ? '从首页取消固定' : '固定到首页', async () => {
-          menu.querySelectorAll('button').forEach(b => { b.disabled = true; });
-          try {
-            await api(`/api/simulator/widgets/${encodeURIComponent(item.id)}/pin`, { method: currentItem.isPinned ? 'DELETE' : 'PUT' });
-            if (mine !== openRevision || current !== generation) return;
-            currentItem.isPinned = !currentItem.isPinned; menu.remove();
-            const note = el('div', 'widget-pin-note', currentItem.isPinned ? '已固定到首页' : '已从首页取消固定'); note.setAttribute('role', 'status'); card.append(note); setTimeout(() => note.remove(), 4000);
-          } catch (error) { if (mine === openRevision) { menu.replaceChildren(el('p', '', error.message), button('知道了', () => menu.remove())); } }
-        }));
-        menu.append(button('刷新', () => open(item))); card.append(menu);
-      }); more.setAttribute('aria-label', '小挂件更多');
-      header.append(dismiss, el('h3', '', item.title), more);
-      const body = el('div', 'widget-modal-body'); body.append(el('p', 'widget-loading', '正在打开小挂件…'));
-      card.append(header, body); overlay.append(card);
+      const dismiss = button('×', () => close()); dismiss.setAttribute('aria-label', '关闭小挂件');
+      const more = button('···', () => ownerMenu(card, item, mine, current), 'widget-more'); more.setAttribute('aria-label', '小挂件更多'); more.hidden = true;
+      const slot = el('div', 'widget-more-slot'); slot.append(more);
+      header.append(dismiss, el('h3', '', item.title), slot);
+      const body = el('div', 'widget-modal-body'); body.setAttribute('aria-busy', 'true');
+      const loadingView = el('div', 'widget-loading'); loadingView.setAttribute('role', 'status');
+      loadingView.append(el('span', 'widget-spinner'), el('p', '', '正在打开小挂件…'));
+      body.append(loadingView); card.append(header, body); overlay.append(card);
       for (const child of phone.children) if (child !== overlay) child.inert = true;
       dismiss.focus();
-      try {
-        const url = previewUrl(`/api/simulator/widgets/${encodeURIComponent(item.id)}`);
-        // Probe errors in the parent; actual HTML executes only inside the opaque sandbox document.
-        const response = await fetch(url, { credentials: 'same-origin' });
-        if (!response.ok) { const error = await response.json(); throw new Error(error.error?.message || error.error || '小挂件暂时无法打开'); }
-        await response.arrayBuffer();
+      const failedLoad = () => {
         if (mine !== openRevision || current !== generation) return;
-        const frame = el('iframe', 'widget-document'); frame.title = item.title; frame.setAttribute('sandbox', 'allow-scripts'); frame.referrerPolicy = 'no-referrer'; frame.src = url;
-        body.replaceChildren(frame);
-        frameObserver = new ResizeObserver(() => {
-          const scale = body.clientWidth / 383;
-          if (!scale) return;
-          frame.style.width = '383px'; frame.style.height = `${body.clientHeight / scale}px`;
-          frame.style.transform = `scale(${scale})`; frame.style.transformOrigin = 'top left';
-        });
-        frameObserver.observe(body);
-      } catch (error) {
+        timers(); body.setAttribute('aria-busy', 'false');
+        const failure = el('div', 'widget-failure'); failure.setAttribute('role', 'status');
+        failure.append(el('span', 'widget-failure-mark', '!'), el('h4', '', '小挂件暂时无法打开'), el('p', '', '加载失败，请稍后重试'), button('重新加载', () => open(item)));
+        body.replaceChildren(failure);
+      };
+      const frame = el('iframe', 'widget-document'); frame.title = item.title; frame.setAttribute('sandbox', 'allow-scripts'); frame.referrerPolicy = 'no-referrer'; frame.style.visibility = 'hidden';
+      documentFrame = frame; documentToken = crypto.randomUUID();
+      const url = new URL(window.previewApiUrl?.(`/api/simulator/widgets/${encodeURIComponent(item.id)}`) ?? `/api/simulator/widgets/${encodeURIComponent(item.id)}`, location.href);
+      url.searchParams.set('render', documentToken); frame.src = url.href;
+      documentReady = state => {
         if (mine !== openRevision || current !== generation) return;
-        body.replaceChildren(el('h4', '', '小挂件暂时无法打开'), el('p', '', error.message), button('重新加载', () => open(item)));
-      }
+        if (state !== 'ready') { failedLoad(); return; }
+        clearTimeout(loadTimer); loadingView.remove(); frame.style.visibility = 'visible'; body.setAttribute('aria-busy', 'false');
+      };
+      frame.addEventListener('error', failedLoad);
+      // Older CLI bridges cannot send lifecycle signals. Keep their document load usable.
+      frame.addEventListener('load', () => { if (!documentLifecycle) documentReady?.('ready'); });
+      body.append(frame);
+      frameObserver = new ResizeObserver(() => {
+        const factor = scale(); if (!factor) return;
+        frame.style.width = `${body.clientWidth / factor}px`; frame.style.height = `${body.clientHeight / factor}px`;
+        frame.style.transform = `scale(${factor})`; frame.style.transformOrigin = 'top left';
+      }); frameObserver.observe(body);
+      loadTimer = setTimeout(failedLoad, 15000);
+      await refresh(true);
+      if (mine === openRevision && current === generation) more.hidden = failed || items.find(value => value.id === item.id)?.role !== 'owner';
     }
+    window.addEventListener('message', event => {
+      if (!documentFrame || event.source !== documentFrame.contentWindow || event.data?.channel !== 'buddy-widget-document' || event.data?.render !== documentToken) return;
+      documentReady?.(event.data.state);
+    });
     overlay.addEventListener('click', event => { if (event.target === overlay) close(); });
+    document.addEventListener('pointerdown', event => {
+      if (choices && !shortcut.contains(event.target)) closeChoices();
+      const menu = overlay.querySelector('.widget-options');
+      if (menu && !menu.contains(event.target) && !event.target.closest('.widget-more')) menu.remove();
+    });
     document.addEventListener('keydown', event => {
-      if (event.key === 'Escape') { if (!overlay.hidden) close(); else { shortcut.querySelector('.widget-choices')?.remove(); shortcut.querySelector('button')?.setAttribute('aria-expanded', 'false'); } }
+      if (event.key === 'Escape') {
+        if (busy) return;
+        const nested = overlay.querySelector('.widget-confirm-backdrop,.widget-native-share,.widget-options');
+        if (nested) { nested.remove(); overlay.querySelector('.widget-more')?.focus(); } else if (!overlay.hidden) close(); else closeChoices();
+      }
       if (event.key === 'Tab' && !overlay.hidden) {
-        const controls = [...overlay.querySelectorAll('button:not(:disabled), iframe')]; const first = controls[0], last = controls.at(-1);
+        const scope = overlay.querySelector('.widget-confirm,.widget-native-share') || overlay;
+        const controls = [...scope.querySelectorAll('button:not(:disabled), iframe')].filter(node => !node.hidden && node.getClientRects().length);
+        const first = controls[0], last = controls.at(-1);
         if (event.shiftKey && document.activeElement === first) { event.preventDefault(); last?.focus(); }
         else if (!event.shiftKey && document.activeElement === last) { event.preventDefault(); first?.focus(); }
       }
     });
-    document.addEventListener('visibilitychange', () => { if (!document.hidden) void refresh(true); });
+    document.addEventListener('visibilitychange', () => {
+      clearTimeout(collapseTimer); closeChoices(false);
+      if (!document.hidden) { setPhase('normal'); scheduleCollapse(); void refresh(true); }
+    });
+    window.addEventListener('pagehide', () => { resize.disconnect(); timers(); clearTimeout(collapseTimer); clearTimeout(closeTimer); });
     return {
-      update({ active, conversationRevision, devRevision }) {
+      update({active, conversationRevision, devRevision, reloading = false}) {
         const key = `${conversationRevision || 0}:${devRevision || 0}`;
-        if (key !== scope || !active) { scope = key; generation++; items = []; failed = false; loading = false; lastRefresh = 0; close(); }
-        ready = active; render(); void refresh();
+        if (conversationScope !== conversationRevision || (!active && !reloading)) reopenId = undefined;
+        else if (selected && (key !== scope || reloading)) reopenId = selected.id;
+        conversationScope = conversationRevision;
+        if (key !== scope || !active) {
+          scope = key; generation++; ready = false; items = []; failed = false; loading = false; lastRefresh = 0; busy = false; documentLifecycle = false; canDelete = false;
+          clearTimeout(collapseTimer); close(true);
+        }
+        ready = active; render();
+        const mine = generation;
+        void refresh().then(() => {
+          if (!ready || mine !== generation || !reopenId) return;
+          const item = items.find(value => value.id === reopenId);
+          reopenId = undefined;
+          if (item) void open(item);
+        });
       },
-      reset() { generation++; ready = false; items = []; loading = false; failed = false; close(); render(); },
+      reset() { reopenId = undefined; generation++; ready = false; items = []; loading = false; failed = false; busy = false; clearTimeout(collapseTimer); close(true); render(); },
       card(item) {
         const card = el('div', 'widget-entry'); card.append(el('h4', '', item.title));
         const details = el('div', 'widget-entry-details');
-        if (item.type && item.imageMediaId) { const image = el('img', 'widget-entry-photo'); image.alt = `${item.title}的照片`; image.src = previewUrl(`/api/simulator/widgets/${encodeURIComponent(item.id)}/image?mediaId=${encodeURIComponent(item.imageMediaId)}`); image.addEventListener('error', () => { image.hidden = true; }); details.append(image); }
-        details.append(el('p', '', item.type ? item.summary?.trim() || '打开查看最新内容' : '此小挂件已删除或不可用')); card.append(details);
+        if (item.type && item.imageMediaId) {
+          const image = el('img', 'widget-entry-photo'); image.alt = `${item.title}的照片`;
+          image.src = window.previewApiUrl?.(`/api/simulator/widgets/${encodeURIComponent(item.id)}/image?mediaId=${encodeURIComponent(item.imageMediaId)}`) ?? `/api/simulator/widgets/${encodeURIComponent(item.id)}/image?mediaId=${encodeURIComponent(item.imageMediaId)}`;
+          image.addEventListener('error', () => { image.hidden = true; }); details.append(image);
+        }
+        details.append(el('p', item.type && item.summary?.trim() ? '' : 'widget-secondary', item.type ? item.summary?.trim() || '打开查看最新内容' : '此小挂件已删除或不可用')); card.append(details);
         if (item.type) card.append(button('去查看', () => open(item), 'widget-entry-open'));
+        const permission = {owner:'可管理、分享',editor:'可编辑',viewer:'仅支持查看'}[item.role];
+        const metadata = el('div', 'widget-entry-metadata');
+        if (item.creatorName?.trim()) metadata.append(el('span', 'widget-creator', `${item.creatorName.trim()}创建`));
+        if (permission) metadata.append(el('span', 'widget-permission', (metadata.children.length ? '｜' : '') + permission));
+        if (metadata.children.length) card.append(metadata);
         return card;
       },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@my-life-buddies/cli",
-  "version": "0.13.3",
+  "version": "0.15.0",
   "type": "module",
   "description": "搭搭 Developer Platform 命令行工具",
   "publishConfig": {
@@ -39,7 +39,7 @@
     "ws": "8.21.3"
   },
   "devDependencies": {
-    "@buddy/cli-core": "0.13.3",
-    "@buddy/preview": "0.13.3"
+    "@buddy/cli-core": "0.15.0",
+    "@buddy/preview": "0.15.0"
   }
 }

package/resources/README.md

@@ -1,54 +1,10 @@
-# CLI 内置的 Creator Skill
+# CLI 分发资源
 
-开发者运行 `buddy-cli init --mode create` 后，CLI 返回一份接续说明，让 Coding Agent 使用这里的 Skill 完成需求创作。这个目录保存可随包分发的程序与规则，不保存开发者作品。
+此目录包含工程模板和品牌资源。Creator 与 Avatar 规则、工具和参考图均由独立 npm 资源包提供，不进入 CLI 安装包。
 
-## 安装时带走什么，创作时留下什么
+- Creator：`@my-life-buddies/creator-skill`，项目锁 `.buddy/creator/skill-lock.json`。
+- Avatar：`avatar-creator-skill`，项目锁 `.buddy/meta/skill-lock.json`。仅生成头像时加载；已有图片确认和上传无需该包。
 
-| 内容 | 保存位置 | 谁使用或修改 |
-| --- | --- | --- |
-| Skill 规则、Python 工具、预览资源 | 安装包内的 `resources/buddy-creator/` | Coding Agent 读取和执行；维护者随版本升级 |
-| 来源与文件摘要 | [buddy-creator.manifest.json](buddy-creator.manifest.json) | 构建过程校验 |
-| 云端身份绑定、初始背景、接续说明、作品与 Booklet | 开发者工程的 `.buddy/creator/` | CLI 创建绑定，Coding Agent 继续创作 |
+`src/init/skill-package.ts` 负责两者共用的下载、完整性校验、缓存和版本锁定，各自协议由 `creator-package.ts` 与 `avatar-package.ts` 定义。安装禁用 npm 脚本，已有缓存可离线准备 Skill，平台身份操作仍需要联网。
 
-例如学习搭子的采访中断了，开发者在同一目录重新运行 create，继续使用原来的作品路径。无需再下载 Skill，也不把作品写进全局 CLI 安装目录。
-
-CLI 只准备接续，不执行采访推理，也不把准备成功当成手册完成。Skill 返回 `creator_complete` 后，当前 Coding Agent 退出采访，按接续说明继续开发；已经明确的技术选择直接沿用，缺少必要选择时主动询问。没有常驻 CLI 进程替 Coding Agent 编写代码。操作流程见 [CLI 使用说明](../../../apps/cli/README.md#想法还模糊时先梳理需求)。
-
-## 这份快照来自哪里
-
-来源是 [Buddy-Creator-Skill](https://github.com/my-life-buddies/Buddy-Creator-Skill)，固定 `main` 提交为 `f642ddd59e1c30a5d4d3a2e9f6a6811f61ce1f2f`，产品版本 **1.3.0**。
-
-这次更新引入更自然的提问规则、按具体缺口记录的追问边界，以及无新增信息时的收口处理。`scripts/interview.py` 负责计数与状态，Coding Agent 根据真实回答提交 `interview.assessment`；它不是新的采访模型服务。详细字段见 [宿主协议](buddy-creator/references/host-guide.md)。
-
-收录范围按上游安装清单确定：四个顶层文件和 `agents`、`assets`、`references`、`scripts`。Git 元数据、开发打包工具和用户作品不在其中；第三方许可证保留。
-
-当前本地补丁包括以下接入规则；完整清单以 manifest 的 localPatches 和 [补丁说明](buddy-creator/PATCHES.md) 为准，内置版本为 1.4.0：
-
-- `initial-context-opening`：CLI 把登记资料写入 `initial-context.json`，Skill 接收后由 Coding Agent 按已有主题准备开场。新登记的资料须由用户提供、确认或授权代定；平台快照本身不证明用户确认，旧记录还可能包含未经确认的暂拟文案。基础资料也不算采访回答或四册确认。开场使用 1.3.0 的问题与缺口绑定；缺省 gapId 和旧开场记录都能安全重试。
-- `completion-return`：Skill 显式报告创作完成或成果待恢复，CLI 接续说明负责把当前 Coding Agent 带回开发流程。手册缺失、失效或项目暂停时不进入开发；用户只要设计时也不自动扩展任务。
-- `small-widget-design` 与后续视觉补丁：四册后增加只读小挂件清单、两视图三态原型和设计验收；不同内容类型使用不同布局，旧版原型资源保持不变。
-- `development-after-design-acceptance`：全部必需设计确认并通过交付校验后，完整创建任务由当前 Coding Agent 同一轮自动接回开发，不停在成果链接或追加开始确认。
-
-manifest 的 revision 指向上游基线，localPatches 标记本地调整，文件摘要对应实际分发内容。
-
-`cli-core/package.json.files` 显式包含 resources。构建时的 [校验脚本](../scripts/verify-creator-skill.mjs) 比对文件清单、大小和 SHA-256，不联网下载，也不执行 Python。
-
-## 执行工具时的约定
-
-Coding Agent 使用 Python 3.9+，带 `-B` 并设置 `PYTHONDONTWRITEBYTECODE=1`，让预览子进程也不向安装目录写字节码缓存。创作文件始终写入指定工作区。
-
-资源缺失或损坏时，CLI 提示修复安装，不临时从网络下载另一版。Skill 可以不经下载直接使用，不代表登录和平台身份登记可以离线。
-
-早期下载版项目会迁移未被用户修改的接续说明，并保留备份、旧 Skill 文件和作品；用户自己改过的说明不自动覆盖。迁移实现位于 [creator.ts](../src/init/creator.ts)。
-
-1.0.0 的已有作品仍用原 workspace 接续，不重置回答、确认和进度。只打开不会迁移访谈记录；第一次新提交时按历史回答补齐内部缺口信息。Coding Agent 需要重新读取新版 Skill 和宿主协议，回答旧问题时也按新协议提交 assessment。
-
-## 维护者怎样升级
-
-先审核上游提交差异，再整体更新快照、来源信息和 manifest；逐项检查 localPatches 是否仍需保留。本地修订也要同步补丁说明和文件摘要，不能把修改后的资源标为未改动的上游快照。
-
-升级后，在仓库根目录执行 `npm run check` 和 `npm run verify:package`。后者检查真实 npm 安装后资源是否完整，并在禁用资源下载的条件下验证 create、重试和同身份 direct 衔接。它验证接入流程，不代替人工评审一次完整采访的效果。
-
-[上游访谈测试](../../../tests/fixtures/creator-upstream-interview.py) 从同一提交的 `development/test_interview.py` 原样收录，只用于测试，不进入 CLI 安装包。[测试入口](../../../tests/creator-context.test.mjs) 让它运行在实际内置资源上，同时检查我们的背景传递与旧项目兼容。
-
-[完成交接测试](../../../tests/fixtures/creator-completion.py) 验证最后一轮、旧项目恢复、成果损坏和暂停等边界；CLI 集成测试继续验证完成后 direct 复用同一个云端身份。它们不等同于一次真实 Coding Agent 的完整创作与开发体验。
+`tests/fixtures/` 是测试输入，不参与构建。安装包验收使用独立提供的 Avatar 测试包和公共 npm Creator 包；可通过 BUDDY_AVATAR_TEST_SKILL_ROOT 指定解包后的真实头像包执行验收。

package/resources/agent-template/package-lock.json

@@ -8,7 +8,7 @@
       "name": "buddy-agent-project",
       "version": "0.0.0",
       "dependencies": {
-        "@my-life-buddies/buddy-runtime": "0.12.2",
+        "@my-life-buddies/buddy-runtime": "0.16.0",
         "typebox": "1.3.7"
       },
       "engines": {
@@ -981,9 +981,9 @@
       }
     },
     "node_modules/@my-life-buddies/buddy-runtime": {
-      "version": "0.12.2",
-      "resolved": "https://registry.npmjs.org/@my-life-buddies/buddy-runtime/-/buddy-runtime-0.12.2.tgz",
-      "integrity": "sha512-LoPt78FO/h6roKoOjVBREeW5UxsZv1NEE41RkIdhg4ffeHL0rzQvi9yaXel+PNT9W9Ud5JfxDTMF7kpqgs0Y7A==",
+      "version": "0.16.0",
+      "resolved": "https://registry.npmjs.org/@my-life-buddies/buddy-runtime/-/buddy-runtime-0.16.0.tgz",
+      "integrity": "sha512-NkJef6s39Fs/pnxtC5q5ee8dEFMUudPcyO6a4v22xMZmaDIsFBvb/R3D1q1/bVrSCKAvhSaVe0sM9LrhuPn02w==",
       "dependencies": {
         "@earendil-works/pi-agent-core": "0.85.1",
         "@earendil-works/pi-ai": "0.85.1",

package/resources/agent-template/package.json

@@ -4,13 +4,13 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "start": "node start.mjs"
+    "start": "node --env-file-if-exists=.env start.mjs"
   },
   "engines": {
     "node": ">=24"
   },
   "dependencies": {
-    "@my-life-buddies/buddy-runtime": "0.12.2",
+    "@my-life-buddies/buddy-runtime": "0.16.0",
     "typebox": "1.3.7"
   }
 }

package/resources/buddy-creator/INSTALL.md

@@ -1,25 +0,0 @@
-# 安装 Buddy Creator Skill 1.4.0
-
-把完整 ZIP 交给当前宿主 agent，告诉它：
-
-> 请安装这个 Buddy Creator Skill，并开始帮我创作一个搭子。
-
-本目录为 CLI 内置的 1.4.0 版本，上游基线及补丁见 [PATCHES.md](PATCHES.md)。独立安装上游包可使用[公开安装入口](https://raw.githubusercontent.com/my-life-buddies/Buddy-Creator-Skill/main/start.md)；开始创作无需填写 buddyid，也无需选择宿主类型。
-
-## 环境与安装
-
-本包使用 **Python 3.9+ 标准库**，不需要 Node、npm、pip 或第三方 Python 包。宿主应先查找并复用自己或系统已有的兼容 Python，读取实际版本并保存其绝对路径。没有可用 Python 时需先准备该环境；不能仅检查一次 `python3` 就认定没有 Python，也不能声称完全不需要执行环境。
-
-将 ZIP 中的 `buddy-creator` 文件夹安装到当前宿主实际支持的 Skill 目录。Codex、Claude Code、WorkBuddy 的安装入口由各自宿主处理，不要求另注册 agent 或 Expert。无法自动发现 Skill 时，可以让宿主直接读取安装目录中的 `SKILL.md` 并按协议调用。
-
-已有同名 `buddy-creator` 时，先备份旧 Skill 文件，再替换程序、规则和预览资源。**不要删除、移动或覆盖创作者工作目录。**若发现用户项目误存于旧安装目录，应先保留该目录并将新版安装到独立位置，不能把项目当作旧程序清理。旧 `buddy-creator-no-node` 试用版可保留；安装后明确使用 `$buddy-creator`，避免混用入口。
-
-## 开始与继续
-
-新项目不继承其他作品；用户已经给出主题时，宿主通过 `open --context` 传入背景并接着聊，不重新介绍或询问已明确的方向。宿主在创作目录中使用实际发现的 Python 调用 `scripts/buddy.py`，按 `SKILL.md` 分配项目身份；安装目录只存程序，不存作品。创作者不需要自行拼接命令。
-
-已有 Python 无 Node 试用版项目，可由新版调用 `open --workspace <原项目绝对路径> --no-browser` 接续，保留原话、进度与确认。此前 Node 0.x 版本的项目及 SQLite/LangGraph 检查点不自动迁移；如需参考，只导入创作者明确选择的手册或资料，不继承历史确认。
-
-采访、修改和确认都发生在宿主主对话；浏览器在本机地址展示只读预览。宿主环境需要允许启动本机预览服务，并具有访问该地址的浏览器能力。预览资源已包含在包内，浏览器不负责运行采访模型。
-
-本版本未宣称所有宿主和系统组合已完成实机验收。资料读取依赖宿主实际可用工具；不包含小红书账号蒸馏或 coding CLI mock handoff。

package/resources/buddy-creator/PATCHES.md

@@ -1,53 +0,0 @@
-# BuddyCLI 本地补丁
-
-## development-after-design-acceptance
-
-统一 Skill、宿主协议、CLI 接续说明和实现指引的开发入口：四册确认后进入小挂件清单、原型和设计验收；以 creator_complete 与有效 ready 交付为完成信号。完整创建任务由当前 Coding Agent 同一轮自动衔接开发，不停在成果链接或增加开始确认。Booklet 交付区同步交接规则，不伪造工程进度；独立设计、流程测试和暂停仍遵守用户范围。保持现有版本、确认和交付校验协议。
-
-## small-widget-distinct-layouts
-
-第 4 版通过内容结构区分小挂件：日期预览、分组凭条、账本金额、成员分类与变更对照。对话卡片和展开页使用同一份数据生成不同的预览形态。新增只读 changes 布局与受限 before/after 字段，强制区分待确认建议和已生效变化。前三版保持原样，视觉变更提交新原型并使旧验收失效。
-
-## small-widget-quiet-blue
-
-第 3 版改为白底与可配置的单一强调色，当前旅行示例用蓝色。减少装饰图标、重复统计、胶囊标签与实色按钮，使用下划线导航、细分隔线与内容排版。前两版渲染资源保持原样；新视觉按新版本重新确认。只读交互、尺寸与字体边界不变。
-
-## small-widget-visuals
-
-新增第 2 版原型渲染器：按阅读任务提供时间线、事项卡、账目、物品清单与资料列表，支持主题概览、关键指标、只读状态、固定线性图标及有数据依据的比例条。对话摘要卡片与展开页共享内容层级，HTML 与 SVG 复用组件；SVG 使用浏览器支持的 foreignObject。第 1 版模板保留原始字节，旧原型恢复不会自动换样式；视觉升级提交新原型并重新确认。Booklet 页面移除共用阅读规范大卡片，规范继续由 Skill、渲染器和验收执行。
-
-## small-widget-design
-
-新项目在固定四册后增加只读小挂件清单、原型和设计验收，复用公开展示与真实确认协议。Booklet 新增设计页，同步两视图三态、版本依赖、自动检查、开发者验收和可用成果。原型采用受限声明式模板，禁止输入与业务写入。交付检查全部必需文件；按项失效，四册内容另有独立指纹。旧项目不自动重开，明确追加才启用。新增 widgets.py、widget_render.py 及参考文件、页面模块，不修改上游预构建 React 逻辑。面板提醒跨全部阶段沿用一次性记录。
-
-上游基线：Buddy Creator Skill 1.3.0，commit `f642ddd59e1c30a5d4d3a2e9f6a6811f61ce1f2f`。
-CLI 内置 Creator 版本为 `1.4.0`，上游基线记录保留上述版本与 commit。
-保留清单中已有的 `initial-context-opening`、`completion-return` 本地改动；本次增加 `interaction-reliability` 补丁。
-
-本补丁改善一次完整创作模拟中发现的交互可靠性问题：
-
-- 确认失败报告具体对象、未决项、采访缺口、阶段门槛和路径字段差异。
-- JSON 输入拒绝交互式 TTY，文件及非 TTY 管道保持支持；JSON 语法错误包含行列。
-- 输出管道关闭时提示核对持久状态，不把丢失回执当作写入未发生。
-- 普通读取、提交及无 creation-key 的恢复不会创建不存在的工作区。
-- 提供绑定工作区的标准库 BuddyClient，从已保存回执生成版本引用。
-- 蓝图允许显式引用已确认路径，验证版本后复制内容并登记依赖；原有完整对象提交继续有效。
-
-工作区格式仍为 `buddy-creator-1`。不迁移或重写已有作品，不改变采访次数、确认授权、必需依赖、未决项或版本一致性规则。资源清单保留上游基线及本地补丁标记，按实际随包文件校验哈希；后续同步上游时应显式核对这些改动。
-
-## 开发者平台品牌一致性
-
-创作手册预览接入平台共用的青蓝色品牌资源，支持系统浅色/深色主题，统一 Logo、文字、边框、状态色与圆角。保留上游只读交互和内容结构；预构建样式中的固定颜色替换为平台语义变量。`assets/preview/brand.css` 和 `brand-logo.png` 由仓库 `sync:brand` 同步并单独更新校验记录。
-
-## Booklet 阅读交互
-
-`assets/preview/reader.css` 与 `reader.js` 提供独立的阅读层：对齐平台的青蓝色、字体、圆角、按钮、标签切换、正文间距和弹窗；从已渲染章节生成目录，支持跳转、当前位置高亮和小屏折叠。目录不读取或修改访谈状态。
-
-预构建应用只增加 `buddy:reader-browse` 事件的订阅与清理，接到目录跳转时暂停自动跟随，继续复用上游实时更新时的阅读位置保护。复制修改引用及对象版本、确认规则、数据端点和章节内容保持上游实现。同步上游时需保留或移植这一事件桥和阅读层。
-
-## preview-panel-reopen
-
-- 宿主在接续、阶段切换或展示手册等自然节点查询本作品界面，区分打开、关闭与未知；服务连通性不代替界面检测。
-- 新增标准库 `preview-panel` 命令，将实际观察与一次性提醒写入独立 preview-panel.json；用过一次提醒后，未回应、拒绝或曾同意都不再主动询问，跨接续保留。
-- 提示一次说明查看内容与进度的用途，并给出“请帮我重新打开 Booklet 面板”的主动入口；明确请求直接恢复原作品。
-- 面板操作不改变采访原话、计数、产物、确认或作品版本；不修改预览读写协议。状态检测与实际打开由宿主能力承担，工具只保证提醒记录与去重。