SuperAPI AI 工具集

unifi-network-support

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:为 UniFi Network 生成尽可能小的、经脱敏处理的支持包,帮助用户本地审查并准备缺陷报告内容,但不代替用户发布、上传、评论或创建 issue。 主要能力:通过 unifi_get_support_bundle 收集支持包,服务端仅向配置的 MCP 客户端返回 JSON。用户可选择探针:默认从 summary 开始,它仅使用本地/缓存,不联系控制器;仅当连接或认证行为相关时才使用 connectivity,它会通过现有已认证会话发出一次有界只读请求,调用前需用户明确确认。 使用方式:默认调用 unifi_get_support_bundle(probe="summary"),除非用户选择并确认了另一个受支持的探针。不要经 _execute、_batch、中继或多位置并发展开调用。若工具缺失,建议更新 network 插件或包并重启 MCP 客户端;若服务器无法启动或注册工具,用 $unifi-network-setup 获取安装帮助,退回使用缺陷表单中的手动字段(版本、控制器、安装方式、客户端、预期、实际、复现步骤)。不要索取凭据、原始配置、控制器载荷或大范围诊断日志。 本地审查:完整展示返回的 JSON,并在任何外部共享前暂停。支持包是脱敏而非匿名,包/控制器版本、运行时模式、能力标志和粗粒度结构形态可能关联或指纹识别环境;它排除凭据、控制器地址、标识符、原始资源值、响应体、原始异常文本、日志、配置文件和调用方提供的路径或端点。UNIFI_MCP_DIAGNOSTICS 日志属独立运维设施,不自动适合公开发布。用户可删除不想共享的可选部分或值,尽量保留 schema_version、product、probe 和相关证据。要求用户确认已审查 JSON,且未手动加入原始日志、载荷、配置、凭据、控制器标识符或安全漏洞细节。 准备好报告后,可提供可粘贴进支持包(可选)表单字段的 json 代码块,或提供本地 .json 文件供用户检查后自行拖入 GitHub。将文件拖入 GitHub 即开始发布/上传,公开 issue 的附件是公开可访问的。不建议对 JSON 截图。本技能绝不自动上传、附加、粘贴、发布或提交支持包。 适用场景:需要在提交 UniFi Network 缺陷报告前,生成并本地审查脱敏支持包的用户。 限制:summary 为本地/缓存,无法确定控制器连通性或整体产品健康;connectivity 是一次有界请求而非全面审计。需保留每个探针的状态,包括不可用、不支持、部分和被截断的结果,不能把失败或缺失探针当作成功空结果或全清。需区分观察到的支持包字段与诊断假设,不评估身份。若所需服务器或工具不可用,应停止收集并改用手动字段。 依赖:必须 network,无可选依赖。