dsh-github-flow 0.3.0 → 0.4.0

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

@@ -37,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;
@@ -91,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;
@@ -102,6 +117,20 @@ 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 渲染时必须带上这一语义提示，否则会误导用户）。
@@ -220,6 +249,10 @@ export interface GitHubOverviewData {
     runs: WorkflowRunItem[];
     lastUpdated: string;
     error?: string;
+    /** 网络是否发生异常（超时、连接拒绝、代理阻断等） */
+    networkError?: boolean;
+    /** 网络异常的原因或提示 */
+    networkErrorReason?: string;
     /** 插件版本与升级信息（由内存缓存快速读取，不阻塞首屏业务） */
     updateInfo?: UpdateInfo;
     /** 本地 Git 状态（ahead/behind/dirty，remote-tracking 快照语义）；非 Git 工作区为 undefined */
@@ -241,6 +274,8 @@ export interface GitHubOverviewData {
         url?: string;
         isDraft?: boolean;
     } | null;
+    /** 当前工作区的 Git 分支列表（供右侧栏分支选择器 0ms 秒开） */
+    branches?: GitBranchesResult | null;
 }
 export interface UserRepoItem {
     name: string;
@@ -301,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;

package/lib/ui/branch-selector.js

@@ -0,0 +1,163 @@
+/**
+ * 分支查看与快速切换下拉选择器组件
+ */
+export function BranchSelectorDropdown(props) {
+    var currentBranch = props.currentBranch || "main";
+    var cwd = props.cwd;
+    var branchesData = props.branchesData;
+    var onBranchSwitched = props.onBranchSwitched || (() => { });
+    var showToast = props.showToast || (() => { });
+    var [isOpen, setIsOpen] = React.useState(false);
+    var [loading, setLoading] = React.useState(false);
+    var [switching, setSwitching] = React.useState(false);
+    var [branches, setBranches] = React.useState([]);
+    var [search, setSearch] = React.useState("");
+    var [fetchError, setFetchError] = React.useState(null);
+    var containerRef = React.useRef(null);
+    React.useEffect(() => {
+        if (!isOpen)
+            return;
+        var handleClickOutside = (e) => {
+            if (containerRef.current && !containerRef.current.contains(e.target)) {
+                setIsOpen(false);
+            }
+        };
+        document.addEventListener("mousedown", handleClickOutside);
+        return () => document.removeEventListener("mousedown", handleClickOutside);
+    }, [isOpen]);
+    var toggleOpen = () => {
+        if (isOpen) {
+            setIsOpen(false);
+            return;
+        }
+        setIsOpen(true);
+        setSearch("");
+        setFetchError(null);
+        if (branchesData && Array.isArray(branchesData.branches) && branchesData.branches.length > 0) {
+            setBranches(branchesData.branches);
+            setLoading(false);
+            return;
+        }
+        setLoading(true);
+        var url = "/api/github/branches" + (cwd ? "?cwd=" + encodeURIComponent(cwd) : "");
+        fetch(url)
+            .then(async (res) => {
+            if (!res.ok) {
+                var errText = await res.text().catch(() => "");
+                if (res.status === 404 || errText.includes("not found")) {
+                    throw new Error("后端分支接口未注册 (404)。请重启 DSH 桌面端以加载新后端服务。");
+                }
+                throw new Error(`服务响应异常 (${res.status}): ${errText || res.statusText}`);
+            }
+            return res.json();
+        })
+            .then((json) => {
+            setLoading(false);
+            if (json && json.ok && json.data && Array.isArray(json.data.branches)) {
+                setBranches(json.data.branches);
+            }
+            else {
+                setFetchError(json.error || "获取分支列表失败");
+            }
+        })
+            .catch((err) => {
+            setLoading(false);
+            setFetchError(err.message || "读取分支失败");
+        });
+    };
+    var handleSwitch = async (targetBranch) => {
+        if (targetBranch === currentBranch || switching)
+            return;
+        setSwitching(true);
+        try {
+            var res = await fetch("/api/github/branch-switch", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ cwd, branch: targetBranch }),
+            }).catch(() => null);
+            if (!res || !res.ok) {
+                res = await fetch("/api/github/action", {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({ action: "switch_branch", cwd, branch: targetBranch }),
+                });
+            }
+            if (!res.ok) {
+                var errText = await res.text().catch(() => "");
+                showToast(`❌ 切换失败：${errText || res.statusText}`);
+                return;
+            }
+            var json = await res.json();
+            if (json && json.ok) {
+                setIsOpen(false);
+                showToast(`✅ 已切换到分支 ${json.currentBranch || targetBranch}`);
+                onBranchSwitched(json.currentBranch || targetBranch);
+            }
+            else {
+                showToast(`❌ 切换失败：${json.error || json.message || "未知错误"}`);
+            }
+        }
+        catch (e) {
+            showToast(`❌ 切换分支网络请求失败：${e.message || e}`);
+        }
+        finally {
+            setSwitching(false);
+        }
+    };
+    var filtered = branches.filter((b) => !search || b.name.toLowerCase().includes(search.toLowerCase()));
+    var localBranches = filtered.filter((b) => !b.isRemote);
+    var remoteBranches = filtered.filter((b) => b.isRemote);
+    var h = React.createElement;
+    return h("div", {
+        ref: containerRef,
+        style: { position: "relative", display: "inline-block" },
+    }, h("button", {
+        type: "button",
+        className: "dsh-github-branch-btn",
+        onClick: toggleOpen,
+        title: `当前分支: ${currentBranch}（点击可切换分支）`,
+    }, renderGitIcon(12, "currentColor"), h("span", { style: { maxWidth: "160px", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, currentBranch), h("span", { style: { fontSize: "9px", opacity: 0.7, marginLeft: "1px" } }, "▾")), isOpen
+        ? h("div", { className: "dsh-github-branch-dropdown" }, h("div", { className: "dsh-github-branch-search" }, h("input", {
+            className: "dsh-github-branch-input",
+            type: "text",
+            placeholder: "搜索分支 (输入关键词)...",
+            value: search,
+            autoFocus: true,
+            onChange: (e) => setSearch(e.target.value),
+        })), h("div", { className: "dsh-github-branch-list" }, loading
+            ? h("div", { style: { padding: "12px", textAlign: "center", fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)" } }, "⏳ 读取分支中...")
+            : fetchError
+                ? h("div", { style: { padding: "12px", textAlign: "center", fontSize: "11px", color: "var(--dsw-alias-state-error-primary, #cf222e)" } }, `⚠️ ${fetchError}`)
+                : [
+                    localBranches.length > 0
+                        ? h("div", { key: "hdr-local", style: { padding: "4px 12px", fontSize: "10px", fontWeight: 600, color: "var(--dsw-alias-label-tertiary, #8c8c8c)", textTransform: "uppercase" } }, "本地分支")
+                        : null,
+                    ...localBranches.map((b) => h("div", {
+                        key: b.name,
+                        className: "dsh-github-branch-item" + (b.isCurrent ? " active" : ""),
+                        onClick: () => handleSwitch(b.name),
+                        title: b.subject ? `${b.name}\n${b.subject} (${b.relativeTime})` : b.name,
+                    }, h("div", { style: { display: "flex", alignItems: "center", gap: "6px", minWidth: 0 } }, b.isCurrent
+                        ? h("span", { style: { color: "var(--dsw-alias-state-success, #2ea043)", fontWeight: 700 } }, "✓")
+                        : h("span", { style: { width: "10px" } }), h("span", { style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, b.name)), b.relativeTime
+                        ? h("span", { style: { fontSize: "10px", color: "var(--dsw-alias-label-tertiary, #8c8c8c)", flexShrink: 0, marginLeft: "6px" } }, b.relativeTime)
+                        : null)),
+                    remoteBranches.length > 0
+                        ? h("div", { key: "hdr-remote", style: { padding: "6px 12px 4px", fontSize: "10px", fontWeight: 600, color: "var(--dsw-alias-label-tertiary, #8c8c8c)", textTransform: "uppercase", borderTop: "1px solid var(--dsw-alias-border-l2, rgba(0,0,0,0.06))", marginTop: "4px" } }, "远程分支 (点击检出)")
+                        : null,
+                    ...remoteBranches.map((b) => h("div", {
+                        key: b.name,
+                        className: "dsh-github-branch-item",
+                        onClick: () => handleSwitch(b.name),
+                        title: b.subject ? `${b.name}\n${b.subject} (${b.relativeTime})` : b.name,
+                    }, h("div", { style: { display: "flex", alignItems: "center", gap: "6px", minWidth: 0 } }, h("span", { style: { width: "10px" } }), h("span", { style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap", opacity: 0.85 } }, b.name)), b.relativeTime
+                        ? h("span", { style: { fontSize: "10px", color: "var(--dsw-alias-label-tertiary, #8c8c8c)", flexShrink: 0, marginLeft: "6px" } }, b.relativeTime)
+                        : null)),
+                    filtered.length === 0 && !loading
+                        ? h("div", { style: { padding: "12px", textAlign: "center", fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)" } }, "未匹配到任何分支")
+                        : null,
+                ].filter(Boolean)), switching
+            ? h("div", { style: { padding: "6px", textAlign: "center", fontSize: "11px", background: "rgba(9, 105, 218, 0.1)", color: "var(--dsw-alias-link, #0969da)", fontWeight: 500 } }, "正在切换分支...")
+            : null)
+        : null);
+}

package/lib/ui/commit-modal.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 提交详情模态弹窗组件（与设置弹窗同构）
+ */
+export declare function CommitDetailModal(props: {
+    commit: any;
+    onClose: () => void;
+    cwd?: string | null;
+}): any;

package/lib/ui/commit-modal.js

@@ -0,0 +1,89 @@
+/**
+ * 提交详情模态弹窗组件（与设置弹窗同构）
+ */
+export function CommitDetailModal(props) {
+    if (!props.commit)
+        return null;
+    var c = props.commit;
+    var h = React.createElement;
+    var [fetchedDetail, setFetchedDetail] = React.useState(null);
+    var [fetchingDetail, setFetchingDetail] = React.useState(false);
+    React.useEffect(function () {
+        var onKeyDown = function (e) {
+            if (e.key === "Escape" || e.keyCode === 27)
+                props.onClose();
+        };
+        window.addEventListener("keydown", onKeyDown);
+        return function () { window.removeEventListener("keydown", onKeyDown); };
+    }, [props.onClose]);
+    React.useEffect(function () {
+        setFetchedDetail(null);
+        if (c.body || c.stat)
+            return;
+        setFetchingDetail(true);
+        var url = "/api/github/commit-detail?sha=" + encodeURIComponent(c.sha) + (props.cwd ? "&cwd=" + encodeURIComponent(props.cwd) : "");
+        fetch(url)
+            .then(function (r) { return r.json(); })
+            .then(function (j) {
+            setFetchingDetail(false);
+            if (j && j.ok && j.detail)
+                setFetchedDetail(j.detail);
+        })
+            .catch(function () { setFetchingDetail(false); });
+    }, [c.sha, props.cwd]);
+    var effectiveBody = c.body;
+    var effectiveStat = c.stat;
+    if (!effectiveBody && !effectiveStat && fetchedDetail) {
+        effectiveStat = fetchedDetail;
+    }
+    return h("div", {
+        className: "dsh-github-modal-overlay",
+        onClick: props.onClose,
+        style: { zIndex: 100000 },
+    }, h("div", {
+        className: "dsh-github-modal-dialog",
+        style: { width: "94%", maxWidth: "460px", maxHeight: "84vh", display: "flex", flexDirection: "column", overflow: "hidden" },
+        onClick: function (e) { e.stopPropagation(); },
+    }, h("div", { className: "dsh-github-modal-header", style: { flexShrink: 0 } }, h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } }, renderGitIcon(15, "#1296db"), h("h3", { style: { margin: 0, fontSize: "14px", fontWeight: 600 } }, "提交详情")), h("button", {
+        style: { background: "none", border: "none", cursor: "pointer", fontSize: "18px", color: "var(--dsw-alias-label-secondary, #656d76)", padding: "0 4px" },
+        onClick: props.onClose,
+        title: "关闭 (Esc)",
+    }, "✕")), h("div", {
+        className: "dsh-github-modal-body",
+        style: { padding: "16px", overflowY: "auto", flex: 1, minHeight: 0, display: "flex", flexDirection: "column", gap: "12px", boxSizing: "border-box" },
+    }, h("div", { style: { display: "flex", justifyContent: "space-between", alignItems: "center", fontSize: "11px", opacity: 0.85 } }, h("span", { style: { fontFamily: "monospace", fontWeight: 600, userSelect: "all" }, title: "完整 SHA: " + (c.fullSha || c.sha) }, c.fullSha || c.sha), h("span", null, c.relative)), h("div", { style: { fontSize: "13px", fontWeight: 600, color: "var(--dsw-alias-label-primary, #1f2328)", wordBreak: "break-word", lineHeight: "1.45" } }, c.subject), h("div", { style: { fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)" } }, `提交者: ${c.author}${c.email ? ` <${c.email}>` : ""}${c.date ? ` · ${c.date}` : ""}`), effectiveBody
+        ? h("div", {
+            style: {
+                fontSize: "12px",
+                lineHeight: "1.6",
+                whiteSpace: "pre-wrap",
+                wordBreak: "break-word",
+                padding: "10px 12px",
+                borderRadius: "6px",
+                background: "var(--dsw-alias-bg-module-platform, #f6f8fa)",
+                border: "1px solid var(--dsw-alias-border-l2, #e1e4e8)",
+            },
+        }, effectiveBody)
+        : null, effectiveStat
+        ? h("div", null, h("div", { style: { fontSize: "11px", fontWeight: 600, marginBottom: "4px", opacity: 0.8 } }, "📁 文件变更统计:"), h("pre", {
+            className: "dsh-github-commit-pre",
+            style: {
+                fontSize: "11px",
+                lineHeight: "1.5",
+                whiteSpace: "pre-wrap",
+                wordBreak: "break-word",
+                margin: 0,
+                maxHeight: "34vh",
+                overflowY: "auto",
+                padding: "8px 10px",
+                borderRadius: "6px",
+                background: "var(--dsw-alias-bg-module-platform, #f6f8fa)",
+                border: "1px solid var(--dsw-alias-border-l2, #e1e4e8)",
+            },
+        }, effectiveStat))
+        : null, !effectiveBody && !effectiveStat
+        ? (fetchingDetail
+            ? h("div", { style: { fontSize: "12px", opacity: 0.7, padding: "8px 0" } }, "⏳ 正在获取详细变更说明…")
+            : h("div", { style: { fontSize: "11px", opacity: 0.6, fontStyle: "italic", padding: "6px 0" } }, "（该提交未包含多行正文；重启 DSH 桌面端可同步最新格式并直接呈现变更统计）"))
+        : null)));
+}

package/lib/ui/icons.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 官方高清 SVG 矢量组件与图标徽章
+ */
+export declare function renderOctocat(size?: number, color?: string): any;
+export declare function renderGitIcon(size?: number, color?: string): any;
+export declare function renderOctocatBadge(size?: number): any;
+export declare function renderPluginBadge(hFactory: any): any;

package/lib/ui/icons.js

@@ -0,0 +1,53 @@
+/**
+ * 官方高清 SVG 矢量组件与图标徽章
+ */
+export function renderOctocat(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: "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"
+    }));
+}
+export function renderGitIcon(size = 14, color = "#1296db") {
+    return React.createElement("svg", {
+        viewBox: "0 0 1024 1024",
+        width: size,
+        height: size,
+        style: { flexShrink: 0, display: "inline-block", verticalAlign: "middle" }
+    }, React.createElement("path", {
+        fill: color,
+        d: "M943.078 472.342L551.076 80.34c-21.859-21.859-57.626-21.859-79.485 0L79.589 472.342c-21.859 21.859-21.859 57.626 0 79.485l392.002 392.002c21.859 21.859 57.626 21.859 79.485 0l392.002-392.002c21.858-21.858 21.858-57.626 0-79.485z m-249.083 113.12c-37.939 0-68.693-30.755-68.693-68.693a68.532 68.532 0 0 1 4.136-23.521l-86.88-86.88v237.369c21.391 11.639 35.908 34.313 35.908 60.378 0 37.939-30.755 68.693-68.693 68.693s-68.693-30.755-68.693-68.693c0-27.314 15.944-50.903 39.03-61.973v-250.25c-23.022-10.642-39.03-33.879-39.03-60.907 0-7.808 1.401-15.272 3.853-22.243L344.061 207.871l44.159-44.159L490.738 266.23c5.58-1.503 11.418-2.378 17.473-2.378 37.076 0 67.132 30.056 67.132 67.132 0 6.055-0.875 11.893-2.378 17.473l102.241 102.241a68.68 68.68 0 0 1 18.789-2.623c37.939 0 68.693 30.755 68.693 68.693s-30.754 68.694-68.693 68.694z"
+    }));
+}
+export function renderOctocatBadge(size = 32) {
+    return React.createElement("div", {
+        className: "dsh-octocat-badge",
+        style: {
+            width: size + "px",
+            height: size + "px",
+            borderRadius: Math.round(size * 0.25) + "px",
+        }
+    }, renderOctocat(Math.round(size * 0.58), "#ffffff"));
+}
+export function renderPluginBadge(hFactory) {
+    var h = hFactory;
+    return h("button", {
+        className: "dsh-github-plugin-badge",
+        type: "button",
+        title: "本界面由第三方插件 dsh-github-flow 提供（非 DSH / GitHub 官方）。点击查看关于。",
+        onClick: function (e) {
+            e.stopPropagation();
+            e.preventDefault();
+            try {
+                window.dispatchEvent(new CustomEvent("dsh-github-open-about"));
+            }
+            catch (err) { }
+        },
+    }, "插件");
+}

package/lib/ui/network-banner.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 网络连接异常与离线状态醒目横幅组件
+ */
+export declare function NetworkAlertBanner(props: {
+    isRightbar?: boolean;
+    networkErrorReason?: string | null;
+    lastSyncedAt?: number;
+    onRefresh?: () => void;
+    onOpenProxy?: () => void;
+}): any;