前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。当智能体完成一个任务后，需要一种方式将结果通知给用户。原生推送通常不够直观，而直接访问手机系统的 API 开发成本较高。这个插件解决了从 DSH 代理向华为 HarmonyOS 负一屏（智慧助手·今天）推送任务完成消息的需求。
是什么¶
这是一个将任务完成消息推送到华为 HarmonyOS 负一屏服务卡片的 DSH 插件。它线缆兼容 OpenClaw today-task 技能（相同的上传端点和负载契约），意味着两者使用相同的认证方式和卡片渲染规则。插件本身不提供客户端 UI，也不依赖额外的运行时库，直接使用 Node.js 内置的 fetch 进行 HTTP 通信。
安装¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add github:Entity-Him/dsh-hiboard-push
安装完成后，重启 dsh 进程以加载插件。
配置¶
使用前需要在 HarmonyOS 手机端获取并配置授权码。
-
获取 authCode
- 在手机上打开负一屏（智慧助手·今天）。
- 进入「我的」→「动态管理」→「关联账号」→「Claw 智能体」。
- 获取并复制授权码（例如uhIzvTvjwnAD）。 -
配置授权码
使用提供的命令将授权码写入配置文件：
dsh-hiboard-auth your-auth-code
该命令会将授权码写入 ~/.dsh/hiboard-auth.env（文件权限为 600，隐藏），并确保 dsh 进程每次启动时都能读取到该凭证。
- 重启服务
执行完配置命令后，重启 dsh 以使设置生效。
核心功能¶
插件注册了两个工具供智能体调用。
hiboard_push¶
用于推送任务卡片。参数说明如下：
| 参数 | 必需 | 说明 |
|---|---|---|
name |
✅ | 任务名称，作为卡片标题、scheduleTaskName 和 summary。 |
content |
✅ | Markdown 格式的正文内容（≤ 5000 字符），将原样渲染在卡片上。 |
result |
❌ | 结果摘要/状态标签，默认为 任务已完成。 |
schedule_id |
❌ | 周期性任务 ID，保持相同的 ID 可将重复卡片聚合。 |
dry_run |
❌ | 布尔值，设为 true 时仅构建和验证载荷，不发送实际卡片。 |
hiboard_verify¶
用于测试连接。调用此工具会在手机负一屏收到一张“dsh 连接测试”卡片，用于验证 authCode 和网络链路是否通畅。
注意事项¶
- 安全风险：authCode 是个人凭证，持有该码的任何人都可以向你的负一屏推送卡片。切勿将其粘贴到群聊或提交到代码仓库。
- 兼容性：由于使用与 OpenClaw 相同的端点，如果你之前配置过 OpenClaw，可以直接复用其 authCode。
- 存储位置：授权码仅存储在本地文件
~/.dsh/hiboard-auth.env中。
