dsh-github-flow 0.1.6 → 0.1.8

package/lib/types.d.ts

@@ -14,10 +14,18 @@ export interface PluginConfig {
     cacheTtlMs?: number;
     /** 查询列表默认限制条数，默认 20 */
     defaultListLimit?: number;
+    /** 是否开启新版本自动检查提示，默认 true */
+    checkUpdate?: boolean;
+    /** 检查更新间隔毫秒数，默认 86,400,000 (24小时) */
+    updateCheckIntervalMs?: number;
+    /** 自定义 npm Registry 镜像地址，留空则自动选用 npmmirror 与 npmjs */
+    registryUrl?: string;
 }
 export interface GhExecutionOptions {
     /** 命令执行的工作目录，优先使用当前 Agent 会话所在的 Workspace 物理路径 */
     cwd?: string;
+    /** 当前调用的会话 ID，用于精确关联物理工作区路径 */
+    sessionId?: string;
     /** 进程超时限制（毫秒），默认 30,000ms */
     timeoutMs?: number;
     /** 附加环境变量 */
@@ -86,6 +94,19 @@ export interface PrItem {
     url: string;
     updatedAt: string;
 }
+/**
+ * Issue 分类维度契约：
+ * - reported: 用户提起的（他人向我名下项目或本仓库提交的 Issue 反馈）
+ * - assigned: 分配给我的（指派给当前账号的待办任务，跨仓库通用）
+ * - created: 我创建的（由当前账号亲自发起的 Issue）
+ */
+export type IssueCategory = 'reported' | 'assigned' | 'created';
+export interface IssueStats {
+    total: number;
+    reported: number;
+    assigned: number;
+    created: number;
+}
 export interface IssueItem {
     number: number;
     title: string;
@@ -102,6 +123,8 @@ export interface IssueItem {
     }>;
     url: string;
     updatedAt: string;
+    /** 命中的所有身份分类 */
+    categories?: IssueCategory[];
 }
 export interface WorkflowRunItem {
     databaseId: number;
@@ -118,9 +141,12 @@ export interface GitHubOverviewData {
     repo?: RepoMetadata;
     pullRequests: PrItem[];
     issues: IssueItem[];
+    issueStats?: IssueStats;
     runs: WorkflowRunItem[];
     lastUpdated: string;
     error?: string;
+    /** 插件版本与升级信息（由内存缓存快速读取，不阻塞首屏业务） */
+    updateInfo?: UpdateInfo;
 }
 export interface UserRepoItem {
     name: string;
@@ -140,6 +166,28 @@ export interface WorkspaceMatrixItem {
     repo?: RepoMetadata;
     sessionCount: number;
 }
+export interface GlobalIssueItem {
+    number: number;
+    title: string;
+    repository: {
+        name?: string;
+        nameWithOwner: string;
+    };
+    author?: {
+        login: string;
+    };
+    assignees?: Array<{
+        login: string;
+    }>;
+    labels?: Array<{
+        name: string;
+        color: string;
+    }>;
+    url: string;
+    updatedAt: string;
+    state?: 'OPEN' | 'CLOSED';
+    categories: IssueCategory[];
+}
 export interface GlobalOverviewData {
     auth: AuthStatus;
     userRepos: UserRepoItem[];
@@ -153,17 +201,47 @@ export interface GlobalOverviewData {
         url: string;
         updatedAt: string;
     }>;
-    myIssues: Array<{
-        number: number;
-        title: string;
-        repository: {
-            nameWithOwner: string;
-        };
-        url: string;
-        updatedAt: string;
-    }>;
+    myIssues: GlobalIssueItem[];
+    issueStats?: IssueStats;
     lastUpdated: string;
     error?: string;
     /** 工作区矩阵读取失败的原因。区分「没有工作区」与「读不到工作区」，避免把故障显示成空状态 */
     workspaceError?: string;
+    /** 插件版本与升级信息（由内存缓存快速读取，不阻塞首屏业务） */
+    updateInfo?: UpdateInfo;
+}
+/**
+ * 插件版本检查信息
+ */
+export interface UpdateInfo {
+    currentVersion: string;
+    latestVersion?: string;
+    hasUpdate: boolean;
+    upgradeCommand: string;
+    allCommands: {
+        dshCli: string;
+        profile: string;
+        pnpm: string;
+        npm: string;
+    };
+    releaseNotesUrl: string;
+    checkedAt: number;
+}
+export type UpgradeState = 'idle' | 'upgrading' | 'success' | 'failed';
+export interface UpgradeStatusResult {
+    state: UpgradeState;
+    targetVersion?: string;
+    message?: string;
+    log?: string;
+    startedAt?: number;
+    completedAt?: number;
+    /** 识别到的宿主环境类型：desktop 为桌面版，web 为网页/CLI版 */
+    environment?: 'desktop' | 'web';
+}
+export interface UpgradeExecutionResult {
+    ok: boolean;
+    message: string;
+    needRestart: boolean;
+    log?: string;
+    environment?: 'desktop' | 'web';
 }

package/lib/updater.d.ts

@@ -0,0 +1,41 @@
+import type { UpdateInfo } from './types.js';
+/**
+ * 极简语义化版本大小比较函数 (latest > current 时返回 true)
+ *
+ * 为什么自研而不引入 semver npm 依赖：
+ * 避免为了简单的 x.y.z 比对而引入数十个传递子依赖，保持 DSH 插件轻量纯净与零运行期依赖负担。
+ * 约束条件：标准处理 x.y.z 形式，自动过滤前导 'v' 或 '^' 等非数字字符，忽略 pre-release 标签后续对比。
+ */
+export declare function isNewerVersion(current: string, latest: string): boolean;
+/**
+ * 插件版本检测引擎
+ *
+ * 架构约束与为什么这样设计：
+ * 1. 业务解耦：getQuickStatus 同步读取内存缓存，耗时 0ms，供主业务路由无感调用；
+ * 2. 闲时触发：check() 异步外网探测，首选淘宝镜像加速 (npmmirror.com)，官方 npmjs 兜底；
+ * 3. 避免击穿：通过 inFlightPromise 合并并发调用，防止多处同时触发重复请求；
+ * 4. 彻底容灾：任何网络或解析异常 100% 内部吸收，返回 hasUpdate: false，绝不影响主流程。
+ */
+export declare class UpdateChecker {
+    private cachedInfo;
+    private inFlightPromise;
+    private readonly intervalMs;
+    private readonly customRegistry?;
+    constructor(options?: {
+        intervalMs?: number;
+        customRegistry?: string;
+    });
+    /**
+     * 同步获取当前已知的版本状态（0ms 纯内存读取，绝不发外网请求）
+     */
+    getQuickStatus(): UpdateInfo;
+    /**
+     * 异步触发版本检测
+     * @param force 是否忽略 24h 缓存强制穿透探测
+     */
+    check(force?: boolean): Promise<UpdateInfo>;
+    /**
+     * 内部双 Registry 竞速/降级探测
+     */
+    private performCheck;
+}

package/lib/updater.js

@@ -0,0 +1,160 @@
+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;
+    }
+    /**
+     * 同步获取当前已知的版本状态（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,54 @@
+import type { UpgradeExecutionResult, UpgradeStatusResult } from './types.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;
+    /**
+     * 探测当前插件是否是以本地 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>;
+}