📥

GenHub 安装引导

5 步轻松装上 GenHub 桌面端 · Windows 10 / 11 全适配 · 遇到问题看故障排查

当前版本 v0.2.0 · 仅 16 MB（精简版，无内嵌 WebView2） · Windows 10 / 11 x64
1

下载安装包 Download

直接下载完整安装版，绝大多数电脑都能一键装好。

推荐

📦 完整安装版 — 16 MB

NSIS 安装包 · GenHub_0.2.0_x64-setup.exe
  • 装到 C:\Program Files\GenHub\，自动注册快捷方式、卸载入口
  • 右键桌面图标即可启动，状态栏图标常驻
  • 适合绝大多数用户（个人电脑 / 公司电脑）
  • 需要一次「SmartScreen 解锁」（见 Step 3）
⬇ 下载完整安装版 看安装步骤
2

下载到本地 Download

浏览器会下载到「下载」目录。如果下载被拦截，复制下面的链接到迅雷/IDM。

✓ 支持 断点续传 ✓ SHA256 校验 ⚠ 首次需 SmartScreen 解锁

完整安装版

https://agent.eake.cn/wp-content/downloads/GenHub_0.2.0_x64-setup.exe
# 校验 SHA256（在 cmd 切到下载目录后运行） certutil -hashfile GenHub_0.2.0_x64-setup.exe SHA256
✅
SHA256 已公布在 FAQ。如果担心下载被劫持，校验后对比即可。
3

安装 Install — 关键步骤

Windows 11 / 10 对未签名安装器有 SmartScreen 拦截，解锁一次即可长期使用。

3.1 双击下载的 setup.exe

在「下载」文件夹找到 GenHub_0.2.0_x64-setup.exe，双击运行。

3.2 弹出蓝色 SmartScreen 窗口（关键！）

这是 Windows 11 24H2+ 的标准行为，因为我们的安装器还没买 EV 数字签名证书（未来会买）。

看到「Windows 已保护你的电脑」不要直接关，跟着下面点：

🛡
Microsoft Defender SmartScreen
Windows 已保护你的电脑
Microsoft Defender SmartScreen 已阻止启动一个未识别的应用。此应用存在风险，或者我们无法验证发布者。
📄 应用: GenHub_0.2.0_x64-setup.exe
📍 发布者: 未知发布者
不运行
更多信息 ⬇

↑ 这是示意图 ↑

  1. 点 「更多信息」（在窗口底部一行小字）
  2. 窗口展开后会出现 「仍要运行」 按钮
  3. 点 「仍要运行」
  4. 出现 NSIS 安装向导，一路「下一步」即可
💡
提示：如果窗口是橙色的「是否允许此应用对你的设备进行更改」UAC 弹窗 → 直接点「是」（这是 Windows 正常的权限请求，不是 SmartScreen）。

Win10 安装流程

  1. 右键 setup.exe → 「以管理员身份运行」
  2. 如果出现「无法识别的应用」提示 → 勾选「不显示此消息」前的勾 → 点「仍要运行」
  3. UAC 弹窗点「是」
  4. NSIS 安装向导一路「下一步」
⚠️
Win10 较老版本（如 1809 之前）可能缺 WebView2 → 装完 GenHub 后会弹窗提示「缺少组件」→ 去微软官网下 WebView2 Evergreen 装上即可。
4

启动 & 验证 Verify

装好后双击桌面图标启动，看到主界面就算成功。

  • 桌面有 「GenHub」 图标（完整安装版）
  • 双击启动 → 主窗口出现，标题「GenHub」
  • 第一次启动会做 4 步引导（欢迎 → 环境检测 → 权限说明 → 进入主程序）
  • 主程序左侧边栏有「对话」「任务链」「设置」等模块
🎉
到这一步就算装好了。后续配置 API Key、添加 Provider 等操作看主程序内引导。
5

故障排查 Troubleshooting

装不上、启动不了、闪退、卡住？点这里看常见问题。

