dsh-github-flow 0.1.7 → 0.2.0

package/lib/updater.js

@@ -0,0 +1,169 @@
+import { CURRENT_PLUGIN_VERSION, PLUGIN_PACKAGE_NAME, NPM_PACKAGE_URL, NPM_REGISTRY_MIRROR, NPM_REGISTRY_OFFICIAL, } from './version.js';
+/**
+ * 极简语义化版本大小比较函数 (latest > current 时返回 true)
+ *
+ * 为什么自研而不引入 semver npm 依赖：
+ * 避免为了简单的 x.y.z 比对而引入数十个传递子依赖，保持 DSH 插件轻量纯净与零运行期依赖负担。
+ * 约束条件：标准处理 x.y.z 形式，自动过滤前导 'v' 或 '^' 等非数字字符，忽略 pre-release 标签后续对比。
+ */
+export function isNewerVersion(current, latest) {
+    if (!current || !latest)
+        return false;
+    const parseParts = (v) => {
+        return v
+            .replace(/^[^\d]*/, '')
+            .split('-')[0]
+            .split('.')
+            .map((part) => parseInt(part, 10) || 0);
+    };
+    const cParts = parseParts(current);
+    const lParts = parseParts(latest);
+    const len = Math.max(cParts.length, lParts.length, 3);
+    for (let i = 0; i < len; i++) {
+        const c = cParts[i] ?? 0;
+        const l = lParts[i] ?? 0;
+        if (l > c)
+            return true;
+        if (l < c)
+            return false;
+    }
+    return false;
+}
+/**
+ * 插件版本检测引擎
+ *
+ * 架构约束与为什么这样设计：
+ * 1. 业务解耦：getQuickStatus 同步读取内存缓存，耗时 0ms，供主业务路由无感调用；
+ * 2. 闲时触发：check() 异步外网探测，首选淘宝镜像加速 (npmmirror.com)，官方 npmjs 兜底；
+ * 3. 避免击穿：通过 inFlightPromise 合并并发调用，防止多处同时触发重复请求；
+ * 4. 彻底容灾：任何网络或解析异常 100% 内部吸收，返回 hasUpdate: false，绝不影响主流程。
+ */
+export class UpdateChecker {
+    cachedInfo = null;
+    inFlightPromise = null;
+    intervalMs;
+    customRegistry;
+    constructor(options = {}) {
+        // 默认缓存 24 小时，杜绝高频击穿 npm
+        this.intervalMs = typeof options.intervalMs === 'number' && options.intervalMs > 0
+            ? options.intervalMs
+            : 86_400_000;
+        this.customRegistry = options.customRegistry;
+    }
+    /**
+     * 应用代理到 npm 探测的 fetch 链路。
+     * 由 main.ts 在 ProxyManager 初始化/变更后调用：undici dispatcher 是进程级全局，
+     * 这里只做一次转发，真正的缓存/重建逻辑在 ProxyManager.applyFetchDispatcher 内。
+     */
+    applyProxy(manager) {
+        if (manager)
+            manager.applyFetchDispatcher();
+    }
+    /**
+     * 同步获取当前已知的版本状态（0ms 纯内存读取，绝不发外网请求）
+     */
+    getQuickStatus() {
+        if (this.cachedInfo) {
+            return this.cachedInfo;
+        }
+        return {
+            currentVersion: CURRENT_PLUGIN_VERSION,
+            hasUpdate: false,
+            upgradeCommand: `pnpm dsh plugin update ${PLUGIN_PACKAGE_NAME}`,
+            allCommands: {
+                dshCli: `pnpm dsh plugin update ${PLUGIN_PACKAGE_NAME}`,
+                profile: `dsh plugin --profile default add ${PLUGIN_PACKAGE_NAME}@latest`,
+                pnpm: `pnpm add ${PLUGIN_PACKAGE_NAME}@latest`,
+                npm: `npm install -g ${PLUGIN_PACKAGE_NAME}@latest`,
+            },
+            releaseNotesUrl: `${NPM_PACKAGE_URL}?activeTab=versions`,
+            checkedAt: 0,
+        };
+    }
+    /**
+     * 异步触发版本检测
+     * @param force 是否忽略 24h 缓存强制穿透探测
+     */
+    async check(force = false) {
+        const now = Date.now();
+        // 1. 命中有效缓存直接返回
+        if (!force && this.cachedInfo && now - this.cachedInfo.checkedAt < this.intervalMs) {
+            return this.cachedInfo;
+        }
+        // 2. 复用正在途中的网络请求，避免并发重复打 npm
+        if (this.inFlightPromise) {
+            return this.inFlightPromise;
+        }
+        this.inFlightPromise = this.performCheck(now).finally(() => {
+            this.inFlightPromise = null;
+        });
+        return this.inFlightPromise;
+    }
+    /**
+     * 内部双 Registry 竞速/降级探测
+     */
+    async performCheck(now) {
+        const fallback = this.getQuickStatus();
+        // 双通道策略：用户自定义源 > 国内淘宝镜像 (2.5s极速) > 官方 npmjs 源 (3.5s兜底)
+        const endpoints = [];
+        if (this.customRegistry) {
+            endpoints.push(`${this.customRegistry.replace(/\/$/, '')}/${PLUGIN_PACKAGE_NAME}/latest`);
+        }
+        else {
+            endpoints.push(`${NPM_REGISTRY_MIRROR}/${PLUGIN_PACKAGE_NAME}/latest`);
+            endpoints.push(`${NPM_REGISTRY_OFFICIAL}/${PLUGIN_PACKAGE_NAME}/latest`);
+        }
+        let latestVersion = null;
+        for (const url of endpoints) {
+            try {
+                const isMirror = url.includes('npmmirror');
+                const timeoutMs = isMirror ? 2_500 : 3_500;
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), timeoutMs);
+                const res = await fetch(url, {
+                    signal: controller.signal,
+                    headers: {
+                        'Accept': 'application/json',
+                        'User-Agent': `dsh-plugin-updater/${CURRENT_PLUGIN_VERSION}`,
+                    },
+                });
+                clearTimeout(timer);
+                if (res.ok) {
+                    const json = (await res.json());
+                    if (json && typeof json.version === 'string' && json.version.trim()) {
+                        latestVersion = json.version.trim();
+                        break;
+                    }
+                }
+            }
+            catch {
+                // 单个源故障静默尝试下一个备用源，确保高可用
+            }
+        }
+        // 若双源均未拉取到版本，保留保底数据并记录时间戳，防止密集重试
+        if (!latestVersion) {
+            this.cachedInfo = {
+                ...fallback,
+                checkedAt: now,
+            };
+            return this.cachedInfo;
+        }
+        const hasUpdate = isNewerVersion(CURRENT_PLUGIN_VERSION, latestVersion);
+        const targetPkg = `${PLUGIN_PACKAGE_NAME}@${latestVersion}`;
+        this.cachedInfo = {
+            currentVersion: CURRENT_PLUGIN_VERSION,
+            latestVersion,
+            hasUpdate,
+            upgradeCommand: `pnpm dsh plugin add ${targetPkg}`,
+            allCommands: {
+                dshCli: `pnpm dsh plugin add ${targetPkg}`,
+                profile: `dsh plugin --profile default add ${targetPkg}`,
+                pnpm: `pnpm add ${targetPkg}`,
+                npm: `npm install -g ${targetPkg}`,
+            },
+            releaseNotesUrl: `${NPM_PACKAGE_URL}?activeTab=versions`,
+            checkedAt: now,
+        };
+        return this.cachedInfo;
+    }
+}

