SuperAPI AI 工具集

unity-cli-snippets-audit

编程与开发

查看项目

更新于 10-16 02:31

技能介绍

用途:对项目片段库 .unity-cli/snippets~/ 做防腐化维护,检测四类腐化——API 漂移(Unity 升级导致片段失效)、完整性漂移(文件与审计条目因合并或手改而不一致)、陈旧(长期未复用)、僵尸弃用(已弃用但未删除)。

主要能力:诊断与重新验证。cs 是 python "$HOME/.unity-cli-plugin/current/cli/cs.py" 的简写,路径固定,原样运行、不切换目录;未安装时先运行一次 unity-cli-setup 技能。

使用方式:离线诊断(始终安全):python "$HOME/.unity-cli-plugin/current/cli/cs.py" snippets doctor --json --project "$(pwd)"。重新验证(需 Unity 运行,用于捕获 API 漂移):python "$HOME/.unity-cli-plugin/current/cli/cs.py" snippets doctor --revalidate --json --project "$(pwd)",对每个只读片段重跑验证门并刷新 verified_at,建议每次 Unity 版本升级后执行。doctor 不触碰使用统计。

按发现项分类处理:revalidation_failed 用 cs snippets show <id> 诊断,修复后 cs snippets update <id> --file <md>,无法修复则 deprecate --reason "API drift <unity-version>";broken(≥7 天内 ≥5 次运行失败)同上;corrupt/id_mismatch 用 show 查看后经 update --file 修复,无望则弃用;orphan_file 有价值则 cs snippets add <id> --file .unity-cli/snippets~/<id>.md,否则删除文件;missing_file 从 git 历史恢复或手动从 snippets-audit.json 移除条目;unverified 人工复核一次;cold(90 天未用且成功 <3 次)询问用户后 cs snippets prune --cold;removable(弃用超 30 天)询问用户后 cs snippets prune --remove。

限制与禁止:prune --remove 与 prune --cold 是唯一破坏性路径,必须用户确认;不得把 revalidation_failed 当作使用失败;不得手改片段正文,修复须走 update --file 以触发验证门;不得自行弃用冷片段。主动触发:unity-cli-setup 带 --update 或 Unity 版本变化后执行重新验证;同一会话两个不同片段失败时先跑诊断。