用途:管理跨平台符号链接,解决 Git 在 Windows 与 macOS/Linux 间签出符号链接时产生文本占位文件或硬链接、导致链接静默失效的问题。
主要能力:环境诊断(系统与 Python 版本、core.symlinks 配置、Windows 开发者模式与管理员权限、仓库中的符号链接/断链/文本占位文件);创建符号链接并按平台自动选择类型;从清单批量恢复链接;审计断链与缺失链接;递归扫描目录批量修复文本占位文件并生成清单报告。
使用方式:先运行 python ./scripts/symlink_manager.py diagnose 查看诊断结果。Windows 需先启用开发者模式,再执行 git config core.symlinks true、git rm --cached -r .、git reset --hard,或直接以管理员身份运行。可用 /create-sym-link 交互命令,或 python ./scripts/symlink_manager.py create --src <源> --dst <目标> 创建,restore 恢复全部,audit 审计。批量修复用 python ./scripts/bulk_symlink_fixer.py <文件夹>。提交 symlinks.json 清单后,新签出时运行 restore 即可按平台重建。
限制:Windows 未启用开发者模式时回退为目录联接(仅限同一卷)或硬链接;硬链接无法作为符号链接提交会破坏工作流。相关参考文档位于 references/troubleshooting.md、.agent/rules/symlink-cross-platform.md 与 references/ADRs/。收费、价格与效果数据暂未提供。