@xgjktech/xg-openclaw-harness-tools 0.3.5 → 0.4.1

package/README.md

@@ -1,15 +1,15 @@
 # @xgjktech/xg-openclaw-harness-tools
 
-OpenClaw 第三方工具插件：企业计划工具 `xg_plan_write` / `xg_plan_execute`。
+OpenClaw 第三方工具插件：企业计划工具 `xg_plan_write` / `xg_plan_view`。
 
 用一份持久化的计划（SQLite 落盘）取代内置 `update_plan`（无状态、只回显、不落库），
-`xg_plan_write` 整张维护草稿计划，`xg_plan_execute` 只读查看计划或最近摘要。
+`xg_plan_write` 整张维护草稿计划，`xg_plan_view` 只读查看计划或最近摘要。
 
 ## 架构裁决：实时事件当前处于事实性休眠（务必先读）
 
 **当前 OpenClaw 2026.6.10 版本下，实时事件推送链路休眠**：工具 execute/factory 期没有
 正当途径获取真实 runId（详见 `docs/notes-plugin-entry.md` N2），且 0.3.0 已移除工具侧
-`notify.ts`。`xg_plan_write` 落库后不发事件，`xg_plan_execute` 全程只读。
+`notify.ts`。`xg_plan_write` 落库后不发事件，`xg_plan_view` 全程只读。
 
 **因此 IM 侧（或任何下游消费方）不得依赖实时事件感知计划进度。** 当前唯一可靠的主感知路径是：
 
