dsh-github-flow 0.1.8 → 0.2.1

package/lib/upgrade-manager.js

@@ -1,4 +1,4 @@
-import { spawn } from 'node:child_process';
+import { spawn, execFile } from 'node:child_process';
 import path from 'node:path';
 import fs from 'node:fs';
 import os from 'node:os';
@@ -14,7 +14,7 @@ import { PLUGIN_PACKAGE_NAME } from './version.js';
  * 3. 动态将当前 node 运行时所在目录 (path.dirname(process.execPath)) 及 Mac 常用包管理器路径注入 PATH 首端，
  *    彻底实现 macOS 与 Linux 环境下子进程对 npm / pnpm 命令的 100% 自愈发现。
  */
-export function buildCrossPlatformEnv() {
+export function buildCrossPlatformEnv(registryOverride) {
     const currentPath = process.env.PATH || '';
     const extraPaths = [];
     const isMac = process.platform === 'darwin';
@@ -26,6 +26,50 @@ export function buildCrossPlatformEnv() {
         }
         catch { }
     }
+    // 1.5 DSH CLI 所在目录自愈（P2 修复）：一键升级实际要执行 `dsh plugin ...`，
+    // 但桌面版由 GUI 启动时不继承终端 PATH，子进程常找不到 dsh（实测本机 dsh 在
+    // D:\dsh-zm\resources\runtime\cli\bin，node 在 D:\CodeApps\nodejs——两者分离，
+    // 且安装根与 ~/.dsh 无任何路径关系）。
+    // 探测链（从准确到模糊）：
+    //   a. DSH_CLI_BIN 显式环境变量（用户/宿主可预设）；
+    //   b. process.argv[0] 宿主二进制推导——桌面版 argv[0] 即
+    //      <安装根>/DeepSeek Harness.exe（或 node 跑 CLI 时的可执行），
+    //      其 dirname 拼上 resources/runtime/cli/bin 是桌面版固定布局；
+    //   c. 从 DSH_PROFILE_DIR 逐级上溯（覆盖 ~/.dsh 布局的安装形态）；
+    //   d. ~/.dsh/runtime/cli/bin 常见兜底。
+    const dshBinCandidates = [];
+    if (process.env.DSH_CLI_BIN)
+        dshBinCandidates.push(process.env.DSH_CLI_BIN);
+    try {
+        if (process.argv[0]) {
+            const hostDir = path.dirname(path.resolve(process.argv[0]));
+            dshBinCandidates.push(path.join(hostDir, 'resources', 'runtime', 'cli', 'bin'));
+        }
+    }
+    catch { }
+    try {
+        const profileDir = (process.env.DSH_PROFILE_DIR || '').trim();
+        if (profileDir) {
+            // profiles/<name> -> 上溯到 ~/.dsh，再拼 runtime/cli/bin
+            let cur = path.resolve(profileDir);
+            for (let i = 0; i < 3; i++) {
+                dshBinCandidates.push(path.join(cur, 'runtime', 'cli', 'bin'));
+                cur = path.dirname(cur);
+            }
+        }
+        const dshHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+        dshBinCandidates.push(path.join(dshHome, 'runtime', 'cli', 'bin'));
+    }
+    catch { }
+    for (const cand of dshBinCandidates) {
+        try {
+            if (fs.existsSync(cand)) {
+                extraPaths.push(cand);
+                break;
+            }
+        }
+        catch { }
+    }
     // 2. macOS 专有软件与包管理器安装路径
     if (isMac) {
         extraPaths.push('/opt/homebrew/bin'); // Apple Silicon Homebrew
@@ -47,11 +91,118 @@ export function buildCrossPlatformEnv() {
     return {
         ...process.env,
         PATH: uniquePaths.join(separator),
-        NPM_CONFIG_REGISTRY: 'https://registry.npmmirror.com', // 优先国内源加速
+        NPM_CONFIG_REGISTRY: registryOverride ?? 'https://registry.npmjs.org',
         LANG: 'zh_CN.UTF-8',
         LC_ALL: 'zh_CN.UTF-8',
     };
 }
+/**
+ * 探测 dsh CLI 是否对当前进程可达（PATH 或已知安装位置）。
+ * 为什么必须预检：桌面端 GUI 启动时 dsh 常不在 PATH，旧实现用 '||' 兜底到
+ * `npm install -g`——装到全局对 profile 依赖毫无作用，表现为「一键升级无效果」
+ * 的静默失败。预检不可达时直接给出带完整命令的明确指引，宁可见失败不可假成功。
+ */
+export async function probeDshCliAvailable(env) {
+    const isWin = process.platform === 'win32';
+    const probeCmd = isWin ? 'where' : 'which';
+    return new Promise((resolve) => {
+        try {
+            execFile(probeCmd, ['dsh'], { env, timeout: 5_000 }, (err, stdout) => {
+                if (!err && String(stdout).trim()) {
+                    resolve({ ok: true });
+                }
+                else {
+                    resolve({ ok: false, hint: `未在 PATH 中发现 dsh CLI（${probeCmd} dsh 无输出）` });
+                }
+            });
+        }
+        catch (e) {
+            resolve({ ok: false, hint: `dsh CLI 探测失败: ${e?.message || e}` });
+        }
+    });
+}
+/**
+ * 定位桌面版自带的 pnpm 分发包（pnpm.mjs）。
+ * 官方事实（apps/desktop/README）：Desktop 在 resources/runtime/primary-runtime/
+ * dependencies/pnpm 携带完整 pnpm 分发，「包操作不要求 PATH 上存在 pnpm」。
+ * dsh CLI 的 plugin 子命令本质就是「进 profile 目录转发 pnpm」——CLI 不可达时
+ * 我们可以自己定位 profile 目录直调这份 pnpm，完全绕开 dsh CLI 依赖。
+ * 候选链：a. DSH_BUNDLED_PNPM 显式覆盖；b. argv[0] 宿主二进制推导（桌面版固定布局）。
+ */
+export function locateBundledPnpm() {
+    const candidates = [];
+    if (process.env.DSH_BUNDLED_PNPM)
+        candidates.push(process.env.DSH_BUNDLED_PNPM);
+    try {
+        if (process.argv[0]) {
+            const hostDir = path.dirname(path.resolve(process.argv[0]));
+            candidates.push(path.join(hostDir, 'resources', 'runtime', 'primary-runtime', 'dependencies', 'pnpm', 'bin', 'pnpm.mjs'));
+        }
+    }
+    catch { }
+    for (const c of candidates) {
+        try {
+            if (fs.existsSync(c))
+                return c;
+        }
+        catch { }
+    }
+    return null;
+}
+/**
+ * 读取 profile 中已实际安装的本插件版本（实证校验的事实源）。
+ * 读不到（目录不存在/无产物/JSON 损坏）返回 null——调用方据此决定是否放行：
+ * 无法证伪时不在成功文案里虚报版本号，但不阻断（避免文件系统受限环境下误杀真成功）。
+ */
+export function readInstalledVersion(profileDir) {
+    try {
+        const dir = profileDir || defaultProfileDir();
+        const pkgPath = path.join(dir, 'node_modules', PLUGIN_PACKAGE_NAME, 'package.json');
+        if (!fs.existsSync(pkgPath))
+            return null;
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        return typeof pkg.version === 'string' ? pkg.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+function defaultProfileDir() {
+    const dshHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+    return process.env.DSH_PROFILE_DIR || path.join(dshHome, 'profiles', process.env.DSH_PROFILE || 'default');
+}
+/**
+ * 把插件包名补写进 profile 的 dsh.profile.bundles（幂等）。
+ * 为什么需要：pnpm add 只改 dependencies；dsh plugin add 还会追加 bundles 列表
+ * （官方语义：无 dsh.bundle 声明的包只作普通依赖不激活）。直调 pnpm 的降级路径
+ * 必须补齐这一步，插件才会真正进入 profile 组合。
+ * 安全性（本机实测）：pnpm add 对 dsh.profile 自定义字段完整保真，因此补写放在
+ * pnpm 成功后执行，读写同一份 package.json 不会互相破坏；写入用「读-改-写全量
+ * JSON」保持 2 空格缩进 + 尾换行与 dsh CLI 产物一致。
+ */
+export function ensureBundleListed(profileDir, pkgName) {
+    try {
+        const pkgPath = path.join(profileDir, 'package.json');
+        if (!fs.existsSync(pkgPath))
+            return { ok: false, error: `profile package.json 不存在: ${pkgPath}` };
+        const raw = fs.readFileSync(pkgPath, 'utf8');
+        const pkg = JSON.parse(raw);
+        if (!pkg.dsh)
+            pkg.dsh = {};
+        if (!pkg.dsh.profile)
+            pkg.dsh.profile = {};
+        if (!Array.isArray(pkg.dsh.profile.bundles))
+            pkg.dsh.profile.bundles = [];
+        if (pkg.dsh.profile.bundles.includes(pkgName))
+            return { ok: true }; // 幂等：已在列表
+        pkg.dsh.profile.bundles.push(pkgName);
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, error: `bundles 补写失败: ${e?.message || e}` };
+    }
+}
 /**
  * 自动升级执行引擎
  *
@@ -68,6 +219,29 @@ export class UpgradeManager {
         state: 'idle',
     };
     logBuffer = [];
+    /** 代理管理器（可选）：注入后一键升级的 npm/pnpm 子进程走用户代理 */
+    proxyManager;
+    /** 更新源模式查询（可选）：一键升级的 NPM_CONFIG_REGISTRY 跟随用户在设置页选择的源 */
+    getUpdateMode = null;
+    attachProxyManager(manager) {
+        this.proxyManager = manager;
+    }
+    /** 注入更新源查询函数（而非静态值）：用户切换源后无需重新装配即实时生效 */
+    attachUpdateModeQuery(query) {
+        this.getUpdateMode = query;
+    }
+    /**
+     * 按当前更新源推导 NPM_CONFIG_REGISTRY。
+     * 为什么跟随源而非写死：用户选官方源的理由（镜像同步滞后）对安装同样成立——
+     * 选镜像源装的可能是旧版。off 模式下一键升级仍可用（关提示不关能力），
+     * 其 registry 落官方源（能力路径取最权威的源）。
+     */
+    resolveRegistry() {
+        const mode = this.getUpdateMode ? this.getUpdateMode() : null;
+        if (mode === 'mirror')
+            return 'https://registry.npmmirror.com';
+        return 'https://registry.npmjs.org';
+    }
     /**
      * 探测当前插件是否是以本地 Git 源码软链接方式运行
      */
@@ -118,6 +292,94 @@ export class UpgradeManager {
             log: this.logBuffer.join('\n'),
         };
     }
+    /**
+     * 级别 2 降级路径：直调桌面版自带 pnpm 安装包（execFile 数组参数隔离，无 shell）。
+     * 输出与退出码经回调上抛，由调用方决定 bundles 补写与状态机收尾。
+     */
+    runPnpmDirect(pnpmMjs, profileDir, pkgWithVer, env, done) {
+        const chunks = [];
+        try {
+            const child = spawn(process.execPath, [pnpmMjs, 'add', pkgWithVer], {
+                cwd: profileDir,
+                env,
+                windowsHide: true,
+            });
+            const collect = (b) => {
+                const t = b.toString();
+                chunks.push(t);
+                this.logBuffer.push(t);
+                if (this.logBuffer.length > 200)
+                    this.logBuffer.shift();
+            };
+            child.stdout?.on('data', collect);
+            child.stderr?.on('data', collect);
+            const timer = setTimeout(() => child.kill(), 120_000);
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                done({ ok: code === 0, log: chunks.join('') });
+            });
+            child.on('error', (err) => {
+                clearTimeout(timer);
+                done({ ok: false, log: [...chunks, String(err?.message || err)].join('') });
+            });
+        }
+        catch (e) {
+            done({ ok: false, log: `spawn pnpm 失败: ${e?.message || e}` });
+        }
+    }
+    /**
+     * 升级结果统一收尾（状态机 + 互斥锁复位）。级别 1/级别 2 共用，
+     * 保证 lastResult、isUpgrading、返回文案的形态完全一致。
+     *
+     * 关键防线一：退出码 0 ≠ 安装成功。本函数在退出码为 0 时再做一次实证校验——
+     * 读 profile 的 node_modules/<pkg>/package.json 实际版本，与目标版本比对。
+     * 不匹配（网络劫持返回空产物、registry 异常静默跳过安装、包管理器缓存错乱
+     * 等场景）一律判失败并如实报「实际安装版本」，绝不把没装上说成装好了。
+     *
+     * 关键防线二：失败文案不内嵌完整命令。前端升级卡片常驻「📋 复制命令」按钮
+     * （复制的命令已按当前 profile 生成），文字里贴长命令既让用户手动描选困难、
+     * 也无法区分 Web/桌面环境谁敲得了终端。文案只引导按钮 + 按环境给可行出路：
+     * 桌面版未注册 CLI 的用户走官方「管理 dsh 命令」菜单，其余走复制命令。
+     */
+    finishUpgrade(result, targetVersion, env, startedAt, profileDir) {
+        const completedAt = Date.now();
+        const wantVersion = targetVersion || 'latest';
+        const pkgWithVer = targetVersion ? `${PLUGIN_PACKAGE_NAME}@${targetVersion}` : `${PLUGIN_PACKAGE_NAME}@latest`;
+        // 出路文案按环境分流：桌面版保留官方菜单通道（未注册 CLI 的用户唯一可行路径）
+        const actionHint = env.isDesktop
+            ? '点击「📋 复制命令」后在系统终端运行；若终端无 dsh 命令，请先在 DSH 桌面端菜单 → 管理 dsh 命令… → 安装'
+            : '点击「📋 复制命令」后在部署 DSH 的机器终端运行';
+        if (result.ok) {
+            // 实证校验：产物版本才是唯一可信事实源
+            const installed = readInstalledVersion(profileDir);
+            if (installed && targetVersion && installed !== targetVersion) {
+                this.lastResult = {
+                    state: 'failed',
+                    targetVersion,
+                    message: `升级失败：命令正常结束，但 profile 中实际安装的版本是 ${installed}（目标 ${targetVersion}），未完成目标版本安装。${actionHint}，或稍后重试一键升级。`,
+                    completedAt,
+                    environment: env.isDesktop ? 'desktop' : 'web',
+                };
+                this.isUpgrading = false;
+                return;
+            }
+            const verSuffix = installed ? `（实证校验通过：${installed}）` : '';
+            const successMsg = env.isDesktop
+                ? `升级成功！已安装 ${pkgWithVer} 到桌面版 Profile${verSuffix}。需重启 DSH 桌面客户端彻底生效后端工具，或刷新当前界面。`
+                : `升级成功！已安装 ${pkgWithVer}${verSuffix}。需重启 DSH 服务彻底生效后端工具，或刷新网页先体验新版界面。`;
+            this.lastResult = { state: 'success', targetVersion: wantVersion, message: successMsg, completedAt, environment: env.isDesktop ? 'desktop' : 'web' };
+        }
+        else {
+            this.lastResult = {
+                state: 'failed',
+                targetVersion,
+                message: `升级失败（安装命令返回非零退出码）。${targetVersion ? `目标版本 ${targetVersion} 未安装成功。` : ''}${actionHint}，或稍后重试一键升级。`,
+                completedAt,
+                environment: env.isDesktop ? 'desktop' : 'web',
+            };
+        }
+        this.isUpgrading = false;
+    }
     /**
      * 执行一键升级核心流程
      */
