@bolloon/bolloon-agent 0.4.23 → 0.4.25

package/dist/web/mobile-privacy.js

@@ -0,0 +1,185 @@
+/**
+ * mobile-privacy.ts — 手机端隐私合规: 首启同意门 + 应用内政策摘要 + 本机数据注销
+ *
+ * 为什么单独成模块: 这三件事都必须能被单测锁住 —— 摘要少一个必填要素、同意版本号算错、
+ * 注销漏删一个库, 都是"上架被拒/合规缺口"级别的问题, 不能只靠肉眼看 UI。
+ *
+ * 上架要求对照 (华为/工信部口径):
+ *   ① 首次启动必须先展示隐私政策, 用户同意前不得收集任何信息/申请任何权限 → needsPrivacyConsent + 门
+ *   ② 隐私政策须含: 收集类型 · 用途 · 存储期限 · 第三方 SDK 清单 · 账号注销路径 → PRIVACY_SUMMARY
+ *   ③ 必须提供注销入口且处理时限 ≤ 7 个工作日 → WIPE_TARGETS + wipeLocalData (本地即时)
+ */
+/** localStorage 键: 记录用户已同意的政策版本 */
+export const PRIVACY_CONSENT_KEY = 'bolloon_privacy_consent';
+/** 政策版本: 摘要或权威页内容发生实质变化时必须 +1 → 会重新征求同意 */
+export const PRIVACY_CONSENT_VERSION = '1';
+/** 权威政策页 (应用市场表单要填的链接; 应用内摘要以它为准) */
+export const PRIVACY_POLICY_URL = 'https://bolloon.cn/privacy.html';
+/** APP 备案号: 备案完成后填入 (形如 浙ICP备XXXXXXXX号-XA), 留空时 UI 显示"备案办理中" */
+export const APP_FILING_NO = '';
+/** 主体联系邮箱 (政策里承诺 7 个工作日答复) */
+export const PRIVACY_CONTACT = 'yuanjieliu65@gmail.com';
+/** 注销时限承诺 (工作日) */
+export const WIPE_SLA_WORKDAYS = 7;
+/**
+ * 应用内政策摘要 —— 必须覆盖上架要求的必填要素。
+ * 单测逐个要素断言 (mobile-privacy.test.ts), 删要素即红。
+ */
+export const PRIVACY_SUMMARY = [
+    {
+        title: '一、我们收集什么',
+        body: '本机生成的网络身份标识（DID）与密钥、你创建的智能体、会话与消息内容、好友与已知节点列表。' +
+            '这些数据默认只保存在你自己的设备上（IndexedDB），我们不设账号体系，不收集手机号、邮箱、通讯录、' +
+            '短信、通话记录、精确定位、设备唯一标识（IMEI/MAC/广告标识），也不做使用行为统计。',
+    },
+    {
+        title: '二、用途',
+        body: '上述数据仅用于提供你要求的功能：P2P 连接与身份验证、智能体会话、本地存储与展示。' +
+            '我们不用于广告、画像或向第三方出售。',
+    },
+    {
+        title: '三、存储位置与期限',
+        body: '全部保存在本机。卸载应用或在「设置 → 清除本机数据（注销）」即删除；我们服务器上没有你的副本，' +
+            '因此不存在"提交删除申请后还要等待"的环节。',
+    },
+    {
+        title: '四、第三方 SDK 与服务',
+        body: '你自选的大模型服务商（API Key 由你填写，你的设备直连该服务商，我们不经手）；' +
+            '网站与安装包托管 Cloudflare / GitHub（境外）、版本号查询 npm registry、网页字体 Google Fonts。' +
+            '本应用不集成任何广告、行为统计或崩溃上报 SDK。若你启用微支付，链上交易记录公开且不可删除。',
+    },
+    {
+        title: '五、系统权限',
+        body: '蓝牙扫描与连接：发现并连接附近设备与好友（已声明 neverForLocation，不用于推断位置）。' +
+            '位置权限：仅 Android 11 及以下系统要求蓝牙扫描需要它（已限制 maxSdkVersion=30，Android 12+ 不再申请）。' +
+            '网络：P2P 连接与下载。相机：调用系统相机应用完成拍摄，本应用不申请相机权限。' +
+            '完全访问权限（让智能体在这台手机上点按、滑动屏幕或调用系统能力）与 Shizuku：仅官网直装版本包含，默认开启' +
+            '（首次使用会直接带你去系统开关页确认一次，之后一直有效）、随时可以关闭；' +
+            '应用商店下载的版本不含这两项，也没有这个能力。',
+    },
+    {
+        title: '六、你的权利与注销',
+        body: '你可以随时在本机查看、修改、删除全部数据。注销入口：设置 → 清除本机数据（注销），' +
+            '即时删除本机数据（异常情况最长 ' + WIPE_SLA_WORKDAYS + ' 个工作日）。' +
+            '已经写入公开区块链的交易记录任何服务方都无法删除。',
+    },
+    {
+        title: '七、联系我们',
+        body: '疑问或投诉请发邮件至 ' + PRIVACY_CONTACT + '，我们会在 ' + WIPE_SLA_WORKDAYS + ' 个工作日内答复。',
+    },
+];
+/**
+ * 是否需要弹同意门。
+ * @param stored 本机已记录的同意值 (localStorage.getItem(PRIVACY_CONSENT_KEY))
+ * @returns true = 需要征求同意 (未同意 / 版本过期 / 值非法)
+ */
+export function needsPrivacyConsent(stored) {
+    if (typeof stored !== 'string')
+        return true;
+    return stored.trim() !== PRIVACY_CONSENT_VERSION;
+}
+/** 同意后写入的值 */
+export function consentRecord() {
+    return PRIVACY_CONSENT_VERSION;
+}
+/** 备案号展示文案 (未备案时如实说明, 不伪造编号) */
+export function filingDisplay(no = APP_FILING_NO) {
+    const v = (no || '').trim();
+    return v ? `APP 备案号 ${v}` : 'APP 备案号：备案办理中';
+}
+/**
+ * 注销要清掉的东西 —— 清单必须与"我们声明收集的数据"一一对应, 少一个就是合规缺口。
+ * 注意: 不删 consent 记录 (同意记录不是个人信息, 且删了会在注销后立刻再弹一次门)。
+ */
+export const WIPE_TARGETS = {
+    /** IndexedDB 库 (名称与各模块里的常量逐一核对过) */
+    databases: ['bolloon-mobile-data', 'bolloon-mobile', 'bolloon-mobile-payments', 'bolloon'],
+    /** localStorage 键前缀: 命中即清 */
+    localStoragePrefixes: ['bolloon_', 'bolloon.', 'bolloon-'],
+    /** 明确保留: 同意记录 + 界面偏好 (不含个人信息) */
+    keep: [PRIVACY_CONSENT_KEY, 'bolloon-lang', 'bolloon_theme'],
+};
+/** 注销后给用户看的说明 (诚实: 链上记录删不掉) */
+export const WIPE_NOTICE = '已删除本机的身份标识（DID）、智能体、会话消息与钱包账本。' +
+    '已经写入公开区块链的交易记录无法删除，这一点任何服务方都做不到。' +
+    `如遇异常，我们的处理时限为 ${WIPE_SLA_WORKDAYS} 个工作日（${PRIVACY_CONTACT}）。`;
+/** 同意门文案 (集中在这里, 便于审计与翻译) */
+export const CONSENT_TEXT = {
+    title: '隐私政策与权限说明',
+    intro: 'Bolloon 是本地优先的：没有账号体系，不收集手机号或邮箱，你的智能体、会话与消息只存在这台设备上。' +
+        '在你点击「同意并继续」之前，应用不会读取本机数据、不会连接网络、也不会申请任何系统权限。',
+    agree: '同意并继续',
+    decline: '不同意',
+    policyLink: '阅读完整隐私政策',
+    declinedTitle: '未同意，已停在说明页',
+    declinedBody: '你可以继续留在本页查阅说明，或退出应用。我们不会在此状态下收集任何信息。' +
+        '随时重新打开应用都可以再次选择。',
+    declinedReread: '重新阅读',
+    declinedExit: '退出应用',
+};
+/** 删除单个 IndexedDB 库 (供没有 reset 导出的模块使用, 如钱包库) */
+function deleteDatabase(name) {
+    return new Promise((resolve, reject) => {
+        if (typeof indexedDB === 'undefined') {
+            resolve();
+            return;
+        }
+        const req = indexedDB.deleteDatabase(name);
+        req.onsuccess = () => resolve();
+        req.onerror = () => reject(req.error);
+        // 还有别的连接开着时会 blocked: 不等死, 如实返回 (下次启动会清掉)
+        req.onblocked = () => resolve();
+    });
+}
+/**
+ * 注销 / 清除本机数据 —— 应用内唯一的删除入口。
+ * 覆盖: 身份 DID+密钥库 · 智能体与会话消息库 · 支付库 · 钱包库 · localStorage 里的本机键。
+ * 不覆盖: 公开区块链上的历史交易 (任何服务方都删不了, 文案里已向用户说明)。
+ */
+export async function wipeLocalData() {
+    const result = { deletedDatabases: [], clearedStorageKeys: [], failed: [] };
+    // ① 三个自带 reset 的库: 复用模块自己的实现 (它们会先关闭连接, 避免 onblocked)
+    const resets = [
+        ['bolloon-mobile-data', async () => (await import('./mobile-data.js')).resetDataDb()],
+        ['bolloon-mobile', async () => (await import('./mobile-agent.js')).resetAgentDb()],
+        ['bolloon-mobile-payments', async () => (await import('./mobile-payments.js')).resetPaymentsDb()],
+    ];
+    for (const [name, fn] of resets) {
+        try {
+            await fn();
+            result.deletedDatabases.push(name);
+        }
+        catch (e) {
+            result.failed.push(`${name}: ${e?.message || String(e)}`);
+        }
+    }
+    // ② 钱包库 (mobile-wallet.ts) 没有 reset 导出 → 直接删库
+    try {
+        await deleteDatabase('bolloon');
+        result.deletedDatabases.push('bolloon');
+    }
+    catch (e) {
+        result.failed.push(`bolloon: ${e?.message || String(e)}`);
+    }
+    // ③ localStorage: 按前缀清, 保留同意记录与界面偏好
+    try {
+        const keys = [];
+        for (let i = 0; i < localStorage.length; i++) {
+            const k = localStorage.key(i);
+            if (k)
+                keys.push(k);
+        }
+        const keep = WIPE_TARGETS.keep;
+        for (const k of keys) {
+            const hit = WIPE_TARGETS.localStoragePrefixes.some((p) => k.startsWith(p));
+            if (!hit || keep.includes(k))
+                continue;
+            localStorage.removeItem(k);
+            result.clearedStorageKeys.push(k);
+        }
+    }
+    catch (e) {
+        result.failed.push(`localStorage: ${e?.message || String(e)}`);
+    }
+    return result;
+}

package/dist/web/mobile.css

@@ -688,3 +688,18 @@ body {
   color: var(--bg);
   font-weight: 600;
 }
+
+/* —— 隐私政策 (2026-09-16) —— */
+.privacy-link {
+  display: block; margin: 6px 0 2px; text-align: center;
+  color: var(--accent); font-size: 13px; text-decoration: none;
+}
+.privacy-link:active { opacity: .7; }
+.policy-body {
+  flex: 1; overflow-y: auto; -webkit-overflow-scrolling: touch;
+  padding: 14px 16px calc(40px + env(safe-area-inset-bottom));
+}
+.policy-body h3 { font-size: 14px; font-weight: 600; color: var(--text); margin: 18px 0 6px; }
+.policy-body p { font-size: 13px; line-height: 1.75; color: var(--text-secondary); margin: 0 0 10px; }
+.policy-body a { color: var(--accent); word-break: break-all; }
+.policy-meta { font-size: 12px; color: var(--text-muted); }

package/dist/web/mobile.html

@@ -43,7 +43,7 @@
   </header>
 
   <!-- 主页面: 双频滑动卡片 -->
-  <main class="page-container" id="page-main" data-tab="main">
+  <main class="page-container" id="page-main" data-tab="main" hidden>
     <!-- 水平滑动卡片轨道 -->
     <div class="card-carousel" id="card-carousel">
       <div class="card-track" id="card-track">
@@ -139,6 +139,26 @@
 <button class="create-session-btn" id="btn-create-session" hidden>＋ 创建新会话</button>
 
 <!-- 创建智能体: 底部滑入加载 sheet -->
+<!-- 2026-09-16: 首启隐私同意门 — 上架要求: 用户同意前不读取本机数据 / 不连网 / 不申请任何权限 -->
+<div class="sheet" id="privacy-gate" hidden>
+  <div class="sheet-inner">
+    <div class="sheet-title" id="privacy-gate-title">隐私政策与权限说明</div>
+    <div class="sheet-text" id="privacy-gate-body"></div>
+    <a class="privacy-link" href="#" id="privacy-gate-link">阅读完整隐私政策 ›</a>
+    <button class="sheet-choice" id="privacy-agree">同意并继续</button>
+    <button class="sheet-choice sheet-cancel" id="privacy-decline">不同意</button>
+  </div>
+</div>
+
+<!-- 2026-09-16: 应用内隐私政策 (全屏, 离线可用; 权威版 = bolloon.cn/privacy.html) -->
+<div class="chat-page" id="policy-page" hidden>
+  <div class="chat-topbar">
+    <button class="icon-btn" id="policy-back">←</button>
+    <div style="flex:1;font-weight:600">隐私政策</div>
+  </div>
+  <div class="policy-body" id="policy-body"></div>
+</div>
+
 <div class="sheet" id="create-sheet" hidden>
   <div class="sheet-inner">
     <div class="spinner"></div>

