dsh-mihome
面向 DeepSeek Harness 代理的 Mi Home (米家) 控制——列出家庭和设备、读取属性，并在人工审批机制下控制设备。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:SiriusWJ/dsh-mihome#e52349e75bba915db860ccbd849aa4cca2dcf446Mihome 以 dsh-mihome 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →
Mi Home (米家) control for DeepSeek Harness agents.
List homes/devices · read props · control devices — every state-changing call stops behind a human approval gate.
中文 · ·
mi_health — connection check (account, region, home/device counts)mi_list_homes — homes and roomsmi_list_devices — devices with category/online status, filterablemi_get_state — one device's common props (power, brightness, temperature, humidity, …)mi_turn — set_power on/off (approval-gated)mi_control — any miIO/raw_command (set_bright, set_properties/MIoT, …) (approval-gated)mi_wait_for_state — poll a property until it reaches/leaves a statemi_dashboard — full-home snapshot rendered as a live dashboard card in the Web UI (grouped by category, rooms, recent changes)All state-changing calls go through the harness approval seam (requireApproval defaults to true) plus an optional category allowlist (allowedCategories). When the category cannot be resolved, the call is denied (least privilege).
Requires dsh ≥ 0.1.0-rc.7 (verified against 0.1.1-rc.2).
dsh plugin --profile web add dsh-mihome # from npm (recommended)
# or: dsh plugin --profile web add github:<owner>/dsh-mihome
Restart dsh --profile web afterwards. Manage it in Settings → Plugins.
git clone https://github.com/<owner>/dsh-mihome
cd dsh-mihome && pnpm install && pnpm demo:mi # fake Mi Home Cloud on http://127.0.0.1:8125
- id: mihome
config:
mode: demo
baseUrl: http://127.0.0.1:8125
Then in DSH: "check Mi Home and list all devices", "turn the bedroom light to 60 brightness" (an approval popup appears; after approving, mi_get_state confirms brightness: 60). Open docs/demo.html to see the full UI without starting dsh at all — simulation chat, approval dialog and a live console connected to the emulator.
Paste-ready configs (demo / real cloud / no approval) are in examples/cordis.patch.yml.
MIHOME_USERNAME=<mi-account> MIHOME_PASSWORD=<mi-password> dsh --profile web
- id: mihome
config:
mode: cloud
region: cn # cn / de / ru / us / tw / sg / in …
usernameEnv: MIHOME_USERNAME
passwordEnv: MIHOME_PASSWORD
requireApproval: true
allowedCategories: [light, outlet, climate] # optional allowlist
Credentials resolve through the harness credentials seam on every request (process env → .env fallback), so rotating them takes effect on the next call.
The cloud adapter implements the community-documented Xiaomi Mi Home app API:
account.xiaomi.com/pass/serviceLogin → serviceLoginAuth2 (sid=xiaomiio, md5(password) uppercased) → STS redirect sets serviceToken / ssecurity.https://api.io.mi.com/app/<method> with nonce/signed-nonce (sha256(ssecurity + nonce)), RC4-encrypted params + sha1 signature for v2/*, and hmac-sha256 signature for miIO/raw_command.This is a non-official protocol (see Xiaomi-cloud-tokens-extractor / python-miio for the community-proven flow) and may change if Xiaomi updates the app. Accounts requiring captcha/2FA at login are reported with a clear error instead of an obscure failure.
pnpm install
pnpm typecheck && pnpm build && pnpm test # signatures/crypto + demo-server e2e
Zero runtime dependencies on the host side: Node built-in crypto/fetch only.
MIT