🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

GitHub 直连修复 iTrimut/GitHub-Road

DeepSeek Harness
iTrimut63 天前有提交已提供中文文档扫描:含敏感能力

自动择优 IP 写入 hosts,让大陆稳定访问 GitHub

29.1/100
综合分
1
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/9/18 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警:未发布到 npm registry,仅可从源码安装。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add iTrimut/GitHub-Road
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
dsh 原生插件 · market
装得上吗
本站已真实安装成功
非静态推断
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 63 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查⚠ 装前注意

未发布到 npm registry,仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包github-road(未发布到 npm,仅可源码安装)
✓Node 引擎要求 >=18.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/9/23 05:50:54

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

读写/删除本地文件
查看扫描证据(共 6 处,展示前 6 条)
  • 写入本地文件
    index.js:13
    mkdirSync(dst, { recursive: true });
  • 读取本地文件
    index.js:14
    for (const entry of readdirSync(src)) {
  • 读取本地文件
    index.js:17
    if (statSync(from).isDirectory()) copyTree(from, to);
  • 写入本地文件
    index.js:18
    else copyFileSync(from, to);
  • 读取本地文件
    index.js:28
    if (!existsSync(join(source, 'SKILL.md'))) return;
  • 读取本地文件
    index.js:29
    if (existsSync(join(target, 'SKILL.md'))) return;
扫描于 2026/11/2(1 天前) · 范围 入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

功能亮点

  • 大陆稳定访问GitHub
  • 30分钟自动自愈

GitHub-Road:大陆稳定访问 GitHub 官网的网络路径修复技能(hosts 直连 + 动态 IP 择优 + 30 分钟自动自愈,免代理、零费用)——不绑定特定智能体,任意智能体都能用,也可纯手动运行。

README

由 DeepSeek 最新模型翻译生成
🛣️ GitHub-Road 让普通用户在中国大陆稳定访问 GitHub 官网:hosts 直连 + 动态 IP 择优 + 计划任务自动自愈,免代理、零费用。 License: MIT GitHub 它是做什么的 / What it does 浏览器打不开 github.com(转圈/超时/连接被重置)?运营商对 GitHub 按 IP 做 TLS/SNI 层封锁,且封锁的 IP 集合会随时间轮换——所以"写死一个 IP 到 hosts"注定过段时间失效。本方案: 1. 双重验证选 IP:候选 IP 先过 TLS 握手(8 秒硬超时 + TLS 1.2 + 证书域名校验),再发真实 HTTPS 请求,必须返回 HTTP 200 才算可用(避免选到握手正常但返回 400/404 的错误前端)。 2. 写入 hosts 并刷新 DNS:自动备份、原子写入、保留 Tailscale/公司 VPN 等其它条目。 3. 计划任务自愈:每 30 分钟自动重跑,当前 IP 被封锁后最多 30 分钟自动切换。 4. 全挂回退 DNS:所有候选都不可用时临时注释 hosts 条目,不钉死坏 IP。 方案经两轮独立第三方审查修正,全部步骤在真实环境(Windows 11 中文版、国内网络)验证。
展开完整文档(README 剩余 1 节)
🛣️ GitHub-Road

让普通用户在中国大陆稳定访问 GitHub 官网:hosts 直连 + 动态 IP 择优 + 计划任务自动自愈,免代理、零费用。

License: MIT
GitHub

它是做什么的 / What it does

浏览器打不开 github.com(转圈/超时/连接被重置)?运营商对 GitHub 按 IP 做 TLS/SNI 层封锁,且封锁的 IP 集合会随时间轮换——所以"写死一个 IP 到 hosts"注定过段时间失效。本方案:

1. 双重验证选 IP:候选 IP 先过 TLS 握手(8 秒硬超时 + TLS 1.2 + 证书域名校验),再发真实 HTTPS 请求,必须返回 HTTP 200 才算可用(避免选到握手正常但返回 400/404 的错误前端)。
2. 写入 hosts 并刷新 DNS:自动备份、原子写入、保留 Tailscale/公司 VPN 等其它条目。
3. 计划任务自愈:每 30 分钟自动重跑,当前 IP 被封锁后最多 30 分钟自动切换。
4. 全挂回退 DNS:所有候选都不可用时临时注释 hosts 条目,不钉死坏 IP。

方案经两轮独立第三方审查修正,全部步骤在真实环境(Windows 11 中文版、国内网络)验证。

仓库结构 / Structure

GitHub-Road/
├── skills/GitHub-Road/ # Agent Skill(标准格式):SKILL.md + files/(PowerShell 脚本) ├── install.sh # 多智能体一键安装脚本 ├── package.json # DeepSeek Harness 插件包元数据(npm) ├── index.js # 插件入口(skills-only,无运行时代码) ├── cordis.patch.yml # 插件注册补丁 ├── README.md └── LICENSE

安装 / Install

方式一:DeepSeek Harness (DSH) 插件安装

dsh plugin --profile web add github:iTrimut/GitHub-Road

重启 dsh web,确认技能已生成:

ls "%USERPROFILE%\.dsh\skills\GitHub-Road\SKILL.md"

之后让 dsh 代理执行技能即可。

方式二:任意智能体一键安装

git clone https://github.com/iTrimut/GitHub-Road.git
cd GitHub-Road
bash install.sh # 自动检测当前智能体并安装 bash install.sh --user # 用户级安装(所有项目可用) bash install.sh --agent claude # 或指定智能体

或手动把 skills/GitHub-Road/ 复制到所用智能体的 skills 目录:

| 智能体 | 安装路径 |
| Claude Code | .claude/skills/GitHub-Road/ |
| DeepSeek Harness (DSH) | ~/.dsh/skills/GitHub-Road/ |
| Cursor | .cursor/skills/GitHub-Road/ |
| Windsurf | .windsurf/skills/GitHub-Road/ |
| GitHub Copilot | .github/skills/GitHub-Road/ |
| OpenCode / Codex | .opencode/skills/GitHub-Road/ / .codex/skills/GitHub-Road/ |

方式三:纯手动运行(不依赖任何智能体)

1. 从本仓库 skills/GitHub-Road/files/ 下载 fix-github.ps1、install-github-fix.ps1、fix-github-quiet.vbs 到同一个文件夹(路径不要含空格,如 D:\GitHubRoad\)。
2. 双击 install-github-fix.ps1 → UAC 弹窗点「是」。
3. 黑色窗口自动完成:立即修复 + 注册每 30 分钟的计划任务(隐藏窗口,允许电池、错过补跑)。
4. 重启浏览器(或 Ctrl+F5)访问 https://github.com。

卸载 / Uninstall

双击 uninstall-github-fix.ps1(删除计划任务,保留当前 hosts 条目)。

验证 / Verify

curl.exe -s -o NUL -w "%{http_code}" https://github.com # 期望 200 schtasks /query /tn DSH-GitHubFix # 期望 Ready,Next Run 在未来

已知限制 / Limitations(如实说明)

- gist.github.com:SNI 被运营商层阻断,所有 IP 都连不上,hosts 无法修复,需要代理。
- codeload.github.com(下载源码压缩包)、ssh github.com:22(Git 推送)、GitHub Desktop 安装包:不在本方案覆盖范围。Git 推送被墙请用 SSH over 443(见 dsh-GitRoad)。
- 候选 IP 列表是手工维护的;GitHub 的 Azure 段偶尔变化,全部失效时脚本自动回退 DNS 并提示。可更新脚本中 $githubCandidates(用 nslookup github.com + 逐 IP 实测 HTTP 200)。
- 与 hosts 管理类工具互斥:若机器装有 Watt Toolkit / Steam++(本地代理加速把 github 指到 127.0.0.1 并持续重写 hosts),会与本方案互相覆盖。需先停用其加速或退出(一键处理:files/quit-watt-and-fix.ps1),详见 SKILL.md 排查表 #16。
- 若运营商升级为"对 github.com 全量封锁",本方案会如实报告失败并建议代理——不承诺万无一失。

安全说明 / Security

- 脚本以管理员权限运行并每 30 分钟自动执行:不要修改脚本内容(被篡改 = 定时执行任意管理员命令);只从本仓库获取脚本。
- 建议把脚本所在文件夹设为仅管理员可写: icacls "D:\GitHubRoad" /inheritance:r /grant:r "Administrators:(OI)(CI)F" "Users:(OI)(CI)RX"
- hosts 每次修改前自动备份到 %USERPROFILE%\hosts.backup-*(保留最近 20 份)。
- 所有脚本 UTF-8 带 BOM、纯 ASCII 引号(Windows PowerShell 5.1 直接可跑)。

免责声明 / Disclaimer

本工具仅用于个人学习与开发环境的网络配置(等价于常见的 hosts 加速工具)。请在遵守当地法律法规的前提下使用;不建议用于公司/受管设备,大规模分发可能面临法律风险。本项目与 GitHub 官方无关。

文档 / Docs

完整操作手册、排查表与审查记录见 skills/GitHub-Road/SKILL.md(安装技能后随技能加载)。
预览分享卡片长什么样 ↓iTrimut/GitHub-Road
分享 · DeepSeek Harness Hub
iTrimut/GitHub-Road

自动择优 IP 写入 hosts,让大陆稳定访问 GitHub

这是你的仓库?认领条目

回到顶部