dsh-harmonyos-hiboard 0.7.0 → 0.7.1

package/README.md

@@ -142,7 +142,8 @@ dsh plugin --profile web add "file:<不含空格的路径>"
 
 **2) 填授权码** —— 两种方式，任选其一。
 
-**方式 A（推荐）：图形界面。** 重启 dsh 后打开 **设置 → 插件 → `dsh-harmonyos-hiboard`**，
+**方式 A（推荐）：图形界面。** 重启 dsh 后打开 **主界面左侧栏的「插件」面板 →
+`dsh-harmonyos-hiboard` → 点进它的页面**（**不在「设置」里**，见下方「设置卡片」一节），
 在「推送设置」卡片里填写。输入框**两种写法都认**：
 
 ```text
@@ -199,14 +200,30 @@ L2 抢救"承诺了却没调用"、L3 按错误类别重试并自动补 `schedul
 
 ---
 
-## 设置页（插件卡片）
+## 设置卡片（在「插件」面板里）
 
-打开 **设置 → 插件 → `dsh-harmonyos-hiboard`**，卡片提供两件事：
+打开 **主界面左侧栏的「插件」面板 → `dsh-harmonyos-hiboard` → 点进它的页面**，
+「推送设置」卡片就在简介与条目行之间。
+
+> **注意不是「设置」里。** dsh 的设置导航里那个「内置插件」页只提供只读清单与市场页签，
+> 它**不声明** `plugins.bundle.config` 插槽 —— 这条卡片永远不可能出现在那里。
+> 承载配置卡片的是 `dsh-client-ui-plugin-manager`（侧栏面板 id `plugins`，文案「插件」），
+> 本插件与 modsearch 的卡片都在同一个位置。
+> 新装或升级后如果没看到卡片，**先刷新页面**；**版本升级还需重启 dsh**（已挂载的插件不会被热替换）。
+
+卡片提供三件事：
 
 1. **授权码输入框** —— 裸授权码与整条关联指令都认（自动取末尾的码），保存前显示打码预览，
    保存后**立即生效**；卡片还显示**当前生效来源**（设置页 / 补丁层 / 环境变量），
    避免"改了一处却不生效"。点「清除」删掉设置页那份，回退到下一层。
 2. **推送兜底开关** —— **默认开启**，关掉**立即生效**（不必重启）。
+   文案里也直说了：建议保持开启。
+3. **兜底战绩** —— 列出**「原本没推出去、但兜底救回来了」**的次数与最近几次，
+   数据来自兜底自己的审计流水（`<状态目录>/audit.jsonl`）：
+   - `retry-ok`：工具真的调用了但失败，按错误类别重试后成功
+   - `rescue-ok`：根本没调用工具（写成纯文本 / 只承诺没做），兜底代为补推
+
+   这个面板的意义是：以前"保险丝到底有没有干活"只能靠猜，现在直接列给你看。
 
 配置写在 `<用户目录>/.dsh/hiboard-push/config.json`（0600，先写临时文件再原子替换）。
 该文件属于当前系统用户，本机所有 dsh profile 共用一份。
@@ -358,6 +375,35 @@ npm test
 
 ---
 
