dsh-github-flow 0.1.2 → 0.1.4

package/README.en.md

@@ -22,17 +22,19 @@
 
 1. **Zero-Configuration Authentication**:
    - Seamlessly reuses existing host credentials from `gh auth login` (OAuth tokens / system Keyrings) without exposing plain-text Personal Access Tokens (PATs) in DSH.
-2. **Deep Workspace Affinity (CWD Binding)**:
-   - Automatically scopes commands to the active session workspace. `gh` resolves the remote repository and current Git branch automatically, saving model tokens from redundant `owner/repo` arguments.
+2. **Deep Workspace Affinity & Zero-Config Detection**:
+   - Automatically scopes commands to the active session workspace by natively reading local `.git/config` and mapping DSH `workspace.json`. Neither models nor humans need to supply redundant `owner/repo` arguments.
 3. **High Signal-to-Noise Ratio & Token Budget Protection**:
    - Consolidates over 70+ scattered micro-tools into **5 focused domain tools**.
    - Queries use `--json <fields>` projections by default; long diffs and failed CI logs are safely truncated (default 24KB) to protect the model's context window.
-4. **Dual Native Web UI Views**:
+   - All tool outputs are defensively normalized into root objects to strictly comply with DSH Tool Gateway schema validation.
+4. **Dual Native Web UI Views & Dynamic Dual-Theme Support**:
    - **Global Cockpit** (`sidebar.panellist`, Order 20): Account-wide repository overview, local workspace matrix, and pending personal PRs/issues.
-   - **Right Sidebar Panel** (`sidebarRightTabs`, Order 40): Shows current repository status, PR list with CI check pills, and quick action buttons inside the session.
+   - **Right Sidebar Panel** (`sidebarRightTabs`, Order 40): Shows current repository status, PR list with CI check pills, and a 2x2 quick action grid (Open Repo, View PRs, Create PR, New Issue) with zero popup dependencies.
+   - **Native Light/Dark Dual-Theme Adaptation**: Deeply aligned with DSH official DSW (DeepSeek Web) design tokens, seamlessly reacting to `body[data-ds-dark-theme]` without lag or flickering.
 5. **Standard Cordis Microkernel Compliance**:
    - Exposes native `GitHubService` (`ctx.github`) for ecosystem extensibility;
-   - Strongly typed runtime validation via Schemastery (`Config`);
+   - Strongly typed runtime validation via Standard Schema (`Config`);
    - Domain event broadcasting (`github/pr:create`, `github/issue:create`).
 
 ---

package/README.md

@@ -22,17 +22,19 @@
 
 1. **零鉴权配置，开箱即用**：
    - 自动复用宿主机已通过 `gh auth login` 认证的登录凭据（OAuth Token / 系统 Keyring），无需在 DSH 中存储任何明文 GitHub PAT。
-2. **工作区目录深度亲和 (CWD 绑定)**：
-   - 自动继承当前会话所在的 Workspace 物理目录，`gh` 自动识别当前 Git 仓库与本地工作分支，无需 Agent 每次显式传递 `owner/repo`。
+2. **工作区目录深度亲和与零参数探测 (CWD & Git Auto-Binding)**：
+   - 自动绑定当前会话所在的物理工作区目录，原生直读本地 `.git/config` 并映射 `workspace.json`，无需 Agent 或人类手动传参 `owner/repo`，零参数直接识别关联仓库。
 3. **高信噪比与 Token 防溢出治理**：
    - 拒绝 70+ 个碎片化微型工具撑爆上下文，收敛聚合为 **5 大领域核心 Tool**。
    - 所有查询原生采用 `--json <fields>` 按需返回；对 `diff`、`log_failed` 设置安全截断保护（默认 24KB），防止模型上下文窗口溢出崩溃。
-4. **原生 Web UI 双重视图**：
+   - 工具层已通过防御性输出包装，列表与标量 100% 契合 DSH 工具网关模式约束。
+4. **原生 Web UI 双重视图与双模式自适应**：
    - **全局驾驶舱**（主导航栏 `sidebar.panellist`，Order 20）：透视账号全局仓库、本地工作区矩阵、个人待办 PR 与 Issues；
-   - **右侧栏工作区面板**（`sidebarRightTabs`，Order 40）：在会话引导页与右侧抽屉常驻呈现当前仓库的 PR 列表、Checks 状态药丸与快捷操作。
+   - **右侧栏工作区面板**（`sidebarRightTabs`，Order 40）：常驻呈现当前仓库的 PR 状态、Checks 门禁药丸与 2x2 黄金快捷网格（浏览器打开、查看 PRs、快速创建 PR、新建 Issue），一键直达官方比对与创建页，零弹窗依赖；
+   - **全场景双模式原生自适应**：深度契合 DSH 官方 DSW（DeepSeek Web）设计变量规范，通过 `body[data-ds-dark-theme]` 驱动浅色与深色主题实时零延迟平滑切换。
 5. **符合 Cordis 官方微内核架构**：
    - 暴露原生 `GitHubService`（`ctx.github`），允许生态其他插件复用；
