dsh-config-manager 0.1.78 → 0.1.80

package/lib/index.d.ts

@@ -61,7 +61,7 @@ import { SyncEngine } from './sync/sync-engine.ts';
 import { SyncSessionStore } from './sync/sync-session.ts';
 import { AutoSyncScheduler } from './sync/autosync-scheduler.ts';
 import { BackupScheduler } from './sync/backup-scheduler.ts';
-import type { AutosyncInterval, AutosyncRunStatus } from './sync/autosync-config.ts';
+import type { AutosyncInterval, AutosyncRunStatus, AutosyncAutoApplyTier, AutosyncConflictPolicy } from './sync/autosync-config.ts';
 import { MigrationStore, type MigrationKind, type MigrationResult } from './core/migration-history.ts';
 import type { SyncConfig, SyncTransportType } from './sync/sync-config.ts';
 import type { SyncSelection, SyncSelectionMode } from './sync/sync-selection.ts';
@@ -78,7 +78,7 @@ export declare const name = "config-manager";
 /** Services required before the engine can mount (present in every profile). */
 export declare const inject: string[];
 /** Plugin version, kept in sync with package.json ("version"). */
-export declare const PLUGIN_VERSION = "0.1.78";
+export declare const PLUGIN_VERSION = "0.1.80";
 /**
  * Star 引导弹窗指向的 GitHub 仓库（用户引导点 Star 的目标）。
  * 与 package.json 的 repository 字段保持一致；界面不可改（硬编码，参照
@@ -131,7 +131,7 @@ export interface Config {
 /**
  * 本文件保留的 7 条路由的路径（被源码级守卫按文件窗口钉住，见下方 routesList 注释）。
  *
- * 其余 72 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
+ * 其余 75 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
  * 新增一条 API 只需那一条声明，不再有「常量表 + 路由对象」两处要同步。
  */
 export declare const API: {
@@ -221,8 +221,9 @@ export declare class DshPluginsFacade implements PluginsFacade {
     private readonly runner;
     constructor(homeDir: string, profile: string, patchFile: PatchFileFacade, runner?: typeof runDshPlugin, msg?: MsgFunc);
     listInstalled(): Promise<PluginInfo[]>;
-    install(pkg: string, spec?: string, signal?: AbortSignal): Promise<{
+    install(pkg: string, target?: string, signal?: AbortSignal): Promise<{
         needsRestart: boolean;
+        installedVersion?: string | null;
     }>;
 }
 /**
@@ -858,7 +859,7 @@ export type RouteEnvInferred = {
         } | {
             error: string;
         }>;
-        rebuild: (repoUrl: string, mode: 'relink' | 'reclone') => Promise<GitWorkDirFacts>;
+        rebuild: (repoUrl: string, mode: 'relink' | 'adopt' | 'reclone') => Promise<GitWorkDirFacts>;
     };
     syncSectionCatalog: {
         id: SectionId;
@@ -990,6 +991,14 @@ export declare function buildAutosyncStatusByChannel(dir: string): Promise<Recor
 interface AutosyncStatusResponse {
     enabled: boolean;
     interval: AutosyncInterval;
+    /** 真·自动同步：本地改动即时触发（缺省 true） */
+    realtime: boolean;
+    /** realtime 下的远端轮询间隔（ms） */
+    remoteCheckMs: number;
+    /** 自动应用的最高风险等级（缺省 medium：plugins/mcp 也自动落盘） */
+    autoApplyTier: AutosyncAutoApplyTier;
+    /** 双侧都改时的策略（缺省 local：保留本机并推上去） */
+    conflictPolicy: AutosyncConflictPolicy;
     lastRunAt?: string;
     lastRunStatus?: AutosyncRunStatus;
     lastRunMessage?: string;

package/lib/index.js

@@ -67,10 +67,11 @@ import { msgOf, zhMsg } from './core/messages.js';
 import { engineMsg, getEngineLocale, setEngineLanguageSource, setEngineLocale } from './core/engine-locale.js';
 import { RollbackAutoTracker, RollbackPointEngine, ROLLBACK_POINTS_DIR_NAME, rollbackSessionBindingOf, rollbackTrackedEventOf } from './core/rollback-point.js';
 import { ROLLBACK_ATTRIBUTION_FILE_NAME, RollbackWriteAttribution } from './core/rollback-attribution.js';
+import { ROLLBACK_ACTIVITY_FILE_NAME, RollbackSessionActivity } from './core/rollback-activity.js';
 import { isRollbackEnabled, onRollbackEnabledChange, setRollbackEnabled } from './core/rollback-gate.js';
 // t3：宿主斜杠命令 /rollback（与 HTTP 路由同一道写入门；命令服务惰取，未组合时安静跳过）。
 import { agentSessionFactsOf, registerRollbackCommand } from './core/command-rollback.js';
-import { cleanupAbortedInstall, hasDshBundlePatch, installAnchorFromProfileContext, installErrorFor, installSpecFor, listInstalledPlugins, profileNameFromProfileContext, resolveProcessProfileName, resolveProfileDir, readProfileManifest, runDshPlugin, validateProfileName } from './core/plugin-cli.js';
+import { cleanupAbortedInstall, hasDshBundlePatch, installAnchorFromProfileContext, installErrorFor, readInstalledVersion, listInstalledPlugins, profileNameFromProfileContext, resolveProcessProfileName, resolveProfileDir, readProfileManifest, runDshPlugin, validateProfileName } from './core/plugin-cli.js';
 import { ImportUserSkippedError } from './core/types.js';
 import { PLUGIN_NPM_PACKAGE } from './core/update-check.js';
 import { planSelfUpdate, runSelfUpdate } from './core/self-update.js';
@@ -106,7 +107,7 @@ import { readRollbackEnabledSync } from './sync/ui-prefs.js';
 import { AUTO_BACKUP_PREFIX, isValidExportFileName, resolveNonCollidingExportName, writeBackupNote } from './sync/backup-files.js';
 import { DEFAULT_RETENTION_POLICY, selectPruneCandidatesByPolicy } from './sync/retention-policy.js';
 import { selectPruneCandidates } from './core/backup.js';
-import { readAllAutosyncConfigs, readAutosyncConfig } from './sync/autosync-config.js';
+import { readAllAutosyncConfigs, readAutosyncConfig, DEFAULT_AUTOSYNC_REALTIME, DEFAULT_AUTOSYNC_REMOTE_CHECK_MS, DEFAULT_AUTOSYNC_AUTO_APPLY_TIER, DEFAULT_AUTOSYNC_CONFLICT_POLICY, lastRunFailureMessage, } from './sync/autosync-config.js';
 import { appendAutosyncEntry } from './sync/sync-history.js';
 import { MigrationStore, MIGRATION_HISTORY_DIR } from './core/migration-history.js';
 import { readSyncConfig, validateRepoUrl, validateWebDavUrl, isWebDavConfig, isS3Config, isGistConfig, channelOf, parseSyncChannel, SYNC_CHANNELS, GIST_PROVIDER, isS3CompatProvider, validateCloudChannelInput, cloudSecretRef } from './sync/sync-config.js';
@@ -138,7 +139,7 @@ export const name = 'config-manager';
 /** Services required before the engine can mount (present in every profile). */
 export const inject = ['settings', 'credentials'];
 /** Plugin version, kept in sync with package.json ("version"). */
-export const PLUGIN_VERSION = '0.1.78';
+export const PLUGIN_VERSION = '0.1.80';
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager';
 /**
@@ -160,7 +161,7 @@ export const DEFAULT_GITHUB_CLIENT_ID = 'Ov23liq4i7n8UsylGRfb';
 /**
  * 本文件保留的 7 条路由的路径（被源码级守卫按文件窗口钉住，见下方 routesList 注释）。
  *
- * 其余 72 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
+ * 其余 75 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
  * 新增一条 API 只需那一条声明，不再有「常量表 + 路由对象」两处要同步。
  */
 export const API = {
@@ -526,12 +527,13 @@ export class DshPluginsFacade {
     async listInstalled() {
         return listInstalledPlugins(this.homeDir, this.profile);
     }
-    async install(pkg, spec, signal) {
+    async install(pkg, target, signal) {
         const profileDir = resolveProfileDir(this.homeDir, this.profile);
-        // 非 registry 来源（github:/git+/file: 等）按来源 spec 安装；registry 包按裸包名装
-        // npm 最新版（官方机制）。spec 丢失（旧备份）时退化为裸包名 → pnpm fetch-404，
-        // 由 installErrorFor 给出可操作诊断。
-        const result = await this.runner(profileDir, this.profile, ['add', installSpecFor(pkg, spec)], undefined, signal);
+        // target 由调用方（adapters/plugins.ts 的 pluginInstallTarget）推导完毕，这里只执行：
+        // registry 包带精确版本或「包名@spec」，pnpm 才不会静默沿用目标机既有 spec（issue #101）。
+        // 缺省退化为裸包名（旧调用方）→ pnpm fetch-404，由 installErrorFor 给出可操作诊断。
+        const spec = target !== undefined && target !== '' ? target : pkg;
+        const result = await this.runner(profileDir, this.profile, ['add', spec], undefined, signal);
         // 用户「跳过当前插件」：宿主 kill 了子进程 → 清理半装状态（删依赖行 + 删 node_modules/<pkg>，
         // 防止「package.json 声明了依赖但没装全」导致 DSH 启动失败），再以跳过语义抛错。
         if (result.aborted || (signal !== undefined && signal.aborted)) {
@@ -549,7 +551,8 @@ export class DshPluginsFacade {
             const reason = error instanceof Error ? error.message : String(error);
             throw new Error(this.msg('host.activationRowFailed', { pkg, reason }));
         }
-        return { needsRestart: true };
+        // 回读实际落盘版本：调用方据此校验升级是否真的生效（issue #101），而不是只看子进程退出码。
+        return { needsRestart: true, installedVersion: readInstalledVersion(profileDir, pkg) };
     }
 }
 /** Workspace facade over the real ctx.workspaceRegistry. */
@@ -2368,12 +2371,19 @@ export async function buildAutosyncStatus(dir, channel) {
     const elapsedMs = cfg.lastRunAt === undefined || cfg.lastRunAt === ''
         ? -1
         : Math.max(0, Date.now() - Date.parse(cfg.lastRunAt));
+    // issue #105：只有本轮真的失败才回传错误原文（success/skipped/partial 不得带上一轮的旧错误）
+    const failureMessage = lastRunFailureMessage(cfg);
     return {
         enabled: cfg.enabled,
         interval: cfg.interval,
+        // 真·自动同步三件套（缺省值在读取层已补齐，这里回传「生效中的值」）
+        realtime: cfg.realtime ?? DEFAULT_AUTOSYNC_REALTIME,
+        remoteCheckMs: cfg.remoteCheckMs ?? DEFAULT_AUTOSYNC_REMOTE_CHECK_MS,
+        autoApplyTier: cfg.autoApplyTier ?? DEFAULT_AUTOSYNC_AUTO_APPLY_TIER,
+        conflictPolicy: cfg.conflictPolicy ?? DEFAULT_AUTOSYNC_CONFLICT_POLICY,
         ...(cfg.lastRunAt !== undefined ? { lastRunAt: cfg.lastRunAt } : {}),
         ...(cfg.lastRunStatus !== undefined ? { lastRunStatus: cfg.lastRunStatus } : {}),
-        ...(cfg.lastRunMessage !== undefined ? { lastRunMessage: cfg.lastRunMessage } : {}),
+        ...(failureMessage !== undefined ? { lastRunMessage: failureMessage } : {}),
         // issue #79：跳过原因以**码**回传（界面本地化）；不再只留在 info 级日志里
         ...(cfg.lastRunSkipReason !== undefined ? { lastRunSkipReason: cfg.lastRunSkipReason } : {}),
         ...(cfg.lastRunSkipCount !== undefined ? { lastRunSkipCount: cfg.lastRunSkipCount } : {}),
@@ -2390,12 +2400,18 @@ export async function buildAutosyncStatusByChannel(dir) {
         const elapsedMs = cfg.lastRunAt === undefined || cfg.lastRunAt === ''
             ? -1
             : Math.max(0, Date.now() - Date.parse(cfg.lastRunAt));
+        // issue #105：同 buildAutosyncStatus —— 只有本轮失败才带错误原文
+        const failureMessage = lastRunFailureMessage(cfg);
         return {
             enabled: cfg.enabled,
             interval: cfg.interval,
+            realtime: cfg.realtime ?? DEFAULT_AUTOSYNC_REALTIME,
+            remoteCheckMs: cfg.remoteCheckMs ?? DEFAULT_AUTOSYNC_REMOTE_CHECK_MS,
+            autoApplyTier: cfg.autoApplyTier ?? DEFAULT_AUTOSYNC_AUTO_APPLY_TIER,
+            conflictPolicy: cfg.conflictPolicy ?? DEFAULT_AUTOSYNC_CONFLICT_POLICY,
             ...(cfg.lastRunAt !== undefined ? { lastRunAt: cfg.lastRunAt } : {}),
             ...(cfg.lastRunStatus !== undefined ? { lastRunStatus: cfg.lastRunStatus } : {}),
-            ...(cfg.lastRunMessage !== undefined ? { lastRunMessage: cfg.lastRunMessage } : {}),
+            ...(failureMessage !== undefined ? { lastRunMessage: failureMessage } : {}),
             ...(cfg.lastRunSkipReason !== undefined ? { lastRunSkipReason: cfg.lastRunSkipReason } : {}),
             ...(cfg.lastRunSkipCount !== undefined ? { lastRunSkipCount: cfg.lastRunSkipCount } : {}),
             consecutiveFailures: cfg.consecutiveFailures,
@@ -3206,6 +3222,10 @@ function makeRoutes(deps) {
         mutationLock: host.mutationLock,
         isBlocked: () => host.safeModeIsBlocked?.() ?? false,
         phase3Recovery: host.phase3Recovery,
+        // 真·自动同步：本地配置文件监听（realtime 通道）以 $DSH_HOME 为基准；
+        // 监听清单由 sync/watch-scope.ts 静态派生，已排除 sessions/ 与调度器自写文件（避免自激）。
+        homeDir: host.homeDir,
+        ...(host.profile === undefined ? {} : { profile: host.profile }),
         // Phase 6：autosync 既写 sync-history.json（既有语义），也写统一迁移历史（COMPLETE 不变量）。
         appendHistoryFn: async (entry) => {
             await appendAutosyncEntry(syncDir, entry).catch(() => undefined);
@@ -3384,7 +3404,13 @@ function makeRoutes(deps) {
             if (port === undefined)
                 return { state: 'FREE' };
             const insp = await port.inspectLockState();
-            return { state: insp.state, ...(insp.detail !== undefined ? { detail: insp.detail } : {}) };
+            // ownerInstanceId 只给编排器做 journal↔锁归属匹配（判定「正在跑」vs「残留事故」），
+            // 不进任何 HTTP 响应体（编排器只消费不回传）。
+            return {
+                state: insp.state,
+                ...(insp.detail !== undefined ? { detail: insp.detail } : {}),
+                ...(insp.ownerInstanceId !== undefined ? { ownerInstanceId: insp.ownerInstanceId } : {}),
+            };
         },
         recoverStaleLock: async () => {
             const port = host.mutationLock;
@@ -3501,13 +3527,17 @@ function makeRoutes(deps) {
                 // 也不伪装成「工作副本不存在」。
                 inspect: async (repoUrl) => {
                     try {
-                        return { facts: await makeGitTransport(repoUrl).inspectWorkDir() };
+                        // issue #104 建议 3：`/sync/status` 要回传「领先远端提交数 / 远端快照数」，
+                        // 用户看不见积压，就会在「以为在备份」的状态下一直失败。detail 多出的几条命令
+                        // 都是本地只读（rev-list / status / ls-tree），不发网络请求。
+                        return { facts: await makeGitTransport(repoUrl).inspectWorkDir({ detail: true }) };
                     }
                     catch (err) {
                         return { error: err instanceof Error ? err.message : String(err) };
                     }
                 },
-                // 重建：relink 非破坏；reclone 删目录重克隆（调用方必须先取得用户确认）
+                // 重建：relink 非破坏；adopt 合并远端历史（不改写本地提交，issue #104）；
+                // reclone 删目录重克隆（调用方必须先取得用户确认）
                 rebuild: async (repoUrl, mode) => {
                     const transport = makeGitTransport(repoUrl);
                     await transport.rebuildWorkDir(mode);
@@ -3541,7 +3571,7 @@ function makeRoutes(deps) {
     /**
      * 路由表：本文件只保留被源码级守卫按**文件窗口**钉住的 7 条（host-entry 审计 F-04 记录的
      * tests/host/**、src/core/model-tools.test.ts、src/core/phase1-wiring.test.ts 的窗口断言）。
-     * 其余 72 条已按域拆到 src/routes/*.ts，由 buildRoutes 组装。
+     * 其余 75 条已按域拆到 src/routes/*.ts，由 buildRoutes 组装。
      * 注册顺序不影响匹配：命名路由必须互不相同（webServer 契约）。
      */
     const routeEnv = makeRouteEnv();
@@ -4393,11 +4423,21 @@ export function apply(ctx, config) {
         warn: (line) => host.log.warn(line),
     });
     void rollbackAttribution.load();
+    // 会话活跃时间窗（2026-10-18）：**每个 session/event 都记一次**活跃 —— 与工具参数无关，
+    // 因此 bash / 脚本 / 外部编辑器写出的路径也能按「文件 mtime 落在谁的活跃窗口内」判定归属；
+    // 落在**谁都不活跃**的时刻 = 手改 / 外部工具 ⇒ 回退零写入并如实报 unclaimed（绝不静默覆盖）。
+    // 同样是 best-effort：读写失败只 warn，退化成「没有时间证据」（回退行为与加它之前逐字一致）。
+    const rollbackActivity = new RollbackSessionActivity({
+        file: path.join(dataDir, ROLLBACK_POINTS_DIR_NAME, ROLLBACK_ACTIVITY_FILE_NAME),
+        warn: (line) => host.log.warn(line),
+    });
+    void rollbackActivity.load();
     const rollbackEngine = new RollbackPointEngine({
         dataDir,
         homeDir,
         log: (line) => host.log.warn(line),
         attribution: rollbackAttribution,
+        activity: rollbackActivity,
         fork: async ({ sessionId, boundarySeq }) => {
             const forkSession = forkPort.forkSession;
             if (typeof forkSession !== 'function') {
@@ -4420,6 +4460,7 @@ export function apply(ctx, config) {
         engine: rollbackEngine,
         log: (line) => host.log.warn(line),
         attribution: rollbackAttribution,
+        activity: rollbackActivity,
     });
     ctx.effect(() => {
         let chain = Promise.resolve();
@@ -4507,6 +4548,9 @@ export function apply(ctx, config) {
             unlisten();
             detach();
             rollbackTracker.stop();
+            // 卸载时把**未落盘**的活跃窗口刷下去（debounce 里可能还有几条）：丢了它，
+            // 下次启动就少一段「谁在什么时候活跃」的证据 —— 归属会因此退回「未判定」。
+            void rollbackActivity.dispose();
         };
     }, 'config-manager: rollback auto points');
     // ------------------------------------------- 宿主斜杠命令 /rollback（t3）

package/lib/market/git-file-writer.js

@@ -192,7 +192,13 @@ export class GitFileWriterClient {
         const fileArg = quoteGitValue(credFile.replace(/\\/g, '/'));
         await atomicWriteFile(credFile, `https://${this.credentialUsername}:${token}@github.com\n`, { mode: 0o600, symlink: 'reject' });
         return {
-            extraArgs: ['-c', 'credential.helper=', '-c', `credential.helper=store --file=${fileArg}`],
+            // issue #103：同 git-transport.buildCredentialArgs —— store 用 username 作查找键，
+            // 不钉住就会被全局 `.gitconfig` 的 `credential.<url>.username` 顶掉而查不到口令。
+            extraArgs: [
+                '-c', 'credential.helper=',
+                '-c', `credential.helper=store --file=${fileArg}`,
+                '-c', `credential.username=${this.credentialUsername}`,
+            ],
             cleanup: async () => { await fs.rm(tmpDir, { recursive: true, force: true }); },
         };
     }

package/lib/profiles/dsh-profile-launcher.d.ts

@@ -97,6 +97,26 @@ export declare function logTail(logText: string, lines?: number): string;
  * 推断不出来（如源码树 tsx 直启 / Electron）时回退 PATH 上的 dsh（.cmd 走 shell）。
  */
 export declare function defaultResolveCli(): DshCliCommand | null;
+/**
+ * 直启 bin.js 用的运行时：宿主是 Electron 时必须以 `ELECTRON_RUN_AS_NODE=1` 当 node 用
+ * （桌面端宿主 `process.execPath` 是 DeepSeek Harness.exe，真机实测可正常跑 CLI）。
+ */
+export declare function resolveDirectCliRunner(versions?: Readonly<Record<string, string | undefined>>): {
+    command: string;
+    env?: Readonly<Record<string, string>>;
+};
+/**
+ * 从 PATH 上的 dsh 包装脚本反解真正的 CLI 入口（`.../@deepseek-ai/dsh/lib/bin.js`）。
+ *
+ * 为什么必须反解（真机实测根因）：Windows 上 `.cmd/.bat` 只能经 shell 起，而
+ * **中间 cmd 层 + `detached: true` 会丢掉孙进程的 stdout/stderr** ——
+ * `dsh.cmd --version` 经 detached 起时日志恒 0 字节（非 detached 正常），
+ * 于是启动器永远读不到 `dsh web: <带 token 的 URL>` 那行，用户只看到
+ * 「20 秒内未确认就绪 / 没能抓到带 token 的 URL」。直启 bin.js 则正常（约 8 秒出 URL）。
+ *
+ * 先按 npm/pnpm 的常见布局找同目录 `node_modules`，再退回脚本内嵌的入口路径。
+ */
+export declare function findCliEntryForShim(shimPath: string): string | null;
 /** 档案 → 是否可启动（唯一判据在 shared，UI 与本模块共用）。 */
 export { isLaunchableShape };
 /** 档案启动器（每个实例无状态，可直接复用）。 */

package/lib/profiles/dsh-profile-launcher.js

@@ -9,6 +9,9 @@
  * 生态里的做法同样如此（dsh-profile-manager 的 `dshm start`、DSH Launcher 的桌面启动器），
  * 都是「由启动器 spawn 一个实例」；本模块把这件事做进插件：
  * web 形态档案 → detached 子进程 + 自动挑空闲端口 + 从启动日志里抓认证 URL + HTTP 探活。
+ * 子进程必须**直启**（node/Electron-as-node 跑 `bin.js`）：Windows 上经 `.cmd` 包装脚本
+ * （`shell: true` 或中间 cmd 层）再 `detached: true` 会丢掉孙进程的 stdout/stderr，
+ * 日志文件恒 0 字节 ⇒ 永远抓不到 `dsh web: <带 token 的 URL>`（真机实测，见 findCliEntryForShim）。
  *
  * 设计约束：
  *  - 只消费 DSH 的稳定表面（启动参数 + 启动日志里的 `dsh web:` 行），不 import 任何
@@ -97,7 +100,18 @@ export function defaultResolveCli() {
         }
         return null;
     }
-    return { command: fromPath, prefixArgs: [], shell: /\.(cmd|bat)$/i.test(fromPath) };
+    const needsShell = /\.(cmd|bat)$/i.test(fromPath);
+    // Windows 的 .cmd/.bat 只能经 shell 起，而「中间 cmd 层 + detached」会吞掉孙进程的
+    // stdio（日志恒 0 字节 ⇒ 永远抓不到带 token 的 URL）。能反解出真入口就直接跑，
+    // 只有反解不出来时才退回包装脚本（那时日志里没有 URL，UI 会如实报 urlNotFound）。
+    if (needsShell) {
+        const entry = findCliEntryForShim(fromPath);
+        if (entry !== null) {
+            const runner = resolveDirectCliRunner();
+            return { command: runner.command, prefixArgs: [entry], shell: false, env: runner.env };
+        }
+    }
+    return { command: fromPath, prefixArgs: [], shell: needsShell };
 }
 /** bin.js 是否属于 @deepseek-ai/dsh（读上一级的 package.json.name）。 */
 function isDshBinPath(binPath) {
@@ -123,6 +137,49 @@ function findOnPath(names) {
     }
     return null;
 }
+/**
+ * 直启 bin.js 用的运行时：宿主是 Electron 时必须以 `ELECTRON_RUN_AS_NODE=1` 当 node 用
+ * （桌面端宿主 `process.execPath` 是 DeepSeek Harness.exe，真机实测可正常跑 CLI）。
+ */
+export function resolveDirectCliRunner(versions = process.versions) {
+    if (versions['electron'] !== undefined)
+        return { command: process.execPath, env: { ELECTRON_RUN_AS_NODE: '1' } };
+    return { command: process.execPath };
+}
+/**
+ * 从 PATH 上的 dsh 包装脚本反解真正的 CLI 入口（`.../@deepseek-ai/dsh/lib/bin.js`）。
+ *
+ * 为什么必须反解（真机实测根因）：Windows 上 `.cmd/.bat` 只能经 shell 起，而
+ * **中间 cmd 层 + `detached: true` 会丢掉孙进程的 stdout/stderr** ——
+ * `dsh.cmd --version` 经 detached 起时日志恒 0 字节（非 detached 正常），
+ * 于是启动器永远读不到 `dsh web: <带 token 的 URL>` 那行，用户只看到
+ * 「20 秒内未确认就绪 / 没能抓到带 token 的 URL」。直启 bin.js 则正常（约 8 秒出 URL）。
+ *
+ * 先按 npm/pnpm 的常见布局找同目录 `node_modules`，再退回脚本内嵌的入口路径。
+ */
+export function findCliEntryForShim(shimPath) {
+    const dir = dirname(shimPath);
+    const candidates = [
+        join(dir, 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js'), // npm 全局前缀（dsh.cmd 同目录）
+        join(dir, '..', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js'), // <prefix>/bin/dsh.cmd
+        join(dir, '..', '..', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js'),
+        join(dir, '..', '@deepseek-ai', 'dsh', 'lib', 'bin.js'), // pnpm <store>/.bin/dsh.cmd
+    ];
+    for (const candidate of candidates) {
+        if (isDshBinPath(candidate))
+            return candidate;
+    }
+    const text = readTextSafe(shimPath);
+    if (text === null)
+        return null;
+    // 脚本内嵌路径可能是相对当前目录的（`%dp0%\node_modules\…`）也可能是 `..\node_modules\…`，
+    // 故把可选的前导相对段一起抓下来，再按 shim 所在目录解析。
+    const embedded = /(?:\.\.[\\/]|[.][\\/])?node_modules[\\/]+@deepseek-ai[\\/]+dsh[\\/]+lib[\\/]+bin\.js/iu.exec(text);
+    if (embedded === null)
+        return null;
+    const resolved = join(dir, embedded[0]);
+    return isDshBinPath(resolved) ? resolved : null;
+}
 /** 档案 → 是否可启动（唯一判据在 shared，UI 与本模块共用）。 */
 export { isLaunchableShape };
 /** 档案启动器（每个实例无状态，可直接复用）。 */

package/lib/profiles/dsh-profile-shared.d.ts

@@ -134,8 +134,14 @@ export interface DshProfileRunningView {
 export type DshProfileStopOutcome = 'graceful' | 'killed' | 'already-stopped';
 /** 启动回执里的非致命告警码。 */
 export type DshProfileLaunchWarning = 'notReady' | 'urlNotFound';
-/** 等待新实例就绪的上限（宿主探活默认值；UI 文案引用同一常量，避免两处各写一个数字）。 */
-export declare const DSH_PROFILE_LAUNCH_TIMEOUT_MS = 20000;
+/**
+ * 等待新实例就绪的上限（宿主探活默认值；UI 文案引用同一常量，避免两处各写一个数字）。
+ *
+ * 真机口径（web 档案）：端口约 3 秒就 LISTENING，但带 token 的 URL 要等 dsh 把整棵插件树
+ * settle 完 + startup audit 走完才打印，实测 8–10 秒，插件多的档案会更久（有过 >20 秒的样本）。
+ * 20 秒会把「慢但成功」误判成未就绪，故放宽到 30 秒。
+ */
+export declare const DSH_PROFILE_LAUNCH_TIMEOUT_MS = 30000;
 /** GET /profiles 的响应负载（列表 + 当前运行 + 运行中实例 + 模板清单）。 */
 export interface DshProfilesSnapshot {
     profiles: DshProfileMeta[];

package/lib/profiles/dsh-profile-shared.js

@@ -6,8 +6,14 @@
  * 引擎（`dsh-profile-manager.ts`，用 node fs）与 UI 视图模型/React 壳都只从这里取
  * 类型、常量与纯函数。
  */
-/** 等待新实例就绪的上限（宿主探活默认值；UI 文案引用同一常量，避免两处各写一个数字）。 */
-export const DSH_PROFILE_LAUNCH_TIMEOUT_MS = 20_000;
+/**
+ * 等待新实例就绪的上限（宿主探活默认值；UI 文案引用同一常量，避免两处各写一个数字）。
+ *
+ * 真机口径（web 档案）：端口约 3 秒就 LISTENING，但带 token 的 URL 要等 dsh 把整棵插件树
+ * settle 完 + startup audit 走完才打印，实测 8–10 秒，插件多的档案会更久（有过 >20 秒的样本）。
+ * 20 秒会把「慢但成功」误判成未就绪，故放宽到 30 秒。
+ */
+export const DSH_PROFILE_LAUNCH_TIMEOUT_MS = 30_000;
 export const DSH_PROFILE_TEMPLATES = [
     { id: 'base', bundles: ['@deepseek-ai/dsh-base'], patchReload: 'live' },
     { id: 'web', bundles: ['@deepseek-ai/dsh-base', '@deepseek-ai/dsh-web-app'], patchReload: 'live' },

package/lib/routes/foreign.js

@@ -17,7 +17,8 @@
  *  ② **不做导入**：本路由只产包，**绝不**触碰 $DSH_HOME 下的配置。导入仍由既有
  *     /analyze → /plan → /execute 完成（导入前快照、冲突判定、dry-run 全部自动生效）；
  *  ③ **凭据值绝不进响应**：只回 skipped 机器码 + 凭据**引用名**（值在转换层就已被剥离，
- *     见 src/foreign/types.ts 的不变量①）；
+ *     见 src/foreign/types.ts 的不变量①）；溯源块（origin：来源标识 / 位置 / 项目根 / 插件元数据 /
+ *     跳过聚合 / 凭据引用名）同样**只含标识与计数**，绝无任何配置值；
  *  ④ **空结果不静默成功**：一个分区都产不出来 → 400 + 稳定码（与 CLI 的退出码 1 同口径），
  *     否则用户会拿到一个自检通过却什么都没有的包。
  *
@@ -198,6 +199,12 @@ export function foreignRoutes(env) {
                 skipped: result.skipped,
                 // 凭据只给**引用名**（形如 mcp:gitnexus:GITHUB_TOKEN）：导入后由用户在 DSH 里补录
                 credentialRefs: result.credentialRefs,
+                /**
+                 * 溯源块（**additive**）：来源标识 / 读取位置 / 项目根 / 插件元数据 / 跳过聚合 /
+                 * 凭据引用名 —— 界面据此让用户核对「这包从哪来」（同一位也写进 manifest.foreign）。
+                 * 翻译层没给 origin 时该键**不出现**（JSON.stringify 丢弃 undefined）⇒ 旧响应逐字不变。
+                 */
+                origin: result.origin,
                 /** 检测到的本机位置（相对 home），供界面显示「从哪儿读的」 */
                 detectedPaths: detection.paths,
                 conflictPolicy: FOREIGN_CONFLICT_POLICY,

package/lib/routes/index.d.ts

@@ -3,7 +3,7 @@
  *
  * 顺序对匹配无影响：DSH webServer 的契约是「命名路由必须互不相同，注册顺序不影响请求」
  * （见 @deepseek-ai/dsh-host-webserver 的 WebServer 文档）。src/index.ts 保留的 7 条被源码级
- * 守卫按文件窗口钉住，其余 72 条在这里组装。
+ * 守卫按文件窗口钉住，其余 75 条在这里组装。
  */
 import type { WebRoute } from './kit.ts';
 import type { RoutesEnv } from './context.ts';

package/lib/routes/kit.d.ts

@@ -8,8 +8,8 @@
  * - 「每条路由首行 guard」这条安全不变量此前**只写在注释里**，零测试覆盖；
  * - 3 条 prefix 路由自造围栏（裸 isLoopbackRequest + 自判方法）。
  *
- * 计数口径（三路一致 = 78，勿再照抄旧审计初稿的计数 —— 那是计数口径 overcount）：
- *   路由快照 79 条 ＝ 现行 `endpoint()` 声明 79 条 ＝ 运行期 `buildRoutes()` 72 条 + `src/index.ts` 保留的 7 条。
+ * 计数口径（三路一致 = 82，勿再照抄旧审计初稿的计数 —— 那是计数口径 overcount）：
+ *   路由快照 82 条 ＝ 现行 `endpoint()` 声明 82 条 ＝ 运行期 `buildRoutes()` 75 条 + `src/index.ts` 保留的 7 条。
  * 增删路由后必须同步这段计数、`src/routes/index.ts` 的头注释与 parity 快照清单；`tests/route/route-parity.test.ts`
  * 的「路由计数散文」守卫会拿真实声明数逐条对账（写错即红灯）。
  *