dsh-github-flow 0.1.0

package/README.md

@@ -0,0 +1,130 @@
+# DSH GitHub Flow (`dsh-github-flow`)
+
+基于 GitHub CLI (`gh`) 为 DeepSeek Harness (DSH) 打造的现代化原生集成插件。  
+深度打通本地 Git 仓库开发与远程 GitHub 协作（PR、Issue、Actions CI 诊断与代码审查），兼备 Agent 模型工具、人类 Slash 指令以及原生 Web UI 双重视图（主驾驶舱与右侧栏快捷面板）。
+
+---
+
+## 🌟 核心特性
+
+1. **零鉴权配置，开箱即用**：
+   - 自动复用宿主机已通过 `gh auth login` 认证的登录凭据（OAuth Token / 系统 Keyring），无需在 DSH 中存储任何明文 GitHub PAT。
+2. **工作区目录深度亲和 (CWD 绑定)**：
+   - 自动继承当前会话所在的 Workspace 物理目录，`gh` 自动识别当前 Git 仓库与本地工作分支，无需 Agent 每次传参 `owner/repo`。
+3. **高信噪比与 Token 防溢出治理**：
+   - 拒绝 70+ 个碎片化微型工具撑爆上下文，聚合为 **5 大领域核心 Tool**。
+   - 所有查询原生采用 `--json <fields>` 按需返回；对 `diff`、`log_failed` 设置安全截断保护（默认 24KB），防止模型上下文窗口溢出崩溃。
+4. **原生双重视图（驾驶舱与右侧栏）**：
+   - **全局驾驶舱**（主导航栏 `sidebar.panellist`，Order 20）：展示账号全局仓库、本地工作区矩阵、个人待办 PR 与 Issues；
+   - **右侧栏工作区面板**（`sidebarRightTabs`，Order 40）：在会话引导页与右侧抽屉常驻呈现当前仓库的 PR 列表、Checks 状态药丸与快捷操作。
+5. **符合 Cordis 官方微内核架构**：
+   - 暴露原生 `GitHubService`（`ctx.github`），允许生态其他插件复用；
+   - 具备 Schemastery 强类型运行时配置校验（`Config`）；
+   - 支持领域事件系统（`github/pr:create`, `github/issue:create`）。
+
+---
+
+## 📦 项目结构
+
+```text
+dsh-github-flow/
+├── package.json              # 模块定义、Cordis bundle 声明及 peerDependencies
+├── cordis.patch.yml          # DSH Profile 自动装配补丁（含默认配置项）
+├── tsconfig.json             # TypeScript 编译配置
+├── README.md                 # 插件说明文档
+├── icon.svg                  # 官方矢量微渐变包图标
+├── src/
+│   ├── index.ts              # Host 插件主入口：apply(ctx) 生命周期、服务挂载与 Config Schema
+│   ├── service.ts            # Cordis 原生 GitHubService 抽象
+│   ├── types.ts              # 数据结构、事件定义与接口类型
+│   ├── executor.ts           # 底层 gh 执行引擎（execFile 参数数组隔离、防注入、超时与截断）
+│   ├── commands/
+│   │   └── gh.ts             # 人类交互斜杠命令 (/gh status, /gh help)
+│   ├── api/
+│   │   └── routes.ts         # 面向 Web 视口的 Host HTTP 路由 (/api/github/*，受 effect 生命周期管理)
+│   ├── tools/                # Agent 模型工具集（规范化 defineTool DSL）
+│   │   ├── pr.ts             # github_pr: PR 查看、比对、Checks、评审与合并
+│   │   ├── issue.ts          # github_issue: Issue 检索、创建、追加评论、关闭
+│   │   ├── run.ts            # github_run: Actions CI 监控与 --log-failed 报错定位
+│   │   ├── repo.ts           # github_repo: 仓库元数据与跨仓库搜索
+│   │   └── api.ts            # github_api: 万能 REST/GraphQL 逃生门
+│   └── client.ts             # Client 页面扩展：注册右侧栏 tab 与主面板视口
+└── lib/                      # TypeScript 编译输出产物（双端 ESM）
+```
+
+---
+
+## 🛠️ Agent 工具集速查
+
+| 工具名称 | 核心操作 (`action`) | 典型场景 |
+|---|---|---|
+| `github_pr` | `list`, `view`, `create`, `diff`, `checks`, `review`, `merge` | 让 Agent 查看 PR 详情、检查 CI 状态、执行代码评审、合并 PR |
+| `github_issue` | `list`, `view`, `create`, `comment`, `close`, `reopen` | 查看与搜索 Issue、创建 Issue、追加排查进展评论 |
+| `github_run` | `list`, `view`, `log_failed`, `rerun`, `cancel` | 查看 CI 构建流水线，特别是 `log_failed` 可直接提取报错日志供 Agent 修复 |
+| `github_repo` | `view`, `search_code`, `search_repos` | 查看仓库元数据、跨仓库代码搜索 |
+| `github_api` | 任意端点（如 `repos/{owner}/{repo}/releases`） | 底层直接调用 REST / GraphQL API（支持 `--jq` 预过滤） |
+
+---
+
+## 💬 人类 Slash 命令
+
+在 DSH 对话输入框直接使用：
+- `/gh status`：检查当前 GitHub CLI 账号登录状态、授权作用域与当前本地目录关联仓库；
+- `/gh help`：查看使用帮助与常见语法示例。
+
+---
+
+## ⚙️ 插件配置项 (Config)
+
+在 `cordis.patch.yml` 或 Profile 配置中自由覆盖如下字段：
+
+```yaml
+- insert:
+    - id: github-flow
+      name: dsh-github-flow
+      config:
+        ghPath: 'gh'              # GitHub CLI 程序路径（内网或特定环境可指定绝对路径）
+        defaultTimeoutMs: 30000   # 命令执行超时时间（毫秒）
+        maxOutputChars: 24000     # 单次命令最大返回字符数（防 Token 溢出保护）
+        cacheTtlMs: 15000         # 界面概览数据缓存时间（毫秒）
+        defaultListLimit: 20      # 默认查询列表返回条数
+```
+
+---
+
+## 🔌 生态服务扩展 (Cordis Service)
+
+其他 DSH 插件可通过依赖注入复用本插件的能力：
+
+```ts
+import type { Context } from '@deepseek-ai/cordis';
+
+export const inject = ['github'];
+
+export function apply(ctx: Context) {
+  // 通过 ctx.github 直接调用底层安全执行引擎
+  const auth = await ctx.github.checkAuth();
+  const repo = await ctx.github.getRepoMetadata();
+}
+```
+
+---
+
+## 🖥️ 页面安装与体验
+
+1. **依赖前提**：
+   宿主机已安装 GitHub CLI (`gh`) 并已登录：
+   ```bash
+   gh auth status
+   ```
+2. **在 DSH 中安装与挂载**：
+   通过 DSH Profile 配置加载本插件 bundle：
+   ```yaml
+   # cordis.patch.yml
+   - insert:
+       - id: github-flow
+         name: dsh-github-flow
+   ```
+3. **界面体验**：
+   - **右侧栏**：在右侧抽屉常驻呈现当前仓库的 PR、CI 状态药丸与快捷操作按钮；
+   - **主视口**：左侧导航栏点击 GitHub 图标进入全局驾驶舱。

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+- insert:
+    - id: github-flow
+      name: dsh-github-flow
+      config:
+        defaultTimeoutMs: 30000
+        maxOutputChars: 24000
+        cacheTtlMs: 15000

