dsh-homeassistant

DSH PLUGIN工具与能力

仓库 huhuai-ni/dsh-homeassistant

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH 插件:用 Home Assistant 接管米家(小米智能家居)设备 —— 灯 / 空调 / 风扇 / 红外遥控,带设置页与完整教程。

一句话选型结论

按资料字段整理

dsh-homeassistant 是工具与能力类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类工具与能力 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-10-26 创建于 2026-10-25
README 13.2 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:huhuai-ni/dsh-homeassistant
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

智能体编排

上游标签

deepseek-harnessdshdsh-pluginhome-assistantmijiamiotredmismart-homexiaomi

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在工具与能力场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-homeassistant当前 L5 · 运行验证通过 低风险 1 未标注 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方huhuai-ni仓库 dsh-homeassistant · 默认分支 main
分类工具与能力agents
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-25 · 2026-10-26最后推送 2026-10-26
本站收录2026-10-30首次进入本站目录的时间

README 全文

13.2 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-homeassistant · 米家 / 小米智能家居控制

> 让 DSH 里的 AI 伙伴直接控制你米家 App 里的设备:灯、空调、风扇、红外遥控器。
> 不靠手机、不靠模拟点击,一条 HTTP 请求打到底。



这是什么

一个 DSH 插件,两半:

