dsh-github-flow 0.1.4 → 0.1.6

package/lib/client.js

@@ -633,6 +633,110 @@ body[data-ds-dark-theme] .dsh-github-repo-link {
 body[data-ds-dark-theme] .dsh-github-subheading {
   color: var(--dsw-alias-label-primary, #f0f6fc);
 }
+
+/* 15. 就绪引导横幅 (Setup Guide Banner) */
+.dsh-github-guide-card {
+  padding: 16px;
+  border-radius: 8px;
+  margin-bottom: 16px;
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  background: var(--dsw-alias-bg-layer-1, #f6f8fa);
+}
+.dsh-github-guide-card.warning {
+  border-color: rgba(210, 153, 34, 0.4);
+  background: rgba(210, 153, 34, 0.08);
+}
+.dsh-github-guide-card.danger {
+  border-color: rgba(248, 81, 73, 0.4);
+  background: rgba(248, 81, 73, 0.08);
+}
+.dsh-github-guide-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 15px;
+  font-weight: 600;
+  margin-bottom: 6px;
+  color: var(--dsw-alias-label-primary, #1f2328);
+}
+body[data-ds-dark-theme] .dsh-github-guide-header {
+  color: var(--dsw-alias-label-primary, #f0f6fc);
+}
+.dsh-github-guide-desc {
+  font-size: 13px;
+  color: var(--dsw-alias-label-secondary, #656d76);
+  line-height: 1.5;
+  margin-bottom: 12px;
+}
+body[data-ds-dark-theme] .dsh-github-guide-desc {
+  color: var(--dsw-alias-label-secondary, #8c8c8c);
+}
+.dsh-github-cmd-box {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  background: var(--dsw-alias-bg-base, #ffffff);
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  border-radius: 6px;
+  padding: 8px 12px;
+  font-family: var(--ds-font-family-code, monospace);
+  font-size: 13px;
+  color: var(--dsw-alias-label-primary, #1f2328);
+  margin-bottom: 12px;
+}
+body[data-ds-dark-theme] .dsh-github-cmd-box {
+  background: var(--dsw-alias-bg-layer-2, #161b22);
+  border-color: var(--dsw-alias-border-l1, #30363d);
+  color: var(--dsw-alias-label-primary, #f0f6fc);
+}
+.dsh-github-copy-btn {
+  padding: 4px 10px;
+  font-size: 12px;
+  border-radius: 4px;
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  background: var(--dsw-alias-bg-layer-1, #f6f8fa);
+  color: var(--dsw-alias-label-primary, #1f2328);
+  cursor: pointer;
+  white-space: nowrap;
+  transition: all 0.15s ease;
+}
+body[data-ds-dark-theme] .dsh-github-copy-btn {
+  background: var(--dsw-alias-bg-layer-2, #21262d);
+  border-color: var(--dsw-alias-border-l1, #30363d);
+  color: var(--dsw-alias-label-primary, #c9d1d9);
+}
+.dsh-github-copy-btn:hover {
+  background: var(--dsw-alias-interactive-bg-hover, #ebeef1);
+}
+body[data-ds-dark-theme] .dsh-github-copy-btn:hover {
+  background: #30363d;
+}
+.dsh-github-copy-btn.copied {
+  color: #2da44e !important;
+  border-color: #2da44e !important;
+  background: rgba(45, 164, 78, 0.15) !important;
+}
+.dsh-github-steps-list {
+  font-size: 12px;
+  color: var(--dsw-alias-label-secondary, #656d76);
+  line-height: 1.6;
+  margin: 0 0 12px 18px;
+  padding: 0;
+}
+body[data-ds-dark-theme] .dsh-github-steps-list {
+  color: var(--dsw-alias-label-secondary, #8c8c8c);
+}
+.dsh-github-guide-actions {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+.dsh-github-guide-tip {
+  font-size: 11px;
+  color: var(--dsw-alias-label-tertiary, #8c8c8c);
+  margin-top: 10px;
+  line-height: 1.4;
+}
 `;
         function injectStyles() {
             var styleId = "dsh-plugin-github-styles";
@@ -672,6 +776,120 @@ body[data-ds-dark-theme] .dsh-github-subheading {
                 }
             }, renderOctocat(Math.round(size * 0.58), "#ffffff"));
         }
+        // 认证与安装引导卡片组件（响应式自适应中央大面板与右侧栏）
+        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 notInstalled = !auth?.installed;
+            var guide = auth?.installGuide;
+            var defaultCmd = 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), 4000);
+                    }
+                    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 h = React.createElement;
+            return h("div", {
+                className: "dsh-github-guide-card " + (notInstalled ? "danger" : "warning"),
+                style: isRightbar ? { padding: "12px", marginBottom: "12px" } : undefined
+            }, 
+            // 头部
+            h("div", { className: "dsh-github-guide-header" }, notInstalled ? "⚠️ 未检测到 GitHub CLI (gh)" : "🔑 GitHub 账号尚未登录", h("span", { className: "dsh-github-badge " + (notInstalled ? "dsh-badge-red" : "dsh-badge-yellow") }, notInstalled ? "未安装" : "未认证")), 
+            // 描述
+            h("div", { className: "dsh-github-guide-desc" }, 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
+                ? 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" }, h("button", {
+                className: "dsh-github-action-btn",
+                onClick: () => launchTerminal(defaultCmd),
+                disabled: launching,
+                title: "自动唤起系统终端并执行该命令"
+            }, launching ? "正在唤起..." : (notInstalled ? "💻 唤起终端安装" : "💻 唤起终端登录")), notInstalled
+                ? h("button", {
+                    className: "dsh-github-action-btn",
+                    onClick: openDownload,
+                    title: "打开 GitHub CLI 官方下载主页获取安装包"
+                }, "🌐 官网安装包 (.msi/.pkg)")
+                : null, h("button", {
+                className: "dsh-github-action-btn",
+                onClick: onRefresh,
+                title: "重新检测登录与安装状态"
+            }, "🔄 刷新状态")), 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 加密保存在操作系统安全凭据库中，授权完毕切回本窗口将自动识别刷新。"));
+        }
         // 渲染 GitHub 仓库信息与操作视图的核心函数
         function renderGithubRepoView(h, data, loading, error, onRefresh, isRightbar = false) {
             var auth = data ? data.auth : null;
@@ -749,7 +967,10 @@ body[data-ds-dark-theme] .dsh-github-subheading {
                     : r.conclusion === "failure"
                         ? h("span", { className: "dsh-github-badge dsh-badge-red" }, "✕ 失败")
                         : h("span", { className: "dsh-github-badge dsh-badge-yellow" }, r.status))))));
-            return [headerEl, repoCardEl, actionsBarEl, prSectionEl, runSectionEl];
+            var authGuideEl = !auth?.loggedIn
+                ? h(AuthGuideCard, { auth, onRefresh, isRightbar })
+                : null;
+            return [headerEl, authGuideEl, repoCardEl, actionsBarEl, prSectionEl, runSectionEl].filter(Boolean);
         }
         // 1. 右侧栏专属视图 (Right Sidebar Tab Body)
         function GithubRightbarBody(props) {
@@ -806,6 +1027,16 @@ body[data-ds-dark-theme] .dsh-github-subheading {
             React.useEffect(() => {
                 loadData(false);
             }, [loadData]);
+            // 窗口切回自动探测自愈
+            React.useEffect(() => {
+                var onFocus = () => {
+                    if (!data?.auth?.loggedIn) {
+                        loadData(false);
+                    }
+                };
+                window.addEventListener("focus", onFocus);
+                return () => window.removeEventListener("focus", onFocus);
+            }, [data, loadData]);
             var h = React.createElement;
             return h("div", { className: "dsh-github-rightbar-container" }, ...renderGithubRepoView(h, data, loading, error, () => loadData(true), true));
         }
@@ -837,29 +1068,57 @@ body[data-ds-dark-theme] .dsh-github-subheading {
             var loadData = React.useCallback(async (forceRefresh = false) => {
                 setLoading(true);
                 setError(null);
+                // 全局驾驶舱要 spawn 十几次 gh，冷启动可能超过 10 秒。
+                // 不设显式超时的话浏览器会抛一个与真实原因无关的网络错误，
+                // 早先这里会把所有失败都归因成「后端服务未就绪或接口不存在」——归因错误比没有报错更糟。
+                var controller = new AbortController();
+                var timedOut = false;
+                var timer = setTimeout(function () { timedOut = true; controller.abort(); }, 30000);
                 try {
                     if (forceRefresh)
                         await fetch("/api/github/refresh", { method: "POST" }).catch(() => { });
-                    var res = await fetch("/api/github/global-overview");
+                    var res = await fetch("/api/github/global-overview", { signal: controller.signal });
                     if (!res.ok) {
                         var errText = await res.text().catch(() => "");
-                        setError(`后端服务未就绪或接口不存在 (${res.status}): ${errText || res.statusText}`);
+                        setError(`获取全局数据失败（HTTP ${res.status}）${errText ? ": " + errText : ""}`);
                         return;
                     }
                     var json = await res.json();
-                    if (json.ok && json.data)
+                    if (json.ok && json.data) {
                         setData(json.data);
-                    else
+                        // 工作区矩阵单独失败时不能静默：否则界面显示「暂无工作区」，把故障伪装成空状态
+                        if (json.data.workspaceError) {
+                            setError("工作区列表读取失败：" + json.data.workspaceError);
+                        }
+                    }
+                    else {
                         setError(json.error || "获取全局数据失败");
+                    }
                 }
                 catch (err) {
-                    setError(err.message);
+                    if (timedOut || err.name === "AbortError") {
+                        setError("获取超时（30 秒）：本机 gh 命令响应过慢，通常是网络或工作区数量较多所致。可稍后重试，或减少同时打开的工作区。");
+                    }
+                    else {
+                        setError("无法连接后端服务：" + (err.message || err));
+                    }
                 }
                 finally {
+                    clearTimeout(timer);
                     setLoading(false);
                 }
             }, []);
             React.useEffect(() => { loadData(false); }, [loadData]);
+            // 窗口切回自动探测自愈
+            React.useEffect(() => {
+                var onFocus = () => {
+                    if (!data?.auth?.loggedIn) {
+                        loadData(false);
+                    }
+                };
+                window.addEventListener("focus", onFocus);
+                return () => window.removeEventListener("focus", onFocus);
+            }, [data, loadData]);
             var h = React.createElement;
             var headerEl = h("div", { className: "dsh-github-header" }, h("div", { className: "dsh-github-title" }, renderOctocatBadge(32), h("h2", null, "GitHub 全景驾驶舱")), h("button", {
                 className: "dsh-github-refresh-btn",
@@ -876,7 +1135,19 @@ body[data-ds-dark-theme] .dsh-github-subheading {
             var myIssues = (data && data.myIssues) || [];
             var errorEl = error ? h("div", { style: { color: "#f85149", background: "rgba(248,81,73,0.1)", border: "1px solid rgba(248,81,73,0.3)", padding: "8px 12px", borderRadius: "6px", marginBottom: "16px", fontSize: "12px" } }, `⚠️ 加载失败: ${error}`) : null;
             // 顶部统计卡片
-            var statsCardsEl = h("div", { className: "dsh-github-overview-cards" }, h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "CLI 认证账号"), h("div", { className: "dsh-github-card-value" }, auth?.loggedIn ? `👤 ${auth.user}` : "未登录", auth?.loggedIn ? h("span", { className: "dsh-github-badge dsh-badge-green" }, "Active") : null)), h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "账号云端仓库"), h("div", { className: "dsh-github-card-value" }, `${userRepos.length} 个 Repositories`)), h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "本地工作区联动"), h("div", { className: "dsh-github-card-value" }, `${workspaceMatrix.length} 个工作区 (${workspaceMatrix.filter((w) => w.repo).length} 个已关联)`)));
+            var statsCardsEl = h("div", { className: "dsh-github-overview-cards" }, h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "CLI 认证账号"), h("div", { className: "dsh-github-card-value" }, auth?.loggedIn
+                ? `👤 ${auth.user}`
+                : !auth?.installed
+                    ? "❌ 未安装 CLI"
+                    : "⚠️ 未登录", auth?.loggedIn
+                ? h("span", { className: "dsh-github-badge dsh-badge-green" }, "Active")
+                : !auth?.installed
+                    ? h("span", { className: "dsh-github-badge dsh-badge-red" }, "Missing")
+                    : h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "Required"))), h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "账号云端仓库"), h("div", { className: "dsh-github-card-value" }, `${userRepos.length} 个 Repositories`)), h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "本地工作区联动"), h("div", { className: "dsh-github-card-value" }, `${workspaceMatrix.length} 个工作区 (${workspaceMatrix.filter((w) => w.repo).length} 个已关联)`)));
+            // 安装与登录引导组件（未登录或未安装时显式展开）
+            var authGuideEl = !auth?.loggedIn
+                ? h(AuthGuideCard, { auth, onRefresh: () => loadData(true), isRightbar: false })
+                : null;
             // Tab 栏
             var tabsEl = h("div", { className: "dsh-github-tabs" }, h("button", { className: `dsh-github-tab-btn ${activeTab === 'workspaces' ? 'active' : ''}`, onClick: () => setActiveTab('workspaces') }, `📂 本地工作区矩阵 (${workspaceMatrix.length})`), h("button", { className: `dsh-github-tab-btn ${activeTab === 'repos' ? 'active' : ''}`, onClick: () => setActiveTab('repos') }, `☁️ 我的 GitHub 仓库 (${userRepos.length})`), h("button", { className: `dsh-github-tab-btn ${activeTab === 'mywork' ? 'active' : ''}`, onClick: () => setActiveTab('mywork') }, `📋 个人待办 (PR: ${myPrs.length} · Issue: ${myIssues.length})`));
             // 内容区
@@ -889,18 +1160,28 @@ body[data-ds-dark-theme] .dsh-github-subheading {
                     : null))));
             }
             else if (activeTab === 'repos') {
-                var filteredRepos = userRepos.filter((r) => !searchQuery || r.nameWithOwner.toLowerCase().includes(searchQuery.toLowerCase()) || r.description?.toLowerCase().includes(searchQuery.toLowerCase()));
-                contentEl = h("div", null, h("input", {
-                    className: "dsh-github-search-input",
-                    placeholder: "🔍 搜索我的 GitHub 仓库...",
-                    value: searchQuery,
-                    onChange: (e) => setSearchQuery(e.target.value)
-                }), h("div", { className: "dsh-github-list" }, filteredRepos.map((r) => h("div", { key: r.nameWithOwner, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: r.url, target: "_blank" }, r.nameWithOwner), r.description ? h("div", { className: "dsh-github-item-desc" }, r.description) : null, h("div", { className: "dsh-github-item-meta" }, h("span", null, `默认分支: ${r.defaultBranch}`), r.isPrivate ? h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "Private") : h("span", { className: "dsh-github-badge dsh-badge-green" }, "Public"), h("span", null, `⭐ ${r.stargazerCount}`))))));
+                if (!auth?.loggedIn) {
+                    contentEl = h("div", { className: "dsh-github-empty" }, "当前尚未认证登录 GitHub 账号，无法读取云端仓库列表。请先完成上方的安装或登录指引。");
+                }
+                else {
+                    var filteredRepos = userRepos.filter((r) => !searchQuery || r.nameWithOwner.toLowerCase().includes(searchQuery.toLowerCase()) || r.description?.toLowerCase().includes(searchQuery.toLowerCase()));
+                    contentEl = h("div", null, h("input", {
+                        className: "dsh-github-search-input",
+                        placeholder: "🔍 搜索我的 GitHub 仓库...",
+                        value: searchQuery,
+                        onChange: (e) => setSearchQuery(e.target.value)
+                    }), h("div", { className: "dsh-github-list" }, filteredRepos.map((r) => h("div", { key: r.nameWithOwner, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: r.url, target: "_blank" }, r.nameWithOwner), r.description ? h("div", { className: "dsh-github-item-desc" }, r.description) : null, h("div", { className: "dsh-github-item-meta" }, h("span", null, `默认分支: ${r.defaultBranch}`), r.isPrivate ? h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "Private") : h("span", { className: "dsh-github-badge dsh-badge-green" }, "Public"), h("span", null, `⭐ ${r.stargazerCount}`))))));
+                }
             }
             else {
-                contentEl = h("div", null, h("h3", { className: "dsh-github-subheading" }, `🔀 我发起的 PR (${myPrs.length})`), myPrs.length === 0 ? h("div", { className: "dsh-github-empty", style: { marginBottom: "16px" } }, "暂无开放中的 PR") : h("div", { className: "dsh-github-list", style: { marginBottom: "16px" } }, myPrs.map((pr) => h("div", { key: pr.number, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: pr.url, target: "_blank" }, `[${pr.repository?.nameWithOwner || 'Repo'}] #${pr.number} ${pr.title}`)))), h("h3", { className: "dsh-github-subheading" }, `📝 我的待办 Issues (${myIssues.length})`), myIssues.length === 0 ? h("div", { className: "dsh-github-empty" }, "暂无开放中的 Issue") : h("div", { className: "dsh-github-list" }, myIssues.map((is) => h("div", { key: is.number, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: is.url, target: "_blank" }, `[${is.repository?.nameWithOwner || 'Repo'}] #${is.number} ${is.title}`)))));
+                if (!auth?.loggedIn) {
+                    contentEl = h("div", { className: "dsh-github-empty" }, "当前尚未认证登录 GitHub 账号，无法读取个人待办 PR 与 Issues。请先完成上方的安装或登录指引。");
+                }
+                else {
+                    contentEl = h("div", null, h("h3", { className: "dsh-github-subheading" }, `🔀 我发起的 PR (${myPrs.length})`), myPrs.length === 0 ? h("div", { className: "dsh-github-empty", style: { marginBottom: "16px" } }, "暂无开放中的 PR") : h("div", { className: "dsh-github-list", style: { marginBottom: "16px" } }, myPrs.map((pr) => h("div", { key: pr.number, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: pr.url, target: "_blank" }, `[${pr.repository?.nameWithOwner || 'Repo'}] #${pr.number} ${pr.title}`)))), h("h3", { className: "dsh-github-subheading" }, `📝 我的待办 Issues (${myIssues.length})`), myIssues.length === 0 ? h("div", { className: "dsh-github-empty" }, "暂无开放中的 Issue") : h("div", { className: "dsh-github-list" }, myIssues.map((is) => h("div", { key: is.number, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: is.url, target: "_blank" }, `[${is.repository?.nameWithOwner || 'Repo'}] #${is.number} ${is.title}`)))));
+                }
             }
-            return h("div", { className: "dsh-github-panel" }, headerEl, errorEl, statsCardsEl, tabsEl, contentEl);
+            return h("div", { className: "dsh-github-panel" }, headerEl, errorEl, statsCardsEl, authGuideEl, tabsEl, contentEl);
         }
         var inject = ["slots", "sidebarRightTabs", "sessions", "layout", "theme"];
         function apply(ctx) {

package/lib/commands/gh.js

@@ -7,7 +7,9 @@ export function registerGhCommand(commandsService, executor) {
         async handler({ rawInput }) {
             const trimmed = (rawInput || '').trim();
             if (!trimmed || trimmed === 'status') {
-                const auth = await executor.checkAuth();
+                // 人类显式诊断必须绕过缓存：用户敲 /gh status 往往正是为了确认
+                // 「我刚 gh auth login 到底成没成」，给他 30 秒前的缓存等于答非所问。
+                const auth = await executor.checkAuth(undefined, true);
                 const repo = await executor.getRepoMetadata();
                 let md = `### GitHub 集成状态\n\n`;
                 if (auth.loggedIn) {

package/lib/executor.d.ts

@@ -1,8 +1,21 @@
 import type { GhExecutionOptions, GhResult, AuthStatus, RepoMetadata, PluginConfig } from './types.js';
+/**
+ * 按「字符数 + UTF-8 字节数」双口径截断输出。
+ * 抽成纯函数是刻意的：截断逻辑是崩溃高发区（切碎多字节字符、误伤 JSON、把二进制流截成垃圾），
+ * 但通过真实 gh 命令很难稳定复现超限输出，抽出来才能用单元测试覆盖边界。
+ */
+export declare function truncateOutput(input: string, maxChars: number, maxBytes: number): {
+    text: string;
+    truncated: boolean;
+};
 export declare class GhExecutor {
     ghPath: string;
     defaultTimeoutMs: number;
     maxOutputChars: number;
+    /** UTF-8 字节口径的硬上限；未配置时按 maxOutputChars × 4 推导（覆盖 CJK 3 字节与 emoji 4 字节） */
+    maxOutputBytes: number;
+    /** 认证状态缓存。`gh auth status` 实测 5.4 秒，而它位于全局驾驶舱关键路径的最前面 */
+    private authCache;
     constructor(config?: PluginConfig);
     updateConfig(config?: PluginConfig): void;
     /**
@@ -20,8 +33,26 @@ export declare class GhExecutor {
     run<T = unknown>(args: string[], options?: GhExecutionOptions): Promise<GhResult<T>>;
     /**
      * 检查宿主机当前 GitHub CLI 的认证状态与账号信息
+     *
+     * @param cwd 解析工作区用的路径
+     * @param bypassCache 跳过进程内缓存。`/gh status` 这类人类显式发起的诊断必须看到实时结果，
+     *   而 Web 面板每次挂载都会来问一次，重复执行实测要 5.4 秒，属于纯浪费。
      */
-    checkAuth(cwd?: string): Promise<AuthStatus>;
+    checkAuth(cwd?: string, bypassCache?: boolean): Promise<AuthStatus>;
+    /** 生成当前操作系统平台的推荐安装引导与命令 */
+    private getPlatformInstallGuide;
+    /** 实际执行 `gh auth status` 并解析结果，不含缓存逻辑 */
+    private probeAuth;
+    /**
+     * 仅从本地 .git/config 解析仓库身份，绝不发起网络请求。
+     *
+     * 为什么需要它：全局驾驶舱要为每个工作区认识别仓库，而 getRepoMetadata 会调用
+     * `gh repo view` 走网络。实测 5 个工作区时该端点冷启动 20.5 秒，其中绝大部分耗在这 5 次
+     * 网络往返上——而有界并发根本救不了它，因为瓶颈是网络延迟而不是进程排队。
+     * 工作区矩阵只需要「这个目录属于哪个仓库」这一身份信息，本地 .git/config 已经完整具备，
+     * 描述/star 数等富字段是当前仓库详情才需要的。这一步把每个工作区从 1 次网络往返降为 0。
+     */
+    getRepoIdentityFromLocal(cwd?: string): RepoMetadata | null;
     /**
      * 获取当前目录（工作区）关联的远程仓库元数据
      * 采用 gh repo view + 本地 git remote 双保险机制，彻底杜绝已配置远程却误判未关联的问题