package/lib/upgrade-manager.d.ts

@@ -0,0 +1,58 @@
+import type { UpgradeExecutionResult, UpgradeStatusResult } from './types.js';
+import type { ProxyManager } from './proxy.js';
+/**
+ * 构建跨平台环境自愈增强的 ProcessEnv (重点解决 macOS GUI 应用丢失 PATH 的痛点)
+ *
+ * 为什么必须这样做：
+ * 1. 在 macOS 系统上，若 DSH 桌面客户端由 Finder / Dock / Spotlight (GUI) 启动，进程默认只继承
+ *    极简系统 PATH (/usr/bin:/bin:/usr/sbin:/sbin)，不会自动读取用户 shell 配置文件 (~/.zshrc, ~/.bash_profile)；
+ * 2. 用户通过 Homebrew (/opt/homebrew/bin 或 /usr/local/bin) 或 nvm 安装的 node、npm、pnpm 默认在 GUI 下不可见；
+ * 3. 动态将当前 node 运行时所在目录 (path.dirname(process.execPath)) 及 Mac 常用包管理器路径注入 PATH 首端，
+ *    彻底实现 macOS 与 Linux 环境下子进程对 npm / pnpm 命令的 100% 自愈发现。
+ */
+export declare function buildCrossPlatformEnv(): NodeJS.ProcessEnv;
+/**
+ * 自动升级执行引擎
+ *
+ * 核心设计考量与约束条件：
+ * 1. 互斥保护 (Mutex)：同一时刻仅允许一个升级任务执行，防止用户连击或并发请求击垮包管理器 lockfile；
+ * 2. 环境自省 (Dev-Link Safe)：检测是否在本地源码工作区调试，若是则阻断自动覆盖，保护源码不被破坏；
+ * 3. 跨平台兼容 (macOS / Windows / Linux)：自动适配 cmd.exe 与 sh/zsh，自愈补全 macOS PATH 变量；
+ * 4. 稳态超时：设置 60s 进程上限，杜绝子进程因网络悬挂死锁宿主 WebServer；
+ * 5. 重启指引：Node.js 运行时内存不可变，升级成功后明确要求重启 DSH 彻底加载最新后端能力。
+ */
+export declare class UpgradeManager {
+    private isUpgrading;
+    private lastResult;
+    private logBuffer;
+    /** 代理管理器（可选）：注入后一键升级的 npm/pnpm 子进程走用户代理 */
+    private proxyManager?;
+    attachProxyManager(manager: ProxyManager): void;
+    /**
+     * 探测当前插件是否是以本地 Git 源码软链接方式运行
+     */
+    isDevLinked(): boolean;
+    /**
+     * 智能识别当前 DSH 运行环境 (桌面版 vs Web/CLI 版)
+     *
+     * 依据事实源：
+     * 1. 桌面版启动时会固定注入 DSH_PROFILE=desktop 与 DSH_PROFILE_DIR (~/.dsh/profiles/desktop)；
+     * 2. Web版/CLI版通常 DSH_PROFILE 为 default 或自定义工作区 profile；
+     * 3. 跨平台支持：通过 os.homedir() 安全解析 ~/.dsh 目录。
+     */
+    detectEnvironment(): {
+        isDesktop: boolean;
+        profile: string;
+        profileDir?: string;
+        isDevLinked: boolean;
+        platform: NodeJS.Platform;
+    };
+    /**
+     * 获取当前升级状态
+     */
+    getStatus(): UpgradeStatusResult;
+    /**
+     * 执行一键升级核心流程
+     */
+    executeUpgrade(targetVersion?: string): Promise<UpgradeExecutionResult>;
+}

