vb2250158/rabiroute/rabi-github-pull

Rabi GitHub 拉取

概览

在拉取 RabiRoute 更新前后使用这个 skill。RabiRoute 的配置变更常常先落在 版本更新日志.md、examples/data/ 和 adapter 文档里，而本机运行期 data/ 目录不会自动升级；因此一次安全的拉取既包括 Git 同步，也包括本地配置迁移检查。

重要路径

• 版本更新日志.md：迁移说明和行为变化的主要来源。
• examples/data/：公开的当前配置模板。
• data/：本地运行期配置和角色数据，默认是私有数据。
• .env：本机密钥和机器相关设置，绝不能用示例文件覆盖。
• src/adapters/、src/forwarding.ts、src/manager.ts：路由、adapter 和配置模型变更的常见位置。
• docs/：更新日志链接到的更详细迁移说明。

拉取流程

1. 在触碰 Git 历史前检查本地状态。

• 运行 git status -sb。
• 如果 tracked 文件有本地改动，阅读足够 diff，判断它们是用户工作还是生成文件抖动。
• 不要覆盖本地 data/、.env、日志、构建产物或用户改动。

1. 拉取前先 fetch 并审阅上游。

• 运行 git fetch origin。
• 如果存在 upstream，用 git log --oneline --decorate --left-right HEAD...@{u} 查看即将进入的提交。
• 在迁移本地配置前先看即将进入的 版本更新日志.md diff：

git diff HEAD..@{u} -- "\347\211\210\346\234\254\346\233\264\346\226\260\346\227\245\345\277\227.md" examples/data docs README.md

1. 如果存在 data/，先备份本地运行配置。

• 在 tracked 文件外创建带时间戳的备份，例如 .codex-logs/config-backups/<timestamp>/。
• 优先备份 data/gateways.json、data/route/、data/roles/ 和各 adapter 的专用配置目录。
• 最终回复里不要打印密钥、token、Cookie、真实 QQ 号、私聊内容或完整私有运行数据。

1. 保守拉取。

• 优先使用 git pull --ff-only。
• 如果不能 fast-forward，停下来检查；不要为了继续而直接创建 merge commit。
• 如果本地 tracked 改动阻塞拉取，除非用户已经指定策略，否则先询问，不要自行 stash 或 commit。

1. 根据更新日志和示例升级本地配置。

• 将 examples/data/ 下相关文件与本地 data/ 结构对比。
• 当更新日志或代码明确要求某个字段时，把公开安全的默认值补进本地配置。
• 保留本地 ID、密钥、endpoint、enable 状态、人设内容、消息历史和私有路径。
• 对改名字段，保留旧值线索，并且只在目标 schema 清楚时迁移。
• 如果不确定某个本地值是否是用户有意设置，把它列为后续确认项，不要猜。

1. 迁移后验证。

• 配置或示例变化时运行 npm run check:config。
• route、adapter、forwarding、manager 或 WebGUI 行为变化时运行针对性测试或 npm test。
• TypeScript/API 变化时，在可行情况下运行 npm run build:backend。
• 如果迁移期间编辑了 tracked 文件，运行 git diff --check。

1. 汇报结果。

• 总结拉取到的提交，或说明当前已经是最新。
• 列出升级、跳过或需要用户确认的本地配置文件。
• 说明运行过的验证命令和失败项。
• 私有运行细节只做摘要并脱敏。

迁移检查清单

更新日志提到配置、route kind、adapter、角色式、RibiWebGUI 或 manager 变化时，检查这些区域：

• Gateway 条目：adapter 类型、显示名、启用状态、进程命令、环境变量。
• Route 配置：route kind、匹配规则、模板变量、目标处理端、输出策略。
• Adapter 配置：NapCat、WeCom、webhook、voice 或 plugin-adapter 字段。
• Persona 配置：personaConfig.json、消息模板规则、growth、skills、plans、memory。
• WebGUI/manager 配置：新 API 字段、默认端口、进程监管、日志路径。
• 示例数据策略：新增公开示例不能被原样复制到私有运行文件。

判断规则

• 如果没有 data/ 目录，只拉取并验证 examples；说明本机无需运行期迁移。
• 如果上游只是文档变化且不影响配置行为，不要搅动本地运行文件。
• 如果 examples 新增可选字段，除非更新日志说明字段必需，否则优先不改本地配置。
• 如果代码现在要求某个字段且 examples 给出安全默认值，在保留私有值的前提下把默认值补到本地。
• 如果迁移可能发送消息、启动进程或暴露私有数据，先停下来询问。
• 不要把本地运行期 data/、.env、日志、dist 或 node_modules 作为拉取清理的一部分提交。

本地改动与共享盘

拉取前比较本地改动与目标远端提交的文件交集，并逐项检查语义和未跟踪文件。没有交集时保留原地改动；有交集时按用户授权保存相关补丁，不因工作区不干净整体回退或暂存。字段与目录改名后检查本地脚本及忽略规则，保留原有签名、凭据与配置。

共享盘不支持依赖链接时，先按项目构建要求使用本机磁盘。确需在共享盘安装且包管理器支持时，可评估 --install-links；它会改变依赖与锁文件语义，先保存锁文件并核对差异，只恢复本次安装造成的部分，不能覆盖用户已有改动。

源码提交、构建产物与已安装版本分别核验。通过当前 Host 获取运行身份和安装信息，不根据源码版本断言运行实例已经升级。