dsh-mobile-plugin 0.4.4 → 0.4.5

package/lib/impl.js

@@ -41,6 +41,9 @@ const { installQuestionBridge } = require('./mobile/questions.js')
 // 「手机上最近来过没有」：守卫记、控制面状态读。单独一个模块，装配层只转交。
 const activity = require('./mobile/activity.cjs')
 const { installSessionCleanup } = require('./session-cleanup.cjs')
+// 统计的定期采集：账本在 mobile/stats-ledger.cjs，采集规则在 stats-collect.cjs，定时器在
+// stats-scheduler.cjs —— 装配层只挂一下（按天归属靠的就是这个节奏）。
+const statsScheduler = require('./mobile/stats-scheduler.cjs')
 // 扩展卡的宿主侧：`extension_present` 工具与卡状态账本（见 mobile/extensions.js）。
 const { installExtensions } = require('./mobile/extensions.js')
 const { activeGuard } = require('./host-guard.cjs')
@@ -345,6 +348,7 @@ function apply(ctx) {
     }
     return undefined
   }, `${name}: extension tool`)
+  ctx.effect(() => statsScheduler.start(ctx), `${name}: stats collect`)
 
   const status = createStatusView({
     state,

package/lib/mobile/host-bridge/event-synthesis.js

@@ -295,10 +295,23 @@ function projectionState() {
  * `next-turn` → `placement: 'queued'`（排队条只认这个值）；`next-step` → `'steering'`，
  * 它只是「宿主已经收下了」的回执，不会多画一行。`message.id` 用宿主行自己的 id，App 靠它
  * 与正文去重。
+ *
+ * **只摊平用户本人说的话。** 宿主把系统注入（后台任务结束、时间/环境上下文、子代理消息、
+ * 模型切换提示这些）也当 user 行塞进同一份 inbox，来源标在 `source.kind` 上（不是 `user`）。
+ * 那一列在正文里由历史投影按来源丢掉，但队列帧的条目形状**没有 source 这一格**：原样摊平
+ * 出去，手机上这些注入就会以「我发出去的气泡」出现（`placement:'steering'` 在 App 侧画的
+ * 正是用户气泡）。所以这里按来源筛掉，注入一条都不进帧 —— 它们不需要排队条，也不需要
+ * 回执翻转。缺 source 的老宿主按普通用户消息处理，与历史投影同一口径。
  */
 function queueItems(inbox, ctx) {
   const items = [];
   let dropped = 0;
+  /** 这一行是不是用户本人发的（缺 source 视为用户，对齐 history-derive 的口径）。 */
+  const fromUser = (message) => {
+    const source = message && typeof message === 'object' ? message.source : null;
+    if (!source || typeof source !== 'object') return true;
+    return source.kind === undefined || source.kind === 'user';
+  };
   /**
    * 摊平一组待发行。`placement` 只标语义：`queued` 进排队条，`steering` 只是回执。
    * 没有 id 的行丢弃并计数（理由见下面的注释）。
@@ -307,6 +320,7 @@ function queueItems(inbox, ctx) {
     if (!Array.isArray(rows)) return;
     for (const message of rows) {
       if (!message || typeof message !== 'object') continue;
+      if (!fromUser(message)) continue;
       const id = typeof message.id === 'string' && message.id ? message.id : '';
       if (!id) { dropped += 1; continue; } // 没有 id 的行没法被 session.updateQueue 定位，别发出去
       items.push({ id, placement, message: { id, content: message.content } });

package/lib/mobile/relay-control.js

@@ -602,10 +602,16 @@ function createRelayControlHandlers(deps) {
    * 一条（时间 + 一句话 + 当时要切过去的地址），不带堆栈 —— 宿主内部路径对手机没用。
    *
    * **不搬堆栈**：台账的 message 只取第一行，截断 300 字。
+   *
+   * 2026-10-27 起多四格：`host` / `relay` / `sidecar` / `mirror`。手机那个「延迟浮窗」里的
+   * 「诊断」块就是把这几格抄成几行人话 —— 用户问「这台电脑到底怎么了」时，光有故障台账
+   * 答不了「插件是哪一版、后台服务重启过几回、镜像还推不推得动」。
+   * **仍然只读、仍然只进不出**：注册密钥、配对码、`lanSecret`、访问 token 一格都不出现。
    */
   async function handleRelayDiagnostics(_ctx, _req, res) {
     if (!wired) return unavailable(res);
     const snapshot = typeof status === 'function' ? status() : {};
+    const text = (value) => (typeof value === 'string' ? value : '');
     sendJson(res, 200, {
       ok: true,
       faults: faultsView(),
@@ -620,6 +626,28 @@ function createRelayControlHandlers(deps) {
       },
       /** 隧道为什么被拒那几条判断（宿主那边按中转错误文案推出来的）。 */
       tunnel: snapshot?.tunnel ?? null,
+      /** 这台电脑上跑着的插件与宿主：版本、平台、网页端口，报障时对方第一句就会问这些。 */
+      host: {
+        plugin: text(snapshot?.appVersion),
+        platform: text(snapshot?.platform),
+        arch: text(snapshot?.arch),
+        osVersion: text(snapshot?.osVersion),
+        webPort: Number.isInteger(snapshot?.localPort) && snapshot.localPort > 0 ? snapshot.localPort : null,
+      },
+      relay: { enabled: snapshot?.enabled === true },
+      /** 后台服务（sidecar）：换配置要重启它，重启失败正是「保存成功却连不上」的那一档。 */
+      sidecar: {
+        state: text(snapshot?.sidecar?.state),
+        restarts: Number.isInteger(snapshot?.sidecar?.restarts) ? snapshot.sidecar.restarts : 0,
+        restartedAt: Number.isInteger(snapshot?.sidecar?.restartedAt) ? snapshot.sidecar.restartedAt : 0,
+        restartError: text(snapshot?.sidecar?.restartError) || null,
+      },
+      /** 镜像推送：手机上看到的列表为什么停住不动，答案在这三格里。 */
+      mirror: {
+        pushedAt: Number.isInteger(snapshot?.mirror?.pushedAt) ? snapshot.mirror.pushedAt : 0,
+        ok: snapshot?.mirror?.ok === undefined ? null : snapshot.mirror.ok === true,
+        error: text(snapshot?.mirror?.error) || null,
+      },
     });
   }
 

package/lib/mobile/session-delivery.js

@@ -0,0 +1,68 @@
+'use strict';
+
+/**
+ * 「这一发到底进没进」：按 `clientMessageId` 回查会话正文。
+ *
+ * 为什么要有这一条：手机端有一条**离线发件箱**（见 App 侧 `services/outbox.ts`）——
+ * 点发送时没网或者电脑够不着，那条消息先留在手机上、标成「等待网络」，等网回来自动重发。
+ * 重发沿用同一个 `clientMessageId`，插件侧本来就会按它去重（`session-cache.js` 的
+ * `promptOnceFor`）。但那份去重记录**只在进程内存里**：插件重启过、或者 App 在「宿主
+ * 已经收下、还没等到回包」那一刻被杀掉，手机这边就分不清「重发会补上」还是「重发会重复」。
+ *
+ * 所以这里从**会话日志**里查：日志是持久的，重启也在。查到就是进过了，App 直接把发件箱
+ * 那一条划掉；查不到才真的重发。这比让 App 发完再拉一整段历史对账便宜，也比「相信内存里
+ * 那份去重表」稳。
+ *
+ * 只读、只听 token、只看最近这一窗：发件箱里的条目最多躺几天，`maxMessages` 取它够用的
+ * 上限；更早的不查 —— 查不到就按「没进」走重发，而重发那一步仍有插件的去重兜着。
+ *
+ * 不解析附件：这里只认「有没有这条 user 消息」，标题、图片字节都不需要
+ * （`deriveMessages` 之外的附件解析是这条端点唯一可能变贵的地方，刻意不走）。
+ */
+
+const { sendJson } = require('../shared/http-util');
+const { unwrap } = require('./envelope.js');
+const { callSessions } = require('./rpc.js');
+const { deriveMessages } = require('./history-derive.js');
+
+/** 一次回查读多少条事件：发件箱的条目只可能出现在最近这几天。 */
+const DELIVERY_HISTORY_WINDOW = 200;
+/** 两个参数的长度上限（与 `clientMessageId` 的生成形状同一个量级）。 */
+const PARAM_MAX = 200;
+
+/**
+ * GET /api/mobile/v1/session/delivery?sessionId=…&clientMessageId=…（token）
+ * → { ok, delivered, seq? }
+ *
+ * 宿主没有这条会话（被删 / 换了机器）时回 404：那是「查不到」，不是「没送到」——
+ * App 据此把发件箱里那条标成失败，而不是永远重试。
+ */
+async function handleSessionDelivery(ctx, req, res) {
+  const url = new URL(req.url, 'http://x');
+  const sessionId = (url.searchParams.get('sessionId') || '').trim();
+  const clientMessageId = (url.searchParams.get('clientMessageId') || '').trim();
+  if (!sessionId || !clientMessageId || sessionId.length > PARAM_MAX || clientMessageId.length > PARAM_MAX) {
+    return sendJson(res, 400, { ok: false, error: { code: 'bad-request', message: '需要 { sessionId, clientMessageId }' } });
+  }
+  const { value, error } = unwrap(await callSessions(ctx, 'history', { sessionId, maxMessages: DELIVERY_HISTORY_WINDOW }));
+  if (error) {
+    const missing = error.code === 'session-not-found';
+    return sendJson(res, missing ? 404 : 502, {
+      ok: false,
+      error: {
+        code: typeof error.code === 'string' ? error.code : 'host-call-failed',
+        message: typeof error.message === 'string' && error.message ? error.message : '读取会话历史失败',
+      },
+    });
+  }
+  const events = (value && Array.isArray(value.events)) ? value.events : [];
+  const messages = deriveMessages(events);
+  const hit = messages.find((message) => message.clientMessageId === clientMessageId);
+  sendJson(res, 200, {
+    ok: true,
+    delivered: Boolean(hit),
+    ...(hit && typeof hit.seq === 'number' ? { seq: hit.seq } : {}),
+  });
+}
+
+module.exports = { handleSessionDelivery, DELIVERY_HISTORY_WINDOW };