-   - 具备 Schemastery 强类型运行时配置校验（`Config`）；
+   - 具备符合 Standard Schema 规范的运行时配置校验（`Config`）；
    - 支持领域事件系统（`github/pr:create`, `github/issue:create`）。
 
 ---

package/cordis.patch.yml

@@ -1,3 +1,3 @@
 - insert:
-    - id: github-flow-v3
-      name: 'D:/Desktop/AgentWork/DSHQuestion/dsh-github-flow/lib/main.js'
+    - id: github-flow
+      name: dsh-github-flow

package/docs/architecture.md

@@ -55,15 +55,21 @@
 - 直接复用宿主机由 `gh auth login` 认证的安全凭证（系统 Keychain / Windows Credential Manager / 系统的加密存储）；
 - 天然支持多账号、企业 GitHub (GH Enterprise) 以及各种 OAuth 作用域。
 
-### 2.2 工作区 CWD 亲和 (Workspace Affinity)
-- 会话内的所有命令默认在当前 Agent 会话物理目录（`cwd`）执行；
-- `gh` 引擎自动逆向推导关联的远程仓库（识别 `origin` 或 `github` remote），免去大模型每次必须传递 `owner/repo` 的繁重上下文负担。
+### 2.2 工作区深度亲和与零参数探测 (Workspace Affinity & Auto-Binding)
+- 结合 `$env:DSH_SESSION_ID` 逆向解析 `~/.dsh/storages/workspace.json`，自动锁定当前活跃会话物理工作区；
+- 原生免子进程直接读取工作区 `.git/config`，自动识别远程仓库，免去大模型或人类每次传递 `owner/repo` 的繁重上下文负担；
+- 具备离线优雅兜底机制，无论在何种受限环境下调用均不崩溃。
 
-### 2.3 上下文 Token 保护 (Token Budget Guard)
+### 2.3 上下文 Token 保护与防御性输出包装 (Token Budget Guard)
 - 所有的 `gh` 查询原生采用 `--json <fields>` 结构化投影；
-- 对长文本输出（如大型 PR 的完整 `diff`、CI 失败步骤日志）设置安全截断阈值（默认 24KB），保留头尾关键上下文并添加显式截断标记，杜绝撑爆模型上下文。
+- 对长文本输出（如大型 PR 的完整 `diff`、CI 失败步骤日志）设置安全截断阈值（默认 24KB），保留头尾关键上下文并添加显式截断标记，杜绝撑爆模型上下文；
+- 所有 Agent 工具的输出统一经过 `normalizeOutput` 归一化，列表自动打包为 `{ items, count }`，标量打包为 `{ result }`，100% 严丝合缝契合 DSH 工具网关模式约束。
 
-### 2.4 Cordis 微内核标准规范
-- **硬依赖解耦**：顶层仅强依赖 `['tools']`，Web 服务与命令服务采用动态作用域注入，在纯终端 / Headless 模式下零卡死；
+### 2.4 原生浅色/深色主题自适应与 2x2 黄金操作栏
+- 全面对齐 DSH 官方 DSW 语义设计变量，基于 `body[data-ds-dark-theme]` 驱动无闪烁双模式切换；
+- 右侧栏 2x2 快捷操作栏彻底废弃失效的 Electron `prompt()` 阻塞弹窗，全面采用官方直达模式（Compare / New Issue），享有 100% 官方富文本体验。
+
+### 2.5 Cordis 微内核标准规范
+- **服务依赖就绪**：声明 `['tools', 'commands', 'webServer', 'workspaceRegistry']`，确保 Web 路由与命令服务在环境就绪后激活；
 - **生命周期 Effect 闭环**：所有 HTTP 路由与命令注册均持有 Disposer 清理函数，插件热重载或重新挂载时自动彻底注销，零内存泄漏；
-- **配置自校验**：基于 `@deepseek-ai/schemastery` 实现强类型声明与运行时校验。
+- **配置自校验与服务暴露**：基于 Standard Schema 规范实现强类型校验与默认值注入，通过 `ctx.provide('github', executor)` 向生态插件暴露单例服务。

package/lib/client.js

@@ -304,6 +304,80 @@ body[data-ds-dark-theme] .dsh-github-action-btn:hover {
   color: #58a6ff;
 }
 
