FBoxMCP

管理 FBox 工业物联网设备。 查看设备在线状态和统计信息，实时读写 PLC 监控点数据，处理和确认设备报警，查询历史采集数据趋势，远程打开 VNC 监控画面。 当用户提到 FBox、盒子、设备状态、LC、监控点、温度/压力/电流等传感器数据、报警告警、历史数据、远程监控、VNC、设备运维时使用此技能。

Security Scan

技能声明、运行指令与所需权限在功能范围内一致——它只需要一个 FBOXMCP_API_KEY 并通过网络调用 FBox MCP 服务来管理设备，没有可疑的额外权限或安装步骤。

Purpose & Capability

姓名/描述（管理 FBox 工业物联网设备）与所需项一致：只要求 FBOXMCP_API_KEY 并通过 MCP/Streamable HTTP 与 fboxmcp 服务通信，所列工具（设备列表、监控点、历史数据、确认报警、打开 VNC 等）与描述相符。

Instruction Scope

SKILL.md 明确规定了必须通过工具调用实时数据、禁止凭记忆或猜测返回设备数据、在执行写操作前要求用户确认等。指令仅涉及调用远端 MCP 服务、时间转换、以及与用户交互的候选选择流程，没有要求访问本地任意文件或额外环境变量。

Install Mechanism

这是一个 instruction-only 技能（无 install spec、无代码文件可执行），没有下载或在本地写入代码的安装步骤；文档建议用户手动在客户端（Claude/OpenClaw 等）添加 MCP Server 和配置 Authorization header，属于正常集成说明。

Credentials

仅声明并使用一个环境变量 FBOXMCP_API_KEY（primaryEnv），其用途与服务认证直接相关，未请求与功能无关的密钥/凭证或多个不相关凭证。文档也提示该 Key 为长期有效并建议保管与轮换。

Persistence & Privilege

技能未设置 always:true；默认允许模型调用（平台默认行为），且技能不会自行修改其他技能或系统范围配置。文档要求用户手动将 MCP Server 加入客户端或修改客户端配置，是用户驱动的操作。

Assessment

此技能在功能、指令和所需权限上看起来内部一致且合理，但在安装前请注意： - 只向你信任的 FBox 平台（https://fbox360.com 或你的内部域名）提供 API Key；确认域名和服务归属可信方。 - API Key 文档提示为长期有效（以 sk- 开头），尽量为不同用途创建最小权限或短期 Key，按文档定期轮换和妥善保管（不要提交到公开仓库）。 - 技能可打开 VNC/远程监控界面——这属于远程控制能力，确保你的网络和设备访问策略允许该行为且了解谁能访问这些会话。 - 技能为 instruction-only，不会在本地安装二进制，但会引导你在客户端添加 MCP Server（这会修改客户端配置文件），请在执行前备份本地客户端配置。 - 源信息显示 Source: unknown（注册元数据有 owner id），如你需要更高信任度，可在安装前核实发布者（github 仓库、组织或官网）并确认该仓库/发布者的可信度。

FBox MCP Server 技能

通过 MCP 工具管理 FBox 工业物联网设备。安装和配置详见 README.md。

核心规则

数据真实性

• 所有数据必须来自工具调用的实时返回，禁止凭记忆、推测或编造任何设备信息、数值或状态
• 不得复用之前对话中获取的数据作为当前结果，每次查询必须重新调用工具
• 如果工具调用失败或返回异常，如实告知用户，禁止用虚构数据填充

时间处理

• 服务端所有时间均为 UTC 时间
• 展示给用户时必须转为北京时间（UTC+8），仅精确到秒
• 禁止假设当前时间，必须通过 utc_now 工具获取服务器实时时间
• 历史数据和报警历史中的 Timestamp 为 UTC 毫秒级时间戳

参数处理

• BoxNo（设备序列号）和 BoxAlias（设备别名）二选一即可定位设备
• 用户说出的设备名称优先作为 BoxAlias 传入
• 缺少必填参数时设为 null 调用工具，服务端会返回候选列表
• 禁止自动猜测或补全参数，必须从候选列表中让用户选择

在线设备优先

• 除非用户明确说"所有设备"或"离线设备"，默认 OnlyOnline = true
• ConnState 为 Online 或 TimedOut 视为在线

数据展示

• bool 值展示为"是"或"否"
• 报警历史和历史数据默认以表格形式展示
• 监控点、报警、历史数据条目之间逻辑上没有强制关联性，不要假设名称一致

写操作安全

• write_user_box_dmon_value 和 confirm_current_alarm 是写操作
• 必须获得用户明确确认后才能执行
• 写入前先读取当前值展示给用户对比

响应格式

所有业务工具返回统一结构：

{
  "success": true,
  "code": 0,
  "message": null,
  "data": { "..." },
  "suggestedParameters": null
}

Code	含义	处理方式
0	成功	解析 data 展示给用户
300	参数需要选择	解析 suggestedParameters 候选列表让用户选择，选择后用 value 字段（非 label）重新调用
400	请求错误	展示 message 错误信息
401	未认证	提示用户检查认证配置
404	未找到	提示目标资源不存在
500	服务器错误	提示系统异常，建议稍后重试

典型工作流

设备状态概览

get_user_box_stats → get_user_box_list(OnlyOnline=true) → get_user_box_info(BoxAlias=xxx)

查看监控点数据

get_user_box_dmon_group_list(BoxAlias=xxx)
  → [如返回 300，让用户选择设备]
get_user_box_dmon_list(BoxNo=xxx, GroupName=xxx)
  → [如返回 300，让用户选择分组]
get_user_box_dmon_value(BoxNo=xxx, GroupName=xxx, Name=xxx)

处理设备报警

get_user_box_stats → 确认存在报警
get_current_alarm_list(BoxAlias=xxx) → 展示当前报警
confirm_current_alarm(BoxNo=xxx, AlarmName=xxx) → 用户确认后执行

查询历史趋势

utc_now → 获取服务器时间
get_history_data_define_list(BoxAlias=xxx) → 了解可查数据
get_history_data_list(BoxNo=xxx, ItemName=xxx, BeginTime=..., EndTime=...)
  → 以表格形式展示，时间转北京时间

写入监控点

get_user_box_dmon_value → 读取当前值展示给用户
  → 用户确认 "将 [监控点] 从 [当前值] 修改为 [目标值]"
write_user_box_dmon_value(Confirmed=true)