dsh-mobile-plugin 0.1.95 → 0.1.97

package/lib/relay/lan-proxy.js

@@ -14,7 +14,7 @@
 const http = require('node:http');
 const { WebSocketServer, WebSocket } = require('ws');
 const core = require('./core.js');
-const { isGlobalUnicastV6 } = require('./lan-network.cjs');
+const { advertisedCandidates, ipv6Candidates, isGlobalUnicastV6 } = require('./lan-network.cjs');
 const { safeEqual } = require('../shared/dshtoken');
 const { isFreshRequest } = require('../shared/fresh-request');
 const { encodeJsonBody } = require('../shared/http-util');
@@ -519,6 +519,13 @@ function createLanProxy(opts) {
                     const issued = credentials.issue(instanceId, device, token);
                     const cookieValue = core.signLanToken(lanSecret, instanceId, core.MOBILE_TOKEN_TTL_SEC);
                     setCookie(res);
+                    // 宿主自己那批直连候选一起回给手机：手输公网地址（域名 / 公网 IP）配对时，
+                    // 二维码那条路没有、也就只有这一处能拿到内网地址。回家后如果那个公网地址
+                    // 打不通（路由器不支持回环 / 域名只在外网解析），手机还能靠这批候选找到这台
+                    // 机器，否则只能删设备重配。App 的 `doPair` 本来就合并响应里的 `lanUrls`
+                    // 与 `ipv6Candidates`，这里不回它就只能记住手输的那一个地址。
+                    const directCandidates = advertisedCandidates(actualPort).map((candidate) => candidate.url).filter(Boolean);
+                    const v6Candidates = ipv6Candidates(actualPort).map((candidate) => candidate.url).filter(Boolean);
                     res.writeHead(200, { 'content-type': 'application/json' });
                     // cookie 同时放进 body：RN fetch 读不到 Set-Cookie 响应头，App 需自行携带
                     res.end(JSON.stringify({
@@ -526,6 +533,8 @@ function createLanProxy(opts) {
                       instanceId,
                       token: token || '',
                       cookie: `dsh_lan=${cookieValue}`,
+                      ...(directCandidates.length ? { lanUrls: directCandidates } : {}),
+                      ...(v6Candidates.length ? { ipv6Candidates: v6Candidates } : {}),
                       deviceId: issued.deviceId,
                       deviceCredential: issued.credential,
                       credentialExpiresAt: issued.expiresAt,

package/lib/routes/control-plane.js

@@ -49,6 +49,8 @@ const { checkForUpdate } = require('../update-registry.cjs');
 const { declaredSource } = require('../update-install.cjs');
 const { clearCompletionForAllDevices, invalidateSessionList } = require('../mobile/session-cache.js');
 const { recordSessionRead } = require('../mobile/session-last-turn.js');
+// 收件目录的占用与清理：和移动端那条路由是同一份实现（`lib/mobile/inbox-clean.js`）。
+const { scanInbox, clearInbox, usageView, setAutoClear } = require('../mobile/inbox-clean.js');
 
 /** 一次 desktop-read 上报最多带多少个会话 id（防灌爆；客户端半边一次最多也就几个）。 */
 const MAX_DESKTOP_READ_IDS = 200;
@@ -770,6 +772,38 @@ function registerControlPlaneRoutes(deps) {
       })
     }
   }) })