@@ -65,7 +65,7 @@ P1 阶段不锁死具体安装命令，避免与实际安装流程漂移（详
 ```jsonc
 {
   "tools": {
-    "allow": ["xg_plan_write", "xg_plan_execute"],
+    "allow": ["xg_plan_write", "xg_plan_view"],
     "deny": ["update_plan"]
   }
 }
@@ -93,13 +93,17 @@ P1 阶段不锁死具体安装命令，避免与实际安装流程漂移（详
 整张创建或覆盖一份草稿计划（goal + tasks[]）并写入 SQLite。更新时必须重交所有要保留的
 task；写入 schema 不接受 steps，但读取旧计划仍兼容旧 steps 数据。
 
-### `xg_plan_execute`
+### `xg_plan_view`
 
-只读查看计划。带 planId 返回完整紧凑 view；不带 planId 返回最近 10 条计划摘要，用于跨会话
-找回 planId。更新进度统一使用 `xg_plan_write` 整张重交。
+只读查看计划，**不会执行任何任务**。带 planId 返回完整紧凑 view；不带 planId 返回最近 10 条
+计划摘要，用于跨会话找回 planId。更新进度统一使用 `xg_plan_write` 整张重交。
 
-两个工具的完整参数 schema 见 `src/plan-write-tool.ts` / `src/plan-execute-tool.ts`
-中的 `PLAN_WRITE_DESCRIPTION` / `PLAN_EXECUTE_DESCRIPTION`。
+> 工具名用 `view` 而非 `execute` 是有意的：`plan_view`/`plan_write` 都只是台账，不执行、不调度、
+> 无后台运行。二者 description 均明确"保存/查看 ≠ 执行"，且结果带 `reminder` 字段引导模型
+> 继续逐项实际执行任务——避免模型调用计划工具后误以为工作已在后台完成而停住。
+
+两个工具的完整参数 schema 见 `src/plan-write-tool.ts` / `src/plan-view-tool.ts`
+中的 `PLAN_WRITE_DESCRIPTION` / `PLAN_VIEW_DESCRIPTION`。
 
 ## 部署 checklist
 
@@ -107,7 +111,7 @@ task；写入 schema 不接受 steps，但读取旧计划仍兼容旧 steps 数
 - [ ] monorepo 构建成功（`xg-shared` 先于本插件构建，workspaces 拓扑自动保证）
 - [ ] 插件已安装且被 OpenClaw 识别为已加载的第三方插件（非 bundled）
 - [ ] `tools.deny` 含 `update_plan`
-- [ ] `tools.allow` 含 `xg_plan_write` + `xg_plan_execute`（或经 `group:plugins` / `*` 放行）
+- [ ] `tools.allow` 含 `xg_plan_write` + `xg_plan_view`（或经 `group:plugins` / `*` 放行）
 - [ ] 实拉一个 agent，验证工具清单**有本插件两工具、无 update_plan**（步骤见下节）
 - [ ] `<stateDir>/xgjktech/` 可写，首次运行能生成 `plans.sqlite`
 - [ ] （互通）IM 侧已依赖 `@xgjktech/xg-openclaw-shared` 并按 `docs/04-互通设计.md` 接入只读反查
@@ -115,15 +119,15 @@ task；写入 schema 不接受 steps，但读取旧计划仍兼容旧 steps 数
 ## 实机验证步骤（可复现）+ 当前实际执行情况说明
 
 **验收标准要求部署方按 checklist 实拉一个 agent，确认工具清单里有 `xg_plan_write`/
-`xg_plan_execute`、没有 `update_plan`。以下是可复现的验证步骤：**
+`xg_plan_view`、没有 `update_plan`。以下是可复现的验证步骤：**
 
 1. 按上文"配置"章节把 `tools.deny`/`tools.allow` 写入生产 agent/profile 配置。
 2. 安装并加载本插件（确认加载日志/插件列表里出现 `xg-harness-tools`，origin 为第三方非 bundled）。
 3. 拉起一个真实 agent 会话，触发一次会列出可用工具的动作（例如让 agent 描述自己有哪些工具，
    或查看 gateway/日志里该次 attempt 实际注册的工具名列表）。
-4. 核对该工具列表：应包含 `xg_plan_write` 与 `xg_plan_execute`，**不应包含** `update_plan`。
+4. 核对该工具列表：应包含 `xg_plan_write` 与 `xg_plan_view`，**不应包含** `update_plan`。
 5. 调用一次 `xg_plan_write` 建一份最小计划，确认返回 `planId + view`；再用该 planId 调
-   `xg_plan_execute`，确认只读 view 一致。用 `openPlanStoreReadonly` 反查并核对落盘内容。
+   `xg_plan_view`，确认只读 view 一致。用 `openPlanStoreReadonly` 反查并核对落盘内容。
 
 **本项在本次交付中未在真实 OpenClaw gateway 环境实机执行**——本仓库当前开发环境没有可用的
 真实 OpenClaw gateway/agent 运行环境，因此无法诚实地报告"已实拉 agent 验证通过"。以下是
@@ -131,12 +135,12 @@ task；写入 schema 不接受 steps，但读取旧计划仍兼容旧 steps 数
 
 - 当前 factory 集成测试用**手工构造的 mock `api`**捕获 2 个工具的注册工厂，并提供带
   `sessionKey`/`deliveryContext` 的 `toolContext`：`xg_plan_write` 写入后通过只读存储反查
-  `origin`，`xg_plan_execute` 校验指定计划的 view 与最近计划列表。**这验证的是插件代码本身
+  `origin`，`xg_plan_view` 校验指定计划的 view 与最近计划列表。**这验证的是插件代码本身
   可以被正确加载、注册并贯通当前契约**，但 mock `api` 不是真实 OpenClaw gateway 的
   `tools.allow`/`deny` 策略引擎，**不能**佐证"生产 deny/allow 配置生效后工具清单精确符合
   预期"这一条——那一条必须在真实 gateway 环境按上面 5 步实测。
 - T6 阶段（`packages/xg-harness-tools/src/integration.test.ts`）用真实的 `SqlitePlanStore`
-  （临时目录）+ 真实工具函数（`buildPlanWriteTool`/`buildPlanExecuteTool`）跑通了完整的
+  （临时目录）+ 真实工具函数（`buildPlanWriteTool`/`buildPlanViewTool`）跑通了完整的
   写入→整张重交→execute 只读查看→SQLite 只读反查链路，但同样不经过 OpenClaw 的工具
   allowlist/deny 策略引擎。
 

package/dist/index.js

@@ -1,14 +1,14 @@
 import { defineToolPlugin } from "openclaw/plugin-sdk/tool-plugin";
 import { resolvePlanDbPath, SqlitePlanStore, SqliteActionStore } from "@xgjktech/xg-openclaw-shared";
 import { PLAN_WRITE_DESCRIPTION, PlanWriteParams, buildPlanWriteTool } from "./plan-write-tool.js";
-import { PLAN_EXECUTE_DESCRIPTION, PlanExecuteParams, buildPlanExecuteTool, } from "./plan-execute-tool.js";
+import { PLAN_VIEW_DESCRIPTION, PlanViewParams, buildPlanViewTool, } from "./plan-view-tool.js";
 import { ACTION_DISPATCH_DESCRIPTION, ActionDispatchParams, buildActionDispatchTool, } from "./action-dispatch-tool.js";
 import { toPlanOrigin } from "./plan-origin.js";
 const PLUGIN_ID = "xg-harness-tools";
 export default defineToolPlugin({
     id: PLUGIN_ID,
     name: "XG Harness Tools",
-    description: "企业工具插件：计划管理与通用动作分发（plan_write / plan_execute / action_dispatch）",
+    description: "企业工具插件：计划管理与通用动作分发（plan_write / plan_view / action_dispatch）",
     tools: (tool) => {
         let planStore;
         let actionStore;
@@ -36,12 +36,12 @@ export default defineToolPlugin({
                 factory: ({ api, toolContext }) => buildPlanWriteTool(getPlanStore(api), toPlanOrigin(toolContext)),
             }),
             tool({
-                name: "xg_plan_execute",
+                name: "xg_plan_view",
                 label: "【xg-harness】查看计划",
-                description: PLAN_EXECUTE_DESCRIPTION,
-                parameters: PlanExecuteParams,
+                description: PLAN_VIEW_DESCRIPTION,
+                parameters: PlanViewParams,
                 optional: true,
-                factory: ({ api, toolContext }) => buildPlanExecuteTool({ store: getPlanStore(api), origin: toPlanOrigin(toolContext) }),
+                factory: ({ api, toolContext }) => buildPlanViewTool({ store: getPlanStore(api), origin: toPlanOrigin(toolContext) }),
             }),
             tool({
                 name: "xg_action_dispatch",

package/dist/{plan-execute-tool.d.ts → plan-view-tool.d.ts}

@@ -1,13 +1,13 @@
 import { Type, type Static } from "typebox";
 import type { AnyAgentTool } from "openclaw/plugin-sdk/plugin-entry";
 import { type PlanOrigin, type PlanStore } from "@xgjktech/xg-openclaw-shared";
-export declare const PlanExecuteParams: Type.TObject<{
+export declare const PlanViewParams: Type.TObject<{
     planId: Type.TOptional<Type.TString>;
 }>;
-export type PlanExecuteParamsT = Static<typeof PlanExecuteParams>;
-export declare const PLAN_EXECUTE_DESCRIPTION: string;
-export declare function buildPlanExecuteTool(deps: {
+export type PlanViewParamsT = Static<typeof PlanViewParams>;
+export declare const PLAN_VIEW_DESCRIPTION: string;
+export declare function buildPlanViewTool(deps: {
     store: PlanStore;
     origin?: PlanOrigin;
 }): AnyAgentTool;
-//# sourceMappingURL=plan-execute-tool.d.ts.map
+//# sourceMappingURL=plan-view-tool.d.ts.map

package/dist/plan-view-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-view-tool.d.ts","sourceRoot":"","sources":["../src/plan-view-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EAEf,MAAM,8BAA8B,CAAC;AAKtC,eAAO,MAAM,cAAc;;EAK1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,qBAAqB,QAQtB,CAAC;AAuBb,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,YAAY,CAmD/F"}

package/dist/{plan-execute-tool.js → plan-view-tool.js}

@@ -1,19 +1,19 @@
 import { Type } from "typebox";
 import { isPlanCancelled, } from "@xgjktech/xg-openclaw-shared";
-import { renderPlanView } from "./plan-view.js";
+import { buildPlanReminder, renderPlanView } from "./plan-view.js";
 import { planInScope, scopeKey } from "./plan-scope.js";
 import { toolJsonResult } from "./tool-json-result.js";
-export const PlanExecuteParams = Type.Object({
+export const PlanViewParams = Type.Object({
     planId: Type.Optional(Type.String({ description: "要查看的计划 id；留空则列出最近计划" })),
 }, { additionalProperties: false });
-export const PLAN_EXECUTE_DESCRIPTION = [
-    "用途：只读查看已保存的计划；不执行任务，也不修改计划。",
-    "只能看到当前会话来源的计划。",
+export const PLAN_VIEW_DESCRIPTION = [
+    "用途：只读查看已保存的 todo 状态，用于前端 UI 展示、恢复工作上下文和汇报进度；不会执行任何任务，也不会修改计划。",
+    "只能看到当前聊天范围（同一 channel/to）的 todo；在同一部署和 stateDir 下，即使重新创建 agent session，也可找回该范围内的 todo。",
     "",
     "- 带 planId：返回该计划当前的完整清单。",
     "- 不带 planId：返回最近计划的摘要列表，用于忘记或跨会话找回 planId。",
     "",
-    "需要更新进度时，用 xg_plan_write 重新提交整张计划。",
+    "重要：查看只恢复记录，不会自动推进状态。若当前请求需要继续这项工作，再按 todo 状态推进，并在状态变化后用 xg_plan_write 回写。",
 ].join("\n");
 function summarizePlan(plan) {
     const taskCounts = { total: 0, completed: 0, blocked: 0, inProgress: 0 };
@@ -33,14 +33,14 @@ function summarizePlan(plan) {
         taskCounts,
     };
 }
-export function buildPlanExecuteTool(deps) {
+export function buildPlanViewTool(deps) {
     const { store, origin } = deps;
     const scope = scopeKey(origin);
     return {
-        name: "xg_plan_execute",
+        name: "xg_plan_view",
         label: "【xg-harness】查看计划",
-        description: PLAN_EXECUTE_DESCRIPTION,
-        parameters: PlanExecuteParams,
+        description: PLAN_VIEW_DESCRIPTION,
+        parameters: PlanViewParams,
         async execute(_toolCallId, rawParams) {
             const params = rawParams;
             try {
@@ -60,10 +60,14 @@ export function buildPlanExecuteTool(deps) {
                     const result = { ok: false, error: { code: "PLAN_NOT_FOUND" } };
                     return toolJsonResult(result);
                 }
+                const reminder = buildPlanReminder(plan);
                 const result = {
                     ok: true,
                     planId: plan.planId,
                     view: renderPlanView(plan),
+                    ...(reminder !== undefined
+                        ? { reminder: `该 todo 有未完成项；查看只恢复记录，不会自动推进状态。${reminder}` }
+                        : {}),
                 };
                 return toolJsonResult(result);
             }

package/dist/plan-view.d.ts

@@ -1,3 +1,9 @@
 import { type Plan } from "@xgjktech/xg-openclaw-shared";
 export declare function renderPlanView(plan: Plan): string;
+/**
+ * 生成当前 todo 的状态提醒，帮助模型恢复工作上下文并及时回写状态。
+ * 规则：优先 in_progress（继续手头任务）→ 其次 pending（开新任务）→ 只剩 blocked 时提示等待；
+ * 全部完成或已取消则返回 undefined。
+ */
+export declare function buildPlanReminder(plan: Plan): string | undefined;
 //# sourceMappingURL=plan-view.d.ts.map

package/dist/plan-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-view.d.ts","sourceRoot":"","sources":["../src/plan-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,EAGV,MAAM,8BAA8B,CAAC;AAoBtC,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAgBjD"}
+{"version":3,"file":"plan-view.d.ts","sourceRoot":"","sources":["../src/plan-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,EAGV,MAAM,8BAA8B,CAAC;AAqBtC,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAgBjD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAsBhE"}

package/dist/plan-view.js

@@ -1,14 +1,15 @@
 import { isPlanCancelled, } from "@xgjktech/xg-openclaw-shared";
+// 状态标记直接用枚举原文，模型可零歧义对账（写读一致），不用符号猜测。
 const TASK_STATUS_MARKERS = {
-    pending: "[ ]",
-    in_progress: "[>]",
-    completed: "[x]",
-    blocked: "[!]",
+    pending: "[pending]",
+    in_progress: "[in_progress]",
+    completed: "[completed]",
+    blocked: "[blocked]",
 };
 const STEP_STATUS_MARKERS = {
-    pending: "[ ]",
-    in_progress: "[>]",
-    completed: "[x]",
+    pending: "[pending]",
+    in_progress: "[in_progress]",
+    completed: "[completed]",
 };
 /** view 依赖"一行一项"的格式约定；字段内容里的换行统一压成空格，防止伪造出多余的行。 */
 function singleLine(text) {
@@ -26,3 +27,28 @@ export function renderPlanView(plan) {
     });
     return lines.join("\n");
 }
+/**
+ * 生成当前 todo 的状态提醒，帮助模型恢复工作上下文并及时回写状态。
+ * 规则：优先 in_progress（继续手头任务）→ 其次 pending（开新任务）→ 只剩 blocked 时提示等待；
+ * 全部完成或已取消则返回 undefined。
+ */
+export function buildPlanReminder(plan) {
+    if (isPlanCancelled(plan))
+        return undefined;
+    const unfinished = plan.tasks.filter((task) => task.status !== "completed");
+    if (unfinished.length === 0)
+        return undefined;
+    const inProgress = unfinished.find((task) => task.status === "in_progress");
+    if (inProgress !== undefined) {
+        return `当前 todo：继续处理「${singleLine(inProgress.title)}」；状态变化后用 xg_plan_write 回写`;
+    }
+    const pending = unfinished.find((task) => task.status === "pending");
+    if (pending !== undefined) {
+        return `当前 todo：待处理「${singleLine(pending.title)}」；开始后将状态更新为 in_progress`;
+    }
+    const blockedCount = unfinished.filter((task) => task.status === "blocked").length;
+    if (blockedCount > 0) {
+        return `当前 todo 有 ${blockedCount} 项 blocked，等待 note 中记录的条件满足后再推进`;
+    }
+    return undefined;
+}

package/dist/plan-write-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-write-tool.d.ts","sourceRoot":"","sources":["../src/plan-write-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EAGf,MAAM,8BAA8B,CAAC;AA8BtC,eAAO,MAAM,eAAe;;;;;;;;;EAwB3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB,QAmBvB,CAAC;AA0Eb,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CAsHtF"}
+{"version":3,"file":"plan-write-tool.d.ts","sourceRoot":"","sources":["../src/plan-write-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EAGf,MAAM,8BAA8B,CAAC;AA8BtC,eAAO,MAAM,eAAe;;;;;;;;;EAwB3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB,QA2BvB,CAAC;AA0Eb,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CA0HtF"}

package/dist/plan-write-tool.js

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { Type } from "typebox";
 import { assertPlanInvariants, isPlanCancelled, } from "@xgjktech/xg-openclaw-shared";
 import { toolJsonResult } from "./tool-json-result.js";
-import { renderPlanView } from "./plan-view.js";
+import { buildPlanReminder, renderPlanView } from "./plan-view.js";
 import { planInScope, scopeKey } from "./plan-scope.js";
 const TaskInput = Type.Object({
     title: Type.String({
@@ -33,21 +33,29 @@ export const PlanWriteParams = Type.Object({
     cancel: Type.Optional(Type.Boolean({ description: "取消该计划；true 时只需带 planId，不带 goal/tasks" })),
 }, { additionalProperties: false });
 export const PLAN_WRITE_DESCRIPTION = [
-    "用途：维护一份对用户可见、可跨回合保存的任务清单。每次调用都是整张替换，不是增量更新。",
+    "用途：维护模型当前工作的 todo 状态，供前端 UI 展示，并可在后续回合恢复。每次调用都是整张替换，不是增量更新。",
     "",
-    "何时不用（除非用户明确要求追踪）：",
-    "- 纯问答、查询、解释或闲聊。",
-    "- 一两个动作即可完成，或预计当前回合可以直接做完。",
-    "- 不要把分析、思考和试错过程写成 task；只记录需要向用户展示的工作项。",
+    "调用判断：收到执行型请求后，先在内部拆解工作项；满足以下任一条件，必须在开始实际工作前调用本工具，不需要等用户明确要求：",
+    "- 用户明确要求计划、任务清单或进度追踪。",
+    "- 需要等待用户回复、审批或外部系统。",
+    "- 有 3 个或以上用户可感知、可独立汇报完成状态的工作项。",
+    "- 同时包含调查、实施、验证等多个阶段。",
+    "- 涉及多个组件且工作项之间存在依赖，或可能中断后继续。",
     "",
-    "何时用：",
-    "- 工作有 3 个以上可独立完成的任务，且预计需要多轮推进或中断后继续。",
-    "- 需要等待人的回复、审批或外部系统，即使任务较少。",
-    "- 用户明确要求任务清单或进度追踪。",
+    "以下情况直接执行，不建计划：",
+    "- 纯问答、查询、解释或闲聊，不涉及后续执行。",
+    "- 只有 1-2 个原子动作，且无需等待、恢复或向用户展示进度。",
+    "",
+    "判断要求：不要以自己能否在当前回合完成作为判断依据；不要把分析、思考和试错过程写成 task，只记录需要向用户展示的工作项。",
+    "",
+    "工作协议（必须遵守）：",
+    "- 本工具只记录 todo 状态并供 UI 展示：不执行、不调度、无后台运行。保存 todo ≠ 完成工作。",
+    "- 写入后继续处理当前请求；任务开始、完成、暂停或阻塞时，用本工具回写最新整张清单。",
+    "- 无法当场完成或需等待外部条件的项，标 in_progress（进行中）或 blocked（note 写明原因），后续回合恢复时再判断。",
     "",
     "提交规则：",
     "- 新建时不传 planId；更新时传入原 planId。",
-    "- 更新计划内容时必须重新提交 goal 和所有要保留的 tasks，包括未变化任务及其当前 status/note。只提交变化项会删除其他任务；记不清时先用 xg_plan_execute 查看。",
+    "- 更新计划内容时必须重新提交 goal 和所有要保留的 tasks，包括未变化任务及其当前 status/note。只提交变化项会删除其他任务；记不清时先用 xg_plan_view 查看。",
     "- goal 用一句话；tasks 通常 3-7 项，每项是能判断是否完成的具体动作，不写 TODO、待定或内部思考。",
     "- status 为 pending、in_progress、completed 或 blocked。通常只有一项 in_progress，确实并行时可以有多项；blocked 时必须用 note 写明原因和继续所需条件。",
     "- 同一件工作只维护一份计划；任务方向变化时，先取消不再推进的旧计划（{planId, cancel:true}）再新建。",
@@ -188,11 +196,15 @@ export function buildPlanWriteTool(store, origin) {
                 const plan = buildPlan(params.goal, params.tasks, existing, planId, origin, new Date().toISOString());
                 assertPlanInvariants(plan);
                 store.set(plan);
+                const reminder = buildPlanReminder(plan);
                 const result = {
                     ok: true,
                     planId: plan.planId,
                     view: renderPlanView(plan),
                     ...(warnings !== undefined ? { warnings } : {}),
+                    ...(reminder !== undefined
+                        ? { reminder: `todo 已保存（仅记录，未执行）。${reminder}` }
+                        : {}),
                 };
                 return toolJsonResult(result);
             }

package/openclaw.plugin.json

@@ -1,14 +1,14 @@
 {
   "id": "xg-harness-tools",
   "name": "XG Harness Tools",
-  "description": "企业工具插件：计划管理与通用动作分发（plan_write / plan_execute / action_dispatch）",
-  "version": "0.1.0",
+  "description": "企业工具插件：计划管理与通用动作分发（plan_write / plan_view / action_dispatch）",
+  "version": "0.4.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": true,
     "properties": {}
   },
   "contracts": {
-    "tools": ["xg_plan_write", "xg_plan_execute", "xg_action_dispatch"]
+    "tools": ["xg_plan_write", "xg_plan_view", "xg_action_dispatch"]
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xgjktech/xg-openclaw-harness-tools",
-  "version": "0.3.5",
-  "description": "企业工具插件：plan_write / plan_execute / action_dispatch（OpenClaw 第三方工具插件）",
+  "version": "0.4.1",
+  "description": "企业工具插件：plan_write / plan_view / action_dispatch（OpenClaw 第三方工具插件）",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -19,6 +19,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prebuild": "npm run clean",
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "pretest": "npm run build",
@@ -52,4 +54,4 @@
       "defaultChoice": "local"
     }
   }
-}
+}

package/dist/plan-execute-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-execute-tool.d.ts","sourceRoot":"","sources":["../src/plan-execute-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EAEf,MAAM,8BAA8B,CAAC;AAKtC,eAAO,MAAM,iBAAiB;;EAK7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB,QAQzB,CAAC;AAuBb,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,YAAY,CA+ClG"}