openclaw-sc 5.38.0

package/lib/task-checker.js

@@ -0,0 +1,317 @@
+/**
+ * 🔍 提示词质量检查 — Task Specificity Checker
+ *
+ * 检测子agent任务描述是否过于具体（过度约束），
+ * 导致子agent不会变通、机械执行。
+ *
+ * 三级检测：
+ *   L1 — 步骤关键词（"步骤1""首先""然后" 等）
+ *   L2 — 具体命令（"exec""git clone""npm install" 等）
+ *   L3 — 结构分析（步骤段落字数 vs 目标段落字数）
+ *
+ * checkTaskOverSpecificity(taskDescription):
+ *   返回 { level: "safe"|"warn", reasons: [string], suggestion: string }
+ */
+
+// ====== L1 检测：步骤关键词 ======
+
+/** 步骤指示词正则 */
+const L1_STEP_PATTERNS = [
+  // 中文步骤
+  /\b步骤\s*[0-9一二三四五六七八九十零]+\b/u,
+  /\b第[一二三四五六七八九十零]+步\b/u,
+  // 中文顺序词
+  /\b首先\b/u,
+  /\b然后\b/u,
+  /\b接着\b/u,
+  /\b最后\b/u,
+  /\b先\b[\s\S]{0,20}再\b/u,
+  // 中文明确编号步骤
+  /^\s*[0-9一二三四五六七八九十零]+[.、．、\s]/mu,
+  /^(第一步|第二步|第三步|第四步|第五步|第六步|第七步|第八步|第九步)/mu,
+  // 英文步骤
+  /\b(?:first(?:ly)?|second(?:ly)?|third(?:ly)?|fourth(?:ly)?|fifth(?:ly)?)\b/i,
+  /\bstep\s+[0-9]+\b/i,
+  /\b(?:then|next|finally|afterwards|subsequently)\b/i,
+  // 短句步骤标记
+  /^\s*[0-9]+[\.\)]\s+/mu,
+];
+
+/** 过度步骤关键词计数阈值 */
+const L1_THRESHOLD = 3;
+
+/**
+ * L1检测：步骤关键词
+ * @param {string} text
+ * @returns {string[]} 匹配到的原因列表
+ */
+function detectL1(text) {
+  const reasons = [];
+  let matchCount = 0;
+  const seen = new Set();
+
+  for (const re of L1_STEP_PATTERNS) {
+    let match;
+    re.lastIndex = 0;
+    while ((match = re.exec(text)) !== null) {
+      const kw = match[0].trim();
+      if (!seen.has(kw)) {
+        seen.add(kw);
+        matchCount++;
+      }
+      // 防止无限循环
+      if (match.index === re.lastIndex) re.lastIndex++;
+    }
+  }
+
+  if (matchCount >= L1_THRESHOLD) {
+    reasons.push(`检测到 ${matchCount} 个步骤指示词（阈值: ${L1_THRESHOLD}），可能过度指定执行步骤`);
+  } else if (matchCount > 0) {
+    // 少量步骤词不报 warn，但记录观察
+    return reasons;
+  }
+
+  return reasons;
+}
+
+// ====== L2 检测：具体命令 ======
+
+const L2_COMMAND_PATTERNS = [
+  // Shell 命令
+  /\bexec\b/,
+  /\bgit\s+clone\b/,
+  /\bgit\s+checkout\b/,
+  /\bgit\s+pull\b/,
+  /\bgit\s+push\b/,
+  /\bnpm\s+install\b/,
+  /\bnpm\s+run\b/,
+  /\bnpx\b/,
+  /\byarn\s+(add|install|run)\b/,
+  /\bpip\s+install\b/,
+  /\bcd\s+/,
+  /\bmkdir\s+[\-p]?\s*-p\b/,
+  /\btouch\s+/,
+  /\brm\s+[\-rf]?\s*-rf\b/,
+  /\bcp\s+[\-rf]?\s*-r\b/,
+  /\bmv\s+/,
+  /\bchmod\s+/,
+  /\bsed\s+/,
+  /\bgrep\s+/,
+  /\bawk\s+/,
+  /\bcat\s+/,
+  /\becho\s+/,
+  /\bcurl\s+/,
+  /\bwget\s+/,
+  // 编程操作
+  /\bimport\s+\{/,
+  /\brequire\s*\(/,
+  /\bfs\.readFileSync\b/,
+  /\bwriteFile\s*\(/,
+  /\bPromise\.all\b/,
+  // 路径指定
+  /[A-Za-z]:\\[\\\w\-\.]+/,
+  /\.\.\/|\.\//,
+  // 工具调用
+  /\bcpu_/,
+  /\bsessions_spawn\b/,
+  /\bmemory_get\b/,
+  /\btavily_search\b/,
+  /\bweb_fetch\b/,
+  // 系统操作
+  /\bStop-Process\b/,
+  /\bStart-Process\b/,
+  /\bGet-ChildItem\b/,
+  /\bSet-Content\b/,
+  /\bAdd-Content\b/,
+  /\bschtasks\b/,
+];
+
+/** L2 命令检测阈值 */
+const L2_THRESHOLD = 2;
+
+/**
+ * L2检测：具体命令
+ * @param {string} text
+ * @returns {string[]} 匹配到的原因列表
+ */
+function detectL2(text) {
+  const reasons = [];
+  let matchCount = 0;
+  const seenCmds = new Set();
+
+  for (const re of L2_COMMAND_PATTERNS) {
+    let match;
+    re.lastIndex = 0;
+    while ((match = re.exec(text)) !== null) {
+      const cmd = match[0].trim().substring(0, 30);
+      if (!seenCmds.has(cmd)) {
+        seenCmds.add(cmd);
+        matchCount++;
+      }
+      if (match.index === re.lastIndex) re.lastIndex++;
+    }
+  }
+
+  if (matchCount >= L2_THRESHOLD) {
+    reasons.push(`检测到 ${matchCount} 个具体命令（阈值: ${L2_THRESHOLD}），可能过度指定实现方式`);
+  }
+
+  return reasons;
+}
+
+// ====== L3 结构分析 ======
+
+/**
+ * 估算段落是"步骤说明"还是"目标说明"
+ * 步骤说明：含具体操作动词、编号、命令
+ * 目标说明：含目标、目的、背景、需求描述
+ */
+function estimateParagraphType(paragraph) {
+  const stepIndicators = [
+    /\b步骤/u, /\b第.*步/u, /\b首先\b/u, /\b然后\b/u, /\b(?:exec|install|clone|mkdir|write|create)\b/i,
+    /^\s*[0-9][\.\)]/m, /\bgit\b/, /\bnpm\b/, /\bcd \b/, /\brun\b/i, /\b执行\b/u, /\b调用\b/u,
+  ];
+  const goalIndicators = [
+    /\b目标\b/u, /\b目的\b/u, /\b背景\b/u, /\b需求\b/u, /\b实现\b/u, /\b任务[：:]\b/u,
+    /\bgoal\b/i, /\bpurpose\b/i, /\bobjective\b/i, /\boverview\b/i, /\bsummary\b/i,
+    /\b的作用\b/u, /\b用于\b/u, /\b需求是\b/u, /\b需要实现\b/u,
+  ];
+
+  let stepScore = 0;
+  let goalScore = 0;
+  const lines = paragraph.split('\n').filter(l => l.trim());
+
+  for (const line of lines) {
+    for (const re of stepIndicators) {
+      if (re.test(line)) stepScore++;
+    }
+    for (const re of goalIndicators) {
+      if (re.test(line)) goalScore++;
+    }
+  }
+
+  return { stepScore, goalScore, type: stepScore > goalScore ? 'step' : 'goal' };
+}
+
+/**
+ * L3检测：步骤段落 vs 目标段落比例
+ * @param {string} text
+ * @returns {string[]} 原因列表
+ */
+function detectL3(text) {
+  const reasons = [];
+  const paragraphs = text.split('\n\n').filter(p => p.trim().length > 20);
+
+  if (paragraphs.length < 2) {
+    return reasons; // 单段落无法做结构比较
+  }
+
+  let stepWordCount = 0;
+  let goalWordCount = 0;
+  let stepParaCount = 0;
+  let goalParaCount = 0;
+  let totalWords = 0;
+
+  for (const para of paragraphs) {
+    const { type } = estimateParagraphType(para);
+    const paraWords = para.replace(/[\s]/g, '').length; // 去空白算中文字符或有效字符
+
+    if (type === 'step') {
+      stepWordCount += paraWords;
+      stepParaCount++;
+    } else {
+      goalWordCount += paraWords;
+      goalParaCount++;
+    }
+    totalWords += paraWords;
+  }
+
+  if (totalWords === 0) return reasons;
+
+  const stepRatio = stepWordCount / Math.max(totalWords, 1);
+  const goalRatio = goalWordCount / Math.max(totalWords, 1);
+
+  // 步骤段落占比超过 60% → 警告
+  if (stepRatio > 0.6 && stepParaCount >= 2) {
+    reasons.push(
+      `步骤说明占比 ${(stepRatio * 100).toFixed(0)}%（目标说明仅 ${(goalRatio * 100).toFixed(0)}%），` +
+      `任务描述偏向"怎么做"而非"做什么"`
+    );
+  }
+
+  // 步骤段落数远超目标段落数
+  if (stepParaCount >= 3 && (stepParaCount / Math.max(goalParaCount, 1)) > 2) {
+    reasons.push(
+      `步骤段落 ${stepParaCount} 段是目标段落 ${goalParaCount} 段的 ${(stepParaCount / Math.max(goalParaCount, 1)).toFixed(1)} 倍` +
+      `，过度关注执行细节`
+    );
+  }
+
+  return reasons;
+}
+
+// ====== 建议生成 ======
+
+/**
+ * 根据检测原因生成建议
+ * @param {string[]} reasons
+ * @returns {string} 建议内容
+ */
+function generateSuggestion(reasons) {
+  if (reasons.length === 0) return '';
+
+  const suggestions = [];
+
+  if (reasons.some(r => r.includes('步骤指示词'))) {
+    suggestions.push('减少步骤关键词（"首先""然后""步骤X"），改为描述目标而非过程');
+  }
+  if (reasons.some(r => r.includes('具体命令'))) {
+    suggestions.push('用"使用XX工具"替代具体命令，让子agent自行选择实现方式');
+  }
+  if (reasons.some(r => r.includes('步骤说明占比'))) {
+    suggestions.push('增加"目标/目的/背景"说明，压缩"怎么做"部分的篇幅');
+  }
+
+  if (suggestions.length > 0) {
+    return '🔧 建议：' + suggestions.join('；');
+  }
+
+  return '建议减少过程指定，增加目标说明，给子agent更多自主空间';
+}
+
+// ====== 主入口 ======
+
+/**
+ * 检查任务描述是否过度具体化
+ *
+ * @param {string} taskDescription - 任务描述文本
+ * @returns {{ level: "safe"|"warn", reasons: string[], suggestion: string }}
+ *
+ * level:
+ *   "safe" — 不过度具体，适合子agent灵活执行
+ *   "warn" — 过度具体，建议放宽约束
+ *
+ * reasons: 检测到的具体问题列表
+ * suggestion: 改善建议（level="warn" 时有值）
+ */
+export function checkTaskOverSpecificity(taskDescription) {
+  if (!taskDescription || typeof taskDescription !== 'string' || taskDescription.trim().length === 0) {
+    return { level: 'safe', reasons: [], suggestion: '' };
+  }
+
+  const allReasons = [
+    ...detectL1(taskDescription),
+    ...detectL2(taskDescription),
+    ...detectL3(taskDescription),
+  ];
+
+  if (allReasons.length === 0) {
+    return { level: 'safe', reasons: [], suggestion: '' };
+  }
+
+  return {
+    level: 'warn',
+    reasons: allReasons,
+    suggestion: generateSuggestion(allReasons),
+  };
+}

package/lib/task-profiles.js

@@ -0,0 +1,255 @@
+/**
+ * 🧬 sc 任务配置文件 — 工具类型→并发/模型/thinking 映射
+ *
+ * 核心设计：
+ *   1. 所有模型名从 openclaw.json 动态读取（agents.defaults.model.primary），不写死任何模型ID
+ *   2. 按任务类别划分：搜索/编码/分析/配置/批量/视觉/系统
+ *   3. 每种类别定义推荐并发度、batchSize、maxWorkers、thinking预算
+ *   4. 导出 getTaskProfile(toolName) 和 core_pickSubagentModel(toolName)
+ *
+ * v1.1 — 2026-06-09 空catch修复 + 类型安全
+ */
+
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// ====== Config cache ======
+/** @type {object|null} */
+let _configCache = null;
+let _configCacheTime = 0;
+const CONFIG_CACHE_TTL = 30000;
+
+/**
+ * 读取并缓存 openclaw.json
+ * @returns {Promise<object|null>} 配置对象或 null
+ */
+async function readOpenClawConfig() {
+  const now = Date.now();
+  if (_configCache && now - _configCacheTime < CONFIG_CACHE_TTL) return _configCache;
+  try {
+    const content = await readFile(join(homedir(), '.openclaw', 'openclaw.json'), 'utf-8');
+    _configCache = JSON.parse(content);
+    _configCacheTime = now;
+  } catch (err) {
+    // 🔧 空catch修复: 记录读取/解析失败原因
+    if (typeof console !== 'undefined' && console.warn) {
+      const reason = err?.code === 'ENOENT' ? '配置文件不存在' : (err?.message || '未知错误');
+      console.warn(`[task-profiles] 读取 openclaw.json 失败: ${reason}`);
+    }
+    _configCache = null;
+    _configCacheTime = now;
+  }
+  return _configCache;
+}
+
+/**
+ * 清除配置缓存（让下一次读取重新加载）
+ */
+export function clearProfileCache() {
+  _configCache = null;
+  _configCacheTime = 0;
+}
+
+/**
+ * 从系统配置读取 primary 模型
+ * @returns {Promise<{full: string|null, provider: string|null, model: string|null}>}
+ */
+async function getPrimaryModel() {
+  const cfg = await readOpenClawConfig();
+  if (!cfg) return { full: null, provider: null, model: null };
+  const modelStr = cfg?.agents?.defaults?.model?.primary || null;
+  if (!modelStr) return { full: null, provider: null, model: null };
+  const parts = modelStr.split('/');
+  return {
+    full: modelStr,
+    provider: parts[0] || null,
+    model: parts[1] || parts[0],
+  };
+}
+
+// ====== 任务类别枚举 ======
+export const TASK_CATEGORIES = {
+  SEARCH: 'search',
+  CODING: 'coding',
+  ANALYSIS: 'analysis',
+  CONFIG: 'config',
+  BATCH: 'batch',
+  VISION: 'vision',
+  SYSTEM: 'system',
+};
+
+// ====== 工具名 → 类别映射 ======
+const TOOL_CATEGORY_MAP = {
+  // 搜索查询类
+  cpu_search: TASK_CATEGORIES.SEARCH,
+  cpu_scan: TASK_CATEGORIES.SEARCH,
+  cpu_semanticSearch: TASK_CATEGORIES.SEARCH,
+  cpu_dialogRecall: TASK_CATEGORIES.SEARCH,
+
+  // 编码类
+  cpu_codeEdit: TASK_CATEGORIES.CODING,
+  cpu_codeReview: TASK_CATEGORIES.CODING,
+  cpu_bugFix: TASK_CATEGORIES.CODING,
+
+  // 分析类
+  cpu_diff: TASK_CATEGORIES.ANALYSIS,
+  cpu_diagnose: TASK_CATEGORIES.ANALYSIS,
+  cpu_research: TASK_CATEGORIES.ANALYSIS,
+  cpu_orchestrate: TASK_CATEGORIES.ANALYSIS,
+
+  // 配置类
+  cpu_resolveModel: TASK_CATEGORIES.CONFIG,
+
+  // 批量调度类
+  cpu_batch: TASK_CATEGORIES.BATCH,
+  core_dispatch: TASK_CATEGORIES.BATCH,
+
+  // 视觉分析类
+  core_batchVision: TASK_CATEGORIES.VISION,
+
+  // 系统管理类
+  core_stats: TASK_CATEGORIES.SYSTEM,
+  core_routeTask: TASK_CATEGORIES.SYSTEM,
+  cpu_routeEvidence: TASK_CATEGORIES.SYSTEM,
+  cpu_evolution: TASK_CATEGORIES.SYSTEM,
+  cpu_chainDetect: TASK_CATEGORIES.SYSTEM,
+  cpu_cerebellumStatus: TASK_CATEGORIES.SYSTEM,
+  cpu_monitorSubagents: TASK_CATEGORIES.SYSTEM,
+  core_backup: TASK_CATEGORIES.SYSTEM,
+  core_about: TASK_CATEGORIES.SYSTEM,
+  core_emergencyStop: TASK_CATEGORIES.SYSTEM,
+  cpu_compressTask: TASK_CATEGORIES.SYSTEM,
+};
+
+// ====== 各类别推荐配置 ======
+const CATEGORY_PROFILES = {
+  [TASK_CATEGORIES.SEARCH]: {
+    concurrency: 8,
+    batchSize: 5,
+    maxWorkers: 28,
+    thinking: 'off',
+    label: '搜索查询类',
+  },
+  [TASK_CATEGORIES.CODING]: {
+    concurrency: 4,
+    batchSize: 3,
+    maxWorkers: 16,
+    thinking: 'high',
+    label: '编码类',
+  },
+  [TASK_CATEGORIES.ANALYSIS]: {
+    concurrency: 4,
+    batchSize: 4,
+    maxWorkers: 8,
+    thinking: 'medium',
+    label: '分析类',
+  },
+  [TASK_CATEGORIES.CONFIG]: {
+    concurrency: 2,
+    batchSize: 1,
+    maxWorkers: 4,
+    thinking: 'off',
+    label: '配置类',
+  },
+  [TASK_CATEGORIES.BATCH]: {
+    concurrency: 6,
+    batchSize: 4,
+    maxWorkers: 20,
+    thinking: 'off',
+    label: '批量调度类',
+  },
+  [TASK_CATEGORIES.VISION]: {
+    concurrency: 3,
+    batchSize: 3,
+    maxWorkers: 6,
+    thinking: 'low',
+    label: '视觉分析类',
+  },
+  [TASK_CATEGORIES.SYSTEM]: {
+    concurrency: 2,
+    batchSize: 1,
+    maxWorkers: 3,
+    thinking: 'off',
+    label: '系统管理类',
+  },
+};
+
+/**
+ * 获取工具的推荐配置
+ * @param {string} toolName - 工具名，如 'core_search'
+ * @returns {{ category: string, concurrency: number, batchSize: number, maxWorkers: number, thinking: string, label: string }}
+ */
+export function getTaskProfile(toolName) {
+  const category = TOOL_CATEGORY_MAP[toolName] || TASK_CATEGORIES.SYSTEM;
+  const profile = CATEGORY_PROFILES[category] || CATEGORY_PROFILES[TASK_CATEGORIES.SYSTEM];
+  return {
+    category,
+    ...profile,
+  };
+}
+
+/**
+ * 获取工具名对应的类别
+ * @param {string} toolName
+ * @returns {string}
+ */
+export function getTaskCategory(toolName) {
+  return TOOL_CATEGORY_MAP[toolName] || TASK_CATEGORIES.SYSTEM;
+}
+
+/**
+ * 获取所有类别定义
+ * @returns {Object}
+ */
+export function getCategoryProfiles() {
+  return { ...CATEGORY_PROFILES };
+}
+
+/**
+ * 获取工具→类别映射
+ * @returns {Object}
+ */
+export function getToolCategoryMap() {
+  return { ...TOOL_CATEGORY_MAP };
+}
+
+/**
+ * 🧠 为子 agent 选取推荐模型和 thinking 级别
+ *
+ * 所有模型名从系统配置（openclaw.json → agents.defaults.model.primary）动态读取，
+ * 不写死任何模型ID。
+ *
+ * 规则：
+ *   - 搜索类 → thinking=off
+ *   - 编码类 → thinking=high
+ *   - 分析类 → thinking=low
+ *   - 视觉类 → thinking=low
+ *   - 其他类 → thinking=off
+ *
+ * @param {string} toolName - 工具名
+ * @returns {Promise<{ model: string|null, provider: string|null, modelId: string|null, thinking: string, category: string, label: string }>}
+ */
+export async function core_pickSubagentModel(toolName) {
+  const primary = await getPrimaryModel();
+  const profile = getTaskProfile(toolName);
+
+  return {
+    model: primary.full || null,
+    provider: primary.provider,
+    modelId: primary.model,
+    thinking: profile.thinking,
+    category: profile.category,
+    label: profile.label,
+  };
+}
+
+export default {
+  getTaskProfile,
+  getTaskCategory,
+  getCategoryProfiles,
+  getToolCategoryMap,
+  core_pickSubagentModel,
+  clearProfileCache,
+  TASK_CATEGORIES,
+};