173787247/dsh-wsl-github

套件安装： 见 dsh-wsl-kit。推荐 KIT_SET=daily | llm | github | full。故障树：TROUBLESHOOTING.zh.md。

DeepSeek Harness 工具：github_app_hint + github_repo_status — 用 GitHub App 鉴权，查看当前仓库未关闭的 PR 与最近一次 Actions。

属于 dsh-wsl-kit。

English → README.md

在套件里的位置

提示 GitHub App 环境文件在不在，并报告仓库 PR / Actions。绝不倾倒密钥。

flowchart LR
  agent["dsh agent"] --> gh["dsh-wsl-github"] --> api["GitHub API 状态"]

整套关系图和版本快照：dsh-wsl-kit 中文说明。本插件是 0.2.0（github）。不要把那份总表抄进本 README。

---

兼容性

项	值
插件	dsh-wsl-github 0.2.0
最低 dsh	≥ 0.1.2（Windows 中继 :3081 一次性 ?token=）
最新验证	以 dsh-wsl-kit 兼容性 为准（当前 0.2.0-rc.2）— 套件唯一真源
套件档位	github / full
云端 Flash	settings / llm-deepseek 使用 deepseek-flash（V4.1 Flash）；本插件不配置模型 id
Agent Teams	上游实验包；本插件不依赖

套件版本地板：check-plugin-versions.sh。故障树：TROUBLESHOOTING.zh.md。

为什么需要这个插件

WSL 里的 Agent 已有 dsh-wsl-cred（cred_hint）管 git 推送凭据。还需要 GitHub API 回答「开着哪些 PR？」「CI 绿了没？」——并且不要把 PAT 贴进对话。

本插件在内存里换短期 GitHub App installation token。工具输出不含私钥、JWT、token。返回的 html_url 用 dsh-wsl-browser 的 win_open_url 在 Windows 浏览器打开。

刻意做小：不是 40 个工具的通用 GitHub 连接器。

和 dsh-wsl-kit 怎么配合

DSH 在 WSL、聊天在 Windows 浏览器，正是 kit 的主场。连 GitHub 时建议整套一起用：

要做的事	插件	工具
推送 / HTTPS 凭据	dsh-wsl-cred	cred_hint
API：未关闭 PR + 最近 Actions	本插件	github_app_hint、github_repo_status
在 Windows 打开 PR / Actions	dsh-wsl-browser	win_open_url
代理 / Node 24 打不通	dsh-wsl-net	net_doctor

走 kit 为什么方便

• 跟路径、剪贴板、通知同一套装（dsh-wsl-kit / install.sh），不用临时塞 PAT。
• 密钥落在 ~/.dsh/ 与进程内存，不进 Trajectory。
• 和 kit 其它插件同一心智模型：小工具、分清 WSL / Windows 边界。
• 有真实的 GitHub App 集成，可报名 GitHub Developer Program。

套件总览：dsh-wsl-kit 中文说明。

工具

工具	作用
github_app_hint	是否已配置 App / ~/.dsh/dsh-wsl-github.env（只查存在性）、配置步骤与 vs cred/ssh/win_open_url 分工（不回传密钥）
github_repo_status	未关闭 PR（最多 5 条）+ 最近一次 Actions。可传 repo，默认 git origin

配好 env 后可自测 github_app_hint（不做真实 App 冒烟，需用户 PEM）。

端到端用法（WSL）

1. 安装插件（随 kit 或单独）：

dsh plugin --profile web add github:173787247/dsh-wsl-github

2. 一次性注册 GitHub App（权限来自 github-app-manifest.json，已预填）：

npm run register-app

在 GitHub 上保留或改名 → 点 Create GitHub App。脚本把 App ID 和 PEM 写到 ~/.dsh/，不会把密钥打到终端。

权限	访问	用途
Metadata	读	仓库名、默认分支
Pull requests	读	列出未关闭 PR
Actions	读	最近一次 workflow
Webhook	关	本插件轮询 API，不收事件
安装范围	私有 App（public: false）	开发时装到自己的账号

3. 把 App 安装到你的 GitHub 账号（脚本打印的 Install 链接，或 apps/dsh-wsl-github）。可选 All repositories，或只勾需要的仓库。

4. 启动 dsh web 前加载环境（WSL / bash）：

set -a
source "$HOME/.dsh/dsh-wsl-github.env"
set +a
dsh web

若从 Windows PowerShell 启动：

Get-Content "$HOME\.dsh\dsh-wsl-github.env" | ForEach-Object {
  if ($_ -match '^(GITHUB_[A-Z_]+)=(.*)$') { Set-Item -Path "Env:$($matches[1])" -Value $matches[2] }
}

5. 开新会话，例如对 Agent 说：

   • 「跑一下 github_app_hint。」
   • 「对当前仓库跑 github_repo_status。」
   • 「用 win_open_url 打开那个 html_url。」

连不上 GitHub HTTPS 时跑 net_doctor；git push 失败时跑 cred_hint——那是另一件事，不是本插件的职责。

不用脚本时：打开 注册 GitHub App，Homepage 填 https://github.com/173787247/dsh-wsl-kit，权限同上、关掉 webhook，生成私钥后：

cp examples/dsh-wsl-github.env.example ~/.dsh/dsh-wsl-github.env
# 编辑填入 GITHUB_APP_ID，PEM 放到 ~/.dsh/dsh-wsl-github.pem
source "$HOME/.dsh/dsh-wsl-github.env"

或手动：

export GITHUB_APP_ID=123456
export GITHUB_APP_PRIVATE_KEY_PATH="$HOME/.dsh/dsh-wsl-github.pem"

GITHUB_TOKEN / GH_TOKEN 只适合本机冒烟，不是正式鉴权。

可选：API 通了之后到 github.com/developer/register 加入 Developer Program（产品网站可填 kit 或本插件仓库地址）。

配置

- id: dsh-wsl-github
  name: dsh-wsl-github
  config:
    timeoutMs: 20000
    appId: ""
    privateKeyPath: ""
    installationId: ""

空字符串表示「从环境变量读」。后写的 profile config 会整段替换。

测试

npm test

许可

MIT