package/icon.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#2ea043" />
+      <stop offset="50%" stop-color="#1f6feb" />
+      <stop offset="100%" stop-color="#8957e5" />
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="4" stdDeviation="6" flood-color="#000" flood-opacity="0.3" />
+    </filter>
+  </defs>
+  <rect width="128" height="128" rx="28" fill="url(#bgGrad)" />
+  <rect width="126" height="126" x="1" y="1" rx="27" fill="none" stroke="rgba(255,255,255,0.2)" stroke-width="2" />
+  <g transform="translate(24, 24) scale(5)" filter="url(#shadow)" fill="#ffffff">
+    <path fill-rule="evenodd" clip-rule="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" />
+  </g>
+</svg>

package/lib/api/routes.d.ts

@@ -0,0 +1,3 @@
+import type { GhExecutor } from '../executor.js';
+import type { PluginConfig } from '../types.js';
+export declare function registerApiRoutes(ctx: any, executor: GhExecutor, config?: PluginConfig): void;

package/lib/api/routes.js

@@ -0,0 +1,230 @@
+const cacheMap = new Map();
+export function registerApiRoutes(ctx, executor, config) {
+    const webServer = ctx.get ? ctx.get('webServer') : ctx.webServer;
+    if (!webServer || typeof webServer.register !== 'function')
+        return;
+    const cacheTtlMs = config?.cacheTtlMs || 15_000;
+    const listLimit = String(config?.defaultListLimit || 20);
+    function sendJson(res, status, data) {
+        res.statusCode = status;
+        res.setHeader('Content-Type', 'application/json; charset=utf-8');
+        res.setHeader('Cache-Control', 'no-store');
+        res.end(JSON.stringify(data));
+    }
+    // 接入 Cordis effect 管理生命周期，卸载或重载时注销所有路由
+    const registerWithEffect = (fn) => {
+        if (ctx.effect) {
+            return ctx.effect(() => {
+                const disposers = fn();
+                return () => {
+                    disposers.forEach((dispose) => {
+                        if (typeof dispose === 'function')
+                            dispose();
+                    });
+                };
+            }, 'github-flow: api routes');
+        }
+        else {
+            fn();
+        }
+    };
+    registerWithEffect(() => {
+        const disposers = [];
+        // 1. 获取全局与当前工作区仓库的 GitHub 概览
+        disposers.push(webServer.register({
+            kind: 'exact',
+            path: '/api/github/overview',
+            handler: async (req, res) => {
+                if (req.method !== 'GET') {
+                    sendJson(res, 405, { ok: false, message: '仅支持 GET 请求' });
+                    return;
+                }
+                try {
+                    const url = new URL(req.url || '', 'http://127.0.0.1');
+                    const cwd = url.searchParams.get('cwd') || process.cwd();
+                    const now = Date.now();
+                    const cached = cacheMap.get(cwd);
+                    if (cached && now - cached.time < cacheTtlMs) {
+                        sendJson(res, 200, { ok: true, data: cached.data, fromCache: true, cwd });
+                        return;
+                    }
+                    const auth = await executor.checkAuth(cwd);
+                    const repo = await executor.getRepoMetadata(cwd);
+                    let pullRequests = [];
+                    let issues = [];
+                    let runs = [];
+                    if (repo && auth.loggedIn) {
+                        // 并发拉取当前工作区仓库的 PRs、Issues 和 Runs
+                        const [prsRes, issuesRes, runsRes] = await Promise.all([
+                            executor.run([
+                                'pr',
+                                'list',
+                                '--json',
+                                'number,title,state,author,headRefName,baseRefName,isDraft,mergeable,reviewDecision,statusCheckRollup,url,updatedAt',
+                                '-L',
+                                '10',
+                            ], { cwd, timeoutMs: 12_000 }),
+                            executor.run(['issue', 'list', '--json', 'number,title,state,author,labels,assignees,url,updatedAt', '-L', '10'], { cwd, timeoutMs: 12_000 }),
+                            executor.run(['run', 'list', '--json', 'databaseId,name,status,conclusion,event,headBranch,url,createdAt', '-L', '5'], { cwd, timeoutMs: 12_000 }),
+                        ]);
+                        if (prsRes.ok && Array.isArray(prsRes.data))
+                            pullRequests = prsRes.data;
+                        if (issuesRes.ok && Array.isArray(issuesRes.data))
+                            issues = issuesRes.data;
+                        if (runsRes.ok && Array.isArray(runsRes.data))
+                            runs = runsRes.data;
+                    }
+                    const freshData = {
+                        auth,
+                        repo: repo || undefined,
+                        pullRequests,
+                        issues,
+                        runs,
+                        lastUpdated: new Date().toISOString(),
+                    };
+                    cacheMap.set(cwd, { data: freshData, time: now });
+                    sendJson(res, 200, { ok: true, data: freshData, fromCache: false, cwd });
+                }
+                catch (err) {
+                    sendJson(res, 500, { ok: false, error: err.message || '获取 GitHub 概览失败' });
+                }
+            },
+        }));
+        // 2. 强制刷新缓存
+        disposers.push(webServer.register({
+            kind: 'exact',
+            path: '/api/github/refresh',
+            handler: async (req, res) => {
+                cacheMap.clear();
+                sendJson(res, 200, { ok: true, message: '缓存已清空，下次读取将拉取最新数据' });
+            },
+        }));
+        // 3. 右侧栏快捷操作代理接口
+        disposers.push(webServer.register({
+            kind: 'exact',
+            path: '/api/github/action',
+            handler: async (req, res) => {
+                if (req.method !== 'POST') {
+                    sendJson(res, 405, { ok: false, message: '仅支持 POST 请求' });
+                    return;
+                }
+                let body = '';
+                req.on('data', (chunk) => {
+                    body += chunk;
+                });
+                req.on('end', async () => {
+                    try {
+                        const payload = body ? JSON.parse(body) : {};
+                        const cwd = payload.cwd || process.cwd();
+                        switch (payload.action) {
+                            case 'create_pr': {
+                                const cmd = ['pr', 'create', '--title', payload.title || 'Update', '--body', payload.body || 'Created from DSH Rightbar'];
+                                if (payload.draft)
+                                    cmd.push('--draft');
+                                const r = await executor.run(cmd, { cwd });
+                                if (!r.ok)
+                                    throw new Error(r.error);
+                                if (ctx.emit) {
+                                    ctx.emit('github/pr:create', cwd, { title: payload.title || 'Update', url: r.rawOutput || '' });
+                                }
+                                sendJson(res, 200, { ok: true, message: 'PR 创建成功', url: r.rawOutput });
+                                break;
+                            }
+                            case 'create_issue': {
+                                const cmd = ['issue', 'create', '--title', payload.title || 'New Issue', '--body', payload.body || 'Created from DSH Rightbar'];
+                                const r = await executor.run(cmd, { cwd });
+                                if (!r.ok)
+                                    throw new Error(r.error);
+                                if (ctx.emit) {
+                                    ctx.emit('github/issue:create', cwd, { title: payload.title || 'New Issue', url: r.rawOutput || '' });
+                                }
+                                sendJson(res, 200, { ok: true, message: 'Issue 创建成功', url: r.rawOutput });
+                                break;
+                            }
+                            case 'open_browser': {
+                                // 浏览器外链在 Client 端原生调用 window.open，服务端安全闭环响应
+                                sendJson(res, 200, { ok: true, message: '外链已通过客户端安全打开' });
+                                break;
+                            }
+                            default:
+                                sendJson(res, 400, { ok: false, message: `未知的操作类型: ${payload.action}` });
+                        }
+                    }
+                    catch (err) {
+                        sendJson(res, 500, { ok: false, error: err.message || '操作执行失败' });
+                    }
+                });
+            },
+        }));
+        // 4. 获取全局视角的驾驶舱概览数据 (不绑定单一项目)
+        disposers.push(webServer.register({
+            kind: 'exact',
+            path: '/api/github/global-overview',
+            handler: async (req, res) => {
+                if (req.method !== 'GET') {
+                    sendJson(res, 405, { ok: false, message: '仅支持 GET 请求' });
+                    return;
+                }
+                try {
+                    const auth = await executor.checkAuth();
+                    let userRepos = [];
+                    let myPrs = [];
+                    let myIssues = [];
+                    let workspaceMatrix = [];
+                    if (auth.loggedIn) {
+                        // 并发拉取全局概览数据
+                        const [reposRes, prsRes, issuesRes] = await Promise.all([
+                            executor.run(['repo', 'list', '--limit', listLimit, '--json', 'name,nameWithOwner,description,defaultBranchRef,isPrivate,stargazerCount,updatedAt,url'], { timeoutMs: 12_000 }),
+                            executor.run(['search', 'prs', '--author=@me', '--state=open', '--limit', '10', '--json', 'number,title,repository,url,updatedAt'], { timeoutMs: 12_000 }),
+                            executor.run(['search', 'issues', '--author=@me', '--state=open', '--limit', '10', '--json', 'number,title,repository,url,updatedAt'], { timeoutMs: 12_000 }),
+                        ]);
+                        if (reposRes.ok && Array.isArray(reposRes.data)) {
+                            userRepos = reposRes.data.map((r) => ({
+                                name: r.name || '',
+                                nameWithOwner: r.nameWithOwner || '',
+                                description: r.description || '',
+                                defaultBranch: r.defaultBranchRef?.name || 'main',
+                                isPrivate: Boolean(r.isPrivate),
+                                stargazerCount: r.stargazerCount || 0,
+                                updatedAt: r.updatedAt || '',
+                                url: r.url || `https://github.com/${r.nameWithOwner}`,
+                            }));
+                        }
+                        if (prsRes.ok && Array.isArray(prsRes.data)) {
+                            myPrs = prsRes.data;
+                        }
+                        if (issuesRes.ok && Array.isArray(issuesRes.data)) {
+                            myIssues = issuesRes.data;
+                        }
+                    }
+                    // 安全解析工作区矩阵：优先通过官方工作区服务获取，无服务时仅展示当前运行工作区，绝不私自侵入宿主私有文件
+                    const currentCwd = process.cwd();
+                    const currentRepo = await executor.getRepoMetadata(currentCwd);
+                    workspaceMatrix = [
+                        {
+                            id: 'current',
+                            title: '当前活动工作区',
+                            path: currentCwd,
+                            hasGit: Boolean(currentRepo),
+                            repo: currentRepo || undefined,
+                            sessionCount: 1,
+                        },
+                    ];
+                    const globalData = {
+                        auth,
+                        userRepos,
+                        workspaceMatrix,
+                        myPrs,
+                        myIssues,
+                        lastUpdated: new Date().toISOString(),
+                    };
+                    sendJson(res, 200, { ok: true, data: globalData });
+                }
+                catch (err) {
+                    sendJson(res, 500, { ok: false, error: err.message || '获取全局驾驶舱数据失败' });
+                }
+            },
+        }));
+        return disposers;
+    });
+}

