@wenbin_wb/dsh-bridge 2.11.2 → 2.12.0

package/client/locales.mjs

@@ -0,0 +1,174 @@
+// dsh-bridge 客户端国际化：跟随 DSH 主体语言（LocaleFace）。
+//
+// DSH 0.1.7 的 client 提供 locale 服务（`dsh-client-locale` 的 LocaleFace）：
+//   - ctx.locale.register(namespace, { zh: {...}, en: {...} }) 注册词典；
+//   - ctx.locale.translate(map) 按当前语言取译文（纯字符串原样返回、map 走词典，
+//     未声明语言回退到 fallback 链，最终到 en）；
+//   - ctx.locale.subscribe(fn) 在语言切换时通知。
+// 插件把 "locale" 加进 inject 后即可拿到 ctx.locale，从而自动跟随 DSH 主体语言
+// （含用户手动切换、浏览器语言回退、<html lang> 同步），无需自建语言开关。
+//
+// 本文件只收「移动端自绘 UI 的用户可见文案」（A 类）：顶栏按钮、工作区选择器、
+// 远程访问面板、浏览器输入区提示等。内部字符串（DOM/CSS 类名匹配、注释、日志）
+// 保持中文原样——它们不是 UI 文案，翻译会破坏匹配（见 readHostSessionTitle 教训）。
+
+export const LOCALE_NAMESPACE = '@wenbin_wb/dsh-bridge';
+
+/** 词典：每个命名空间至少要有 en（最终 fallback）；zh 为默认语言。 */
+export const zh = {
+  // 移动端顶栏
+  'menu.open': '打开菜单',
+  'menu.newSession': '新建会话',
+  'title.fallback': '新会话',
+  // 移动端输入区
+  'composer.placeholder': '✍️ 点击输入消息…',
+  'composer.expand': '展开输入框',
+  'composer.collapse': '收起输入框，最大化对话阅读区',
+  'panel.backToChat': '返回对话',
+  // 移动端设置面板 / 抽屉（dsh-bridge 自绘部分）
+  'workspace.choose': '选择电脑工作区',
+  'workspace.reading': '正在读取目录内容…',
+  'workspace.currentDir': '当前目录:',
+  'workspace.registeredHint': '已注册工作区 (${count} 个，点击直接切换)：',
+  'workspace.enterHint': '点击进入文件夹，或点击「+ 选为工作区」直接添加并切换',
+  'workspace.unlockHint': '远程访问时浏览/添加工作区需输入后台管理密码解锁（与访问密码不同）。',
+  'workspace.chooseFolder': '选择工作区',
+  'workspace.addFolder': '添加',
+  'workspace.refresh': '刷新目录',
+  'workspace.back': '返回上一级',
+  'workspace.filter': '过滤子文件夹…',
+  'workspace.more': '还有更多',
+  'workspace.addSubfolder': '直接添加此子文件夹为工作区并进入',
+  'workspace.onlyAdmin': '仅限本机管理',
+  'workspace.isCurrent': '当前主入口',
+  'workspace.isFallback': '主入口',
+  // 远程访问面板
+  'access.copyLink': '复制链接',
+  'access.copied': '✓ 已复制',
+  'access.hideQr': '隐藏二维码',
+  'access.showQr': '显示二维码',
+  'access.privateEnv': '请在私密环境下使用',
+  'access.switching': '切换中…',
+  'access.publicEntry': '公网访问入口',
+  'access.copy': '复制',
+  'access.stopReconnect': '停止重连',
+  'access.close': '关闭',
+  'access.connecting': '连接中…',
+  'access.downloading': '下载中…',
+  'access.enable': '开启公网隧道',
+  'access.scanHint': '请在私密环境下扫码使用',
+  'access.autoStart': '随 DSH 启动自动开启',
+  'access.tunnelConfig': '隧道配置',
+  'access.expand': '展开 ▾',
+  'access.collapse': '收起 ▴',
+  'access.saveError': '保存配置失败',
+  'access.serverConfig': '隧道服务器配置',
+  'access.saving': '保存中…',
+  'access.saved': '✓ 已保存',
+  'access.saveConfig': '保存配置',
+  'access.clear': '清除',
+  'access.externalTunnel': '外部已部署隧道',
+  'access.saveFixed': '保存固定域名配置',
+  'access.updateFailed': '更新失败',
+  'access.securityHint': '设置外部访客访问密码',
+  'access.goSetup': '去开启 ➔',
+  'access.gotoSettings': '设置 ➔',
+  'access.tutorial': '查看自建隧道服务器搭建教程',
+};
+
+export const en = {
+  'menu.open': 'Open menu',
+  'menu.newSession': 'New session',
+  'title.fallback': 'New Session',
+  'composer.placeholder': '✍️ Tap to type a message…',
+  'composer.expand': 'Expand input',
+  'composer.collapse': 'Collapse input to maximize chat view',
+  'panel.backToChat': 'Back to chat',
+  'workspace.choose': 'Choose a workspace',
+  'workspace.reading': 'Reading directory…',
+  'workspace.currentDir': 'Current directory:',
+  'workspace.registeredHint': 'Registered workspaces (${count}, click to switch):',
+  'workspace.enterHint': 'Enter a folder, or tap “+ Select as workspace” to add & switch',
+  'workspace.unlockHint': 'Browsing/adding workspaces remotely requires the admin password to unlock (different from the access password).',
+  'workspace.chooseFolder': 'Choose workspace',
+  'workspace.addFolder': 'Add',
+  'workspace.refresh': 'Refresh',
+  'workspace.back': 'Back',
+  'workspace.filter': 'Filter subfolders…',
+  'workspace.more': 'More',
+  'workspace.addSubfolder': 'Add this subfolder as a workspace and enter',
+  'workspace.onlyAdmin': 'Local admin only',
+  'workspace.isCurrent': 'Current entry',
+  'workspace.isFallback': 'Main entry',
+  'access.copyLink': 'Copy link',
+  'access.copied': '✓ Copied',
+  'access.hideQr': 'Hide QR',
+  'access.showQr': 'Show QR',
+  'access.privateEnv': 'Use in a private environment',
+  'access.switching': 'Switching…',
+  'access.publicEntry': 'Public access entry',
+  'access.copy': 'Copy',
+  'access.stopReconnect': 'Stop reconnecting',
+  'access.close': 'Close',
+  'access.connecting': 'Connecting…',
+  'access.downloading': 'Downloading…',
+  'access.enable': 'Enable public tunnel',
+  'access.scanHint': 'Scan in a private environment',
+  'access.autoStart': 'Start automatically with DSH',
+  'access.tunnelConfig': 'Tunnel configuration',
+  'access.expand': 'Expand ▾',
+  'access.collapse': 'Collapse ▴',
+  'access.saveError': 'Failed to save configuration',
+  'access.serverConfig': 'Tunnel server configuration',
+  'access.saving': 'Saving…',
+  'access.saved': '✓ Saved',
+  'access.saveConfig': 'Save configuration',
+  'access.clear': 'Clear',
+  'access.externalTunnel': 'External tunnel',
+  'access.saveFixed': 'Save fixed-domain configuration',
+  'access.updateFailed': 'Update failed',
+  'access.securityHint': 'Set an external visitor access password',
+  'access.goSetup': 'Set up ➔',
+  'access.gotoSettings': 'Settings ➔',
+  'access.tutorial': 'View the self-hosted tunnel server tutorial',
+};
+
+/**
+ * 构造一个翻译函数：优先用宿主的 ctx.locale.translate（跟随主体语言），
+ * 宿主不支持时退化为「取当前语言词典（en/zh）+ 互为兜底」。
+ * @param {object} ctx - Cordis 客户端上下文（含可选 locale 服务）
+ * @returns {{ t: Function, active: () => string, subscribe: Function }}
+ */
+/**
+ * 构造翻译器：读 DSH 主体语言（`<html lang>`，宿主 LocaleFace 实时同步），
+ * 中英词典按当前语言选词。`ctx.locale` 只作可选的词典注册（拿到则注册，
+ * 拿不到或未声明 inject 也不抛错、不影响翻译——动态插件无法把 locale 加进
+ * inject，宿主会对未声明服务抛 denyRead，详见 index.js 注释）。
+ * @param {object} ctx - Cordis 客户端上下文（可选）
+ * @returns {{ t: Function, active: () => string }}
+ */
+export function createTranslator(ctx) {
+  // 当前语言：宿主把 active 语言同步到 <html lang>（zh→zh-CN，其余原样）。
+  // 读它即可跟随 DSH 主体语言且无需声明 locale 服务。
+  const active = () => {
+    const lang = (typeof document !== 'undefined' ? document.documentElement.getAttribute('lang') : '') || '';
+    return lang.toLowerCase().startsWith('zh') ? 'zh' : 'en';
+  };
+  const entryOf = (key) => ({ zh: zh[key], en: en[key] });
+  const t = (key, vars) => {
+    const e = entryOf(key);
+    let text = e[active()] ?? e.en ?? e.zh ?? '';
+    if (vars && text) {
+      for (const [k, v] of Object.entries(vars)) text = text.replaceAll(`\${${k}}`, String(v));
+    }
+    return text;
+  };
+  // 可选：向宿主注册词典（仅当其有 register 且可访问时；失败无妨）
+  try {
+    const locale = ctx && (typeof ctx.get === 'function' ? ctx.get('locale') : ctx.locale);
+    if (locale && typeof locale.register === 'function') {
+      locale.register(LOCALE_NAMESPACE, { zh, en });
+    }
+  } catch { /* 动态插件的 locale 服务被宿主门控时忽略 */ }
+  return { t, active };
+}

