@fieldwangai/agentflow 0.1.25

package/bin/lib/i18n.mjs

@@ -0,0 +1,233 @@
+/**
+ * AgentFlow CLI i18n 模块
+ * 支持通过 LANG 环境变量或 --lang 参数切换语言
+ */
+
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import path from "path";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/** 支持的语言列表 */
+export const SUPPORTED_LANGUAGES = ["en", "zh"];
+
+/**
+ * 检测系统语言
+ * - 优先使用 LANG/LANGUAGE 环境变量
+ * - macOS/Linux: process.env.LANG (如 zh_CN.UTF-8)
+ * - Windows: process.env.LANGUAGE 或 LC_ALL
+ * @returns {string}
+ */
+function detectSystemLanguage() {
+  const envLang = process.env.LANG || process.env.LANGUAGE || process.env.LC_ALL || "";
+  // 处理形如 zh_CN.UTF-8、en_US.UTF-8 的格式
+  const langCode = envLang.split(".")[0].split("_")[0].toLowerCase();
+  // 默认使用英文，仅在检测到中文时使用中文
+  if (langCode === "zh") return "zh";
+  if (SUPPORTED_LANGUAGES.includes(langCode)) return langCode;
+  return "en";
+}
+
+/** 默认语言（跟随系统） */
+export const DEFAULT_LANGUAGE = detectSystemLanguage();
+
+/** 当前语言 */
+let currentLang = DEFAULT_LANGUAGE;
+
+/** 已加载的语言包缓存 */
+const localeCache = new Map();
+
+/**
+ * 从环境变量解析语言（兼容旧 API）
+ * @returns {string}
+ */
+function detectLanguageFromEnv() {
+  return detectSystemLanguage();
+}
+
+/**
+ * 初始化 i18n
+ * @param {string} [lang] - 指定语言，如不提供则使用环境变量检测
+ */
+export function initI18n(lang) {
+  currentLang = lang || detectLanguageFromEnv();
+  if (!SUPPORTED_LANGUAGES.includes(currentLang)) {
+    currentLang = DEFAULT_LANGUAGE;
+  }
+  // 清空缓存以重新加载
+  localeCache.clear();
+}
+
+/**
+ * 设置当前语言
+ * @param {string} lang
+ */
+export function setLanguage(lang) {
+  if (SUPPORTED_LANGUAGES.includes(lang)) {
+    currentLang = lang;
+    localeCache.clear();
+  }
+}
+
+/**
+ * 获取当前语言
+ * @returns {string}
+ */
+export function getLanguage() {
+  return currentLang;
+}
+
+/**
+ * 加载语言包
+ * @param {string} lang
+ * @returns {object}
+ */
+function loadLocale(lang) {
+  if (localeCache.has(lang)) {
+    return localeCache.get(lang);
+  }
+
+  try {
+    const filePath = path.join(__dirname, "locales", `${lang}.json`);
+    const content = readFileSync(filePath, "utf-8");
+    const locale = JSON.parse(content);
+    localeCache.set(lang, locale);
+    return locale;
+  } catch (err) {
+    // 如果加载失败，返回空对象（会使用回退逻辑）
+    return {};
+  }
+}
+
+/**
+ * 获取翻译文本
+ * @param {string} key - 键名，支持嵌套如 "flow.not_found"
+ * @param {object} [vars] - 插值变量
+ * @returns {string}
+ */
+export function t(key, vars = {}) {
+  const locale = loadLocale(currentLang);
+  const fallbackLocale = loadLocale(DEFAULT_LANGUAGE);
+
+  // 解析嵌套键
+  const keys = key.split(".");
+  let value = locale;
+  let fallbackValue = fallbackLocale;
+
+  for (const k of keys) {
+    value = value?.[k];
+    fallbackValue = fallbackValue?.[k];
+  }
+
+  // 如果没有找到翻译，使用回退语言或键名
+  let text = value || fallbackValue || key;
+
+  // 处理插值 {{varName}}
+  if (vars && typeof text === "string") {
+    text = text.replace(/\{\{(\w+)\}\}/g, (match, varName) => {
+      return vars[varName] !== undefined ? String(vars[varName]) : match;
+    });
+  }
+
+  return text;
+}
+
+/**
+ * 批量翻译多个键
+ * @param {string[]} keys
+ * @returns {object}
+ */
+export function tBatch(keys) {
+  const result = {};
+  for (const key of keys) {
+    result[key] = t(key);
+  }
+  return result;
+}
+
+// 初始化（使用环境变量检测）
+initI18n();
+
+/** 中文 type 到英文 key 的映射 */
+export const TYPE_ZH_TO_KEY = {
+  节点: "node",
+  文本: "text",
+  文件: "file",
+  bool: "bool",
+  布尔: "bool",
+};
+
+/** 英文 key 到中文 type 的映射 */
+export const TYPE_KEY_TO_ZH = {
+  node: "节点",
+  text: "文本",
+  file: "文件",
+  bool: "布尔",
+};
+
+/** 中文 role 到英文 key 的映射 */
+export const ROLE_ZH_TO_KEY = {
+  普通: "normal",
+  技术规划: "planning",
+  代码执行: "code",
+  测试回归: "test",
+  需求拆解: "requirement",
+};
+
+/** 英文 key 到中文 role 的映射 */
+export const ROLE_KEY_TO_ZH = {
+  normal: "普通",
+  planning: "技术规划",
+  code: "代码执行",
+  test: "测试回归",
+  requirement: "需求拆解",
+};
+
+/**
+ * 翻译类型名称（支持中英文互转）
+ * @param {string} typeOrKey - 中文类型名或英文 key
+ * @returns {string} 当前语言对应的类型名
+ */
+export function translateType(typeOrKey) {
+  const key = TYPE_ZH_TO_KEY[typeOrKey] || typeOrKey;
+  return t(`type.${key}`);
+}
+
+/**
+ * 翻译角色名称（支持中英文互转）
+ * @param {string} roleOrKey - 中文角色名或英文 key
+ * @returns {string} 当前语言对应的角色名
+ */
+export function translateRole(roleOrKey) {
+  const key = ROLE_ZH_TO_KEY[roleOrKey] || roleOrKey;
+  return t(`role.${key}`);
+}
+
+/**
+ * 获取类型的英文 key（用于内部存储）
+ * @param {string} typeOrKey - 中文类型名或英文 key
+ * @returns {string} 英文 key
+ */
+export function normalizeTypeToKey(typeOrKey) {
+  return TYPE_ZH_TO_KEY[typeOrKey] || typeOrKey;
+}
+
+/**
+ * 获取角色的英文 key（用于内部存储）
+ * @param {string} roleOrKey - 中文角色名或英文 key
+ * @returns {string} 英文 key
+ */
+export function normalizeRoleToKey(roleOrKey) {
+  return ROLE_ZH_TO_KEY[roleOrKey] || roleOrKey;
+}
+
+/**
+ * 翻译节点定义字段
+ * @param {string} definitionId - 节点定义 ID
+ * @param {"displayName" | "description"} field - 字段名
+ * @returns {string}
+ */
+export function translateNodeDef(definitionId, field) {
+  return t(`nodeDef.${definitionId}.${field}`);
+}