package/lib/client/icons.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GitHub 官方高精度的 Invertocat 矢量路径
+ */
+export declare const GITHUB_OCTOCAT_PATH = "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";
+/**
+ * 基础矢量 Logo
+ */
+export declare function createOctocatSvg(size?: number, color?: string): any;
+/**
+ * 现代暗黑科技感徽标 Artwork（用于卡片与主要入口）
+ * 带有暗夜流光微渐变与精致白描
+ */
+export declare function createOctocatBadge(size?: number): any;

package/lib/client/icons.js

@@ -0,0 +1,41 @@
+/**
+ * GitHub 官方高精度的 Invertocat 矢量路径
+ */
+export const GITHUB_OCTOCAT_PATH = "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";
+/**
+ * 基础矢量 Logo
+ */
+export function createOctocatSvg(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: GITHUB_OCTOCAT_PATH
+    }));
+}
+/**
+ * 现代暗黑科技感徽标 Artwork（用于卡片与主要入口）
+ * 带有暗夜流光微渐变与精致白描
+ */
+export function createOctocatBadge(size = 36) {
+    var iconSize = Math.round(size * 0.58);
+    return React.createElement("div", {
+        style: {
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            width: `${size}px`,
+            height: `${size}px`,
+            borderRadius: "10px",
+            background: "linear-gradient(135deg, #2ea043 0%, #1f6feb 100%)", // GitHub 科技绿蓝微渐变
+            boxShadow: "0 2px 8px rgba(31, 111, 235, 0.25), inset 0 1px 0 rgba(255, 255, 255, 0.2)",
+            flexShrink: 0,
+            position: "relative"
+        }
+    }, createOctocatSvg(iconSize, "#ffffff"));
+}