package/lib/upgrade-manager.js

@@ -0,0 +1,309 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { PLUGIN_PACKAGE_NAME } from './version.js';
+/**
+ * 构建跨平台环境自愈增强的 ProcessEnv (重点解决 macOS GUI 应用丢失 PATH 的痛点)
+ *
+ * 为什么必须这样做：
+ * 1. 在 macOS 系统上，若 DSH 桌面客户端由 Finder / Dock / Spotlight (GUI) 启动，进程默认只继承
+ *    极简系统 PATH (/usr/bin:/bin:/usr/sbin:/sbin)，不会自动读取用户 shell 配置文件 (~/.zshrc, ~/.bash_profile)；
+ * 2. 用户通过 Homebrew (/opt/homebrew/bin 或 /usr/local/bin) 或 nvm 安装的 node、npm、pnpm 默认在 GUI 下不可见；
+ * 3. 动态将当前 node 运行时所在目录 (path.dirname(process.execPath)) 及 Mac 常用包管理器路径注入 PATH 首端，
+ *    彻底实现 macOS 与 Linux 环境下子进程对 npm / pnpm 命令的 100% 自愈发现。
+ */
+export function buildCrossPlatformEnv() {
+    const currentPath = process.env.PATH || '';
+    const extraPaths = [];
+    const isMac = process.platform === 'darwin';
+    const isWin = process.platform === 'win32';
+    // 1. 当前正在运行的 node 自身二进制文件所在目录（最优先，必然有配套 npm）
+    if (process.execPath) {
+        try {
+            extraPaths.push(path.dirname(process.execPath));
+        }
+        catch { }
+    }
+    // 2. macOS 专有软件与包管理器安装路径
+    if (isMac) {
+        extraPaths.push('/opt/homebrew/bin'); // Apple Silicon Homebrew
+        extraPaths.push('/opt/homebrew/sbin');
+        extraPaths.push('/usr/local/bin'); // Intel Mac Homebrew
+        extraPaths.push('/usr/local/sbin');
+        extraPaths.push(path.join(os.homedir(), '.local/bin'));
+        extraPaths.push(path.join(os.homedir(), 'Library/pnpm'));
+        extraPaths.push(path.join(os.homedir(), '.nvm/current/bin'));
+    }
+    // 3. Linux 专有常见路径
+    if (process.platform === 'linux') {
+        extraPaths.push('/usr/local/bin');
+        extraPaths.push('/home/linuxbrew/.linuxbrew/bin');
+        extraPaths.push(path.join(os.homedir(), '.local/bin'));
+    }
+    const separator = isWin ? ';' : ':';
+    const uniquePaths = Array.from(new Set([...extraPaths, ...currentPath.split(separator)])).filter(Boolean);
+    return {
+        ...process.env,
+        PATH: uniquePaths.join(separator),
+        NPM_CONFIG_REGISTRY: 'https://registry.npmmirror.com', // 优先国内源加速
+        LANG: 'zh_CN.UTF-8',
+        LC_ALL: 'zh_CN.UTF-8',
+    };
+}
+/**
+ * 自动升级执行引擎
+ *
+ * 核心设计考量与约束条件：
+ * 1. 互斥保护 (Mutex)：同一时刻仅允许一个升级任务执行，防止用户连击或并发请求击垮包管理器 lockfile；
+ * 2. 环境自省 (Dev-Link Safe)：检测是否在本地源码工作区调试，若是则阻断自动覆盖，保护源码不被破坏；
+ * 3. 跨平台兼容 (macOS / Windows / Linux)：自动适配 cmd.exe 与 sh/zsh，自愈补全 macOS PATH 变量；
+ * 4. 稳态超时：设置 60s 进程上限，杜绝子进程因网络悬挂死锁宿主 WebServer；
+ * 5. 重启指引：Node.js 运行时内存不可变，升级成功后明确要求重启 DSH 彻底加载最新后端能力。
+ */
+export class UpgradeManager {
+    isUpgrading = false;
+    lastResult = {
+        state: 'idle',
+    };
+    logBuffer = [];
+    /** 代理管理器（可选）：注入后一键升级的 npm/pnpm 子进程走用户代理 */
+    proxyManager;
+    attachProxyManager(manager) {
+        this.proxyManager = manager;
+    }
+    /**
+     * 探测当前插件是否是以本地 Git 源码软链接方式运行
+     */
+    isDevLinked() {
+        try {
+            const currentDir = path.dirname(fileURLToPath(import.meta.url));
+            const isInsideNodeModules = currentDir.includes('node_modules');
+            // 检查上级或同级是否存在 .git 目录
+            const gitDirParent = path.resolve(currentDir, '../.git');
+            const gitDirRoot = path.resolve(currentDir, '../../.git');
+            const hasGit = fs.existsSync(gitDirParent) || fs.existsSync(gitDirRoot);
+            return !isInsideNodeModules && hasGit;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 智能识别当前 DSH 运行环境 (桌面版 vs Web/CLI 版)
+     *
+     * 依据事实源：
+     * 1. 桌面版启动时会固定注入 DSH_PROFILE=desktop 与 DSH_PROFILE_DIR (~/.dsh/profiles/desktop)；
+     * 2. Web版/CLI版通常 DSH_PROFILE 为 default 或自定义工作区 profile；
+     * 3. 跨平台支持：通过 os.homedir() 安全解析 ~/.dsh 目录。
+     */
+    detectEnvironment() {
+        const profile = (process.env.DSH_PROFILE || '').trim();
+        const profileDir = (process.env.DSH_PROFILE_DIR || '').trim();
+        const isDesktop = profile === 'desktop' || profileDir.toLowerCase().includes('desktop');
+        const isDevLinked = this.isDevLinked();
+        const platform = process.platform;
+        return {
+            isDesktop,
+            profile: profile || 'default',
+            profileDir: profileDir || undefined,
+            isDevLinked,
+            platform,
+        };
+    }
+    /**
+     * 获取当前升级状态
+     */
+    getStatus() {
+        const env = this.detectEnvironment();
+        return {
+            ...this.lastResult,
+            environment: env.isDesktop ? 'desktop' : 'web',
+            log: this.logBuffer.join('\n'),
+        };
+    }
+    /**
+     * 执行一键升级核心流程
+     */
+    async executeUpgrade(targetVersion) {
+        const env = this.detectEnvironment();
+        if (this.isUpgrading) {
+            return {
+                ok: false,
+                message: '升级任务已在进行中，请勿重复点击。',
+                needRestart: false,
+                environment: env.isDesktop ? 'desktop' : 'web',
+                log: this.logBuffer.join('\n'),
+            };
+        }
+        if (env.isDevLinked) {
+            const devMsg = '检测到当前插件正在以本地 Git 源码软链接模式 (link:) 运行，请在源码目录执行 git pull 更新，已自动阻止 npm 覆盖以保护工作区代码。';
+            this.lastResult = {
+                state: 'failed',
+                targetVersion,
+                message: devMsg,
+                completedAt: Date.now(),
+                environment: env.isDesktop ? 'desktop' : 'web',
+            };
+            return {
+                ok: false,
+                message: devMsg,
+                needRestart: false,
+                environment: env.isDesktop ? 'desktop' : 'web',
+                log: 'Operation blocked by dev-linked protection.',
+            };
+        }
+        this.isUpgrading = true;
+        this.logBuffer = [];
+        const startedAt = Date.now();
+        const pkgWithVer = targetVersion ? `${PLUGIN_PACKAGE_NAME}@${targetVersion}` : `${PLUGIN_PACKAGE_NAME}@latest`;
+        this.lastResult = {
+            state: 'upgrading',
+            targetVersion,
+            message: `正在执行命令拉取 ${pkgWithVer}...`,
+            startedAt,
+            environment: env.isDesktop ? 'desktop' : 'web',
+        };
+        return new Promise((resolve) => {
+            const isWin = process.platform === 'win32';
+            let command = '';
+            let executionCwd = process.cwd();
+            // 根据环境类型分流升级指令（跨平台安全路径）：
+            if (env.isDesktop) {
+                // 场景 A：DSH 桌面版环境（macOS / Windows / Linux 桌面端通用）
+                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}`;
+                }
+            }
+            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}`;
+            }
+            // 跨平台 Shell 选型与参数调度：
+            // - Windows: 采用 cmd.exe (/d /s /c)，完美原生支持 '||' 且冷启动仅 ~10ms，规避 powershell 5.1 语法报错；
+            // - macOS / Linux: 优先采用用户的 SHELL (/bin/zsh 或 /bin/bash)，兜底 /bin/sh，参数为 -c。
+            const shell = isWin
+                ? (process.env.ComSpec || 'cmd.exe')
+                : (process.env.SHELL || '/bin/sh');
+            const args = isWin
+                ? ['/d', '/s', '/c', command]
+                : ['-c', command];
+            let settled = false;
+            const safeSettle = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                this.isUpgrading = false;
+                resolve(result);
+            };
+            // 注入跨平台增强环境（尤其治愈 macOS GUI 启动丢失 PATH 的痛点）
+            // 代理环境变量按 applyToPackageManager 开关合并：npm/pnpm 遵循 HTTPS_PROXY，
+            // 与 gh 链路同一管理器，保证「设置代理后升级也走代理」的体验一致性。
+            const childEnv = {
+                ...buildCrossPlatformEnv(),
+                ...(this.proxyManager?.getEnv('package-manager') || {}),
+            };
+            const child = spawn(shell, args, {
+                cwd: executionCwd,
+                windowsHide: true,
+                env: childEnv,
+            });
+            const timeoutTimer = setTimeout(() => {
+                child.kill();
+                const timeoutMsg = '升级命令执行超时（60 秒），可能是网络阻塞或包管理器锁占用，建议在终端手动执行升级。';
+                this.lastResult = {
+                    state: 'failed',
+                    targetVersion,
+                    message: timeoutMsg,
+                    completedAt: Date.now(),
+                    environment: env.isDesktop ? 'desktop' : 'web',
+                };
+                safeSettle({
+                    ok: false,
+                    message: timeoutMsg,
+                    needRestart: false,
+                    environment: env.isDesktop ? 'desktop' : 'web',
+                    log: this.logBuffer.join('\n'),
+                });
+            }, 60_000);
+            child.stdout?.on('data', (chunk) => {
+                const text = chunk.toString();
+                this.logBuffer.push(text);
+                if (this.logBuffer.length > 200)
+                    this.logBuffer.shift();
+            });
+            child.stderr?.on('data', (chunk) => {
+                const text = chunk.toString();
+                this.logBuffer.push(text);
+                if (this.logBuffer.length > 200)
+                    this.logBuffer.shift();
+            });
+            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({
+                        ok: true,
+                        message: successMsg,
+                        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,
+                        needRestart: false,
+                        environment: env.isDesktop ? 'desktop' : 'web',
+                        log: this.logBuffer.join('\n'),
+                    });
+                }
+            });
+            child.on('error', (err) => {
+                clearTimeout(timeoutTimer);
+                const errMsg = `无法启动安装子进程: ${err.message}`;
+                this.lastResult = {
+                    state: 'failed',
+                    targetVersion,
+                    message: errMsg,
+                    completedAt: Date.now(),
+                    environment: env.isDesktop ? 'desktop' : 'web',
+                };
+                safeSettle({
+                    ok: false,
+                    message: errMsg,
+                    needRestart: false,
+                    environment: env.isDesktop ? 'desktop' : 'web',
+                    log: this.logBuffer.join('\n'),
+                });
+            });
+        });
+    }
+}

