Skip to content

refactor(ref-alignment): audit file paths and align utils initialization layout - #586

Open
MFSGA wants to merge 5 commits into
masterfrom
codex/ref-path-alignment-utils-20261104
Open

MFSGA wants to merge 5 commits into
masterfrom
codex/ref-path-alignment-utils-20261104

Conversation

@MFSGA

@MFSGA MFSGA commented Nov 4, 2026 •

Copy link
Copy Markdown
Owner

2026-11-04:创建 PR 时 master 的后续 ref pin 更新

创建本 PR 时,远端 master 已从本地重放基线 7932af9a 再次前进至 772bceaa56c6f2b0d00f1f9d89996b8f6e817caf,其中引入了上游 ref 5ed3c019e13015fc5b06fc8d7069b330607d9036 和 runtime 81e93043c29cb60425077f4419dcbd60d6f2b8c9 pin 及 Core local-host 改动。PR 仍是相对最新 master 的 5 个指定文件,mergeable=true,未改动这些 gitlink。

重要区分: 本 PR 的 316 条文件路径扫描是一份以任务开始时固定 ref 518bf498 为基线的历史审计快照,不得宣称它反映新 5ed3c019 的全部目录分类。已通过 GitHub 在新 5ed3 直接核对 backend/tauri/src/utils/open.rs:blob 81e415e3dc8c451e552a6b65d2612e1d63e4fc24 与本 PR 提交同路径 完全一致;新 ref 的 utils/init/mod.rs 仍使用 #[cfg(test)] mod tests;,因此本批对齐方向在新 pin 下仍有效。新版本将若干业务组件迁入 backend/nyanpasu-core/src,后续必须重新做新 ref 的逐目录/逐文件基线扫描,不能沿用旧版 backend/tauri/src 路径数量判断具体迁移工作量。

最终签名提交和本地全库测试在 7932af9a 父提交上完成;GitHub 对当前 PR merge ref 的新 CI/E2E 是最新 master 的必要补充证据,目前尚未标记通过。未执行独立 Reviewer 批准或合并。

目标与基线

第一批逐目录/逐文件路径对齐(L1,非行为性重排)。以只读 ref gitlink 518bf49843e1f735380e11da1ebe2a85eb8ce8c6 为来源,最初扫描从 master ddad1aac 开始;在提交前远端 master 已因两次版本号更新前进至 7932af9adab9cefe3970394b17427649d581ddf7,确认两个新版本提交不修改本批文件后,重签名重放本 PR 的唯一提交。最终 head 7360549029b714f55b67bc913d35a4138f76a8ee。固定 runtime gitlink 2cb1160996f912b536418cb62bda470d097c1190 不变。独立工作树实现;原主检出与 #585 未修改。

逐文件对齐结果

  • ref/backend/tauri/src/utils/open.rs → backend/tauri/src/utils/open.rs:整个文件已恢复与 ref 逐字节一致。原有 that() / with() 两个接口、AppImage xdg-open/指定程序调用行为完全保留;只是按上游排列函数、恢复注释/属性。现有 ipc.rs、help.rs 调用方保持不变。
  • ref/backend/tauri/src/utils/init/{mod.rs,tests.rs} → 同路径:Chimera 原内嵌 startup_file_tests 的五项旧配置文件保护测试原样移至 init/tests.rs,父模块改为上游式 #[cfg(test)] mod tests;。断言不变、五项测试仍执行,不将其误称为上游迁移子进程测试已对齐。
  • docs/ref-path-alignment-audit-20261104.md:逐路径扫描 backend/tauri/src 的 316 条 Rust 文件路径(239 个 ref、210 个 Chimera、133 个路径共有;6 个内容相同、127 个不同、106 个 ref-only、77 个 Chimera-only),按目录统计,并对 utils/ 逐项判定:对齐、必要品牌/兼容差异、需要完整调用链迁移的目录。其余文件路径标注为“待语义审查”,不是已经验收。
  • docs/ref-alignment-progress.md DIFF-072:固定 ref 映射、修改范围、保留差异、回滚和下一批扫描。

不会盲目复制 core/geo 的旧实例状态(Chimera 有更安全的实例隔离与补偿刷新)、utils/hwid 的不同品牌盐、core/migration 中未经迁移恢复测试的新模块、state/profiles 的类型端口或 utils/net 的代理参数:涉及持久数据与共享 API 时,将另开有界实现批次。

实际验证(最终 head SHA 73605490)

  • macOS cargo test --locked --manifest-path backend/Cargo.toml -p chimera --lib -- --test-threads=2:782 passed / 0 failed / 1 pre-existing ignored。
  • cargo clippy --locked --manifest-path backend/Cargo.toml -p chimera --all-targets --all-features:pass(存在项目既有警告);Rustfmt、Prettier 文档格式、git diff --check 全部 pass。
  • 本地新工作树首次编译因缺少未纳入 Git 的 Tauri sidecar 构建资源而失败;采用仅在隔离工作树中指向主检出已生成资源的忽略路径软链接后,完整测试与 Clippy 通过。未启动生产 App、代理/TUN/Service 或迁移用户数据。
  • 远程 PR CI/Windows E2E:新提交待 GitHub Actions 执行;本地测试不能代替远程平台结果。

风险、审查与回滚

这批改动仅包含 Rust 函数排列和测试模块移动,不改生产调用链、配置 schema、协议、构建依赖、Core/Service、Agent、Main/Legacy、release/workflow。范围内风险 L1,独立 Reviewer 尚未完成;本 PR 不自动合并。发现问题时回退该单个签名提交即可,恢复原测试模块与原函数排列,无需数据/子模块恢复。

下一批推荐按 core/migration/ 的 registry → runner → modules → fs/store/recovery,再 client/application_workflow/ 逐文件做真实结构对齐;任何大范围持久化格式迁移另行审批和验证。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant