@xgjktech/xg-openclaw-harness-tools 0.4.9 → 0.4.10

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+BA,QAAA,MAAM,WAAW,kEA6Df,CAAC;AAaH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiDA,QAAA,MAAM,WAAW,kEAkEf,CAAC;AAeH,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+import { Type } from "typebox";
 import { defineToolPlugin } from "openclaw/plugin-sdk/tool-plugin";
 import { isSubagentSessionKey } from "openclaw/plugin-sdk/routing";
 import { resolvePlanDbPath, SqlitePlanStore, SqliteActionStore } from "@xgjktech/xg-openclaw-shared";
@@ -7,6 +8,18 @@ import { ACTION_DISPATCH_DESCRIPTION, ActionDispatchParams, buildActionDispatchT
 import { toPlanOrigin } from "./plan-origin.js";
 import { buildPlanPromptInjection } from "./plan-prompt.js";
 const PLUGIN_ID = "xg-harness-tools";
+// 计划功能总开关：默认 false（关闭 xg_plan_write / xg_plan_view 及主动建计划 prompt 注入）。
+// 代码与测试保留，部署时在插件配置里设 { "enablePlan": true } 即可重新启用。
+const PluginConfigSchema = Type.Object({
+    enablePlan: Type.Optional(Type.Boolean({
+        default: false,
+        description: "启用 xg 计划工具（xg_plan_write / xg_plan_view）与主动建计划 prompt 注入。默认 false。",
+    })),
+});
+/** 计划功能是否启用：仅显式 true 才开启，缺省/其他值一律视为关闭。 */
+function isPlanEnabled(pluginConfig) {
+    return pluginConfig?.enablePlan === true;
+}
 // 临时诊断日志：确认 subagent 会话的 sessionKey 是否到达 hook/tool factory 且判定正确。确认后删除。
 function logPlanGate(api, tag, sessionKey) {
     api.runtime?.logging
@@ -20,6 +33,7 @@ const pluginEntry = defineToolPlugin({
     id: PLUGIN_ID,
     name: "XG Harness Tools",
     description: "企业工具插件：计划管理与通用动作分发（plan_write / plan_view / action_dispatch）",
+    configSchema: PluginConfigSchema,
     tools: (tool) => {
         let planStore;
         let actionStore;
@@ -44,9 +58,12 @@ const pluginEntry = defineToolPlugin({
                 description: PLAN_WRITE_DESCRIPTION,
                 parameters: PlanWriteParams,
                 optional: true,
-                factory: ({ api, toolContext }) => {
-                    // 计划只允许主 agent 维护；subagent 会话不注册计划工具，杜绝其建计划。
+                factory: ({ api, config, toolContext }) => {
+                    // 计划功能默认关闭；仅显式 enablePlan:true 时注册。
                     logPlanGate(api, "plan_write_factory", toolContext.sessionKey);
+                    if (!config.enablePlan)
+                        return null;
+                    // 计划只允许主 agent 维护；subagent 会话不注册计划工具，杜绝其建计划。
                     if (isSubagentSessionKey(toolContext.sessionKey))
                         return null;
                     return buildPlanWriteTool(getPlanStore(api), toPlanOrigin(toolContext));
@@ -58,8 +75,11 @@ const pluginEntry = defineToolPlugin({
                 description: PLAN_VIEW_DESCRIPTION,
                 parameters: PlanViewParams,
                 optional: true,
-                factory: ({ api, toolContext }) => {
+                factory: ({ api, config, toolContext }) => {
+                    // 计划功能默认关闭；仅显式 enablePlan:true 时注册。
                     logPlanGate(api, "plan_view_factory", toolContext.sessionKey);
+                    if (!config.enablePlan)
+                        return null;
                     if (isSubagentSessionKey(toolContext.sessionKey))
                         return null;
                     return buildPlanViewTool({ store: getPlanStore(api), origin: toPlanOrigin(toolContext) });
@@ -81,6 +101,9 @@ const pluginEntry = defineToolPlugin({
 const baseRegister = pluginEntry.register;
 pluginEntry.register = (api) => {
     baseRegister(api);
+    // 计划功能默认关闭时，不注入主动建计划纪律。
+    if (!isPlanEnabled(api.pluginConfig))
+        return;
     api.on("before_prompt_build", (event, ctx) => {
         logPlanGate(api, "hook", ctx.sessionKey);
         return buildPlanPromptInjection(event, ctx);

package/openclaw.plugin.json

@@ -6,7 +6,13 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": true,
-    "properties": {}
+    "properties": {
+      "enablePlan": {
+        "type": "boolean",
+        "default": false,
+        "description": "启用 xg 计划工具（xg_plan_write / xg_plan_view）与主动建计划 prompt 注入。默认 false。"
+      }
+    }
   },
   "contracts": {
     "tools": ["xg_plan_write", "xg_plan_view", "xg_action_dispatch"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg-openclaw-harness-tools",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "企业工具插件：plan_write / plan_view / action_dispatch（OpenClaw 第三方工具插件）",
   "license": "MIT",
   "type": "module",