dsh-github-flow 0.4.0 → 0.5.0

package/README.en.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <b>Give DeepSeek Harness Agents native hands and feet to operate GitHub, crafting an immersive collaboration cockpit for developers.</b><br>
-  Natively reuses host <code>gh</code> CLI login credentials to eliminate Personal Access Token (PAT) leaks; deeply bridges local Git workspaces with remote GitHub collaboration, equipped with <b>14 core domain Agent tools (85+ actions covering PR review/Issue tracking/Actions workflow & cache governance/clone-free file reads/branch ruleset policy diagnosis/Gist snippets/labels & global status dashboards/secrets & variables)</b>, <b>human slash commands</b>, <b>Web UI visual cockpits</b>, and <b>cross-platform one-click seamless upgrades</b>.
+  Natively reuses host <code>gh</code> CLI login credentials to eliminate Personal Access Token (PAT) leaks; deeply bridges local Git workspaces with remote GitHub collaboration, equipped with <b>18 core domain Agent tools (104 actions covering PR review/Issue tracking/Actions workflow & cache governance/clone-free file reads/branch ruleset policy diagnosis/Gist snippets/labels & global status dashboards/secrets & variables/agent tasks/discussions/projects v2/codespaces/runtime telemetry)</b>, <b>human slash commands</b>, <b>Web UI visual cockpits</b>, and <b>cross-platform one-click seamless upgrades</b>.
 </p>
 
 <p align="center">
@@ -73,7 +73,7 @@ dsh plugin --profile web add dsh-github-flow
 
 ## 🤖 Core Agent Tools: Equipping Agents with Native GitHub Powers
 
-Consolidates scattered GitHub endpoints into **14 core domain tools (85+ actions)**, featuring **Token Budget Protection (default 24KB intelligent truncation)**, **High-density Native Markdown Rendering (70%+ list output token reduction)** and **Zero-argument CWD auto-binding**.
+Consolidates scattered GitHub endpoints into **18 core domain tools (104 actions)** with an official command coverage of **87% (104/120)**, featuring **Token Budget Protection (default 24KB intelligent truncation)**, **High-density Native Markdown Rendering (70%+ list output token reduction)**, **OAuth Scope self-healing guidance**, and **Zero-argument CWD auto-binding**.
 
 ### 1. `github_pr`: Pull Request Lifecycle & Automated Code Review
 > **Example Agent Prompts**:
