前言¶
在 DeepSeek Harness（DSH）里做开发协作时，常见做法是手动打开 GitHub 网页、复制 API 文档，或把 Personal Access Token 写进脚本再交给智能体调用。令牌容易进日志或上下文，写操作也不好一眼看清「刚才到底调了哪些接口」。dsh-gitdeck 是社区插件，维护者为 hulibuld，分类为联网工具；它在 DSH 对话界面接入 GitHub 账号，授权后由 AI 通过内置的 github_api 工具代你建仓库、传文件、改代码、处理 issue 与 PR、查看 Actions 日志，并在面板侧提供只读模式与调用留痕。下面介绍它是什么、怎么装、怎么连、典型怎么说事，以及使用时要注意什么。
这是什么¶
dsh-gitdeck 的定位是「Git 操作台」：在 DSH 里连接你的 GitHub 账号，让 AI 以你的身份完成常见 GitHub 操作，而不必在对话里背诵 REST 路径。README 写明：令牌只保存在本机 ~/.dsh/.dsh-gitdeck/auth.json，权限为 0600，不会进入上下文、不会进仓库、也不会出现在插件日志里。package.json 当前版本为 0.1.1，许可证 MIT，要求 Node.js >= 20.18.1，peer 依赖 @deepseek-ai/cordis ^4.0.1。
社区目录页：https://www.skillhub.cn/plugins/hulibuld/dsh-gitdeck
源码与说明：https://github.com/hulibuld/dsh-gitdeck
DSH 生态强调「一切皆插件」；SkillHub 等目录是独立站点，与 DeepSeek / 幻方无官方从属关系，本文仅依据上述仓库 README 与 package.json 描述能力。
核心功能¶
已核实的能力包括：
- 账号连接：OAuth 设备流（推荐）或粘贴 fine-grained / classic Token 两种方式。
- 仓库与内容：建仓库、传文件、改代码（README 示例含「把桌面文件夹建成私有仓库」「改 README 错字并提 PR」）。
- 协作与 CI：提 issue、开 PR、读 PR、给 issue 打标签、查看 PR 对应 CI / Actions 日志。
- 对 AI 的接口：连上后无需记 API，AI 通过
github_api发请求；路径、查询串、中文文件名均可处理。 - 三道保险（README 表格）：
- 只读模式：面板「设置」中开启后仅放行 GET，写操作返回 403。
- 调用留痕：面板「记录」可查看每次调用的方法、路径、状态码、耗时（重启后清空）。
- 随时断开：面板「断开连接」立即作废本地会话；也可在 GitHub → Settings → Applications 撤销授权。
安装与启用¶
先做本地或市场安装，再重启 DSH，输入框左下角会出现「Git」按钮。
官方 README 给出的安装方式如下（路径需换成你本机 clone 或解压后的目录，不要用未在文档中出现的 dsh plugin add github:owner/repo 形式）：
dsh plugin --profile desktop add link:/path/to/dsh-gitdeck
文档另说明：发布到 npm 之后可在 profile 里全局安装并在市场搜索 dsh-gitdeck。装完重启 DSH 后才会出现「Git」入口。
安装前建议自行浏览仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，写操作会真实改动你的 GitHub 资源。
连接 GitHub¶
两条路任选其一。
A. OAuth 设备流（推荐）¶
- 在 GitHub 打开 Settings → Developer settings → OAuth Apps → New OAuth App。
- 名称随意；回调地址填
http://127.0.0.1/。 - 复制 Client ID，粘贴到 DSH 面板，点击「开始连接」。
- 浏览器自动打开后，输入面板上显示的 8 位码并 Authorize。
- 回到 DSH，面板显示「已连接 @你的用户名」。
设备流需要浏览器能访问 github.com（443）。若连不上授权页，README 提示可能是网络限制，需先确认浏览器能打开 GitHub 站点。
B. 粘贴 Token¶
可使用 fine-grained token，只勾选需要的仓库与权限（例如 Contents 读写、Issues、Pull requests）。
代理与状态¶
插件配置支持代理，例如：
proxy: "http://127.0.0.1:7890"
或强制直连：
proxy: "direct"
若状态异常：关闭再打开面板会重新读取状态；「重新验证」会用当前令牌请求一次 /user。
典型用法¶
连上之后用自然语言描述意图即可，README 给出的示例如下：
- 「把桌面那个文件夹建成私有仓库」
- 「看看这个 PR 的 CI 为什么挂」
- 「给这个 issue 打上 bug 标签」
- 「把 README 里那段的错字改掉，提个 PR」
经过上面的步骤，AI 会通过 github_api 完成具体 HTTP 调用；你可在面板「记录」里核对方法与路径。若开启只读模式，则仅查询类请求会通过。
适用场景与注意¶
适合谁：经常在 DSH 里让 AI 协助 GitHub 日常操作、又希望令牌留在本机、并需要只读开关与调用审计的开发者。
务必注意：
- 写操作在关闭只读模式时会真实生效；安装与授权前请确认信任来源与权限范围。
- 调用留痕在进程重启后清空，不能当作长期审计日志。
- 排障信息以 README 为准：OAuth 依赖
github.com可达；API 走api.github.com时网络情况可能不同，需分别排查。
结尾¶
dsh-gitdeck 把 GitHub 账号接到 DSH 对话里，用 OAuth 设备流或 Token 二选一，配合只读模式与调用留痕，降低「令牌进上下文」和「误写仓库」的风险。当前 package.json 版本 0.1.1，详情与 issue 见 GitHub 仓库；社区索引见 SkillHub 目录页。
- 目录页：https://www.skillhub.cn/plugins/hulibuld/dsh-gitdeck
- GitHub：https://github.com/hulibuld/dsh-gitdeck
