

Sentinel 是一款用于项目审计、构建验证和资源清理的 Unity 编辑器扩展。它会扫描你的场景和预制件,查找缺失的脚本、损坏的引用以及未使用的资源——然后帮助你修复、清理并持续追踪这些问题。
与简单的缺失脚本查找工具不同,Sentinel 在单一窗口中集成了四款专业工具,覆盖 Unity 项目健康的各个方面——从场景验证到 CI/CD 流水线集成。
🔍 问题查找器(Issues Finder)
一款完整的场景验证器和预制件审计工具,可扫描已打开和未打开的场景(无需打开它们),检测 10 种内置问题类型:缺失脚本、损坏引用、空材质、着色器错误、无效图层、无效标签、空 UnityEvents、未使用组件等等。可针对每种问题类型配置严重程度。一键自动修复,并完整支持撤销(Undo)。
🗑️ 项目清理器(Project Cleaner)
一款由根追踪依赖扫描器驱动的无用文件移除与未使用资源清理工具。它能标记出真正未被引用的资源——不仅是"不在某个场景中",而是无法从任何构建场景、Resources 文件夹、Addressables 组和资源包(asset bundle)中触及。删除操作默认会进入可恢复的回收站(Trash)文件夹,永久删除时还会自动生成备份 ZIP。
🔗 引用查找器(References Finder)
一款全项目依赖追踪工具,可即时回答"这个资源在哪里被使用?"——涵盖场景、预制件和 ScriptableObject,并配备 YAML 级回退搜索以确保完全准确。
📈 趋势与健康评分(Trends & Health Score)
每次扫描都会生成一个 0-100 的健康评分。内置的趋势图表可追踪最多 60 次历史扫描中的错误、警告和总数。锁定一个基线(Baseline),将有意保留的技术债务与新出现的回退问题区分开来——这对团队工作流程和代码审查至关重要。
🚀 支持 CI/CD
可从命令行运行无界面(headless)项目审计。输出既包含机器可读的 JSON 报告,也包含兼容 GitHub Actions、Jenkins 和 GitLab CI 的 JUnit XML 报告。还附带一份开箱即用的 GitHub Actions 工作流。安装 git post-merge 钩子,即可在每次拉取(pull)后自动扫描。
🛡️ 构建验证
启用"出现错误时构建失败"(Fail Build on Errors),即可在存在严重问题时自动阻止玩家版本(player)构建。每次构建前都会运行快速的预构建检查(仅检测缺失脚本 + 损坏引用),在问题到达玩家之前及时发现它们。
🔔 通知
只需粘贴一个 webhook URL,即可将扫描结果发送到 Slack 或 Discord 频道。
🔧 可扩展
通过继承 SentinelExtensionBase 添加你自己的项目专属检测器。借助 TypeCache 自动发现——无需注册。直接在代码中使用 [SentinelIgnore] 特性来抑制误报,或将整个文件夹从依赖扫描器中排除。
📧 支持与咨询
如有任何疑问、错误报告或功能请求,请通过 ragendom@gmail.com 联系我们
我们通常会在 24-48 小时内回复。
零运行时占用。仅限编辑器程序集。不会向你的玩家版本构建中添加任何内容。兼容 Unity 2021.3 LTS 至 Unity 6。无外部依赖。
