dsh-mobile-plugin 0.1.69 → 0.1.70

package/README.md

@@ -14,6 +14,9 @@ Electron 运行时**，`node host.js` 即可独立运行。
 
 本仓库是插件的**公开发布仓库**，仓库根就是包根：别人从这里读代码，也从这里核对这份代码的说法。
 
+隐私政策（App Store / Google Play 上架用的那份，描述手机 App 会经手哪些数据）：[PRIVACY.md](PRIVACY.md)。
+技术支持 / 常见问题（上架时填的「技术支持网址」）：[SUPPORT.md](SUPPORT.md)。
+
 开发和 App 客户端、中转服务器放在一起进行（一个私有 monorepo），所以这里的提交历史从拆分那天开始，
 不是项目历史 —— 每次发版，把同一次改动一起推到这里。
 
@@ -83,9 +86,18 @@ DSH_HOME=/opt/dsh-mobile/.dsh DSH_MOBILE_PROFILE=mobile node host.js
 
 本包有两条完全不同的安装路径，别混用。
 
-**服务器 / 无头部署：源码同步。** 直接把仓库目录 rsync 到 `/opt/dsh-mobile/`，依赖只在首次装
-或 `package.json` 变了时重装，然后 `systemctl restart dsh-mobile-host`。这条路的版本号不参与
-任何判断，`package.json` 里的 version 写成什么都不会影响宿主行为。
+**服务器 / 无头部署：启动器 rsync + 插件本体走 npm。**（2026-10-11 改）那一台是**两半**，别混着看：
+
+- **启动器**：`host.js`、两层 patch、`config/`、内嵌的凭据包。把仓库目录 rsync 到 `/opt/dsh-mobile/`，
+  然后 `systemctl restart dsh-mobile-host` —— 它只负责把宿主那棵树拼起来。
+- **插件本体**：装在 profile 里，用 pnpm 从 npm 装：
+  `cd <DSH_HOME>/profiles/<profile> && pnpm add dsh-mobile-plugin@<版本>`。宿主按**绝对路径**挂那份的
+  `lib/index.js`（**稳定外壳**），所以这台面板里也有「检查 / 立即更新」，换代**不用重启宿主**。
+  profile 的 `autoInstallPeers: false` 是刻意的：peer 依赖（`@deepseek-ai/*`）由宿主自己的依赖树供，
+  两边必须解析到**同一份 realpath**，否则会出现两份 cordis（见 `lib/shell/manager.js` 的文件头）。
+- 挂哪一份由 `host.js` 现场判断（`profile` 里有没有这个包，不看环境变量）：装了挂那份外壳；
+  没装就退回**源码树直挂**（没有外壳，面板里更新不了，只能同步源码 + 重启宿主）。两种现场都会在
+  启动日志里打一行「挂载方式 = …」，`npm run test:plugin:server` 会核对它。
 
 **桌面端：从 npm 装，更新交给 DSH 的插件市场。**（2026-10 改的：此前是本包自带的 OTA +
 「稳定外壳 + 可热替换的代」，那套已经删掉。）

package/host.js

@@ -14,7 +14,7 @@
  * package's `cordis.patch.yml`.
  */
 
