首页
工具
实用工具
screenshot
1/10
thumbnail
thumbnail
thumbnail
thumbnail
thumbnail
thumbnail
thumbnail
thumbnail
thumbnail
thumbnail
扫描场景、捕获损坏的引用、删除未使用的资源、长期追踪项目健康状况,并拦截有问题的构建——内置 CI/CD 流水线支持,全方位掌控。
渲染管线兼容性
内置渲染管线是团结引擎/Unity的默认渲染管线,它是一种通用型渲染管线,但可定制化的选项较为有限。通用渲染管线(简称 URP)是一种可编程渲染管线,能够快速、轻松地进行定制,并可在广泛的平台上实现优化的图形效果。高清渲染管线(简称 HDRP)同样是一种可编程渲染管线,能够在高端平台上实现前沿的高保真图形效果。
团结/Unity版本
内置渲染管线
通用渲染管线(URP)
高清渲染管线(HDRP)
团结 1.9.1
不兼容
兼容
不兼容
描述

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。无外部依赖。

技术细节

核心模块

  • 问题查找器 - 扫描已打开和已关闭的场景(基于 YAML,每秒 50+ 个场景,无需加载场景)
  • 项目清理器 - 采用根追溯依赖算法,配备可逆回收站 + 备份 ZIP
  • 引用查找器 - 完整的项目引用图谱,辅以 YAML 补充搜索
  • 趋势与健康评分 - 0-100 评分、变化指示器、折线图,最多保存 60 个扫描快照

内置问题检测器(10 个)

  • 缺失脚本(错误)- 已删除/重命名的 MonoBehaviour 组件
  • 缺失引用(错误)- 指向缺失资源的序列化字段
  • 缺失材质(错误)- 渲染器上的空材质插槽
  • Shader 错误(错误)- 无法编译的 shader
  • 空 UnityEvent(警告)- 没有持久监听器的 UnityEvent 字段
  • 无效图层(警告)- 位于未定义图层索引上的 GameObject
  • 无效标签(警告)- 带有不在标签管理器中标签的 GameObject
  • 未使用组件(警告)- 末端 GameObject 上孤立的 MonoBehaviour
  • 空 GameObject(信息)- 仅含 Transform 且无子物体的 GameObject
  • 重名(信息)- 共用同一文件名的多个资源

CI/CD 与自动化

  • 通过 -executeMethod SentinelCLI.RunScan 实现无界面 CLI 模式
  • JSON 报告(扫描日期、版本、问题摘要、完整问题数组)
  • 带内联 PR 注释的 JUnit XML 报告(GitHub Actions、Jenkins、GitLab CI)
  • 内含开箱即用的 GitHub Actions 工作流(Assets/Sentinel/GitHubActions/sentinel.yml)
  • CLI 基线锁定:SentinelCLI.LockBaseline
  • Git post-merge 钩子安装器:每次 git pull / merge 后自动扫描
  • 退出码:0 = 通过,1 = 发现问题,2 = 扫描错误

构建守卫

  • 可选的"出现错误时构建失败"功能:存在错误级别问题时阻止玩家版本构建
  • 每次构建前进行快速预构建扫描(缺失脚本 + 缺失引用)

基线与回归追踪

  • 可将任意扫描状态锁定为基线(存储于受版本控制的 sentinel.baseline.json 中)
  • 后续所有扫描均会报告"自基线以来新增 X 个问题"- 阻止新回归,同时允许已知的技术债务

抑制与覆盖

  • [SentinelIgnore] 特性用于代码级抑制,可附带可选的原因字符串
  • 在 Project Settings 中按问题类型覆盖严重级别
  • 团队共享的抑制文件(Assets/SentinelData/SentinelSuppressions.json,受版本控制)
  • 右键上下文菜单:排除文件夹或抑制某资源中的所有问题

通知

  • 支持 Slack 和 Discord webhook,并提供"测试 Webhook"按钮

可扩展性

  • 通过 SentinelExtensionBase 创建自定义检测器 - 自动发现,无需注册
  • 重写 DetectorName + On*Scanned 方法,调用 AddIssue()

要求与兼容性

  • Unity 2021.3 LTS 或更新版本(包括 Unity 6)
  • 支持所有渲染管线:Built-in、URP、HDRP
  • 仅限编辑器 - 对玩家版本构建体积零影响
  • 无外部依赖
  • 键盘快捷键:Ctrl+Shift+Alt+S

Sentinel - 项目健康检测、问题扫描与资源清理工具

Unity 海外资源商店评分
5.0(2条评分)
国内数据
6浏览
0收藏
当前价格
¥203
¥290
30% OFF
已享受 平台补贴
席位
仅支持将资源分配给中国区用户,其他区域账号暂不支持
许可证类型
如对许可证类型有疑问,请查阅EULA
席位
文件大小
72.8 KB
最新版本
1.0.1
最新发布日期
2026-06-29
支持Unity版本
/
支持的团结引擎版本
1.9.1或更高
发布者支持
ragendom@gmail.com