半边 干什么
后端(index.js) 注册 ha_* 工具,转发请求到 Home Assistant 的 REST API;同时提供 /api/ha/* 给设置页用
前端(client.js) 在 DSH 的 设置 → 插件 里加一栏「家庭助理」:填地址、填令牌、看设备列表、直接开关、拖亮度

配好之后,你可以直接说:

「把卧室的灯关了」
「灯调暗一点」
「空调调到 26 度」
「现在有啥设备开着」

AI 就会调 ha_control / ha_light / ha_service,真的把灯关掉。


米家(Xiaomi MIoT)适配说明

这个插件不直接对接米家,而是通过 Home Assistant 的 Xiaomi Miot Auto 集成间接控制。原因写在下一节,这里只说清楚它覆盖了什么:

米家里的东西 能不能控 说明
米家台灯 / 吸顶灯 / 灯泡 ✅ 开关、亮度、色温都能调
米家插座 / 开关面板 ✅ 开关
空调(含米家空调伴侣 / 红外遥控) ✅ climate 实体,开关、温度、模式
风扇(含红外遥控款) ✅ fan 实体,开关、档位
窗帘电机 ✅ cover 实体,开/关
米家场景 / 自动化 ✅ 通过 ha_service 触发 scene / script
小爱音箱 ⚠️ 部分 能开关、调音量(media_player);不能让它开口说话
门锁 / 摄像头 ❌ 不碰 安全和隐私考虑,本插件不提供相关操作

账号要求:一个能登录米家 App 的小米账号(手机号或邮箱都行)。密码只填在 HA 里,本插件不保存。

为什么不做直连:米家没有对个人开放的 API,第三方库(python-miio + micloud)的登录流程已经被小米改掉,会返回 MiCloudAccessDenied——密码对也登不上。Xiaomi Miot Auto 自己维护登录,是目前唯一稳定的路子。

为什么要绕 Home Assistant 这一道

这是本项目最需要解释的地方。

米家原生接口走不通了

理论上,控制米家设备有两条「直连」路:

  1. miIO 协议(局域网直连)——需要每个设备的 token
  2. 小米云 API(云端)——需要登录账号

问题是:

  • token 只能通过小米云登录才能拿到,而主流的第三方库(python-miio + micloud)用的登录流程已经被小米改掉,实测会返回
    MiCloudAccessDenied: Access denied. Did you set the correct api key and/or username?
    ——密码对也没用,是接口对不上,不是用户的问题。
  • 换 token 的老办法(抓包、root 读数据库)门槛很高,普通用户根本走不通。
  • 官方 MIoT 开放平台只对企业开放,个人拿不到。

Home Assistant 的 Xiaomi Miot 集成能过

Home Assistant(下称 HA)有一个社区集成叫 Xiaomi Miot Auto,它自己维护登录流程,跟着小米接口的变化更新。实测:

  • 账号密码能登上
  • 灯、空调、风扇、红外遥控器都能认出来
  • 实体状态实时同步

于是架构就变成:

DSH 插件  ──HTTP──▶  Home Assistant  ──Xiaomi Miot──▶  小米云 / 局域网  ──▶  设备
▲
└── 设置页(client.js)

代价:多一个 Docker 容器、约 1.5 GB 镜像、首次配置十几分钟。
收益:真的能控制,而且以后换设备、加设备,都在 HA 里点两下就行,插件不用改。


架构

┌──────────────────────────── DSH ────────────────────────────┐
│                                                             │
│  设置 → 插件 → 家庭助理          AI 对话                     │
│  ┌─────────────────────┐        ┌──────────────────────┐    │
│  │ client.js (React)   │        │ ha_status            │    │
│  │  · 地址 / 令牌       │        │ ha_entities          │    │
│  │  · 设备表格          │        │ ha_state             │    │
│  │  · 亮度滑条          │        │ ha_control           │    │
│  │  · 全部关闭          │        │ ha_light             │    │
│  └─────────┬───────────┘        │ ha_all_off           │    │
│            │ /api/ha/*          │ ha_service           │    │
│            ▼                    └──────────┬───────────┘    │
│  ┌──────────────────────────────────────┐   │                │
│  │        index.js(宿主半端)           │◀──┘                │
│  │  · HTTP 路由  · 工具注册  · 配置读写   │                    │
│  └──────────────────┬───────────────────┘                    │
└─────────────────────┼────────────────────────────────────────┘
│ Authorization: Bearer <长期令牌>
▼
┌─────────────────────────────┐
│ Home Assistant :8123        │
│  · Xiaomi Miot 集成          │
└──────────────┬──────────────┘
▼
小米云 / 局域网设备

安装

前置

  • Windows / macOS / Linux 都行(本项目在 Windows 上开发测试)
  • Docker
  • DSH(桌面版或 Web 版)
  • Node 22+

一、装 Docker

到 docker.com 下载 Docker Desktop,安装后启动,等托盘图标稳定。

验证:

docker info --format "{{.ServerVersion}}"

二、拉 Home Assistant 镜像

官方源 ghcr.io 在国内经常拉不动(实测卡住十几分钟无进展)。用镜像站:

# 南京大学镜像(推荐,实测可用)
docker pull ghcr.nju.edu.cn/home-assistant/home-assistant:stable

# 备选
docker pull ghcr.dockerproxy.com/home-assistant/home-assistant:stable
docker pull docker.m.daocloud.io/ghcr.io/home-assistant/home-assistant:stable

三、起容器

mkdir -p F:/deepseek/ha

docker run -d \
--name homeassistant \
--restart=unless-stopped \
-v F:/deepseek/ha:/config \
-e TZ=Asia/Shanghai \
-p 8123:8123 \
ghcr.nju.edu.cn/home-assistant/home-assistant:stable

Windows PowerShell 版本:

New-Item -ItemType Directory -Force -Path F:\deepseek\ha
docker run -d --name homeassistant --restart=unless-stopped `
-v F:\deepseek\ha:/config -e TZ=Asia/Shanghai -p 8123:8123 `
ghcr.nju.edu.cn/home-assistant/home-assistant:stable

等 1–3 分钟,浏览器打开 ,创建管理员账号。

四、装 Xiaomi Miot 集成

方式 A:手动放(推荐,不依赖 HACS)

# 下载(GitHub 直连可能失败,见 docs/troubleshooting.md)
curl -L -o xiaomi_miot.zip \
https://github.com/al-one/hass-xiaomi-miot/archive/refs/heads/master.zip

unzip xiaomi_miot.zip -d tmp
mkdir -p F:/deepseek/ha/custom_components
cp -r tmp/hass-xiaomi-miot-master/custom_components/xiaomi_miot \
F:/deepseek/ha/custom_components/

docker restart homeassistant

放完检查一下:F:\deepseek\ha\custom_components\xiaomi_miot\manifest.json 存在就对了。

方式 B:HACS

装 HACS → 集成里搜 Xiaomi Miot Auto → 下载 → 重启 HA。

五、绑定小米账号

  1. HA → 设置 → 设备与服务
  2. 右下角 添加集成
  3. 搜 Xiaomi Miot
  4. 选「添加小米账号」,填账号密码
  5. 等它把设备拉出来(灯、空调、红外遥控都能认)

六、拿长期令牌

  1. HA 左下角点自己的用户名
  2. 切到 安全 标签
  3. 最下面「长期访问令牌」→ 创建令牌
  4. 名字随便填(如 dsh),复制 eyJ... 那串

> 令牌等于家里设备的钥匙,别贴群里、别发截图。

七、装插件

dsh plugin --profile desktop add dsh-homeassistant

或者本地开发:

dsh plugin --profile desktop add link:F:/deepseek/dsh-homeassistant

八、在设置里填

设置 → 插件 → 家庭助理

HA 地址    http://localhost:8123
长期令牌   eyJ...

点 保存 → 测试连接。成功会显示 HA 版本 / 实体数量,下面出现设备表格。


使用

前端(设置页)

区域 能干什么
顶部 改地址、换令牌、保存、测试连接、刷新、全部关闭
分页 全部 / 灯 / 开关 / 风扇 / 空调 / 窗帘(带数量)
表格 名称、实体 id、状态(开=绿)、亮度百分比、温度
操作 开 / 关;灯还有亮度滑条,拖一下立刻生效

工具(对话里)

工具 说明 例子
ha_status 检查连通性 ha_status {}
ha_entities 列可控实体 ha_entities { domain: "light" }
ha_state 查状态 ha_state { entity: "灯" }
ha_control 开 / 关 / 切换 ha_control { entity: "灯", action: "off" }
ha_light 开关 + 亮度 + 色温 ha_light { entity: "灯", brightness: 60 }
ha_all_off 一键全关 ha_all_off {}
ha_service 任意 HA 服务 ha_service { domain:"climate", service:"set_temperature", data:{...} }

口语名

工具都支持直接说「灯」「空调」,解析顺序:

  1. aliases 配置里的别名
  2. 完整实体 id
  3. 实体「友好名称」包含
  4. 实体 id 包含

想固定映射,编辑 ~/.dsh/homeassistant/config.json:

{
"url": "http://localhost:8123",
"token": "eyJ...",
"aliases": {
"卧室灯": "light.yeelink_mbulb3_92ae_light",
"客厅灯": "light.xxx"
}
}

配置存哪

~/.dsh/homeassistant/config.json     # 地址、令牌、别名
  • 只在本机
  • 不上传、不写日志
  • 删掉这个文件等于清空配置

工作原理(想改代码的人看这里)

后端

apply(ctx) 做两件事:

  1. 注册工具:每个工具执行时读配置 → 拼 REST 请求 → 返回 JSON
  2. 挂 HTTP 路由:ctx.webServer.register({ kind: 'prefix', path: '/api/ha' }),给前端用

REST 调用统一走 request():

GET  /api/                          版本信息
GET  /api/states                    所有实体状态
GET  /api/states/        单个实体
POST /api/services//   调用服务(turn_on / turn_off / toggle ...)

前端

client.js 用 window.__ModuleLoader__.load({ id, factory }) 自注册,factory 里拿 React,
然后往 settings.section 插一个面板:

slots.inject('settings.section', () => slots.register(
{ name: 'settings.section', id: 'homeassistant', order: 46, label: '家庭助理' },
() => h(Panel),
))

面板通过 fetch('/api/ha/*') 跟后端说话,不直接碰 HA。

为什么配置不用 schemastery

配置存在自己的 JSON 文件里,不走 DSH 的 settings store——因为前端要能改完立刻生效,
而且令牌这种敏感字段不适合进统一配置。


常见问题

见 docs/troubleshooting.md。

几个高频的:

现象 原因 处理
8123 打不开 容器没起 docker ps / docker logs homeassistant
集成搜不到 Xiaomi Miot 目录放错 / 没重启 检查 custom_components/xiaomi_miot/manifest.json,docker restart homeassistant
测试连接 401 令牌无效 重新创建长期令牌
实体 unavailable 设备离线或账号掉线 HA 里重新加载集成
空调/风扇只有红外 红外遥控实体 用 climate / fan 域,不要用 light

安全说明

  • HA 只监听本机 8123,没有暴露公网
  • 令牌存本机文件,权限跟随用户目录
  • 插件不收集任何数据,不发外部请求(只打你的 HA)
  • 建议定期轮换令牌

路线图

  • [ ] 支持 HA 的「区域」分组(按房间分页)
  • [ ] 场景 / 脚本一键触发按钮
  • [ ] 定时任务(晚上 23:00 自动关灯)
  • [ ] 实体收藏置顶
  • [ ] 深色/浅色主题适配

许可

MIT,见 LICENSE。

致谢

  • Home Assistant
  • hass-xiaomi-miot
  • DeepSeek Harness 插件系统

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-homeassistant 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:huhuai-ni/dsh-homeassistant` 即可。

dsh-homeassistant 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-homeassistant 安全吗?

低风险。

dsh-homeassistant 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-homeassistant 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

工具与能力
按星标排序,可作替代方案

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

huhuai-ni 的其它插件

4 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。