Yeelight/dsh-yeelight-smart-home

---

它能做什么

dsh-yeelight-smart-home 把 DeepSeek Harness 变成你的完整 Yeelight 智能家居管家。它由本地 yeelight-home Skill Runtime 驱动——所有请求都走官方运行时，无需 API Key、无需云代理、无需 Home Assistant。

模型可以控制设备、查询状态、执行场景与自动化、做灯光设计、记住你的偏好、回答产品问题；而你在 DSH 里拥有一页专属设置页，轻松管理运行时、认证与配置。

功能特性

快速开始

1. 安装插件

需要 Node.js ≥ 22.13 和 DeepSeek Harness ≥ 0.1.1。

# 从 npm 安装（推荐）
dsh plugin --profile web add dsh-yeelight-smart-home

# …或从源码构建
git clone https://github.com/Yeelight/dsh-yeelight-smart-home.git
cd dsh-yeelight-smart-home
npm install && npm run build

重启 dsh web，然后打开 设置 → Yeelight 智能家居。

2. 安装运行时（一键）

打开插件设置页。如果缺少 yeelight-home，页面会列出你机器上可用的安装渠道——点一下，插件就会替你安装并校验二进制文件，全程无需终端。

更喜欢命令行？

npm install -g yeelight-home          # npm
brew install yeelight/yeelight-home/yeelight-home   # Homebrew（macOS）

3. 认证

yeelight-home auth login --qr

…或者从设置页复制命令，在终端扫描二维码即可。

4. 开始与你的家对话

安装后，工具会在下次启动 profile 时自动激活：

• 控制 — 开关、亮度、色温、颜色
• 查询 — 设备状态、家庭摘要、实体列表
• 场景与自动化 — 查看、执行、创建、修改
• 诊断 — 网关、设备、场景、自动化诊断
• 灯光设计 — 全屋设计方案、选品、导入
• 个性化 — 记忆（记住/回忆）、推荐、操作经验
• 参考 — 路由指南、产品目录、Schema、示例

设置页

插件注册了顶级设置分区（设置 → Yeelight 智能家居），与「通用设置」「模型」「插件」等平级：

• 状态横幅 — 连接状态、版本、可执行文件路径、认证状态、地区
• 认证 — 登录状态与 token 来源；未登录时给出扫码登录引导
• 配置 — 运行时路径、地区与语言下拉选择、住宅 ID、配置档、请求超时、日志保留、界面开关
• 运行时安装 — 缺运行时的一键渠道安装，带实时进度
• 调用日志 — 最近历史，可实时刷新

配置

所有键都可以在设置页直接编辑。配置持久化于 $DSH_HOME/plugins/dsh-yeelight-smart-home/config.json。

开发

npm install
npm run build      # host bundle → lib/ · browser bundle → lib/client.js
npm run typecheck  # TypeScript 检查
npm test           # vitest 测试套件
npm run check      # 以上全部

目录结构：host 端在 src/（工具、技能、Web 路由），浏览器端在 src/client/bundle.js（设置页），技能数据在 data/。

文档

• SKILL.md — 从上游适配到 DSH 的技能说明（SKILL.upstream.md）
• references/ — 路由文档、领域规则、载荷指南
• assets/ — 意图目录、Schema、灯光设计示例、产品目录
• CHANGELOG.md — 版本历史

许可证

Apache-2.0 — 详见 LICENSE 与 NOTICE。

本插件是 yeelight-smart-home 参考技能（Yeelight 版权所有，Apache-2.0 许可）的衍生作品。