+/* 组合式快捷操作按钮 (AI 智能装填主操作 + 官方外链直达) */
+.dsh-github-split-btn {
+  display: flex;
+  align-items: stretch;
+  border-radius: 6px;
+  border: 1px solid var(--dsw-alias-border-l2, #e1e4e8);
+  background: var(--dsw-alias-bg-module-platform, #f6f8fa);
+  overflow: hidden;
+  transition: all 0.15s ease;
+}
+.dsh-github-split-btn:hover {
+  border-color: var(--dsw-alias-link, #0969da);
+}
+body[data-ds-dark-theme] .dsh-github-split-btn {
+  border-color: var(--dsw-alias-border-l1, #444);
+  background: var(--dsw-alias-bg-layer-2, #28282b);
+}
+body[data-ds-dark-theme] .dsh-github-split-btn:hover {
+  border-color: #58a6ff;
+}
+.dsh-github-split-main {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 5px;
+  padding: 8px 8px;
+  border: 0;
+  background: transparent;
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font-size: 12px;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  white-space: nowrap;
+}
+.dsh-github-split-main:hover {
+  background: var(--dsw-alias-interactive-bg-hover, #ebeef2);
+  color: var(--dsw-alias-link, #0969da);
+}
+body[data-ds-dark-theme] .dsh-github-split-main {
+  color: var(--dsw-alias-label-primary, #fff);
+}
+body[data-ds-dark-theme] .dsh-github-split-main:hover {
+  background: var(--dsw-alias-interactive-bg-hover, #343438);
+  color: #58a6ff;
+}
+.dsh-github-split-link {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0 8px;
+  border-left: 1px solid var(--dsw-alias-border-l2, #e1e4e8);
+  background: transparent;
+  color: var(--dsw-alias-label-tertiary, #656d76);
+  font-size: 12px;
+  font-weight: bold;
+  text-decoration: none !important;
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+.dsh-github-split-link:hover {
+  background: var(--dsw-alias-interactive-bg-hover, #ebeef2);
+  color: var(--dsw-alias-link, #0969da);
+}
+body[data-ds-dark-theme] .dsh-github-split-link {
+  border-left-color: var(--dsw-alias-border-l1, #444);
+  color: var(--dsw-alias-label-secondary, #9ca3af);
+}
+body[data-ds-dark-theme] .dsh-github-split-link:hover {
+  background: var(--dsw-alias-interactive-bg-hover, #343438);
+  color: #58a6ff;
+}
+
 /* 9. 模块分区与列表 */
 .dsh-github-section {
   margin-bottom: 20px;
@@ -609,23 +683,6 @@ body[data-ds-dark-theme] .dsh-github-subheading {
                 onClick: onRefresh,
                 disabled: loading,
             }, loading ? "刷新中..." : "🔄 刷新"));
-            // 操作执行函数
-            const runAction = async (action, extra = {}) => {
-                try {
-                    const res = await fetch("/api/github/action", {
-                        method: "POST",
-                        headers: { "Content-Type": "application/json" },
-                        body: JSON.stringify({ action, ...extra }),
-                    });
-                    const json = await res.json();
-                    alert(json.ok ? `✅ ${json.message || "操作已完成"}` : `❌ ${json.error || "操作失败"}`);
-                    if (json.ok)
-                        onRefresh();
-                }
-                catch (err) {
-                    alert(`网络异常: ${err.message}`);
-                }
-            };
             // 仓库基础卡片
             var repoCardEl = h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "当前工作区 GitHub 仓库"), h("div", { className: "dsh-github-card-value" }, repo
                 ? h("a", { href: repo.url, target: "_blank", className: "dsh-github-repo-link" }, repo.nameWithOwner)
@@ -636,40 +693,46 @@ body[data-ds-dark-theme] .dsh-github-subheading {
                 : null, !repo
                 ? h("div", { className: "dsh-github-card-subtext" }, "若本地已有 git 仓库，请运行 `git remote add github <url>` 或 `git remote add origin <url>` 关联远程仓库。")
                 : null);
-            // 快捷操作栏
-            var actionsBarEl = h("div", { className: "dsh-github-quick-actions" }, h("button", {
+            // 快捷操作栏 (方案 1: 官方黄金功能直达)
+            var actionsBarEl = h("div", { className: "dsh-github-quick-actions" }, 
+            // 1. 浏览器打开仓库主页
+            h("button", {
                 className: "dsh-github-action-btn",
+                title: "在系统默认浏览器中打开当前仓库主页",
                 onClick: () => {
                     if (repo?.url) {
                         window.open(repo.url, "_blank", "noopener,noreferrer");
                     }
-                    else {
-                        alert("当前工作区尚未关联 GitHub 仓库");
-                    }
                 },
-            }, "🌐 浏览器打开"), h("button", {
+            }, "🌐 浏览器打开"), 
+            // 2. 查看所有 PRs
+            h("button", {
                 className: "dsh-github-action-btn",
+                title: "在系统默认浏览器中查看所有 Pull Requests",
                 onClick: () => {
                     if (repo?.url) {
                         window.open(`${repo.url}/pulls`, "_blank", "noopener,noreferrer");
                     }
-                    else {
-                        alert("当前工作区尚未关联 GitHub 仓库");
-                    }
                 },
-            }, "🔀 查看所有 PRs"), h("button", {
+            }, "🔀 查看所有 PRs"), 
+            // 3. 🚀 快速创建 PR (官方对比与创建页直达)
+            h("button", {
                 className: "dsh-github-action-btn",
+                title: "在系统默认浏览器中打开 GitHub 官方对比与创建 Pull Request 页面",
                 onClick: () => {
-                    var title = prompt("请输入要创建的 PR 标题:");
-                    if (title)
-                        runAction("create_pr", { title });
+                    if (repo?.url) {
+                        window.open(`${repo.url}/compare`, "_blank", "noopener,noreferrer");
+                    }
                 },
-            }, "🚀 快速创建 PR"), h("button", {
+            }, "🚀 快速创建 PR"), 
+            // 4. 📝 新建 Issue (官方 Issue 模板页直达)
+            h("button", {
                 className: "dsh-github-action-btn",
+                title: "在系统默认浏览器中打开 GitHub 官方新建 Issue 页面",
                 onClick: () => {
-                    var title = prompt("请输入 Issue 标题:");
-                    if (title)
-                        runAction("create_issue", { title });
+                    if (repo?.url) {
+                        window.open(`${repo.url}/issues/new`, "_blank", "noopener,noreferrer");
+                    }
                 },
             }, "📝 新建 Issue"));
             // PR 列表
@@ -720,6 +783,11 @@ body[data-ds-dark-theme] .dsh-github-subheading {
                         url += "?" + params.join("&");
                     }
                     var res = await fetch(url);
+                    if (!res.ok) {
+                        var errText = await res.text().catch(() => "");
+                        setError(`后端服务未就绪 (${res.status}): ${errText || res.statusText}`);
+                        return;
+                    }
                     var json = await res.json();
                     if (json.ok && json.data) {
                         setData(json.data);
@@ -773,6 +841,11 @@ body[data-ds-dark-theme] .dsh-github-subheading {
                     if (forceRefresh)
                         await fetch("/api/github/refresh", { method: "POST" }).catch(() => { });
                     var res = await fetch("/api/github/global-overview");
+                    if (!res.ok) {
+                        var errText = await res.text().catch(() => "");
+                        setError(`后端服务未就绪或接口不存在 (${res.status}): ${errText || res.statusText}`);
+                        return;
+                    }
                     var json = await res.json();
                     if (json.ok && json.data)
                         setData(json.data);

package/lib/executor.d.ts

@@ -5,6 +5,14 @@ export declare class GhExecutor {
     maxOutputChars: number;
     constructor(config?: PluginConfig);
     updateConfig(config?: PluginConfig): void;
+    /**
+     * 智能解析最可靠的工作区物理路径：
+     * 1. 优先使用显式指定的有效 cwd（若包含 .git 目录）
+     * 2. 读取当前进程/会话的 DSH_SESSION_ID 并匹配 ~/.dsh/storages/workspace.json
+     * 3. 匹配 ~/.dsh/storages/workspace.json 中最近活跃的工作区
+     * 4. 回退到 process.cwd()
+     */
+    resolveWorkspaceCwd(explicitCwd?: string): string;
     /**
      * 安全执行 gh 命令
      * 采用 execFile 参数数组隔离，彻底杜绝 Shell 字符串拼接注入漏洞

package/lib/executor.js

@@ -1,5 +1,8 @@
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
 const execFileAsync = promisify(execFile);
 export class GhExecutor {
     ghPath;
@@ -18,12 +21,61 @@ export class GhExecutor {
         if (config.maxOutputChars)
             this.maxOutputChars = config.maxOutputChars;
     }
+    /**
+     * 智能解析最可靠的工作区物理路径：
+     * 1. 优先使用显式指定的有效 cwd（若包含 .git 目录）
+     * 2. 读取当前进程/会话的 DSH_SESSION_ID 并匹配 ~/.dsh/storages/workspace.json
+     * 3. 匹配 ~/.dsh/storages/workspace.json 中最近活跃的工作区
+     * 4. 回退到 process.cwd()
+     */
+    resolveWorkspaceCwd(explicitCwd) {
+        if (explicitCwd) {
+            try {
+                if (fs.existsSync(path.join(explicitCwd, '.git'))) {
+                    return explicitCwd;
+                }
+            }
+            catch { }
+        }
+        try {
+            const wsJsonPath = path.join(os.homedir(), '.dsh', 'storages', 'workspace.json');
+            if (fs.existsSync(wsJsonPath)) {
+                const wsData = JSON.parse(fs.readFileSync(wsJsonPath, 'utf8'));
+                const workspaces = wsData.tables?.workspaces || {};
+                // A. 优先通过 DSH 会话 ID 精准匹配物理工作区
+                const sessionId = process.env.DSH_SESSION_ID;
+                if (sessionId) {
+                    for (const wsId of Object.keys(workspaces)) {
+                        const item = workspaces[wsId];
+                        if (item.sessionIds && Array.isArray(item.sessionIds) && item.sessionIds.includes(sessionId)) {
+                            if (item.path && fs.existsSync(item.path)) {
+                                return item.path;
+                            }
+                        }
+                    }
+                }
+                // B. 兜底匹配最近活跃更新的工作区
+                let latestItem = null;
+                for (const wsId of Object.keys(workspaces)) {
+                    const item = workspaces[wsId];
+                    if (!latestItem || new Date(item.updatedAt || 0) > new Date(latestItem.updatedAt || 0)) {
+                        latestItem = item;
+                    }
+                }
+                if (latestItem && latestItem.path && fs.existsSync(latestItem.path)) {
+                    return latestItem.path;
+                }
+            }
+        }
+        catch { }
+        return explicitCwd || process.cwd();
+    }
     /**
      * 安全执行 gh 命令
      * 采用 execFile 参数数组隔离，彻底杜绝 Shell 字符串拼接注入漏洞
      */
     async run(args, options = {}) {
-        const cwd = options.cwd || process.cwd();
+        const cwd = this.resolveWorkspaceCwd(options.cwd);
         const timeout = options.timeoutMs || this.defaultTimeoutMs;
         try {
             const { stdout, stderr } = await execFileAsync(this.ghPath, args, {
@@ -144,7 +196,7 @@ export class GhExecutor {
      * 采用 gh repo view + 本地 git remote 双保险机制，彻底杜绝已配置远程却误判未关联的问题
      */
     async getRepoMetadata(cwd) {
-        const targetCwd = cwd || process.cwd();
+        const targetCwd = this.resolveWorkspaceCwd(cwd);
         // 1. 优先尝试由 gh 直接根据当前上下文识别
         const res = await this.run(['repo', 'view', '--json', 'nameWithOwner,name,owner,defaultBranchRef,description,isPrivate,url'], { cwd: targetCwd, timeoutMs: 10_000 });
         if (res.ok && res.data && res.data.nameWithOwner) {
@@ -159,20 +211,17 @@ export class GhExecutor {
                 url: d.url || `https://github.com/${d.nameWithOwner}`,
             };
         }
-        // 2. 双保险兜底：如果 gh 未能自动推断（如当前分支未推送到 upstream），直接解析本地 git remote
+        // 2. 原生文件解析：直接读取本地 .git/config 文件（0 子进程开销、免疫沙箱 EPERM）
         try {
-            const { execFile } = await import('node:child_process');
-            const { promisify } = await import('node:util');
-            const execAsync = promisify(execFile);
-            const { stdout: remoteOut } = await execAsync('git', ['remote', '-v'], { cwd: targetCwd });
-            if (remoteOut) {
-                // 匹配 github.com 格式：git@github.com:owner/repo.git 或 https://github.com/owner/repo.git
-                const match = remoteOut.match(/github\.com[:/]([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+?)(?:\.git)?(?:\s|\()/i);
+            const gitConfigPath = path.join(targetCwd, '.git', 'config');
+            if (fs.existsSync(gitConfigPath)) {
+                const configText = fs.readFileSync(gitConfigPath, 'utf8');
+                const match = configText.match(/github\.com[:/]([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+?)(?:\.git)?(?:\s|\r|\n|$)/i);
                 if (match) {
                     const owner = match[1];
                     const repoName = match[2];
                     const nameWithOwner = `${owner}/${repoName}`;
-                    // 使用提取出的精确 owner/repo 向 gh 获取元数据
+                    // 使用精确的 owner/repo 向 gh 获取元数据（显式传参，不依赖无上下文的探测）
                     const directRes = await this.run(['repo', 'view', nameWithOwner, '--json', 'nameWithOwner,name,owner,defaultBranchRef,description,isPrivate,url'], { cwd: targetCwd, timeoutMs: 10_000 });
                     if (directRes.ok && directRes.data && directRes.data.nameWithOwner) {
                         const d = directRes.data;
@@ -199,9 +248,7 @@ export class GhExecutor {
                 }
             }
         }
-        catch {
-            // 本地无 git 或无 remote 配置
-        }
+        catch { }
         return null;
     }
 }

package/lib/index.d.ts

@@ -1,4 +1,2 @@
-export declare const name = "dsh-github-flow";
-export declare const inject: readonly ['tools', 'commands', 'webServer', 'workspaceRegistry'];
-export declare function apply(ctx: any): void;
-export * from './types.js';
+export * from './main.js';
+export { apply as default } from './main.js';

package/lib/index.js

@@ -1,30 +1,2 @@
-import { GhExecutor } from './executor.js';
-import { createPrTool } from './tools/pr.js';
-import { createIssueTool } from './tools/issue.js';
-import { createRunTool } from './tools/run.js';
-import { createRepoTool } from './tools/repo.js';
-import { createApiTool } from './tools/api.js';
-import { registerGhCommand } from './commands/gh.js';
-import { registerApiRoutes } from './api/routes.js';
-export const name = 'dsh-github-flow';
-export const inject = ['tools', 'commands', 'webServer', 'workspaceRegistry'];
-export function apply(ctx) {
-    const executor = new GhExecutor();
-    // 1. 注册人类 Slash 命令 (/gh status, /gh help)
-    if (ctx.commands) {
-        registerGhCommand(ctx.commands, executor);
-    }
-    // 2. 注册 Agent 模型工具集（5 大核心领域工具）
-    if (ctx.tools) {
-        ctx.tools.register(createPrTool(executor));
-        ctx.tools.register(createIssueTool(executor));
-        ctx.tools.register(createRunTool(executor));
-        ctx.tools.register(createRepoTool(executor));
-        ctx.tools.register(createApiTool(executor));
-    }
-    // 3. 注册面向 Client 端的 WebServer HTTP 路由
-    if (ctx.webServer) {
-        registerApiRoutes(ctx.webServer, executor, ctx.workspaceRegistry);
-    }
-}
-export * from './types.js';
+export * from './main.js';
+export { apply as default } from './main.js';

package/lib/main.d.ts

@@ -1,4 +1,20 @@
+import { GhExecutor } from './executor.js';
+import type { PluginConfig } from './types.js';
 export declare const name = "dsh-github-flow";
 export declare const inject: readonly ['tools', 'commands', 'webServer', 'workspaceRegistry'];
-export declare function apply(ctx: any): void;
+export type Config = PluginConfig;
+/**
+ * 符合 Standard Schema / Cordis Loader 契约的 Config 运行时校验规范
+ */
+export declare const Config: {
+    '~standard': {
+        version: number;
+        vendor: string;
+        validate(value: unknown): {
+            value: PluginConfig;
+        };
+    };
+};
+export declare function apply(ctx: any, config?: PluginConfig): void;
+export type GitHubService = GhExecutor;
 export * from './types.js';

package/lib/main.js

@@ -8,13 +8,41 @@ import { registerGhCommand } from './commands/gh.js';
 import { registerApiRoutes } from './api/routes.js';
 export const name = 'dsh-github-flow';
 export const inject = ['tools', 'commands', 'webServer', 'workspaceRegistry'];
-export function apply(ctx) {
-    const executor = new GhExecutor();
-    // 1. 注册人类 Slash 命令 (/gh status, /gh help)
+/**
+ * 符合 Standard Schema / Cordis Loader 契约的 Config 运行时校验规范
+ */
+export const Config = {
+    '~standard': {
+        version: 1,
+        vendor: 'dsh',
+        validate(value) {
+            const cfg = (typeof value === 'object' && value !== null) ? value : {};
+            return {
+                value: {
+                    ghPath: typeof cfg.ghPath === 'string' ? cfg.ghPath : 'gh',
+                    defaultTimeoutMs: typeof cfg.defaultTimeoutMs === 'number' ? cfg.defaultTimeoutMs : 30_000,
+                    maxOutputChars: typeof cfg.maxOutputChars === 'number' ? cfg.maxOutputChars : 24_000,
+                    cacheTtlMs: typeof cfg.cacheTtlMs === 'number' ? cfg.cacheTtlMs : 15_000,
+                    defaultListLimit: typeof cfg.defaultListLimit === 'number' ? cfg.defaultListLimit : 20,
+                }
+            };
+        }
+    }
+};
+export function apply(ctx, config = {}) {
+    const executor = new GhExecutor(config);
+    // 1. 兑现生态服务契约：将 GitHub 执行引擎作为服务暴露给其他 DSH 插件 (ctx.github)
+    if (ctx.provide && typeof ctx.provide === 'function') {
+        ctx.provide('github', executor);
+    }
+    else {
+        ctx.github = executor;
+    }
+    // 2. 注册人类 Slash 命令 (/gh status, /gh help)
     if (ctx.commands) {
         registerGhCommand(ctx.commands, executor);
     }
-    // 2. 注册 Agent 模型工具集（5 大核心领域工具）
+    // 3. 注册 Agent 模型工具集（5 大核心领域工具）
     if (ctx.tools) {
         ctx.tools.register(createPrTool(executor));
         ctx.tools.register(createIssueTool(executor));
@@ -22,7 +50,7 @@ export function apply(ctx) {
         ctx.tools.register(createRepoTool(executor));
         ctx.tools.register(createApiTool(executor));
     }
-    // 3. 注册面向 Client 端的 WebServer HTTP 路由
+    // 4. 注册面向 Client 端的 WebServer HTTP 路由（如果当前环境启用了 Web UI 服务）
     if (ctx.webServer) {
         registerApiRoutes(ctx.webServer, executor, ctx.workspaceRegistry);
     }

package/lib/tools/api.d.ts

@@ -31,8 +31,8 @@ export declare function createApiTool(executor: GhExecutor): {
         };
         render(args: any, value: any): {
             type: string;
-            text: string;
+            text: any;
         }[];
     };
-    execute(args: any, execContext: any): Promise<{} | undefined>;
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
 };

package/lib/tools/api.js

@@ -1,3 +1,12 @@
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
 export function createApiTool(executor) {
     return {
         name: 'github_api',
@@ -28,7 +37,15 @@ export function createApiTool(executor) {
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+                if (!value)
+                    return [{ type: 'text', text: '无返回内容' }];
+                if (typeof value.result === 'string') {
+                    return [{ type: 'text', text: value.result }];
+                }
+                if (Array.isArray(value.items)) {
+                    return [{ type: 'text', text: JSON.stringify(value.items, null, 2) }];
+                }
+                return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
             },
         },
         async execute(args, execContext) {
@@ -48,7 +65,7 @@ export function createApiTool(executor) {
             const res = await executor.run(cmd, { cwd });
             if (!res.ok)
                 throw new Error(res.error);
-            return res.data || res.rawOutput;
+            return normalizeOutput(res.data !== undefined ? res.data : res.rawOutput);
         },
     };
 }

package/lib/tools/issue.d.ts

@@ -49,8 +49,8 @@ export declare function createIssueTool(executor: GhExecutor): {
         };
         render(args: any, value: any): {
             type: string;
-            text: string;
+            text: any;
         }[];
     };
-    execute(args: any, execContext: any): Promise<{} | undefined>;
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
 };

package/lib/tools/issue.js

@@ -1,3 +1,12 @@
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
 export function createIssueTool(executor) {
     return {
         name: 'github_issue',
@@ -42,18 +51,33 @@ export function createIssueTool(executor) {
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+                if (!value)
+                    return [{ type: 'text', text: '无返回内容' }];
+                if (typeof value.result === 'string') {
+                    return [{ type: 'text', text: value.result }];
+                }
+                if (Array.isArray(value.items)) {
+                    return [{ type: 'text', text: JSON.stringify(value.items, null, 2) }];
+                }
+                return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
             },
         },
         async execute(args, execContext) {
             const cwd = execContext?.cwd || process.cwd();
-            const repoArgs = args.repo ? ['-R', args.repo] : [];
+            let repoTarget = args.repo;
+            if (!repoTarget) {
+                const meta = await executor.getRepoMetadata(cwd);
+                if (meta?.nameWithOwner) {
+                    repoTarget = meta.nameWithOwner;
+                }
+            }
+            const repoArgs = repoTarget ? ['-R', repoTarget] : [];
             switch (args.action) {
                 case 'list': {
                     const res = await executor.run(['issue', 'list', ...repoArgs, '--json', 'number,title,state,author,labels,updatedAt', '-L', '20'], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'view': {
                     if (!args.issue_number)
@@ -61,7 +85,7 @@ export function createIssueTool(executor) {
                     const res = await executor.run(['issue', 'view', String(args.issue_number), ...repoArgs, '--json', 'number,title,body,state,author,labels,assignees,comments,url'], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'create': {
                     const cmd = ['issue', 'create', ...repoArgs, '--title', args.title || '', '--body', args.body || ''];

package/lib/tools/pr.d.ts

@@ -53,8 +53,8 @@ export declare function createPrTool(executor: GhExecutor): {
         };
         render(args: any, value: any): {
             type: string;
-            text: string;
+            text: any;
         }[];
     };
-    execute(args: any, execContext: any): Promise<{} | undefined>;
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
 };

package/lib/tools/pr.js

@@ -1,3 +1,12 @@
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
 export function createPrTool(executor) {
     return {
         name: 'github_pr',
@@ -50,39 +59,54 @@ export function createPrTool(executor) {
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+                if (!value)
+                    return [{ type: 'text', text: '无返回内容' }];
+                if (typeof value.result === 'string') {
+                    return [{ type: 'text', text: value.result }];
+                }
+                if (Array.isArray(value.items)) {
+                    return [{ type: 'text', text: JSON.stringify(value.items, null, 2) }];
+                }
+                return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
             },
         },
         async execute(args, execContext) {
             const cwd = execContext?.cwd || process.cwd();
-            const repoArgs = args.repo ? ['-R', args.repo] : [];
+            let repoTarget = args.repo;
+            if (!repoTarget) {
+                const meta = await executor.getRepoMetadata(cwd);
+                if (meta?.nameWithOwner) {
+                    repoTarget = meta.nameWithOwner;
+                }
+            }
+            const repoArgs = repoTarget ? ['-R', repoTarget] : [];
             switch (args.action) {
                 case 'list': {
                     const res = await executor.run(['pr', 'list', ...repoArgs, '--json', 'number,title,author,headRefName,isDraft,state,updatedAt', '-L', '20'], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'view': {
                     const target = args.pr_number ? [String(args.pr_number)] : [];
                     const res = await executor.run(['pr', 'view', ...target, ...repoArgs, '--json', 'number,title,body,state,author,labels,assignees,reviewDecision,mergeable,statusCheckRollup,url'], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'checks': {
                     const target = args.pr_number ? [String(args.pr_number)] : [];
                     const res = await executor.run(['pr', 'checks', ...target, ...repoArgs, '--json', 'name,state,conclusion,detailsUrl'], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'diff': {
                     const target = args.pr_number ? [String(args.pr_number)] : [];
                     const res = await executor.run(['pr', 'diff', ...target, ...repoArgs], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.rawOutput || '无差异内容';
+                    return { result: res.rawOutput || '无差异内容' };
                 }
                 case 'create': {
                     const createCmd = ['pr', 'create', ...repoArgs, '--title', args.title || '', '--body', args.body || ''];

package/lib/tools/repo.d.ts

@@ -31,8 +31,8 @@ export declare function createRepoTool(executor: GhExecutor): {
         };
         render(args: any, value: any): {
             type: string;
-            text: string;
+            text: any;
         }[];
     };
-    execute(args: any, execContext: any): Promise<{} | undefined>;
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
 };

package/lib/tools/repo.js

@@ -1,3 +1,12 @@
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
 export function createRepoTool(executor) {
     return {
         name: 'github_repo',
@@ -28,7 +37,15 @@ export function createRepoTool(executor) {
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+                if (!value)
+                    return [{ type: 'text', text: '无返回内容' }];
+                if (typeof value.result === 'string') {
+                    return [{ type: 'text', text: value.result }];
+                }
+                if (Array.isArray(value.items)) {
+                    return [{ type: 'text', text: JSON.stringify(value.items, null, 2) }];
+                }
+                return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
             },
         },
         async execute(args, execContext) {
@@ -36,11 +53,24 @@ export function createRepoTool(executor) {
             const limitStr = String(args.limit || 10);
             switch (args.action) {
                 case 'view': {
-                    const repoArgs = args.repo ? [args.repo] : [];
+                    let repoTarget = args.repo;
+                    let meta = null;
+                    if (!repoTarget) {
+                        meta = await executor.getRepoMetadata(cwd);
+                        if (meta?.nameWithOwner) {
+                            repoTarget = meta.nameWithOwner;
+                        }
+                    }
+                    const repoArgs = repoTarget ? [repoTarget] : [];
                     const res = await executor.run(['repo', 'view', ...repoArgs, '--json', 'nameWithOwner,description,defaultBranchRef,isPrivate,stargazerCount,forkCount,url'], { cwd });
-                    if (!res.ok)
+                    if (!res.ok) {
+                        // 若执行 gh 失败（如离线或环境限制），但本地已成功识别仓库元数据，进行优雅兜底返回
+                        if (meta && meta.nameWithOwner) {
+                            return normalizeOutput(meta);
+                        }
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    }
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'search_code': {
                     if (!args.query)
@@ -49,7 +79,7 @@ export function createRepoTool(executor) {
                     const res = await executor.run(['search', 'code', args.query, ...repoArgs, '--json', 'path,repository,textMatches', '-L', limitStr], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'search_repos': {
                     if (!args.query)
@@ -57,7 +87,7 @@ export function createRepoTool(executor) {
                     const res = await executor.run(['search', 'repos', args.query, '--json', 'fullName,description,stargazersCount,updatedAt', '-L', limitStr], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 default:
                     throw new Error(`未知的 Repo 操作: ${args.action}`);

package/lib/tools/run.d.ts

@@ -31,8 +31,8 @@ export declare function createRunTool(executor: GhExecutor): {
         };
         render(args: any, value: any): {
             type: string;
-            text: string;
+            text: any;
         }[];
     };
-    execute(args: any, execContext: any): Promise<{} | undefined>;
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
 };

package/lib/tools/run.js

@@ -1,3 +1,12 @@
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
 export function createRunTool(executor) {
     return {
         name: 'github_run',
@@ -28,18 +37,33 @@ export function createRunTool(executor) {
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+                if (!value)
+                    return [{ type: 'text', text: '无返回数据' }];
+                if (typeof value.result === 'string') {
+                    return [{ type: 'text', text: value.result }];
+                }
+                if (Array.isArray(value.items)) {
+                    return [{ type: 'text', text: JSON.stringify(value.items, null, 2) }];
+                }
+                return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
             },
         },
         async execute(args, execContext) {
             const cwd = execContext?.cwd || process.cwd();
-            const repoArgs = args.repo ? ['-R', args.repo] : [];
+            let repoTarget = args.repo;
+            if (!repoTarget) {
+                const meta = await executor.getRepoMetadata(cwd);
+                if (meta?.nameWithOwner) {
+                    repoTarget = meta.nameWithOwner;
+                }
+            }
+            const repoArgs = repoTarget ? ['-R', repoTarget] : [];
             switch (args.action) {
                 case 'list': {
                     const res = await executor.run(['run', 'list', ...repoArgs, '--json', 'databaseId,name,status,conclusion,event,headBranch,createdAt', '-L', String(args.limit || 10)], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'view': {
                     if (!args.run_id)
@@ -47,7 +71,7 @@ export function createRunTool(executor) {
                     const res = await executor.run(['run', 'view', String(args.run_id), ...repoArgs, '--json', 'databaseId,name,status,conclusion,jobs,url'], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'log_failed': {
                     if (!args.run_id)
@@ -60,7 +84,7 @@ export function createRunTool(executor) {
                     });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.rawOutput || '未找到失败步骤的日志';
+                    return { result: res.rawOutput || '未找到失败步骤的日志' };
                 }
                 case 'rerun': {
                     if (!args.run_id)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-github-flow",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "icon": "icon.svg",
   "description": "GitHub Flow: Native GitHub CLI (gh) integration for DeepSeek Harness — Agent Tools, Slash Commands, and Web UI Workspace",
   "type": "module",