@bolloon/bolloon-agent 0.4.33 → 0.5.1

package/dist/ios/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/ios/mobile-tasks.js

@@ -0,0 +1,339 @@
+/**
+ * mobile-tasks.ts — 手机端「任务协作」能力层 (2026-09-25)
+ *
+ * 四项能力的手机侧实现 (桌面/CLI 同一套存储与协议, **手机不是第二个权威源**):
+ *   ① 入群        → 桌面 `/api/mobile/tasks/groups*` → `gateway-group.ts` (与 CLI `bolloon task group …` 同一份 store)
+ *   ② 发任务公告   → 桌面 `/api/mobile/tasks/announce|publish|post` → `task-group.ts` / `task-board.ts` (与 CLI 同函数)
+ *   ③ 看飞轮进度   → 桌面 `/api/mobile/tasks/flywheel` → `goal-store` 只读 + `goal-flywheel` 冻结类型投影
+ *   ④ 授权签名     → 每个**高风险**动作: 展示待发内容 → 设备私钥 (Ed25519) 签规范载荷 → 桌面验签才执行
+ *
+ * 纪律 (与本仓其它手机模块一致):
+ *   · **浏览器安全**: 不 import 任何 node: 模块 (纯函数与 fetch)。
+ *   · **不支持设备签名就明说**: 没有 WebCrypto/Ed25519 → 返回 device_signing_unavailable, **绝不发未签名请求**。
+ *   · **桌面离线不假装成功**: 直接返回 desktop_offline (任务动作**不进离线队列** ——
+ *     一张几小时后突然生效的"发公告/入群"批准比失败更危险; 这条与 contacts 队列的取舍不同, 是刻意的)。
+ *   · **本地先过隐私闸**: 群消息文本用桌面同一份规则表 (`task-public-text.ts`) 预检, 命中就本地拒发。
+ *   · **只渲染脱敏视图**: 页面数据一律经 `mobile-task-views.ts` 投影 (id 只给缩短形式)。
+ */
+import { canonicalTaskActionPayload, taskActionContentText, checkTaskActionFreshness, TASK_ACTION_DEFAULT_TTL_MS, MOBILE_TASK_ACTION_KINDS, } from '../agents/mobile-task-actions.js';
+import { requirePublicText } from '../agents/task-public-text.js';
+import { buildBoardView, buildTrailView, buildGroupsView, describeTaskActionForConfirm, } from '../agents/mobile-task-views.js';
+import { findInternalFieldLeaks } from '../agents/mobile-flywheel-view.js';
+import { sha256HexOf, ed25519Available } from './mobile-contacts.js';
+const K_TASKS_HINT = 'bolloon.mobile.tasks.hint.v1';
+function defaultStorage() {
+    try {
+        if (typeof localStorage !== 'undefined')
+            return localStorage;
+    }
+    catch { /* 隐私模式 */ }
+    const mem = new Map();
+    return { getItem: (k) => (mem.has(k) ? mem.get(k) : null), setItem: (k, v) => { mem.set(k, v); }, removeItem: (k) => { mem.delete(k); } };
+}
+async function baseOf(deps) {
+    if (deps.base && String(deps.base).trim())
+        return String(deps.base).replace(/\/+$/, '');
+    try {
+        if (typeof localStorage !== 'undefined') {
+            const v = localStorage.getItem('bolloon_desktop_base_url');
+            if (v)
+                return String(v).replace(/\/+$/, '');
+        }
+    }
+    catch { /* 忽略 */ }
+    return '';
+}
+function fetchOf(deps) {
+    return deps.fetchImpl || globalThis.fetch;
+}
+async function getJson(base, path, f) {
+    const res = await f(`${base}${path}`);
+    let json = null;
+    try {
+        json = await res.json();
+    }
+    catch { /* 空响应 */ }
+    return { status: res.status, json };
+}
+async function postJson(base, path, body, f) {
+    const res = await f(`${base}${path}`, {
+        method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body ?? {}),
+    });
+    let json = null;
+    try {
+        json = await res.json();
+    }
+    catch { /* 空响应 */ }
+    return { status: res.status, json };
+}
+const OFFLINE_NOTE = '地址在 我 → 设置 → 电脑端地址 里填; 手机不替桌面记账';
+/** 读接口统一错误映射 (桌面不在线 → 明说, 不返回空壳当成功) */
+function mapFail(r, what) {
+    const code = r.json?.code ? String(r.json.code) : (r.status ? `desktop_http_${r.status}` : 'desktop_unreachable');
+    return { ok: false, code, error: `${what} 失败: ${r.json?.error || r.json?.message || code}`, note: OFFLINE_NOTE };
+}
+// ── 请求构造 (空字段一律显式 null: 桌面据此重算内容摘要) ─────────────────────
+export function emptyTaskActionRequest(kind) {
+    return {
+        kind, groupRef: null, announcementId: null, capability: null, instruction: null,
+        budgetHuman: null, currency: null, deadline: null, criteria: null, round: null, price: null,
+        hash: null, bytes: null, checks: null, verdict: null, trailKind: null,
+    };
+}
+/**
+ * 构造并签一个动作。**没有设备签名能力 → 直接失败** (没有"不签名也能过"的路径)。
+ * 群消息类动作在签名前先过本地隐私闸 (与桌面同一份规则表)。
+ */
+export async function signTaskAction(req, deps = {}) {
+    const storage = deps.storage || defaultStorage();
+    const c = deps.cryptoObj || globalThis.crypto;
+    if (!ed25519Available(c)) {
+        return { ok: false, code: 'device_signing_unavailable', error: '本机 WebView 不支持 Ed25519 设备签名 —— 请在桌面端执行这个动作 (或升级系统 WebView)' };
+    }
+    if (!MOBILE_TASK_ACTION_KINDS.includes(String(req?.kind))) {
+        return { ok: false, code: 'unknown_kind', error: `未知动作: ${String(req?.kind || '')}` };
+    }
+    // 群消息类动作: 先本地过闸 (桌面还会再过一遍, 两道都要)
+    const text = taskActionContentText(req);
+    if (req.kind === 'trail_post' || req.kind === 'announce_publish' || req.kind === 'announce_to_group') {
+        for (const fieldText of [req.round, req.price, req.criteria, req.checks, req.verdict, req.capability, req.hash]) {
+            if (!fieldText)
+                continue;
+            const gate = requirePublicText(String(fieldText));
+            if (!gate.ok) {
+                return { ok: false, code: 'privacy_denied', error: `本地隐私闸拦下: ${gate.violations.map((v) => v.rule).join(', ')} (群里/公告里不放标识符)`, violations: gate.violations };
+            }
+        }
+    }
+    const now = deps.now ? deps.now() : Date.now();
+    const ttl = Math.min(Number(deps.ttlMs) || TASK_ACTION_DEFAULT_TTL_MS, TASK_ACTION_DEFAULT_TTL_MS);
+    let contentDigest;
+    try {
+        contentDigest = await sha256HexOf(text, c);
+    }
+    catch (e) {
+        return { ok: false, code: 'device_signing_unavailable', error: String(e?.message || e) };
+    }
+    const action = {
+        actionId: `act-${now.toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
+        kind: req.kind,
+        deviceId: '', // 由 signPayloadOnDevice 填 (它知道设备 id)
+        ownerDid: String(deps.ownerDid || '').trim(),
+        targetRef: String(req.groupRef || req.announcementId || ''),
+        contentDigest,
+        createdAt: new Date(now).toISOString(),
+        expiresAt: new Date(now + ttl).toISOString(),
+        grantedBy: deps.grantedBy || 'leo',
+        via: 'mobile',
+    };
+    // 设备 id 必须先落到载荷里 (签名是对**含 deviceId 的载荷**做的), 且与签名同源
+    let signature;
+    try {
+        const { loadOrCreateDeviceKey, signPayloadWithMaterial } = await import('./mobile-contacts.js');
+        const material = await loadOrCreateDeviceKey(storage, c);
+        action.deviceId = material.deviceId;
+        signature = await signPayloadWithMaterial(canonicalTaskActionPayload(action), material, c);
+        if (signature.deviceId !== action.deviceId) {
+            return { ok: false, code: 'device_signing_unavailable', error: '设备密钥不一致 (签名与载荷设备对不上) → 不发送' };
+        }
+        const fresh = checkTaskActionFreshness(action, now);
+        if (!fresh.ok)
+            return { ok: false, code: fresh.reason, error: `动作时效不合法: ${fresh.reason}` };
+    }
+    catch (e) {
+        return { ok: false, code: 'device_signing_unavailable', error: String(e?.message || e).slice(0, 160) };
+    }
+    return {
+        ok: true,
+        data: { signed: { action, signature }, contentText: text, confirm: describeTaskActionForConfirm(req.kind, req) },
+    };
+}
+// ── 执行 (签名 → 桌面验签 → 桌面执行) ────────────────────────────────────────
+export async function executeTaskAction(req, deps = {}) {
+    const storage = deps.storage || defaultStorage();
+    const base = await baseOf(deps);
+    if (!base)
+        return { ok: false, code: 'desktop_offline', error: '还没设置电脑端地址: 高风险动作必须由桌面执行 (手机签了名也要送到桌面)', note: OFFLINE_NOTE };
+    const signed = await signTaskAction(req, { ...deps, storage });
+    if (!signed.ok || !signed.data)
+        return { ok: false, code: signed.code, error: signed.error, violations: signed.violations };
+    const f = fetchOf(deps);
+    let r;
+    try {
+        r = await postJson(base, '/api/mobile/tasks/execute', { request: req, ...signed.data.signed }, f);
+    }
+    catch (e) {
+        return { ok: false, code: 'desktop_offline', error: `桌面不可达: ${String(e?.message || e).slice(0, 120)}`, note: OFFLINE_NOTE };
+    }
+    if (r.status !== 200 || !r.json?.ok)
+        return mapFail(r, '执行');
+    return { ok: true, data: r.json, note: '桌面已验签并执行 (同一套存储与协议)' };
+}
+/** 预览群消息正文 (由桌面用**将要发送的同一个构造器**生成; 只给要发进群的那一行) */
+export async function previewGroupMessage(req, deps = {}) {
+    const base = await baseOf(deps);
+    if (!base)
+        return { ok: false, code: 'desktop_offline', error: '预览需要桌面在线 (群消息由桌面的构造器生成)', note: OFFLINE_NOTE };
+    const c = deps.cryptoObj || globalThis.crypto;
+    let digestPreview = '';
+    try {
+        digestPreview = await sha256HexOf(taskActionContentText(req), c);
+    }
+    catch {
+        digestPreview = '';
+    }
+    const f = fetchOf(deps);
+    try {
+        const r = await postJson(base, '/api/mobile/tasks/preview', { request: req }, f);
+        if (r.status !== 200 || !r.json?.ok)
+            return mapFail(r, '预览');
+        return { ok: true, data: { text: String(r.json.text || ''), contentText: taskActionContentText(req), digestPreview } };
+    }
+    catch (e) {
+        return { ok: false, code: 'desktop_offline', error: `桌面不可达: ${String(e?.message || e).slice(0, 120)}`, note: OFFLINE_NOTE };
+    }
+}
+// ── ① 入群 (与 CLI `task group list|join|leave|create` 同一份 store) ─────────
+export async function listGroups(deps = {}) {
+    const base = await baseOf(deps);
+    if (!base)
+        return { ok: false, code: 'desktop_offline', error: '看群列表需要电脑端在线 (群存在于桌面节点的 OrbitDB)', note: OFFLINE_NOTE };
+    try {
+        const r = await getJson(base, '/api/mobile/tasks/groups', fetchOf(deps));
+        if (r.status !== 200 || !r.json?.ok)
+            return mapFail(r, '读群列表');
+        return { ok: true, data: buildGroupsView(r.json.groups || []) };
+    }
+    catch (e) {
+        return { ok: false, code: 'desktop_offline', error: `桌面不可达: ${String(e?.message || e).slice(0, 120)}`, note: OFFLINE_NOTE };
+    }
+}
+/** 入群 (高风险: 要签名) */
+export function joinGroup(link, deps = {}) {
+    const req = { ...emptyTaskActionRequest('group_join'), groupRef: String(link || '').trim() };
+    return executeTaskAction(req, deps);
+}
+/** 退群 (高风险: 要签名) */
+export function leaveGroup(groupRef, deps = {}) {
+    const req = { ...emptyTaskActionRequest('group_leave'), groupRef: String(groupRef || '').trim() };
+    return executeTaskAction(req, deps);
+}
+/** 建群 (高风险: 要签名; 建完自动入群) */
+export function createGroup(name, deps = {}) {
+    const req = { ...emptyTaskActionRequest('group_create'), groupRef: String(name || '').trim() };
+    return executeTaskAction(req, deps);
+}
+// ── ② 发任务公告 ────────────────────────────────────────────────────────────
+/** 看板 (只读): 与 CLI `bolloon task board` 同一份事实 */
+export async function loadBoard(deps = {}) {
+    const base = await baseOf(deps);
+    if (!base)
+        return { ok: false, code: 'desktop_offline', error: '看板需要电脑端在线 (公告板在桌面节点上)', note: OFFLINE_NOTE };
+    const now = deps.now ? deps.now() : Date.now();
+    try {
+        const r = await getJson(base, '/api/mobile/tasks/board', fetchOf(deps));
+        if (r.status !== 200 || !r.json?.ok)
+            return mapFail(r, '读看板');
+        return { ok: true, data: buildBoardView(r.json, now) };
+    }
+    catch (e) {
+        return { ok: false, code: 'desktop_offline', error: `桌面不可达: ${String(e?.message || e).slice(0, 120)}`, note: OFFLINE_NOTE };
+    }
+}
+/** 发布一条待接单公告 (高风险: 要签名; 与 CLI `task publish` 同一函数) */
+export function publishAnnouncement(input, deps = {}) {
+    const req = {
+        ...emptyTaskActionRequest('announce_publish'),
+        capability: String(input.capability || '').trim(),
+        instruction: String(input.instruction || ''),
+        budgetHuman: String(input.budgetHuman || '').trim(),
+        currency: String(input.currency || 'USDC').toUpperCase(),
+        deadline: input.deadline ? String(input.deadline).trim() : null,
+    };
+    return executeTaskAction(req, deps);
+}
+/** 把板上的一条公告发进群 (高风险: 要签名; 与 CLI `task announce` 同一函数) */
+export function announceIntoGroup(input, deps = {}) {
+    const req = {
+        ...emptyTaskActionRequest('announce_to_group'),
+        groupRef: String(input.groupRef || '').trim(),
+        announcementId: String(input.announcementId || '').trim(),
+        round: input.round ? String(input.round) : null,
+        criteria: input.criteria ? String(input.criteria) : null,
+    };
+    return executeTaskAction(req, deps);
+}
+/** 过程留痕: 接单 / 交付 / 初筛 / 终审 (高风险: 要签名; 与 CLI `task post` 同一函数) */
+export function postTrail(input, deps = {}) {
+    const req = {
+        ...emptyTaskActionRequest('trail_post'),
+        groupRef: String(input.groupRef || '').trim(),
+        announcementId: String(input.announcementId || '').trim(),
+        round: input.round ? String(input.round) : null,
+        price: input.price ? String(input.price) : null,
+        hash: input.hash ? String(input.hash) : null,
+        bytes: typeof input.bytes === 'number' ? input.bytes : null,
+        checks: input.checks ? String(input.checks) : null,
+        verdict: input.verdict ? String(input.verdict) : null,
+        trailKind: input.kind,
+    };
+    return executeTaskAction(req, deps);
+}
+/** 读群里的一期过程痕迹 (只读): 与 CLI `bolloon task trail --group …` 同一份汇总 */
+export async function loadTrail(input, deps = {}) {
+    const base = await baseOf(deps);
+    if (!base)
+        return { ok: false, code: 'desktop_offline', error: '读群痕迹需要电脑端在线', note: OFFLINE_NOTE };
+    const q = new URLSearchParams();
+    q.set('group', String(input.groupRef || '').trim());
+    if (input.announcementId)
+        q.set('announcementId', String(input.announcementId));
+    if (input.limit)
+        q.set('limit', String(input.limit));
+    try {
+        const r = await getJson(base, `/api/mobile/tasks/trail?${q.toString()}`, fetchOf(deps));
+        if (r.status !== 200 || !r.json?.ok)
+            return mapFail(r, '读群痕迹');
+        return { ok: true, data: buildTrailView(r.json.summary || r.json) };
+    }
+    catch (e) {
+        return { ok: false, code: 'desktop_offline', error: `桌面不可达: ${String(e?.message || e).slice(0, 120)}`, note: OFFLINE_NOTE };
+    }
+}
+// ── ③ 看飞轮进度 (只读消费 goal-flywheel 冻结类型) ───────────────────────────
+export async function loadFlywheel(deps = {}) {
+    const base = await baseOf(deps);
+    if (!base)
+        return { ok: false, code: 'desktop_offline', error: '看飞轮进度需要电脑端在线 (Goal 记录在桌面节点上)', note: OFFLINE_NOTE };
+    try {
+        const r = await getJson(base, '/api/mobile/tasks/flywheel', fetchOf(deps));
+        if (r.status !== 200 || !r.json?.ok)
+            return mapFail(r, '读飞轮进度');
+        const goals = Array.isArray(r.json.goals) ? r.json.goals : [];
+        // 桌面投影里若混进内部字段 → 手机**拒绝渲染** (宁可显示"读不到", 也不把内部状态摆给用户)
+        const leaks = findInternalFieldLeaks(JSON.stringify(goals));
+        if (leaks.length)
+            return { ok: false, code: 'view_leak', error: `视图里含内部字段 (${leaks.join(', ')}) → 拒绝渲染` };
+        return { ok: true, data: { goals, hint: r.json.hint ? String(r.json.hint) : null } };
+    }
+    catch (e) {
+        return { ok: false, code: 'desktop_offline', error: `桌面不可达: ${String(e?.message || e).slice(0, 120)}`, note: OFFLINE_NOTE };
+    }
+}
+// ── 小工具 (UI 直接用) ─────────────────────────────────────────────────────
+/** 上一次操作的提示 (给 UI 跨页显示; 只存极短文本, 不含标识符) */
+export function setTaskHint(text, storage = defaultStorage()) {
+    try {
+        storage.setItem(K_TASKS_HINT, String(text || '').slice(0, 160));
+    }
+    catch { /* 忽略 */ }
+}
+export function getTaskHint(storage = defaultStorage()) {
+    try {
+        return String(storage.getItem(K_TASKS_HINT) || '');
+    }
+    catch {
+        return '';
+    }
+}
+export { requirePublicText, describeTaskActionForConfirm, buildBoardView, buildTrailView, buildGroupsView };