dsh-mobile-plugin 0.5.17 → 0.5.19

package/lib/routes/mobile-api.js

@@ -48,13 +48,17 @@ const { createRelayControlHandlers } = require('../mobile/relay-control.js');
 const uploads = require('../mobile/uploads.js');
 const canvasStore = require('../mobile/canvas-store.js');
 const inboxClean = require('../mobile/inbox-clean.js');
+// 过程播报开关（读 / 写同一条路径，由 req.method 分派）。默认关，见那个文件头。
+const narration = require('../mobile/narration.js');
 const git = require('../mobile/git.js');
+const terminal = require('../mobile/terminal.js');
 const pairing = require('../mobile/pairing.js');
 const { credentialsEntry } = require('../shared/credentials-entry.js');
 const { handleCredentialUpgrade } = require('../mobile/credential-upgrade.js');
 const extensions = require('../mobile/extensions.js');
 const extensionDev = require('../mobile/extension-dev.js');
 const sessionDelivery = require('../mobile/session-delivery.js');
+const { createPhoneRoutes } = require('../mobile/phone/routes.js');
 // 体检接口要自报身份：版本号只有一个来源，就是包自己的 package.json（与 relay/status.js 同）。
 const pkg = require('../../package.json');
 const desktopView = require('../desktop-view.cjs');
