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`、日志、构建产物或用户改动。 2. 拉取前先 fetch 并审阅上游。 - 运行 `git fetch origin`。 - 如果存在 upstream，用 `git log --oneline --decorate --left-right HEAD...@{u}` 查看即将进入的提交。 - 在迁移本地配置前先看即将进入的 `版本更新日志.md` diff： ```bash 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 ``` 3. 如果存在 `data/`，先备份本地运行配置。 - 在 tracked 文件外创建带时间戳的备份，例如 `.codex-logs/config-backups/<timestamp>/`。 - 优先备份 `data/gateways.json`、`data/route/`、`data/roles/` 和各 adapter 的专用配置目录。 - 最终回复里不要打印密钥、token、Cookie、真实 QQ 号、私聊内容或完整私有运行数据。 4. 保守拉取。 - 优先使用 `git pull --ff-only`。 - 如果不能 fast-forward，停下来检查；不要为了继续而直接创建 merge commit。 - 如果本地 tracked 改动阻塞拉取，除非用户已经指定策略，否则先询问，不要自行 stash 或 commit。 5. 根据更新日志和示例升级本地配置。 - 将 `examples/data/` 下相关文件与本地 `data/` 结构对比。 - 当更新日志或代码明确要求某个字段时，把公开安全的默认值补进本地配置。 - 保留本地 ID、密钥、endpoint、enable 状态、人设内容、消息历史和私有路径。 - 对改名字段，保留旧值线索，并且只在目标 schema 清楚时迁移。 - 如果不确定某个本地值是否是用户有意设置，把它列为后续确认项，不要猜。 6. 迁移后验证。 - 配置或示例变化时运行 `npm run check:config`。 - route、adapter、forwarding、manager 或 WebGUI 行为变化时运行针对性测试或 `npm test`。 - TypeScript/API 变化时，在可行情况下运行 `npm run build:backend`。 - 如果迁移期间编辑了 tracked 文件，运行 `git diff --check`。 7. 汇报结果。 - 总结拉取到的提交，或说明当前已经是最新。 - 列出升级、跳过或需要用户确认的本地配置文件。 - 说明运行过的验证命令和失败项。 - 私有运行细节只做摘要并脱敏。 ## 迁移检查清单 更新日志提到配置、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 获取运行身份和安装信息，不根据源码版本断言运行实例已经升级。