dsh-plugin-mobile-link 0.6.5 → 0.7.0

package/lib/routes.js

@@ -94,6 +94,7 @@ export function registerMobileLinkRoutes(ctx, { agent, logger, config = {}, hist
   const guard = makeGuard(ctx, logger)
   const STATUS_ROUTE = '/mobile-link/status'
   const PAIR_ROUTE = '/mobile-link/pair-code'
+  const REGENERATE_ROUTE = '/mobile-link/pair-code/regenerate'
   const disposers = []
 
   disposers.push(ctx.webServer.register({
@@ -131,10 +132,14 @@ export function registerMobileLinkRoutes(ctx, { agent, logger, config = {}, hist
         sendJson(res, 400, { ok: false, message: 'invalid JSON body' })
         return
       }
-      const ttlMs = ttlFrom(body.ttlMs, Number(config.pairTtlMs) || 10 * 60 * 1000)
+      // 032：调用方**没提** ttlMs 就要一张持久码（面板走这条路）；显式给了才限时，
+      // 那是老行为，留给还在用的调用方。
+      const wantsTtl = Object.prototype.hasOwnProperty.call(body, 'ttlMs')
+      const ttlMs = wantsTtl ? ttlFrom(body.ttlMs, Number(config.pairTtlMs) || 10 * 60 * 1000) : null
       try {
         const minted = await agent.mintPairCode({ ttlMs })
-        logger.info?.(`mobile-link: minted a pairing code for ${minted.agentId}`)
+        logger.info?.(`mobile-link: minted a ${minted.persistent ? 'persistent' : 'time-limited'}`
+          + ` pairing code for ${minted.agentId}`)
         // The picture travels with the code. It used to be a route of its own
         // (`GET /mobile-link/qr`) that a person opened in a browser; the pairing
         // entry is now the connector's own panel in the DSH client, so the one
@@ -148,5 +153,32 @@ export function registerMobileLinkRoutes(ctx, { agent, logger, config = {}, hist
     },
   }))
 
+  disposers.push(ctx.webServer.register({
+    kind: 'exact',
+    path: REGENERATE_ROUTE,
+    handler: async (req, res) => {
+      if (guard(req, res, { requireFence: true })) return
+      if (req.method !== 'POST') {
+        res.statusCode = 405
+        res.setHeader('allow', 'POST')
+        res.end()
+        return
+      }
+      const body = await readJsonBody(req)
+      if (body === undefined) {
+        sendJson(res, 400, { ok: false, message: 'invalid JSON body' })
+        return
+      }
+      try {
+        const minted = await agent.regeneratePairCode()
+        logger.info?.(`mobile-link: regenerated the pairing code for ${minted.agentId}`
+          + ` (revoked ${minted.revoked})`)
+        sendJson(res, 200, { ok: true, ...minted, svg: qrSvg(minted.qrPayload) })
+      } catch (error) {
+        sendJson(res, 502, { ok: false, code: 'relay/unavailable', message: String(error?.message ?? error) })
+      }
+    },
+  }))
+
   return disposers
 }

package/lib/session-digest.js

@@ -12,25 +12,33 @@
  */
 
 import { deflateRawSync } from 'node:zlib'
+import { createHash } from 'node:crypto'
 
 /** 方法名（设备发起，中转不校验方法名，所以不需要中转改动）。 */
 export const SESSION_DIGEST_METHOD = '_link/sessionDigest'
 
 /** 会话项里剔掉的字段：零读取点（`agentAvailable` 1.8%）。 */
-export const DROPPED_ITEM_KEYS = Object.freeze(['agentAvailable'])
+// `agentAvailable` 曾是"零读取点"，018 之后列表行要用它区分"会话是否还有活实例"
+// （`ActivityStore` 与 `session.activity.*`），因此**不再剔除**。留空数组是为了保住
+// 「剔除机制 + 逐字节稳定」这两条不变式；将来要剔字段仍从这里加。
+export const DROPPED_ITEM_KEYS = Object.freeze([])
 
 /**
- * 投影键里剔掉的字段（合计 56.7%）。
+ * 投影键里剔掉的字段（合计约 55%）。
  *
  * 每一条都能在 App/DSHKit 里复查"零读取点"：
  * `turnOutline` 33.4%（每轮 prompt/response 原文）、`imageLimits` 6.2%（上传限制）、
  * `sessionStats` 4.2%、`todos` 2.6%、`subagentCatalog` 2.6%、`contextBreakdown` 2.5%、
  * `sessionListMetadata` 1.9%（唯一被读的 `blank` 在顶层已有同名字段）、
- * `subagentTiming` 1.5%、`agentPreset` 0.8%（`SessionCreateRequest.agentPreset` 是请求字段）。
+ * `agentPreset` 0.8%（`SessionCreateRequest.agentPreset` 是请求字段）。
+ *
+ * **2026-10-20 起不再剔除 `subagentTiming`**（原 1.5%）：018 的活动可见性靠它判断
+ * "某子会话当前是否在跑"与已跑时长；剔除后手机永远看不到「N 智能体」。
+ * 同理 `agentAvailable` 也不再剔除。代价是摘要通道多约 1.5% 字节，换来功能可用。
  */
 export const DROPPED_PROJECTION_KEYS = Object.freeze([
   'turnOutline', 'imageLimits', 'sessionStats', 'todos', 'subagentCatalog',
-  'contextBreakdown', 'sessionListMetadata', 'subagentTiming', 'agentPreset',
+  'contextBreakdown', 'sessionListMetadata', 'agentPreset',
 ])
 
 /**
@@ -115,3 +123,50 @@ export function encodeDigest(value, encoding) {
     rawBytes: raw.length,
   }
 }
+
+/** 单条会话的稳定指纹：内容不变则指纹不变（用于增量比较）。 */
+export function digestFingerprint(item) {
+  try {
+    return createHash('sha1').update(JSON.stringify(item)).digest('hex').slice(0, 16)
+  } catch {
+    return 'unhashable'
+  }
+}
+
+/** 一批会话的指纹表（id → 指纹）。 */
+export function digestFingerprints(items) {
+  const map = new Map()
+  for (const item of items ?? []) {
+    if (item && typeof item.id === 'string') map.set(item.id, digestFingerprint(item))
+  }
+  return map
+}
+
+/** 指纹表的版本：指纹集合不变则版本不变。 */
+export function fingerprintsVersion(map) {
+  const keys = [...map.keys()].sort()
+  const digest = createHash('sha1')
+  for (const key of keys) digest.update(key).update('\u0000').update(map.get(key)).update('\u0001')
+  return digest.digest('hex').slice(0, 16)
+}
+
+/**
+ * 相对上一次指纹表的增量。
+ *
+ * 入参 `previous` 为 Map 或 null；返回 changed（新增或内容变化的项）、
+ * removed（消失的 id）与新版本。`previous` 为空时调用方应按全量处理。
+ */
+export function digestDelta(previous, items) {
+  const list = Array.isArray(items) ? items : []
+  const next = digestFingerprints(list)
+  const changed = []
+  for (const item of list) {
+    if (!item || typeof item.id !== 'string') continue
+    if (!previous || previous.get(item.id) !== next.get(item.id)) changed.push(item)
+  }
+  const removed = []
+  if (previous) {
+    for (const id of previous.keys()) if (!next.has(id)) removed.push(id)
+  }
+  return { changed, removed, version: fingerprintsVersion(next), fingerprints: next }
+}

package/lib/state.js

@@ -3,8 +3,8 @@
  *
  * The file holds the long-lived `agentId` / `agentSecret` for this computer.
  * There are two ways it gets there, and they are deliberately indistinguishable
- * afterwards: the relay operator provisions it by hand (relay/admin.py
- * `agent-register --write-config`), or the person running the computer redeems
+ * afterwards: the relay operator provisions it by hand (`dsh-relay admin
+ * agent-register --write-config`), or the person running the computer redeems
  * an invite code themselves (`dsh-mobile-link enroll`, see enroll.js).
  * Environment variables and the plugin config block override the file, which is
  * how the integration test injects a throwaway identity.
@@ -109,7 +109,7 @@ export async function resolveIdentity({ stateFile, agentId, agentSecret, relayUr
       `mobile-link: this computer is not registered yet. Run "dsh-mobile-link enroll`
       + ` --invite <code> --relay <relay-url>" with the invite code you were given, or set`
       + ` ${INVITE_ENV} and restart DSH. (Provisioning by hand is still possible:`
-      + ` "python3 relay/admin.py agent-register --account <acc> --name <name>`
+      + ` "dsh-relay admin agent-register --account <acc> --name <name>`
       + ` --write-config ${path}".)`,
       { stateFile: path },
     )

package/lib/status.js

@@ -6,7 +6,7 @@
  * 函数只读 agent 的字段，不持有状态，因此可以直接被单测调用。
  */
 
-import { SERVER_CAPABILITIES, SERVER_VERSION } from './hello.js'
+import { SERVER_CAPABILITIES, SERVER_VERSION, hostVersion } from './hello.js'
 
 const PROTOCOL_VERSION = 1
 
@@ -93,6 +93,9 @@ export function statusSnapshot(agent) {
     // Same facts as `_link/hello`, which is the channel the app actually uses:
     // this route only exists on the direct path.
     serverVersion: SERVER_VERSION,
+    // 宿主 DSH 的版本（`null` = 这个宿主没把版本放进环境）。与 `serverVersion`
+    // 是两个命名空间：前者是连接器，后者是跑它的 DSH。
+    hostVersion: hostVersion(),
     capabilities: SERVER_CAPABILITIES,
     enroll: {
       // A phone (or the user's browser) can read this to find out that the

package/lib/unicode.js

@@ -0,0 +1,116 @@
+/**
+ * UTF-16 安全边界：落单代理项修复与按码元安全截断。
+ *
+ * 为什么需要（2026-10-17 事故的同一个根）：
+ *
+ *   JS 字符串按 UTF-16 码元索引。凡是 `text.slice(0, n)` 这类截断，n 落在代理对
+ *   中间时就会留下**落单的高代理项**（`\ud83d`），序列化成 JSON 后是 `"\ud83d…"`。
+ *   这种帧不是合法 Unicode：中转要按 UTF-8 计费，编码直接抛错（Python 版当年就是
+ *   这么把连接打死的）；iOS 的 `JSONDecoder` 会整条拒绝（`Missing low code point
+ *   in surrogate pair`）。中转现在会用 U+FFFD 修好再转发，但**生产端不该发出这种
+ *   帧**——它是本连接器的出口，帧有效性归这里。
+ *
+ * 两件事分开：
+ *   1. `repairLoneSurrogates`：出口兜底。帧里已经有落单代理项时替换成 U+FFFD，
+ *      与中转的修复口径一致；
+ *   2. `truncateSafe` / `sliceRangeSafe`：自己截断时就不制造落单代理项（预览、
+ *      搜索片段、diff 正文）。兜底只防别人的数据，自己造出来的必须从源头修。
+ */
+
+/** JSON 转义里的四位十六进制（大小写都认）。 */
+const HEX_UNIT = /^[0-9a-fA-F]{4}$/
+
+function hexUnitAt(text, at) {
+  if (at + 4 > text.length) return -1
+  const raw = text.slice(at, at + 4)
+  return HEX_UNIT.test(raw) ? Number.parseInt(raw, 16) : -1
+}
+
+/** 这个反斜杠本身是不是被转义了（前面有奇数个连续反斜杠）。 */
+function isEscapedBackslash(text, index) {
+  let count = 0
+  for (let i = index - 1; i >= 0 && text[i] === '\\'; i -= 1) count += 1
+  return count % 2 === 1
+}
+
+function isHighUnit(unit) {
+  return unit >= 0xd800 && unit <= 0xdbff
+}
+
+function isLowUnit(unit) {
+  return unit >= 0xdc00 && unit <= 0xdfff
+}
+
+/**
+ * 扫描一段 JSON 文本，把**落单**的 `\uD800`–`\uDFFF` 转义换成 `\ufffd`。
+ *
+ * 只认真正的转义（`\\ud83d` 是字面量）；合法配对原样保留。替换串与转义同为
+ * 6 个字符，帧长度不变。返回值带修复条数，调用方据此决定要不要记一条告警。
+ *
+ * @param {string} text JSON 文本
+ * @returns {{ text: string, repaired: number }}
+ */
+export function repairLoneSurrogatesWithCount(text) {
+  if (typeof text !== 'string') return { text, repaired: 0 }
+  // 廉价前置判断：正常帧连 `\ud`/`\uD` 都没有，不做完整扫描。
+  if (text.indexOf('\\ud') < 0 && text.indexOf('\\uD') < 0) return { text, repaired: 0 }
+
+  let out = ''
+  let last = 0
+  let repaired = 0
+  for (let i = 0; i + 5 < text.length; i += 1) {
+    if (text[i] !== '\\' || text[i + 1] !== 'u') continue
+    if (isEscapedBackslash(text, i)) continue
+    const unit = hexUnitAt(text, i + 2)
+    if (unit < 0) continue
+    if (isHighUnit(unit)) {
+      let paired = false
+      if (text[i + 6] === '\\' && text[i + 7] === 'u') {
+        const next = hexUnitAt(text, i + 8)
+        paired = isLowUnit(next)
+      }
+      if (paired) {
+        i += 11 // 整个 `\uXXXX\uXXXX` 是合法配对：跳过 12 个字符
+        continue
+      }
+    } else if (!isLowUnit(unit)) {
+      continue
+    }
+    out += `${text.slice(last, i)}\\ufffd`
+    last = i + 6
+    repaired += 1
+  }
+  if (repaired === 0) return { text, repaired: 0 }
+  return { text: out + text.slice(last), repaired }
+}
+
+/** `repairLoneSurrogatesWithCount` 只取文本的那一半。 */
+export function repairLoneSurrogates(text) {
+  return repairLoneSurrogatesWithCount(text).text
+}
+
+/**
+ * 截到 `end` 个**码元**为止，且不把代理对切开。
+ *
+ * 与 `text.slice(0, end)` 的差别只有一种：第 `end` 个码元是高代理项时把它让给
+ * 后半截（结果最多少 1 个码元），从而不会留下落单的高代理项。
+ */
+export function truncateSafe(text, end) {
+  if (typeof text !== 'string' || !(end > 0)) return ''
+  if (text.length <= end) return text
+  const unit = text.charCodeAt(end - 1)
+  return text.slice(0, isHighUnit(unit) ? end - 1 : end)
+}
+
+/**
+ * `text.slice(start, end)` 的安全版本：起点若落在低代理项上就后移一位，终点若
+ * 落在高代理项上就前移一位；两端都不会制造落单代理项。
+ */
+export function sliceRangeSafe(text, start, end) {
+  if (typeof text !== 'string') return ''
+  let from = Math.max(0, Math.min(Number(start) || 0, text.length))
+  let to = Math.max(from, Math.min(Number(end) || 0, text.length))
+  if (isLowUnit(text.charCodeAt(from))) from += 1
+  if (isHighUnit(text.charCodeAt(to - 1))) to -= 1
+  return text.slice(from, Math.max(from, to))
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-mobile-link",
-  "version": "0.6.5",
+  "version": "0.7.0",
   "description": "Put your PC's DeepSeek Harness in your pocket: dials a relay over WSS so the native iOS client reaches this machine even without a public IP.",
   "keywords": [
     "dsh",