dsh-mobile-plugin 0.3.1 → 0.4.0

package/config/agent-presets/standard/agent.cordis.yml

@@ -166,9 +166,10 @@
   # the `user-questions/request` hook (0.2.x shape) and answers it — only the
   # tool row was missing.
   #
-  # The package must be pinned to the runtime's own generation (0.2.0-rc.2):
-  # its peerDependencies track the runtime release exactly, and the loader
-  # disables the whole row — rather than degrade — when one does not match.
+  # 这里的 `name` 是**占位**：无头宿主启动时会把同代那一份的入口绝对路径写进
+  # 一份副本（`host.js` 的 syncPresetDir），挂载的是运行时自己的那一代。这个包的
+  # peerDependencies 逐版本紧咬，对不上时 `dsh-app-boot` 会**整行禁用**（不是降级），
+  # 而钉死哪一代都不可能覆盖每台机器上装的 DSH —— 判据交给运行期，别在这里写死。
   - id: tool-ask-user
     name: '@deepseek-ai/dsh-tool-ask-user'
   # `present` 是模型**显式声明交付文件**的那一行。桌面 `standard` preset 里一直有它
@@ -180,7 +181,8 @@
   # `deliverables/presented` 事件追加进会话日志。卡片该不该出现，由**模型叫不叫这个工具**
   # 决定，不由「有没有文件被改」决定 —— 这是桌面的口径。
   #
-  # 版本必须钉在运行时那一代（当前 0.2.1-rc.2）：它的 peerDependencies 逐版本紧咬，
-  # 对不上时 `dsh-app-boot` 会**整行禁用**（不是降级），现象是模型说「没有这个工具」。
+  # 版本同样由运行期决定（见上面 tool-ask-user 那段）：0.2.1 的 `present` 要
+  # `dsh-agent` 恰好是同一代，对不上时 `dsh-app-boot` 会整行禁用，模型只会说
+  # 「没有这个工具」。`name` 是占位，宿主启动时换成本次运行时的入口。
   - id: tool-present
     name: '@deepseek-ai/dsh-tool-present'

package/host.js

@@ -14,21 +14,26 @@
  * package's `cordis.patch.yml`.
  */
 
-import { existsSync, writeFileSync } from 'node:fs'
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { provideCmdline } from '@deepseek-ai/dsh-cmdline'
 import { installProcessGuard } from './lib/host-guard.cjs'
+import { DIRECTORY_PICKER_ROW, TOOL_ROWS, pinInsertedRows, syncPresetDir } from './lib/host-compat.cjs'
 import { dropBareNameSelfMounts } from './lib/host-patches.cjs'
 import {
   assertEntriesActivated,
   boot,
+  evaluatePluginCompatibility,
+  getDshRuntimeVersion,
   initProfile,
   installFailLoud,
   loadLayeredEnv,
   loadOverlayPatches,
   loadProfile,
   PROFILE_TEMPLATES,
+  readProfileCompatibility,
   resolveProfileDir,
 } from '@deepseek-ai/dsh-app-boot'
 