package/lib/bridge-rpc-constants.js

@@ -32,6 +32,8 @@ export const BRIDGE_ENDPOINTS = {
   authRegenerateToken: 'authRegenerateToken',
   authAdminUnlock: 'authAdminUnlock',
   authAdminLock: 'authAdminLock',
+  // 首次启用引导：用户确认已了解后置位，避免重复打扰
+  dismissFirstRunGuide: 'dismissFirstRunGuide',
   // 平台管理器（多 IM 平台统一接口）
   listPlatforms: 'listPlatforms',
   platformLogin: 'platformLogin',

package/lib/bridge-rpc.js

@@ -16,7 +16,10 @@ function ok(value) {
 
 function fail(code, message, details = {}) {
   const allowedCodes = new Set([
-    'bad-request', 'cancelled', 'internal', 'settings-rejected', 'command-error'
+    'bad-request', 'cancelled', 'internal', 'settings-rejected', 'command-error',
+    // 'busy'：重启等操作因「有任务在跑」被拦下，需与普通 bad-request 区分，
+    // 面板据此弹二次确认（而不是报错）。
+    'busy'
   ]);
   const safeCode = allowedCodes.has(code) ? code : 'bad-request';
   return {
@@ -82,12 +85,18 @@ function checkAdminAuth(authManager, payload, { requireConfigured = false } = {}
   return fail('bad-request', '操作已被拦截：需要管理员权限，请先在控制台输入管理密码解锁');
 }
 
-export function installBridgeRpc(ctx, { service, authManager, platformManager, logger, saveCustomTunnelConfig, exportBackup, importBackup }) {
+export function installBridgeRpc(ctx, { service, authManager, platformManager, logger, saveCustomTunnelConfig, exportBackup, importBackup, runtime }) {
   if (!ctx?.connection?.rpc?.handle) {
     logger.warn('dsh-bridge: Connection RPC unavailable — UI will not work');
     return () => {};
   }
 
+  // 运行中任务探测所需的引用（由 apply 注入）。缺失时探测退化为「无任务」，不阻断重启。
+  if (runtime) {
+    service.runtimeCtx = runtime.ctx ?? null;
+    service.platformManager = runtime.platformManager ?? null;
+  }
+
   // 经 connection-compat 注册：兼容 DSH ≥ 0.1.5-alpha.1 的 webServer 注入回归
   // （上游 register() 里对 connection 自身 ctx 取 webServer 而未加 inject 作用域）
   return registerRpcChannel(
@@ -152,6 +161,12 @@ export function installBridgeRpc(ctx, { service, authManager, platformManager, l
           return ok(authManager.getStatus({ masked: false }));
         }
 
+        if (endpoint === BRIDGE_ENDPOINTS.dismissFirstRunGuide) {
+          // 无管理权限要求：这是纯本地提示状态，不涉及安全配置变更。
+          // 与 authUpdateConfig 中「切换 enabled 不需管理权限」同理，避免提示无法关闭。
+          return ok(await service.dismissFirstRunGuide());
+        }
+
         if (endpoint === BRIDGE_ENDPOINTS.authRegenerateToken) {
           if (!authManager) return fail('bad-request', 'AuthManager 未初始化');
           const adminErr = checkAdminAuth(authManager, payload);
@@ -305,6 +320,22 @@ export function installBridgeRpc(ctx, { service, authManager, platformManager, l
           const adminErr = checkAdminAuth(authManager, payload, { requireConfigured: true });
           if (adminErr) return adminErr;
 
+          // 打断保护：有任务在跑且调用方未显式确认时，**不重启**，改为把现场回给面板，
+          // 由面板弹二次确认。已确认（payload.confirm === true）则照常重启。
+          // 探测本身失败会降级为「无任务」，绝不会把重启锁死。
+          if (payload?.confirm !== true) {
+            let work;
+            try {
+              work = service.getActiveWork?.() ?? { total: 0, sessions: [], subagentSessions: [], pendingApprovals: [] };
+            } catch (err) {
+              logger?.debug?.('dsh-bridge: 重启前探测任务失败（按无任务处理）：%s', err?.message ?? err);
+              work = { total: 0, sessions: [], subagentSessions: [], pendingApprovals: [] };
+            }
+            if (work.total > 0) {
+              return fail('busy', '当前有任务正在运行，重启会打断它们', { activeWork: work });
+            }
+          }
+
           const result = await service.restartDsh();
           return ok(result);
         }

package/lib/index.js

@@ -11,13 +11,14 @@ import { networkInterfaces, homedir, totalmem, freemem, cpus, loadavg, platform,
 import { join, dirname, basename, resolve, normalize } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { readFileSync, appendFileSync, existsSync, realpathSync, mkdirSync } from 'node:fs';
-import { readFile, writeFile, mkdir, unlink, readdir, stat, access } from 'node:fs/promises';
+import { readFile, writeFile, mkdir, unlink, readdir, stat, access, chmod } from 'node:fs/promises';
 import { spawn } from 'node:child_process';
 import QRCode from 'qrcode';
 import { installBridgeRpc } from './bridge-rpc.js';
 import { CustomTunnelClient } from './tunnel-client.mjs';
 import { CloudflaredManager, CLOUDFLARED_LOG_NAME } from './cloudflared-manager.mjs';
 import { PlatformManager } from './platform/manager.js';
+import { describeOpenTurn } from './platform/conversation-bridge.js';
 import { applyRestoredPlatformConfig, RESTORED_STRING_FIELDS, PLATFORM_TIMING_FIELDS } from './platform/config-restore.js';
 import { WechatService } from './wechat/index.js';
 import { QqService } from './qq/index.js';
@@ -571,6 +572,27 @@ class ProxyServer {
         return;
       }
 
+      // 纵深防御：浏览器发起的升级请求若带 Origin 且不在已知面板来源内，拒绝握手，
+      // 防止恶意页面借用户浏览器已有的 Cookie 建立 WebSocket（CSWSH）。
+      // 认证已在上方完成，此处只做额外收紧，不构成绕过认证的路径。
+      // 关键兼容性约束：Origin 缺失一律放行——非浏览器客户端（IM 机器人、
+      // ws 库、命令行工具、隧道转发）通常不发 Origin，若按缺失拒绝会直接
+      // 打断现有用户的机器人通道。
+      const origin = req.headers?.origin;
+      if (origin) {
+        let allowed;
+        try {
+          allowed = this.allowedOrigins?.() ?? [];
+        } catch { allowed = []; }
+        if (!allowed.includes(origin)) {
+          // 直接内联 origin，避免依赖 logger 的 printf 插值（该 logger 在部分调用形态下不做替换）
+          this.logger?.warn?.(`dsh-bridge: 拒绝来源不明的 WebSocket 升级请求 (Origin=${origin})`);
+          socket.write('HTTP/1.1 403 Forbidden\r\nContent-Type: text/plain\r\n\r\nForbidden\r\n');
+          socket.destroy();
+          return;
+        }
+      }
+
       const headers = loopbackHeaders(req.headers, this.targetPort);
       const proxyReq = httpRequest({
         host: '127.0.0.1', port: this.targetPort, method: req.method, path: req.url, headers, agent: false,
@@ -666,9 +688,19 @@ class BridgeService {
     this.onPersist = onPersist ?? null;
     this.logger = logger;
 
+    // 运行中任务探测所需的运行时引用（由 apply 在构造后注入）：
+    //   ctx.sessions —— 枚举 live 会话及其事件流，判断是否有 turn 在跑
+    //   platformManager —— 遍历各 IM 平台 bridge，取其 pending 审批
+    // 二者缺失时探测退化为「未检测到任务」，重启照常执行（不得因探测失败而阻断重启）。
+    this.runtimeCtx = null;
+    this.platformManager = null;
+
     this.qrCache = new QrCache();
     this.proxy = null;
 
+    // 首次启用引导：是否仍需要向用户展示「开门禁」提示（由 apply 的启动链按保守判据置位）
+    this.firstRunGuidePending = false;
+
     this.customTunnel = null;
     this.customTunnelState = { phase: 'idle', detail: '' };
 
@@ -742,8 +774,17 @@ class BridgeService {
     return this._dshVersion;
   }
 
-  async setLanIp({ ip } = {}) {
-    const trimmed = ip ? String(ip).trim() : null;
+  /**
+   * 标记「首次启用引导」已展示/已确认，持久化后不再打扰用户。
+   * 与访问认证状态解耦：即便用户仍未开启门禁，确认过后也不再重复弹窗。
+   */
+  async dismissFirstRunGuide() {
+    this.firstRunGuidePending = false;
+    await this.onPersist?.({ wizard: { guideShown: true } });
+    return { ok: true };
+  }
+
+  async setLanIp({ ip } = {}) {    const trimmed = ip ? String(ip).trim() : null;
     this.selectedLanIp = trimmed || null;
     await this.onPersist?.({ lan: { selectedIp: this.selectedLanIp } });
     this.logger?.info('局域网选定 IP 更新为: %s', this.selectedLanIp || '自动推荐');
@@ -767,8 +808,17 @@ class BridgeService {
           `http://127.0.0.1:${this.dshPort}`, `http://localhost:${this.dshPort}`,
         ];
         try {
-          for (const iface of listAllLanIPv4()) origins.push(`http://${iface.address}:${this.proxyPort}`);
-          if (this.selectedLanIp) origins.push(`http://${this.selectedLanIp}:${this.proxyPort}`);
+          // LAN 面板与回环同理需要同时覆盖 3082（代理）与 dshPort（DSH 原生端口直连）：
+          // 浏览器从 LAN IP 直连原生端口时 Origin 是 http://<lanIp>:<dshPort>，
+          // 只配 proxyPort 会导致页面能打开但 WebSocket 升级被拒（实时通道静默失效）。
+          for (const iface of listAllLanIPv4()) {
+            origins.push(`http://${iface.address}:${this.proxyPort}`);
+            origins.push(`http://${iface.address}:${this.dshPort}`);
+          }
+          if (this.selectedLanIp) {
+            origins.push(`http://${this.selectedLanIp}:${this.proxyPort}`);
+            origins.push(`http://${this.selectedLanIp}:${this.dshPort}`);
+          }
           if (this.cloudflared?.url) origins.push(new URL(this.cloudflared.url).origin);
           if (this.customTunnel?.publicUrl) origins.push(new URL(this.customTunnel.publicUrl).origin);
           if (this.externalTunnelConfig?.url) origins.push(new URL(this.externalTunnelConfig.url).origin);
@@ -818,6 +868,13 @@ class BridgeService {
 
       auth: this.authManager?.getStatus({ masked: !adminAuthValid }) ?? { enabled: false },
 
+      // 首次启用引导：为 true 时面板应提示用户开启访问门禁（默认 0.0.0.0 且认证默认关闭）
+      firstRunGuide: {
+        pending: Boolean(this.firstRunGuidePending),
+        // 当前是否处于「监听 0.0.0.0 但认证未开启」的开箱敞开状态
+        exposedWithoutAuth: this.authManager?.enabled !== true,
+      },
+
       proxy: {
         running: !!this.proxy,
         port: this.proxyPort,
@@ -1113,9 +1170,13 @@ class BridgeService {
       try {
         dshRealPath = realpathSync(dshBin) || dshBin;
       } catch { /* 保留原始路径继续判断 */ }
-      // 2. 当前 node 对应的全局 node_modules 根
+      // npm root -g 返回的是 prefix 下的 node_modules（如 /prefix/lib/node_modules），
+      // 不能直接 dirname 后再作为 --prefix，否则会变成 /prefix/lib，实际安装到
+      // /prefix/lib/lib/node_modules，dsh 命令仍会加载旧的 /prefix/lib/node_modules。
+      // npm prefix -g 才是可传给 --prefix 的真实全局安装前缀。
+      const globalPrefix = await runCmd('npm', ['prefix', '-g']);
       const globalNodeModules = await runCmd('npm', ['root', '-g']);
-      const rootGlobal = globalNodeModules ? dirname(globalNodeModules) : dirname(nodeDir);
+      const rootGlobal = globalPrefix || (globalNodeModules ? dirname(dirname(globalNodeModules)) : dirname(nodeDir));
       const marker = join('node_modules', '@deepseek-ai', 'dsh');
       if (dshRealPath.includes(marker) && (dshRealPath.startsWith(rootGlobal) || dshRealPath.includes('node-v') && dshRealPath.includes('lib'))) {
         return { upgradable: true, rootGlobal, dshRealPath };
@@ -1272,7 +1333,8 @@ class BridgeService {
 
   // 一键升级 DSH 宿主 CLI（npm 全局包 @deepseek-ai/dsh）。
   // 升级的是"与当前 node 配对"的全局 prefix（dsh 命令所在目录），完成后需重启 DSH 生效。
-  async upgradeDsh({ version } = {}) {
+  // opts.spawnImpl 供测试注入，生产环境用 node:child_process 的 spawn。
+  async upgradeDsh({ version, spawnImpl = spawn } = {}) {
     const targetVersion = version ? String(version).trim() : 'latest';
     // 严格 SemVer 白名单校验（dsh 用 rc 版本号，如 0.1.2-rc.1）
     if (!/^(latest|\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?)$/.test(targetVersion)) {
@@ -1331,7 +1393,7 @@ class BridgeService {
         const res = await new Promise((resolve, reject) => {
           let cp;
           try {
-            cp = spawn(task.cmd, task.args, {
+            cp = spawnImpl(task.cmd, task.args, {
               windowsHide: true,
               shell: true,
               env: augmentedEnv,
@@ -1352,6 +1414,27 @@ class BridgeService {
         });
         const output = (res.stdout || res.stderr || '升级成功').trim().slice(-500);
         this.logger?.info('dsh-bridge: DSH 升级命令成功: %s %s', task.cmd, task.args.join(' '));
+        
+        // 升级成功后清理版本缓存，让 getDshVersion/checkVersion 下次重新探测
+        this._dshVersion = null;
+        this._dshVersionLoaded = false;
+        this._versionCheckCache = null;
+        
+        // 核验实际 dsh 版本：npm 命令成功不等于正在使用的 dsh 已经变新。
+        // 如果探测到的版本号仍然是旧版（或探测失败），则安装可能装到了错误位置。
+        const actualVersion = await this.getDshVersion();
+        if (actualVersion && targetVersion !== 'latest') {
+          // 用户指定了具体版本号（如 0.2.0-rc.2）：安装后 dsh --version 必须精确匹配
+          if (actualVersion !== targetVersion) {
+            return {
+              ok: false,
+              error: `npm 安装成功但 dsh 命令实际版本仍为 ${actualVersion}（预期 ${targetVersion}）。可能安装到了错误位置，请手动执行 \`npm install -g @deepseek-ai/dsh@${targetVersion}\` 并重启 DSH。`,
+              version: targetVersion,
+              installedButNotActive: true,
+            };
+          }
+        }
+        
         return { ok: true, command: `${task.cmd} ${task.args.join(' ')}`, output, version: targetVersion };
       } catch (err) {
         lastError = err;
@@ -1368,6 +1451,65 @@ class BridgeService {
   //   - 默认 KillMode=control-group，主进程退出时 systemd 会把 cgroup 里刚派生的子进程一起杀掉。
   //   结果就是"点了重启，dsh 再也没起来"，而且没有任何日志（旧实现 stdio: 'ignore'）。
   // 因此这里先识别托管方式：
+  // 探测「重启会打断哪些正在跑的任务」。
+  //
+  // 判据（均为可从宿主运行时直接读到的信号，不依赖任何新增宿主 API）：
+  //   1. 主会话进行中的 turn：事件流里存在未配对的 turn/start（无对应 turn/end）。
+  //      这是 Web/IM 两端「正在思考/工具调用中」的同一依据
+  //      （见 lib/platform/conversation-bridge.js 的 digestLine）。
+  //   2. 子代理/agent 会话：会话 header.origin === 'subagent'，同样按未闭合 turn 判断在跑。
+  //      嵌套委托最容易被遗忘，重启损失也最大。
+  //   3. 待审批请求：各 IM 平台 bridge 的 pending（用户尚未在机器人里点「同意/拒绝」）。
+  //      宿主 ctx.approval 只提供 request()，无查询 API，故以插件自身登记的 pending 为准。
+  //
+  // 任何一步探测失败都必须降级为「该项无任务」并继续，绝不因此阻断重启：
+  // 重启是救急能力，不能被探测逻辑锁死。
+  getActiveWork() {
+    const work = { sessions: [], subagentSessions: [], pendingApprovals: [], total: 0 };
+
+    // 1 + 2：遍历 live 会话，按未闭合 turn 判断是否在跑
+    try {
+      const list = this.runtimeCtx?.sessions?.list?.() ?? [];
+      for (const s of list) {
+        if (!s || !s.id) continue;
+        const isSubagent = s.origin === 'subagent' || s.header?.origin === 'subagent';
+        const turn = describeOpenTurn(s.events);
+        if (!turn) continue;
+        const entry = {
+          id: s.id,
+          title: s.title || (s.header?.cwd ? basename(s.header.cwd) : '') || '未命名会话',
+          turn: turn.turn,
+          tools: turn.tools,
+          lastTool: turn.lastTool,
+        };
+        if (isSubagent) work.subagentSessions.push(entry);
+        else work.sessions.push(entry);
+      }
+    } catch (err) {
+      this.logger?.debug?.('dsh-bridge: 探测进行中会话失败（视为无任务）：%s', err?.message ?? err);
+    }
+
+    // 3：各 IM 平台的待审批请求
+    try {
+      for (const platform of this.platformManager?.list?.() ?? []) {
+        const pending = platform?.bridge?.pending;
+        if (!pending || typeof pending.forEach !== 'function') continue;
+        pending.forEach((entry, number) => {
+          work.pendingApprovals.push({
+            platform: platform?.id ?? 'unknown',
+            number,
+            summary: entry?.summary || entry?.title || entry?.tool || '待审批请求',
+          });
+        });
+      }
+    } catch (err) {
+      this.logger?.debug?.('dsh-bridge: 探测待审批请求失败（视为无））：%s', err?.message ?? err);
+    }
+
+    work.total = work.sessions.length + work.subagentSessions.length + work.pendingApprovals.length;
+    return work;
+  }
+
   //   - systemd（从 /proc/self/cgroup 取单元名）→ 交给 `systemctl [--user] restart --no-block <unit>`，
   //     由 systemd 负责 stop+start，新进程仍在正确的 cgroup 里；
   //   - DSH_DAEMON / PM2 → 直接退出，交给守护进程拉起；
@@ -1962,9 +2104,42 @@ function apply(ctx, config = {}) {
     }
   }
 
+  // config.json 含平台 Token / 隧道凭据 / 访问密码哈希，属同机敏感文件：
+  // 落盘固定 0600，与 sessions.json（lib/auth/manager.js）保持一致。
+  const CONFIG_FILE_MODE = 0o600;
+
   async function writeConfig(data) {
     await mkdir(join(dshHome, 'dsh-bridge'), { recursive: true });
-    await writeFile(configFile, JSON.stringify(data, null, 2), 'utf8');
+    // mode 仅对新建文件生效；已存在的旧文件（历史版本落在 0644）由
+    // ensureConfigFileMode 在启动时收敛，两者配合覆盖新建与存量两种情形。
+    await writeFile(configFile, JSON.stringify(data, null, 2), { encoding: 'utf8', mode: CONFIG_FILE_MODE });
+  }
+
+  // 存量收敛：writeFile 的 mode 不会修改已存在文件的权限位，历史版本已把
+  // config.json 写成 0644（同机其他用户可读）。此处幂等收紧到 0600。
+  // 失败仅告警、不阻断启动（Windows 等平台 chmod 语义不同，且权限收紧
+  // 不应成为插件不可用的原因）。
+  async function ensureConfigFileMode() {
+    try {
+      await access(configFile);
+    } catch (err) {
+      // 仅「文件不存在」属预期（尚未写入，写入时会带上正确 mode）。
+      // 其余错误（EACCES/EIO 等）意味着我们无法确认权限状态，必须出声，
+      // 否则旧版遗留的宽松权限会被静默放过。
+      if (err?.code !== 'ENOENT') {
+        logger.warn('dsh-bridge: 无法检查 config.json 权限状态，跳过收紧：%s', err?.message ?? err);
+      }
+      return;
+    }
+    try {
+      const current = await stat(configFile);
+      const tightened = current.mode & 0o777;
+      if (tightened === CONFIG_FILE_MODE) return;
+      await chmod(configFile, CONFIG_FILE_MODE);
+      logger.info('dsh-bridge: 已将 config.json 权限从 %s 收敛为 0600', tightened.toString(8).padStart(4, '0'));
+    } catch (err) {
+      logger.warn('dsh-bridge: 收紧 config.json 权限失败（不影响运行）：%s', err?.message ?? err);
+    }
   }
 
   // 整对象写入（同样入队，避免与进行中的事务交错）
@@ -2022,7 +2197,7 @@ function apply(ctx, config = {}) {
   }
 
   // 启动时读取已保存的 auth 配置并执行保命标记检查
-  checkEmergencyReset().then(() => loadConfig()).then((stored) => {
+  checkEmergencyReset().then(() => ensureConfigFileMode()).then(() => loadConfig()).then((stored) => {
     if (stored?.auth) {
       if (stored.auth.enabled != null) authManager.enabled = Boolean(stored.auth.enabled);
       if (stored.auth.mode) authManager.mode = stored.auth.mode;
@@ -2053,6 +2228,10 @@ function apply(ctx, config = {}) {
 
   // 启动时读取已保存的局域网网卡配置与公网隧道配置并按需自动拉起
   loadConfig().then(async (stored) => {
+    // 首次启用引导判据（保守）：仅当「访问认证未开启」且「从未展示过引导」时才提示。
+    // 已开启认证的用户、以及已经看过引导的用户一律不再打扰。
+    // 目的：默认监听 0.0.0.0 且认证默认关闭时，让新用户在开箱状态被明确提醒去开门禁。
+    service.firstRunGuidePending = authManager.enabled !== true && stored?.wizard?.guideShown !== true;
     if (stored?.externalTunnel) {
       service.externalTunnelConfig = stored.externalTunnel;
     }
@@ -2201,6 +2380,8 @@ function apply(ctx, config = {}) {
     telegram,
     platformManager,
     logger,
+    // 运行中任务探测所需的引用：探测失败一律降级为「无任务」，不阻断重启
+    runtime: { ctx, platformManager },
     saveCustomTunnelConfig: async (serverUrl, accessToken, sseStreaming) => {
       const stored = await updateConfig((current) => {
         const prev = service.customTunnelConfig ?? {};

package/lib/platform/conversation-bridge.js

@@ -33,13 +33,30 @@ export { textOfAssistantMessage } from './message-split.js'
 
 
 function digestLine(session) {
+  const open = describeOpenTurn(session?.events)
+  if (!open) return null
+  const steps = open.tools > 0 ? `${open.tools} 次工具调用` : '思考中'
+  const last = open.lastTool ? ` | 最近: ${open.lastTool}` : ''
+  return `[处理中] 第 ${open.turn} 轮 | ${steps}${last}`
+}
+
+/**
+ * 判断会话是否有**未闭合**的 turn（即正在跑任务），返回结构化描述或 null。
+ * 依据：事件流里最后一次 turn/start 之后没有配对的 turn/end。
+ * 这是 Web/IM「正在思考 / 工具调用中」的同一判据；消息摘要与重启前探测共用它，
+ * 避免两处各写一套导致结论不一致。
+ *
+ * @param {Array} events 会话事件流（session.events）
+ * @returns {{turn:number, tools:number, lastTool:(string|undefined)}|null}
+ */
+export function describeOpenTurn(events) {
   let turn = 0
   let tools = 0
   let lastTool = undefined
   let inTurn = false
-  for (const event of session.events ?? []) {
+  for (const event of events ?? []) {
     if (event.type === 'turn/start') {
-      turn = event.data.turn
+      turn = event.data?.turn ?? 0
       inTurn = true
       tools = 0
       lastTool = undefined
@@ -47,13 +64,11 @@ function digestLine(session) {
       inTurn = false
     } else if (event.type === 'tool/call' && inTurn) {
       tools += 1
-      lastTool = event.data.name
+      lastTool = event.data?.name
     }
   }
   if (!inTurn || turn === 0) return null
-  const steps = tools > 0 ? `${tools} 次工具调用` : '思考中'
-  const last = lastTool ? ` | 最近: ${lastTool}` : ''
-  return `[处理中] 第 ${turn} 轮 | ${steps}${last}`
+  return { turn, tools, lastTool }
 }
 
 function summarizeError(error) {