dsh-yeelight-smart-home

dsh plugin --profile web add dsh-yeelight-smart-home

<div align="center">

dsh-yeelight-smart-home

在 DeepSeek Harness 中直接控制、组织、诊断、设计、个性化你的 Yeelight 智能家居。

[English](README.md) · [简体中文](README.zh-CN.md)





</div>

---

它能做什么

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

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

功能特性

🤖 三个面向模型的工具 · yeelight_home — 一键 Skill Runtime 调用 · yeelight_reference — 按需路由文档 / 目录 / Schema · yeelight_product_select — 离线灯光设计选品

🧠 内存技能 · 完整适配的路由规则集（绝对规则、工作流、领域参考）— 任何 DSH profile 都能用

⚙️ 专属设置页 · DSH 设置中的独立页面（而非埋在卡片里）：运行状态、配置、认证、日志一目了然

🚀 一键安装运行时 · 缺少 yeelight-home？直接在设置页选 Homebrew / npm / GitHub Release 安装并自动校验

📋 调用日志 · 有界、自动裁剪的 JSONL 历史记录，支持逐条查看详情

🗂️ 持久化配置 · 保存在 $DSH_HOME/plugins/dsh-yeelight-smart-home/config.json

快速开始

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。

键 · 默认值 · 说明

binPath · ""（自动检测） · yeelight-home 可执行文件的绝对路径

region · "" · 地区覆盖（cn、us、eu、sg、in、ru 等）

houseId · "" · 默认住宅 ID（--house-id）

profile · "" · 运行时配置档（--profile）

locale · zh-CN · 请求语言（zh-CN、en-US、zh-TW、ja-JP）

dryRunDefault · false · 默认仅预览效果，直到关闭 dry-run 重发

requestTimeoutMs · 120000 · 单次请求超时（毫秒）

logRetention · 500 · 最多保留的调用日志条数

logEnabled · true · 调用日志总开关

uiStatusEnabled · true · 显示状态横幅

uiLogsEnabled · true · 显示调用日志区域

uiQuickInvokeEnabled · true · 显示快速调用面板

开发

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/](src/)（工具、技能、Web 路由），浏览器端在 [src/client/bundle.js](src/client/bundle.js)（设置页），技能数据在 [data/](data/)。

文档

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

许可证

Apache-2.0 — 详见 [LICENSE](./LICENSE) 与 [NOTICE](./NOTICE)。

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