tavern-harness 0.1.12 → 0.1.13

package/src/components/Sidebar.tsx

@@ -1,5 +1,6 @@
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
+import { QRCodeSVG } from 'qrcode.react';
 import { useStore } from '../store/store';
 import { db } from '../db/database';
 import { Icon, Modal, SessionVisual } from './shared';
@@ -7,6 +8,10 @@ import type { SessionMember } from './shared';
 import type { ChatSession, NpcCharacter } from '../types/models';
 import { NewSessionMenu } from './NewSessionMenu';
 import { useT } from '../core/i18n';
+import { useTouchLongPress } from '../core/longPress';
+import { fixedViewportPoint } from '../core/viewport';
+import { useHasUnseenVersion } from '../core/version';
+import { PopoverMenu } from './PopoverMenu';
 
 const SIDEBAR_MIN = 240;
 const SIDEBAR_MAX = 520;
@@ -19,6 +24,7 @@ function openGlobalGameplayExport(sessionId: number, includeHistory: boolean) {
 }
 
 export function Sidebar() {
+  const [mobileOpen, setMobileOpen] = useState(false);
   const sessions = useStore((s) => s.sessions);
   const npcs = useStore((s) => s.npcs);
   const activeSessionId = useStore((s) => s.activeSessionId);
@@ -31,16 +37,32 @@ export function Sidebar() {
   const togglePin = useStore((s) => s.togglePin);
   const addToast = useStore((s) => s.addToast);
   const t = useT();
+  const hasUnseenVersion = useHasUnseenVersion();
 
   const [showNew, setShowNew] = useState(false);
   const [confirmDelete, setConfirmDelete] = useState<ChatSession | null>(null);
   const [editTarget, setEditTarget] = useState<ChatSession | null>(null);
   const [sessionMenu, setSessionMenu] = useState<{ session: ChatSession; x: number; y: number } | null>(null);
   const [query, setQuery] = useState('');
+  const [appUrl, setAppUrl] = useState(() => window.location.href);
   // 搜索命中的会话 id 集合（null = 未在搜索中）
   const [searchHits, setSearchHits] = useState<Set<number> | null>(null);
   // 群聊会话 → 参与者中的 NPC 角色
   const [groupMembers, setGroupMembers] = useState<Record<number, NpcCharacter[]>>({});
+  const sessionLongPressTarget = useRef<ChatSession | null>(null);
+  const sessionLongPressProps = useTouchLongPress(
+    (point) => {
+      const session = sessionLongPressTarget.current;
+      if (session) setSessionMenu({ session, ...fixedViewportPoint(point) });
+    },
+    (event) => {
+      // 键盘 / 触屏补发的 contextmenu 未必经过 pointerdown，用行上记录的 id 兜底。
+      const id = Number(event.currentTarget.dataset.sessionId);
+      const session = (Number.isFinite(id) ? sessions.find((item) => item.id === id) : null)
+        ?? sessionLongPressTarget.current;
+      if (session) setSessionMenu({ session, ...fixedViewportPoint({ x: event.clientX, y: event.clientY }) });
+    },
+  );
 
   // 可拖拽侧边栏宽度
   const [sidebarW, setSidebarW] = useState<number>(() => {
@@ -55,6 +77,27 @@ export function Sidebar() {
     localStorage.setItem('tav-sidebar-w', String(sidebarW));
   }, [sidebarW]);
 
+  useEffect(() => {
+    let cancelled = false;
+    const updateAppUrl = async () => {
+      try {
+        const response = await fetch('/api-v2/lan-address', { cache: 'no-store' });
+        const { url } = await response.json() as { url?: string | null };
+        if (!cancelled) setAppUrl(url || window.location.href);
+      } catch {
+        if (!cancelled) setAppUrl(window.location.href);
+      }
+    };
+    void updateAppUrl();
+    window.addEventListener('popstate', updateAppUrl);
+    window.addEventListener('hashchange', updateAppUrl);
+    return () => {
+      cancelled = true;
+      window.removeEventListener('popstate', updateAppUrl);
+      window.removeEventListener('hashchange', updateAppUrl);
+    };
+  }, []);
+
   useEffect(() => {
     const onMove = (e: MouseEvent) => {
       const d = dragRef.current;
@@ -178,9 +221,36 @@ export function Sidebar() {
       colorOrdinal: n.avatarColorOrdinal,
       imageUrl: n.avatarDataUrl,
     }));
-
   return (
-    <aside className="sidebar">
+    <>
+      <div className="mobile-topbar">
+        <button
+          className="mobile-nav-toggle"
+          type="button"
+          aria-label={mobileOpen ? t('common.close') : t('nav.sessions')}
+          aria-expanded={mobileOpen}
+          onClick={() => setMobileOpen((open) => !open)}
+        >
+          <Icon name={mobileOpen ? 'x' : 'menu'} size={22} />
+        </button>
+        <nav className="mobile-topbar-nav" aria-label={t('nav.chat')}>
+          <button className={`nav-chip ${activeView === 'chat' ? 'active' : ''}`} onClick={() => setActiveView('chat')}>
+            <Icon name="send" size={15} /> <span>{t('nav.chat')}</span>
+          </button>
+          <button className={`nav-chip ${activeView === 'characters' ? 'active' : ''}`} onClick={() => setActiveView('characters')}>
+            <Icon name="users" size={15} /> <span>{t('nav.characters')}</span>
+          </button>
+          <button className={`nav-chip ${activeView === 'stats' ? 'active' : ''}`} onClick={() => setActiveView('stats')}>
+            <Icon name="trophy" size={15} /> <span>{t('nav.achievements')}</span>
+          </button>
+          <button className={`nav-chip ${activeView === 'settings' ? 'active' : ''}`} onClick={() => setActiveView('settings')}>
+            <Icon name="settings" size={15} /> <span>{t('nav.settings')}</span>
+            {hasUnseenVersion && <span className="unseen-dot" title={t('changelog.unseen')} />}
+          </button>
+        </nav>
+      </div>
+      {mobileOpen && <button className="mobile-sidebar-backdrop" type="button" aria-label={t('common.close')} onClick={() => setMobileOpen(false)} />}
+      <aside className={`sidebar ${mobileOpen ? 'mobile-open' : ''}`}>
       <div className="sidebar-head">
         <div
           className="brand"
@@ -198,10 +268,14 @@ export function Sidebar() {
           <div className="brand-logo">
             <img src="/tavern-harness-logo.png" alt="Tavern Harness" style={{ width: '100%', height: '100%', objectFit: 'cover', borderRadius: '50%' }} />
           </div>
-          <div>
+          <div className="brand-copy">
             <div className="brand-name">Tavern Harness</div>
             <div className="brand-sub">{t('nav.brandSub')}</div>
           </div>
+          <div className="brand-qr" title={t('nav.qrHint')}>
+            <QRCodeSVG value={appUrl} size={52} level="H" includeMargin={false} fgColor="var(--primary)" bgColor="transparent" />
+            <span className="brand-qr-icon"><Icon name="phone" size={9} /></span>
+          </div>
         </div>
         <div className="side-nav" data-hscroll>
           <button className={`nav-chip ${activeView === 'chat' ? 'active' : ''}`} onClick={() => setActiveView('chat')}>
@@ -215,6 +289,7 @@ export function Sidebar() {
           </button>
           <button className={`nav-chip ${activeView === 'settings' ? 'active' : ''}`} onClick={() => setActiveView('settings')}>
             <Icon name="settings" size={13} /> {t('nav.settings')}
+            {hasUnseenVersion && <span className="unseen-dot" title={t('changelog.unseen')} />}
           </button>
         </div>
       </div>
@@ -245,11 +320,20 @@ export function Sidebar() {
             <button
               key={s.id}
               className={`session-item ${s.id === activeSessionId && activeView === 'chat' ? 'active' : ''}`}
-              onClick={() => setActiveSession(s.id!)}
-              onContextMenu={(e) => {
-                e.preventDefault();
-                setSessionMenu({ session: s, x: e.clientX, y: e.clientY });
+              data-session-id={s.id}
+              onClick={() => {
+                setActiveSession(s.id!);
+                setMobileOpen(false);
+              }}
+              onPointerDown={(event) => {
+                sessionLongPressTarget.current = s;
+                sessionLongPressProps.onPointerDown(event);
               }}
+              onPointerMove={sessionLongPressProps.onPointerMove}
+              onPointerUp={sessionLongPressProps.onPointerUp}
+              onPointerCancel={sessionLongPressProps.onPointerCancel}
+              onClickCapture={sessionLongPressProps.onClickCapture}
+              onContextMenu={sessionLongPressProps.onContextMenu}
             >
               {s.mode === 'NPC' ? (
                 <SessionVisual mode="NPC" npcName={npc?.name ?? 'NPC'} hue={npc?.avatarColorOrdinal ?? 0} imageUrl={npc?.avatarDataUrl} />
@@ -305,53 +389,48 @@ export function Sidebar() {
 
       {sessionMenu &&
         createPortal(
-          <>
-            <div className="overlay-msg" onClick={() => setSessionMenu(null)} />
-            <div
-              className="msg-menu card"
-              style={{
-                left: Math.max(8, Math.min(sessionMenu.x, window.innerWidth - 196)),
-                top: Math.max(8, Math.min(sessionMenu.y, window.innerHeight - 132)),
+          <PopoverMenu
+            key={`${sessionMenu.x}:${sessionMenu.y}:${sessionMenu.session.id ?? ''}`}
+            point={sessionMenu}
+            onClose={() => setSessionMenu(null)}
+          >
+            <button className="msg-menu-item" onClick={() => openEdit(sessionMenu.session)}>
+              <Icon name="pencil" size={13} /> {t('nav.editSession')}
+            </button>
+            <button
+              className="msg-menu-item"
+              onClick={async () => {
+                await togglePin(sessionMenu.session.id!);
+                setSessionMenu(null);
+                addToast(
+                  (sessionMenu.session as { pinned?: unknown }).pinned
+                    ? t('toast.sessionUnpinned')
+                    : t('toast.sessionPinned')
+                );
               }}
             >
-              <button className="msg-menu-item" onClick={() => openEdit(sessionMenu.session)}>
-                <Icon name="pencil" size={13} /> {t('nav.editSession')}
-              </button>
-              <button
-                className="msg-menu-item"
-                onClick={async () => {
-                  await togglePin(sessionMenu.session.id!);
-                  setSessionMenu(null);
-                  addToast(
-                    (sessionMenu.session as { pinned?: unknown }).pinned
-                      ? t('toast.sessionUnpinned')
-                      : t('toast.sessionPinned')
-                  );
-                }}
-              >
-                <Icon name="pin" size={13} /> {(sessionMenu.session as { pinned?: unknown }).pinned ? t('nav.unpinSession') : t('nav.pinSession')}
-              </button>
-              <button
-                className="msg-menu-item"
-                onClick={() => {
-                  const target = sessionMenu.session;
-                  setSessionMenu(null);
-                  openGlobalGameplayExport(target.id!, true);
-                }}
-              >
-                <Icon name="share" size={13} /> {t('nav.exportGameplay')}
-              </button>
-              <button
-                className="msg-menu-item danger"
-                onClick={() => {
-                  setConfirmDelete(sessionMenu.session);
-                  setSessionMenu(null);
-                }}
-              >
-                <Icon name="trash" size={13} /> {t('nav.deleteSession')}
-              </button>
-            </div>
-          </>,
+              <Icon name="pin" size={13} /> {(sessionMenu.session as { pinned?: unknown }).pinned ? t('nav.unpinSession') : t('nav.pinSession')}
+            </button>
+            <button
+              className="msg-menu-item"
+              onClick={() => {
+                const target = sessionMenu.session;
+                setSessionMenu(null);
+                openGlobalGameplayExport(target.id!, true);
+              }}
+            >
+              <Icon name="share" size={13} /> {t('nav.exportGameplay')}
+            </button>
+            <button
+              className="msg-menu-item danger"
+              onClick={() => {
+                setConfirmDelete(sessionMenu.session);
+                setSessionMenu(null);
+              }}
+            >
+              <Icon name="trash" size={13} /> {t('nav.deleteSession')}
+            </button>
+          </PopoverMenu>,
           document.body
         )}
 
@@ -387,6 +466,7 @@ export function Sidebar() {
           document.body.classList.add('resizing');
         }}
       />
-    </aside>
+      </aside>
+    </>
   );
 }

package/src/components/VersionHistoryModal.tsx

@@ -0,0 +1,114 @@
+import { useEffect } from 'react';
+import { CHANGELOG, compareUrl, entryGroups, type ChangelogEntry, type ChangelogGroup } from '../core/changelog';
+import { currentLanguage, useT } from '../core/i18n';
+import { APP_VERSION, markVersionSeen } from '../core/version';
+import { Icon, Modal } from './shared';
+
+// ============================================================
+// 版本记录弹窗（设置 → 关于）
+// ============================================================
+
+/** 行内格式：只支持 `code` 与 **强调**，不引入完整 Markdown 渲染 */
+function InlineText({ text }: { text: string }) {
+  const parts = text.split(/(`[^`]+`|\*\*[^*]+\*\*)/g).filter(Boolean);
+  return (
+    <>
+      {parts.map((part, index) => {
+        if (part.length > 2 && part.startsWith('`') && part.endsWith('`')) {
+          return <code key={index}>{part.slice(1, -1)}</code>;
+        }
+        if (part.length > 4 && part.startsWith('**') && part.endsWith('**')) {
+          return <strong key={index}>{part.slice(2, -2)}</strong>;
+        }
+        return <span key={index}>{part}</span>;
+      })}
+    </>
+  );
+}
+
+function GroupList({ group }: { group: ChangelogGroup }) {
+  const t = useT();
+  const items = (
+    <ul>
+      {group.items.map((item, index) => (
+        <li key={index}>
+          <InlineText text={item} />
+        </li>
+      ))}
+    </ul>
+  );
+
+  if (group.kind === 'internal') {
+    return (
+      <details className="changelog-group changelog-internal">
+        <summary>{t('changelog.internal')}</summary>
+        {items}
+      </details>
+    );
+  }
+
+  return (
+    <section className="changelog-group">
+      <h4>{t(`changelog.${group.kind}`)}</h4>
+      {items}
+    </section>
+  );
+}
+
+function Entry({ entry, isCurrent }: { entry: ChangelogEntry; isCurrent: boolean }) {
+  const t = useT();
+  const groups = entryGroups(entry, currentLanguage());
+  return (
+    <article className={`changelog-entry ${isCurrent ? 'current' : ''}`}>
+      <header className="changelog-entry-head">
+        <h3>v{entry.version}</h3>
+        <time dateTime={entry.date}>{entry.date}</time>
+        <span className="changelog-flags">
+          {isCurrent && <span className="changelog-flag">{t('changelog.currentTag')}</span>}
+          {entry.breaking && <span className="changelog-flag breaking">{t('changelog.breaking')}</span>}
+        </span>
+      </header>
+      {groups.map((group) => (
+        <GroupList key={group.kind} group={group} />
+      ))}
+      <a
+        className="changelog-compare"
+        href={compareUrl(entry)}
+        target="_blank"
+        rel="noopener noreferrer"
+      >
+        {entry.compare ?? `v${entry.version}`} ↗
+      </a>
+    </article>
+  );
+}
+
+export function VersionHistoryModal({ onClose }: { onClose: () => void }) {
+  const t = useT();
+
+  useEffect(() => {
+    markVersionSeen();
+  }, []);
+
+  return (
+    <Modal onClose={onClose} width="min(720px, calc(100vw - 24px))">
+      <div className="modal-head">
+        <span style={{ fontWeight: 800, fontSize: 15 }}>{t('changelog.title')}</span>
+        <button className="icon-btn" onClick={onClose} aria-label={t('common.close')}>
+          <Icon name="x" />
+        </button>
+      </div>
+      <div className="modal-body changelog-body">
+        <p className="changelog-meta">{t('changelog.current', { version: APP_VERSION })}</p>
+        {CHANGELOG.entries.map((entry) => (
+          <Entry key={entry.version} entry={entry} isCurrent={entry.version === APP_VERSION} />
+        ))}
+      </div>
+      <div className="modal-foot">
+        <button className="btn btn-primary" onClick={onClose}>
+          {t('common.close')}
+        </button>
+      </div>
+    </Modal>
+  );
+}

package/src/components/shared.tsx

@@ -156,10 +156,16 @@ export function Avatar({
   const cls = size === 'lg' ? 'avatar' : size === 'xs' ? 'avatar xs' : 'avatar sm';
   const hue = (colorOrdinal ?? 0) % 6;
   if (imageUrl) {
+    // 用背景图而不是 <img>：微信 Android 内置浏览器会对 <img> 的长按弹出
+    // “发送给朋友 / 保存图片”。命中测试落在宿主 div 上就不会触发原生菜单；
+    // pointer-events: none 再让点击/滚动继续冒泡给外层（见 global.css）。
     return (
-      <div className={cls}>
-        <img src={imageUrl} alt={name} />
-      </div>
+      <div
+        className={`${cls} avatar-image`}
+        role="img"
+        aria-label={name}
+        style={{ backgroundImage: `url(${JSON.stringify(imageUrl)})` }}
+      />
     );
   }
   return <div className={`${cls} avatar-hue-${hue}`}>{name.slice(0, 1)}</div>;
@@ -330,7 +336,9 @@ const ICONS: Record<string, React.ReactNode> = {
   file: <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8l-6-6zM14 2v6h6" />,
   trophy: <><path d="M6 9H4.5a2.5 2.5 0 0 1 0-5H6M18 9h1.5a2.5 2.5 0 0 0 0-5H18" /><path d="M4 22h16M10 14.66V17c0 .55-.47.98-.97 1.21C7.85 18.75 7 20.24 7 22M14 14.66V17c0 .55.47.98.97 1.21C16.15 18.75 17 20.24 17 22" /><path d="M18 2H6v7a6 6 0 0 0 12 0V2Z" /></>,
   more: <><circle cx="5" cy="12" r="1.6" /><circle cx="12" cy="12" r="1.6" /><circle cx="19" cy="12" r="1.6" /></>,
+  menu: <><path d="M4 6h16" /><path d="M4 12h16" /><path d="M4 18h16" /></>,
   image: <><rect x="3" y="3" width="18" height="18" rx="2" /><circle cx="9" cy="9" r="2" /><path d="m21 15-5-5L5 21" /></>,
+  phone: <><rect x="6" y="2" width="12" height="20" rx="2" /><path d="M11 18h2" /></>,
   check: <path d="M20 6 9 17l-5-5" />,
   cancel: <path d="M18 6 6 18M6 6l12 12" />,
   x: <path d="M18 6 6 18M6 6l12 12" />,
@@ -348,6 +356,7 @@ const ICONS: Record<string, React.ReactNode> = {
   'text-wrap': <><path d="M4 6h13a4 4 0 0 1 0 8H9" /><path d="m12 11-3 3 3 3M4 18h3" /></>,
   eye: <><path d="M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7-10-7-10-7z" /><circle cx="12" cy="12" r="3" /></>,
   folder: <><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z" /></>,
+  copy: <><rect x="8" y="8" width="13" height="13" rx="2" /><path d="M5 16V6a2 2 0 0 1 2-2h10" /></>,
 };
 
 export function Icon({ name, size = 15 }: { name: string; size?: number }) {

package/src/core/browserPreferences.ts

@@ -0,0 +1,45 @@
+import type { AppLanguage, ThemeModeId } from '../types/models';
+
+const BROWSER_UI_PREFERENCES_KEY = 'th-browser-ui-preferences';
+
+export interface BrowserUiPreferences {
+  language: AppLanguage;
+  themeMode: ThemeModeId;
+}
+
+const DEFAULT_BROWSER_UI_PREFERENCES: BrowserUiPreferences = {
+  language: null,
+  themeMode: 'system',
+};
+
+export function hasBrowserUiPreferences(): boolean {
+  try {
+    return localStorage.getItem(BROWSER_UI_PREFERENCES_KEY) != null;
+  } catch {
+    return false;
+  }
+}
+
+export function readBrowserUiPreferences(): BrowserUiPreferences {
+  try {
+    const parsed: unknown = JSON.parse(localStorage.getItem(BROWSER_UI_PREFERENCES_KEY) || '{}');
+    if (!parsed || typeof parsed !== 'object') return DEFAULT_BROWSER_UI_PREFERENCES;
+    const value = parsed as Partial<BrowserUiPreferences>;
+    return {
+      language: value.language === 'zh-CN' || value.language === 'zh-TW' || value.language === 'en' ? value.language : null,
+      themeMode: value.themeMode === 'light' || value.themeMode === 'dark' || value.themeMode === 'system' ? value.themeMode : 'system',
+    };
+  } catch {
+    return DEFAULT_BROWSER_UI_PREFERENCES;
+  }
+}
+
+export function saveBrowserUiPreferences(preferences: Partial<BrowserUiPreferences>): BrowserUiPreferences {
+  const next = { ...readBrowserUiPreferences(), ...preferences };
+  try {
+    localStorage.setItem(BROWSER_UI_PREFERENCES_KEY, JSON.stringify(next));
+  } catch {
+    // Private browsing and blocked storage keep the current-page preference only.
+  }
+  return next;
+}

package/src/core/changelog.ts

@@ -0,0 +1,43 @@
+import data from '../generated/changelog.json';
+
+// ============================================================
+// 版本记录（由 scripts/changelog.mjs 从 changelog/v*.md 生成）
+// 条目正文不放进 i18n 字典：每发一版只改数据源，不用同步三份文案。
+// ============================================================
+
+export type ChangelogKind = 'added' | 'changed' | 'fixed' | 'internal';
+
+export interface ChangelogGroup {
+  kind: ChangelogKind;
+  items: string[];
+}
+
+export interface ChangelogEntry {
+  version: string;
+  date: string;
+  breaking: boolean;
+  compare: string | null;
+  groups: {
+    'zh-CN': ChangelogGroup[];
+    en: ChangelogGroup[];
+  };
+}
+
+interface ChangelogData {
+  latest: string | null;
+  repo: string;
+  entries: ChangelogEntry[];
+}
+
+export const CHANGELOG = data as unknown as ChangelogData;
+
+/** 取当前界面语言对应的条目；繁體中文回退到简体中文（版本记录不维护第三份文案） */
+export function entryGroups(entry: ChangelogEntry, language: string): ChangelogGroup[] {
+  return entry.groups[language === 'en' ? 'en' : 'zh-CN'] ?? entry.groups['zh-CN'];
+}
+
+export function compareUrl(entry: ChangelogEntry): string {
+  return entry.compare
+    ? `${CHANGELOG.repo}/compare/${entry.compare}`
+    : `${CHANGELOG.repo}/releases/tag/v${entry.version}`;
+}

package/src/core/characterBook.ts

@@ -198,6 +198,38 @@ export function hasUsableCharacterBook(characterBook: string | undefined): boole
   }));
 }
 
+/** 知识库条目统计：总条目数与可参与召回的条目数（已启用且内容非空）。 */
+export function characterBookEntryStats(characterBook: string | undefined): { total: number; enabled: number } {
+  const book = parseCharacterBook(characterBook);
+  const entries = Array.isArray(book?.entries)
+    ? book.entries.map(asRecord).filter(Boolean) as CharacterBookEntry[]
+    : [];
+  let enabled = 0;
+  for (const entry of entries) {
+    if (entry.enabled !== false && typeof entry.content === 'string' && entry.content.trim()) enabled++;
+  }
+  return { total: entries.length, enabled };
+}
+
+/**
+ * 合并多个知识库（Character Book JSON）：角色卡知识库 + 所选世界书知识库。
+ * 召回参数取并集：扫描深度取最大值、预算累加、递归扫描任一开启即开启；
+ * 条目按各自顺序保留，召回时统一按 insertion order 排序。
+ */
+export function mergeCharacterBooks(...sources: Array<string | null | undefined>): string | undefined {
+  const valid = sources
+    .map((source) => ({ source, book: parseCharacterBook(source ?? undefined) }))
+    .filter((item): item is { source: string; book: CharacterBook } => item.book != null && Boolean(item.source?.trim()));
+  if (valid.length === 0) return undefined;
+  if (valid.length === 1) return valid[0].source;
+  return JSON.stringify({
+    scan_depth: Math.max(...valid.map(({ book }) => positiveInt(book.scan_depth, DEFAULT_SCAN_DEPTH))),
+    token_budget: valid.reduce((total, { book }) => total + positiveInt(book.token_budget, DEFAULT_TOKEN_BUDGET), 0),
+    recursive_scanning: valid.some(({ book }) => toBoolean(book.recursive_scanning)),
+    entries: valid.flatMap(({ book }) => (Array.isArray(book.entries) ? book.entries : [])),
+  });
+}
+
 function retrieveCharacterBook(characterBook: string | undefined, messages: NetworkMessage[]): RetrievedCharacterBookContext | null {
   const book = parseCharacterBook(characterBook);
   if (!book) return null;

package/src/core/clipboard.ts

@@ -0,0 +1,32 @@
+/**
+ * 复制文本到剪贴板。
+ *
+ * 局域网 http 访问不是安全上下文，`navigator.clipboard` 不可用，
+ * 此时退回已废弃但兼容性最好的 `document.execCommand('copy')`。
+ *
+ * @returns 是否复制成功
+ */
+export async function copyText(text: string): Promise<boolean> {
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    // 非安全上下文 / 无权限：走下面的兜底
+  }
+
+  const helper = document.createElement('textarea');
+  helper.value = text;
+  helper.setAttribute('readonly', '');
+  helper.style.cssText = 'position:fixed;left:-9999px;top:0;opacity:0;';
+  document.body.appendChild(helper);
+  helper.select();
+
+  let copied = false;
+  try {
+    copied = document.execCommand('copy');
+  } catch {
+    copied = false;
+  }
+  helper.remove();
+  return copied;
+}

package/src/core/editable.ts

@@ -0,0 +1,26 @@
+/**
+ * 文本输入控件的判定（输入框、文本域、contenteditable）。
+ *
+ * 键盘 / 视口逻辑（`mobileViewport.ts`）和微信长按兜底（`wechatTouch.ts`）
+ * 共用同一份判定，避免两处选择器不一致。
+ *
+ * 注意：`mobileViewport.ts` 会被 Node 单测直接加载，所以从它引用的模块
+ * 需要显式带 `.ts` 后缀（Node 的 ESM 解析不补后缀）。
+ */
+
+const EDITABLE_SELECTOR =
+  'input, textarea, [contenteditable=""], [contenteditable="true"], [contenteditable="plaintext-only"]';
+
+function closestElement(node: Node | null): Element | null {
+  return node instanceof Element ? node : node?.parentElement ?? null;
+}
+
+/** 事件目标（或其祖先）是否是可编辑控件。 */
+export function isEditableTarget(target: EventTarget | null): boolean {
+  return target instanceof Element && target.closest(EDITABLE_SELECTOR) != null;
+}
+
+/** 选区端点可能是文本节点，先取最近的元素再判断。 */
+export function isEditableNode(node: Node | null): boolean {
+  return closestElement(node)?.closest(EDITABLE_SELECTOR) != null;
+}

package/src/core/gameplay.ts

@@ -307,6 +307,7 @@ export async function importGameplay(payload: unknown): Promise<ImportGameplayRe
       name: finalName,
       prompt: source.prompt ?? '',
       greeting: source.greeting ?? '',
+      characterBook: source.characterBook,
       alternateGreetings: source.alternateGreetings ?? [],
       avatarColorOrdinal: source.avatarColorOrdinal ?? 0,
       avatarDataUrl: source.avatarDataUrl ?? null,
@@ -338,6 +339,7 @@ export async function importGameplay(payload: unknown): Promise<ImportGameplayRe
     worldBookId = await db.worldBooks.add({
       name: finalName,
       content: data.worldBook.content ?? '',
+      characterBook: data.worldBook.characterBook,
       imageUri: null,
       createdAt: Date.now(),
     });