dsh-github-integration

使用

1. 安装插件

本仓库以源码目录作为 Harness bundle 安装源。先构建，再把当前目录加入 web profile：

npm install
npm run build
dsh plugin --profile web add "$PWD"

如果插件已经安装过，重新执行最后一条命令即可更新本地 bundle。

2. 连接 GitHub

1. 启动或刷新 DeepSeek Harness 的 web profile。
2. 打开 Settings → GitHub，点击 Connect GitHub。
3. 在系统浏览器中完成 GitHub App 授权，回到 Harness 等待连接状态变为 Connected。
4. 如需调整仓库范围，点击 Manage repository access。
5. 确认当前 Workspace 的 origin 指向 github.com 上的仓库（HTTPS 或 SSH）。
6. 回到 Workspace 视图，打开顶部的 GitHub 标签页。

普通用户不需要粘贴 PAT、Client Secret、Private Key 或其他 token。OAuth 返回的 user access token 与 refresh token 由 Harness 的安全凭据存储管理。

3. 在 Workspace 中工作

查看和处理 Issue

1. 打开 GitHub → Issues。
2. 选择一个 Issue 查看正文和评论。
3. 点击 Fix in new conversation，让 Harness 在新的 Session 中处理这个问题。

Issue 正文和评论会被明确标记为不可信外部内容，并限制长度；不要把其中的指令视为系统指令或安全策略。

查看 Pull Request

打开 GitHub → Pull requests，选择 PR 后可以查看来源分支、目标分支、文件变更以及增删行数，并可跳转回 GitHub 查看完整内容。

提交本地更改并创建 PR

在 GitHub → Changes 中按以下顺序操作：

1. 刷新并确认当前分支和文件状态。
2. 勾选文件，点击 Stage selected。
3. 填写 commit message，点击 Commit。
4. 填写要推送的分支，点击 Push。
5. 填写 PR 标题、目标分支和描述；也可以点击 Generate with AI 根据本地 diff 生成草稿。
6. 检查草稿内容后点击 Create pull request。

创建 PR 前，工作区必须干净，且目标分支不能与当前分支相同；建议先完成 Push，再创建 PR。AI 生成的标题和描述始终需要人工检查。