前言¶
DeepSeek Harness (DSH) 的插件化架构允许智能体扩展功能，调用外部服务。对于需要将执行结果实时同步到手机的用户来说，将消息推送到华为负一屏（“Today” / 智慧助手·今天）是一个典型需求。此插件通过 DSH 代理将任务完成消息转化为负一屏的服务卡片，解决了智能体与手机端信息同步的问题。
插件简介¶
这是 entity-him/dsh-hiboard-push 插件。它用于从 DeepSeek Harness (DSH) 代理向华为 HarmonyOS 负一屏推送任务完成消息作为服务卡片。该插件与 OpenClaw 的 today-task 技能 wire 兼容，使用相同的上传端点、载荷协议和卡片渲染规则，因此复用相同的 authCode 即可。
安装¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add github:Entity-Him/dsh-hiboard-push
配置连接¶
插件使用华为负一屏的 authCode 进行身份验证。配置步骤如下：
-
在手机上获取
authCode：
- 打开负一屏（assistant-today）。
- 进入“我的” → “动态管理” → “关联账号” → “Claw 智能体”。
- 复制显示的授权代码。 -
在终端中配置该代码：
dsh-hiboard-auth your-auth-code
该命令会将代码写入 ~/.dsh/hiboard-auth.env（文件权限为 600）。
或者，直接设置环境变量：
export DSH_HIBOARD_AUTH_CODE=your-auth-code
配置后需重启 DSH 进程以生效。
核心功能¶
插件注册了两个工具，用于发送卡片和验证连接。
hiboard_push¶
该工具用于构建并发送任务卡片。参数说明如下：
| 参数 | 必填 | 描述 |
|---|---|---|
name |
✅ | 任务名称，作为卡片标题、scheduleTaskName 和 summary。 |
content |
✅ | Markdown 格式的正文内容（≤ 5000 字符），将原样渲染在卡片上。 |
result |
❌ | 结果摘要/状态标签，默认为“任务已完成”。 |
schedule_id |
❌ | 周期任务 ID，保持相同 ID 可将重复卡片归类。 |
dry_run |
❌ | 模拟构建并验证载荷，不发送消息（无需 authCode）。 |
卡片样式根据参数填充情况变化：
* 标准任务卡片：包含 name、content、result。
* 周期任务卡片：在标准卡片基础上包含 schedule_id。
* 仅摘要卡片：仅包含 name 和 result，不含 content。
hiboard_verify¶
该工具用于端到端的连接测试，发送一张名为“dsh 连接测试”的卡片，用于确认 authCode 和网络路径有效。
典型用法¶
- 连接测试：在 DSH 聊天中调用工具验证配置：
call hiboard_verify
如果手机收到“dsh 连接测试”卡片，说明配置成功。
- 任务推送：在智能体逻辑中调用
hiboard_push。
call hiboard_push with name="代码审查", content="# 审查结果\n通过", result="已完成"
此后，卡片会出现在手机的负一屏卡片流中。
注意事项¶
- 凭证安全：
authCode是个人凭证，持有该代码的人可以向你的负一屏推送卡片。请勿将其粘贴到群聊或提交到代码仓库。 - Markdown 限制：
content字段的 Markdown 内容长度不能超过 5000 字符。 - 运行权限：插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证（MIT）。
- 依赖：插件不包含客户端 UI，底层使用 Node.js 内置的
fetch进行 HTTP 通信。
总结¶
该插件为 DSH 代理提供了一个直接将任务结果推送到华为负一屏的途径。通过 hiboard_push 和 hiboard_verify 工具，开发者可以方便地实现任务状态的可视化通知。更多细节可参考 GitHub 仓库。