package/lib/client/index.d.ts

@@ -0,0 +1,3 @@
+export declare const name = "dsh-github-flow";
+export declare const inject: readonly ['slots'];
+export declare function apply(ctx: any): void;

package/lib/client/index.js

@@ -0,0 +1,36 @@
+import { GITHUB_PANEL_CSS } from './style.js';
+import { createGithubPanelComponent } from './panel.js';
+export const name = 'dsh-github-flow';
+export const inject = ['slots'];
+export function apply(ctx) {
+    // 1. 注入样式
+    if (typeof styles !== 'undefined' && styles.insert) {
+        styles.insert(GITHUB_PANEL_CSS);
+    }
+    else if (typeof document !== 'undefined') {
+        const styleEl = document.createElement('style');
+        styleEl.textContent = GITHUB_PANEL_CSS;
+        document.head.appendChild(styleEl);
+    }
+    // 2. 侧边栏图标组件
+    function GithubSidebarIcon() {
+        return React.createElement('div', { className: 'dsh-github-icon', title: 'GitHub 工作台' }, React.createElement('svg', { viewBox: '0 0 16 16', width: 18, height: 18, fill: 'currentColor' }, React.createElement('path', {
+            d: 'M8 0c4.42 0 8 3.58 8 8a8.013 8.013 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02-.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27-.68 0-1.36.09-2 .27-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.28-.82 2.15 0 3.06 1.86 3.75 3.64 3.95-.23.2-.44.55-.51 1.07-.46.21-1.61.55-2.33-.66-.15-.24-.6-.83-1.23-.82-.67.01-.27.38.01.53.34.19.73.9.82 1.13.16.45.68 1.31 2.69.94 0 .67.01 1.3.01 1.49 0 .21-.15.45-.55.38A7.995 7.995 0 0 1 0 8c0-4.42 3.58-8 8-8Z',
+        })));
+    }
+    // 3. 注册到 sidebar.panellist（排在 schedules 自动任务后，workspaces 工作区前）
+    if (ctx.slots && typeof ctx.slots.register === 'function') {
+        ctx.slots.register({
+            slot: 'sidebar.panellist',
+            id: 'github',
+            order: 20,
+            label: 'GitHub',
+        }, GithubSidebarIcon);
+        // 4. 注册中央主视图（main slot, key: 'github'）
+        const GithubWorkspacePanel = createGithubPanelComponent();
+        ctx.slots.register({
+            slot: 'main',
+            key: 'github',
+        }, GithubWorkspacePanel);
+    }
+}