package/bin/lib/locales/en.json

@@ -0,0 +1,344 @@
+{
+  "meta": {
+    "name": "English",
+    "code": "en"
+  },
+  "common": {
+    "loading": "Loading...",
+    "error": "Error",
+    "success": "Success",
+    "warning": "Warning",
+    "info": "Info",
+    "done": "Done",
+    "cancel": "Cancel",
+    "confirm": "Confirm",
+    "yes": "Yes",
+    "no": "No",
+    "save": "Save",
+    "delete": "Delete",
+    "edit": "Edit",
+    "create": "Create",
+    "close": "Close",
+    "back": "Back",
+    "next": "Next",
+    "prev": "Previous",
+    "search": "Search",
+    "filter": "Filter",
+    "refresh": "Refresh",
+    "copy": "Copy",
+    "copied": "Copied",
+    "not_found": "Not found",
+    "required": "Required",
+    "optional": "Optional",
+    "total": "Total",
+    "local": "Local",
+    "default": "Default"
+  },
+  "cli": {
+    "description": "AgentFlow CLI — drive apply/replay with Cursor or OpenCode CLI streaming",
+    "usage": "Usage",
+    "commands": "Commands",
+    "options": "Options",
+    "requires": "Requires",
+    "examples": "Examples"
+  },
+  "flow": {
+    "name": "Flow",
+    "list": "List all pipelines",
+    "apply": "Apply flow",
+    "replay": "Replay node",
+    "resume": "Resume flow",
+    "validate": "Validate flow",
+    "not_found": "Flow not found: {{name}}",
+    "invalid": "Invalid flow",
+    "running": "Flow is running",
+    "completed": "Flow completed",
+    "failed": "Flow failed",
+    "pending": "Flow pending",
+    "ready_nodes": "Ready nodes",
+    "no_ready_nodes": "No ready nodes",
+    "node_start": "Starting node: {{label}} ({{instanceId}})",
+    "node_done": "Node completed: {{label}} ({{instanceId}})",
+    "node_failed": "Node failed: {{label}} ({{instanceId}}) - {{error}}",
+    "extract_thinking": "Extract thinking content",
+    "dry_run_nodes": "[--dry-run] Would execute nodes: {{nodes}}. Omit --dry-run to run.",
+    "stuck_error": "No ready nodes and not all done; flow may be stuck.",
+    "paused": "Paused",
+    "resume_hint": "To resume, run:"
+  },
+  "node": {
+    "name": "Node",
+    "status": {
+      "success": "Success",
+      "failed": "Failed",
+      "pending": "Pending",
+      "running": "Running",
+      "skipped": "Skipped"
+    },
+    "types": {
+      "agent": "Agent Node",
+      "control": "Control Node",
+      "tool": "Tool Node"
+    },
+    "start": "[START] Node",
+    "end": "[END] Node",
+    "start_parallel": "[START] Parallel execution",
+    "end_parallel": "[END] All parallel nodes completed",
+    "model_label": "Model",
+    "done_label": "Done",
+    "failed_label": "Failed"
+  },
+  "apply": {
+    "done": "Apply done",
+    "paused": "Paused",
+    "stuck": "Flow may be stuck",
+    "resume_command": "To resume, run:",
+    "user_confirmed": "User confirmed to continue (including retry failed)"
+  },
+  "catalog": {
+    "builtin_agent_not_found": "Built-in agent not found",
+    "name_already_exists": "Name already exists, please choose another",
+    "agent_not_found": "Agent not found",
+    "invalid_agent_id": "Invalid agent id (needs to be filename-safe)",
+    "builtin_flow_not_found": "Built-in flow not found",
+    "builtin_flow_archive_not_supported": "Built-in pipelines do not support archive view",
+    "builtin_flow_archive_path_not_supported": "Built-in pipelines do not support archive path",
+    "type_text": "Text",
+    "pipeline_header": "Pipeline",
+    "source_header": "Source",
+    "apply_example_header": "Apply Example"
+  },
+  "composer": {
+    "edit_context": "## AgentFlow Edit Context",
+    "tool_nodejs_rules_title": "## tool_nodejs Node Writing Rules (Must Follow)",
+    "tool_nodejs_rules_body": "The core of `definitionId: tool_nodejs` is the **`script` field**—must write a complete executable shell/node command.\n- `script`: Pipeline spawns directly, stdout becomes result, exit code determines success/failure\n- `body`: When `script` exists, it serves only as human-readable comment, **will NOT be executed**\n- `script` supports `${}` placeholders referencing input slots and system variables (workspaceRoot, runDir, etc.), values are auto shell-quoted\n- **Do NOT** wrap `${workspaceRoot}` etc. with extra double quotes (e.g., `node \"${workspaceRoot}/...\"`); write `node ${workspaceRoot}/...` instead, otherwise path will contain extra quotes causing execution failure\n- **Forbidden** to only write natural language description in `body` without `script`—this leads to no executable code at runtime\n- If logic is too complex to write complete `script`, use `agent_subAgent` instead (also change definitionId)",
+    "task_title": "## Task",
+    "task_instruction": "Please complete only the above single task, no extra modifications. After completion, sync UI per context instructions.",
+    "validation_passed": "flow validation passed",
+    "validation_passed_detail": "✓ flow.yaml validation passed (validate-flow)",
+    "validation_failed": "flow validation failed, attempting auto-fix...",
+    "fix_task_title": "## Task: Fix flow.yaml to pass validate-flow",
+    "fix_errors_intro": "The following errors must be **all eliminated** (same rules as CLI `agentflow validate` / `validate-flow.mjs`):",
+    "fix_constraints_title": "### Constraints",
+    "fix_constraints_body": "- **Only** edit the \"flow definition file\" `flow.yaml` in context, do not modify unrelated files.\n- Prefer minimal changes: add edges, fix sourceHandle/targetHandle, role, model, instance structure, etc.",
+    "analyzing_task": "Analyzing task…",
+    "validation_repair": "Validation repair: agent attempt {{attempt}}/{{max}}…",
+    "validation_repair_start": "🔧 Starting validation repair ({{attempt}}/{{max}})…",
+    "validation_repair_auto_success": "(auto-repair succeeded)",
+    "skip_validation_for_phase": "Skipping validation for current phase (will validate at final phase)",
+    "all_phases_complete": "All phases complete",
+    "phase_complete_waiting": "{{label}} complete, waiting for confirmation…",
+    "current_phase": "Phase {{index}}",
+    "all_steps_complete": "All steps complete",
+    "multi_step_failed": "Multi-step execution failed: {{message}}",
+    "multi_step_starting": "Multi-step mode starting…",
+    "classify_failed": "[CLASSIFY_FAIL] Task classification failed: {{message}}"
+  },
+  "runner": {
+    "cursor_account_limit": "[agentflow] Cursor account limit: detected Auto-only support, auto-retrying once (Auto)...",
+    "generating_reply": "Generating reply...",
+    "thinking": "Thinking...",
+    "completed": "Completed",
+    "execution_failed": "Execution failed",
+    "event_label": "Event",
+    "tool_call": "Tool call ({{subtype}})",
+    "base64_data": "[cursor-stdout] (base64 data, {{len}} chars)",
+    "non_json_line": "(non-JSON) {{preview}}",
+    "unparsed_line": "(unparsed line, {{len}} chars)",
+    "opencode_exit_code": "OpenCode exit code {{code}}",
+    "done": "Done"
+  },
+  "tool": {
+    "nodejs_script_hint": "script success/failure determined by exit code (0=success), stdout directly becomes result slot content (plain text, e.g., console.log).",
+    "nodejs_heal_retry": "[tool_nodejs self-heal] {{instanceId}} retry {{attempt}}/{{maxRetries}}: {{detail}}"
+  },
+  "planner": {
+    "heuristic_analysis": "Heuristic task analysis (configure OPENAI_API_KEY or ANTHROPIC_API_KEY to enable smart planning)",
+    "planning": "Planning task ({{model}})…",
+    "planner_format_error": "Planner returned unexpected format, falling back to single-step",
+    "planner_call_failed": "Planner call failed ({{message}}), falling back to heuristic analysis",
+    "phased_planning": "Phased planning: {{label}} ({{index}}/{{total}})…",
+    "phased_cli_exec": "Phased: {{label}} (CLI execution)",
+    "phased_format_error": "Phased planner returned unexpected format, using default agent step",
+    "phased_planning_failed": "Phased planning failed ({{message}}), using default agent step"
+  },
+  "api": {
+    "node_context_marker": "## Node Context",
+    "task_marker": "## Execution Task"
+  },
+  "ui": {
+    "server_start": "UI server started",
+    "server_listening": "Server listening on port {{port}}",
+    "open_browser": "Open browser",
+    "projects": "Projects & Pipelines",
+    "flow_editor": "Flow Editor",
+    "settings": "Settings"
+  },
+  "error": {
+    "generic": "Error occurred: {{message}}",
+    "file_not_found": "File not found: {{path}}",
+    "invalid_args": "Invalid arguments",
+    "missing_required": "Missing required field: {{field}}",
+    "exec_failed": "Execution failed: {{command}}",
+    "network_error": "Network error",
+    "permission_denied": "Permission denied",
+    "read_flow_failed": "Failed to read flow",
+    "read_node_library_failed": "Failed to read node library",
+    "save_failed": "Save failed",
+    "move_failed": "Move failed"
+  },
+  "env": {
+    "cursor_not_cached": "Not cached",
+    "cursor_cached": "Model list cached",
+    "opencode_not_found": "Not found",
+    "opencode_ready": "Ready",
+    "service_normal": "Service normal",
+    "service_abnormal": "Some interfaces abnormal"
+  },
+  "type": {
+    "node": "Node",
+    "text": "Text",
+    "file": "File",
+    "bool": "Boolean"
+  },
+  "role": {
+    "normal": "Normal",
+    "planning": "Planning",
+    "code": "Code",
+    "test": "Test",
+    "requirement": "Requirement"
+  },
+  "nodeDef": {
+    "control_start": {
+      "displayName": "Start",
+      "description": "Entry point of AgentFlow, all flows should start from this node"
+    },
+    "control_end": {
+      "displayName": "End",
+      "description": "End point of AgentFlow, flow terminates after this node"
+    },
+    "agent_subAgent": {
+      "displayName": "SubAgent",
+      "description": "Execute tasks using SubAgent"
+    },
+    "tool_user_ask": {
+      "displayName": "UserAsk",
+      "description": "Pause and wait for the user to pick one of N branches. Each output slot is an option; the slot description is the option label (human-driven switch)."
+    },
+    "tool_user_check": {
+      "displayName": "User Confirm",
+      "description": "Wait for user confirmation, flow pauses. Requires user to reply 'continue' to resume"
+    },
+    "control_if": {
+      "displayName": "If Branch",
+      "description": "Has exactly one bool type input. Continues to next1 if true, next2 if false"
+    },
+    "control_anyOne": {
+      "displayName": "Any One",
+      "description": "Continues to next when any upstream input is ready"
+    },
+    "control_toBool": {
+      "displayName": "To Bool",
+      "description": "Execute script to produce true/false prediction. Like tool_nodejs but enforces bool output. Extensible inputs."
+    },
+    "control_agent_toBool": {
+      "displayName": "Agent ToBool",
+      "description": "AI-powered boolean judgment for non-deterministic scenarios"
+    },
+    "tool_nodejs": {
+      "displayName": "Node.js Script",
+      "description": "Execute Node.js script, success determined by exit code, stdout as result"
+    },
+    "tool_print": {
+      "displayName": "Print",
+      "description": "Output content to user with special font style"
+    },
+    "tool_get_env": {
+      "displayName": "Get Env",
+      "description": "Get environment variable value"
+    },
+    "tool_save_key": {
+      "displayName": "Save Key",
+      "description": "Save key-value pair to global storage"
+    },
+    "tool_load_key": {
+      "displayName": "Load Key",
+      "description": "Load key-value from global storage"
+    },
+    "provide_str": {
+      "displayName": "Text",
+      "description": "Provide a text value directly, value will be passed to downstream as-is"
+    },
+    "provide_file": {
+      "displayName": "File",
+      "description": "Provide file path or content directly, value will be passed to downstream as-is"
+    }
+  },
+  "pipeline": {
+    "module-migrate": {
+      "description": "Module migration pipeline (Define scope -> Confirm -> Migrate -> Static loop -> Compile loop -> Output document)",
+      "start": { "label": "Start", "body": "Flow entry" },
+      "scope": { "label": "Define Migration Scope" },
+      "user_confirm_scope": { "label": "User Confirm Scope" },
+      "migrate": { "label": "Execute Migration" },
+      "anyOne_static": { "label": "AnyOne (Static Loop Entry)" },
+      "anyOne_gradle": { "label": "AnyOne (Compile Loop Entry)" },
+      "ai_check_ref": { "label": "AI Check References" },
+      "agent_sum_error": { "label": "Summarize Issues" },
+      "gradle_build": { "label": "Gradle Build" },
+      "fix_dynamic": { "label": "Fix Build Issues" },
+      "output_doc": { "label": "Output Document" },
+      "end": { "label": "End", "body": "Flow exit" },
+      "provide_key_ready_file": { "label": "KeyReadyFile" },
+      "provide_key_module_name": { "label": "KeyModuleName" },
+      "tool_save_ready_file": { "label": "Ready Files List" },
+      "tool_save_module_name": { "label": "Module Name" },
+      "agent_new_module": { "label": "Create Module" },
+      "tool_static_analy": { "label": "Static Analysis" },
+      "if_static": { "label": "If Static Check" },
+      "LoadFile": { "label": "Migration File List" },
+      "agent_fix_todo": { "label": "Fix TODO Items" },
+      "control_toBool_static_bool": { "label": "Static Check Result Conversion" },
+      "control_if_task_gradle": { "label": "If Task Complete" },
+      "control_toBool_gradle_bool": { "label": "List Complete Result" },
+      "control_if_fixed": { "label": "If Fix Complete" },
+      "to_bool_fix_all": { "label": "Check If All Fixed" },
+      "control_anyOne_start_fix": { "label": "Fix Entry" },
+      "tool_print_module": { "label": "Print Summary" },
+      "gradle_tasks": { "label": "Get Java/Kotlin Build Tasks" }
+    },
+    "figma-restore": {
+      "description": "Figma design restoration pipeline",
+      "Start": { "label": "Start" },
+      "FigmaURL": { "label": "FigmaURL" },
+      "FigmaToken": { "label": "FigmaToken" },
+      "script_check": { "label": "Script Self Check" },
+      "get_figma_tree": { "label": "Get Figma Node Tree and Screenshots" },
+      "ai_semantic": { "label": "AI Semantic Analysis of Screenshot Structure" },
+      "restore_by_depth": { "label": "Restore by Tree Depth Traversal" },
+      "export_resources": { "label": "Export img/icon Resources" },
+      "summarize": { "label": "Summarize Delivery JSON" },
+      "End": { "label": "End" }
+    },
+    "new": {
+      "description": "New pipeline",
+      "control_start_new": { "label": "Start" },
+      "agent_plan": { "label": "Plan Nodes" },
+      "agent_create": { "label": "Create Flow" },
+      "control_end_new": { "label": "End" },
+      "provide_skills_file": { "label": "Layout Skills" },
+      "provide_requirement": { "label": "Requirements" },
+      "agent_fix": { "label": "Fix Nodes" },
+      "agent_implement_script": { "label": "Complete Code" },
+      "tool_user_check": { "label": "UserCheck" },
+      "control_anyOne": { "label": "AnyOne" },
+      "provide_flow": { "label": "Flows Skills" },
+      "provide_newFlow_key_save": { "label": "Flow Key Name" },
+      "provide_newFlow_key_load": { "label": "Flow Key Name" },
+      "agent_ai_check_tool": { "label": "AI Check Tools" },
+      "AI_CHECK_FILE": { "label": "AI Check Files" },
+      "control_if_check": { "label": "If Check" },
+      "control_toBool_check": { "label": "Check Result" }
+    }
+  }
+}