前言¶

在 DSH 里写代码、跑任务时，经常遇到的一个麻烦是：GitHub 上的情况不在视野里。想知道某个仓库的 description 是不是还空着、CI 有没有开、最近有没有 fork 忘了清理，得切回浏览器或者终端里敲 gh。切换次数多了，上下文就断了。

dsh-github-panel 把这件事收进侧面的 GitHub 图标里：它调用你已经登录在本机上的 GitHub CLI（gh），把连接状态、仓库统计、待办清单和可以安全执行的元数据修改，汇总到一页。不需要粘贴 token，不需要 API key，也不需要再登录一次——登录态在 gh 和系统钥匙串里。

这个插件由 zayyehtut 维护，分类是联网工具，属于社区提交的目录项目。下面按「是什么、有什么能力、怎么装、怎么用、有什么限制」几块介绍。

这是什么¶

一句话定位：一个 DSH 插件，在 Web UI 左侧栏加一个 GitHub 面板，读取并操作「当前这台 PC 上已经登录的那个 GitHub 账号」。

它解决的痛点有两个：一是不用离开 Harness 就能核对账号和仓库状态；二是仓库管理动作（改描述、加 topics、归档、改名）可以直接在面板里做，不用打开网站找入口。

核心功能¶

README 里列出的能力如下，按页面分区描述。

1、连接状态一眼可见。面板显示 Connected as @you，走的是哪个账号、token 有哪些 scope，由 GitHub 报告后显示。

2、仓库统计。总数、公开数、私有数、已归档数，以及有多少仓库写了 description、有多少写了 topics。

3、Needs attention 清单。缺 description 或 topics 的仓库、空仓库、不再使用的 fork、profile README、空 bio、用不上的 pinned 仓库、重复的 gist，都归到这一栏，作为动手的起点。

4、可搜索的仓库列表。可以按条件筛选，然后在行内编辑 description 或 topics、归档或取消归档、改名，或者直接在 GitHub 上打开该仓库。

5、Profile 与 pins 说明。README 明确列出 GitHub API 能改什么、不能改什么，不能改的给链接跳到对应的 GitHub 设置页面。

6、健康报告。按仓库检查 README、License、.gitignore、CI、测试和疑似密钥，并给出可以一键执行的安全修复。

安装与启用¶

有三条安装路径，按你的使用环境选一条。

方式一：DeepSeek Harness 应用里直接装，README 称之为最简单。

github:zayyehtut/dsh-github-panel

在左侧边栏打开 Plugins，点 Add plugin，把上面这串填进 package 字段，然后点 Install，再点 Enable now。如果 GitHub 图标没有立刻出现，重载一次窗口。

方式二：用命令行，通过 dsh web 安装。官方命令如下，装完需要重启 dsh web；如果你用的是自定义 profile，把 web 换成你的 profile 名。

dsh plugin --profile web add github:zayyehtut/dsh-github-panel

方式三：走社区目录 dsh-market。插件已经提交到该目录，等它出现后搜索 GitHub panel 即可一键安装。

README 还给出了一条提醒：如果用的是桌面版 DeepSeek Harness，请用方式一。桌面版管理自己的 profile，通过命令行装到 profiles/web 的东西不会显示在桌面版里。

安装前需要满足三个条件，README 用表格列了出来：

1、DeepSeek Harness 0.2.1 或更高版本（README 在 0.2.1-rc.5 上测试过）。

2、本机已安装 GitHub CLI。

3、已经通过 CLI 登录 GitHub。

自查命令分别是 dsh --version、gh --version、gh auth status。

典型用法¶

安装启用后第一次运行，流程是固定的。

1、点左侧边栏（Plugins 和 Automation tasks 旁边）的 GitHub 图标。

2、面板显示连接账号和仓库计数。

3、如果提示未连接：在终端里跑 gh auth login，回到面板点 Re-check。

4、用仓库列表上方的筛选条件缩小范围，从 Needs attention 清单开始处理。

改 description 或 topics 这类动作，面板会先从 GitHub 重新读一遍仓库状态，并校验要写入的内容，然后才提交。改完之后可以在列表里直接看到结果。

排查问题时，README 给了一张症状表，摘几条常用的：

1、图标不见了 —— 到 Plugins 页面确认 bundle 已启用，重载窗口，确认 DSH 是 0.2.1 或更高版本。

2、提示 “Not connected on this PC” —— 跑 gh auth login，用 gh auth status 确认，再点 Re-check。

3、账号显示不对 —— 用 gh auth switch（或对正确账号跑 gh auth login），再点 Re-check。

4、一直停在 “Loading your GitHub account…” —— 检查网络能否访问 GitHub API，并在终端里确认 gh api user 能跑通。

5、沙箱主机里找不到 gh —— 把 DSH_GITHUB_CONFIG_DIR 设置为存放 gh 配置的目录，或者确认 PATH 上的 gh 属于运行 Harness 的那个用户。

6、改动报 permission 错误 —— token 需要 repo scope，并且你对目标仓库有 admin 权限。

安全与隐私¶

这段值得单独看，因为面板有读写能力。README 的说法如下：

• 面板由你自己的 Harness 进程提供服务，只监听 127.0.0.1。
• 面板从不读取 token，只负责启动 gh；登录凭据在操作系统的 keyring 里，由 gh 自己持有。
• 面板不向磁盘写任何东西，操作日志只存在内存里，Harness 重启后即消失。
• 不提供删除仓库的功能。pinned 仓库和 profile 名称 / bio 走外链，因为 GitHub API 对这两类没有写权限。

适用场景与注意¶

适合下面这些情况：GitHub 账号下仓库数量多到不好凭记忆维护，希望在一个页面里看到「哪些仓库需要补描述、哪些已经没用了」；或者希望改 description、topics、归档状态时不用去网站找入口。

几条限制需要提前知道：

1、README 明确写着 “This project is not actively maintained”：issue 不会被分诊，没有响应时间承诺。坏了或者要改，README 建议的做法是指派给你的 AI agent，让它诊断并修补你自己的副本或 fork；上游 PR 可能一直没有人 review。

2、本体是纯 ESM JavaScript，没有构建步骤，index.js 是宿主侧（loopback 路由、启动 gh），client.js 是客户端侧（侧栏图标和面板 UI），另有 cordis.patch.yml 用于插入插件行。

3、平台方面，README 说在 Windows 10/11 上测试过；macOS 和 Linux 走 PATH 上的 gh，未做测试。

4、package.json 里标记了 "private": true，因此不要直接把它当作可发布的 npm 包引用；如果你打算长期使用，建议 clone 仓库后自行维护一份副本，README 也给了开发用的手动挂载配置（在 profile 的 package.json 里加 link: 依赖并放进 bundle 列表）。

5、插件以当前 DSH 进程的权限运行。安装之前，建议先读一遍源码、确认 index.js 和 client.js 的行为与你的仓库权限相符，再决定是否启用写操作（改 description、topics、归档、改名）。许可证是 MIT。

结尾¶

dsh-github-panel 的价值在于把「GitHub 状态核对」和「仓库元数据维护」这两件事收敛到一个面板里，且不引入新的登录态。它不追求功能多，接口和权限边界都写在 README 里，是否采用取决于你对 gh 已有登录的依赖程度。

目录页：https://www.skillhub.cn/plugins/zayyehtut/dsh-github-panel

GitHub：https://github.com/zayyehtut/dsh-github-panel