@@ -90,6 +95,82 @@ try {
   const rootConfig = join(profileDir, 'cordis.root.yml')
   writeFileSync(rootConfig, '[]\n')
 
+  /**
+   * 官方工具行跟着**运行时**换代，本包不再自带一份钉死的副本。
+   *
+   * 这三个包（提问工具 / 交付文件工具 / 目录浏览后端）互相之间用精确版本咬死，
+   * 而装载前的预检对不上的处理不是降级、是**整行禁用** —— 现象是手机上
+   * 「模型说没有这个工具」「添加工作区列不出目录」，桌面上却一切正常。钉在哪一代
+   * 都不对：官方每抬一次代，钉死的副本就失效一次，而一台机器上装的 DSH 是哪一代
+   * 我们发版时并不知道。
+   *
+   * 判据直接用 `dsh-app-boot` 自己导出的 `evaluatePluginCompatibility`，与装载前那次
+   * 预检**同源**：自己写一套 semver 只会让两边分叉，这里放过的行照样被预检禁掉。
+   * 先问运行时那棵树，再问本包自带的那份，都不行就返回 null —— 那一行保持原样，
+   * 交给官方预检去禁用并打印原因，等于退回旧行为，不会更差。
+   */
+  let runtimeRequire = null
+  try {
+    runtimeRequire = createRequire(new URL(import.meta.resolve('@deepseek-ai/dsh-app-boot')))
+  } catch (error) {
+    // 定位不到不是致命：下面每一行都会退回本包自带的那份，最差回归旧行为。
+    process.stderr.write(`${BIN_NAME}: 定位不到运行时那棵依赖树（${error?.message || error}），这一轮只按本包自带的解析\n`)
+  }
+  const bundledRequire = createRequire(import.meta.url)
+  const runtimeVersion = getDshRuntimeVersion()
+  let exemptions = {}
+  try {
+    exemptions = readProfileCompatibility(profileDir).exemptions
+  } catch (error) {
+    process.stderr.write(`${BIN_NAME}: 读不了 profile 的兼容性豁免文件，这一轮按无豁免处理：${error?.message || error}\n`)
+  }
+
+  const resolveGeneration = (scope, require, name) => {
+    if (!require) return null
+    try {
+      const manifestPath = require.resolve(`${name}/package.json`)
+      const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
+      const issue = evaluatePluginCompatibility(manifest, exemptions, runtimeVersion)
+      if (issue !== undefined && !issue.exempted) return null
+      return { scope, name, version: manifest.version, entry: require.resolve(name) }
+    } catch {
+      return null
+    }
+  }
+
+  const pinnedRows = new Map()
+  for (const { id, name } of [...TOOL_ROWS, DIRECTORY_PICKER_ROW]) {
+    const hit = resolveGeneration('运行时', runtimeRequire, name)
+      ?? resolveGeneration('本包自带', bundledRequire, name)
+    if (hit) pinnedRows.set(id, hit)
+    process.stderr.write(
+      hit
+        ? `${BIN_NAME}: ${name} → 用${hit.scope}的 ${hit.version}\n`
+        : `${BIN_NAME}: ${name} 没解析到与 dsh ${runtimeVersion} 同代的一份，这一行维持原样（装载预检会说明它为什么被禁用）\n`,
+    )
+  }
+
+  // 预设里的两行默认按裸名写：Loader 从它自己的位置解析，命中哪一份不由我们决定。
+  // 解析到了同代的那份就改写一份副本给它，路径写死成那一份的入口。
+  const presetRoots = {}
+  for (const { id } of TOOL_ROWS) {
+    const hit = pinnedRows.get(id)
+    if (hit) presetRoots[id] = hit.entry
+  }
+  const presetDir = TOOL_ROWS.some(({ id }) => presetRoots[id] !== undefined)
+    ? syncPresetDir(
+      join(PACKAGE_DIR, 'config', 'agent-presets'),
+      join(profileDir, '.mobile-agent-presets'),
+      presetRoots,
+    )
+    : join(PACKAGE_DIR, 'config', 'agent-presets')
+
+  // patch 层里的 insert 行按包名写（`cordis.mobile-host.yml` 的目录浏览器），
+  // 同样换成解析到的那份入口。只改 insert：patch 里其它形态的 name 是断言，
+  // 改它会让整条 patch 被静默跳过。
+  const entryByName = {}
+  for (const hit of pinnedRows.values()) entryByName[hit.name] = hit.entry
+
   const patches = [
     ...profile.layers.flatMap(layer => layer.patches),
     ...profile.patches,
@@ -123,16 +204,18 @@ try {
       id: 'agent-presets',
       config: {
         default: 'standard',
-        roots: [{ path: join(PACKAGE_DIR, 'config', 'agent-presets'), trust: 'system' }],
+        roots: [{ path: presetDir, trust: 'system' }],
       },
     },
   ]
 
+  const pinnedPatches = pinInsertedRows(patches, entryByName)
+
   process.stderr.write(
     `${BIN_NAME}: 挂载方式 = ${selfInstalled ? `profile 里装的那份（${installedDir}，带稳定外壳，面板里能自更新）` : '源码树直挂（无外壳，更新靠同步源码 + 重启宿主）'}\n`,
   )
 
-  const ctx = await boot(BIN_NAME, rootConfig, patches, (hostCtx) => {
+  const ctx = await boot(BIN_NAME, rootConfig, pinnedPatches, (hostCtx) => {
     // A headless mobile host has no command line: nothing passes flags and
     // nobody is watching a help screen. The web startup plugin still waits on
     // `cmdlineArgs` before it will provide `webStartup`, so the service must

package/lib/host-compat.cjs

@@ -0,0 +1,132 @@
+'use strict'
+
+/**
+ * 让「官方工具行」跟着运行时换代，而不是跟着本包发版那一刻。
+ *
+ * 这三个包（提问工具、交付文件工具、目录浏览后端）有个共同点：它们互相之间用
+ * **精确版本**咬死（`dsh-tool-ask-user@0.2.1-rc.2` 要求 `dsh-agent` 恰好是
+ * `0.2.1-rc.2`），而 `dsh-app-boot` 在装载前会把每一个要挂的行拿出来跟运行时对
+ * 一遍——对不上不是降级，是**整行禁用**，只留一行
+ * `disabling profile plugin row "tool-ask-user"` 的启动日志。现象就是手机上
+ * 「模型说没有这个工具」「添加工作区列不出目录」，而桌面上一切正常。
+ *
+ * 所以本包不再自带一份钉死的副本：
+ *
+ *  - `host.js` 启动时先问运行时那棵树要**同代**的那一份（判据直接用
+ *    `dsh-app-boot` 自己导出的兼容性判定，跟装载前那次检查完全同源）；
+ *  - 拿到了就把预设行与该 patch 行的 `name` 换成那份的**入口绝对路径**，
+ *    Loader 按路径装载，绕开「从谁的位置按裸名解析」这个坑；
+ *  - 拿不到就保持原样，让官方那次检查去禁用并打印原因——退回当前行为，不会更差。
+ *
+ * 这个文件只放纯函数（复制目录、改文本、改 patch 行），不 import 任何 ESM 包：
+ * `host.js` 一 import 就 `boot()` 整个宿主，测试碰不得。
+ */
+
+const fs = require('node:fs')
+const path = require('node:path')
+
+/**
+ * 预设里那两行的 id 与包名。
+ *
+ * 两个都要，因为它们是**同一类**：都是官方工具、都精确咬版本、都不在 `dsh-web-app`
+ * 的预设里（手机这份预设是本包自带的）。漏掉任何一个，对应能力的消失方式都一样安静。
+ */
+const TOOL_ROWS = Object.freeze([
+  Object.freeze({ id: 'tool-ask-user', name: '@deepseek-ai/dsh-tool-ask-user' }),
+  Object.freeze({ id: 'tool-present', name: '@deepseek-ai/dsh-tool-present' }),
+])
+
+/** 无头宿主里被钉成 browse 的目录选择后端；同样精确咬版本。 */
+const DIRECTORY_PICKER_ROW = Object.freeze({
+  id: 'directory-picker-browse',
+  name: '@deepseek-ai/dsh-host-directory-picker-browse',
+})
+
+const ROW_ID = /^(\s*)-\s+id:\s*(\S+)\s*$/
+const ROW_NAME = /^(\s+)name:\s*'([^']+)'\s*$/
+
+/**
+ * 把 `- id: <id>` 紧跟着的那个 `name:` 换成给定值。
+ *
+ * 逐行扫而不是解析 YAML 再序列化：这份预设带着大量解释性注释，解析一遍再写回去
+ * 会把注释和空行全洗掉，而那些注释正是下一个人理解这几行为什么存在的唯一线索。
+ * 只认「上一行是目标 id」的 name，所以同一个包名在别处出现（注释、其它行）不会被误伤。
+ *
+ * @param {string} source 预设文件内容
+ * @param {Record<string, string>} targets 行 id → 新的 name（入口绝对路径）
+ * @returns {{ text: string, changed: string[] }}
+ */
+function rewriteToolNames(source, targets) {
+  const changed = []
+  let currentId = null
+  const text = source
+    .split('\n')
+    .map(line => {
+      const id = ROW_ID.exec(line)
+      if (id) {
+        currentId = id[2]
+        return line
+      }
+      if (currentId === null) return line
+      const name = ROW_NAME.exec(line)
+      if (!name || targets[currentId] === undefined) return line
+      if (name[2] === targets[currentId]) return line
+      changed.push(currentId)
+      // 单引号是 YAML 的转义形式：值里的 ' 要写成 ''。
+      return `${name[1]}name: '${targets[currentId].replace(/'/g, "''")}'`
+    })
+    .join('\n')
+  return { text, changed }
+}
+
+/**
+ * 把预设目录同步一份到 `outDir`，并把目标行换成本次运行时的入口。
+ *
+ * 每次启动都重写：两份 yml 加起来不到 8KB，而「只在内容变化时写」需要记住上一次
+ * 解析出来的运行时入口，多一份状态就多一处能不一致的地方。写完才用，不写就不存在。
+ *
+ * @param {string} presetDir 包内 `config/agent-presets`
+ * @param {string} outDir 宿主可写的目标目录
+ * @param {Record<string, string>} targets 行 id → 入口绝对路径
+ * @returns {string} 真正该交给 `agent-presets` roots 的目录
+ */
+function syncPresetDir(presetDir, outDir, targets) {
+  fs.rmSync(outDir, { recursive: true, force: true })
+  fs.cpSync(presetDir, outDir, { recursive: true })
+  if (Object.keys(targets).length === 0) return outDir
+  for (const entry of fs.readdirSync(outDir, { recursive: true, withFileTypes: true })) {
+    if (!entry.isFile() || !entry.name.endsWith('.yml')) continue
+    const file = path.join(entry.parentPath ?? entry.path, entry.name)
+    const { text, changed } = rewriteToolNames(fs.readFileSync(file, 'utf8'), targets)
+    if (changed.length > 0) fs.writeFileSync(file, text)
+  }
+  return outDir
+}
+
+/**
+ * 把 patch 层里命中目标的 `name` 换成入口绝对路径。
+ *
+ * 只改 `insert` 里的行：patch 里其它形态的 `name` 是**断言**（与原名同才会应用），
+ * 改它等于让整条 patch 被静默跳过。改名只对「新插一行」有意义。
+ *
+ * @param {Array} patches 已加载的 patch 层
+ * @param {Record<string, string>} targets 包名 → 入口绝对路径
+ * @returns {Array} 新数组，不改原对象
+ */
+function pinInsertedRows(patches, targets) {
+  const swap = (row) => {
+    if (!row || typeof row !== 'object' || Array.isArray(row)) return row
+    const next = targets[row.name] === undefined ? row : { ...row, name: targets[row.name] }
+    if (Array.isArray(next.insert)) return { ...next, insert: next.insert.map(swap) }
+    return next
+  }
+  return patches.map(swap)
+}
+
+module.exports = {
+  TOOL_ROWS,
+  DIRECTORY_PICKER_ROW,
+  rewriteToolNames,
+  syncPresetDir,
+  pinInsertedRows,
+}

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.3.1",
-  "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)",
+  "version": "0.4.0",
+  "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",
+  "engines": {
+    "dsh": ">=0.2.0 <0.3.0"
+  },
   "type": "module",
   "main": "lib/index.js",
   "bin": {
@@ -46,8 +49,6 @@
     "release:check": "node scripts/preflight-release.mjs"
   },
   "dependencies": {
-    "@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"
   },
@@ -73,7 +74,9 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-host-directory-picker-browse": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-host-directory-picker-browse": "^0.2.1-rc.3",
+    "@deepseek-ai/dsh-tool-ask-user": "^0.2.1-rc.3",
+    "@deepseek-ai/dsh-tool-present": "^0.2.1-rc.3",
     "yaml": "2.9.1"
   }
 }