dsh-harmonyos-hiboard 0.7.2 → 0.9.0

package/README.md

@@ -230,6 +230,27 @@ L2 抢救"承诺了却没调用"、L3 按错误类别重试并自动补 `schedul
 
    这个面板的意义是：以前"保险丝到底有没有干活"只能靠猜，现在直接列给你看。
 
+4. **常驻推送规则**（默认开启）—— **保存授权码时，会把「每轮回答都要推送」自动写进
+   全局指令文件 `$DSH_HOME/AGENTS.md`**，这样「一键安装 + 粘一次授权码」之后就不必再
+   手改任何文件，新会话立刻按规则推送。
+
+   > ⚠️ **这是本插件唯一会改动你已有文件的行为，且明确声明在此。** 具体约束：
+   > - 规则被 **BEGIN/END 标记**包裹，插件**只改标记之间那一段**，标记之外一个字节都不动；
+   > - **幂等**：重复保存不会产生第二份规则；
+   > - **首次改动前自动备份** `AGENTS.md.bak-hiboard-<时间戳>`（只备份一次）；
+   > - **检测到你已手写过推送规则就完全跳过**，并如实提示，而不是硬塞第二份；
+   > - 卡片上那颗开关可以**一键移除**该段（其余内容原样保留），关掉后再保存授权码也不会重新写入。
+
+   **为什么必须写这个文件**：dsh 的 `dsh-agent-instructions` 每个会话都加载
+   `$DSH_HOME/AGENTS.md`，而且**只认这一个全局文件** —— `.local` 叠加（`AGENTS.local.md`）
+   只在**项目目录**的祖先链里生效，全局那段代码写死了只探测 `AGENTS.md`。
+   （`agent/pre-step` 注入要拼宿主内部消息形状，在预览版上太脆，所以没有采用。）
+
+   > **授权码仍然必须手动粘一次**，这一点无法自动化：它是你在手机上
+   > 「负一屏 → 我的 → 动态管理 → 关联账号 → Claw 智能体」取到的**个人凭据**，
+   > 任何插件都不可能凭空得到它。所以准确说法是：安装后规则自动就位，
+   > 你只需**在卡片里粘一次授权码**。
+
 配置写在 `<用户目录>/.dsh/hiboard-push/config.json`（0600，先写临时文件再原子替换）。
 该文件属于当前系统用户，本机所有 dsh profile 共用一份。
 
@@ -388,7 +409,7 @@ npm test
 |---|---|---|
 | 1 | 装插件：`dsh plugin --profile web add dsh-harmonyos-hiboard` | 没有工具 |
 | 2 | 配授权码（设置卡片，或 profile 补丁层） | 调用时报「未配置授权码」 |
-| 3 | **把推送规则写进 `~/.dsh/AGENTS.md`** | 功能在，但**没人调用它** —— 每轮都不会推 |
+| 3 | 保存授权码 —— 插件会把推送规则**自动**写进 `~/.dsh/AGENTS.md`（默认开启、可一键关掉） | 功能在，但**没人调用它** —— 每轮都不会推 |
 | 4 | 重启 dsh | 新装/升级的插件不生效（升级不会热替换已挂载插件） |
 
 第 3 步的现成模板见 **[`docs/AGENTS-rule.md`](docs/AGENTS-rule.md)**：dsh 由

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-harmonyos-hiboard",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "把DSH的任务结果，以服务卡片形式推送到华为鸿蒙负一屏 ｜ Push DSH task results to the Huawei HarmonyOS assistant-today screen as service cards.",
   "author": "Jim Chen",
   "license": "MIT",

package/src/lib/agents-rule.js

@@ -0,0 +1,145 @@
+/**
+ * 常驻推送规则：把「每轮回答都要推送」写进 dsh 的全局指令文件。
+ *
+ * ## 为什么必须动这个文件
+ *
+ * dsh 的 `dsh-agent-instructions` 在每个会话自动加载 `$DSH_HOME/AGENTS.md`。
+ * 它**只认这一个全局文件** —— `.local` 叠加（`AGENTS.local.md`）只在**项目目录**的
+ * 祖先链里生效，全局那段代码写死了只探测 `AGENTS.md`（见 dsh-agent-instructions
+ * 的 `discoverInstructionFiles`）。所以想让规则对所有会话、所有项目生效，
+ * 除了写这个文件没有第二条路（`agent/pre-step` 注入要拼宿主内部消息形状，预览版上太脆）。
+ *
+ * ## 安全约定（每一条都是必须的）
+ *
+ * 1. **只改自己那一段**：规则块由 BEGIN/END 标记包裹，标记之外一个字节都不碰。
+ * 2. **幂等**：标记已存在就原地替换；重复调用不会产生第二份规则。
+ * 3. **不覆盖用户手写的规则**：文件里已有等价规则（非标记块）时**直接跳过**，
+ *    并如实报告，而不是硬塞一份重复的。
+ * 4. **首次改动前备份**：`AGENTS.md.bak-hiboard-<时间戳>`，且只备份一次，不刷屏。
+ * 5. **可一键移除**：`removeRule()` 把标记块整段删掉，其余内容原样保留。
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, readdirSync } from "node:fs";
+import { basename, dirname } from "node:path";
+
+/** 规则块的起止标记。改这里等于改契约，不要动。 */
+export const RULE_BEGIN = "<!-- BEGIN dsh-harmonyos-hiboard (managed block; the plugin rewrites this region) -->";
+export const RULE_END = "<!-- END dsh-harmonyos-hiboard -->";
+
+/** 规则块正文。中英并列：dsh 的全局文件对所有会话生效，读者可能是任意语言。 */
+export function buildRuleBlock() {
+	return [
+		RULE_BEGIN,
+		"## 强制要求：每轮回答都要推送到手机负一屏",
+		"",
+		"1. 给出最终回答时，调用 `hiboard_push` 推送本轮的详细结论。",
+		"2. **必须传 `schedule_id`**（例如 `dsh_worklog`）—— 它为空时卡片只有一行标题、正文不渲染、也点不开。",
+		"3. `content` 用 Markdown，**上限 5000 字符**；超长就推精简版，并在开头注明被截断，完整内容留在对话里。",
+		"4. `result` 是状态标签，默认「任务已完成」。",
+		"5. 本轮确实没有实质输出时，也推一张简短卡片，不要跳过。",
+		"6. 推送失败要写明原因（未配置授权码 / 接口不通），不要静默略过。",
+		"",
+		"> Every turn must push: call `hiboard_push` with a non-empty `schedule_id`; Markdown body is",
+		"> capped at 5000 characters; push a short card even on a thin turn; never fail silently.",
+		"",
+		"（本段由 dsh-harmonyos-hiboard 维护，可在插件的设置卡片里一键关闭与移除。）",
+		RULE_END
+	].join("\n");
+}
+
+/** 判定文件里是否已存在「等价规则」（非本插件标记块）。 */
+export function looksLikePushRule(text) {
+	if (!/hiboard_push/.test(text)) return false;
+	return /(每轮|每一轮|每次|每一条|必须)[^\n]{0,24}(推|发送|推送)/.test(text) || /every\s+(turn|reply|response)/i.test(text);
+}
+
+function readText(file) {
+	try {
+		return readFileSync(file, "utf8");
+	} catch {
+		return "";
+	}
+}
+
+function hasBackup(file) {
+	try {
+		return readdirSync(dirname(file)).some((name) => name.startsWith(`${basename(file)}.bak-hiboard-`));
+	} catch {
+		return false;
+	}
+}
+
+/** 原子写入；`backup` 为真且尚无备份时，先留一份原件。 */
+function writeText(file, text, { backup = false } = {}) {
+	mkdirSync(dirname(file), { recursive: true });
+	if (backup && existsSync(file) && !hasBackup(file)) {
+		try {
+			copyFileSync(file, `${file}.bak-hiboard-${new Date().toISOString().replace(/[-:T]/g, "").slice(0, 15)}`);
+		} catch {
+			/* 备份失败不阻止写入：用户要的是规则生效，不是备份成功 */
+		}
+	}
+	const tmp = `${file}.${process.pid}.tmp`;
+	writeFileSync(tmp, text, "utf8");
+	renameSync(tmp, file);
+}
+
+/** 用新块替换旧块（保留前后一切内容）。 */
+function replaceBlock(text, block) {
+	const start = text.indexOf(RULE_BEGIN);
+	const end = text.indexOf(RULE_END);
+	if (start < 0 || end < 0 || end < start) return text;
+	return `${text.slice(0, start)}${block}${text.slice(end + RULE_END.length)}`;
+}
+
+/** 状态：文件在哪、有没有我们的块、有没有用户自己写的等价规则。 */
+export function ruleStatus(file) {
+	const text = readText(file);
+	const hasBlock = text.includes(RULE_BEGIN) && text.includes(RULE_END);
+	return {
+		file,
+		exists: existsSync(file),
+		block: hasBlock,
+		customRule: !hasBlock && looksLikePushRule(text)
+	};
+}
+
+/**
+ * 确保规则就位（幂等）。
+ * @returns {{action: 'added'|'updated'|'unchanged'|'skipped-custom', status: object}}
+ */
+export function ensureRule(file) {
+	const block = buildRuleBlock();
+	const before = readText(file);
+	const hasBlock = before.includes(RULE_BEGIN) && before.includes(RULE_END);
+
+	if (hasBlock) {
+		const next = replaceBlock(before, block);
+		if (next === before) return { action: "unchanged", status: ruleStatus(file) };
+		writeText(file, next);
+		return { action: "updated", status: ruleStatus(file) };
+	}
+
+	// 用户自己已经写过等价规则 → 不硬塞第二份
+	if (looksLikePushRule(before)) return { action: "skipped-custom", status: ruleStatus(file) };
+
+	const body = before.replace(/\s*$/, "");
+	const next = body ? `${body}\n\n${block}\n` : `${block}\n`;
+	writeText(file, next, { backup: true });
+	return { action: "added", status: ruleStatus(file) };
+}
+
+/**
+ * 移除规则块（只删标记之间那一段）。
+ * @returns {{action: 'removed'|'absent', status: object}}
+ */
+export function removeRule(file) {
+	const before = readText(file);
+	if (!before.includes(RULE_BEGIN)) return { action: "absent", status: ruleStatus(file) };
+	const start = before.indexOf(RULE_BEGIN);
+	const end = before.indexOf(RULE_END);
+	let next = `${before.slice(0, start)}${before.slice(end + RULE_END.length)}`;
+	// 清掉移除后留下的空行堆，但不动其它内容
+	next = next.replace(/\n{3,}/g, "\n\n").replace(/^\s*\n/, "");
+	writeText(file, next);
+	return { action: "removed", status: ruleStatus(file) };
+}

package/src/lib/client.js

@@ -95,6 +95,19 @@ window.__ModuleLoader__.load({
         guardBudget: function (g) {
           return '重试预算：确定未送达 ' + g.retryCount + ' 次 / 可能已送达 ' + g.ambiguousRetryCount + ' 次　·　schedule_id 兜底：' + g.defaultScheduleId;
         },
+        ruleTitle: '每轮对话推送',
+        ruleOn: '已启用',
+        ruleOff: '未启用',
+        ruleHint: '保存授权码时，会自动把「每轮都要推送」写进全局指令文件 AGENTS.md（带标记、可随时移除），新会话即生效。',
+        ruleCustom: '检测到你已手写过推送规则 —— 插件不会改动你的 AGENTS.md。',
+        ruleBlockPresent: 'AGENTS.md 里已有本插件维护的规则段（带标记；关掉即可移除）。',
+        sourceTitle: '推送源名称',
+        sourceCurrent: function (v) {
+          return '当前生效：' + v;
+        },
+        sourcePlaceholder: 'DeepSeek Harness',
+        sourceHint: '负一屏卡片上显示的「来源 / AI 工具名」。改这里，本机所有推送（含启动卡片）会一起改用同一个名称。输入框留空并保存即恢复默认。',
+        sourceReset: '恢复默认',
         debugTitle: '兜底战绩',
         debugSummary: function (c) {
           return '已救回 ' + (c.retryOk + c.rescueOk) + ' 次（重试 ' + c.retryOk + ' · 补推 ' + c.rescueOk + '）';
@@ -138,6 +151,19 @@ window.__ModuleLoader__.load({
         guardBudget: function (g) {
           return 'Retry budget: definitely-undelivered ' + g.retryCount + ' / possibly-delivered ' + g.ambiguousRetryCount + '　·　schedule_id fallback: ' + g.defaultScheduleId;
         },
+        ruleTitle: 'Push every turn',
+        ruleOn: 'enabled',
+        ruleOff: 'disabled',
+        ruleHint: 'Saving the authCode also writes an "every turn must push" rule into your global instruction file AGENTS.md (marker-delimited, removable); new sessions pick it up.',
+        ruleCustom: 'You already wrote a push rule by hand, so this plugin leaves AGENTS.md untouched.',
+        ruleBlockPresent: "AGENTS.md already carries this plugin's rule block (marker-delimited; switch this off to remove it).",
+        sourceTitle: 'Push source name',
+        sourceCurrent: function (v) {
+          return 'Currently: ' + v;
+        },
+        sourcePlaceholder: 'DeepSeek Harness',
+        sourceHint: 'The brand / AI tool name shown on the card. Changing it moves every push on this machine (including the startup card) to the same name. Save an empty value to restore the default.',
+        sourceReset: 'Reset',
         debugTitle: 'Rescues so far',
         debugSummary: function (c) {
           return 'Saved ' + (c.retryOk + c.rescueOk) + ' (retries ' + c.retryOk + ', pushes ' + c.rescueOk + ')';
@@ -264,6 +290,7 @@ window.__ModuleLoader__.load({
         var info = summary.data && summary.data.authCode;
         var guard = summary.data && summary.data.guard;
         var audit = summary.data && summary.data.audit;
+        var rule = summary.data && summary.data.rule;
 
         var onSave = function () {
           if (!draft.trim()) { setNote(t.emptyErr); return; }
@@ -287,6 +314,34 @@ window.__ModuleLoader__.load({
             setNote((data.notes && data.notes[0]) || '');
           });
         };
+        var sourceState = useState('');
+        var sourceDraft = sourceState[0];
+        var setSourceDraft = sourceState[1];
+        var onSaveSource = function () {
+          setBusy('source');
+          setNote('');
+          post({ source: sourceDraft }).then(function (data) {
+            setBusy('');
+            if (data && data.notes && data.notes[0]) setNote(data.notes[0]);
+          });
+        };
+        var onResetSource = function () {
+          setSourceDraft('');
+          setBusy('source');
+          setNote('');
+          post({ source: '' }).then(function (data) {
+            setBusy('');
+            if (data && data.notes && data.notes[0]) setNote(data.notes[0]);
+          });
+        };
+        var onToggleRule = function (next) {
+          setBusy('rule');
+          setNote('');
+          post({ ruleEnabled: next }).then(function (data) {
+            setBusy('');
+            if (data && data.notes && data.notes[0]) setNote(data.notes[0]);
+          });
+        };
         var onToggleGuard = function (next) {
           setBusy('guard');
           setNote('');
@@ -323,7 +378,7 @@ window.__ModuleLoader__.load({
           disabled: busy === 'auth',
           onChange: function (event) { setDraft(event.target.value); },
           onKeyDown: function (event) { if (event.key === 'Enter') onSave(); },
-          style: { flex: '1 1 220px', minWidth: '0' }
+          style: { flex: '1 1 300px', minWidth: '300px' }
         });
 
         var preview = null;
@@ -425,6 +480,60 @@ window.__ModuleLoader__.load({
               )
             : null,
 
+          // ---- 每轮对话推送（保存授权码时自动写进全局指令文件）----
+          h(
+            'div',
+            { style: { marginTop: '14px', paddingTop: '12px', borderTop: '1px solid ' + V.border } },
+            row([
+              h('span', { style: { fontWeight: 600 } }, t.ruleTitle),
+              h('span', { style: { color: V.sub } }, rule && rule.enabled ? t.ruleOn : t.ruleOff),
+              h(Switch, {
+                checked: Boolean(rule && rule.enabled),
+                onChange: onToggleRule,
+                label: t.ruleTitle,
+                disabled: busy === 'rule' || !rule
+              })
+            ]),
+            muted(
+              rule && rule.customRule ? t.ruleCustom : rule && rule.block ? t.ruleBlockPresent : t.ruleHint,
+              { marginTop: '6px' }
+            )
+          ),
+
+          // ---- 推送源名称：改一处，本机所有推送一起改 ----
+          h(
+            'div',
+            { style: { marginTop: '14px', paddingTop: '12px', borderTop: '1px solid ' + V.border } },
+            row([
+              h('span', { style: { fontWeight: 600 } }, t.sourceTitle),
+              h(
+                'span',
+                { style: { color: V.sub } },
+                t.sourceCurrent(String((summary.data && summary.data.source) || t.sourcePlaceholder))
+              )
+            ]),
+            h(
+              'div',
+              { style: { display: 'flex', gap: '8px', flexWrap: 'wrap', alignItems: 'center', marginTop: '6px' } },
+              [
+                h(Input, {
+                  type: 'text',
+                  value: sourceDraft,
+                  placeholder: t.sourcePlaceholder,
+                  spellCheck: false,
+                  autoComplete: 'off',
+                  disabled: busy === 'source',
+                  onChange: function (event) { setSourceDraft(event.target.value); },
+                  onKeyDown: function (event) { if (event.key === 'Enter') onSaveSource(); },
+                  style: { flex: '1 1 300px', minWidth: '300px' }
+                }),
+                h(Button, { variant: 'primary', size: 'sm', onClick: onSaveSource, disabled: busy === 'source' }, t.save),
+                h(Button, { variant: 'ghost', size: 'sm', onClick: onResetSource, disabled: busy === 'source' }, t.sourceReset)
+              ]
+            ),
+            muted(t.sourceHint, { marginTop: '6px' })
+          ),
+
           // ---- 推送兜底 + 调试图 ----
           h(
             'div',
@@ -461,7 +570,7 @@ window.__ModuleLoader__.load({
               ),
               showDebug ? h('div', { style: { marginTop: '4px' } }, debugBody) : null
             )
-          )
+          ),
         );
       };
     }

package/src/lib/index.js

@@ -34,6 +34,7 @@ import { join } from "node:path";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import z from "@deepseek-ai/schemastery";
 import { maskAuthCode, parseAuthCodeInput } from "./authcode.js";
+import { ensureRule, removeRule, ruleStatus } from "./agents-rule.js";
 import { configPath, readStore, writeStore } from "./config-store.js";
 import { apply as applyPushGuard } from "./push-guard.js";
 
@@ -60,7 +61,19 @@ const DEFAULT_RESULT = "任务已完成";
  * name); the platform accepts other values, but rendering is platform-defined,
  * so check a real card after changing it.
  */
-const WIRE_SOURCE = "OpenClaw";
+/**
+ * The HIBoard contract brands cards by this value — the phone renders it as the
+ * card's brand / tool name. It defaults to `"DeepSeek Harness"` (this project's
+ * branding; the official today-task skill and hwpush send `"OpenClaw"` for the
+ * same field, and the platform accepts either — rendering of a custom value is
+ * platform-defined, so look at a real card after changing it).
+ *
+ * Overridable via the `source` config option, which the settings card exposes as
+ * 「推送源名称」. Other local pushers (e.g. the startup/token card in
+ * `dsh-token-broadcast`) read this same value from the plugin's config file, so
+ * one edit moves the whole machine to one brand.
+ */
+const WIRE_SOURCE = "DeepSeek Harness";
 
 /** Environment fallback for the authCode. */
 const AUTH_CODE_ENV = "DSH_HIBOARD_AUTH_CODE";
@@ -74,6 +87,22 @@ const GUARD_STATE_DIR = join(homedir(), ".dsh", "lan", "push-guard");
 /** 调试图最多回溯多少条审计（文件本身有大小上限，读全量没必要）。 */
 const AUDIT_MAX_LINES = 4000;
 
+/**
+ * dsh 的全局指令文件。`dsh-agent-instructions` 每个会话都加载它 ——
+ * 而且**只认这一个全局文件**：`.local` 叠加（`AGENTS.local.md`）只在**项目目录**的
+ * 祖先链里生效，全局那段代码写死了只探测 `AGENTS.md`。所以「每轮都推」这条规则
+ * 想对所有会话、所有项目生效，只能写在这里。
+ */
+const AGENTS_FILE = join(process.env.DSH_HOME || join(homedir(), ".dsh"), "AGENTS.md");
+
+/** 规则写入的结果 → 卡片上的提示语。 */
+const RULE_NOTE = {
+	added: "已把「每轮都要推送」写进全局指令文件 AGENTS.md，新会话即生效。",
+	updated: "已更新 AGENTS.md 里的推送规则。",
+	unchanged: "AGENTS.md 里的推送规则已是最新。",
+	"skipped-custom": "检测到你已手写过推送规则，未改动 AGENTS.md。"
+};
+
 /** Success codes accepted by the official client (string or numeric zero). */
 const SUCCESS_CODES = new Set(["0000000000", "0"]);
 
@@ -118,7 +147,14 @@ const Config = z.object({
 	/** hiboard_push 没带有效 schedule_id 时自动补的值（为空则卡片点不开）。 */
 	defaultScheduleId: z.string().default("dsh_worklog"),
 	/** 设置页路由开关；关掉后 `/hiboard-push/config` 不注册，浏览器半边也停手。 */
-	settingsCard: z.boolean().default(true)
+	settingsCard: z.boolean().default(true),
+	/**
+	 * 保存授权码时，是否顺带把「每轮都要推送」的规则写进全局指令文件
+	 * （`$DSH_HOME/AGENTS.md` 里的一个标记块）。**默认开启** —— 这样一键安装后
+	 * 只要粘一次授权码，规则就自动就位，不必再手改 AGENTS.md。
+	 * 关掉它（卡片上的按钮）会把已写入的那一段一起移除。
+	 */
+	autoRule: z.boolean().default(true)
 });
 
 const entryDefaults = {
@@ -136,7 +172,8 @@ const entryDefaults = {
 	guardAmbiguousRetryCount: 1,
 	guardRetryDelayMs: 3000,
 	defaultScheduleId: "dsh_worklog",
-	settingsCard: true
+	settingsCard: true,
+	autoRule: true
 };
 
 // ---------------------------------------------------------------- payload
@@ -429,7 +466,7 @@ function hiboardVerifyTool({ resolveAuthCode, settings }) {
  * 不继承 dsh Connection 的登录认证，本插件也不自己做 Host / Origin 策略。
  * 部署时鉴权必须同时覆盖本路由与 dsh 本身；不想暴露就把 settingsCard 设为 false。
  */
-function buildConfigRoute({ authCodeInfo, settings, storeFile }) {
+function buildConfigRoute({ authCodeInfo, settings, storeFile, selfcheckReport }) {
 	const SOURCE_LABEL = {
 		settings: "设置页（本插件配置）",
 		entry: "profile 补丁层 hiboard-push.config.authCode",
@@ -532,9 +569,15 @@ function buildConfigRoute({ authCodeInfo, settings, storeFile }) {
 				defaultScheduleId: s.defaultScheduleId
 			},
 			endpoint: s.pushServiceUrl,
+			// 推送源名称：卡片上显示的"来源 / AI 工具名"
+			source: s.source,
+			// 自检工具是否真的注册上了（失败会被回显，不再静默）
+			selfcheck: selfcheckReport(),
 			storeFile,
 			// 调试图：兜底到底把多少次「原本失败的推送」救了回来
-			audit: auditSummary()
+			audit: auditSummary(),
+			// 常驻规则：是否开启、有没有已写入的块、有没有用户自己写的等价规则
+			rule: Object.assign(ruleStatus(AGENTS_FILE), { enabled: s.autoRule })
 		};
 	};
 
@@ -574,6 +617,10 @@ function buildConfigRoute({ authCodeInfo, settings, storeFile }) {
 				const body = JSON.parse(Buffer.concat(chunks).toString("utf8") || "{}");
 				const patch = {};
 				const notes = [];
+				/** 本次请求是否真的写入了授权码（清除不算）——用它触发"顺带写规则"。 */
+				let authCodeTouched = false;
+				/** 卡片上的规则开关：true 写入 / false 移除 / undefined 不表态。 */
+				let ruleRequest;
 
 				// ---- 授权码：完整指令或裸码都行；空串表示"清除覆盖" ----
 				if (Object.prototype.hasOwnProperty.call(body, "authCode")) {
@@ -589,10 +636,17 @@ function buildConfigRoute({ authCodeInfo, settings, storeFile }) {
 							return;
 						}
 						patch.authCode = parsed.code;
+						authCodeTouched = true;
 						notes.push(`${parsed.note}（${maskAuthCode(parsed.code)}）`);
 					}
 				}
 
+				// ---- 常驻规则开关 ----
+				if (Object.prototype.hasOwnProperty.call(body, "ruleEnabled")) {
+					patch.autoRule = body.ruleEnabled === true;
+					ruleRequest = body.ruleEnabled === true;
+				}
+
 				// ---- 兜底开关：布尔直接落盘，立即生效 ----
 				for (const key of ["guardEnabled", "guardRescueEnabled", "guardPromiseRescueEnabled", "guardRetryEnabled"]) {
 					if (Object.prototype.hasOwnProperty.call(body, key)) patch[key] = body[key] === true;
@@ -601,12 +655,40 @@ function buildConfigRoute({ authCodeInfo, settings, storeFile }) {
 					const text = String(body.defaultScheduleId ?? "").trim();
 					patch.defaultScheduleId = text || null;
 				}
+				// ---- 推送源名称（source）：卡片上显示的"来源 / AI 工具名" ----
+				// 空串 → 清除覆盖，回退到默认 "DeepSeek Harness"
+				if (Object.prototype.hasOwnProperty.call(body, "source")) {
+					const text = String(body.source ?? "").trim();
+					patch.source = text || null;
+					notes.push(text ? `推送源名称已改为「${text}」，本机所有推送都会用它。` : "已恢复默认推送源名称（DeepSeek Harness）。");
+				}
 
 				if (Object.keys(patch).length === 0) {
 					send(400, { error: "没有可保存的字段" });
 					return;
 				}
 				writeStore(patch, storeFile);
+
+				// ---- 常规规则动作：放在落盘之后，读到的才是"最终"的 autoRule ----
+				// 保存授权码时**顺带**把「每轮都要推送」写进全局指令文件：用户此刻的意图
+				// 就是"让它开始工作"，不该再要求他手改 AGENTS.md。默认开启，卡片可关。
+				try {
+					if (ruleRequest === false) {
+						const r = removeRule(AGENTS_FILE);
+						notes.push(r.action === "removed" ? "已移除全局指令文件里的推送规则。" : "全局推送规则本来就不存在，未改动。");
+					} else if (ruleRequest === true) {
+						const r = ensureRule(AGENTS_FILE);
+						notes.push(RULE_NOTE[r.action] ?? "已同步全局推送规则。");
+					} else if (authCodeTouched && settings().autoRule) {
+						const r = ensureRule(AGENTS_FILE);
+						// unchanged 不提示：每次保存都重复一句"已是最新"只是噪音
+						if (r.action !== "unchanged") notes.push(RULE_NOTE[r.action] ?? "已同步全局推送规则。");
+					}
+				} catch (error) {
+					// 规则写不进去不该让"授权码已保存"这件事看起来失败
+					notes.push(`授权码已保存，但写入全局规则失败：${String(error?.message ?? error)}`);
+				}
+
 				send(200, { ...summary(), notes });
 			} catch (error) {
 				send(400, { error: String(error?.message ?? error) });
@@ -645,7 +727,8 @@ function apply(ctx, rawConfig) {
 			guardAmbiguousRetryCount: Number(resolved.guardAmbiguousRetryCount) >= 0 ? Number(resolved.guardAmbiguousRetryCount) : 1,
 			guardRetryDelayMs: Number(resolved.guardRetryDelayMs) > 0 ? Number(resolved.guardRetryDelayMs) : 3000,
 			defaultScheduleId: String(resolved.defaultScheduleId ?? "").trim() || "dsh_worklog",
-			settingsCard: resolved.settingsCard !== false
+			settingsCard: resolved.settingsCard !== false,
+			autoRule: resolved.autoRule !== false
 		};
 	};
 
@@ -670,8 +753,13 @@ function apply(ctx, rawConfig) {
 	ctx.tools.register(hiboardPushTool({ resolveAuthCode, settings }));
 	ctx.tools.register(hiboardVerifyTool({ resolveAuthCode, settings }));
 
+	/** 自检工具的注册结果，由兜底回调写入（见下面的 selfcheckReport）。 */
+	let selfcheckStatus = { ok: null, error: "" };
+
 	// ---- 推送兜底（原 dsh-push-guard，现并入本包）：默认开启，可实时关闭 ----
 	applyPushGuard(ctx, {
+		// 注册成败都要回显：失败原本只写了一条**看不见的** warn
+		onSelfcheckRegister: (result) => { selfcheckStatus = result; },
 		// 静态值：只有把 guardEnabled:false 写死在配置里，才会整个不加载
 		enabled: entry.guardEnabled !== false,
 		// 实时值：每次判定都重新读，设置页一关就立即停
@@ -685,6 +773,8 @@ function apply(ctx, rawConfig) {
 		// 让兜底走"实时解析"而不是把挂载时的值钉死，
 		// 否则设置页里新存的授权码要等重启才对兜底生效。
 		resolveAuthCode,
+		// 同理实时解析：设置页改了「推送源名称」，兜底补推的卡片也要立刻跟着变
+		resolveSource: () => settings().source,
 		pushServiceUrl: settings().pushServiceUrl,
 		maxContentLength: settings().maxContentLength,
 		defaultResult: settings().defaultResult,
@@ -694,12 +784,23 @@ function apply(ctx, rawConfig) {
 		source: settings().source
 	});
 
+	/**
+	 * 自检工具的注册状态（**回显给设置页**）。
+	 * `registered` 取实时查询 —— 即便注册被延迟或撤下也能如实反映；
+	 * `error` 是注册时捕获到的原因。没有它，注册失败就只剩一条无处可见的 warn：
+	 * 本机 `~/.dsh/logs` 下没有该进程的日志文件（2026-10-13 验收报告第 5 节）。
+	 */
+	const selfcheckReport = () => ({
+		registered: Boolean(ctx.tools?.get?.("hiboard_push_selfcheck")),
+		error: selfcheckStatus.error || ""
+	});
+
 	// ---- 设置页路由 ----
 	// webServer 只在 web profile 存在，而 cordis 没有"可选注入"的写法，
 	// 所以走一次 scoped inject：服务不在时闭包根本不执行，插件照常加载。
 	if (settings().settingsCard && typeof ctx.inject === "function") {
 		ctx.inject(["webServer"], (scope) => {
-			const route = buildConfigRoute({ authCodeInfo, settings, storeFile });
+			const route = buildConfigRoute({ authCodeInfo, settings, storeFile, selfcheckReport });
 			// 挂在 effect 上：插件被关掉时路由一起撤下，否则它会继续为一个
 			// 已关闭的插件读写配置（modsearch 踩过这个坑，见其 dsh/index.js 注释）。
 			scope.effect(() => scope.webServer.register(route), "hiboard-push: settings route");

package/src/lib/push-guard.js

@@ -83,7 +83,7 @@ const DEFAULTS = {
 	retryCount: 3,
 	ambiguousRetryCount: 1,
 	defaultResult: "任务已完成",
-	source: "OpenClaw",
+	source: "DeepSeek Harness",
 	defaultScheduleId: "dsh_worklog",
 	stateDir: "",
 	minPromiseLength: 120,
@@ -123,7 +123,8 @@ export const Config = z.object({
 	defaultResult: z.string().default(DEFAULTS.defaultResult),
 	/**
 	 * 卡片 `source` 字段 —— 就是负一屏上那个**来源 / AI 工具名**的品牌化渲染值。
-	 * 默认 `"OpenClaw"`：与官方 `today-task` skill、`hwpush` 以及本插件历史行为一致。
+	 * 默认 `"DeepSeek Harness"`（本项目品牌）。官方 `today-task` skill 与 `hwpush` 在同一
+	 * 字段上发的是 `"OpenClaw"`，平台两者都接受。可在设置卡片「推送源名称」里改。
 	 * 实测平台**接受**任意值（自定义值同样返回 `0000000000`），但渲染样式由平台决定，
 	 * 换值后请先在真机上看一眼卡片再长期使用。
 	 */
@@ -488,7 +489,13 @@ export function apply(ctx, config) {
 		).trim();
 	const pushUrl = String(settings.pushServiceUrl || DEFAULTS.pushServiceUrl);
 	const maxLen = Number(settings.maxContentLength) > 0 ? Number(settings.maxContentLength) : DEFAULTS.maxContentLength;
-	const cardSource = String(settings.source ?? "").trim() || DEFAULTS.source;
+	/**
+	 * 卡片来源（负一屏上的"来源 / AI 工具名"）**实时解析**：设置页改一次，
+	 * 之后**所有**卡片（含兜底补推的那张）都用新值，而不是钉在挂载那一刻。
+	 */
+	const resolveCardSource = () =>
+		String((typeof settings.resolveSource === "function" ? settings.resolveSource() : settings.source) ?? "").trim() ||
+		DEFAULTS.source;
 	const retryBudget = Math.max(0, Number(settings.retryCount) >= 0 ? Number(settings.retryCount) : DEFAULTS.retryCount);
 	const ambiguousBudget = Math.max(0, Number(settings.ambiguousRetryCount) >= 0 ? Number(settings.ambiguousRetryCount) : DEFAULTS.ambiguousRetryCount);
 	const stateDir = String(settings.stateDir || "").trim() || join(homedir(), ".dsh", "lan", "push-guard");
@@ -514,7 +521,7 @@ export function apply(ctx, config) {
 		retryEnabled: settings.retryEnabled !== false,
 		retryCount: retryBudget,
 		ambiguousRetryCount: ambiguousBudget,
-		source: cardSource,
+		source: resolveCardSource(),
 		defaultScheduleId: String(settings.defaultScheduleId || DEFAULTS.defaultScheduleId),
 		stateDir
 	};
@@ -522,7 +529,7 @@ export function apply(ctx, config) {
 	ctx.logger?.info?.(
 		"[push-guard] 启动自检：authCode=%s；L1 抢救=%s，L2 承诺兜底=%s，L3 重试=%s（确定未送达 %d 次 / 可能已送达 %d 次）；卡片来源=%s；schedule_id 兜底=%s；状态目录=%s",
 		startup.authCode, startup.rescueEnabled, startup.promiseRescueEnabled, startup.retryEnabled,
-		retryBudget, ambiguousBudget, cardSource, startup.defaultScheduleId, stateDir
+		retryBudget, ambiguousBudget, resolveCardSource(), startup.defaultScheduleId, stateDir
 	);
 	if (startup.authCode === "MISSING") {
 		ctx.logger?.warn?.("[push-guard] ⚠️ 未配置 authCode，任何兜底推送都会失败（请检查 hiboard-push / push-guard 配置）");
@@ -618,7 +625,7 @@ export function apply(ctx, config) {
 						// 兜底卡片同样必须是"能点开"的：schedule_id 为空时用默认分组
 						defaultScheduleId: String(settings.defaultScheduleId || DEFAULTS.defaultScheduleId),
 						// 兜底卡片与正常卡片用同一个来源名（负一屏上显示的 AI 工具名）
-						source: cardSource,
+						source: resolveCardSource(),
 						stateDir,
 						audit
 					});
@@ -776,16 +783,26 @@ export function apply(ctx, config) {
 					schema: {
 						type: "object",
 						additionalProperties: false,
+						// ⚠️ `required` 必须写在**对象层**，不能写进每个属性节点。
+						// 本工具没有走 defineTool()（那个会把 DSL 编译掉），而是把裸对象直接
+						// 交给 ctx.tools.register()，于是要过 dsh-tools 的
+						// assertSupportedJsonSchema —— 它只允许 required 出现在 type:"object" 上。
+						// 写成属性级 `required: true` 会抛 JsonSchemaError，而被下面的 catch 吞掉，
+						// 表现为"自检工具根本不存在"且毫无提示（2026-10-13 验收实测）。
+						required: [
+							"guardActive", "hooked", "authCode", "source", "retryBudget",
+							"endpoint", "endpointReachable", "lastState", "auditTail"
+						],
 						properties: {
-							guardActive: { type: "boolean", required: true },
-							hooked: { type: "boolean", required: true },
-							authCode: { type: "string", required: true },
-							source: { type: "string", required: true },
-							retryBudget: { type: "string", required: true },
-							endpoint: { type: "string", required: true },
-							endpointReachable: { type: "boolean", required: true },
-							lastState: { type: "string", required: true },
-							auditTail: { type: "string", required: true }
+							guardActive: { type: "boolean" },
+							hooked: { type: "boolean" },
+							authCode: { type: "string" },
+							source: { type: "string" },
+							retryBudget: { type: "string" },
+							endpoint: { type: "string" },
+							endpointReachable: { type: "boolean" },
+							lastState: { type: "string" },
+							auditTail: { type: "string" }
 						}
 					},
 					render(_args, value) {
@@ -832,7 +849,7 @@ export function apply(ctx, config) {
 						guardActive: !guardOff(),
 						hooked,
 						authCode: resolveAuthCode() ? "已配置" : "未配置（推送会失败）",
-						source: cardSource,
+						source: resolveCardSource(),
 						retryBudget: `确定未送达 ${retryBudget} 次 / 可能已送达 ${ambiguousBudget} 次`,
 						endpoint: pushUrl,
 						endpointReachable: reachable,
@@ -841,10 +858,24 @@ export function apply(ctx, config) {
 					};
 				}
 			});
+			try {
+				settings.onSelfcheckRegister?.({ ok: true, error: "" });
+			} catch {
+				/* 上报失败不影响工具本身 */
+			}
 			return () => off();
 		}, "push-guard: self-check tool");
 	} catch (error) {
-		ctx.logger?.warn?.("[push-guard] 注册自检工具失败（已忽略）：%s", error?.message ?? String(error));
+		const message = String(error?.message ?? error);
+		ctx.logger?.warn?.("[push-guard] 注册自检工具失败：%s", message);
+		// **不再静默**：把失败回显给宿主，设置页会在 /hiboard-push/config 里报
+		// selfcheck.registered=false。本机 ~/.dsh/logs 下没有该进程的日志文件，warn
+		// 是无处可见的 —— 2026-10-13 的验收就是因为这一点完全无感（报告第 5 节）。
+		try {
+			settings.onSelfcheckRegister?.({ ok: false, error: message });
+		} catch {
+			/* 上报失败不该影响其它功能 */
+		}
 	}
 }