前言¶
在 DSH(DeepSeek Harness)里做智能体或插件开发时,经常要在侧边栏之外切到浏览器:查某个 owner/repo、复制 git clone、或下载默认分支 zip。若本机访问 github.com 不稳定,还要自己改链接前缀、记几套镜像规则,流程容易断在「找仓库」这一步。
下面介绍社区插件 dsh-github-mirror(维护者 Jianmo-R):它在 DSH Web 客户端侧边栏增加 GitHub 入口,列出仓库并在可配置的镜像上打开页面,同时为 clone 与 zip 提供单独的加速路由。插件归类为联网工具;当前 GitHub 仓库约 1 star,许可证 MIT(package.json 版本 1.0.0)。社区目录页见 SkillHub 插件条目,与 DeepSeek / 幻方无官方从属关系,安装前请自行阅读源码与许可证。
这是什么¶
dsh-github-mirror 是面向 DSH Web GUI 的 GitHub 仓库启动面板:侧边栏出现 GitHub 图标后,可浏览指定用户的仓库列表,把仓库链接重写到所选镜像(默认浏览镜像 bgithub.xyz),并把 git clone、zip 下载走另一套加速前缀(默认 ghfast.top)。它不替代完整 GitHub 客户端,也不在本机代理 git 流量或缓存仓库内容。
运行要求(来自 README):
- 带客户端插件能力的 DSH 构建(文档写明在
0.2.1-rc.2上测试过)。 - 能访问
api.github.com;未登录时若 API 被挡,面板会尝试通过gh-proxy.com作为未认证请求的 API 回退。 - 无构建步骤,浏览器侧为现成的
client.jsbundle。
核心功能¶
侧边栏与仓库列表¶
点击侧边栏 GitHub 图标打开面板。插件通过 GitHub REST API 读取最多 100 个最近更新的仓库(暂无分页),展示描述、语言、星标、更新时间,以及 private / fork / archived 等标记。
镜像浏览与健康检查¶
Browse via 选择器决定仓库页、个人主页等链接的前缀,内置包括 bgithub.xyz、gitclone.com、官方 GitHub,也可在设置里填自定义镜像前缀。打开面板时会对当前浏览镜像做一次探测;若不可达,链接会临时回退到官方 GitHub,并在界面提示。
加速 clone 与下载¶
Clone / download 与浏览路由分开配置。默认 clone/下载走 ghfast.top,也可选 gh-proxy.com、gitclone.com 或官方直连。每一行仓库提供:复制 clone 命令、下载默认分支 zip、在所选镜像中打开。
快速打开与可选私有仓库¶
搜索框支持粘贴 owner/repo、https://github.com/owner/repo、git@github.com:owner/repo.git 或镜像 URL,回车即可跳转。
公开仓库无需登录。若需私有仓或组织协作仓,在齿轮菜单填入具备 repo 只读权限的 Personal Access Token,可调用 /user/repos,并将 API 限额从每小时 60 次提升到 5,000 次。Token 默认仅存于 sessionStorage;勾选 Remember the token 才会写入 localStorage。
离线缓存¶
最近一次成功的列表会缓存 6 小时;刷新失败时仍可看到上次数据。
路由一览¶
| 路由 | 用途 | 说明 |
|---|---|---|
bgithub.xyz |
浏览 | GitHub 风格网页镜像,可用性因时而异 |
gitclone.com |
浏览 / Git | 网页镜像与 clone 加速 |
ghfast.top |
Clone / 下载 | 代理 github.com 与 raw.githubusercontent.com |
gh-proxy.com |
Clone / 下载 / API | 亦作未认证 API 回退 |
| 官方 GitHub | 回退 | 直连 |
镜像均为第三方服务,可能变更或下线;运行时均可切换,设置对话框也接受自定义前缀,无需改代码。
安装与启用¶
插件以当前 DSH 配置与进程权限运行,安装前请核对 GitHub 仓库 源码与 MIT 许可证。
从 DSH 插件页安装¶
- 打开 Settings → Plugins。
- 选择 Add plugin → Install a third-party plugin。
- 填入 Git 地址:
https://github.com/Jianmo-R/dsh-github-mirror
- 启用 bundle;若宿主提示重启,则重启 DSH。
插件安装到当前活跃的 DSH profile,不需要发布到 npm。
从 CLI 安装¶
若安装包提供 dsh 命令行:
dsh plugin add https://github.com/Jianmo-R/dsh-github-mirror
手动 link 安装¶
将仓库放在稳定路径后,在 profile 的 package.json 中以 link: 依赖加入,并把 dsh-github-mirror 列入 dsh.profile.bundles,在 profile 目录执行 pnpm install 后重启 DSH。插件自带的 cordis.patch.yml 会插入 github-mirror Loader 项。
典型用法¶
- 在 DSH 侧边栏点击 GitHub 图标。
- 首次使用输入 GitHub 用户名(仅用户名,不要填邮箱或完整 URL)。
- 公开仓可直接浏览;私有仓在齿轮菜单配置 Token(
repo只读)。 - 在面板顶部设置 Browse via 与 Clone / download 两路路由。
- 对单行仓库使用复制 clone、下载 zip、在镜像中打开。
用户名、路由选择与列表缓存保存在浏览器 localStorage;Token 仅发往 https://api.github.com,不会转发到 gh-proxy.com 或其他镜像。链接在系统浏览器中打开。
适用场景与注意¶
适合:经常在 DSH 里查 GitHub 仓库、需要一套可切换的浏览镜像与 clone/zip 加速前缀、且能接受「最多 100 个最近更新仓库、无分页」的轻量启动器。
限制(README 原文要点):
- 无 Token 时
/users/:name/repos仅返回该账号拥有的公开仓;组织仓与协作仓需 Token 与/user/repos。 - 镜像页面新鲜度取决于镜像本身,可能落后于 GitHub。
- 缓存可能包含私有仓名称与描述;可通过 Clear local settings 清除。
DSH 生态强调「一切皆插件」;SkillHub 等目录由社区维护,并非官方应用商店。选用第三方镜像时请自行评估可用性与隐私策略。