前言¶
DeepSeek Harness 的核心理念是「一切皆插件」。在使用 Agent 辅助工程研发时，开发者需要频繁与 GitHub 进行交互，例如创建 PR、排查 CI 失败或管理密钥。传统方式往往依赖手动在网页端操作或配置明文 Token，不仅效率低，还存在安全隐患。
dsh-github-flow 是由 ItQianChen 维护的插件。它让 DeepSeek Harness Agent 拥有操作 GitHub 的原生能力，通过原生复用宿主机的 gh CLI 安全登录凭据，实现 PR/Issue/Actions 工作流治理、密钥管理及全景工作台，为人机协作打造沉浸式 GitHub 工作环境。
安装与前置要求¶
本插件依赖 GitHub CLI (gh) 进行认证，需先在宿主机安装并登录。
- 前置准备
安装 GitHub CLI 并登录：
# macOS
brew install gh
gh auth login
# Windows (PowerShell)
winget install --id GitHub.cli
gh auth login
- 安装插件
在 DSH 终端根据环境选择对应命令：
# DSH 桌面版
dsh plugin --profile desktop add dsh-github-flow
# DSH Web / CLI 环境
dsh plugin --profile web add dsh-github-flow
DSH 内置包管理器默认启用了供应链安全策略。新版本发布后的 24 小时内执行裸名安装会自动回退至上一稳定版。若需立即安装新版本，请显式指定版本号（例如 `dsh-github-flow@0.3.0`）。
核心能力¶
该插件聚合为 9 大领域核心工具，覆盖 PR/Issue/Actions 工作流治理、密钥与变量管理，并具备 Token 防溢出保护（默认 24KB 智能二分截断）与高危操作二次确认机制。
PR 全生命周期管理¶
Agent 可以对 PR 进行创建、审查、合并、更新分支及冲突检查等操作。
* 操作：支持列出 PR、查看详情、获取代码差异、检查 CI 门禁、创建 PR、合并（支持 squash/merge/rebase）、撤销合并等。
* 特性：支持 Draft ↔ Ready 切换、创建反向提交、下载 PR 讨论截图。
CI 流水线排查与修复¶
用于定位 CI 构建失败原因并辅助修复。
* 操作：支持查看 CI 运行历史、精准提取失败步骤日志、重新触发工作流、查看工作流清单与详情、下载构建产物。
* 特性：提供 log_failed 等核心工具，帮助 Agent 快速诊断并定位问题代码。
缺陷跟踪与任务闭环¶
管理 Issue 的全生命周期。
* 操作：支持多条件检索 Issue、创建与编辑 Issue、分配与锁定、评论、关闭、物理删除、跨仓库迁移、从 Issue 一键切出开发分支。
* 特性：支持置顶、按分配人与提及状态分段查看。
仓库探索与跨库检索¶
无需 clone 仓库即可进行探索。
* 操作：支持查看仓库元数据、读取 README、跨仓库或全站搜索代码/仓库/Issue/PR。
* 特性：提供免 clone 读取任意文件和目录清单的能力，提升检索效率。
底层 API 与发布管理¶
- GitHub API：提供底层 REST/GraphQL 调用能力，支持
--jq过滤与自动翻页。 - 版本发布：支持查看、创建、上传/下载构建资产到 Release，自动根据提交记录生成发版说明。
CI/CD 密钥与变量管理¶
安全地管理仓库 Secrets 和 Actions 变量。
* 操作：支持查看密钥/变量清单、设置/更新密钥值、删除密钥。
* 特性：密文经子进程标准输入传递，绝不暴露在命令行参数中；支持仓库/组织/环境三级作用域。
Web UI 全景工作台¶
内置沉浸式工作台，提供 PR 门禁、CI 流水线、Issue 矩阵的全景视图，无需在多个应用间切换。
典型用法¶
通过自然语言指令即可调用上述能力：
* PR 交互："帮我检查当前仓库有没有需要我审查的 PR？"
* CI 修复："最近一次 Actions 工作流为什么挂了？提取失败步骤日志并帮我修复"
* Issue 管理："把刚才复现的 Bug 提一个 Issue，打上 'bug' 和 'backend' 标签"
* 代码搜索："在当前仓库搜索使用到 'createPrTool' 的代码行"
* 版本发布："给当前仓库发布 v0.2.0 版本，自动根据提交记录生成发版说明"
* 密钥更新："帮我把新的 NPM_TOKEN 更新到当前仓库的 Secrets 里"
注意事项¶
- 前置依赖：必须前置安装并登录 GitHub CLI (
gh)。 - 平台支持：支持 macOS、Windows 和 Linux 平台。
- 安全机制：高危操作（如删除、合并、设置密钥）需二次确认；Token 防溢出保护默认开启。
- 兼容性：兼容 Cordis 框架。
总结¶
dsh-github-flow 解决了 Agent 在 GitHub 工作流中“看得见、进不去、改不动”的痛点。它通过复用 gh CLI 的安全凭据，提供了从代码审查到 CI 修复、从 Issue 管理到密钥维护的完整工具链，帮助开发者构建高效的沉浸式 GitHub 工作台。
更多信息请参考：GitHub 仓库
