用途:当需要安全地重命名符号、提取模块、拆分函数或服务、移动文件或重组代码时使用。
主要能力:gitnexus_rename 支持跨多文件的自动化重命名,带 dry_run 预览,区分图编辑(高置信度)与 ast_search 编辑(需人工审查)。gitnexus_impact 沿 upstream 方向列出所有依赖方及受影响流程。gitnexus_context 查看目标的所有入向与出向引用。gitnexus_detect_changes 在改动后核对变更文件、符号与受影响流程及风险等级。gitnexus_query 查找涉及目标的执行流。gitnexus_cypher 支持自定义引用查询。
使用方式:工作流为先 gitnexus_impact 梳理依赖,再 gitnexus_query 找执行流,然后 gitnexus_context 看引用,按接口→实现→调用方→测试的顺序规划更新。重命名时先 gitnexus_rename 并设 dry_run 为 true 预览,审查后设 false 应用,再用 gitnexus_detect_changes 验证,最后运行受影响流程的测试。若提示索引过期,在终端运行 npx gitnexus analyze。
适用场景:重命名函数、提取模块、拆分函数或服务、移动代码位置。
限制与风险:调用方多时可借助自动化更新;跨区域引用需用 detect_changes 核对范围;字符串或动态引用需用 gitnexus_query 查找;对外公开 API 应妥善做版本与弃用处理。ast_search 类编辑必须人工复核。其余细节暂未提供。