BetterGenshinImpact 脚本库管理：2 种更新方式与订阅同步操作指南
【免费下载链接】better-genshin-impact📦BetterGI · 更好的原神 - 自动拾取 | 自动剧情 | 全自动钓鱼(AI) | 全自动七圣召唤 | 自动伐木 | 自动刷本 | 自动采集/挖矿/锄地 | 一条龙 | 全连音游 | 自动烹饪 | 桌面分身 - UI Automation Testing Tools For Genshin Impact项目地址: https://gitcode.com/gh_mirrors/be/better-genshin-impact
你在用 BetterGenshinImpact 做原神自动化时，需要安装新的社区脚本或让旧脚本保持新版，这正是脚本库管理要解决的问题。它负责同步脚本仓库、浏览并订阅脚本，支持 Git 更新与离线导入两种方式。下文给出完整流程、配置项与排错方法。
脚本库管理功能速览
| 能力 | 说明 | 典型场景 |
|---|---|---|
| Git 渠道更新 | 从 CNB / GitHub / 自定义仓库同步最新脚本内容到本地 | 定期获取新脚本，核对更新红点 |
| 手动 zip 导入 | 用本地压缩包文件搭建仓库，全程离线 | Git 通道受限、网络不稳定 |
| 仓库浏览与订阅 | 内置页面查看脚本列表，点击『订阅』保存脚本路径 | 安装新的自动化脚本 |
| 订阅更新 | 把已订阅脚本整体重新检出到用户目录 | 脚本发布新版本后同步 |
| 启动自动更新 | 程序启动时同步仓库并刷新全部订阅脚本 | 定时任务、一条龙场景 |
| 重置仓库 | 删除本地仓库副本并重新克隆 | 仓库目录损坏、更新反复失败 |
上手流程：四步完成脚本库管理与订阅更新
从任务设置页打开脚本仓库窗口
- 在『任务设置』页点击『脚本仓库』按钮，弹出『脚本仓库』对话框。
- 键盘鼠标记录、JS 脚本、地图路线、脚本控制等页面都有相同入口。
- 对话框上方有『Git 更新』与『手动导入』两个标签页，底部是『打开仓库』与订阅更新按钮。
按网络环境选择更新渠道
- 『Git 一键更新』标签页中，在『更新渠道』下拉框选择 CNB、GitHub 或自定义。
- 选择自定义后『仓库地址』可编辑，并可填写 Git 用户名与访问令牌（token，凭据，自动存入 Windows 凭据管理器）。
- 切到『手动导入』标签页选择本地 zip 导入，适合完全离线的环境。
- 渠道选择会写入配置，下次打开窗口自动恢复。
执行仓库更新并订阅脚本
- 点击『更新仓库』同步最新内容，对话框底部进度条显示检出进度。
- 更新成功后点击『打开仓库』浏览本地脚本，点击『订阅』保存脚本路径。
- 点击『一键更新订阅』把已订阅脚本批量检出到用户目录；JS 脚本会在更新前后备份并还原你改动过的文件。
- 订阅脚本按 js、combat、pathing、tcg 四类目录归位。
用提示消息确认更新结果
- 弹出『脚本仓库更新成功，有新内容』或『脚本仓库已是最新』，说明仓库同步完成。
- 订阅更新结束后，提示会给出成功与失败的脚本数量。
- 仓库超过 30 天未更新时，打开仓库会弹出『仓库更新提示』，同步后需重新订阅脚本才能拿到新版本。
- 更新成功后，『脚本仓库』入口上的红点会消失。
配置说明：自动更新与渠道记忆
| 配置项 | 作用 | 建议值 |
|---|---|---|
| AutoUpdateSubscribedScripts | 启动时自动同步仓库并更新全部订阅脚本 | 使用一条龙 / 定时任务时开启 |
| AutoUpdateBeforeCommandLineRun | 命令行启动时先等待脚本更新完成再执行 | 仅在命令行启动场景开启 |
| SelectedChannelName | 记录所选更新渠道，决定使用的仓库地址 | 保留当前网络可达的渠道 |
| CustomRepoUrl | 自定义仓库地址，渠道为『自定义』时生效 | 填自己的脚本仓库 Git 地址 |
| SubscribedScriptPaths | 已订阅脚本路径列表，由程序自动维护 | 无需手工修改 |
两个自动更新开关位于通用设置页，见 CommonSettingsPage.xaml；完整配置项定义见 ScriptConfig.cs。
排错速查：脚本仓库更新失败如何处理
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 点击『更新仓库』后提示更新失败 | 渠道不可达、代理或网络异常 | 更换其他渠道重试；仍失败则走『手动导入』导入本地 zip |
| 提示『不是有效的Git仓库，将重新克隆』 | 本地仓库目录损坏 | 等待自动重新克隆，或点击『重置仓库』清理后重新更新 |
| 提示『仓库文件夹不存在，请先更新仓库』 | 仓库从未成功更新过 | 先通过 Git 渠道完成一次更新 |
| 打开仓库时弹出『已经 X 天未更新』提示 | 仓库超过 30 天未同步，订阅脚本偏旧 | 选择『立即更新』同步仓库，再重新订阅脚本 |
| 任务启动时提示『等待订阅脚本更新超时』 | 自动更新超过 10 分钟未完成 | 检查网络与渠道，待更新完成后重跑任务 |
定期核对仓库更新状态，只从可信来源订阅脚本；访问令牌会存入 Windows 凭据管理器，共享电脑上使用需留意。下一步：完成一次订阅流程后，在通用设置页开启『启动时自动更新已订阅的脚本』开关，再运行下一次定时任务验证效果。
【免费下载链接】better-genshin-impact📦BetterGI · 更好的原神 - 自动拾取 | 自动剧情 | 全自动钓鱼(AI) | 全自动七圣召唤 | 自动伐木 | 自动刷本 | 自动采集/挖矿/锄地 | 一条龙 | 全连音游 | 自动烹饪 | 桌面分身 - UI Automation Testing Tools For Genshin Impact项目地址: https://gitcode.com/gh_mirrors/be/better-genshin-impact
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
