MirrorGithubCN Skill 使用指南

一、简介

MirrorGithubCN 是一款专为解决地区网络访问限制而设计的 OpenCode Skill。它能够自动将 GitHub 相关 URL 替换为 bgithub.xyz镜像地址，确保在网络受限环境下仍能顺利访问 GitHub 资源。

🔧 适用场景: 由于地区网络限制，github.com 无法直接访问时使用。

---

二、功能特性

2.1 核心功能

功能	说明
URL 自动替换	将 github.com 自动替换为 bgithub.xyz
全覆盖支持	支持 GitHub 所有子域名和资源类型
智能识别	自动识别需要替换的 GitHub 相关链接

2.2 支持的资源类型

• ✅ 仓库克隆 (git clone)
• ✅ 文件浏览 (github.com/xxx/xxx/blob/…)
• ✅ 原始文件 (raw.githubusercontent.com)
• ✅ Release 下载 (github.com/xxx/releases/download/…)
• ✅ GitHub Pages (xxx.github.io)
• ✅ API 调用 (api.github.com)

---

三、使用示例

3.1 仓库克隆

用户请求:

帮我 clone 这个仓库: https://github.com/facebook/react

Skill 自动处理:

# 原 URL
https://github.com/facebook/react

# 替换后
https://bgithub.xyz/facebook/react

# 实际执行命令
git clone https://bgithub.xyz/facebook/react

---

3.2 查看文件

用户请求:

获取这个文件的原始内容: https://github.com/nodejs/node/blob/main/README.md

Skill 自动处理:

# 原 URL
https://github.com/nodejs/node/blob/main/README.md

# 替换后
https://bgithub.xyz/nodejs/node/blob/main/README.md

---

3.3 下载 Release

用户请求:

下载 VSCode: https://github.com/microsoft/vscode/releases/download/1.85.0/VSCode-win32-x64.zip

Skill 自动处理:

# 原 URL
https://github.com/microsoft/vscode/releases/download/1.85.0/VSCode-win32-x64.zip

# 替换后
https://bgithub.xyz/microsoft/vscode/releases/download/1.85.0/VSCode-win32-x64.zip

---

四、URL 替换规则

4.1 域名替换表

原域名	替换为	示例
github.com	bgithub.xyz	github.com/user/repo → bgithub.xyz/user/repo
raw.githubusercontent.com	保持不变*	bgithub.xyz会自动代理
api.github.com	保持不变*	bgithub.xyz会自动代理

*注：bgithub.com 会自动代理所有 GitHub 子域名，只需替换主域名即可。

4.2 注意事项

1. 路径完整性 - 替换时确保整个 URL 路径不被破坏
2. Query 参数保留 - URL 中的 ?param=value 会完整保留
3. Fragment 保留 - #anchor 部分会完整保留
4. 大小写敏感 - 仅替换小写的 github.com
5. 防重复替换 - 已包含 bgithub.xyz 的 URL 不会重复替换

---

五、触发条件

以下场景会自动触发此 Skill：

触发条件	示例
用户提供 GitHub 链接	https://github.com/xxx/xxx
用户要求 clone 仓库	帮我 clone 这个仓库
用户要求访问 GitHub 文件	获取这个文件内容
用户要求下载 release	下载这个 release
用户使用 GitHub CLI	gh repo clone xxx

---

六、配置与优化

6.1 全局 Git 配置（可选）

如果希望所有 git 操作都自动使用镜像，可以配置全局 git：

git config --global url."https://bgithub.xyz/".insteadOf "https://github.com/"

配置后，所有 git clone https://github.com/... 会自动变为 git clone https://bgithub.xyz/...

6.2 GitHub CLI 配置（可选）

# 设置 GitHub CLI 使用镜像
gh auth login --hostname bgithub.xyz

---

七、故障排除

7.1 镜像访问失败

如果 bgithub.xyz也无法访问，可以尝试其他镜像：

• ghproxy.com
• gitee.com (同步仓库)

7.2 验证镜像是否生效

# 测试 GitHub 访问
curl -I https://bgithub.xyz

# 应该返回 200 OK 状态码

---

八、技术信息

项目	内容
Skill 名称	MirrorGithubCN
安装路径	~/.opencode/skills/MirrorGithubCN/
依赖	OpenCode 环境
版本	1.0.0

---

九、总结

MirrorGithubCN 让 OpenCode 在网络受限环境下也能自如地访问 GitHub 资源，真正做到「无感切换」—— 用户只需正常提出需求，Skill 自动完成 URL 替换，无需任何额外操作。

---

十、SKILL源码下载地址

我的Gitee仓库，或者直接git：
https://gitee.com/duanwei2019/MirrorGithubCN.git
文档生成时间: 2026-03-22