DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-mihome

J

dsh-mihome

Manifest valid

DeepSeek Harness plugin: control Mi Home (米家) devices through mijiaAPI — device tiles, device detail pages, scenes and consumables in a sidebar workbench. · 通过 mijiaAPI 控制米家设备的 DSH 插件,侧栏工作台复刻米家 App 的设

UI (client)hasBundlePatch

dsh-mihome

DeepSeek Harness 插件:通过 mijiaAPI 控制小米米家设备。

插件本体是 Node(Cordis 插件),米家协议栈是 Python。两者之间是一个常驻的 JSON-Lines 桥接进程:Node 侧往 stdin 写一行请求,Python 侧从 stdout 回一行响应。

选这个形状的原因是米家登录(账号扫码、token 刷新、设备 spec 解析、属性加密) 已经有成熟实现在 mijiaAPI 里,在 Node 里重写等于重做整套协议;而 DSH 插件生态 是 Node 的。桥接只用 app.core.service 一层——上游的 app.ui 与 app.core.jobs 都 import PySide6,但米家控制本身不需要 Qt,所以插件不必拖 200 MB 的 Qt 运行时。

侧栏工作台

侧栏「全局面板」里有一个米家入口(sidebar.panellist 一行 + 同名 main 面板)。 面板打开后按 家庭 / 房间 分组列出设备卡:点开卡片能看属性、改枚举/范围/开关、 执行动作、切电源;顶部还有场景按钮与耗材汇总;未登录时面板里直接出二维码扫码登录。

前端在 client.js,后端在 lib/panel.js(前缀 /dsh-mihome/api),两者都通过桥接 进程取数。登录长轮询最长约 2 分钟,会独占一个桥接进程,所以面板用了第二个独立桥接 loginBridge——否则扫码期间设备列表和开关全排队超时。

目录

路径内容
lib/index.js(工具注册)、bridge.js(JSON-Lines 客户端)、panel.js(Web 路由)、format.js(文本渲染)
client.jsWeb UI 面板(window.__ModuleLoader__.load)
python/MiHome-Windows 源码副本 + mihome_bridge.py(桥接入口)
_upstream/MiHome-Windows 的原始 git 克隆,供对照与升级
_probe/开发期登录/二维码探针脚本,运行时不使用
locale/zh.json / en.json(面板标题与描述)
tests/bridge.test.js(node --test)
data/运行时数据:qr/ 下的二维码 PNG

提供的工具

工具作用
mihome_loginstart 出二维码 / poll 等扫码结果 / status 查登录态
mihome_devices列出全部设备(did、名称、型号、家庭、房间、在线状态)
mihome_device单台设备规格:可读写属性、取值范围、可执行动作
mihome_controlread / write / action / power 四种模式控制设备
mihome_sceneslist 列出场景 / run 执行场景
mihome_sensorsmetrics 读温湿度等外显值 / consumables 汇总耗材余量

did 是后续所有操作的键,从 mihome_devices 拿。

安装

插件目录需要一份 Python 虚拟环境和两个依赖(python/ 是 MiHome-Windows 的源码副本):

cd <插件目录>
python -m venv .venv
.venv\Scripts\python.exe -m pip install "mijiaAPI>=5,<6" "qrcode>=8"

然后接入 profile:在 <profile>/node_modules 下建指向本目录的符号链接, 并在 <profile>/package.json 的 dependencies 与 dsh.profile.bundles 里各加一条:

"dsh-mihome": "link:E:/DSHWORK/DSH插件/dsh-mihome"

登录

米家凭据由 mijiaAPI 存在 ~/.config/mijia-api/auth.json(与 mijiaAPI 命令行共用)。 插件不复制也不改写它。第一次用 mihome_login(action=start) 出二维码,手机米家 APP 扫码确认后 action=poll 收结果。

二维码同时给两种形态:字符二维码(纯文本会话里直接能扫)和 PNG 文件 (路径随结果返回,落在 <dataDir>/qr/mihome-login-<ticket前16位>-<毫秒>.png)。

