按房间总结设备
使用 yeelight-smart-home，只读总结我家每个房间的灯具、设备组和在线状态。
你会看到真实的房间与设备摘要，0 项改动。给 AI 装上易来全屋智能能力
先确认 Yeelight Home 已经连好你的家庭，再把官方 Skill 安装到常用 AI。完成后，你可以用日常语言查询家庭、预览并执行灯光操作、调用情景、设计自动化和优化全屋照明。
- 预计时间
- 15 分钟
- 完成后你会看到
- AI 真实发现 `yeelight-smart-home`，能读取当前家庭，生成一次零写入灯光预览，并在你确认后完成一次可逆操作与状态核对。
开始前准备
- Yeelight Home 已安装并通过检查
- Yeelight Pro 账号已授权
- 已经选择默认 Pro 家庭
- 至少安装了一个支持 Agent Skill 的 AI
先确认家庭底座已经就绪
运行下面两条只读命令；如果正常运行，就不重复安装 Yeelight Home，也不重复扫码。任何一条失败，都先进入上方“安装底座并配置你的家庭”教程，完成后再回来。
yeelight-home version --jsonyeelight-home version --json
交互演示，不会在你的电脑上执行命令，也不会连接设备。
yeelight-home doctor --jsonyeelight-home doctor --json
交互演示，不会在你的电脑上执行命令，也不会连接设备。
看到这个就成功版本命令正常，Doctor 显示 `status: ok`、已登录并已选择家庭。
如果没有成功命令不存在、未登录、没有默认家庭或出现修复建议时，先去完成 Yeelight Home 教程。本页无需再次扫码。
推荐：让 AI 帮你安装 Skill
把下面这句话发给能操作本机终端的 AI。它只负责检查前置、打开交互式安装向导和核对结果，不会替你猜选哪个 AI。已登录时，向导会让你继续使用当前账号或主动切换账号。
安装完整智能能力
请先运行 `yeelight-home version --json` 和 `yeelight-home doctor --json`，确认 Yeelight Home 已安装、已登录并已选择家庭。如果没有就绪，请停下来并引导我完成 Yeelight Home 教程，不要在这篇 Skill 教程里重复安装或扫码。确认就绪后，运行 `yeelight-home setup --lang zh-CN --mode skill`，让我在终端里选择要安装到的 AI、确认安装计划，并选择继续使用当前账号还是重新扫码切换账号。安装完成后，告诉我完全退出并重新打开所选 AI，再真实检查当前会话是否发现 `yeelight-smart-home`。不要索要账号、二维码、验证码或 Token，也不要改用非官方 Skill。
默认继续使用当前账号；只有你明确选择切换时才会重新扫码，凭据不会进入聊天。 脱敏交互演示，不会读取你的家庭或控制设备。
看到这个就成功AI 把选择权交给你，并如实报告安装器和宿主发现结果。
如果没有成功AI 无法操作终端时，直接执行下一步的同一条命令。
在终端选择你的 AI 并安装
不要加 `--agent auto --yes`：确认 Yeelight setup 总计划并选择登录账号后，会直接进入 Vercel `skills` 官方安装器。Vercel 负责扫描本机 AI、默认选中已检测目标，并提供搜索、空格多选、安装方式和最终确认；Yeelight Home 不再维护一套重复的 Agent 选择器。安装器只选择 `yeelight-smart-home`，并在打开交互界面前从 GitHub、官方 Gitee、GitCode 中找到第一个可用源。
yeelight-home setup --lang zh-CN --mode skillyeelight-home setup --lang zh-CN --mode skill
交互演示，不会在你的电脑上执行命令，也不会连接设备。
查看文字版
真实安装器从官方源读取两个 Skill，只选择 yeelight-smart-home，安装到所选 AI，并返回成功；家庭、路径和凭据已脱敏。
看到这个就成功安装器显示 `Selected 1 skill: yeelight-smart-home`、安装位置和 `Installation complete`。重复执行也能安全更新。
如果没有成功没有检测到 AI 时，Vercel 安装器会显示它支持的宿主供你选择。未列出的新宿主可显式使用 `--agent <id>` 尝试；只支持项目级 Skill 的宿主不能使用本教程的全局安装。
完全重开 AI，再确认它真的看见了 Skill
多数 AI 只在启动时扫描 Skill。只刷新网页或新开聊天可能不够，先完全退出应用或命令行进程，再重新打开。
检查真实发现结果
请查看当前会话真正加载到的 Skills，确认是否包含 `yeelight-smart-home`，并告诉我它来自哪个安装位置。不要只根据文件夹存在就推断已经加载。
这里只检查 Skill 元数据，不读取或控制家庭。 脱敏交互演示，不会读取你的家庭或控制设备。
看到这个就成功AI 返回精确 Skill ID，而不是笼统地说“文件已经安装”。
如果没有成功仍未发现时，核对安装位置是否属于当前 AI，并再次完全退出重开；不要反复重装 Yeelight Home。
体验 1：让 AI 看懂整个家
先从只读开始。真实 Runtime 会同时读取家庭、房间、设备、设备组、情景和自动化，再由 Skill 用普通话归纳。
生成家庭速览
请使用 yeelight-smart-home 看看我当前的家，用普通人容易看懂的方式总结房间、主要灯具、设备组、情景和自动化。只读取，不要控制或修改任何东西。
只读，不产生云端写入。 脱敏交互演示，不会读取你的家庭或控制设备。
看到这个就成功你能看到自己的真实房间、设备组、情景和自动化，而不是通用示例。
如果没有成功名称重复时让 AI 列出候选项；不要让它凭印象猜目标。
体验 2：问清一盏灯现在怎么样
指定房间和位置，AI 会先定位唯一设备，再读取在线状态、开关、亮度、色温或设备实际支持的属性。
查询真实状态
请使用 yeelight-smart-home 查看客厅电视墙附近的灯现在是否在线、有没有打开、亮度和色温是多少。先确认具体是哪一盏灯；如果有多个候选，请列出来让我选。
查询不会改变设备。 脱敏交互演示，不会读取你的家庭或控制设备。
看到这个就成功AI 给出真实状态，并在目标不唯一时先询问。
如果没有成功设备离线时继续使用诊断能力，不要把上一次状态当成当前状态。
体验 3：先预览，再让灯光真实响应
这一步能看到 Skill 的完整价值：先核对房间或灯组、亮度和影响范围，确认没有写入；你同意后再执行可逆控制，并读回状态。
预览并确认一次可逆操作
请使用 yeelight-smart-home 预览把客厅格栅灯组调到 40% 亮度。先告诉我会影响哪些灯，并明确现在没有执行；等我回复“确认执行”后再操作，完成后读取状态确认结果。
亮度调整可逆；没有你的确认不会执行。 脱敏交互演示，不会读取你的家庭或控制设备。
删除、解绑、转移家庭等高影响操作不属于这个快速体验。
看到这个就成功预览阶段灯不变；确认后对应灯组响应，AI 给出真实验证结果。
如果没有成功如果只返回预览，就明确回复“确认执行”；如果目标不对，先改目标，不要确认。
体验 4：一句话调用家里的情景
Skill 会先查看你已有的情景，不会把“观影”“晚安”之类的日常词直接猜成某个内部编号。
找到并执行已有情景
请使用 yeelight-smart-home 找出我家和观影有关的情景，用一句话说明每个情景会影响什么。让我选中一个后，再执行并告诉我结果。
情景执行前先确认具体名称和影响范围。 脱敏交互演示，不会读取你的家庭或控制设备。
看到这个就成功AI 使用你家真实存在的情景，并准确说明执行结果。
如果没有成功没有匹配情景时，让 AI 提议一个新方案，但不要假装已经存在。
体验 5：把照明经验变成可检查的方案
完整 Skill 不只会开灯。它能结合房间、灯具、传感器、情景和已有自动化，先给出可读方案，再决定是否写入。
设计晚间自动化
请使用 yeelight-smart-home 检查主卧现有灯光、窗帘、传感器、情景和自动化，为我设计一个晚间放松方案。先说明触发条件、每一步动作、失败保护和为什么这样设计，只给预览，不要创建或修改任何配置。
默认只预览；创建自动化或应用设计前再次确认。 脱敏交互演示，不会读取你的家庭或控制设备。
看到这个就成功方案引用真实设备和已有配置，明确区分现状、建议和未执行内容。
如果没有成功缺少传感器或设备能力时，AI 应说明限制并给出简化方案，不能杜撰设备。
先试这几个日常场景
先选 3-5 个最容易理解的例子。每句话都可以直接发给你的 AI。
查询指定灯具
使用 yeelight-smart-home，看看主卧床头右侧的灯是否在线、当前亮度和色温是多少；目标不唯一就先问我。
你会看到消除歧义后的真实设备状态。预览并调整灯组
使用 yeelight-smart-home，先预览把客厅射灯组调到 35%，等我确认后执行并核对。
你会看到预览、确认、执行和读回验证。执行已有情景
使用 yeelight-smart-home 列出晚安相关情景，让我选择后再执行。
你会看到真实情景发现与受控执行。排查离线设备
使用 yeelight-smart-home，只读检查离线设备，并按真实证据给最短排查顺序。
你会看到基于设备、网关和连接证据的诊断。更多完整场景
整理设备组与区域
检查房间、区域和设备组是否有重复、遗漏或名称混乱，先给整理方案，不要修改。
你会看到可审查的空间与分组整理建议。解释自动化为什么没触发
检查“回家亮灯”自动化的状态、时间窗、传感器条件和动作，告诉我最可能卡在哪里，不要先修改。
你会看到按证据排序的自动化诊断。设计人体传感自动化
检查走廊传感器和灯具，设计有人亮灯、无人延时关闭的自动化，只给预览。
你会看到真实能力约束下的触发、动作和保护。优化面板与旋钮
查看主卧面板和旋钮的现有绑定，给出更顺手的按键与旋转方案，不要写入。
你会看到保留现有绑定前提下的配置建议。全屋照明体检
检查全屋房间、灯组、情景和自动化，按舒适度、可控性和节能优先级给建议。
你会看到结合现状的全屋照明改进清单。生成照明设计计划
根据客厅现有灯具和使用习惯，设计会客、观影和清洁三套灯光，只预览。
你会看到带设备目标、亮度、色温和理由的设计。检查设备能力
检查儿童房灯具分别支持开关、亮度、色温还是彩光，按设备整理。
你会看到基于真实能力的可控项清单。诊断网关与子设备
只读检查网关、子设备数量和在线情况，说明哪些问题是已证实、哪些仍未知。
你会看到不臆测原因的网关诊断。记住明确偏好
记住我明确偏好主卧夜间使用 3000 K 暖光；保存前先向我复述这一条偏好。
你会看到经确认的结构化本地偏好。给出一个有依据的建议
结合当前家庭和已保存偏好，只给我一个最值得做的照明建议，并说明依据。
你会看到一条有真实证据、可接受或忽略的建议。新家方案预演
根据现有三室户型和易来设备能力，先生成新家照明导入计划，不绑定网关、不创建真实设备。
你会看到与真实执行资源明确分开的设计预演。遇到问题
开始前必须先装好 Yeelight Home 吗？
是。先运行 `yeelight-home version --json` 和 `yeelight-home doctor --json`。未安装、未登录或未选家庭时，进入“安装底座并配置你的家庭”教程；本页不重复这些步骤。
为什么这篇教程没有要求我再次扫码？
扫码和选家已在 Yeelight Home 教程完成。交互式 setup 检测到已登录账号时，默认继续使用当前账号；如果你正好要换账号，用方向键选择“重新扫码并切换账号”，成功后会重新选择新账号的家庭。
为什么推荐命令不再使用 `--agent auto --yes`？
不加这两个参数时，setup 会直接打开 Vercel `skills` 官方安装器，由它扫描本机 AI、默认选中已检测目标，并让你搜索、增删和确认。`--agent auto --yes` 只适合明确需要无人值守安装的高级用户。
GitHub 在国内访问不了怎么办？
setup 会先尝试 GitHub canonical 源，失败后自动尝试易来官方 Gitee、GitCode 只读镜像。主流程不需要手工复制仓库地址。
安装器为什么显示 Found 2 skills？
官方仓库包含多个 Skill，但 setup 会显式选择 `yeelight-smart-home`。成功输出应显示 `Selected 1 skill: yeelight-smart-home`。
PromptScript 提示不支持全局安装，是程序坏了吗？
不是。PromptScript 只支持项目级 Skill；请在目标项目中使用它的项目级安装方式，或选择支持全局 Skill 的 AI。setup 会明确报告这个边界，不会假装成功。
ClawHub 可以作为首选吗？
不建议。GitHub 源码与 Release 是 canonical，Gitee/GitCode 是官方镜像。ClawHub 只适合 OpenClaw 用户可选直装，而且当前平台许可证元数据与官方 Apache-2.0 不一致，不能作为版本真相源。
安装成功后，AI 为什么还看不到 Skill？
宿主通常只在启动时扫描 Skill。完全退出并重开所选 AI，再查看当前会话真实加载的 Skill；仅看到文件夹存在不等于已加载。
需要自己启动本地服务器吗？
不需要。Skill 直接调用本机 `yeelight-home`，普通用户不用启动 Python、MCP 服务或维护端口。
需要在这页选择 cn、sg、us、eu 区域吗？
不需要。区域已在 Yeelight Home 配置时保存。本页只安装 Skill；区域或账号不对时，回到 Yeelight Home 教程修正。
为什么有些操作要求家庭管理员？
读取和普通可逆控制通常不需要管理权限；创建、删除、成员、家庭和部分配置操作受账号角色限制。Skill 不会绕过 Yeelight Pro 权限。
AI 不知道我要操作哪一盏灯怎么办？
补充房间、位置或设备名称，让 AI 列出候选项再选择。不要用模糊名称直接确认执行。
预览会不会真的开灯？
不会。正确预览会返回 `dryRun=true`、`persistentWrites=false` 和 `dry_run_no_cloud_write`。只有你确认后，AI 才会发送真实控制。
我确认后灯还是没变化怎么办？
让 AI 读取操作结果和当前状态，区分离线、能力不支持、部分执行和写后验证不一致；不要把“命令已发送”当成“设备已成功变化”。
可以重复运行 setup 更新 Skill 或切换账号吗？
可以。重复运行会重新读取官方源并更新同一 Skill；检测到登录账号时，用方向键选择沿用当前账号或重新扫码切换。切换成功后会重新选择家庭，扫码失败则保留原账号和家庭。
Skill 会保存我的所有对话吗？
不会。Yeelight Home 不保存完整对话；只有你明确要求记住的结构化偏好或反馈才会进入本地记忆，并且可以暂停、查看、导出或删除。
关注易来，继续探索
获取产品动态、智能照明灵感与 Yeelight AI 的最新实践。选择你常用的平台，扫码关注或直接访问。
微信公众号
Yeelight 易来
关注官方公众号，获取产品更新、使用指南与智能照明内容。
使用微信扫码关注。 抖音
Yeelight 易来
观看易来产品、空间光影与智能照明的短视频内容。
使用抖音扫码关注。
腾讯视频号
姜兆宁 Yeelight 易来
关注易来 CEO 的家居视频号，了解智能照明与真实家庭空间。
使用微信扫码关注视频号。