❓ 双击 setup.exe 直接闪退 / 一点反应都没有
原因：Windows SmartScreen 在第一道关卡就拦截了，连蓝色窗口都没弹出来。
解决：
  1. 右键 setup.exe → 「属性」 → 最下方「安全」一栏勾上 「解除锁定」 → 确定
  2. 再右键 setup.exe → 「以管理员身份运行」
  3. 如果还闪退，看 Win+R → eventvwr.msc → 「Windows 日志 → 应用程序」找最近一条 Application Error 红色错误 → 把详细信息发给客服
❓ 弹「无法识别的应用」/ 弹 SmartScreen 后只能「不运行」
回到 Step 3.2，按「更多信息 → 仍要运行」操作。
如果找不到「更多信息」按钮：说明你被装在 Win10 早期版本了 → 用右键「以管理员身份运行」试试。
❓ 启动 app.exe 提示「缺少 WebView2 Runtime」
GenHub 依赖微软 WebView2 组件，Win11 自带、Win10 大部分自带。
如果缺：去 微软官网下载「Evergreen Standalone Installer」（约 100MB）→ 双击装好 → 重启 GenHub。
❓ 装到一半失败 / 提示「另一程序正在使用」
  1. 检查 GenHub 是否还开着（任务栏右键关闭）
  2. 如果之前装过 GenHub 残留 → 「设置 → 应用」搜 GenHub → 卸载
  3. 手动清残留（隐藏文件要先在文件管理器勾「显示 → 隐藏的项目」）：
    C:\Program Files\GenHub\
    %APPDATA%\GenHub\（Win+R → 输入 %APPDATA% 回车）
  4. 重启电脑 → 再装一次
❓ 装好了但启动后白屏 / 一直转圈 / 几十秒没反应
原因：WebView2 首次初始化会下载/解压一些资源（约 5-30 秒），看机器性能。
解决：
  1. 等 30 秒，第一次启动慢是正常的
  2. 如果超过 1 分钟还是白屏 → 关掉 GenHub → 右键 app.exe 选「以管理员身份运行」
  3. 还是不行 → 联系客服排查
❓ 杀软（360 / 火绒 / Defender）报毒 / 拦截
这是误报。我们的安装器和 app.exe 都不含任何恶意代码（NSIS 是开源工具，GenHub 全部代码公开）。
解决：
  1. Defender：「病毒防护 → 病毒和威胁防护设置 → 排除项 → 添加排除项 → 文件夹」选安装目录
  2. 360 / 火绒：信任区 → 添加 C:\Program Files\GenHub\ 和 setup.exe
  3. 如果实在担心 → 装前先用 VirusTotal 上传扫描，看 70+ 引擎报告
❓ 公司电脑没管理员权限装不上
完整安装版默认装到 C:\Program Files\GenHub\，需要管理员权限。
如果当前账号没权限 → 联系公司 IT，用管理员账号帮你安装；或要求 IT 加白 C:\Program Files\GenHub\app.exe。
❓ 升级新版装不上（之前装过老版本）
  1. 用 GenHub 内置「设置 → 关于 → 检查更新」功能（最稳）
  2. 或者：卸载老版（设置 → 应用）→ 重启 → 装新版
❓ 装完找不到桌面图标 / 找不到 GenHub
  1. 开始菜单搜「GenHub」
  2. 或直接到 C:\Program Files\GenHub\app.exe 双击
❓ SHA256 校验值
完整安装版 0.2.0：
fd5df498c846f398ea509a73c87afc073939f2d14a4648fa4110879d285ab8ac

校验方法：cmd 切到下载目录 → 运行 certutil -hashfile <文件名> SHA256 → 对比输出。
⚠️
本安装包为 16 MB 精简版（已修复之前 217 MB 包双击闪退的问题）。不嵌入 WebView2 Runtime，要求你的 Windows 已安装 WebView2：Win11 默认自带、Win10 1809+ 自带；Win10 更早版本需手动去微软官网下 WebView2 Evergreen 装一次（约 100MB），永久使用。