+## 新环境部署清单（怎么对齐到「每轮都推送」）
+
+换一台电脑、或让别人从零装一遍，**装完插件只是一半**。完整清单：
+
+| # | 做什么 | 不做会怎样 |
+|---|---|---|
+| 1 | 装插件：`dsh plugin --profile web add dsh-harmonyos-hiboard` | 没有工具 |
+| 2 | 配授权码（设置卡片，或 profile 补丁层） | 调用时报「未配置授权码」 |
+| 3 | **把推送规则写进 `~/.dsh/AGENTS.md`** | 功能在，但**没人调用它** —— 每轮都不会推 |
+| 4 | 重启 dsh | 新装/升级的插件不生效（升级不会热替换已挂载插件） |
+
+第 3 步的现成模板见 **[`docs/AGENTS-rule.md`](docs/AGENTS-rule.md)**：dsh 由
+`dsh-agent-instructions` 在**每个会话**自动加载 `$DSH_HOME/AGENTS.md`，写在那里就是全局生效。
+
+> ⚠️ **「每轮必定推送」不是插件能保证的事，要如实理解。**
+> `hiboard_push` 是一个**工具**，工具不会自己调用 —— 调不调用由模型按指令决定。
+> 内置兜底把「漏推」的概率压得很低，但它是**启发式**，不是硬保证：
+> - L1/L2 需要正文里**看得出推送意图**才会补推（保守优先，宁可少推也不乱推）；
+> - L3 只对**可重试**的失败生效（授权码无效、内容超长这类永久错误不重试）；
+> - 授权码未配置、或端点处于坏窗口且重试预算用尽时，仍然推不出去。
+>
+> 准确的表述是：**规则 + 兜底让「每轮都推」在实践上基本成立**，而不是被保证。
+
+**不必迁移、与本插件无关的东西**：本机网络入口（局域网 3081 / tailnet 8443 / 公网 18443）、
+token 广播、Steam++ 之类的 hosts 加速器 —— 那些属于本机环境。
+本插件只需要：Node 18+、pnpm、一台能取到授权码的华为手机。
+
+---
+
 ## 兼容性
 
 | 组件 | 版本 |

package/docs/DEPLOY.md

@@ -51,7 +51,8 @@ dsh plugin --profile web add "file:E:/dsh-vendor/dsh-harmonyos-hiboard"
 
 ## 第 3 步：写入授权码
 
-**推荐做法（图形界面）**：不用命令行 —— 打开 **设置 → 插件 → `dsh-harmonyos-hiboard`**，
+**推荐做法（图形界面）**：不用命令行 —— 打开 **主界面侧栏的「插件」面板 →
+`dsh-harmonyos-hiboard` → 点进它的页面**（**不在「设置」里**，见 README「设置卡片」一节），
 在「推送设置」卡片里填。输入框**裸授权码**和**整条关联指令**
 （`openclaw config set skills.entries.today-task.config.authCode <AUTH_CODE>`）都认，
 保存后立即生效，并显示当前生效来源。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-harmonyos-hiboard",
-  "version": "0.7.0",
-  "description": "把 dsh 的任务结果推送到华为鸿蒙负一屏服务卡片；设置页可直接粘贴关联指令；内置推送兜底，默认开启。 ｜ Push dsh task results to Huawei HarmonyOS assistant-today cards, with a settings card and a push safety net that is on by default.",
+  "version": "0.7.1",
+  "description": "把DSH的任务结果，以服务卡片形式推送到华为鸿蒙负一屏\nPush DSH task results to the Huawei HarmonyOS assistant-today screen as service cards.",
   "author": "Jim Chen",
   "license": "MIT",
   "repository": {

package/src/lib/index.js

@@ -348,7 +348,7 @@ function hiboardPushTool({ resolveAuthCode, settings }) {
 			const authCode = resolveAuthCode();
 			if (!authCode) {
 				throw new Error(
-					"hiboard_push: 未配置授权码（authCode）。请在 dsh 的「插件」页打开本插件的设置卡片填写" +
+					"hiboard_push: 未配置授权码（authCode）。请打开 dsh 侧栏的「插件」面板 → 本插件 → 在「推送设置」卡片里填写" +
 					"（支持整条关联指令或裸授权码），或写进 profile 补丁层 hiboard-push.config.authCode，" +
 					`或设置环境变量 ${AUTH_CODE_ENV}。授权码获取：负一屏 → 我的 → 动态管理 → 关联账号 → Claw 智能体。`
 				);
@@ -388,7 +388,7 @@ function hiboardVerifyTool({ resolveAuthCode, settings }) {
 			const authCode = resolveAuthCode();
 			if (!authCode) {
 				throw new Error(
-					"hiboard_verify: 未配置授权码（authCode）。请在 dsh 的「插件」页打开本插件的设置卡片填写" +
+					"hiboard_verify: 未配置授权码（authCode）。请打开 dsh 侧栏的「插件」面板 → 本插件 → 在「推送设置」卡片里填写" +
 					"（支持整条关联指令或裸授权码），或写进 profile 补丁层 hiboard-push.config.authCode，" +
 					`或设置环境变量 ${AUTH_CODE_ENV}。授权码获取：负一屏 → 我的 → 动态管理 → 关联账号 → Claw 智能体。`
 				);