dsh-github-flow 0.2.0 → 0.3.0

package/lib/updater.js

@@ -1,4 +1,64 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { CURRENT_PLUGIN_VERSION, PLUGIN_PACKAGE_NAME, NPM_PACKAGE_URL, NPM_REGISTRY_MIRROR, NPM_REGISTRY_OFFICIAL, } from './version.js';
+/**
+ * 检测当前 DSH 运行 profile 名（升级命令的 --profile 必填项，官方 CLI 语义：
+ * `dsh plugin --profile <name> add <pkg>` 在 profile 目录内转发给 pnpm）。
+ * 探测优先级（从权威到兜底，不瞎猜）：
+ * 1. DSH_PROFILE 环境变量——launcher 启动时固定注入（桌面版=desktop，
+ *    `dsh --profile web` 启动的 Web 版=web），是运行进程对自身 profile 的事实源；
+ * 2. DSH_PROFILE_DIR 路径含 desktop 时判定 desktop；
+ * 3. 兜底探测 ~/.dsh/profiles 下实际存在的 profile 目录（web > default 顺序），
+ *    两者皆无才回落 'default'（dsh CLI 的默认 profile 名）。
+ */
+export function detectProfileName() {
+    const profile = (process.env.DSH_PROFILE || '').trim();
+    if (profile)
+        return profile;
+    const dir = (process.env.DSH_PROFILE_DIR || '').trim().toLowerCase();
+    if (dir.includes('desktop'))
+        return 'desktop';
+    // 0.5 最可靠的事实源兜底：本插件模块必然安装在 <profile>/node_modules/ 下，
+    // 从自身 import.meta.url 逐级上溯找到 profiles/<name> 段即为当前 profile。
+    // 优先于目录枚举：即使机器上装了多个 profile 也能指认「正在运行的这一个」。
+    try {
+        let cur = path.dirname(fileURLToPath(import.meta.url));
+        for (let i = 0; i < 8; i++) {
+            const parent = path.dirname(cur);
+            if (path.basename(parent) === 'profiles' && parent !== cur) {
+                const name = path.basename(cur);
+                if (name && name !== 'node_modules')
+                    return name;
+            }
+            cur = parent;
+            if (!cur || cur === path.dirname(cur))
+                break;
+        }
+    }
+    catch { /* 非 file:// 上下文（理论不发生）继续走兜底 */ }
+    // 环境变量缺失（自定义启动方式）：按实际存在的 profile 目录兜底
+    try {
+        const profilesRoot = path.join(os.homedir(), '.dsh', 'profiles');
+        if (fs.existsSync(profilesRoot)) {
+            const names = fs.readdirSync(profilesRoot).filter((n) => {
+                try {
+                    return fs.statSync(path.join(profilesRoot, n)).isDirectory();
+                }
+                catch {
+                    return false;
+                }
+            });
+            if (names.includes('web'))
+                return 'web';
+            if (names.length > 0 && !names.includes('default'))
+                return names[0];
+        }
+    }
+    catch { /* 探测失败走最终兜底 */ }
+    return 'default';
+}
 /**
  * 极简语义化版本大小比较函数 (latest > current 时返回 true)
  *
@@ -43,12 +103,20 @@ export class UpdateChecker {
     inFlightPromise = null;
     intervalMs;
     customRegistry;
+    /** 配置总开关（checkUpdate: false 时的自动探测熔断），见 check() 内注释 */
+    enabled;
+    /**
+     * 当前更新源模式。null = 未初始化（走 legacy 双源竞速，兼容 store 不存在
+     * 且无 Cordis registryUrl 的老安装）；一旦 UI 保存过任何 mode 即为权威。
+     */
+    sourceMode = null;
     constructor(options = {}) {
         // 默认缓存 24 小时，杜绝高频击穿 npm
         this.intervalMs = typeof options.intervalMs === 'number' && options.intervalMs > 0
             ? options.intervalMs
             : 86_400_000;
         this.customRegistry = options.customRegistry;
+        this.enabled = options.enabled !== false;
     }
     /**
      * 应用代理到 npm 探测的 fetch 链路。
@@ -60,19 +128,39 @@ export class UpdateChecker {
             manager.applyFetchDispatcher();
     }
     /**
-     * 同步获取当前已知的版本状态（0ms 纯内存读取，绝不发外网请求）
+     * 运行时切换更新源（UI 保存即调用，无需插件 reload）。
+     * 为什么必须失效缓存：24h 缓存里存的是旧源的结果，用户切源后若不清缓存，
+     * 首次 check() 仍返回旧源的 latestVersion——用户感知「切换无效」。
+     * 'off' 与 enabled 熔断独立并存：enabled 来自 Cordis 静态配置（缺省 true），
+     * off 来自 UI 持久化设置；任一为「关」都熔断自动探测。
+     */
+    applySettings(mode) {
+        this.sourceMode = mode;
+        this.cachedInfo = null;
+        // 切换到 off 时，途中旧源的请求任其自然完成（结果已无人消费，无害）；
+        // 不 abort inFlightPromise：abort 会让并发等待方拿到异常，得不偿失。
+    }
+    /** 当前生效的更新源模式（供命令行/升级链路展示与对齐） */
+    getSourceMode() {
+        return this.sourceMode;
+    }
+    /**
+     * 同步获取当前已知的版本状态（0ms 纯内存读取，绝不发外网请求）。
+     * 兜底命令同样按当前 profile 生成：网络探测失败时复制命令也必须开箱可用。
      */
     getQuickStatus() {
         if (this.cachedInfo) {
             return this.cachedInfo;
         }
+        const profile = detectProfileName();
+        const primary = `dsh plugin --profile ${profile} add ${PLUGIN_PACKAGE_NAME}@latest`;
         return {
             currentVersion: CURRENT_PLUGIN_VERSION,
             hasUpdate: false,
-            upgradeCommand: `pnpm dsh plugin update ${PLUGIN_PACKAGE_NAME}`,
+            upgradeCommand: primary,
             allCommands: {
-                dshCli: `pnpm dsh plugin update ${PLUGIN_PACKAGE_NAME}`,
-                profile: `dsh plugin --profile default add ${PLUGIN_PACKAGE_NAME}@latest`,
+                dshCli: primary,
+                profile: primary,
                 pnpm: `pnpm add ${PLUGIN_PACKAGE_NAME}@latest`,
                 npm: `npm install -g ${PLUGIN_PACKAGE_NAME}@latest`,
             },
@@ -85,6 +173,14 @@ export class UpdateChecker {
      * @param force 是否忽略 24h 缓存强制穿透探测
      */
     async check(force = false) {
+        // 自动探测熔断（两个独立开关，任一为「关」即熔断）：
+        // 1. enabled=false：Cordis 静态配置 checkUpdate: false；
+        // 2. sourceMode='off'：UI「更新设置」选择了不检查更新。
+        // 熔断语义统一为「关自动提示，不关能力」：force（/gh upgrade、设置页保存后的
+        // 即时验证）与一键升级路由不经过此门——用户显式动作必须真探。
+        if ((!this.enabled || this.sourceMode === 'off') && !force) {
+            return this.getQuickStatus();
+        }
         const now = Date.now();
         // 1. 命中有效缓存直接返回
         if (!force && this.cachedInfo && now - this.cachedInfo.checkedAt < this.intervalMs) {
@@ -104,9 +200,17 @@ export class UpdateChecker {
      */
     async performCheck(now) {
         const fallback = this.getQuickStatus();
-        // 双通道策略：用户自定义源 > 国内淘宝镜像 (2.5s极速) > 官方 npmjs 源 (3.5s兜底)
+        // 端点选择：UI 保存的源模式为权威（单源严格不互备——静默回落另一源等于
+        // 背叛用户选择：镜像同步滞后正是选官方的理由，反之亦然）；无 UI 设置时
+        // 走 legacy 行为（自定义源 > 镜像竞速官方兜底）保持老安装兼容。
         const endpoints = [];
-        if (this.customRegistry) {
+        if (this.sourceMode === 'official') {
+            endpoints.push(`${NPM_REGISTRY_OFFICIAL}/${PLUGIN_PACKAGE_NAME}/latest`);
+        }
+        else if (this.sourceMode === 'mirror') {
+            endpoints.push(`${NPM_REGISTRY_MIRROR}/${PLUGIN_PACKAGE_NAME}/latest`);
+        }
+        else if (this.customRegistry) {
             endpoints.push(`${this.customRegistry.replace(/\/$/, '')}/${PLUGIN_PACKAGE_NAME}/latest`);
         }
         else {
@@ -150,14 +254,18 @@ export class UpdateChecker {
         }
         const hasUpdate = isNewerVersion(CURRENT_PLUGIN_VERSION, latestVersion);
         const targetPkg = `${PLUGIN_PACKAGE_NAME}@${latestVersion}`;
+        // 命令按真实 profile 生成（P1 修复）：dsh CLI 的 --profile 为必填项，
+        // 桌面端用户复制 'pnpm dsh plugin add ...' 会直接报 required option 错误。
+        const profile = detectProfileName();
+        const primary = `dsh plugin --profile ${profile} add ${targetPkg}`;
         this.cachedInfo = {
             currentVersion: CURRENT_PLUGIN_VERSION,
             latestVersion,
             hasUpdate,
-            upgradeCommand: `pnpm dsh plugin add ${targetPkg}`,
+            upgradeCommand: primary,
             allCommands: {
-                dshCli: `pnpm dsh plugin add ${targetPkg}`,
-                profile: `dsh plugin --profile default add ${targetPkg}`,
+                dshCli: primary,
+                profile: primary,
                 pnpm: `pnpm add ${targetPkg}`,
                 npm: `npm install -g ${targetPkg}`,
             },

package/lib/upgrade-manager.d.ts

@@ -10,7 +10,45 @@ import type { ProxyManager } from './proxy.js';
  * 3. 动态将当前 node 运行时所在目录 (path.dirname(process.execPath)) 及 Mac 常用包管理器路径注入 PATH 首端，
  *    彻底实现 macOS 与 Linux 环境下子进程对 npm / pnpm 命令的 100% 自愈发现。
  */
-export declare function buildCrossPlatformEnv(): NodeJS.ProcessEnv;
+export declare function buildCrossPlatformEnv(registryOverride?: string): NodeJS.ProcessEnv;
+/**
+ * 探测 dsh CLI 是否对当前进程可达（PATH 或已知安装位置）。
+ * 为什么必须预检：桌面端 GUI 启动时 dsh 常不在 PATH，旧实现用 '||' 兜底到
+ * `npm install -g`——装到全局对 profile 依赖毫无作用，表现为「一键升级无效果」
+ * 的静默失败。预检不可达时直接给出带完整命令的明确指引，宁可见失败不可假成功。
+ */
+export declare function probeDshCliAvailable(env: NodeJS.ProcessEnv): Promise<{
+    ok: boolean;
+    hint?: string;
+}>;
+/**
+ * 定位桌面版自带的 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 declare function locateBundledPnpm(): string | null;
+/**
+ * 读取 profile 中已实际安装的本插件版本（实证校验的事实源）。
+ * 读不到（目录不存在/无产物/JSON 损坏）返回 null——调用方据此决定是否放行：
+ * 无法证伪时不在成功文案里虚报版本号，但不阻断（避免文件系统受限环境下误杀真成功）。
+ */
+export declare function readInstalledVersion(profileDir?: string): string | null;
+/**
+ * 把插件包名补写进 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 declare function ensureBundleListed(profileDir: string, pkgName: string): {
+    ok: boolean;
+    error?: string;
+};
 /**
  * 自动升级执行引擎
  *
@@ -27,7 +65,18 @@ export declare class UpgradeManager {
     private logBuffer;
     /** 代理管理器（可选）：注入后一键升级的 npm/pnpm 子进程走用户代理 */
     private proxyManager?;
+    /** 更新源模式查询（可选）：一键升级的 NPM_CONFIG_REGISTRY 跟随用户在设置页选择的源 */
+    private getUpdateMode;
     attachProxyManager(manager: ProxyManager): void;
+    /** 注入更新源查询函数（而非静态值）：用户切换源后无需重新装配即实时生效 */
+    attachUpdateModeQuery(query: () => 'official' | 'mirror' | 'off' | null): void;
+    /**
+     * 按当前更新源推导 NPM_CONFIG_REGISTRY。
+     * 为什么跟随源而非写死：用户选官方源的理由（镜像同步滞后）对安装同样成立——
+     * 选镜像源装的可能是旧版。off 模式下一键升级仍可用（关提示不关能力），
+     * 其 registry 落官方源（能力路径取最权威的源）。
+     */
+    private resolveRegistry;
     /**
      * 探测当前插件是否是以本地 Git 源码软链接方式运行
      */
@@ -51,6 +100,26 @@ export declare class UpgradeManager {
      * 获取当前升级状态
      */
     getStatus(): UpgradeStatusResult;
+    /**
+     * 级别 2 降级路径：直调桌面版自带 pnpm 安装包（execFile 数组参数隔离，无 shell）。
+     * 输出与退出码经回调上抛，由调用方决定 bundles 补写与状态机收尾。
+     */
+    private runPnpmDirect;
+    /**
+     * 升级结果统一收尾（状态机 + 互斥锁复位）。级别 1/级别 2 共用，
+     * 保证 lastResult、isUpgrading、返回文案的形态完全一致。
+     *
+     * 关键防线一：退出码 0 ≠ 安装成功。本函数在退出码为 0 时再做一次实证校验——
+     * 读 profile 的 node_modules/<pkg>/package.json 实际版本，与目标版本比对。
+     * 不匹配（网络劫持返回空产物、registry 异常静默跳过安装、包管理器缓存错乱
+     * 等场景）一律判失败并如实报「实际安装版本」，绝不把没装上说成装好了。
+     *
+     * 关键防线二：失败文案不内嵌完整命令。前端升级卡片常驻「📋 复制命令」按钮
+     * （复制的命令已按当前 profile 生成），文字里贴长命令既让用户手动描选困难、
+     * 也无法区分 Web/桌面环境谁敲得了终端。文案只引导按钮 + 按环境给可行出路：
+     * 桌面版未注册 CLI 的用户走官方「管理 dsh 命令」菜单，其余走复制命令。
+     */
+    private finishUpgrade;
     /**
      * 执行一键升级核心流程
      */