@@ -205,7 +205,9 @@ Consolidates scattered GitHub endpoints into **14 core domain tools (85+ actions
   * `search`: Discover compliant Agent skills across open-source GitHub repositories;
   * `preview`: Preview `SKILL.md` rule instructions without installing;
   * `install`: Install skills locally (`scope: 'project'` or `'user'`; requires `confirm: true`);
-  * `list`: Inspect installed skills in the current environment.
+  * `list`: Inspect installed skills in the current environment;
+  * `publish`: 🆕 **Skill Compliance Validation & Publishing Loop**: Safe `--dry-run` inspection against agentskills.io specifications, `--fix` metadata stripping, and release publishing with required `tag` and `confirm: true`;
+  * `update`: 🆕 **Batch Inspection & Sync Updates**: Safe `--dry-run` check comparing local and remote tree SHAs, with `--all` batch synchronization.
 
 ---
 
@@ -216,11 +218,11 @@ Consolidates scattered GitHub endpoints into **14 core domain tools (85+ actions
 > - *"How do I debug 'authentication failed' errors from gh?"*
 
 * **Supported Actions**:
-  * `overview`: Complete toolbox navigation and summary table (14 core tools);
+  * `overview`: Complete toolbox navigation and summary table (18 core tools);
   * `mapping`: **Official gh Command ↔ Tool Action Mapping Table**, detailing exact tool calls and REST/GraphQL fallback routes;
   * `search_syntax`: Date ranges, qualifiers, and boolean query syntax;
   * `troubleshooting`: Self-healing recipes for authentication loss, timeouts, SOCKS5 proxy configs, and permissions;
-  * Domain guides: In-depth usage guides for `pr`, `issue`, `run`, `repo`, `release`, `secret`, `skill`, `label`, `ruleset`, `cache`, `gist`, and `status`;
+  * Domain guides: In-depth usage guides for `pr`, `issue`, `run`, `repo`, `release`, `secret`, `skill`, `label`, `ruleset`, `cache`, `gist`, `status`, `agent_task`, `discussion`, `project`, and `codespace`;
   * `gh_command`: Direct pass-through lookup of official gh manual entries (e.g. `gh_command: 'ruleset'`).
 
 ---
@@ -290,13 +292,78 @@ Consolidates scattered GitHub endpoints into **14 core domain tools (85+ actions
 
 ---
 
-### 14. `github_status`: Cross-Repository Todo & Activity Dashboard
+### 14. `github_status`: Cross-Repository Todo & Runtime Health Dashboard
 > **Example Agent Prompts**:
 > - *"What tasks and pull requests need my attention on GitHub today?"*
 > - *"Check recent @mentions and activity across all repositories I follow."*
+> - *"Audit the runtime health score and degradation rate report of our GitHub tools."*
 
 * **Supported Actions**:
-  * `view`: **Account-level global status cockpit**, aggregating Assigned Issues, Assigned PRs, Review Requests, Mentions, and Repository Activity across all subscribed repositories without needing repository context; supports `-o` org filtering and `-e` noise repository exclusion.
+  * `view`: **Account-level global status cockpit** (default), aggregating Assigned Issues, Assigned PRs, Review Requests, Mentions, and Repository Activity across all subscribed repositories without needing repository context; supports `-o` org filtering and `-e` noise repository exclusion;
+  * `health`: 🆕 **Toolchain Runtime Health & Degradation Audit Report**: Powered by Cordis `tools/result` event telemetry, audits total calls, success rates, comprehensive health score (0-100), API degradation rates, and actionable self-healing upgrade suggestions across all 18 tools.
+
+---
+
+### 15. `github_agent_task`: Cloud Coding Agent Session Governance
+> **Example Agent Prompts**:
+> - *"List all GitHub Copilot Coding Agent task sessions assigned under my account."*
+> - *"View task 'e2fa49d2' details and fetch its execution logs."*
+> - *"Dispatch a task to the cloud Agent: 'Refactor network layer with retry support', based on branch develop."*
+
+* **Supported Actions**:
+  * `list`: List agent tasks (supports `-L/--limit` and `-R/--repo`);
+  * `view`: View task session details and logs (supports `--log`, strictly requires `task_id` to prevent TTY hangs);
+  * `create`: Create and dispatch a cloud agent coding task (supports `-b/--base` and `-a/--custom-agent`).
+
+---
+
+### 16. `github_discussion`: Team Discussions & Open-Source RFC Loop
+> **Example Agent Prompts**:
+> - *"List open discussions in category 'Ideas' for this repository."*
+> - *"View discussion #101 body and comment thread."*
+> - *"Start a discussion under 'RFC': 'Proposal on telemetry observability'."*
+> - *"Post a reply comment to discussion #101."*
+
+* **Supported Actions**:
+  * `list`: Query discussions (supports `-c/--category`, `-s/--state`, `--labels`, and `-S/--search`);
+  * `view`: Read discussion body and replies (supports `--comments`, requires `discussion_number`);
+  * `create`: Start a discussion (requires `category`, `title`, and `body`);
+  * `edit`: Update discussion title or body;
+  * `comment`: Post a comment reply to an existing discussion.
+
+---
+
+### 17. `github_project`: Projects v2 Board & Item Planning
+> **Example Agent Prompts**:
+> - *"List all Projects v2 boards under my account."*
+> - *"View items in project board #1 with filter query 'is:open'."*
+> - *"Add Issue 'https://github.com/owner/repo/issues/10' to project board #1."*
+> - *"Create a draft issue item in project #1 titled 'Review unit test coverage'."*
+
+* **Supported Actions**:
+  * `list`: List user or organization projects (default `owner: '@me'`, natively handles `--format json`);
+  * `view`: Inspect project metadata, visibility, description, and README;
+  * `item-list`: Inspect board items (supports Projects query filter syntax `--query`, e.g., `is:open assignee:@me`);
+  * `item-add`: Associate existing Issue/PR URLs to a project board;
+  * `item-create`: Create draft issue items;
+  * `item-delete`: Remove items from board (guarded by required `confirm: true`);
+  * 🔑 **Scope Self-Healing**: Automatically renders a single-line self-healing command card (`gh auth refresh -s read:project`) when permissions are missing.
+
+---
+
+### 18. `github_codespace`: Cloud Remote Development Environment (MVP)
+> **Example Agent Prompts**:
+> - *"Check which cloud Codespace environments are currently running."*
+> - *"Inspect instance specs and idle timeout for 'fuzzy-spoon-69vj'."*
+> - *"Stop 'fuzzy-spoon-69vj' to avoid billable core-hour consumption."*
+> - *"Permanently delete an unused temporary Codespace."*
+
+* **Supported Actions**:
+  * `list`: List Codespaces under current user or organization;
+  * `view`: Inspect environment specs, DevContainer path, and status (requires `codespace` name);
+  * `stop`: Stop running instances to halt billing immediately;
+  * `delete`: Safely delete instances (requires `confirm: true`, passes `-f` for non-interactive execution);
+  * 🔑 **Scope Self-Healing**: Automatically renders a single-line self-healing command card (`gh auth refresh -h github.com -s codespace`) when missing required scopes.
 
 ---
 
@@ -426,7 +493,7 @@ Initial Mount (0ms) ──────────> Instantly render local persi
 
 Enter in any DSH chat window:
 
-* `/gh status`: Diagnostics for GitHub CLI auth status, scopes, active workspace repository, and plugin version;
+* `/gh status`: Diagnostics for GitHub CLI auth status, scopes, active workspace repository, plugin version, and **runtime toolchain telemetry (health score & degradation rates)**;
 * `/gh upgrade`: Check the latest npm release and output platform-tailored upgrade instructions (macOS / Windows / Linux);
 * `/gh help`: View help documentation and example Agent dialogue recipes.
 

package/README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <b>让 DeepSeek Harness Agent 拥有操作 GitHub 的原生手和脚，为人机协作打造沉浸式 GitHub 工作台。</b><br>
-  原生复用宿主机 <code>gh</code> CLI 安全登录凭据，告别 Personal Access Token 泄露；深度打通本地 Git 工作区与云端仓库协作，兼具 <b>14 大领域 Agent 核心工具（85+ action，覆盖 PR 审查/Issue 任务/Actions 工作流与构建缓存治理/免 clone 读文件/分支规则集策略排障/代码片段 Gist/标签与全局待办大盘/密钥与变量管理）</b>、<b>人类 Slash 快捷指令</b>、<b>Web UI 全景工作台</b> 与 <b>一键自动跨平台无缝升级</b>。
+  原生复用宿主机 <code>gh</code> CLI 安全登录凭据，告别 Personal Access Token 泄露；深度打通本地 Git 工作区与云端仓库协作，兼具 <b>18 大领域 Agent 核心工具（104 个 action，覆盖 PR 审查/Issue 任务/Actions 工作流与构建缓存治理/免 clone 读文件/分支规则集策略排障/代码片段 Gist/标签与全局待办大盘/密钥与变量管理/智能体任务会话/社区 Discussions 讨论/Projects v2 看板/云端 Codespaces/运行时遥测与自愈健康度）</b>、<b>人类 Slash 快捷指令</b>、<b>Web UI 全景工作台</b> 与 <b>一键自动跨平台无缝升级</b>。
 </p>
 
 <p align="center">
@@ -73,7 +73,7 @@ dsh plugin --profile web add dsh-github-flow
 
 ## 🤖 核心工具集 (Agent Tools)：给 Agent 装上 GitHub 的手和脚
 
-本插件精选聚合为 **14 大领域核心工具（85+ action）**，拒绝几十个无用微型工具撑爆 Agent 上下文，原生搭载 **Token 防溢出保护（默认 24KB 智能二分截断）**、**高密度 Markdown 原生渲染（列表输出压缩 70%+ Token）** 与 **零参数 CWD 智能绑定**。
+本插件精选聚合为 **18 大领域核心工具（104 个 action）**，官方命令语义化覆盖率高达 **87%（104/120）**，拒绝几十个无用微型工具撑爆 Agent 上下文，原生搭载 **Token 防溢出保护（默认 24KB 智能二分截断）**、**高密度 Markdown 原生渲染（列表输出压缩 70%+ Token）**、**OAuth Scope 缺失单行自愈引导** 与 **零参数 CWD 智能绑定**。
 
 ### 1. `github_pr`：PR 全生命周期管理与自动化代码审查
 > **典型对话指令**：
@@ -205,7 +205,9 @@ dsh plugin --profile web add dsh-github-flow
   * `search`：跨 GitHub 开源仓库检索符合规范的 Agent Skills；
   * `preview`：免安装直接在线预览指定 Skill 的 `SKILL.md` 规则与行为指令；
   * `install`：一键安装指定 Skill 至本地环境（支持 `scope: 'project'` 或 `'user'`，需 `confirm: true`）；
-  * `list`：查看当前环境已安装的 Skills 清单。
+  * `list`：查看当前环境已安装的 Skills 清单；
+  * `publish`：🆕 **Agent 技能自检与发布闭环**：默认 `--dry-run` 模式进行 agentskills.io 规范体检，支持 `--fix` 自动剔除安装残留元数据，正式发版强制要求指定版本 `tag` 并附带 `confirm: true` 自动创建 GitHub Release；
+  * `update`：🆕 **批量检查与同步更新**：默认 `--dry-run` 只读比对本地与远端 SHA 差异，支持 `--all` 批量同步更新已安装技能。
 
 ---
 
@@ -216,11 +218,11 @@ dsh plugin --profile web add dsh-github-flow
 > - *"调用 gh 命令报错 'authentication failed'，该怎么排查？"*
 
 * **支持操作 (`topic` / `gh_command`)**：
-  * `overview`：输出全景工具箱导航与核心职责速查（14 大工具矩阵全景）；
+  * `overview`：输出全景工具箱导航与核心职责速查（18 大工具矩阵全景）；
   * `mapping`：**官方命令映射总表**，精准指示任意 `gh <command>` 对应哪个插件工具，以及未覆盖域对应的 GitHub REST/GraphQL 端点；
   * `search_syntax`：日期区间、状态筛选与高级布尔搜索语法指南；
   * `troubleshooting`：常见错误自愈配方（认证失效、网络超时、SOCKS5 代理配置、权限不足等）；
-  * 领域速查：`pr` / `issue` / `run` / `repo` / `release` / `secret` / `skill` / `label` / `ruleset` / `cache` / `gist` / `status` 专项高阶用法；
+  * 领域速查：`pr` / `issue` / `run` / `repo` / `release` / `secret` / `skill` / `label` / `ruleset` / `cache` / `gist` / `status` / `agent_task` / `discussion` / `project` / `codespace` 专项高阶用法；
   * `gh_command`：直接透传查询官方原生手册（如 `gh_command: 'ruleset'`）。
 
 ---
@@ -290,13 +292,78 @@ dsh plugin --profile web add dsh-github-flow
 
 ---
 
-### 14. `github_status`：跨仓库待办与动态全局大盘
+### 14. `github_status`：跨仓库待办与运行时健康度大盘
 > **典型对话指令**：
 > - *"帮我看看今天在 GitHub 上有哪些需要我处理的事情？"*
 > - *"查看当前账号在所有订阅仓库中的最新动态与 @提及"*
+> - *"查看当前工具链的运行健康度与 API 降级率报表"*
 
 * **支持操作 (`action`)**：
-  * `view`：**账号维度跨仓一站式聚合大盘**，汇总展示「指派给我的 Issue」、「指派给我的 PR」、「等待我评审的 PR (Review Requests)」、「提及我的消息 (Mentions)」以及「订阅仓库近期动态 (Repository Activity)」，无需绑定单仓即可一览全局工作台；支持 `-o` 组织过滤与 `-e` 排除噪音仓库。
+  * `view`：**账号维度跨仓一站式聚合大盘**（默认），汇总展示「指派给我的 Issue」、「指派给我的 PR」、「等待我评审的 PR (Review Requests)」、「提及我的消息 (Mentions)」以及「订阅仓库近期动态 (Repository Activity)」，无需绑定单仓即可一览全局工作台；支持 `-o` 组织过滤与 `-e` 排除噪音仓库；
+  * `health`：🆕 **工具链运行时健康度与降级率审计报表**：基于 Cordis `tools/result` 事件切面，实时审计全插件 18 大核心工具的调用总量、成功率、综合健康分（0~100 分）、API 降级率与智能自愈建议。
+
+---
+
+### 15. `github_agent_task`：云端编码智能体任务会话治理
+> **典型对话指令**：
+> - *"查阅我名下所有的 GitHub Copilot 智能体任务会话列表"*
+> - *"检视任务 'e2fa49d2' 的执行状态，并抓取详细会话日志"*
+> - *"向云端 Agent 发起新任务：'重构网络通信模块以支持自动重试'，基于 develop 分支"*
+
+* **支持操作 (`action`)**：
+  * `list`：列出当前用户关联的智能体任务（支持 `-L/--limit` 与 `-R/--repo`）；
+  * `view`：查看任务详情与会话执行日志（支持 `--log`，强制校验 `task_id` 防交互挂起）；
+  * `create`：向云端 Agent 派发新编码/重构任务（支持 `-b/--base` 指定基准分支，`-a/--custom-agent` 指定仓库智能体定义）。
+
+---
+
+### 16. `github_discussion`：团队技术研讨与开源社区 RFC 闭环
+> **典型对话指令**：
+> - *"查看当前仓库分类为 'Ideas' 的开放讨论列表"*
+> - *"查看讨论 #101 的正文内容与回复楼层"*
+> - *"在 'RFC' 分类下发起新讨论：'关于接入自动化遥测系统的提案'"*
+> - *"向讨论 #101 发表回复评论"*
+
+* **支持操作 (`action`)**：
+  * `list`：查阅 Discussions 列表（支持 `-c/--category`、`-s/--state`、`--labels` 与 `-S/--search` 过滤）；
+  * `view`：查看讨论正文与多楼层评论（支持 `--comments`，强制校验 `discussion_number`）；
+  * `create`：发起新讨论（`category`、`title`、`body` 三项必填，缺少给出友好指引）；
+  * `edit`：编辑现有讨论的标题或正文；
+  * `comment`：向指定讨论追加发表评论回复。
+
+---
+
+### 17. `github_project`：Projects v2 项目看板与任务规划
+> **典型对话指令**：
+> - *"列出我名下的所有 Projects v2 项目看板"*
+> - *"查看项目 #1 看板中的所有任务条目，筛选 open 状态"*
+> - *"将 Issue 'https://github.com/owner/repo/issues/10' 添加到项目 #1 看板中"*
+> - *"在项目 #1 看板中创建一个草稿条目：'完成单元测试覆盖'"*
+
+* **支持操作 (`action`)**：
+  * `list`：查看用户或组织的项目列表（默认 `owner: '@me'`，底层自动适配 `--format json` 勘误）；
+  * `view`：查看项目元数据、可见性、描述与 README；
+  * `item-list`：查看看板条目（支持 Projects 过滤查询语法 `--query`，如 `is:open assignee:@me`）；
+  * `item-add`：关联已有 Issue/PR URL 进看板；
+  * `item-create`：在项目中创建草稿条目（Draft Issue）；
+  * `item-delete`：从看板移除条目（强制 `confirm: true` 拦截）；
+  * 🔑 **权限自愈**：检测到缺少 `read:project` 权限时自动输出单行自愈授权卡片（`gh auth refresh -s read:project`）。
+
+---
+
+### 18. `github_codespace`：云端远程开发环境管控 (MVP)
+> **典型对话指令**：
+> - *"查看我当前有哪些运行中的 Codespace 云端开发机？"*
+> - *"检视实例 'fuzzy-spoon-69vj' 的机器规格与空闲停机策略"*
+> - *"把开发机 'fuzzy-spoon-69vj' 关机停止运行，防止扣除核时费用"*
+> - *"销毁已经用完的临时 Codespace 实例"*
+
+* **支持操作 (`action`)**：
+  * `list`：列出当前用户或组织名下的 Codespace 环境（展示状态、机器规格与上次使用时间）；
+  * `view`：检视环境详细配置与 DevContainer 路径（强制校验 `codespace` 名称防交互挂起）；
+  * `stop`：发送停机指令，立即停止计算资源计费；
+  * `delete`：安全销毁实例（物理销毁不可逆，强制 `confirm: true` 拦截，底层传 `-f` 保证无交互幂等删除）；
+  * 🔑 **权限自愈**：检测到缺少 `codespace` 权限时自动输出单行自愈授权卡片（`gh auth refresh -h github.com -s codespace`）。
 
 ---
 
@@ -429,7 +496,7 @@ dsh plugin --profile web add dsh-github-flow
 
 在 DSH 任意聊天窗口输入：
 
-* `/gh status`：一键诊断当前 GitHub CLI 账号认证状态、作用域、当前工作区关联仓库及插件版本；
+* `/gh status`：一键诊断当前 GitHub CLI 账号认证状态、作用域、当前工作区关联仓库、插件版本与**工具链运行时可观测性（健康分与 API 降级率）**；
 * `/gh upgrade`：主动检测 npm 最新版本，自适应输出当前操作系统（macOS / Windows / Linux）的最佳升级指引；
 * `/gh help`：查看帮助说明与 Agent 典型对话范例。
 

package/docs/UPGRADE-NOTES.md

@@ -10,8 +10,8 @@
 
 | # | 文件 | 位置 | 当前值 | 说明 |
 |---|---|---|---|---|
-| 1 | [package.json](../package.json) | 第 3 行 `"version": "0.4.0"` | `0.4.0` | npm 发布版本、CI 取版来源 |
-| 2 | [src/version.ts](../src/version.ts) | 第 9 行 `CURRENT_PLUGIN_VERSION = '0.4.0'` | `'0.4.0'` | 运行时版本比较基准（假横幅的教训来源） |
+| 1 | [package.json](../package.json) | 第 3 行 `"version": "0.5.0"` | `0.5.0` | npm 发布版本、CI 取版来源 |
+| 2 | [src/version.ts](../src/version.ts) | 第 9 行 `CURRENT_PLUGIN_VERSION = '0.5.0'` | `'0.5.0'` | 运行时版本比较基准（假横幅的教训来源） |
 
 **两处必须同值**。`pnpm run build` 会硬校验（[scripts/build.mjs](../scripts/build.mjs) 的
 `assertVersionConsistency`），不一致直接构建失败——但不要依赖拦截，发版前手动核对。
@@ -41,31 +41,28 @@
 | # | 机制 | 说明 |
 |---|---|---|
 | 9 | CI 取版（.github/workflows/npm-publish.yml:62） | `VERSION=$(node -p "require('./package.json').version")`——从 package.json 读，无硬编码 |
-| 10 | Git tag | `git tag v0.4.0` 手动打，值必须 = package.json 版本（tag 与 package.json 不一致时：CI 发布的 npm 版本以 package.json 为准，GitHub Release 标题以 tag 为准，出现两者错位） |
+| 10 | Git tag | `git tag v0.5.0` 手动打，值必须 = package.json 版本（tag 与 package.json 不一致时：CI 发布的 npm 版本以 package.json 为准，GitHub Release 标题以 tag 为准，出现两者错位） |
 
 ## 五、发版完整流程（含版本修改）
 
 ```powershell
 # 1. 改版本（两处同值）
-#    package.json  → "version": "0.4.0"
-#    src/version.ts → CURRENT_PLUGIN_VERSION = '0.4.0'
+#    package.json  → "version": "0.5.0"
+#    src/version.ts → CURRENT_PLUGIN_VERSION = '0.5.0'
 
 # 2. 文档已用占位符（npm-publish-guide 示例、README 安装命令），发版无需改文档版本号
 
 # 3. 构建（版本一致性校验在此拦截漏改）+ 全量测试
 pnpm run build
-pnpm test    # 16 阶段全绿
+pnpm test    # 全量测试全绿
 
 # 4. 本机 e2e（必须先重启 DSH 桌面进程——Node 模块缓存，软链重建不注入运行中进程）
-#    重启后验证：GET /api/github/check-update 的 currentVersion = 0.4.0
+#    重启后验证：GET /api/github/check-update 的 currentVersion = 0.5.0
 
 # 5. 提交 + 打 tag + 推送（tag 值 = package.json 版本）
 git add -A
-git commit -m "chore(release): v0.4.0"
-git tag v0.4.0
-git push origin master --tags
-#    CI（npm-publish.yml）自动：构建→发布 npm→创建 GitHub Release
-git tag v0.3.0
+git commit -m "chore(release): v0.5.0"
+git tag v0.5.0
 git push origin master --tags
 #    CI（npm-publish.yml）自动：构建→发布 npm→创建 GitHub Release
 

package/docs/architecture.md

@@ -35,7 +35,7 @@
 │            │                       │                        │               │
 │            ▼                       ▼                        ▼               │
 │  ┌──────────────────┐    ┌──────────────────┐    ┌───────────────────────┐  │
-│  │  14 大 Agent 工具 │    │  人类 Slash 指令 │    │   Host HTTP WebServer │  │
+│  │  18 大 Agent 工具 │    │  人类 Slash 指令 │    │   Host HTTP WebServer │  │
 │  │  (defineTool DSL)│    │  /gh status      │    │ (Effect Disposer 清理)│  │
 │  │  - pr (+attach)  │    │  /gh upgrade     │    │ - /api/github/overview│  │
 │  │  - issue (+attach│    │  /gh help        │    │ - /api/github/action  │  │
@@ -44,25 +44,36 @@
 │  │  - api (逃生门)  │  (workflow_enable/disable │  │ - /branch-switch      │  │
 │  │  - release       │   启停·list/view·download) │ - /api/github/git-    │  │
 │  │  - secret & var  │                            │   watch (定向监听)    │  │
-│  │  - skill         │  (search 三域=issues/prs/ │ - /check-update (并行)│  │
+│  │  - skill (+pub/up│  (search 三域=issues/prs/ │ - /check-update (并行)│  │
 │  │  - label (CRUD/cl│   commits; read_file/dir)  │ - /upgrade (一键自动) │  │
 │  │  - ruleset(check)│                            │ - /update-settings    │  │
 │  │  - cache (治理)  │                            │ - /proxy (全局代理)   │  │
 │  │  - gist (分享)   │                            │ - /auth (轻量探针)    │  │
-│  │  - status (大盘) │                            └──────────┬────────────┘  │
-│  │  - help (元指南) │                                       │               │
-│  └────────┬─────────┘                                       ▼               │
-│           │                                      ┌───────────────────────┐  │
-│           │                                      │ git-watcher (独立服务)│  │
-│           ▼                                      │ - .git/HEAD & index   │  │
-│  ┌──────────────────────────────────┐            │ - 800ms 防抖/35s 超时 │  │
-│  │ Markdown 渲染引擎 (renderers/)   │            └───────────────────────┘  │
-│  │ - common.ts: 单元格清洗/通用徽章 │                                       │
-│  │ - 11领域模块: pr/issue/run/repo/ │                                       │
-│  │   release/skill/label/ruleset/   │                                       │
-│  │   cache/gist/status 独立渲染     │                                       │
-│  │ - 统一门面出口 markdown.ts 兼容  │                                       │
-│  └──────────────────────────────────┘                                       │
+│  │  - status (健康) │                            └──────────┬────────────┘  │
+│  │  - agent_task    │                                       │               │
+│  │  - discussion    │                                       ▼               │
+│  │  - project (v2)  │                        ┌───────────────────────────┐  │
+│  │  - codespace(MVP)│                        │ git-watcher (独立服务)    │  │
+│  │  - help (元指南) │                        │ - .git/HEAD & index       │  │
+│  └────────┬─────────┘                        │ - 800ms 防抖/35s 超时     │  │
+│           │                                  └───────────────────────────┘  │
+│           ▼                                                 │               │
+│  ┌──────────────────────────────────┐                       │               │
+│  │ Markdown 渲染引擎 (renderers/)   │                       │               │
+│  │ - common.ts: 单元格清洗/通用徽章 │                       │               │
+│  │ - 15领域模块: pr/issue/run/repo/ │                       │               │
+│  │   release/skill/label/ruleset/   │                       │               │
+│  │   cache/gist/status/agent-task/  │                       │               │
+│  │   discussion/project/codespace   │                       │               │
+│  │ - 统一门面出口 markdown.ts 兼容  │                       │               │
+│  └──────────────────────────────────┘                       │               │
+│           │                                                 │               │
+│           ▼                                                 ▼               │
+│  ┌───────────────────────────────────────────────────────────────────────┐  │
+│  │ 遥测审计系统 (src/telemetry.ts ➔ Cordis tools/result 事件切面)        │  │
+│  │ - TelemetryRingBuffer (固定 200 条无锁环形队列，常驻内存 <200KB)      │  │
+│  │ - 实时计算 API 降级率 (Degradation Rate) 与工具链健康分 (0-100 分)     │  │
+│  └───────────────────────────────────────────────────────────────────────┘  │
 └─────────────────────────────────────────────────────────────┬───────────────┘
                                                               │
 ┌─────────────────────────────────────────────────────────────┼───────────────┐
@@ -110,7 +121,7 @@
 - **AI_AGENT 识别信号注入**：每次 gh 子进程启动注入 `AI_AGENT=dsh`（gh detect.go 最高优先级通用信号）——gh ≥2.99 自动切换 text-only spinner、≥2.100 命令误用时打印完整 help（模型可据此自我纠正）、telemetry 归因到 dsh；旧版 gh 忽略该变量零副作用。经 `agentEnvInjection` 配置开关（默认开启）可恢复 gh 原生行为。
 
 ### 2.3.1 高危操作确认与敏感值安全通道 (Safety Confirmation & Secret stdin Channel)
-- 不可逆写操作（`merge` / `close` / `issue delete`（物理删除）/ `issue transfer`（跨仓库迁移）/ `pr revert`（远端创建反向 PR）/ `release delete` / clobber 覆盖上传 / `secret delete` / `skill install` / `label delete`（物理删除且解绑）/ `cache delete all`（全量清空缓存）/ `gist delete`（代码片段永久删除））强制要求 `confirm: true` 显式参数，未确认时仅返回影响评估卡片，不产生任何远端或本地副作用；
+- 不可逆写操作（`merge` / `close` / `issue delete`（物理删除）/ `issue transfer`（跨仓库迁移）/ `pr revert`（远端创建反向 PR）/ `release delete` / clobber 覆盖上传 / `secret delete` / `skill install` / `skill publish`（创建 Release）/ `label delete`（物理删除且解绑）/ `cache delete all`（全量清空缓存）/ `gist delete`（代码片段永久删除）/ `codespace delete`（销毁开发机）/ `project item-delete`（移除看板条目））强制要求 `confirm: true` 显式参数，未确认时仅返回影响评估卡片，不产生任何远端或本地副作用；
 - 密钥明文仅经子进程标准输入传递（`spawnWithStdin` 通道：`spawn` + `stdin.end(data)` 半关闭写入），全程不出现在命令行参数、进程列表与工具输出中；渲染层对 secret 输出采用独立实现，从结构上隔离「绝不渲染 value 字段」这条安全红线。
 
 ### 2.3.2 产物落盘纪律 (Artifact Download Discipline)
@@ -132,9 +143,9 @@
 - [src/executor/platform-guide.ts](../src/executor/platform-guide.ts)：跨平台 CLI 安装引导与升级命令文本生成。
 
 ### 3.2 渲染层领域化细分 (`src/renderers/`)
-- [src/renderers/markdown.ts](../src/renderers/markdown.ts)（瘦身至 14 行）：门面出口，统一聚合导出全部领域子模块；
+- [src/renderers/markdown.ts](../src/renderers/markdown.ts)：门面出口，统一聚合 Re-export 全部领域子模块；
 - [src/renderers/common.ts](../src/renderers/common.ts)：表格单元格字符净化、各类状态药丸 Emoji 徽章、API 降级透明注解；
-- `pr.ts` / `issue.ts` / `run.ts` / `repo.ts` / `release.ts` / `skill.ts`：6 大领域独立渲染格式化，避免跨工具改动合并冲突。
+- 15 大领域独立渲染模块：`pr.ts` / `issue.ts` / `run.ts` / `repo.ts` / `release.ts` / `skill.ts` / `label.ts` / `ruleset.ts` / `cache.ts` / `gist.ts` / `status.ts` / `agent-task.ts` / `discussion.ts` / `project.ts` / `codespace.ts`，彻底实现高内聚低耦合，避免跨工具改动冲突。
 
 ### 3.3 本地 Git 元数据监听服务 (`src/git-watcher.ts`)
 - 独立底层服务模块，彻底剥离路由控制器内部的物理文件系统监听与定时器杂糅；
@@ -158,7 +169,7 @@
 
 ## 4. 自动化测试体系 (Test Suite)
 
-项目配备了 13 个独立阶段的全量自动化回归测试套件（`test/run-all.mjs`），覆盖 **562 项全量自动化测试断言**：
+项目配备了 **20 个独立阶段的全量自动化回归测试套件（`test/run-all.mjs`）**，覆盖 **880+ 项全量自动化测试断言**：
 - `phase1`：Issue / Run / PR / Repo / Help 命令装配与确认门禁；
 - `phase2`：Native Markdown 渲染与 Token 压缩率实测（>60% 降幅）；
 - `phase3`：Release 资产交付、Secret 密文管道与 Skills 检索；
@@ -171,4 +182,11 @@
 - `phase10`：版本守卫降级链（runGuarded）、AI_AGENT 注入与命令白名单；
 - `phase11`：右侧栏五 Tab 响应式互斥、Git 提交记录与滑动分页；
 - `phase12`：工作区物理所有权隔离、SWR 离线快照防抹杀与安全分支切换；
-- `phase13`：云端定时自动同步生命周期、三选一互斥设置模型与右侧栏独占本地 git-watch 监听。
+- `phase13`：云端定时自动同步生命周期、三选一互斥设置模型与右侧栏独占本地 git-watch 监听；
+- `phase14`：github_label（标签体系CRUD与克隆）与 github_ruleset（保护策略排障）；
+- `phase15`：github_cache（构建缓存治理）与 github_gist（代码片段与排障留痕）；
+- `phase16`：github_status（全局待办大盘）与 attach_images（图片附件上传通道）；
+- `phase17`：github_skill publish（agentskills.io 规范自检、--fix 修复与发布闭环）；
+- `phase18`：github_agent_task（云端编码智能体会话）与 github_discussion（社区讨论与RFC）；
+- `phase19`：github_project（Projects v2 看板）、github_codespace（云端开发机）与 skill update；
+- `phase20`：TelemetryRingBuffer、Cordis tools/result 事件总线运行时遥测、降级率统计与健康度看板。

package/lib/api/routes-actions.js

@@ -243,6 +243,27 @@ export function registerActionRoutes(deps, executor, cacheMap, globalCache) {
                             sendJson(res, 200, { ok: true, currentBranch: r.currentBranch, message: `已成功切换到分支 ${r.currentBranch}` });
                             break;
                         }
+                        case 'file_diff':
+                        case 'get_file_diff': {
+                            const fileTarget = typeof payload.file === 'string' ? payload.file.trim() : (typeof payload.filePath === 'string' ? payload.filePath.trim() : '');
+                            if (!fileTarget) {
+                                sendJson(res, 400, { ok: false, error: '缺少目标文件路径' });
+                                return;
+                            }
+                            const resolvedCwd = executor.resolveWorkspaceCwd(cwd);
+                            const r = await executor.getFileDiff(resolvedCwd, fileTarget);
+                            sendJson(res, 200, { ok: r.ok, data: r, error: r.error });
+                            break;
+                        }
+                        case 'uncommitted_files':
+                        case 'get_uncommitted_files': {
+                            const limit = Math.min(Math.max(1, Number(payload.limit) || 15), 100);
+                            const skip = Math.max(0, Number(payload.skip) || 0);
+                            const resolvedCwd = executor.resolveWorkspaceCwd(cwd);
+                            const r = await executor.getUncommittedFiles(resolvedCwd, limit, skip);
+                            sendJson(res, 200, { ok: true, data: r });
+                            break;
+                        }
                         default:
                             sendJson(res, 400, { ok: false, message: `未知的操作类型: ${payload.action}` });
                     }
@@ -353,4 +374,115 @@ export function registerActionRoutes(deps, executor, cacheMap, globalCache) {
             }
         },
     });
+    // 6. 纯本地 Git 状态毫秒级轻量查询（专供工作区改动时的局部定向刷新）
+    // 严格安全与性能纪律：
+    // 1. 动静解耦：仅执行本地 getLocalGitStatus、getGitCommitLog 与 getGitBranches；
+    // 2. 100% 零网络调用、零远端 GitHub API 请求、零 Token 额度消耗，耗时仅 5~10ms；
+    // 3. 彻底与 PR/Issue/Run 远端数据解耦，切断因修改本地文件误触发远端全量网络风暴与超时报错的恶性循环。
+    bindRoute({
+        kind: 'exact',
+        path: '/api/github/local-git-status',
+        handler: async (req, res) => {
+            if (req.method !== 'GET') {
+                sendJson(res, 405, { ok: false, message: '仅支持 GET 请求' });
+                return;
+            }
+            const url = new URL(req.url || '', 'http://127.0.0.1');
+            const cwd = url.searchParams.get('cwd');
+            if (!cwd || !hasGitDir(cwd)) {
+                sendJson(res, 400, { ok: false, error: '非 Git 仓库，无法获取本地 Git 状态' });
+                return;
+            }
+            try {
+                const gitStatus = await executor.getLocalGitStatus(cwd).catch(() => null);
+                const commitLog = await executor
+                    .getGitCommitLog(cwd, gitStatus ? gitStatus.hasUpstream : false)
+                    .catch(() => null);
+                const branches = await executor.getGitBranches(cwd).catch(() => null);
+                // 同步就地更新内存缓存中的本地元数据，保证后续全量请求也能自然拿到最新的本地状态
+                const cached = cacheMap.getFallback(cwd) || cacheMap.get(cwd, Date.now());
+                if (cached) {
+                    if (gitStatus)
+                        cached.gitStatus = gitStatus;
+                    if (commitLog)
+                        cached.commitLog = commitLog;
+                    if (branches)
+                        cached.branches = branches;
+                }
+                sendJson(res, 200, {
+                    ok: true,
+                    data: {
+                        gitStatus,
+                        commitLog,
+                        branches,
+                    },
+                    cwd,
+                });
+            }
+            catch (err) {
+                sendJson(res, 500, { ok: false, error: err?.message || '获取本地 Git 状态失败' });
+            }
+        },
+    });
+    // 7. 单个未提交文件的 Git Diff 差异查询（供右侧栏 FileDiffModal 调用）
+    bindRoute({
+        kind: 'exact',
+        path: '/api/github/file-diff',
+        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') || undefined;
+                const file = url.searchParams.get('file');
+                if (!file || !file.trim()) {
+                    sendJson(res, 400, { ok: false, error: '缺少必需的 file 参数' });
+                    return;
+                }
+                const resolvedCwd = executor.resolveWorkspaceCwd(cwd);
+                if (!hasGitDir(resolvedCwd)) {
+                    sendJson(res, 400, { ok: false, error: '当前工作区不是 Git 仓库' });
+                    return;
+                }
+                const diffResult = await executor.getFileDiff(resolvedCwd, file.trim());
+                if (!diffResult.ok) {
+                    sendJson(res, 400, { ok: false, error: diffResult.error || '获取文件差异失败' });
+                    return;
+                }
+                sendJson(res, 200, { ok: true, data: diffResult });
+            }
+            catch (err) {
+                sendJson(res, 500, { ok: false, error: err?.message || '获取文件差异失败' });
+            }
+        },
+    });
+    // 8. 本地未提交文件列表轻量流式分页查询（供右侧栏滑动加载调用）
+    bindRoute({
+        kind: 'exact',
+        path: '/api/github/uncommitted-files',
+        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') || undefined;
+                const limit = Math.min(Math.max(1, Number(url.searchParams.get('limit')) || 15), 100);
+                const skip = Math.max(0, Number(url.searchParams.get('skip')) || 0);
+                const resolvedCwd = executor.resolveWorkspaceCwd(cwd);
+                if (!hasGitDir(resolvedCwd)) {
+                    sendJson(res, 400, { ok: false, error: '当前工作区不是 Git 仓库' });
+                    return;
+                }
+                const result = await executor.getUncommittedFiles(resolvedCwd, limit, skip);
+                sendJson(res, 200, { ok: true, data: result });
+            }
+            catch (err) {
+                sendJson(res, 500, { ok: false, error: err?.message || '获取未提交文件列表失败' });
+            }
+        },
+    });
 }

package/lib/client.d.ts

@@ -8,10 +8,10 @@ declare global {
         };
     }
 }
-import { formatRelativeTime, rollupCiStatus, reviewDecisionBadge, eventLabel } from './ui/utils.js';
+import { formatRelativeTime, rollupCiStatus, reviewDecisionBadge, eventLabel, parseGitStatText } from './ui/utils.js';
 import { GITHUB_PANEL_CSS, injectStyles } from './ui/styles.js';
 import { renderOctocat, renderGitIcon, renderOctocatBadge, renderPluginBadge } from './ui/icons.js';
-import { getLocalSyncSettings, saveLocalSyncSettings, getStoredGlobalOverview, saveStoredGlobalOverview, clearStoredGlobalOverview, getCacheStorageMeta, getRightbarStorageKey, getStoredRightbarSnapshot, saveStoredRightbarData } from './ui/storage.js';
+import { getLocalSyncSettings, saveLocalSyncSettings, getStoredGlobalOverview, saveStoredGlobalOverview, clearStoredGlobalOverview, getCacheStorageMeta, getRightbarStorageKey, getStoredRightbarSnapshot, saveStoredRightbarData, getStoredHeaderCardsVisible, saveStoredHeaderCardsVisible, HEADER_CARDS_STORAGE_KEY } from './ui/storage.js';
 import { BranchSelectorDropdown } from './ui/branch-selector.js';
 import { AuthGuideCard } from './ui/auth-guide-card.js';
 import { UpgradeNotificationCard } from './ui/upgrade-card.js';
@@ -19,5 +19,6 @@ import { NetworkAlertBanner } from './ui/network-banner.js';
 import { SyncStatusBadge } from './ui/sync-status-badge.js';
 import { CommitDetailModal } from './ui/commit-modal.js';
 import { GlobalSyncSettingsModal } from './ui/sync-settings-modal.js';
+import { GithubHelpModal } from './ui/help-modal.js';
 import { GithubWorkspacePanel } from './ui/workspace-panel.js';
-export { formatRelativeTime, rollupCiStatus, reviewDecisionBadge, eventLabel, GITHUB_PANEL_CSS, injectStyles, renderOctocat, renderGitIcon, renderOctocatBadge, renderPluginBadge, getLocalSyncSettings, saveLocalSyncSettings, getStoredGlobalOverview, saveStoredGlobalOverview, clearStoredGlobalOverview, getCacheStorageMeta, getRightbarStorageKey, getStoredRightbarSnapshot, saveStoredRightbarData, BranchSelectorDropdown, AuthGuideCard, UpgradeNotificationCard, NetworkAlertBanner, SyncStatusBadge, CommitDetailModal, GlobalSyncSettingsModal, GithubWorkspacePanel, };
+export { formatRelativeTime, rollupCiStatus, reviewDecisionBadge, eventLabel, parseGitStatText, GITHUB_PANEL_CSS, injectStyles, renderOctocat, renderGitIcon, renderOctocatBadge, renderPluginBadge, getLocalSyncSettings, saveLocalSyncSettings, getStoredGlobalOverview, saveStoredGlobalOverview, clearStoredGlobalOverview, getCacheStorageMeta, getRightbarStorageKey, getStoredRightbarSnapshot, saveStoredRightbarData, getStoredHeaderCardsVisible, saveStoredHeaderCardsVisible, HEADER_CARDS_STORAGE_KEY, BranchSelectorDropdown, AuthGuideCard, UpgradeNotificationCard, NetworkAlertBanner, SyncStatusBadge, CommitDetailModal, GlobalSyncSettingsModal, GithubHelpModal, GithubWorkspacePanel, };