package/dist/web/mobile.js

@@ -1712,11 +1712,14 @@
         <div class="conv-item" id="settings-data"><span class="list-icon">${ICONS.chip}</span><span style="flex:1;min-width:0"><span style="display:block">本机数据</span><span class="conv-preview" style="display:block">读取中…</span></span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-desktop"><span class="list-icon">${ICONS.globe}</span><span>电脑端同步</span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-chain"><span class="list-icon">${ICONS.chip}</span><span>链上配置 (RPC/网络)</span><span class="list-arrow">›</span></div>
-        <div class="conv-item" id="settings-accessibility"><span class="list-icon">${ICONS.globe}</span><span>无障碍服务 (屏幕触控)</span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="settings-accessibility"><span class="list-icon">${ICONS.globe}</span><span>完全访问权限<span class="conv-preview" style="display:block" id="access-preview">默认开启</span></span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-ipfs"><span class="list-icon">${ICONS.chip}</span><span>IPFS 存储</span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-helia"><span class="list-icon">${ICONS.globe}</span><span>本机 IPFS 节点</span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-selfcard"><span class="list-icon">${ICONS.chip}</span><span id="selfcard-text">显示本机卡片: 开</span></div>
         <div class="conv-item" id="settings-did"><span class="list-icon">${ICONS.idcard}</span><span>DID</span></div>
