用途：排查 Endor Labs 扫描报错与失败。输入可以是粘贴的错误文本、扫描并诊断请求，或自然语言描述；未提供错误文本时会询问是扫描当前仓库还是分析粘贴内容。扫描模式使用 scan MCP 工具，参数为 path=仓库路径、scan_types=["vulnerabilities", "dependencies"]、scan_options={ "quick_scan": true }，再解析结果并匹配知识库。
主要能力：先识别生态（NPM、Maven/Gradle、PyPI、Go、Cargo、NuGet、RubyGems、Packagist，未匹配时检查跨生态模式如 GitHub Packages、registry/artifactory、沙箱错误）；再分类错误（Auth Conflict、Private Registry、Toolchain、Other）；然后读取 references/error-knowledge-base.md 匹配已知模式，输出诊断表（生态、类别、错误、是否可修复）、含义说明与分步修复方案。多个错误时分别诊断，按 Private Registry > Toolchain > Other 优先级呈现，并提示修复一个可能连带解决其他问题。
常见修复：Auth Conflict 需检查 ~/.endorctl/config.yaml 与 settings.json/mcp.json 中的认证环境变量是否同时存在，二选一后重启 MCP 连接重试；Private Registry 需配置私有包仓库或在 CI 设置凭据并确认云端可访问；Toolchain 需按错误确定版本并更新 Scan Profile 后重扫。云端扫描限制（SSH Git 依赖、系统包安装、Windows 构建、自定义环境变量、Docker 构建）建议迁移到 CI/CD。
限制：无匹配模式时建议查阅文档、重跑 /endor-scan 或联系支持；多生态时需用户指定先排查哪个；MCP 认证错误建议 /endor-setup；扫描工具不可用时仅分析粘贴文本。数据源策略见 references/data-sources.md。