dsh-github-flow 0.2.1 → 0.4.0

package/lib/tools/secret.js

@@ -45,17 +45,63 @@ function renderSecretOutput(args, value) {
     }
     return JSON.stringify(value, null, 2);
 }
+/**
+ * 渲染 variable 工具输出——与 renderSecretOutput 物理分离（S3 D1 决策）。
+ * 为什么必须独立函数而非同一渲染器的分支：variable 的 value 是 CI 明文（可回显，
+ * 这正是 get action 的用途），secret 的 value 永不显示。若共用渲染逻辑再
+ * 「选择性放开」，未来任一侧的重构都可能意外污染另一侧的安全假设——
+ * 两个函数的边界比一个函数的分支更可审。
+ */
+function renderVariableOutput(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (value.status === 'AWAITING_CONFIRMATION') {
+        return [
+            `> ### ${value.warning}`,
+            `> - **影响评估**: ${value.impact}`,
+            `> - **确认指引**: ${value.requiredAction}`,
+        ].join('\n');
+    }
+    if (Array.isArray(value.items) && args?.action === 'list') {
+        const list = value.items.filter(Boolean);
+        if (list.length === 0)
+            return '📭 当前作用域尚未配置任何 Variable。';
+        const rows = list.map((v) => {
+            const name = `\`${String(v.name || '-')}\``;
+            const date = v.createdAt ? String(v.createdAt).slice(0, 10) : '-';
+            return `| ${name} | ${date} |`;
+        });
+        return [
+            `**当前已配置 ${list.length} 个 Variable（值为 CI 明文，可经 get 查看）:**\n`,
+            '| 变量名 | 创建日期 |',
+            '| :--- | :--- |',
+            ...rows,
+        ].join('\n');
+    }
+    if (typeof value.result === 'string') {
+        return value.result;
+    }
+    if (typeof value.message === 'string') {
+        return `**${value.message}**`;
+    }
+    return JSON.stringify(value, null, 2);
+}
 export function createSecretTool(executor) {
     return {
         name: 'github_secret',
-        description: '管理 GitHub Actions 仓库密钥 (Secrets)：查看已配置的密钥名称列表、设置/更新密钥值（如 NPM_TOKEN、部署密钥）。密文经标准输入安全传递，绝不出现在命令行参数中，也不会在输出中回显。删除需 confirm: true。',
+        description: '管理 GitHub Actions 仓库密钥 (Secrets) 与变量 (Variables)：查看名称清单、设置/更新/删除值。Secret 密文经标准输入安全传递，绝不出现在命令行参数或输出中；Variable 为 CI 明文，可经 get 查看值。Secret 删除需 confirm: true。',
         parameters: {
             type: 'object',
             properties: {
                 action: {
                     type: 'string',
-                    enum: ['list', 'set', 'delete'],
-                    description: 'Secret 操作类型。',
+                    enum: ['list', 'get', 'set', 'delete'],
+                    description: '操作类型。get 仅 kind=variable 可用（secret 值写入后 GitHub 侧加密存储，物理不可读取）。',
+                },
+                kind: {
+                    type: 'string',
+                    enum: ['secret', 'variable'],
+                    description: '操作对象类型，默认 secret（向后兼容）。variable 为 Actions 明文变量：set 走 -b 直传、get 可回显值；secret 走 stdin 密文通道且永不回显。',
                 },
                 repo: {
                     type: 'string',
@@ -63,33 +109,33 @@ export function createSecretTool(executor) {
                 },
                 name: {
                     type: 'string',
-                    description: '密钥名称（set/delete 动作使用，如 "NPM_TOKEN"、"DOCKER_PASSWORD"）。',
+                    description: '名称（set/get/delete 动作使用，如 "NPM_TOKEN"、"DEPLOY_ENV"）。',
                 },
                 value: {
                     type: 'string',
-                    description: '密钥明文内容（set 动作使用）。内部通过子进程标准输入传递，避免在进程命令行被 ps/任务管理器窃取。',
+                    description: '值内容（set 动作使用）。secret：经子进程标准输入传递（防进程列表窃取）；variable：经 -b 参数直传（CI 明文，无 stdin 红线）。',
                 },
                 org: {
                     type: 'string',
-                    description: '组织级密钥的所属组织名（可选，映射 --org）。',
+                    description: '组织级作用域的组织名（可选，映射 --org）。',
                 },
                 env: {
                     type: 'string',
-                    description: '环境级密钥的部署环境名（可选，映射 --env）。',
+                    description: '环境级作用域的部署环境名（可选，映射 --env）。',
                 },
                 app: {
                     type: 'string',
                     enum: ['actions', 'agents', 'codespaces', 'dependabot'],
-                    description: '密钥归属的应用（可选，映射 --app，默认 actions）。',
+                    description: '密钥归属的应用（可选，仅 secret 的 --app，默认 actions；variable 无此维度）。',
                 },
                 visibility: {
                     type: 'string',
                     enum: ['all', 'private', 'selected'],
-                    description: '组织级密钥的可见范围（可选，仅 org 场景有意义）。',
+                    description: '组织级密钥的可见范围（可选，仅 secret + org 场景有意义）。',
                 },
                 confirm: {
                     type: 'boolean',
-                    description: '删除密钥时的确认标志。删除不可逆，未传 true 时仅输出影响评估。',
+                    description: '删除操作的确认标志。删除不可逆，未传 true 时仅输出影响评估。',
                 },
             },
             required: ['action'],
@@ -97,13 +143,16 @@ export function createSecretTool(executor) {
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                return [{ type: 'text', text: renderSecretOutput(args, value) }];
+                // 渲染分流即安全边界：variable 与 secret 永不共享渲染路径（见函数注释）
+                const renderer = args?.kind === 'variable' ? renderVariableOutput : renderSecretOutput;
+                return [{ type: 'text', text: renderer(args, value) }];
             },
         },
         async execute(args, execContext) {
             const cwd = execContext?.cwd || process.cwd();
             const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
-            // org 作用域的密钥挂在组织上，与具体仓库无关：既不需要仓库识别，
+            const isVariable = args.kind === 'variable';
+            // org 作用域挂在组织上，与具体仓库无关：既不需要仓库识别，
             // 也不能把 -R 与 --org 同时传给 gh（两者语义冲突，gh 会报错）。
             const isOrgScope = Boolean(args.org);
             let repoTarget = args.repo;
@@ -114,34 +163,67 @@ export function createSecretTool(executor) {
                 }
             }
             if (!repoTarget && !isOrgScope) {
-                throw new Error('未能自动识别当前工作区关联的 GitHub 仓库。请通过 `repo` 参数显式指定目标仓库 [owner/repo]，或改用 `org` 参数操作组织级密钥。');
+                throw new Error('未能自动识别当前工作区关联的 GitHub 仓库。请通过 `repo` 参数显式指定目标仓库 [owner/repo]，或改用 `org` 参数操作组织级作用域。');
+            }
+            // app 限定符仅 secret 域存在（variable 命令无 --app）；误传时明确报错而非静默忽略
+            if (isVariable && args.app) {
+                throw new Error("variable 无 --app 维度（app 仅 secret 域支持），请移除 app 参数。");
+            }
+            if (isVariable && args.visibility) {
+                throw new Error("variable 无 --visibility 维度（visibility 仅组织级 secret 支持），请移除 visibility 参数。");
             }
             const runOpts = { cwd, sessionId };
             // org/env/app 三类作用域标志对所有动作通用；仓库作用域时三项均不追加
             const scopeFlags = [];
             if (args.org) {
                 scopeFlags.push('--org', args.org);
-                if (args.visibility)
+                if (!isVariable && args.visibility)
                     scopeFlags.push('--visibility', args.visibility);
             }
             else if (args.env) {
                 scopeFlags.push('--env', args.env);
             }
-            if (args.app)
+            if (!isVariable && args.app)
                 scopeFlags.push('--app', args.app);
             const targetArgs = isOrgScope ? [] : ['-R', repoTarget];
+            // gh 命令域分流：secret → gh secret …；variable → gh variable …
+            // （两级分流：域前缀 + 每个分支内的行为差异——stdin vs -b、get 可用性）
+            const domain = isVariable ? 'variable' : 'secret';
             switch (args.action) {
                 case 'list': {
-                    const res = await executor.run(['secret', 'list', ...targetArgs, ...scopeFlags, '--json', 'name,updatedAt,visibility'], runOpts);
+                    // 字段集各自实测钉死：secret 有 updatedAt/visibility；variable 仅 4 字段
+                    // （createdAt,name,numSelectedRepos,selectedReposURL——无 value，get 才返回）
+                    const fields = isVariable ? 'name,createdAt,numSelectedRepos' : 'name,updatedAt,visibility';
+                    const res = await executor.run([domain, 'list', ...targetArgs, ...scopeFlags, '--json', fields], runOpts);
                     if (!res.ok)
                         throw new Error(res.error);
                     return normalizeOutput(res.data || res.rawOutput);
                 }
+                case 'get': {
+                    if (!args.name)
+                        throw new Error('get 操作必须提供 name');
+                    if (!isVariable) {
+                        throw new Error('secret 的值写入后由 GitHub 侧加密存储，物理上不可读取（这正是 secret 与 variable 的设计区别）。请改用 kind: \'variable\' 或直接 set 覆盖。');
+                    }
+                    // gh variable get 输出变量值（纯文本，无 --json）
+                    const res = await executor.run(['variable', 'get', args.name, ...targetArgs, ...scopeFlags], { ...runOpts, rawText: true });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { name: args.name, value: res.rawOutput || '' };
+                }
                 case 'set': {
                     if (!args.name)
-                        throw new Error('set 操作必须提供 name（密钥名称）');
+                        throw new Error('set 操作必须提供 name');
                     if (typeof args.value !== 'string' || args.value.length === 0) {
-                        throw new Error('set 操作必须提供 value（密钥明文），且不允许为空字符串');
+                        throw new Error('set 操作必须提供 value，且不允许为空字符串');
+                    }
+                    if (isVariable) {
+                        // variable 是 CI 明文（workflow 中 env 直接引用可见），无 secret 的
+                        // stdin 红线；gh variable set 原生支持 -b 直传（实测 help）。
+                        const res = await executor.run(['variable', 'set', args.name, '--body', args.value, ...targetArgs, ...scopeFlags], runOpts);
+                        if (!res.ok)
+                            throw new Error(res.error);
+                        return { message: `Variable「${args.name}」已更新（值: ${args.value}）` };
                     }
                     // 安全红线：密文只走 stdin。严禁退化为 -b <value> —— 那会把明文
                     // 留在进程列表与 shell 历史里，等于密钥泄漏。gh 本地会用仓库公钥
@@ -154,21 +236,24 @@ export function createSecretTool(executor) {
                 case 'delete': {
                     if (!args.name)
                         throw new Error('delete 操作必须提供 name');
+                    const kindLabel = isVariable ? 'Variable' : 'Secret';
                     if (args.confirm !== true) {
                         return {
                             status: 'AWAITING_CONFIRMATION',
-                            warning: `⚠️ 高危操作拦截：你即将删除 Secret「${args.name}」${args.org ? `（组织 ${args.org}）` : ''}。`,
-                            impact: '删除后所有引用该密钥的 CI/CD 工作流将立即无法取到值，运行中的构建会失败。',
+                            warning: `⚠️ 高危操作拦截：你即将删除 ${kindLabel}「${args.name}」${args.org ? `（组织 ${args.org}）` : ''}。`,
+                            impact: isVariable
+                                ? '删除后所有引用该变量的工作流将取不到值，运行中的构建立即失败。'
+                                : '删除后所有引用该密钥的 CI/CD 工作流将立即无法取到值，运行中的构建会失败。',
                             requiredAction: '如确认删除，请向用户核实并附加 `confirm: true` 重新调用。',
                         };
                     }
-                    const res = await executor.run(['secret', 'delete', args.name, ...targetArgs, ...scopeFlags], runOpts);
+                    const res = await executor.run([domain, 'delete', args.name, ...targetArgs, ...scopeFlags], runOpts);
                     if (!res.ok)
                         throw new Error(res.error);
-                    return { message: `Secret「${args.name}」已删除` };
+                    return { message: `${kindLabel}「${args.name}」已删除` };
                 }
                 default:
-                    throw new Error(`未知的 Secret 操作: ${args.action}`);
+                    throw new Error(`未知的 Secret/Variable 操作: ${args.action}（kind: ${args.kind || 'secret'}）`);
             }
         },
     };

package/lib/tools/status.d.ts

@@ -0,0 +1,39 @@
+import type { GhExecutor } from '../executor.js';
+export declare function createStatusTool(executor: GhExecutor): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            org: {
+                type: string;
+                description: string;
+            };
+            exclude: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+    };
+    output: {
+        schema: {
+            type: string;
+        };
+        render(args: any, value: any): {
+            type: string;
+            text: string;
+        }[];
+    };
+    execute(args: any, execContext: any): Promise<{
+        parsed: import("../renderers/status.js").ParsedStatusReport;
+        rawText: string;
+    }>;
+};

package/lib/tools/status.js

@@ -0,0 +1,53 @@
+import { renderStatusMarkdown, parseStatusOutput } from '../renderers/markdown.js';
+export function createStatusTool(executor) {
+    return {
+        name: 'github_status',
+        description: '聚合展示当前登录用户的跨仓库全局待办与动态大盘：包括指派给我的 Issues、指派给我的 PR、等待我评审的 PR、近期 @提及 以及订阅仓库的最新动态。无需指定单仓，账号维度一站式概览。',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['view'],
+                    description: '操作类型，默认为 view（查看全局待办看板）。',
+                },
+                org: {
+                    type: 'string',
+                    description: '组织名称（可选，限定仅汇报指定组织内部的待办与动态）。',
+                },
+                exclude: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: '要排除的仓库名称列表 [owner/repo]（可选，支持排除噪音仓库）。',
+                },
+            },
+        },
+        output: {
+            schema: { type: 'object' },
+            render(args, value) {
+                return [{ type: 'text', text: renderStatusMarkdown(args, value) }];
+            },
+        },
+        async execute(args, execContext) {
+            const cwd = execContext?.cwd || process.cwd();
+            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const statusCmd = ['status'];
+            if (args?.org) {
+                statusCmd.push('-o', String(args.org));
+            }
+            if (args?.exclude && Array.isArray(args.exclude)) {
+                for (const ex of args.exclude) {
+                    statusCmd.push('-e', String(ex));
+                }
+            }
+            const res = await executor.run(statusCmd, { cwd, sessionId, rawText: true });
+            if (!res.ok)
+                throw new Error(res.error);
+            const parsed = parseStatusOutput(res.rawOutput || '');
+            return {
+                parsed,
+                rawText: res.rawOutput || '',
+            };
+        },
+    };
+}