+        <div class="conv-item" id="settings-privacy"><span class="list-icon">${ICONS.chip}</span><span>隐私政策与个人信息</span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="settings-wipe"><span class="list-icon">${ICONS.trash}</span><span style="flex:1;min-width:0"><span style="display:block">清除本机数据（注销）</span><span class="conv-preview" style="display:block">删除本机身份、智能体、会话与钱包</span></span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="settings-filing"><span class="list-icon">${ICONS.idcard}</span><span id="filing-text">APP 备案号：备案办理中</span></div>
       </div>`;
     document.body.appendChild(page);
     applyTheme(resolveThemePref(), false);
@@ -1726,16 +1729,46 @@
       const next = currentTheme === 'auto' ? 'light' : (currentTheme === 'light' ? 'dark' : 'auto');
       applyTheme(next, true);
     });
-    // 无障碍服务: 屏幕触控 (电脑端 phone.tap / phone.swipe) 的前提 — 与 MCP/Skills 控制无关
+    // 完全访问权限 (屏幕点按/滑动, 电脑端 phone.tap / phone.swipe 的前提) — 默认开启
+    const ACCESS_AUTO_KEY = 'bolloon_access_auto_guided';
+    const refreshAccessPreview = async () => {
+      const el = document.querySelector('#access-preview');
+      if (!el) return;
+      const cap = window.Capacitor;
+      const b = cap && cap.Plugins && cap.Plugins.RokidBridge;
+      if (!b) { el.textContent = '仅手机 App'; return; }
+      let st = {};
+      try { st = (await b.touchStatus()) || {}; } catch (e) { st = {}; }
+      el.textContent = st.ready ? '已开启' : '未开启 · 点这里开';
+    };
+    void refreshAccessPreview();
+    // 默认开启: 首次启动自动把用户带到系统开关页 (只引导一次, 不反复打扰)
+    void (async () => {
+      try {
+        const cap = window.Capacitor;
+        const b = cap && cap.Plugins && cap.Plugins.RokidBridge;
+        if (!b) return;
+        let st = {};
+        try { st = (await b.touchStatus()) || {}; } catch (e) { return; }
+        if (st.ready) return;
+        if (localStorage.getItem(ACCESS_AUTO_KEY) === '1') return;
+        localStorage.setItem(ACCESS_AUTO_KEY, '1');
+        await b.openAccessibilitySettings();
+      } catch (e) {}
+    })();
     $('#settings-accessibility').addEventListener('click', async () => {
       const cap = window.Capacitor;
       const bridge = cap && cap.Plugins && cap.Plugins.RokidBridge;
-      if (!bridge) { alert('仅真机可用：App 内可把屏幕触控能力授权给电脑端'); return; }
+      if (!bridge) { alert('完全访问权限只在手机 App 里有：电脑端 / 网页版没有这项。'); return; }
       let st = {};
       try { st = (await bridge.touchStatus()) || {}; } catch (e) { st = {}; }
-      if (st.ready) { alert('触控已就绪：电脑端可发 phone.tap / phone.swipe 操作这台手机'); return; }
-      try { await bridge.openAccessibilitySettings(); }
-      catch (e) { alert('请手动开启：设置 → 辅助功能 → 已安装的服务 → Bolloon Agent'); }
+      if (st.ready) { alert('完全访问权限已开启：智能体可以在这台手机上点按、滑动屏幕（电脑端也能远程帮你点）。\n\n想关掉：系统设置 → 辅助功能 → 已开启的服务 → Bolloon Agent，关掉即可。'); return; }
+      try {
+        alert('马上打开系统设置，把「Bolloon Agent」的完全访问权限打开。\n（这一项在有些手机叫「辅助功能」，有些叫「无障碍」，指同一个开关；打开后一直有效，随时可以关掉。）');
+        await bridge.openAccessibilitySettings();
+        void refreshAccessPreview();
+      }
+      catch (e) { alert('没打开成功，请手动去：系统设置 → 辅助功能 → 已开启的服务 → Bolloon Agent，打开即可。'); }
     });
 
     // 本机数据: 直接读 IndexedDB 快照 (智能体/会话/消息都在本机, 重开 App 不会丢)
@@ -1757,6 +1790,20 @@
       });
     }
     $('#settings-desktop').addEventListener('click', openDesktopSync);
+    // 隐私政策 (双入口之一: 设置页; 另一个是首启同意门)
+    const privacyRow = $('#settings-privacy');
+    if (privacyRow) privacyRow.addEventListener('click', openPrivacyPolicy);
+    // 注销: 清除本机数据
+    const wipeRow = $('#settings-wipe');
+    if (wipeRow) wipeRow.addEventListener('click', () => { void wipeLocalDataFlow(); });
+    // 备案号展示 (未备案时如实显示"备案办理中", 不伪造编号)
+    const filingRow = $('#settings-filing');
+    if (filingRow) {
+      const ft = $('#filing-text');
+      const ptxt = privacyCore() && privacyCore().filingText ? privacyCore().filingText() : '';
+      if (ft && ptxt) ft.textContent = ptxt;
+      filingRow.addEventListener('click', () => { const pp = privacyCore(); alert((pp && pp.filingText ? pp.filingText() : 'APP 备案号：备案办理中') + '\n\n备案信息以工信部备案系统公示为准。'); });
+    }
     // 本机卡片显示开关 (移除后从这里恢复)
     const drawSelfCardToggle = () => {
       const on = (() => { try { return localStorage.getItem(SELF_CARD_HIDDEN_KEY) !== '1'; } catch { return true; } })();
@@ -2842,7 +2889,133 @@
     });
   }
 
+  // ============ 隐私合规 (2026-09-16): 同意门 / 政策页 / 注销 ============
+  //  上架要求: 首次启动必须先展示隐私政策; 用户同意前不得读取本机数据、不得连网、不得申请任何权限。
+  //  所以 init() 只做一件事 —— 决定"先弹门"还是"进应用"; 真正的初始化在 initApp()。
+
+  function privacyCore() {
+    return (window.BolloonCore && window.BolloonCore.privacy) || null;
+  }
+
+  function privacyNeedsConsent() {
+    const p = privacyCore();
+    if (!p || typeof p.needsConsent !== 'function') return true;   // 内核未就绪 → 按"需要同意"处理
+    try { return !!p.needsConsent(); } catch (e) { return true; }
+  }
+
+  function escHtml(v) {
+    return String(v == null ? '' : v)
+      .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+  }
+
+  /** 政策摘要 HTML (要素来自内核常量, 单测锁了必填项) */
+  function privacySummaryHtml() {
+    const p = privacyCore();
+    const items = (p && p.summary) || [];
+    return items.map((it) => `<h3>${escHtml(it.title)}</h3><p>${escHtml(it.body)}</p>`).join('');
+  }
+
+  function showPrivacyGate() {
+    const p = privacyCore();
+    const t = (p && p.consentText) || {};
+    const gate = $('#privacy-gate');
+    if (!gate) return;
+    const titleEl = $('#privacy-gate-title'), bodyEl = $('#privacy-gate-body');
+    if (titleEl && t.title) titleEl.textContent = t.title;
+    if (bodyEl) bodyEl.textContent = t.intro || '使用前请先阅读并同意隐私政策。';
+    const linkEl = $('#privacy-gate-link');
+    if (linkEl && t.policyLink) linkEl.textContent = t.policyLink + ' ›';
+    const agreeEl = $('#privacy-agree'), declineEl = $('#privacy-decline');
+    if (agreeEl && t.agree) agreeEl.textContent = t.agree;
+    if (declineEl && t.decline) declineEl.textContent = t.decline;
+    if (linkEl) linkEl.onclick = (e) => { e.preventDefault(); openPrivacyPolicy(); };
+    if (agreeEl) agreeEl.onclick = () => {
+      const ok = p && typeof p.grant === 'function' ? p.grant() : false;
+      if (!ok) { /* 本机写不进去(隐私模式/满盘): 不假装同意, 下次启动会再问 */ }
+      hideSheet('#privacy-gate');
+      initApp();
+    };
+    if (declineEl) declineEl.onclick = () => showPrivacyDeclined();
+    gate.hidden = false;
+  }
+
+  /** 不同意 → 停在说明页: 不初始化功能、不收集任何东西, 但也不强制退出应用 */
+  function showPrivacyDeclined() {
+    const p = privacyCore();
+    const t = (p && p.consentText) || {};
+    const gate = $('#privacy-gate');
+    if (!gate) return;
+    const titleEl = $('#privacy-gate-title'), bodyEl = $('#privacy-gate-body');
+    if (titleEl) titleEl.textContent = t.declinedTitle || '未同意';
+    if (bodyEl) bodyEl.textContent = t.declinedBody || '未同意隐私政策时应用不会收集任何信息。';
+    const linkEl = $('#privacy-gate-link');
+    if (linkEl) { linkEl.textContent = (t.declinedReread || '重新阅读') + ' ›'; linkEl.onclick = (e) => { e.preventDefault(); showPrivacyGate(); }; }
+    const agreeEl = $('#privacy-agree'), declineEl = $('#privacy-decline');
+    if (agreeEl) { agreeEl.textContent = t.agree || '同意并继续'; agreeEl.onclick = () => { const ok = p && p.grant ? p.grant() : false; if (!ok) {} hideSheet('#privacy-gate'); initApp(); }; }
+    if (declineEl) {
+      declineEl.textContent = t.declinedExit || '退出应用';
+      declineEl.onclick = () => {
+        const cap = window.Capacitor;
+        if (cap && cap.Plugins && cap.Plugins.App && cap.Plugins.App.exitApp) { try { cap.Plugins.App.exitApp(); return; } catch (e) {} }
+        alert('请手动退出应用（返回键 / 上滑关闭）。未同意隐私政策期间应用不会收集任何信息。');
+      };
+    }
+    gate.hidden = false;
+  }
+
+  /** 应用内完整政策 (全屏, 离线可用)。权威版永远是 bolloon.cn/privacy.html (商店表单填的就是它) */
+  function openPrivacyPolicy() {
+    const p = privacyCore();
+    const page = $('#policy-page');
+    const bodyEl = $('#policy-body');
+    if (!page || !bodyEl) return;
+    const t = (p && p.consentText) || {};
+    const url = (p && p.policyUrl) || 'https://bolloon.cn/privacy.html';
+    const contact = (p && p.contact) || '';
+    const filing = p && typeof p.filingText === 'function' ? p.filingText() : '';
+    bodyEl.innerHTML = `
+      <p class="policy-meta">${escHtml(t.intro || '')}</p>
+      ${privacySummaryHtml()}
+      <h3>完整政策与备案信息</h3>
+      <p>在线完整版：<a href="${escHtml(url)}" target="_blank" rel="noopener">${escHtml(url)}</a></p>
+      <p>${escHtml(filing)}</p>
+      <p class="policy-meta">联系方式：${escHtml(contact)}（承诺 7 个工作日内答复）</p>
+      <p class="policy-meta">本页内容与在线版本一致；如两者不一致，以在线版本为准。</p>`;
+    const back = $('#policy-back');
+    if (back) back.onclick = () => { page.hidden = true; };
+    page.hidden = false;
+  }
+
+  /** 注销: 清除本机全部数据 (身份 DID / 智能体 / 会话消息 / 支付 / 钱包) */
+  async function wipeLocalDataFlow() {
+    if (!confirm('确定清除本机数据（注销）？\n\n将删除本机上的：身份标识（DID）、智能体、会话与消息、钱包账本。\n已写入公开区块链的交易记录无法删除。\n\n此操作不可撤销。')) return;
+    const p = privacyCore();
+    if (!p || typeof p.wipe !== 'function') { alert('清除失败：本机内核未就绪，请重启应用后重试。'); return; }
+    showToast('正在清除本机数据…');
+    try {
+      const r = await p.wipe();
+      const failed = (r && r.failed) || [];
+      const deleted = (r && r.deletedDatabases) || [];
+      const cleared = (r && r.clearedStorageKeys) || [];
+      if (failed.length) {
+        alert(`部分数据未能清除（可重试）：\n${failed.join('\n')}\n\n已清除 ${deleted.length} 个数据库 / ${cleared.length} 个本机键。`);
+      } else {
+        alert(`${p.wipeNotice || '已清除本机数据。'}\n\n（本次删除 ${deleted.length} 个数据库、${cleared.length} 个本机键）`);
+      }
+      location.reload();   // 回到首启状态 (同意记录保留, 不再重复弹门)
+    } catch (e) {
+      alert('清除失败：' + ((e && e.message) || e));
+    }
+  }
+
   function init() {
+    // 首启/政策版本变更 → 先弹同意门, 不做任何初始化 (不读本机数据 / 不连网 / 不申请权限)
+    if (privacyNeedsConsent()) { showPrivacyGate(); return; }
+    initApp();
+  }
+
+  function initApp() {
     bindMenu();
     applyTheme(resolveThemePref(), false);
     switchTab('main');