SuperAPI AI 工具集

unifi-protect-support

部署与运维

查看项目

更新于 10-16 09:29

技能介绍

用途:通过 protect_get_support_bundle 收集最小可用的脱敏支持包,服务器仅将 JSON 返回给已配置的 MCP 客户端;本技能不会替用户发布、上传、评论或创建 issue。依赖:必需 protect,无可选依赖。若所需服务器或工具不可用,应停止收集并改用漏洞表单中的手动字段;工具可发现并不代表控制器可达。

探针选择:默认从 summary 开始,它仅使用本地/缓存,不接触控制器。仅当连接或认证行为相关时才使用 connectivity,它会通过现有已认证会话发起一次有界的只读请求,调用前需用户明确确认。对于疑似 Protect 传感器序列化不匹配,可用 summary 获取环境证据;protect_get_support_bundle(probe="resource_shape", resource="sensors") 当前返回 unsupported,因无可用的经验证安全传感器结构来源,现版本不要请求或调用该探针,也不要声称支持 UP-AirQuality 传感器结构覆盖。若用户要求先看将收集什么,应先说明所选探针及包含/排除的数据类别。

生成:除非用户选择并确认其他受支持探针,否则调用 protect_get_support_bundle(probe="summary")。不要经 _execute、_batch、中继或多位置扇出调用。若工具缺失,建议更新 protect 插件或包并重启 MCP 客户端;若服务器无法启动或注册工具,使用 $unifi-protect-setup 获取设置帮助,并回退到手工填写版本、控制器、安装、客户端、预期、实际与复现步骤。不要索取凭据、原始配置、控制器负载或宽泛诊断日志。

本地审查:向用户展示完整返回的 JSON,并在任何外部共享前暂停。说明支持包是脱敏而非匿名,包/控制器版本、运行模式、能力标志和粗粒度结构形状可能关联或指纹化环境;它排除了凭据、控制器地址、标识符、原始资源值、响应体、原始异常文本、日志、配置文件及调用方提供的路径或端点。UNIFI_MCP_DIAGNOSTICS 日志是独立运维设施,不自动可公开发布。用户可移除不想分享的可选字段,同时尽量保留 schema_version、product、probe 及相关证据。请用户确认已审查 JSON 且未手动添加原始日志、负载、配置、凭据、控制器标识符或安全漏洞细节。

为漏洞报告做准备:审查后,提供可粘贴到 Support bundle(可选)字段的 fenced json 代码块,或供检查后拖入 GitHub 的本地 .json 文件。拖入 GitHub 即开始发布/上传,公开 issue 的附件公开可见;不建议对 JSON 截图。本支持技能绝不能上传、附加、粘贴、发布或提交支持包,只返回已审查的 JSON 或其本地路径,任何发布须在本工作流之外进行。规范指南:https://github.com/sirkirby/unifi-mcp/blob/main/docs/support-bundles.md