文件名必须带 ticket 和毫秒:早期版本写固定文件名,GUI 按路径缓存,用户反复扫到 第一张早就过期的码,现象就是「一生成就过期」。另一个必要条件是生成后立刻挂长轮询, 不能等用户说"扫了"才 poll。

配置

在 profile 的 cordis.patch.yml 里覆盖 <profile 的 bundle patch 行>:

- id: mihome
  config:
    pythonPath: ''      # 留空 = 插件自带 .venv
    dataDir: ''         # 留空 = <插件目录>/data
    requestTimeoutMs: 30000
    loginTimeoutMs: 150000

测试

# 桥接协议与错误分类,不需要米家账号(未登录本身就是常态)
node --test tests/bridge.test.js

# 校验 client.js 的 i18n:zh/en 键集合一致、用到的键都存在
node scripts/check-i18n.mjs client.js

# 无浏览器渲染冒烟:把面板渲染成 HTML 并断言关键文案
node scripts/render-smoke.mjs client.js

render-smoke 用最小 React 替身 + 假 fetch 在 vm 里跑 client.js,覆盖首页磁贴、 设备详情页、场景页、耗材页四处,是改前端后唯一能在无浏览器环境里验证的闸门。 产物写到 scripts/.out/。

许可

插件代码 GPL-3.0-or-later;python/ 目录是 MiHome-Windows 的源码副本,同样 GPL-3.0-or-later,必须保持同许可。米家协议实现来自 mijiaAPI。

Comments

Loading…

Similar plugins

dsh-miloco

by Lzm1645

DeepSeek Harness 插件:小米 Miloco(米家)设备工具 + 本地控制面板

Manifest valid

★ 0

MIT

JavaScript

Nov 20, 2026

dsh plugin --profile web add dsh-miloco

by KKUCODES

Desktop plugin for DeepSeek Harness that connects DSHM to computer sessions, with device pairing, access control, and synchronized chat.

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Nov 14, 2026

dsh plugin --profile web add @dsh-mobile/plugin

by Amouren7

DeepSeek Harness 插件管家:在「设置 → 插件」新增标签页,用人话说明每个插件是做什么的,提供一键停用/启用(热生效)与安全卸载;同一页的「技能」分段盘点所有技能、标明唯一可用的触发方式,并给出两个真开关(模型自动加载 / 斜杠命令)。Plugin and skill manager for DeepSeek Harness: plain-language catalogs, one-click hot enable/disable, rollback-guarded uninstall, and per-skill invocation switches.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Sep 11, 2026

dsh plugin --profile web add dsh-plugin-desk

by TYOPXN360

DeepSeek Harness 一体化移动端外壳插件:手机窄屏侧边栏抽屉(标题前按钮 + 全局右滑唤出)+ 可安装 PWA(DeepSeek Assistant)。桌面布局零改动,不改动其他插件代码。

Manifest valid

★ 0

GPL-3.0

JavaScript

Nov 9, 2026

dsh plugin --profile web add dsh-mobile-shell

by 2768651338

DeepSeek Harness 的图形化插件管理插件:在 设置 → 插件 里新增「插件管家」标签页,用中文名和说明展示每个插件是做什么的,并提供一键启停开关与内置备注编辑——启停写入全局层补丁并实时热生效,备注保存到本地覆盖文件长期生效。

UI & ExperienceManifest valid

★ 9

MIT

JavaScript

Oct 20, 2026

dsh plugin --profile web add @2768651338/dsh-plugin-manager

by Hjay1101

DeepSeek Harness 插件:手机扫码遥控电脑上的 agent —— 在 dsh-remote-link 基础上增强会话持久化(dsh 重启后已配对设备保持登录)、iOS 主屏图标等

Manifest valid

★ 0

MIT

JavaScript

Aug 23, 2026

dsh plugin --profile web add dsh-ios-control