package/lib/client/panel.d.ts

@@ -0,0 +1 @@
+export declare function createGithubPanelComponent(): () => any;

package/lib/client/panel.js

@@ -0,0 +1,75 @@
+export function createGithubPanelComponent() {
+    return function GithubWorkspacePanel() {
+        const [loading, setLoading] = React.useState(true);
+        const [data, setData] = React.useState(null);
+        const [error, setError] = React.useState(null);
+        const loadData = React.useCallback(async (forceRefresh = false) => {
+            setLoading(true);
+            setError(null);
+            try {
+                if (forceRefresh) {
+                    await fetch('/api/github/refresh', { method: 'POST' }).catch(() => { });
+                }
+                const res = await fetch('/api/github/overview');
+                const json = await res.json();
+                if (json.ok && json.data) {
+                    setData(json.data);
+                }
+                else {
+                    setError(json.error || json.message || '获取 GitHub 概览失败');
+                }
+            }
+            catch (err) {
+                setError(err.message || '网络连接异常');
+            }
+            finally {
+                setLoading(false);
+            }
+        }, []);
+        React.useEffect(() => {
+            loadData(false);
+            // 60秒自动温和轮询
+            const timer = setInterval(() => loadData(false), 60_000);
+            return () => clearInterval(timer);
+        }, [loadData]);
+        const h = React.createElement;
+        // 头部区域
+        const headerEl = h('div', { className: 'dsh-github-header' }, h('div', { className: 'dsh-github-title' }, h('svg', { viewBox: '0 0 16 16', width: 22, height: 22, fill: 'currentColor' }, h('path', {
+            d: 'M8 0c4.42 0 8 3.58 8 8a8.013 8.013 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02-.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27-.68 0-1.36.09-2 .27-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.28-.82 2.15 0 3.06 1.86 3.75 3.64 3.95-.23.2-.44.55-.51 1.07-.46.21-1.61.55-2.33-.66-.15-.24-.6-.83-1.23-.82-.67.01-.27.38.01.53.34.19.73.9.82 1.13.16.45.68 1.31 2.69.94 0 .67.01 1.3.01 1.49 0 .21-.15.45-.55.38A7.995 7.995 0 0 1 0 8c0-4.42 3.58-8 8-8Z',
+        })), h('h2', null, 'GitHub 工作台')), h('button', {
+            className: 'dsh-github-refresh-btn',
+            onClick: () => loadData(true),
+            disabled: loading,
+        }, loading ? '刷新中...' : '🔄 刷新状态'));
+        if (loading && !data) {
+            return h('div', { className: 'dsh-github-panel' }, headerEl, h('div', { className: 'dsh-github-empty' }, '正在连接 GitHub CLI 并获取仓库状态...'));
+        }
+        if (error && !data) {
+            return h('div', { className: 'dsh-github-panel' }, headerEl, h('div', { className: 'dsh-github-empty', style: { borderColor: '#f85149', color: '#f85149' } }, `⚠️ ${error}`));
+        }
+        const auth = data?.auth;
+        const repo = data?.repo;
+        const prs = data?.pullRequests || [];
+        const issues = data?.issues || [];
+        const runs = data?.runs || [];
+        // 概览卡片区
+        const cardsEl = h('div', { className: 'dsh-github-overview-cards' }, h('div', { className: 'dsh-github-card' }, h('div', { className: 'dsh-github-card-title' }, '认证账号'), 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' }, repo
+            ? h('a', { href: repo.url, target: '_blank', style: { color: 'inherit', textDecoration: 'none' } }, repo.nameWithOwner)
+            : '未关联 GitHub 仓库')), h('div', { className: 'dsh-github-card' }, h('div', { className: 'dsh-github-card-title' }, '待审 PR / 活跃任务'), h('div', { className: 'dsh-github-card-value' }, `${prs.length} PRs · ${issues.length} Issues`)));
+        // Pull Requests 区域
+        const prsSectionEl = h('div', { className: 'dsh-github-section' }, h('div', { className: 'dsh-github-section-header' }, h('h3', null, `🔀 Pull Requests (${prs.length})`)), prs.length === 0
+            ? h('div', { className: 'dsh-github-empty' }, '当前无开放的 Pull Request')
+            : h('div', { className: 'dsh-github-list' }, prs.map((pr) => h('div', { key: pr.number, className: 'dsh-github-item' }, h('div', { className: 'dsh-github-item-main' }, h('a', { className: 'dsh-github-item-title', href: pr.url, target: '_blank' }, `#${pr.number} ${pr.title}`), h('div', { className: 'dsh-github-item-meta' }, h('span', null, `由 ${pr.author?.login || '未知'} 提交`), h('span', null, `${pr.headRefName} → ${pr.baseRefName}`), pr.mergeable === 'CONFLICTING'
+                ? h('span', { className: 'dsh-github-badge dsh-badge-red' }, '冲突 Conflicting')
+                : h('span', { className: 'dsh-github-badge dsh-badge-green' }, '可合并 Mergeable'))), h('div', { className: 'dsh-github-item-actions' }, h('a', { className: 'dsh-github-btn-sm', href: pr.url, target: '_blank', style: { textDecoration: 'none' } }, '在 GitHub 打开'))))));
+        // GitHub Actions 区域
+        const runsSectionEl = h('div', { className: 'dsh-github-section' }, h('div', { className: 'dsh-github-section-header' }, h('h3', null, `⚡ GitHub Actions 最近流水线 (${runs.length})`)), runs.length === 0
+            ? h('div', { className: 'dsh-github-empty' }, '暂无工作流运行记录')
+            : h('div', { className: 'dsh-github-list' }, runs.map((r) => h('div', { key: r.databaseId, className: 'dsh-github-item' }, h('div', { className: 'dsh-github-item-main' }, h('a', { className: 'dsh-github-item-title', href: r.url, target: '_blank' }, r.name), h('div', { className: 'dsh-github-item-meta' }, h('span', null, `分支: ${r.headBranch}`), h('span', null, `触发事件: ${r.event}`), r.conclusion === 'success'
+                ? h('span', { className: 'dsh-github-badge dsh-badge-green' }, '成功 Success')
+                : r.conclusion === 'failure'
+                    ? h('span', { className: 'dsh-github-badge dsh-badge-red' }, '失败 Failure')
+                    : h('span', { className: 'dsh-github-badge dsh-badge-yellow' }, r.status || '进行中'))), h('div', { className: 'dsh-github-item-actions' }, h('a', { className: 'dsh-github-btn-sm', href: r.url, target: '_blank', style: { textDecoration: 'none' } }, '查看流水线'))))));
+        return h('div', { className: 'dsh-github-panel' }, headerEl, cardsEl, prsSectionEl, runsSectionEl);
+    };
+}