+  // ── 收件目录（手机分享进来的文件）──
+  //
+  // 同一份实现在移动端也有两条（`/api/mobile/v1/inbox/{status,clear}`），这里只是把它
+  // 开到网页面板上：面板与 App 读同一份扫描结果，两边不各算一套口径。
+  //
+  // 走 localOnly：清的是本机上那个固定收件目录，属于本机运维动作，和其余控制面一样。
+  // 面板侧也因此在网页管理窗口打不开时仍可由本机操作。
+  registerRoute({ kind: 'exact', path: '/api/relay/inbox/status', handler: localOnly('GET', async (_req, res) => {
+    sendJson(res, 200, usageView(await scanInbox()))
+  }) })
+  // 自动清理开关：默认关。打开后宿主每次启动顺手清一次（见 mobile/inbox-clean.js 的
+  // clearInboxOnce）。手动那颗「清理收件文件」不受它管 —— 那个是用户当场按的。
+  registerRoute({ kind: 'exact', path: '/api/relay/inbox/auto', handler: localOnly('POST', async (req, res) => {
+    let body = {}
+    try {
+      body = (await readJson(req)) || {}
+    } catch {
+      body = {}
+    }
+    if (typeof body.enabled !== 'boolean') return sendJson(res, 400, { ok: false, error: { code: 'bad-request', message: 'enabled 必须是布尔值' } })
+    try {
+      return sendJson(res, 200, { ok: true, data: { autoClear: setAutoClear(body.enabled) } })
+    } catch (error) {
+      return sendJson(res, 500, { ok: false, error: { code: 'write-failed', message: String(error?.message || error) } })
+    }
+  }) })
+  registerRoute({ kind: 'exact', path: '/api/relay/inbox/clear', handler: localOnly('POST', async (_req, res) => {
+    // 面板上那颗按钮自带二次确认；这里不额外要 `confirm` 字段 —— 移动端那条要求它，
+    // 是因为那里没有既有的确认口径，而这一页的确认是界面自己的事。
+    const result = await clearInbox()
+    sendJson(res, 200, { ok: true, ...result })
+  }) })
 }
 
 // 路由字符串清单放在注册区之后，避免被按路由源码切片的契约测试误认为是真正的 handler。
@@ -801,6 +835,10 @@ const WEB_ACCESS_ROUTES = new Set([
   '/api/relay/restart-sidecar',
   // 开发机的「就地重载」：能换掉本机跑着的实现，属于最该只允许本机调的那一类。
   '/api/relay/reload-implementation',
+  // 收件目录的占用与清理（面板那张「收件文件」卡）。
+  '/api/relay/inbox/status',
+  '/api/relay/inbox/clear',
+  '/api/relay/inbox/auto',
 ]);
 
 // `panelDiagnosis` 一并导出，只为让 test/panel-artifact.test.cjs 能拿临时目录跑那三条分支：

package/lib/routes/mobile-api.js

@@ -23,6 +23,9 @@ const { sendJson } = require('../http/routing.js');
 const { orderCandidates } = require('../relay/lan-network.cjs');
 
 const sessions = require('../mobile/sessions.js');
+const sessionModelOptions = require('../mobile/session-model-options.js');
+const sessionFile = require('../mobile/session-file.js');
+const stats = require('../mobile/stats.js');
 const agentPresets = require('../mobile/agent-presets.js');
 const stream = require('../mobile/stream.js');
 const events = require('../mobile/events.js');
@@ -32,15 +35,19 @@ const workspaces = require('../mobile/workspaces.js');
 const archiveClean = require('../mobile/archive-clean.js');
 const sessionLog = require('../mobile/session-log.js');
 const hostSettings = require('../mobile/host-settings.js');
+const channels = require('../mobile/channels.js');
 const deepSeekAccount = require('../mobile/deepseek-account.js');
 const skills = require('../mobile/skills.js');
 const mobileCredentials = require('../mobile/credentials.js');
 const subagents = require('../mobile/subagents.js');
 const monitor = require('../mobile/monitor.js');
 const references = require('../mobile/references.js');
+const schedule = require('../mobile/schedule.js');
 const plugins = require('../mobile/plugins.js');
 const pluginUpdate = require('../mobile/plugin-update.js');
 const uploads = require('../mobile/uploads.js');
+const inboxClean = require('../mobile/inbox-clean.js');
+const git = require('../mobile/git.js');
 const pairing = require('../mobile/pairing.js');
 const { credentialsEntry } = require('../shared/credentials-entry.js');
 // 体检接口要自报身份：版本号只有一个来源，就是包自己的 package.json（与 relay/status.js 同）。