@@ -82,8 +86,79 @@ const API_VERSION = '1';
  *   所以它走 route() 即包 guarded。
  */
 function registerMobileRoutes(deps) {
-  const { registerRoute, registerUpgradeRoute, guarded, state, hostMetadata, getSidecarSnapshot, safeLanCandidates, safeIpv6Candidates, lanPortInUse, preview, core, pairingApproval, rotatePairing } = deps;
-  const route = (path, handler) => registerRoute({ kind: 'exact', path, handler: guarded(handler) })
+  const { registerRoute, registerUpgradeRoute, guarded, state, hostMetadata, getSidecarSnapshot, safeLanCandidates, safeIpv6Candidates, lanPortInUse, preview, core, pairingApproval, rotatePairing, terminalService, cliService, phoneService } = deps;
+  // CLI 会话（`cli-*`）在这张表上分派一次（见 mobile/cli/mobile.js）：它们是 ACP 子进程、
+  // 不是宿主的会话，但手机上必须像普通会话一样可用 —— 列表 / 历史 / 发送 / 停止 / 流 /
+  // 审批 / 模型全走宿主那套端点。分派发生在 `route()` 里面，下面每条注册都还是原样一行，
+  // handler 一个都没抄；`sessionId` 不在 `cli-` 前缀上的请求原样交给原 handler。
+  const cliMobile = cliService && cliService.mobile
+  const route = (path, handler) => registerRoute({ kind: 'exact', path, handler: guarded(withCliSession(path, handler)) })
+  /**
+   * 哪些路径要过 CLI 分派。
+   *
+   * 只收「请求体是 JSON / 只读」的那批：`route()` 里的分派要先读一次 POST 的请求体才能看见
+   * sessionId，二进制那条（`/session/file`、上传分片）一读就坏，所以它们不在名单里 ——
+   * CLI 会话也没有那些东西。
+   */
+  const CLI_SESSION_PATHS = new Set([
+    '/api/mobile/v1/session',
+    '/api/mobile/v1/session/messages',
+    '/api/mobile/v1/session/send',
+    '/api/mobile/v1/session/attachment',
+    '/api/mobile/v1/session/head',
+    '/api/mobile/v1/session/stop',
+    '/api/mobile/v1/session/rename',
+    '/api/mobile/v1/session/fork',
+    '/api/mobile/v1/session/models',
+    '/api/mobile/v1/session/select-model',
+    '/api/mobile/v1/session/model-option',
+    '/api/mobile/v1/session/model-visibility',
+    '/api/mobile/v1/session/stats',
+    '/api/mobile/v1/session/read',
+    '/api/mobile/v1/session/delivery',
+    '/api/mobile/v1/session/search',
+    '/api/mobile/v1/session/goal',
+    '/api/mobile/v1/session/queue/update',
+    '/api/mobile/v1/commands',
+    '/api/mobile/v1/skills',
+    '/api/mobile/v1/subagents',
+    '/api/mobile/v1/file-references',
+    '/api/mobile/v1/session-references',
+    '/api/mobile/v1/extension/cards',
+    // 导出：CLI 会话没有宿主日志，这条回一份空 ZIP（见 cli/mobile.js 的 handleExport）。
+    '/api/mobile/v1/session-log',
+  ])
+  /**
+   * 会话级开关里那四条「属于会话自己、不属于工作区」的写：归档 / 取消归档 / 置顶 /
+   * 取消置顶。CLI 会话在宿主那本账里没有条目，原样透过去只会换一张错误卡，所以 `cli-*`
+   * 由适配层自己记（内存账，跟 CLI 会话一起没）。
+   */
+  const CLI_SESSION_FLAGS = {
+    '/api/mobile/v1/workspace/archive-session': 'archive',
+    '/api/mobile/v1/workspace/unarchive-session': 'unarchive',
+    '/api/mobile/v1/workspace/pin-session': 'pin',
+    '/api/mobile/v1/workspace/unpin-session': 'unpin',
+  }
+  function withCliSession(path, handler) {
+    if (!cliMobile) return handler
+    if (path === '/api/mobile/v1/sessions') return cliMobile.wrapSessions(handler)
+    if (CLI_SESSION_FLAGS[path]) return cliMobile.routeFlag(CLI_SESSION_FLAGS[path], handler)
+    if (path === '/api/mobile/v1/workspace/clear-archived') return cliMobile.wrapClearArchived(handler)
+    // 后台提醒视图：CLI 会话的「在跑 / 刚完成 / 待回话」也从这里出去（注入成取值器，
+    // monitor.js 不认识 CLI 的任何细节，出口形状不变）。
+    if (path === '/api/mobile/v1/monitor') {
+      return (ctx, req, res) => handler(ctx, req, res, () => cliMobile.monitorItems())
+    }
+    if (path === '/api/mobile/v1/approval/respond') return cliMobile.wrapApprovalRespond(handler)
+    if (path === '/api/mobile/v1/session/stream') {
+      return (ctx, req, res) => {
+        const sessionId = new URL(req.url || '/', 'http://x').searchParams.get('sessionId')
+        return cliMobile.isCliSessionId(sessionId) ? cliMobile.handleStream(ctx, req, res) : handler(ctx, req, res)
+      }
+    }
+    if (CLI_SESSION_PATHS.has(path)) return cliMobile.route(path, handler)
+    return handler
+  }
   // 中转配置那一组要**装配期已有的实例**（config store、sidecar 生命周期），不能靠模块级
   // 单例去拿：同一进程里两份 relay.json 的真值只会打架。所以这里按装配层给的依赖建一次。
   const relayControl = createRelayControlHandlers(deps.relayControl || {})
@@ -260,6 +335,12 @@ function registerMobileRoutes(deps) {
   route('/api/mobile/v1/session/select-model', sessions.handleSelectModel)
   // 模型之外的附加选项（速度、输出详略……）：写一条已声明的行，落地是宿主自己的设置。
   route('/api/mobile/v1/session/model-option', sessionModelOptions.handleModelOption)
+  // CLI 模型管理页的开关（只影响显示，真值存在那台电脑上，见 cli/model-visibility.js）。
+  // 这条只对 CLI 会话有意义：宿主那套模型目录没有「跨手机一致」的要求，所以非 CLI 的
+  // sessionId 一律回 400，不做静默成功。
+  route('/api/mobile/v1/session/model-visibility', async (_ctx, _req, res) => {
+    sendJson(res, 400, { ok: false, error: { code: 'cli-only', message: '这条接口只对 CLI 会话有效' } });
+  })
   route('/api/mobile/v1/session/stats', sessions.handleStats)
   // 统计总览（统计页）。账本落在宿主家里（`$DSH_HOME/mobile-stats.json`），与会话日志
   // 无关：归档只是挪位置，清理删的是日志，历史数字都还在 —— 见 mobile/stats-ledger.cjs。
@@ -500,6 +581,9 @@ function registerMobileRoutes(deps) {
   route('/api/mobile/v1/inbox/clear', inboxClean.handleInboxClear)
   // 自动清理开关：默认关，打开后宿主每次启动顺手清一次（面板那颗按钮不受它管）。
   route('/api/mobile/v1/inbox/auto', inboxClean.handleInboxAuto)
+  // 过程播报开关（GET 读、POST 写 `{enabled}`）。缺省关；关着时宿主一个钩子都不动手。
+  // 与「自动清理」同一个位置：都是这台电脑自己的偏好，跟会话无关。
+  route('/api/mobile/v1/narration', narration.handleNarration)
 
   // 电脑上的 DSH 网页版（见 mobile/host-web.js）：App 的内置浏览器要直接用它，而那个页面
   // 只绑在宿主自己的环回端口上、且要一枚一次性登录令牌。令牌是凭据，所以这条**必须**
@@ -521,7 +605,59 @@ function registerMobileRoutes(deps) {
   //
   // 路径字面量必须与 App 侧 apiPaths.ts 的 preview 一致：test/mobile-routes.test.cjs
   // 就是拿这张表反向核对 App 常量表的。
+  // 远程终端（见 mobile/terminal.js）：白名单 CLI + 受管伪终端。
+  //
+  // 四条普通路由里只有 `agents` / `sessions` 是读，另两条是起与收；真正的字节流走下面的
+  // 升级路由。`terminalService` 从装配层来（会话表要在插件重载时被一起收掉，不能是模块单例）。
+  if (terminalService) {
+    route('/api/mobile/v1/terminal/agents', terminalService.handleAgents)
+    route('/api/mobile/v1/terminal/session', terminalService.handleCreate)
+    route('/api/mobile/v1/terminal/close', terminalService.handleClose)
+    route('/api/mobile/v1/terminal/sessions', terminalService.handleSessions)
+  }
   registerUpgradeRoute({ path: '/api/mobile/v1/preview', handler: preview.handleUpgrade })
+  // 终端字节流：与预览同一套升级机制（中转与局域网代理都不看路径）。
+  if (terminalService) registerUpgradeRoute({ path: '/api/mobile/v1/terminal/stream', handler: terminalService.handleUpgrade })
+
+  // CLI 对话（见 mobile/cli/service.js）：同一批白名单 CLI，但走 ACP —— 手机拿到的是结构化
+  // 的消息 / 工具调用 / 审批请求，所以能像正常对话一样渲染，而不是一块终端屏幕。
+  //
+  // 与终端那组并列存在，不是替换：终端留着给「我要看原始 TUI」的那一档。`cliService` 同样
+  // 从装配层来（会话表要在插件重载时被一起收掉，不能是模块单例）。
+  if (cliService) {
+    route('/api/mobile/v1/cli/agents', cliService.handleAgents)
+    route('/api/mobile/v1/cli/session', cliService.handleCreate)
+    route('/api/mobile/v1/cli/close', cliService.handleClose)
+    route('/api/mobile/v1/cli/sessions', cliService.handleSessions)
+    // 读一份全貌 + 三个写动作。WS 是快的那条路；隧道上偶尔「握手成了、帧进不来」，这一组
+    // 是它的兜底（页面轮询 detail、发送走 HTTP），两边共用服务层同一份实现。
+    route('/api/mobile/v1/cli/detail', cliService.handleDetail)
+    route('/api/mobile/v1/cli/prompt', cliService.handlePrompt)
+    route('/api/mobile/v1/cli/permission', cliService.handlePermission)
+    route('/api/mobile/v1/cli/cancel', cliService.handleCancel)
+    route('/api/mobile/v1/cli/config', cliService.handleConfig)
+    // 「这个 CLI 以后按哪一套跑」：配置页读它、也写它。与上一条的区别是**不动正在跑的会话**，
+    // 只决定下一次开局（ACP 的配置是会话级的，所以要提前存一份，见 cli/config-prefs.js）。
+    route('/api/mobile/v1/cli/prefs', cliService.handlePrefs)
+    registerUpgradeRoute({ path: '/api/mobile/v1/cli/stream', handler: cliService.handleUpgrade })
+  }
+
+  // 「让 AI 操作手机」（见 mobile/phone/）：三条状态路由与一条动作字节流的升级口。
+  //
+  // 状态那三条都只读账本或做收尾，**没有一条能往手机上发动作**。动作只有模型在会话里通过
+  // `phone_*` 工具发得出去，而且只能是那一小张固定动作表里的 —— 这里刻意不开口子，
+  // `test/mobile-routes.test.cjs` 也钉着这张表里不许出现 shell / exec 一类路径。
+  if (phoneService) {
+    const phoneRoutes = createPhoneRoutes({
+      getService: () => phoneService,
+      credentials: phoneService.credentials,
+      instanceId: phoneService.instanceId,
+    })
+    route('/api/mobile/v1/phone/status', phoneRoutes.status)
+    route('/api/mobile/v1/phone/devices', phoneRoutes.devices)
+    route('/api/mobile/v1/phone/unbind', phoneRoutes.unbind)
+    registerUpgradeRoute({ path: '/api/mobile/v1/phone/control', handler: phoneService.handleUpgrade })
+  }
 }
 
-module.exports = { registerMobileRoutes };
+module.exports = { registerMobileRoutes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.5.17",
+  "version": "0.5.19",
   "description": "Mobile API (/api/mobile/v1) and relay client for the DSH mobile app — desktop profile build (dsh 0.2.x, peers resolved by the host)",
   "license": "MIT",
   "icon": "./icon.png",
@@ -54,6 +54,7 @@
     "release:check": "node scripts/preflight-release.mjs"
   },
   "dependencies": {
+    "@agentclientprotocol/sdk": "2.4.0",
     "qrcode": "1.5.4",
     "ws": "8.18.0"
   },