dsh-github-ops

让 DeepSeek Harness 直接操作你的 GitHub：建仓库、写文件、clone / commit / push 真实代码、开 PR、提 issue、搜索。

Turn DSH into a GitHub operator — not just a reader. Create repos, write files, clone / commit / push real code, open PRs and issues. Token lives in the credential store, never in config.

---

为什么要多一个 GitHub 插件

市面上已有的 GitHub 插件基本是只读的：搜仓库、读文件、看 issue。 这个插件是可写可管理的 —— 你说"帮我把这个目录传上去"，它就真的建仓库、推代码； 你说"把安装说明改成从 Release 下载"，它就改文件、提交、推送。它同时给你三个层次的入口：

层次	走哪条路	工具
仓库本身（建 / 删 / 看 / 列）	GitHub REST API	github_repo
仓库里的文件（读 / 列目录 / 直接改写）	GitHub Contents API	github_file
本地真的改代码再推上去	你机器上的 git	github_git

外加 github_pr / github_issue / github_search，以及把 token 存进 DSH credential store 的 github_auth。

安装

一行装（从 GitHub 源码）

dsh plugin add github:Lzfbite/dsh-github-ops

在 DSH 插件市场里点一下

本插件已提交到 awesome-dsh-plugin 精选列表； 收录后打开市场 → 分类 git → 找到 dsh-github-ops → 一键安装。

用预构建包（最快，不需要任何构建）

dsh plugin add https://github.com/Lzfbite/dsh-github-ops/releases/latest/download/dsh-github-ops-1.0.0.tgz

这是一个 host-only bundle，只有一个 index.js，没有依赖、没有构建步骤、没有 postinstall。 装完重启 DSH，7 个工具立刻出现在工具列表里。

连上你的账号

插件不会、也不能替你生成 token。去 GitHub → Settings → Developer settings → Personal access tokens 建一个，然后：

github_auth action=login token=ghp_xxxxxxxx

推荐 fine-grained token（可只授权某几个仓库），需要的能力：

能力	用来做什么
Contents: Read & write	github_file 读写、github_git 推送
Metadata: Read	列出/查看仓库
Pull requests: Read & write	github_pr 建 PR / 合并 / 评论
Issues: Read & write	github_issue 建 issue / 评论 / 关闭
Administration: Read & write	只在创建或删除仓库时需要

经典 token 的话，repo + workflow 基本够用。存好之后 github_auth action=status 会告诉你： 连的是谁、token 从哪来（credential store / 环境变量 / 本次会话）、git 是否可用。

GitHub：@yourname（Your Name）· token 来源：credential store（dsh-github/token）
可选 scope：repo, workflow
git：git version 2.55.0.windows.5

七个工具

github_auth

status 看状态 · login 保存 token · logout 清掉已保存的 token。

github_repo

list · view · create · delete 删除必须原样复述 owner/name 到 confirm 参数里 —— 防手滑，也防模型自作主张。

github_file

read · list · write write 会自动取已有文件的 sha 做更新，不用先读一遍；message 就是提交信息。

github_git（真实 git，跑在你自己机器上）

clone · status · diff · log · commit · push · pull · fetch · checkout · branch

• clone 默认落到 ~/dsh-github/<owner>/<name>（DSH_GITHUB_DIR 可改）。
• commit 默认 git add -A 后提交；push / pull 自动带上 token 认证。
• 认证走一次性 header，origin 的 URL 里不会出现 token。

github_pr

list · view · create · merge · comment

github_issue

list · view · comments · create · comment · close · reopen

github_search

repos · code · issues —— 支持 GitHub 搜索语法，如 language:rust stars:>500。

用起来是什么样

你：把 D:\work\my-app 这个项目传到我 GitHub 上
它：github_repo create name=my-app  →  github_git clone  →  拷贝文件
    github_git commit message="初始提交"  →  github_git push
    仓库：https://github.com/you/my-app

你：给 my-app 加个 CI，跑完给我开个 PR
它：github_file write .github/workflows/ci.yml  →  github_git checkout -b ci
    github_git commit  →  github_git push  →  github_pr create ...

安全边界（重要）

• token 存 DSH credential store，记录地址 dsh-github/token；取不到 store 才退回环境变量 GITHUB_TOKEN / GH_TOKEN，再退回本进程内存（此时会明确告诉你"只在本会话有效"）。
• token 不会写进插件配置（配置可能被导出、分享、贴进 issue）。
• token 不会进 git remote URL；git 只用一次性的 http.https://github.com/.extraheader。
• 工具输出里出现的任何 token 形态都会被抹成 ***。
• 删仓库要求重复确认；其余写操作都是人看得见的一步，不做后台批量动作。

环境变量（都可选）

变量	默认	说明
DSH_GITHUB_DIR	~/dsh-github	github_git clone 的落点
GITHUB_API_URL	https://api.github.com	GitHub Enterprise / 代理端点
GITHUB_TOKEN / GH_TOKEN	—	没有 credential store 时的兜底

兼容性

• DSH Desktop / dsh CLI，host 侧插件（export function apply(ctx) + export const inject = ['tools']）。
• 需要系统里装了 git（只有 github_git 用到；纯 REST 那几个工具不需要）。
• 无 peer 依赖、无构建、无 postinstall —— 装完即用。

开发

git clone https://github.com/Lzfbite/dsh-github-ops
cd dsh-github-ops
dsh plugin add "$PWD"     # 或 dsh plugin add github:Lzfbite/dsh-github-ops

index.js 是一个文件，语义按工具分段；改完重启 DSH 生效。

License

MIT © 2026 Lzfbite