三峰智能家居控制技能。适用场景:(1) 用户说"三峰登录 账号 密码";(2) 用户说打开/关闭/调节灯/空调/窗帘/插座等设备;(3) 用户说同步设备、设备列表、场景列表、执行场景、家庭列表、进入家庭、帮助、三峰帮助;(4) 用户说任何模式/场景名称(如观影模式、阅读模式、回家等)。所有操作真实调用 API,不返回模拟结果。
--- name: sufn-smart-home version: 1.0.2 tags: ["smart-home", "智能家居", "sufn", "三峰", "灯光", "场景控制"] description: 三峰智能家居控制技能。适用场景:(1) 用户说"三峰登录 账号 密码";(2) 用户说打开/关闭/调节灯/空调/窗帘/插座等设备;(3) 用户说同步设备、设备列表、场景列表、执行场景、家庭列表、进入家庭、帮助、三峰帮助;(4) 用户说任何模式/场景名称(如观影模式、阅读模式、回家等)。所有操作真实调用 API,不返回模拟结果。 --- 技能激活说明 : - 用户发送「三峰登录 [账号] [密码]」时,调用本技能处理登录。 - 用户发送设备控制指令(打开/关闭 + 设备名)时,调用本技能。 - 用户说任何模式或场景名称时,调用本技能。 智能家居控制技能 外部服务声明 本技能调用以下外部 API: https://open.aibasis.cc —— 三峰智能家居(SUFN)官方开放平台 API,用于设备控制、场景执行、家庭数据同步、用户登录鉴权。 本技能不访问任何其他外部域名,不读写授权范围外的本地文件,不执行与智能家居控制无关的系统操作。 平台支持 Windows :完全支持,使用 PowerShell + Invoke-RestMethod 调用 API。 macOS / Linux :完全支持,使用 bash + curl 调用 API。 Agent 在执行前应先判断操作系统,选择下方对应章节的脚本。若检测失败,默认按 Windows 处理;非 Windows 环境下若未提供 bash 支持,回复用户「本技能在当前系统尚未完全适配,请在 Windows 环境使用」。 响应规则 所有操作真实调用 API,不返回模拟或伪造结果。 回复保持简洁,仅包含操作结果,不附加额外建议或多余提示。 每次操作只发一条消息。 --- 状态文件 登录状态和设备数据持久化存储在 {baseDir}/state.json。 读取 :使用标准 read 工具,path 填 {baseDir}/state.json。文件不存在时视为未登录。 写入 :使用标准 write 工具,path 填 {baseDir}/state.json,content 为脚本输出的 JSON 字符串。 exec 工具仅用于调用 HTTP API,不用于文件读写。 数据流约定 :下方所有脚本会在最后用 Write-Output "STATE JSON: "(PowerShell)或 echo "STATE JSON: "(bash)输出待持久化的 JSON。Agent 捕获该行后,提取 STATE JSON: 之后的内容,用 write 工具写入 state.json。若脚本还输出了 OK ... 或 FAIL ... 行,则按该行决定回复文案。 --- API 说明 Base URL:https://open.aibasis.cc 认证:所有接口 Header 加 Authorization: Bearer 登录 获取家庭列表 进入指定家庭 同步家庭数据 控制设备或执行场景 lamp 5 设备 properties:{"open":1} 开、{"open":0} 关、{"brightness":80} 亮度、{"colorTemperature":4000} 色温、{"h":120,"s":100,"l":50} 颜色 执行场景:model="scene",properties={} --- 操作流程 一、登录 触发词:三峰登录 账号 密码 Windows (PowerShell): macOS / Linux (bash): Agent 处理 : 捕获 STATE JSON: 行,用 write 工具写入 {baseDir}/state.json。 输出 OK home:xxx devices:N scenes:M 时回复:✅ 登录成功,家庭:xxx,已同步设备 N 个、场景 M 个。 输出 FAIL xxx 时回复:❌ 登录失败:xxx。 未提供账号密码时回复:请用格式登录:三峰登录 账号 密码。 --- 二、家庭列表 触发词:家庭列表、我的家庭、有哪些家庭 先用 read 工具读取 state.json,获取 token,再执行: Windows: macOS / Linux: 回复:🏠 共 N 个家庭,前10个:名称1、名称2...,发送「进入家庭 名称」切换 --- 三、进入家庭 触发词:进入家庭 、切换家庭 流程:先用 read 读取 state.json 获取 token,从用户消息提取家庭名称关键词。 Windows: macOS / Linux: Agent 处理 : 捕获 STATE JSON: 行,用 write 工具写入 state.json。 输出 OK home:xxx devices:N scenes:M 时回复:✅ 已进入家庭:xxx,已同步设备 N 个、场景 M 个。 输出 FAIL xxx 时回复:❌ 切换失败:xxx。 --- 四、同步设备 触发词:同步设备、刷新设备 流程:先用 read 读取 state.json 获取 token 和 home 信息。 Windows: macOS / Linux: Agent 处理 :捕获 STATE JSON 行用 write 工具写入;回复 ✅ 同步完成,设备 N 个,场景 M 个。 --- 五、设备列表 触发词:设备列表、有哪些设备 用 read 工具读取 state.json,按房间分组,回复:📋 设备列表(共N个)房间1:设备1、设备2 房间2:设备3 --- 六、场景列表 触发词:场景列表、有哪些场景 用 read 工具读取 state.json,回复:🎬 场景列表(共N个):场景1、场景2、场景3... --- 七、控制设备 触发词:打开/关闭/开启/关掉/调节/设置 + 设备名 流程: 用 read 工具读取 state.json,检查 token 和 devices。 无 token 提示登录;无 devices 提示同步设备。 从用户指令提取设备名,模糊匹配 devices,获取 id 和 model。 构造 properties:开 {"open":1}、关 {"open":0}、亮度 {"brightness":XX}、色温 {"colorTemperature":XXXX}、HSL 颜色 {"h":X,"s":X,"l":X}。 用 exec 调用 /api/control,commands 必须带 model。 成功回复:✅ 已执行:设备名 操作描述。 失败回复:❌ 控制失败:错误信息。 找不到设备:❌ 未找到「关键词」,当前设备:设备1、设备2...。 --- 八、场景模式(智能场景) 触发词:任何模式名称(观影模式、阅读模式、回家、离家、睡眠等) 处理逻辑 : 用 read 工具读取 state.json,提取用户说的场景关键词。 在 scenes 列表中模糊匹配(场景名包含关键词,或关键词包含场景名)。 若找到匹配场景 :调用 /api/control 执行场景,回复:✅ 已执行场景:场景名。 若未找到场景 :根据关键词语义推断灯光参数,对所有设备批量控制。 常见模式推断规则(若未匹配,根据语义自行判断): 观影:brightness:20, colorTemperature:2700 阅读:brightness:100, colorTemperature:6500 睡眠 / 休息:brightness:5, colorTemperature:2700 起床 / 早晨:brightness:70, colorTemperature:5500 浪漫:brightness:20, colorTemperature:2700 专注 / 工作:brightness:100, colorTemperature:5500 聚会 / 会客:brightness:80, colorTemperature:4000 全开:open:1 全关 / 离家:open:0 批量控制时在一次 control 请求里将所有设备放入 commands 数组,不要逐个发请求。 PowerShell 序列化提示 :嵌套对象序列化时需避免 properties 变成 System.Collections.Hashtable 字符串,建议用字符串拼接构造 commands JSON。 Windows: macOS / Linux: 回复:✅ 已执行「场景名」:亮度XX%,色温XXXXK --- 九、未登录时收到控制指令 回复:请先登录,发送:三峰登录 账号 密码 --- 十、帮助 触发词:帮助、三峰帮助、怎么用、有什么功能 直接回复(不调用 API): 🏠 三峰智能家居指令:三峰登录 账号 密码 | 家庭列表 | 进入家庭 名称 | 同步设备 | 设备列表 | 场景列表 | 打开/关闭 设备名 | 设备名 亮度XX% | 设备名 色温XXXX | 观影模式/阅读模式/回家 等场景名