package/lib/version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 插件版本与元数据模块
+ *
+ * 为什么独立为此文件：
+ * 1. 运行时需要精确获知自身当前安装版本与包标识，避免硬编码分散在各业务模块；
+ * 2. 避免在 ESM 运行时动态读取 package.json 引入 fs 权限和路径解析边界问题；
+ * 3. 方便在 CI 发布流水线或 build 脚本中自动化校准。
+ */
+export declare const CURRENT_PLUGIN_VERSION = "0.1.8";
+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";
+export declare const NPM_REGISTRY_OFFICIAL = "https://registry.npmjs.org";

package/lib/version.js

@@ -0,0 +1,13 @@
+/**
+ * 插件版本与元数据模块
+ *
+ * 为什么独立为此文件：
+ * 1. 运行时需要精确获知自身当前安装版本与包标识，避免硬编码分散在各业务模块；
+ * 2. 避免在 ESM 运行时动态读取 package.json 引入 fs 权限和路径解析边界问题；
+ * 3. 方便在 CI 发布流水线或 build 脚本中自动化校准。
+ */
+export const CURRENT_PLUGIN_VERSION = '0.1.8';
+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';
+export const NPM_REGISTRY_OFFICIAL = 'https://registry.npmjs.org';

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-github-flow",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "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;