package/lib/types.d.ts

@@ -24,6 +24,12 @@ export interface PluginConfig {
     updateCheckIntervalMs?: number;
     /** 自定义 npm Registry 镜像地址，留空则自动选用 npmmirror 与 npmjs */
     registryUrl?: string;
+    /**
+     * 是否向 gh 子进程注入 AI_AGENT='dsh' 环境变量，默认 true。
+     * gh ≥2.99 检测该变量后切换 agent 专属行为（text-only spinner、误用时打印完整 help）；
+     * 关闭后恢复 gh 原生行为（用于对照实验或偏好原生输出的场景）。
+     */
+    agentEnvInjection?: boolean;
     /**
      * 代理地址预置默认值（如 "http://127.0.0.1:7890"）。
      * 仅在用户未在驾驶舱保存过代理设置时生效；运行时 UI 保存的值优先级更高。
@@ -31,6 +37,15 @@ export interface PluginConfig {
      */
     proxyUrl?: string;
 }
+/** 数据同步与自动化感知偏好配置 */
+export interface SyncSettings {
+    /** 刷新策略三选一：'swr' 秒开并在首屏拉新 | 'auto' SWR秒开+云端定时轮询 | 'manual' 仅手动点击拉取 */
+    strategy: 'swr' | 'auto' | 'manual';
+    /** 云端定时同步周期（毫秒，不少于 300,000 即 5 分钟，默认 600,000 即 10 分钟） */
+    cloudSyncIntervalMs: number;
+    /** 是否开启本地 .git 监控（感知代码修改、暂存与分支切换，仅右侧栏当前工作区生效，默认开启，用户可取消勾选） */
+    localGitWatch: boolean;
+}
 export interface GhExecutionOptions {
     /** 命令执行的工作目录，优先使用当前 Agent 会话所在的 Workspace 物理路径 */
     cwd?: string;
@@ -85,6 +100,12 @@ export interface AuthStatus {
     scopes?: string[];
     installGuide?: AuthInstallGuide;
     raw?: string;
+    /** 网络是否发生异常（超时、DNS解析失败、连接被拒、代理阻断等） */
+    networkError?: boolean;
+    /** 网络异常的人类可读原因或排查建议 */
+    networkErrorReason?: string;
+    /** 本地是否已检测到持久化凭据（如 hosts.yml 或 Keyring） */
+    hasLocalToken?: boolean;
 }
 export interface RepoMetadata {
     nameWithOwner: string;
@@ -96,6 +117,66 @@ export interface RepoMetadata {
     isPrivate?: boolean;
     url?: string;
 }
+/** Git 分支详情项（供分支切换器下拉列表消费） */
+export interface GitBranchItem {
+    name: string;
+    isCurrent: boolean;
+    isRemote: boolean;
+    upstream?: string;
+    shortSha: string;
+    subject: string;
+    relativeTime: string;
+}
+export interface GitBranchesResult {
+    current: string;
+    branches: GitBranchItem[];
+}
+/**
+ * 本地 Git 工作区状态快照（ahead/behind 是 remote-tracking ref 的「上次 fetch」视图，
+ * 非实时网络状态——UI 渲染时必须带上这一语义提示，否则会误导用户）。
+ */
+export interface GitLocalStatus {
+    branch: string;
+    /** 领先远程的提交数；无 upstream 时为 -1（未知） */
+    ahead: number;
+    /** 落后远程的提交数；无 upstream 时为 -1（未知） */
+    behind: number;
+    /** 未提交变更文件数（含 untracked） */
+    dirtyCount: number;
+    hasUpstream: boolean;
+    /** 未提交文件清单（porcelain 解析，截断前 20 条防快照膨胀） */
+    dirtyFiles: Array<{
+        status: string;
+        path: string;
+    }>;
+}
+/** 单条提交记录（结构化解析） */
+export interface GitCommitEntry {
+    sha: string;
+    fullSha?: string;
+    author: string;
+    email?: string;
+    date?: string;
+    /** git 的相对时间原文（如 "2 hours ago"）——本地化由渲染层处理 */
+    relative: string;
+    subject: string;
+    body?: string;
+    stat?: string;
+}
+/**
+ * 本地 Git 提交记录三段视图（与 GitLocalStatus 的 ahead/behind 计数同口径，
+ * 均为 remote-tracking 快照）。
+ */
+export interface GitCommitLog {
+    /** 本地领先远程的提交（待 push） */
+    aheadCommits: GitCommitEntry[];
+    /** 远程领先本地的提交（待 pull，快照口径） */
+    behindCommits: GitCommitEntry[];
+    /** 最近提交（默认 15 条，支持下滚分页） */
+    recent: GitCommitEntry[];
+    /** 仓库总提交数（rev-list --count HEAD） */
+    totalCount?: number;
+}
 export interface PrItem {
     number: number;
     title: string;
@@ -168,8 +249,33 @@ export interface GitHubOverviewData {
     runs: WorkflowRunItem[];
     lastUpdated: string;
     error?: string;
+    /** 网络是否发生异常（超时、连接拒绝、代理阻断等） */
+    networkError?: boolean;
+    /** 网络异常的原因或提示 */
+    networkErrorReason?: string;
     /** 插件版本与升级信息（由内存缓存快速读取，不阻塞首屏业务） */
     updateInfo?: UpdateInfo;
+    /** 本地 Git 状态（ahead/behind/dirty，remote-tracking 快照语义）；非 Git 工作区为 undefined */
+    gitStatus?: GitLocalStatus | null;
+    /** 提交记录三段（本地领先/远程领先/最近）；探测失败为 undefined */
+    commitLog?: GitCommitLog | null;
+    /** 最新 Release 锚定（已过滤 Draft）；无 Release 仓库为 null */
+    releaseInfo?: {
+        tagName: string;
+        isPrerelease?: boolean;
+        publishedAt?: string;
+        url?: string;
+    } | null;
+    /** 当前分支关联的 PR；无 PR 分支为 null */
+    branchPr?: {
+        number: number;
+        title: string;
+        state?: string;
+        url?: string;
+        isDraft?: boolean;
+    } | null;
+    /** 当前工作区的 Git 分支列表（供右侧栏分支选择器 0ms 秒开） */
+    branches?: GitBranchesResult | null;
 }
 export interface UserRepoItem {
     name: string;
@@ -188,6 +294,8 @@ export interface WorkspaceMatrixItem {
     hasGit: boolean;
     repo?: RepoMetadata;
     sessionCount: number;
+    /** 本地 Git 状态摘要（可选——探测失败/非 Git 工作区不携带） */
+    gitStatus?: GitLocalStatus;
 }
 export interface GlobalIssueItem {
     number: number;
@@ -228,6 +336,10 @@ export interface GlobalOverviewData {
     issueStats?: IssueStats;
     lastUpdated: string;
     error?: string;
+    /** 网络是否发生异常（超时、连接拒绝、代理阻断等） */
+    networkError?: boolean;
+    /** 网络异常的原因或提示 */
+    networkErrorReason?: string;
     /** 工作区矩阵读取失败的原因。区分「没有工作区」与「读不到工作区」，避免把故障显示成空状态 */
     workspaceError?: string;
     /** 插件版本与升级信息（由内存缓存快速读取，不阻塞首屏业务） */

package/lib/ui/auth-guide-card.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 认证与安装引导卡片组件（响应式自适应中央大面板与右侧栏）
+ */
+export declare function AuthGuideCard(props: any): any;

package/lib/ui/auth-guide-card.js

@@ -0,0 +1,161 @@
+/**
+ * 认证与安装引导卡片组件（响应式自适应中央大面板与右侧栏）
+ */
+export function AuthGuideCard(props) {
+    var auth = props ? props.auth : null;
+    var onRefresh = props ? props.onRefresh : () => { };
+    var isRightbar = Boolean(props && props.isRightbar);
+    var [copied, setCopied] = React.useState(false);
+    var [launching, setLaunching] = React.useState(false);
+    var [toastMsg, setToastMsg] = React.useState(null);
+    var isNetwork = Boolean(auth?.networkError);
+    var notInstalled = !isNetwork && Boolean(auth && auth.installed === false);
+    var notLoggedIn = !isNetwork && !notInstalled && Boolean(!auth?.loggedIn);
+    var guide = auth?.installGuide;
+    var defaultCmd = isNetwork
+        ? "gh auth status"
+        : notInstalled
+            ? (guide?.command || "winget install --id GitHub.cli")
+            : "gh auth login";
+    var copyCmd = (cmd) => {
+        try {
+            if (navigator && navigator.clipboard && navigator.clipboard.writeText) {
+                navigator.clipboard.writeText(cmd);
+            }
+            else {
+                var input = document.createElement("textarea");
+                input.value = cmd;
+                document.body.appendChild(input);
+                input.select();
+                document.execCommand("copy");
+                document.body.removeChild(input);
+            }
+            setCopied(true);
+            setTimeout(() => setCopied(false), 2000);
+        }
+        catch (e) {
+            console.warn("复制失败:", e);
+        }
+    };
+    var launchTerminal = async (cmd) => {
+        setLaunching(true);
+        setToastMsg(null);
+        try {
+            var res = await fetch("/api/github/action", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ action: "open_terminal", command: cmd })
+            });
+            var json = await res.json();
+            if (json.ok) {
+                setToastMsg("已唤起系统终端，请在弹出窗口中完成操作；若未弹出，可手动打开终端执行上方命令");
+                setTimeout(() => setToastMsg(null), 6000);
+            }
+            else {
+                setToastMsg("❌ " + (json.message || "唤起失败，请手动打开终端执行上方命令"));
+            }
+        }
+        catch (e) {
+            setToastMsg("无法连接后台服务，请手动打开终端执行上方命令");
+        }
+        finally {
+            setLaunching(false);
+        }
+    };
+    var openDownload = async () => {
+        var url = guide?.downloadUrl || "https://cli.github.com/";
+        try {
+            await fetch("/api/github/action", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ action: "open_browser", url })
+            });
+        }
+        catch (e) {
+            window.open(url, "_blank", "noopener,noreferrer");
+        }
+    };
+    var openProxySettings = () => {
+        try {
+            window.dispatchEvent(new CustomEvent("dsh-github-open-proxy"));
+        }
+        catch (e) { }
+    };
+    var h = React.createElement;
+    return h("div", {
+        className: "dsh-github-guide-card " + (isNetwork ? "warning" : notInstalled ? "danger" : "warning"),
+        style: isRightbar ? { padding: "12px", marginBottom: "12px" } : undefined
+    }, h("div", { className: "dsh-github-guide-header" }, isNetwork
+        ? "🌐 无法连接 GitHub 服务器"
+        : notInstalled
+            ? "⚠️ 未检测到 GitHub CLI (gh)"
+            : "🔑 GitHub 账号尚未登录", h("span", { className: "dsh-github-badge " + (isNetwork ? "dsh-badge-yellow" : notInstalled ? "dsh-badge-red" : "dsh-badge-yellow") }, isNetwork ? "网络受限" : notInstalled ? "未安装" : "未认证")), h("div", { className: "dsh-github-guide-desc" }, isNetwork
+        ? (auth?.networkErrorReason || "检测到本机已安装 GitHub CLI，但当前无法连接至 api.github.com（网络超时、DNS 无法解析或被系统代理阻断）。")
+        : notInstalled
+            ? (guide?.description || "DSH GitHub Flow 插件依赖官方 GitHub CLI 工具与云端进行安全交互，当前系统 PATH 中未检测到该工具。")
+            : "检测到本机已安装 GitHub CLI，请完成账号授权以解锁仓库管理、PR 审查和 Issues 待办。"), h("div", { className: "dsh-github-cmd-box" }, h("code", null, defaultCmd), h("button", {
+        className: "dsh-github-copy-btn " + (copied ? "copied" : ""),
+        onClick: () => copyCmd(defaultCmd),
+        title: "复制命令到剪贴板"
+    }, copied ? "✓ 已复制" : "📋 复制命令")), !notInstalled && !isRightbar
+        ? (isNetwork
+            ? h("ol", { className: "dsh-github-steps-list" }, h("li", null, "检查系统本地网络连接或 DNS 解析，确认能正常访问 github.com；"), h("li", null, "若使用了网络代理工具，可在下方点击「配置网络代理」填写 HTTP 或 SOCKS5 代理；"), h("li", null, "配置或恢复网络后，切回本面板或点击「重试连接」即可自动同步数据。"))
+            : h("ol", { className: "dsh-github-steps-list" }, h("li", null, "打开系统终端（PowerShell / CMD / Terminal），运行上述命令；"), h("li", null, "按提示依次选择「GitHub.com」➜「HTTPS」➜「Login with a web browser」；"), h("li", null, "按回车打开浏览器确认授权后，切回本页面即可自动恢复。")))
+        : null, h("div", { className: "dsh-github-guide-actions" }, isNetwork
+        ? h("button", {
+            className: "dsh-github-action-btn",
+            onClick: onRefresh,
+            title: "重新发起网络连接校验"
+        }, "🔄 重试网络连接")
+        : null, isNetwork
+        ? h("button", {
+            className: "dsh-github-action-btn",
+            onClick: openProxySettings,
+            title: "打开网络代理设置，配置 HTTP/SOCKS5 代理服务器"
+        }, "⚙️ 配置网络代理")
+        : null, h("button", {
+        className: "dsh-github-action-btn",
+        onClick: () => launchTerminal(defaultCmd),
+        disabled: launching,
+        title: "自动唤起系统终端并执行该命令"
+    }, launching ? "正在唤起..." : (isNetwork ? "💻 终端排查状态" : notInstalled ? "💻 唤起终端安装" : "💻 唤起终端登录")), notInstalled
+        ? h("button", {
+            className: "dsh-github-action-btn",
+            onClick: openDownload,
+            title: "打开 GitHub CLI 官方下载主页获取安装包"
+        }, "🌐 官网安装包 (.msi/.pkg)")
+        : null, !isNetwork
+        ? h("button", {
+            className: "dsh-github-action-btn",
+            onClick: function () {
+                setToastMsg("正在快速检测登录状态...");
+                var probeController = new AbortController();
+                var probeTimer = setTimeout(function () { probeController.abort(); }, 10000);
+                fetch("/api/github/auth?force=true", { signal: probeController.signal })
+                    .then(function (res) { return res.json(); })
+                    .then(function (json) {
+                    clearTimeout(probeTimer);
+                    if (json && json.ok && json.auth && json.auth.loggedIn) {
+                        setToastMsg("✅ 已识别到 GitHub CLI 登录态，正在拉取数据...");
+                        clearStoredGlobalOverview();
+                        onRefresh();
+                    }
+                    else {
+                        setToastMsg("⚠️ 暂未检测到登录凭据，请在终端执行 gh auth login 完成授权");
+                        onRefresh();
+                    }
+                })
+                    .catch(function () {
+                    clearTimeout(probeTimer);
+                    setToastMsg("❌ 检测超时或后端不可达，请稍后重试");
+                    onRefresh();
+                });
+            },
+            title: "重新检测登录与安装状态"
+        }, "🔄 刷新状态")
+        : null), toastMsg
+        ? h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-link, #0969da)", marginTop: "8px" } }, `ℹ️ ${toastMsg}`)
+        : null, h("div", { className: "dsh-github-guide-tip" }, notInstalled
+        ? "💡 提示：使用包管理器安装完成后，若未立即识别，可重启 DeepSeek Harness 应用刷新系统环境变量 PATH。"
+        : "💡 提示：凭证由官方 GitHub CLI 加密保存在操作系统安全凭据库中，授权完毕切回本窗口将自动识别刷新。"));
+}

package/lib/ui/branch-selector.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 分支查看与快速切换下拉选择器组件
+ */
+export declare function BranchSelectorDropdown(props: {
+    currentBranch: string;
+    cwd: string | null;
+    branchesData?: any;
+    onBranchSwitched?: (branch: string) => void;
+    showToast?: (msg: string) => void;
+}): any;