package/lib/client/style.d.ts

@@ -0,0 +1 @@
+export declare const GITHUB_PANEL_CSS = "\n.dsh-github-icon {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 100%;\n  height: 100%;\n  cursor: pointer;\n  color: var(--dsw-alias-label-secondary, #8c8c8c);\n  transition: color 0.15s ease;\n}\n.dsh-github-icon:hover {\n  color: var(--dsw-alias-label-primary, #ffffff);\n}\n.dsh-github-icon svg {\n  width: 18px;\n  height: 18px;\n  fill: currentColor;\n}\n\n/* \u4E3B\u9762\u677F\u5BB9\u5668 */\n.dsh-github-panel {\n  display: flex;\n  flex-direction: column;\n  width: 100%;\n  height: 100%;\n  overflow-y: auto;\n  padding: 24px 32px;\n  box-sizing: border-box;\n  background: var(--dsw-alias-bg-primary, #1e1e20);\n  color: var(--dsw-alias-label-primary, #ececec);\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;\n}\n\n/* \u9876\u90E8\u6807\u9898\u4E0E\u5DE5\u5177\u680F */\n.dsh-github-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  margin-bottom: 24px;\n  padding-bottom: 16px;\n  border-bottom: 1px solid var(--dsw-alias-border-l1, #333336);\n}\n.dsh-github-title {\n  display: flex;\n  align-items: center;\n  gap: 12px;\n}\n.dsh-github-title h2 {\n  margin: 0;\n  font-size: 20px;\n  font-weight: 600;\n}\n.dsh-github-refresh-btn {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  padding: 6px 14px;\n  font-size: 13px;\n  border-radius: 6px;\n  border: 1px solid var(--dsw-alias-border-l1, #444);\n  background: var(--dsw-alias-bg-secondary, #2a2a2e);\n  color: var(--dsw-alias-label-primary, #fff);\n  cursor: pointer;\n  transition: all 0.15s ease;\n}\n.dsh-github-refresh-btn:hover {\n  background: var(--dsw-alias-interactive-bg-hover, #3a3a3e);\n}\n\n/* \u6982\u89C8\u5361\u7247\u533A */\n.dsh-github-overview-cards {\n  display: grid;\n  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));\n  gap: 16px;\n  margin-bottom: 24px;\n}\n.dsh-github-card {\n  padding: 16px 20px;\n  border-radius: 8px;\n  border: 1px solid var(--dsw-alias-border-l1, #333336);\n  background: var(--dsw-alias-bg-secondary, #252528);\n}\n.dsh-github-card-title {\n  font-size: 12px;\n  text-transform: uppercase;\n  letter-spacing: 0.5px;\n  color: var(--dsw-alias-label-tertiary, #888);\n  margin-bottom: 8px;\n}\n.dsh-github-card-value {\n  font-size: 16px;\n  font-weight: 600;\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n.dsh-github-badge {\n  display: inline-block;\n  font-size: 11px;\n  padding: 2px 8px;\n  border-radius: 12px;\n  font-weight: 500;\n}\n.dsh-badge-green { background: rgba(46, 160, 67, 0.2); color: #3fb950; }\n.dsh-badge-red { background: rgba(248, 81, 73, 0.2); color: #f85149; }\n.dsh-badge-yellow { background: rgba(210, 153, 34, 0.2); color: #d29922; }\n.dsh-badge-purple { background: rgba(163, 113, 247, 0.2); color: #a371f7; }\n\n/* \u6A21\u5757\u5206\u680F\u533A */\n.dsh-github-section {\n  margin-bottom: 28px;\n}\n.dsh-github-section-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  margin-bottom: 12px;\n}\n.dsh-github-section-header h3 {\n  margin: 0;\n  font-size: 15px;\n  font-weight: 600;\n}\n\n/* \u5217\u8868\u6761\u76EE */\n.dsh-github-list {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n.dsh-github-item {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 12px 16px;\n  border-radius: 6px;\n  border: 1px solid var(--dsw-alias-border-l1, #333336);\n  background: var(--dsw-alias-bg-secondary, #252528);\n  transition: border-color 0.15s ease;\n}\n.dsh-github-item:hover {\n  border-color: var(--dsw-alias-border-l2, #555);\n}\n.dsh-github-item-main {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n.dsh-github-item-title {\n  font-size: 14px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary, #fff);\n  text-decoration: none;\n}\n.dsh-github-item-title:hover {\n  text-decoration: underline;\n}\n.dsh-github-item-meta {\n  font-size: 12px;\n  color: var(--dsw-alias-label-secondary, #8c8c8c);\n  display: flex;\n  gap: 12px;\n}\n.dsh-github-item-actions {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n.dsh-github-btn-sm {\n  font-size: 12px;\n  padding: 4px 10px;\n  border-radius: 4px;\n  border: 1px solid var(--dsw-alias-border-l1, #444);\n  background: transparent;\n  color: var(--dsw-alias-label-primary, #fff);\n  cursor: pointer;\n}\n.dsh-github-btn-sm:hover {\n  background: var(--dsw-alias-interactive-bg-hover, #333);\n}\n.dsh-github-empty {\n  padding: 24px;\n  text-align: center;\n  font-size: 13px;\n  color: var(--dsw-alias-label-tertiary, #666);\n  border: 1px dashed var(--dsw-alias-border-l1, #333);\n  border-radius: 6px;\n}\n";