@@ -160,27 +422,88 @@ export class UpgradeManager {
             startedAt,
             environment: env.isDesktop ? 'desktop' : 'web',
         };
+        // 两级执行策略（官方事实：桌面版的 dsh CLI 注册是可选操作，大量桌面用户
+        // 未注册命令；而 Desktop 自带完整 pnpm 分发包，「包操作不要求 PATH 上存在
+        // pnpm」，dsh plugin 本质是「进 profile 目录转发 pnpm + 补写 bundles 列表」）：
+        //   级别 1：dsh CLI 可达（Web 版终端起 / 桌面版已注册命令）→ 走 CLI，行为
+        //           与官方完全一致（含 bundles 维护）；
+        //   级别 2：CLI 不可达但能定位自带 pnpm 与 profile 目录 → 直调 pnpm add +
+        //           自行补写 bundles，完全绕开 CLI 依赖；
+        //   兜底：两者皆不可用 → 给官方「管理 dsh 命令」菜单指引（安装后重试即可）。
+        // 注意：任何提前失败分支必须复位 isUpgrading（safeSettle 不经过这些路径）。
+        // registry 按用户「更新设置」选择的源解析（每次升级执行时实时取，切源后无需重新装配）。
+        const probeEnv = { ...buildCrossPlatformEnv(this.resolveRegistry()), ...(this.proxyManager?.getEnv('package-manager') || {}) };
+        const dshProbe = await probeDshCliAvailable(probeEnv);
+        let usePnpmFallback = false;
+        if (!dshProbe.ok) {
+            const bundledPnpm = locateBundledPnpm();
+            const dshHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+            const profileDir = env.profileDir || path.join(dshHome, 'profiles', env.profile || 'default');
+            if (bundledPnpm && fs.existsSync(profileDir)) {
+                usePnpmFallback = true;
+                this.logBuffer.push(`[fallback] dsh CLI 不可达，降级为直调自带 pnpm: ${bundledPnpm}`);
+            }
+            else {
+                this.isUpgrading = false;
+                // 官方指引（apps/desktop/README「终端命令」）：桌面版菜单提供「管理 dsh
+                // 命令…」的安装/修复入口，注册后即可在终端使用 dsh。指引一次安装永久解决。
+                // 官方指引（apps/desktop/README「终端命令」）：桌面版菜单提供「管理 dsh
+                // 命令…」的安装/修复入口，注册后即可在终端使用 dsh。一次安装永久解决。
+                // 文案不内嵌命令（引导复制按钮），且此场景多为桌面版——Web 版通常自带 CLI。
+                const menuPath = 'DSH 桌面端菜单 → 管理 dsh 命令… → 安装';
+                const failMsg = `未能自动定位可用的安装通道（${dshProbe.hint || 'dsh CLI 不可用'}，且未找到桌面版自带的 pnpm）。请通过官方入口注册命令：${menuPath}（注册后重试一键升级即可）；或点击「📋 复制命令」获取手动升级命令。`;
+                this.lastResult = {
+                    state: 'failed',
+                    targetVersion,
+                    message: failMsg,
+                    completedAt: Date.now(),
+                    environment: env.isDesktop ? 'desktop' : 'web',
+                };
+                return {
+                    ok: false,
+                    message: failMsg,
+                    needRestart: false,
+                    environment: env.isDesktop ? 'desktop' : 'web',
+                    log: `Both dsh CLI and bundled pnpm unavailable. Official menu: ${menuPath}`,
+                };
+            }
+        }
         return new Promise((resolve) => {
             const isWin = process.platform === 'win32';
             let command = '';
             let executionCwd = process.cwd();
-            // 根据环境类型分流升级指令（跨平台安全路径）：
+            if (usePnpmFallback) {
+                // 级别 2：直调桌面版自带 pnpm（execFile 数组参数，不经 shell，无注入面）。
+                // 升级成功后由 close 回调补写 bundles 列表（见下方 code === 0 分支）。
+                const bundledPnpm = locateBundledPnpm();
+                const dshHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+                executionCwd = env.profileDir || path.join(dshHome, 'profiles', env.profile || 'default');
+                this.runPnpmDirect(bundledPnpm, executionCwd, pkgWithVer, probeEnv, (result) => {
+                    if (result.ok) {
+                        const listed = ensureBundleListed(executionCwd, PLUGIN_PACKAGE_NAME);
+                        if (!listed.ok) {
+                            this.logBuffer.push(`[warn] ${listed.error}（依赖已安装；重启后如未生效，请在菜单「管理 dsh 命令」注册 CLI 后重试）`);
+                        }
+                        else {
+                            this.logBuffer.push(`[fallback] 已补写 bundles 列表: ${PLUGIN_PACKAGE_NAME}`);
+                        }
+                    }
+                    this.finishUpgrade(result, targetVersion, env, startedAt, executionCwd);
+                });
+                return;
+            }
+            // 级别 1：dsh CLI（官方语义 `dsh plugin --profile <name> add <pkg>` 在 profile
+            // 目录内转发 pnpm，自动维护 dependencies 与 bundles）。失败不静默滑入
+            // npm install —— 装到全局对 profile 依赖毫无作用，只制造假成功。
             if (env.isDesktop) {
-                // 场景 A：DSH 桌面版环境（macOS / Windows / Linux 桌面端通用）
+                command = `dsh plugin --profile desktop add ${pkgWithVer}`;
                 const dshHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
-                const fallbackDesktopCwd = env.profileDir || path.join(dshHome, 'profiles', 'desktop');
-                if (fs.existsSync(fallbackDesktopCwd)) {
-                    executionCwd = fallbackDesktopCwd;
-                    command = `dsh plugin --profile desktop add ${pkgWithVer} || npm install ${pkgWithVer} --save`;
-                }
-                else {
-                    command = `dsh plugin --profile desktop add ${pkgWithVer} || npm install -g ${pkgWithVer}`;
-                }
+                executionCwd = env.profileDir || path.join(dshHome, 'profiles', 'desktop');
             }
             else {
                 // 场景 B：Web 版 / 开发者终端 CLI 版环境
                 const profile = env.profile || 'default';
-                command = `pnpm dsh plugin add ${pkgWithVer} || dsh plugin --profile ${profile} add ${pkgWithVer} || npm install -g ${pkgWithVer}`;
+                command = `dsh plugin --profile ${profile} add ${pkgWithVer}`;
             }
             // 跨平台 Shell 选型与参数调度：
             // - Windows: 采用 cmd.exe (/d /s /c)，完美原生支持 '||' 且冷启动仅 ~10ms，规避 powershell 5.1 语法报错；
@@ -200,7 +523,12 @@ export class UpgradeManager {
                 resolve(result);
             };
             // 注入跨平台增强环境（尤其治愈 macOS GUI 启动丢失 PATH 的痛点）
-            const childEnv = buildCrossPlatformEnv();
+            // 代理环境变量按 applyToPackageManager 开关合并：npm/pnpm 遵循 HTTPS_PROXY，
+            // 与 gh 链路同一管理器，保证「设置代理后升级也走代理」的体验一致性。
+            const childEnv = {
+                ...buildCrossPlatformEnv(this.resolveRegistry()),
+                ...(this.proxyManager?.getEnv('package-manager') || {}),
+            };
             const child = spawn(shell, args, {
                 cwd: executionCwd,
                 windowsHide: true,
@@ -208,7 +536,7 @@ export class UpgradeManager {
             });
             const timeoutTimer = setTimeout(() => {
                 child.kill();
-                const timeoutMsg = '升级命令执行超时（60 秒），可能是网络阻塞或包管理器锁占用，建议在终端手动执行升级。';
+                const timeoutMsg = '升级命令执行超时（60 秒），可能是网络阻塞或包管理器锁占用。可稍后重试一键升级，或点击「📋 复制命令」手动执行。';
                 this.lastResult = {
                     state: 'failed',
                     targetVersion,
@@ -238,47 +566,29 @@ export class UpgradeManager {
             });
             child.on('close', (code) => {
                 clearTimeout(timeoutTimer);
-                const completedAt = Date.now();
-                if (code === 0) {
-                    const successMsg = env.isDesktop
-                        ? `升级成功！已安装最新依赖 ${pkgWithVer} 到桌面版 Profile。需重启 DSH 桌面客户端彻底生效后端工具，或刷新当前界面。`
-                        : `升级成功！已安装最新依赖 ${pkgWithVer}。需重启 DSH 服务彻底生效后端工具，或刷新网页先体验新版界面。`;
-                    this.lastResult = {
-                        state: 'success',
-                        targetVersion,
-                        message: successMsg,
-                        completedAt,
-                        environment: env.isDesktop ? 'desktop' : 'web',
-                    };
-                    safeSettle({
+                // 级别 1 收尾也走实证校验（与级别 2 同一防线）：退出码 0 后读产物版本，
+                // 与目标不符即判失败——杜绝 dsh 命令静默未安装却报成功的假象。
+                this.finishUpgrade({ ok: code === 0 }, targetVersion, env, startedAt, executionCwd);
+                const finalResult = this.lastResult.state === 'success'
+                    ? {
                         ok: true,
-                        message: successMsg,
+                        message: this.lastResult.message || '升级成功',
                         needRestart: true,
                         environment: env.isDesktop ? 'desktop' : 'web',
                         log: this.logBuffer.join('\n'),
-                    });
-                }
-                else {
-                    const failedMsg = `升级退出码异常 (${code})，可能需要管理员权限或在宿主环境终端手动执行。`;
-                    this.lastResult = {
-                        state: 'failed',
-                        targetVersion,
-                        message: failedMsg,
-                        completedAt,
-                        environment: env.isDesktop ? 'desktop' : 'web',
-                    };
-                    safeSettle({
+                    }
+                    : {
                         ok: false,
-                        message: failedMsg,
+                        message: this.lastResult.message || `升级退出码异常 (${code})`,
                         needRestart: false,
                         environment: env.isDesktop ? 'desktop' : 'web',
                         log: this.logBuffer.join('\n'),
-                    });
-                }
+                    };
+                safeSettle(finalResult);
             });
             child.on('error', (err) => {
                 clearTimeout(timeoutTimer);
-                const errMsg = `无法启动安装子进程: ${err.message}`;
+                const errMsg = `升级失败：无法启动安装子进程（${err.message}）。可重试一键升级，或点击「📋 复制命令」手动执行。`;
                 this.lastResult = {
                     state: 'failed',
                     targetVersion,

package/lib/version.d.ts

@@ -6,7 +6,7 @@
  * 2. 避免在 ESM 运行时动态读取 package.json 引入 fs 权限和路径解析边界问题；
  * 3. 方便在 CI 发布流水线或 build 脚本中自动化校准。
  */
-export declare const CURRENT_PLUGIN_VERSION = "0.1.8";
+export declare const CURRENT_PLUGIN_VERSION = "0.2.1";
 export declare const PLUGIN_PACKAGE_NAME = "dsh-github-flow";
 export declare const NPM_PACKAGE_URL = "https://www.npmjs.com/package/dsh-github-flow";
 export declare const NPM_REGISTRY_MIRROR = "https://registry.npmmirror.com";

package/lib/version.js

@@ -6,7 +6,7 @@
  * 2. 避免在 ESM 运行时动态读取 package.json 引入 fs 权限和路径解析边界问题；
  * 3. 方便在 CI 发布流水线或 build 脚本中自动化校准。
  */
-export const CURRENT_PLUGIN_VERSION = '0.1.8';
+export const CURRENT_PLUGIN_VERSION = '0.2.1';
 export const PLUGIN_PACKAGE_NAME = 'dsh-github-flow';
 export const NPM_PACKAGE_URL = 'https://www.npmjs.com/package/dsh-github-flow';
 export const NPM_REGISTRY_MIRROR = 'https://registry.npmmirror.com';

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-github-flow",
-  "version": "0.1.8",
+  "version": "0.2.1",
   "icon": "icon.svg",
-  "description": "GitHub Flow: Native GitHub CLI (gh) integration for DeepSeek Harness — Agent Tools, Slash Commands, and Web UI Workspace",
+  "description": "GitHub 工作流引擎：为 DeepSeek Harness 提供原生 GitHub CLI (gh) 集成——9 大 Agent 领域工具（PR 审查合并、Issue 任务流转、CI 失败诊断、发版交付、密钥管理、Agent Skills 生态）、/gh 人类快捷指令、Web UI 全景驾驶舱与一键跨平台自动升级；零凭证侵入复用宿主机 gh 登录态，内置 Token 防溢出截断、高危操作二次确认与密文安全输入通道。",
   "type": "module",
   "main": "./lib/main.js",
   "repository": {
@@ -30,6 +30,7 @@
   ],
   "scripts": {
     "build": "tsc && node scripts/build.mjs",
+    "test": "node test/run-all.mjs",
     "prepare": "pnpm run build"
   },
   "dsh": {

package/lib/client/icons.d.ts

@@ -1,13 +0,0 @@
-/**
- * GitHub 官方高精度的 Invertocat 矢量路径
- */
-export declare const GITHUB_OCTOCAT_PATH = "M8 0C3.58 0 0 3.58 0 8C0 11.54 2.29 14.53 5.47 15.59C5.87 15.66 6.02 15.42 6.02 15.21C6.02 15.02 6.01 14.39 6.01 13.72C4 14.09 3.48 13.23 3.32 12.78C3.23 12.55 2.84 11.84 2.5 11.65C2.22 11.5 1.82 11.13 2.49 11.12C3.12 11.11 3.57 11.7 3.72 11.94C4.44 13.15 5.59 12.81 6.05 12.6C6.12 12.08 6.33 11.72 6.56 11.52C4.78 11.32 2.92 10.63 2.92 7.58C2.92 6.71 3.23 5.99 3.74 5.43C3.66 5.23 3.38 4.41 3.82 3.31C3.82 3.31 4.49 3.1 6.02 4.13C6.66 3.95 7.34 3.86 8.02 3.86C8.7 3.86 9.38 3.95 10.02 4.13C11.55 3.09 12.22 3.31 12.22 3.31C12.66 4.41 12.38 5.23 12.3 5.43C12.81 5.99 13.12 6.7 13.12 7.58C13.12 10.65 11.25 11.32 9.47 11.52C9.76 11.77 10.01 12.25 10.01 13C10.01 14.08 10 14.95 10 15.21C10 15.42 10.15 15.67 10.55 15.59C13.71 14.53 16 11.53 16 8C16 3.58 12.42 0 8 0Z";
-/**
- * 基础矢量 Logo
- */
-export declare function createOctocatSvg(size?: number, color?: string): any;
-/**
- * 现代暗黑科技感徽标 Artwork（用于卡片与主要入口）
- * 带有暗夜流光微渐变与精致白描
- */
-export declare function createOctocatBadge(size?: number): any;

package/lib/client/icons.js

@@ -1,41 +0,0 @@
-/**
- * GitHub 官方高精度的 Invertocat 矢量路径
- */
-export const GITHUB_OCTOCAT_PATH = "M8 0C3.58 0 0 3.58 0 8C0 11.54 2.29 14.53 5.47 15.59C5.87 15.66 6.02 15.42 6.02 15.21C6.02 15.02 6.01 14.39 6.01 13.72C4 14.09 3.48 13.23 3.32 12.78C3.23 12.55 2.84 11.84 2.5 11.65C2.22 11.5 1.82 11.13 2.49 11.12C3.12 11.11 3.57 11.7 3.72 11.94C4.44 13.15 5.59 12.81 6.05 12.6C6.12 12.08 6.33 11.72 6.56 11.52C4.78 11.32 2.92 10.63 2.92 7.58C2.92 6.71 3.23 5.99 3.74 5.43C3.66 5.23 3.38 4.41 3.82 3.31C3.82 3.31 4.49 3.1 6.02 4.13C6.66 3.95 7.34 3.86 8.02 3.86C8.7 3.86 9.38 3.95 10.02 4.13C11.55 3.09 12.22 3.31 12.22 3.31C12.66 4.41 12.38 5.23 12.3 5.43C12.81 5.99 13.12 6.7 13.12 7.58C13.12 10.65 11.25 11.32 9.47 11.52C9.76 11.77 10.01 12.25 10.01 13C10.01 14.08 10 14.95 10 15.21C10 15.42 10.15 15.67 10.55 15.59C13.71 14.53 16 11.53 16 8C16 3.58 12.42 0 8 0Z";
-/**
- * 基础矢量 Logo
- */
-export function createOctocatSvg(size = 18, color = "currentColor") {
-    return React.createElement("svg", {
-        viewBox: "0 0 16 16",
-        width: size,
-        height: size,
-        fill: color,
-        style: { flexShrink: 0, display: "inline-block", verticalAlign: "middle" }
-    }, React.createElement("path", {
-        fillRule: "evenodd",
-        clipRule: "evenodd",
-        d: GITHUB_OCTOCAT_PATH
-    }));
-}
-/**
- * 现代暗黑科技感徽标 Artwork（用于卡片与主要入口）
- * 带有暗夜流光微渐变与精致白描
- */
-export function createOctocatBadge(size = 36) {
-    var iconSize = Math.round(size * 0.58);
-    return React.createElement("div", {
-        style: {
-            display: "flex",
-            alignItems: "center",
-            justifyContent: "center",
-            width: `${size}px`,
-            height: `${size}px`,
-            borderRadius: "10px",
-            background: "linear-gradient(135deg, #2ea043 0%, #1f6feb 100%)", // GitHub 科技绿蓝微渐变
-            boxShadow: "0 2px 8px rgba(31, 111, 235, 0.25), inset 0 1px 0 rgba(255, 255, 255, 0.2)",
-            flexShrink: 0,
-            position: "relative"
-        }
-    }, createOctocatSvg(iconSize, "#ffffff"));
-}

package/lib/client/index.d.ts

@@ -1,3 +0,0 @@
-export declare const name = "dsh-github-flow";
-export declare const inject: readonly ['slots'];
-export declare function apply(ctx: any): void;

package/lib/client/index.js

@@ -1,36 +0,0 @@
-import { GITHUB_PANEL_CSS } from './style.js';
-import { createGithubPanelComponent } from './panel.js';
-export const name = 'dsh-github-flow';
-export const inject = ['slots'];
-export function apply(ctx) {
-    // 1. 注入样式
-    if (typeof styles !== 'undefined' && styles.insert) {
-        styles.insert(GITHUB_PANEL_CSS);
-    }
-    else if (typeof document !== 'undefined') {
-        const styleEl = document.createElement('style');
-        styleEl.textContent = GITHUB_PANEL_CSS;
-        document.head.appendChild(styleEl);
-    }
-    // 2. 侧边栏图标组件
-    function GithubSidebarIcon() {
-        return React.createElement('div', { className: 'dsh-github-icon', title: 'GitHub 工作台' }, React.createElement('svg', { viewBox: '0 0 16 16', width: 18, height: 18, fill: 'currentColor' }, React.createElement('path', {
-            d: 'M8 0c4.42 0 8 3.58 8 8a8.013 8.013 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02-.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27-.68 0-1.36.09-2 .27-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.28-.82 2.15 0 3.06 1.86 3.75 3.64 3.95-.23.2-.44.55-.51 1.07-.46.21-1.61.55-2.33-.66-.15-.24-.6-.83-1.23-.82-.67.01-.27.38.01.53.34.19.73.9.82 1.13.16.45.68 1.31 2.69.94 0 .67.01 1.3.01 1.49 0 .21-.15.45-.55.38A7.995 7.995 0 0 1 0 8c0-4.42 3.58-8 8-8Z',
-        })));
-    }
-    // 3. 注册到 sidebar.panellist（排在 schedules 自动任务后，workspaces 工作区前）
-    if (ctx.slots && typeof ctx.slots.register === 'function') {
-        ctx.slots.register({
-            slot: 'sidebar.panellist',
-            id: 'github',
-            order: 20,
-            label: 'GitHub',
-        }, GithubSidebarIcon);
-        // 4. 注册中央主视图（main slot, key: 'github'）
-        const GithubWorkspacePanel = createGithubPanelComponent();
-        ctx.slots.register({
-            slot: 'main',
-            key: 'github',
-        }, GithubWorkspacePanel);
-    }
-}

package/lib/client/panel.d.ts

@@ -1 +0,0 @@
-export declare function createGithubPanelComponent(): () => any;