前言¶
在 DeepSeek Harness（DSH）里接智能家居后端时，常见做法是把大量 HTTP 工具直接挂进默认 Agent，结果是普通会话也能看到 miloco_* 工具，Skill 被全局注入，上下文变噪。Miloco 还支持感知、规则、任务到期等主动推送；若没有在 DSH 侧做会话路由和优先级过滤，低价值感知也会占满 turn。
下面介绍社区插件 dsh-miloco-bridge（维护者 exa160）：非官方桥接，运行在 DSH Web profile，用专用 Agent 预设隔离 Miloco 工具与 Skill，并承接 Miloco → DSH 推送闭环。目录页：skillhub.cn/plugins/exa160/dsh-miloco-bridge；源码：github.com/exa160/dsh-miloco-bridge。插件以 MIT 许可发布，与小米无隶属关系。
这是什么¶
dsh-miloco-bridge 把 Xiaomi Miloco 的 2.0 HTTP API 接到 DSH：56 个原生工具与 18 个重写 Skill 只绑定预设「Miloco 家庭助手」，普通对话不暴露 Miloco 能力；设置页完成账号、推送目标、感知等级与运行模式；Miloco 侧通过 adapter 与 Bearer token 把事件推回指定 DSH 会话。
当前 npm 包版本为 0.1.1（见仓库 package.json）。DSH 侧建议 >= 0.2.1-rc.4（README 写明在 0.2.1-rc.4 实测通过），Node.js >= 22，平台为 Linux / macOS 下的 Web profile（dsh --profile web）。
核心功能¶
Agent 隔离¶
Miloco 工具与 Skill 仅挂在专用预设上。README 说明：56 个 Miloco 工具、18 个 Skill 不会进入普通会话，避免 miloco_* 干扰其他项目或对话。
能力与运行模式¶
插件覆盖设备、场景、感知、规则、任务、身份、宠物、家庭档案、通知、token 用量等 Miloco 能力。默认只读：写类工具不注册；在「设置 → 插件 → Miloco」切换到管家模式后，才暴露设备控制、规则/任务创建等写入能力。
推送闭环与感知过滤¶
Miloco 的感知事件、规则触发、任务到期可主动推送到 DSH 会话。插件按 low / medium / high 感知优先级过滤，低于阈值的感知建议不产生 DSH turn，减少无效轮次。
可视化配置与可选部署¶
配置集中在 DSH WebUI：设置 → 插件 → Miloco（账号/设备/token 概览、推送目标、感知等级、运行模式、连接与卸载）。未安装 Miloco 时也可先装插件，之后在 UI 一键部署 Miloco 或 连接已有的 Miloco；install.sh 在已有 Miloco 时可自动安装 adapter 并写入连接与推送令牌，细节见仓库 docs/INSTALL.md。
安装与启用¶
推荐从 npm 安装（命令来自 README 原文）：
dsh plugin --profile web add dsh-miloco-bridge
若 npm 包处于审核期导致 404，可使用源码安装：
dsh plugin --profile web add github:exa160/dsh-miloco-bridge
本地 bundle 或开发 link 见 README（例如 file:dist/dsh-miloco-bridge-0.1.1.tgz 或 ./install.sh --profile web）。安装后需重启 DSH Web 服务：
systemctl --user restart dsh-web.service
Miloco 侧需与 DSH 使用同一枚 Bearer token，并确认 Miloco 配置 agent.platform=dsh，推送才能进入闭环。推送入口无令牌时按 README 说明 fail closed。
典型用法¶
按 README「快速开始」可复现如下步骤：
- 打开 DSH WebUI → 设置 → 插件 → Miloco。
- 无 Miloco：点 一键部署 Miloco；已有实例：点 连接已有的 Miloco。
- 新建会话时选择预设 Miloco 家庭助手。
- 在设置页选择运行模式（只读 / 管家）、推送会话、可选模型与感知等级。
- 需要主动推送时，确认 Miloco
agent.platform=dsh且 token 与 DSH 侧一致。
Miloco HTTP API 默认 127.0.0.1:1810，也可在配置中使用局域网地址。架构、推送协议与状态文件见 docs/ARCHITECTURE.md；离线/联调验证见 docs/VERIFICATION.md。
适用场景与注意¶
适合：已在或计划使用 Miloco 2.0、希望在 DSH Web profile 里用独立预设管家庭自动化，并需要 Miloco 主动事件进入指定会话的开发者或自托管用户。
权限与风险（摘自 README）：插件会写入 $DSH_HOME（配置、状态、可选部署源码）与 $MILOCO_HOME（adapter）；访问 Miloco HTTP API；「一键部署」会运行上游 Miloco 安装器，可能安装 Python 依赖并占用磁盘。插件不含遥测、不内置账号或 token。安装前应阅读仓库源码、LICENSE、NOTICE 与 SECURITY.md：插件以当前 dsh 进程权限 运行，能力边界取决于所选运行模式与 Miloco 实例配置。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区维护的集成插件，非小米或 DSH 官方产品。
结尾¶
dsh-miloco-bridge 把 Miloco 的长工具链收进专用 Agent 预设，并在 DSH 侧完成推送接收与感知优先级过滤，适合把家庭自动化与通用对话分开管理的 Web profile 部署。
- 目录页：https://www.skillhub.cn/plugins/exa160/dsh-miloco-bridge
- GitHub：https://github.com/exa160/dsh-miloco-bridge
进一步安装、adapter、systemd 与排错见仓库 docs/INSTALL.md；56 个工具语义见 docs/TOOLS.md。