-import { writeFileSync } from 'node:fs'
+import { existsSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { provideCmdline } from '@deepseek-ai/dsh-cmdline'
@@ -59,6 +59,32 @@ try {
   initProfile(profileDir, PROFILE_TEMPLATES.web)
   const profile = loadProfile(BIN_NAME, PROFILE_NAME, INSTALL_ANCHOR, home, { userLayer: true })
 
+  /**
+   * 本插件是**装在这个 profile 里**的，还是「源码树直接跑」的？
+   *
+   * 这两种现场的挂载方式不一样，而差别全在「挂哪一份入口」上（2026-10-11 起两条都留着）：
+   *
+   *  - **装在 profile 里**（桌面端；服务器那台改成 `pnpm 装进 profile` 之后也是）→ 挂
+   *    `<profile>/node_modules/dsh-mobile-plugin/lib/index.js`，也就是**稳定外壳**：
+   *    查更新、装新版、就地换代那一套全在它手里，所以面板上才有「检查 / 立即更新」。
+   *  - **源码树直接跑**（老的无头部署、开发时直接 `node host.js`）→ 插件**就是** Loader 自己
+   *    正跑的那个包，没有任何人把它放进 `node_modules`，于是这一支挂随包发布的
+   *    `lib/impl.js`（真正的实现）。代价是**没有外壳** → 那台的面板里更新不了，只能同步
+   *    源码 + 重启宿主。
+   *
+   * **两处都走「绝对路径」而不是包名**：`cordis.patch.yml` 里那行按包名挂载是给桌面端用的，
+   * 无头宿主这边解析不到 —— loader 是从**它自己所在的位置**解析包名的（实测报错原文：
+   * `Cannot find package 'dsh-mobile-plugin' imported from <…>/@deepseek-ai/cordis-plugin-loader/lib/index.js`），
+   * 而它在宿主自己的依赖树里，profile 里装的那份它根本看不见。而 loader 对解析失败不是留一条
+   * 警告，是**整棵插件树加载失败**（服务器那台当年就是这么完全起不来的）。所以那行在无头宿主
+   * 里一律摘掉，由这里按绝对路径插一行 —— 装没装 profile 决定的是**挂哪一份**，不是挂不挂。
+   *
+   * 判据取「profile 里有没有这个包」，不看环境变量、不看目录名：装没装是事实，改不了口径。
+   */
+  const installedDir = join(profileDir, 'node_modules', BIN_NAME)
+  const selfInstalled = existsSync(join(installedDir, 'package.json'))
+  const selfPatches = loadOverlayPatches(BIN_NAME, join(PACKAGE_DIR, 'cordis.patch.yml'))
+
   // An empty entry list is the composition root: upstream fills the tree from
   // the profile's bundle layers; every plugin arrives via a patch layer.
   const rootConfig = join(profileDir, 'cordis.root.yml')
@@ -67,15 +93,24 @@ try {
   const patches = [
     ...profile.layers.flatMap(layer => layer.patches),
     ...profile.patches,
-    ...dropBareNameSelfMounts(loadOverlayPatches(BIN_NAME, join(PACKAGE_DIR, 'cordis.patch.yml')), BIN_NAME),
+    ...dropBareNameSelfMounts(selfPatches, BIN_NAME),
     // 宿主专属的层（不开浏览器、目录选择器钉成 browse）。刻意不放进
     // cordis.patch.yml：那一层桌面 GUI 也会加载，而桌面操作者就坐在机器前，
     // 不需要把原生目录选择器换成远程用的 browse 交互。
     ...loadOverlayPatches(BIN_NAME, join(PACKAGE_DIR, 'cordis.mobile-host.yml')),
     // The mobile API is this very package. The Loader imports an entry by bare
-    // name from its own location, and `dsh-mobile-plugin` is not installed
-    // there, so the row names the plugin's entry module by absolute path.
-    { insert: [{ id: 'mobile-api', name: join(PACKAGE_DIR, 'lib/impl.js'), config: { enabled: true } }] },
+    // name from its own location, and that location has no `dsh-mobile-plugin`,
+    // so the row names the entry module by absolute path — profile 里装了就挂
+    // 那份的外壳，没装就挂源码树自己的实现（见上）。
+    {
+      insert: [{
+        id: 'mobile-api',
+        name: selfInstalled
+          ? join(installedDir, 'lib', 'index.js')
+          : join(PACKAGE_DIR, 'lib/impl.js'),
+        config: { enabled: true },
+      }],
+    },
     // The DSH Web bundle disables every agent-plane row (shell, files, search,
     // skills, goals, planning, compaction, delegation) and lets each session
     // mount a preset instead — but it leaves the roster's shipped root to
@@ -93,6 +128,10 @@ try {
     },
   ]
 
+  process.stderr.write(
+    `${BIN_NAME}: 挂载方式 = ${selfInstalled ? `profile 里装的那份（${installedDir}，带稳定外壳，面板里能自更新）` : '源码树直挂（无外壳，更新靠同步源码 + 重启宿主）'}\n`,
+  )
+
   const ctx = await boot(BIN_NAME, rootConfig, patches, (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

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

@@ -10,7 +10,35 @@
  * 按 frame.payload 里的 type 分发，形状对上了它们一行都不用改。
  */
 
-const { openStream, warn } = require('./transport.js');
+const { gatewayOf, openStream, warn } = require('./transport.js');
+
+const warnedUnavailableContexts = new WeakSet();
+
+/**
+ * Keep the compatibility SSE alive when a host has no streaming gateway. The
+ * device stream also carries plugin-owned signals and heartbeats, so ending it
+ * here would cause reconnect churn and disable that independent data path.
+ */
+async function* unavailableHostStream(ctx, signal) {
+  const gateway = gatewayOf(ctx);
+  if (gateway && typeof gateway.stream === 'function') return false;
+
+  if (ctx && typeof ctx === 'object' && !warnedUnavailableContexts.has(ctx)) {
+    warnedUnavailableContexts.add(ctx);
+    warn(ctx, '宿主未提供 typertGateway.stream，跳过宿主事件并保持设备流空闲');
+  }
+
+  if (!signal || signal.aborted) return true;
+  await new Promise((resolve) => {
+    const finish = () => {
+      signal.removeEventListener('abort', finish);
+      resolve();
+    };
+    signal.addEventListener('abort', finish, { once: true });
+    if (signal.aborted) finish();
+  });
+  return true;
+}
 
 // ── 事件合成 ──────────────────────────────────────────────────────────────
 
@@ -168,6 +196,7 @@ async function* deviceFrames(ctx, signal) {
 function muxFrames(ctx, request, signal) {
   const sessionId = sessionHint(request);
   return (async function* run() {
+    if (yield* unavailableHostStream(ctx, signal)) return;
     if (!sessionId) {
       yield* deviceFrames(ctx, signal);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.1.69",
+  "version": "0.1.70",
   "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",