codewave-openclaw-installer 2.1.12 → 2.2.0

package/bin/install-lib.mjs

@@ -142,6 +142,17 @@ export function resolvePromptDefault({
   return defaultYes;
 }
 
+export function preserveEnabledTruePreference(beforeSection = {}, afterSection = {}) {
+  if (beforeSection?.enabled === true) {
+    return {
+      ...afterSection,
+      enabled: true,
+    };
+  }
+
+  return { ...afterSection };
+}
+
 export function evaluateChannelDetection(channelDefinition, detection) {
   const desktopApps = detection.desktopApps ?? [];
   const hasDesktopApps = desktopApps.length > 0;

package/bin/install.mjs

@@ -19,6 +19,7 @@ import {
   getCoreBootstrapPlan,
   getDesktopAppCandidates,
   getPipxBootstrapPlan,
+  preserveEnabledTruePreference,
   resolvePromptDefault,
   shouldDryRun,
 } from './install-lib.mjs';
@@ -133,6 +134,44 @@ function readJson(filePath) {
   }
 }
 
+function ensurePluginTrusted(pluginId) {
+  if (DRY_RUN) {
+    return false;
+  }
+
+  const config = readJson(OPENCLAW_CONFIG_PATH) || {};
+  const currentPlugins = config.plugins || {};
+  const allow = Array.isArray(currentPlugins.allow) ? [...currentPlugins.allow] : [];
+  const entries = { ...(currentPlugins.entries || {}) };
+  let changed = false;
+
+  if (!allow.includes(pluginId)) {
+    allow.push(pluginId);
+    changed = true;
+  }
+
+  const currentEntry = entries[pluginId] || {};
+  if (currentEntry.enabled !== true) {
+    entries[pluginId] = { ...currentEntry, enabled: true };
+    changed = true;
+  }
+
+  if (!changed) {
+    return false;
+  }
+
+  const nextConfig = {
+    ...config,
+    plugins: {
+      ...currentPlugins,
+      allow,
+      entries,
+    },
+  };
+  writeFileSync(OPENCLAW_CONFIG_PATH, `${JSON.stringify(nextConfig, null, 2)}\n`, 'utf8');
+  return true;
+}
+
 function stripFeishuAccounts(section = {}) {
   const { accounts: _accountsIgnored, ...base } = section;
   return base;
@@ -211,7 +250,7 @@ function mergeFeishuBindings(beforeSection = {}, afterSection = {}) {
     addedCount += 1;
   }
 
-  const mergedSection = { ...afterBase };
+  const mergedSection = preserveEnabledTruePreference(beforeBase, { ...afterBase });
   if (Object.keys(mergedAccounts).length > 0) {
     mergedSection.accounts = mergedAccounts;
   }
@@ -1090,6 +1129,24 @@ async function runExtensionInstall(context) {
     return;
   }
 
+  if (await commandExists('openclaw')) {
+    console.log(dim(`  优先使用 OpenClaw 官方插件安装流程注册 ${extensionId}...`));
+    const installCode = await run('openclaw', ['plugins', 'install', PKG_ROOT]);
+    if (installCode === 0) {
+      ensurePluginTrusted(extensionId);
+      console.log(green('  ✅ OpenClaw 官方插件安装成功'));
+      contextResult(context, 'extension', 'ok');
+      console.log('');
+      console.log(dim('  Skills 将由 OpenClaw 自动从扩展目录加载:'));
+      for (const skill of SKILL_SUMMARIES) {
+        console.log(dim(`    • ${skill}`));
+      }
+      return;
+    }
+
+    console.log(yellow('  ⚠️ 官方插件安装失败，回退到目录复制模式'));
+  }
+
   try {
     cpSync(PKG_ROOT, extensionTarget, {
       recursive: true,
@@ -1101,6 +1158,7 @@ async function runExtensionInstall(context) {
           && base !== '__MACOSX';
       },
     });
+    ensurePluginTrusted(extensionId);
     console.log(green('  ✅ OpenClaw 扩展安装成功'));
     console.log(dim(`  路径: ${extensionTarget}`));
     contextResult(context, 'extension', 'ok');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codewave-openclaw-installer",
-  "version": "2.1.12",
+  "version": "2.2.0",
   "description": "网易智企 CodeWave OpenClaw 扩展：Skills + CLI 依赖一键安装",
   "type": "module",
   "main": "index.js",
@@ -9,6 +9,17 @@
     "codewave-install": "bin/install.mjs",
     "codewave-check": "bin/check.mjs"
   },
+  "openclaw": {
+    "id": "codewave-toolkit",
+    "extensions": [
+      "./index.js"
+    ],
+    "install": {
+      "npmSpec": "codewave-openclaw-installer",
+      "localPath": ".",
+      "defaultChoice": "npm"
+    }
+  },
   "files": [
     "index.js",
     "bin/",

package/skills/acceptance-doc-entry/SKILL.md

@@ -190,7 +190,60 @@ razel-py-cli acceptance-toolkit finalize --task-dir <TASK_DIR> --confirmed
 
 仅当用户明确表示"不需要确认映射，直接生成"时，才可使用 `revise` 一步到位。
 
-**核心原则**：Agent 只做编排调度，不理解文档内容。读 result.json → 跟着 `next_action` 走 → 向用户展示 `user_prompt` + 结构化数据。每次 plan 完成后必须等用户确认再 build。
+**核心原则**：默认情况下，Agent 以编排调度为主，不直接承担整包大素材的深度通读。读 result.json → 跟着 `next_action` 走 → 向用户展示 `user_prompt` + 结构化数据。每次 plan 完成后必须等用户确认再 build。
+
+## 大素材并行处理
+
+当素材体量较大、类型较杂，或一次性让单个 Agent 完整通读会明显变慢时，优先启用“主智能体 + 子智能体”并行模式。
+
+### 触发条件
+
+满足任一条件即可触发：
+- 素材文件数 >= 8
+- 预计需要处理的总字数 >= 30000
+- 同时包含 3 种及以上素材类型（如 DOCX、PDF、XLSX、图片、聊天记录、录音转写）
+- 单次素材梳理预计超过 3 分钟
+- 用户明确表示“素材很多”“先并行处理”“用子智能体拆分”
+
+### 执行原则
+
+- 主智能体负责：扫描素材清单、确定拆分维度、创建子智能体、汇总结果、消解冲突、决定是否进入 CLI `plan`
+- 子智能体负责：只处理分配到的素材子集，提取与验收模板有关的信息，不直接生成最终验收文档
+- 优先按“文件”或“主题”切分；只有在单文件过大时，才按章节切分
+- 如果素材强依赖上下文，先由主智能体建立全局索引或总览，再把子问题分发给子智能体
+- 不要把整包大素材原样丢给单个子智能体，也不要让多个子智能体同时产出同一个章节的最终版本
+
+### 给 openClaw 的提示词要求
+
+当触发大素材并行处理时，在调用或驱动 openClaw 时，应显式加入类似约束：
+
+```text
+当前素材包较大，请不要单线程完整通读全部素材。先按文件或主题拆分任务，创建多个子智能体并行提炼信息。每个子智能体只负责自己的素材范围，输出结构化摘要、验收项映射、证据来源、风险和待确认项。主智能体最后统一去重、合并冲突，并基于汇总结果决定是否继续执行 acceptance-toolkit 的 plan/build/finalize。
+```
+
+如果素材彼此高度依赖，可将提示词改为：
+
+```text
+当前素材包较大且跨文件依赖较强。请先建立全局素材索引，再将可独立的问题拆给子智能体并行处理。不要直接让单个智能体通读全部素材后再输出最终结论。
+```
+
+### 子智能体输出格式
+
+每个子智能体必须返回以下结构化内容：
+
+1. `scope`：本子智能体负责的素材范围
+2. `summary`：与验收文档相关的关键信息摘要
+3. `section_candidates`：可映射到模板章节的候选内容
+4. `evidence`：对应证据位置或原始素材来源
+5. `risks`：信息冲突、缺失、低置信度项
+6. `open_questions`：需要主智能体或用户补充确认的问题
+
+### 汇总门禁
+
+- 只有主智能体可以产出最终映射结论或触发 `build`
+- 若子智能体之间出现冲突，主智能体必须先合并或标记待确认，不能直接进入 `build`
+- 若大部分章节仍缺证据支撑，应先提示用户补充素材，再执行后续命令
+- 并行提炼的目标是“缩短素材理解时间”，不是跳过 `result.json` 和 `next_action` 驱动的正式流程
 
 ### needs_llm_fallback 处理