@@ -118,7 +125,18 @@ function registerMobileRoutes(deps) {
   registerRoute({
     kind: 'exact',
     path: '/api/mobile/v1/pair',
-    handler: pairing.createPairHandler({ state, core, credentials: credentialsEntry(), pairingApproval, log: (...args) => console.warn('[dsh-mobile-plugin] [pair]', ...args) }),
+    handler: pairing.createPairHandler({
+      state,
+      core,
+      credentials: credentialsEntry(),
+      pairingApproval,
+      // 配对响应顺手把宿主当前的直连候选带回去（与 `/connection-info` 同一份取值）：
+      // 手输公网地址配对时没有二维码，这是手机拿到内网地址的唯一机会。
+      lanCandidates: safeLanCandidates,
+      ipv6Candidates: safeIpv6Candidates,
+      lanPort: lanPortInUse,
+      log: (...args) => console.warn('[dsh-mobile-plugin] [pair]', ...args),
+    }),
   })
   // 局域网/中转连接信息。**这条由宿主自己回答**：中转只转发，不再代答。
   // 纯局域网配对（App 只扫到局域网二维码、完全不经中转）需要一个宿主自己回答的地址，
@@ -170,6 +188,8 @@ function registerMobileRoutes(deps) {
   route('/api/mobile/v1/session', sessions.handleSession)
   route('/api/mobile/v1/session/messages', sessions.handleMessages)
   route('/api/mobile/v1/session/attachment', sessions.handleSessionAttachment)
+  // 交付文件卡要的字节：只放行本会话 present 声明过的路径（见 mobile/session-file.js）。
+  route('/api/mobile/v1/session/file', sessionFile.handleSessionFile)
   route('/api/mobile/v1/session/send', sessions.handleSend)
   // 正文水位探针：App 进对话前先问一句「这条会话的正文到哪个水位了」，跟本地缓存水位
   // 一比就知道要不要重拉全量历史（几十字节换几兆）。**只读信号快照**：信号里没有就如实
@@ -182,7 +202,12 @@ function registerMobileRoutes(deps) {
   route('/api/mobile/v1/session/fork', sessions.handleFork)
   route('/api/mobile/v1/session/models', sessions.handleModels)
   route('/api/mobile/v1/session/select-model', sessions.handleSelectModel)
+  // 模型之外的附加选项（速度、输出详略……）：写一条已声明的行，落地是宿主自己的设置。
+  route('/api/mobile/v1/session/model-option', sessionModelOptions.handleModelOption)
   route('/api/mobile/v1/session/stats', sessions.handleStats)
+  // 统计总览（统计页）。账本落在宿主家里（`$DSH_HOME/mobile-stats.json`），与会话日志
+  // 无关：归档只是挪位置，清理删的是日志，历史数字都还在 —— 见 mobile/stats-ledger.cjs。
+  route('/api/mobile/v1/stats/overview', stats.handleStatsOverview)
   // 正文检索（宿主 session.search 的移动端代理）：只回 { sessionId, snippet }，
   // 标题 / 工作区由 App 用自己轮询到的会话列表拼接，见 mobile/sessions.js。
   route('/api/mobile/v1/session/search', sessions.handleSessionSearch)
@@ -226,6 +251,24 @@ function registerMobileRoutes(deps) {
   // 「清理所有已归档的对话」（侧栏归档视图的文字按钮）：按 workspace.list 的归档集合全量清理，
   // 且 body 必须带 confirm: true（磁盘删除不可恢复）。
   route('/api/mobile/v1/workspace/clear-archived', archiveClean.handleClearArchived)
+  // Git 管理器（docs/git-manager.md）：手机上的仓库概览 / 变更 / 历史 / 分支都是读，
+  // 暂存 / 提交 / 切分支是写。能力面是一组固定命名的动词，不接受透传命令；每个请求都带
+  // workspaceId 与（可选的）仓库根，插件再校验它确实属于这个项目识别出来的仓库。
+  route('/api/mobile/v1/git/repo', git.handleGitRepo)
+  route('/api/mobile/v1/git/status', git.handleGitStatus)
+  route('/api/mobile/v1/git/diff', git.handleGitDiff)
+  route('/api/mobile/v1/git/log', git.handleGitLog)
+  route('/api/mobile/v1/git/show', git.handleGitShow)
+  route('/api/mobile/v1/git/branches', git.handleGitBranches)
+  route('/api/mobile/v1/git/overview', git.handleGitOverview)
+  route('/api/mobile/v1/git/stage', git.handleGitStage)
+  route('/api/mobile/v1/git/unstage', git.handleGitUnstage)
+  route('/api/mobile/v1/git/commit', git.handleGitCommit)
+  route('/api/mobile/v1/git/checkout', git.handleGitCheckout)
+  // 推当前分支到它的上游：只做这一档，不收分支名 / 远端名 / force 开关。
+  route('/api/mobile/v1/git/push', git.handleGitPush)
+  // AI 写提交信息：只读 `git diff --cached`，调宿主 llm 服务，回一行文案；不提交、不推送。
+  route('/api/mobile/v1/git/commit-message', git.handleGitCommitMessage)
   // 桌面端 `/export` 其实是两步：命令本身只留一行 transcript 标记，真正的下载由
   // @deepseek-ai/dsh-session-log-export 在浏览器侧监听 command/executed 后拉
   // `GET /api/session.export` 完成。手机端没有浏览器下载管理器，而那个端点绑在宿主
@@ -242,6 +285,16 @@ function registerMobileRoutes(deps) {
   // 改设置：与桌面端同一个 settings.mutate（按路径寻址的 op + expectedRevision 乐观并发）。
   route('/api/mobile/v1/host-settings/mutate', hostSettings.handleHostSettingsMutate)
   route('/api/mobile/v1/llm/providers', hostSettings.handleLlmProviders)
+  // 宿主的模型目录（`llm.models`）：每个提供方下面真正可请求的模型 id，给「用哪个模型做
+  // AI commit」这类选择器用 —— 它不需要活动会话，与 `/session/models` 不是一回事。
+  route('/api/mobile/v1/llm/models', hostSettings.handleLlmModels)
+  // 渠道管理（见 mobile/channels.js）：只对「本机自建」那一类（`llm-pi-ai` 里的路由）
+  // 提供增删；插件 / 宿主注册的提供方只列出来，一个写操作都不做。获取模型由宿主代问
+  // （端点常在内网，手机直连未必通），与桌面面板的 `discoverModels` 同一条路。
+  route('/api/mobile/v1/channels', channels.handleChannels)
+  route('/api/mobile/v1/channels/discover', channels.handleChannelDiscover)
+  route('/api/mobile/v1/channels/save', channels.handleChannelSave)
+  route('/api/mobile/v1/channels/delete', channels.handleChannelDelete)
   // 技能目录（宿主 skill.list 的移动端只读代理）。桌面端敲「/」时命令候选菜单里
   // 混着技能（@deepseek-ai/dsh-client-ui-skill 注册的 inputTriggers source），
   // 手机端此前只有 commands.list 的命令目录，技能一个都看不到，见 mobile/skills.js。
@@ -268,6 +321,15 @@ function registerMobileRoutes(deps) {
   route('/api/mobile/v1/file-references', references.handleFileReferences)
   route('/api/mobile/v1/session-references', references.handleSessionReferences)
 
+  // 定时任务（宿主 ScheduleService 的移动端代理）：目录、会话内 active 任务、运行记录、
+  // 删除。桌面端有一套完整的定时任务面板，手机端此前一条都看不到；服务同进程直查
+  // `ctx.get('schedule')`，宿主没有它时这四条统一回 503 而不是空列表，
+  // 见 mobile/schedule.js。`update` 这一批没接：手机端还没有编辑入口。
+  route('/api/mobile/v1/schedule/catalog', schedule.handleScheduleCatalog)
+  route('/api/mobile/v1/schedule/list', schedule.handleScheduleList)
+  route('/api/mobile/v1/schedule/history', schedule.handleScheduleHistory)
+  route('/api/mobile/v1/schedule/delete', schedule.handleScheduleDelete)
+
   // 桌面端 设置 → 插件 的只读部署快照，由 dsh-host-plugin-inventory 拥有，
   // 经 typertGateway 命名空间 pluginInventory 取，见 mobile/plugins.js。
   route('/api/mobile/v1/plugins', plugins.handlePlugins)
@@ -288,6 +350,13 @@ function registerMobileRoutes(deps) {
   route('/api/mobile/v1/upload/chunk', uploads.handleUploadChunk)
   route('/api/mobile/v1/upload/finish', uploads.handleUploadFinish)
   route('/api/mobile/v1/upload/abort', uploads.handleUploadAbort)
+  // 同一个收件目录的出口：上面四条只往里放，这两条报占用、按龄清掉（见 mobile/inbox-clean.js）。
+  // 落盘的文件不认识会话，所以没有「删掉这条对话就顺带清掉它传上来的文件」这条路 ——
+  // 唯一的出口只能按龄，口径写在那个文件头。
+  route('/api/mobile/v1/inbox/status', inboxClean.handleInboxStatus)
+  route('/api/mobile/v1/inbox/clear', inboxClean.handleInboxClear)
+  // 自动清理开关：默认关，打开后宿主每次启动顺手清一次（面板那颗按钮不受它管）。
+  route('/api/mobile/v1/inbox/auto', inboxClean.handleInboxAuto)
 
   // 内置浏览器预览（App 侧「点 localhost 链接在内置浏览器里打开」的宿主端一半）。
   //

package/lib/session-cleanup.cjs

@@ -46,6 +46,8 @@ const HEADER_MAX_BYTES = 64 * 1024
 
 const { envelopeValue, unwrap } = require('./mobile/envelope.js')
 const { rememberDeletedSessionIds } = require('./mobile/session-cache.js')
+// 收件目录的启动清理与这里共用同一个「宿主刚起来」的窗口，实现见 mobile/inbox-clean.js。
+const { clearInboxOnce } = require('./mobile/inbox-clean.js')
 
 function asItems(response) {
   const value = envelopeValue(response)
@@ -469,6 +471,12 @@ function installSessionCleanup(ctx) {
     void pruneOrphanedArchivedSessionsOnce(ctx, (message) => {
       try { ctx.logger?.info?.(message) } catch { /* 日志失败不影响修剪 */ }
     })
+    // 收件目录（手机分享进来的文件）也在这里顺手清一次：它只进不出，不点按钮就没人管。
+    // 与上面那条同一个「宿主刚起来」的窗口，但两者互不依赖 —— 收件目录的口径只看 mtime，
+    // 碰不到任何会话日志（见 mobile/inbox-clean.js 的文件头）。
+    void clearInboxOnce((message) => {
+      try { ctx.logger?.info?.(message) } catch { /* 日志失败不影响清理 */ }
+    })
   }
   registerSessionCleanupTool(ctx)
 }

package/lib/shared/sse-write.js

@@ -11,10 +11,11 @@
  * 事件 id 怎么算」「写不动时怎么等 drain」都只在这里，两条流只在调用点上声明自己的策略。
  *
  * 两条流刻意保留的差异（不是遗漏，改之前先看各自的理由）：
- *  - 丢帧口径：会话流的软水位只丢**没有 seq** 的增量（`assistant/chunk` 是草稿，同一轮
- *    收尾的 `assistant/message` 带完整正文、重连 `replaySince` 能补齐）；设备级流的帧
- *    全是「有东西变了」的幂等信号，软水位一律丢，下一次变更或重连补发会再补上。
- *    由调用方传 `shedWhenBuffered`。
+ *  - 丢帧口径：会话流的软水位只丢**明确可丢的增量**（只有 `assistant/chunk` 草稿：同一轮
+ *    收尾的 `assistant/message` 带完整正文、重连 `replaySince` 能补齐）。`session/queue`、
+ *    `session/jobs`、`session/resync-required` 这些控制帧没有 seq，但绝不能丢；设备级流的
+ *    帧全是「有东西变了」的幂等信号，软水位丢弃后由调用方**断流重连**并用
+ *    `replayKnownSignals()` 补发。由调用方传 `shedWhenBuffered`。
  *  - 写不动时：会话流 `await` 一次 drain（20s 超时再收尾）；设备级流直接收尾让客户端
  *    重连 —— 它没有 Last-Event-ID 续传，但连上时会 `replayKnownSignals()` 补发当前状态，
  *    所以「断开重连」是它的正常收敛路径。
@@ -42,8 +43,18 @@ const SSE_CLOSE_BUFFERED_BYTES = 16 * 1024 * 1024;
  */
 const SSE_DRAIN_TIMEOUT_MS = 20_000;
 
-/** 默认丢帧口径：没有 seq 的帧可以丢，有 seq 的不能（丢了不回放就在手机上留个洞）。 */
-const shedWithoutSeq = (payload) => !Number.isFinite(payload && payload.seq);
+/**
+ * 默认丢帧口径：只有**明确可丢**的无 seq 增量帧可以丢；有 seq 的一律不能丢。
+ *
+ * 旧实现是「没有 seq 就丢」，结果把 `session/queue` / `session/jobs` /
+ * `session/resync-required` 这些控制帧一起丢了 —— 它们没有 seq，但丢了没有回放路径，
+ * 队列/任务面板会永久停在旧状态，gap 提示也到不了客户端。
+ */
+const SHEDDABLE_INCREMENTAL_TYPES = new Set(['assistant/chunk']);
+const shedWithoutSeq = (payload) => {
+  if (!payload || !SHEDDABLE_INCREMENTAL_TYPES.has(payload.type)) return false;
+  return !Number.isFinite(payload.seq);
+};
 
 /** 每条记录后面补的 SSE 注释（客户端忽略内容，只用来把小 chunk 撑过 RN 的缓冲阈值）。 */
 function ssePadding(bytes) {

package/lib/shell/updater.js

@@ -312,13 +312,13 @@ function autoUpdateFile() {
   return path.join(dshHome(), 'storages', 'mobile-plugin', 'auto-update.json')
 }
 
-/** 读开关。读不到 / 读坏了都当「关」——自动装东西这种事，缺省必须在用户这一侧。 */
+/** 未设置过默认自动更新；显式关闭保持关闭，配置损坏时不改动盘上插件。 */
 export function autoUpdateEnabled() {
   try {
     const raw = JSON.parse(fs.readFileSync(autoUpdateFile(), 'utf8'))
     return raw?.enabled === true
-  } catch {
-    return false
+  } catch (error) {
+    return error?.code === 'ENOENT'
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.1.95",
+  "version": "0.1.97",
   "description": "Mobile API (/api/mobile/v1) and relay client for the DSH mobile app — desktop profile build (0.2.0-rc.2 compatible, peers resolved by the host)",
   "license": "MIT",
   "type": "module",
@@ -45,7 +45,8 @@
     "test": "node --test test/*.test.cjs && node test/lan-direct-e2e.cjs && node test/sidecar-facade.cjs"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-tool-ask-user": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tool-ask-user": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tool-present": "0.2.1-rc.2",
     "qrcode": "1.5.4",
     "ws": "8.18.0"
   },