@fieldwangai/agentflow 0.1.28 → 0.1.30

package/bin/lib/flow-write.mjs

@@ -68,11 +68,11 @@ export function buildEmptyUserFlowYaml(options = {}) {
  * @param {string} workspaceRoot
  * @param {FlowWriteSource} source
  */
-function getPipelinesRootByWriteSource(workspaceRoot, source) {
+function getPipelinesRootByWriteSource(workspaceRoot, source, opts = {}) {
   if (source === "workspace") {
     return path.join(path.resolve(workspaceRoot), PIPELINES_DIR);
   }
-  return getUserPipelinesRoot();
+  return getUserPipelinesRoot(opts.userId);
 }
 
 /**
@@ -94,7 +94,7 @@ function resolveExistingWorkspaceFlowDir(workspaceRoot, flowId) {
  * @param {FlowWriteSource} flowSource
  * @returns {{ flowDir: string, error?: string }}
  */
-export function resolveFlowDirForWrite(workspaceRoot, flowId, flowSource) {
+export function resolveFlowDirForWrite(workspaceRoot, flowId, flowSource, opts = {}) {
   if (!workspaceRoot || !flowId) {
     return { flowDir: "", error: "workspaceRoot and flowId are required" };
   }
@@ -125,7 +125,7 @@ export function resolveFlowDirForWrite(workspaceRoot, flowId, flowSource) {
     }
   }
 
-  const pipelinesRoot = getPipelinesRootByWriteSource(workspaceRoot, flowSource);
+  const pipelinesRoot = getPipelinesRootByWriteSource(workspaceRoot, flowSource, opts);
   const flowDir = path.join(pipelinesRoot, flowId);
   const resolvedFlowDir = path.resolve(flowDir);
   const baseWithSep = boundariesBase.endsWith(path.sep) ? boundariesBase : boundariesBase + path.sep;
@@ -148,7 +148,7 @@ export function resolveFlowDirForWrite(workspaceRoot, flowId, flowSource) {
  * @param {FlowWriteSource} flowSource
  * @returns {{ flowDir: string, error?: string }}
  */
-export function resolveArchivedFlowDirForWrite(workspaceRoot, flowId, flowSource) {
+export function resolveArchivedFlowDirForWrite(workspaceRoot, flowId, flowSource, opts = {}) {
   if (!workspaceRoot || !flowId) {
     return { flowDir: "", error: "workspaceRoot and flowId are required" };
   }
@@ -176,7 +176,7 @@ export function resolveArchivedFlowDirForWrite(workspaceRoot, flowId, flowSource
     }
   }
 
-  const pipelinesRoot = getPipelinesRootByWriteSource(workspaceRoot, flowSource);
+  const pipelinesRoot = getPipelinesRootByWriteSource(workspaceRoot, flowSource, opts);
   const flowDir = path.join(pipelinesRoot, ARCHIVED_PIPELINES_DIR_NAME, flowId);
   const resolvedFlowDir = path.resolve(flowDir);
   const baseWithSep = boundariesBase.endsWith(path.sep) ? boundariesBase : boundariesBase + path.sep;
@@ -197,8 +197,8 @@ export function resolveArchivedFlowDirForWrite(workspaceRoot, flowId, flowSource
 export function writeFlowYaml(workspaceRoot, flowId, flowSource, flowYaml, opts = {}) {
   const archived = Boolean(opts.archived);
   const { flowDir, error } = archived
-    ? resolveArchivedFlowDirForWrite(workspaceRoot, flowId, flowSource)
-    : resolveFlowDirForWrite(workspaceRoot, flowId, flowSource);
+    ? resolveArchivedFlowDirForWrite(workspaceRoot, flowId, flowSource, opts)
+    : resolveFlowDirForWrite(workspaceRoot, flowId, flowSource, opts);
   if (error) return { success: false, error };
   try {
     fs.mkdirSync(flowDir, { recursive: true });
@@ -217,11 +217,11 @@ export function writeFlowYaml(workspaceRoot, flowId, flowSource, flowYaml, opts
  * @param {FlowWriteSource} flowSource
  * @returns {{ success: true } | { success: false, error: string }}
  */
-export function archiveFlowPipeline(workspaceRoot, flowId, flowSource) {
+export function archiveFlowPipeline(workspaceRoot, flowId, flowSource, opts = {}) {
   if (flowSource !== "user" && flowSource !== "workspace") {
     return { success: false, error: "仅支持用户目录或工作区流水线归档" };
   }
-  const yamlRes = getFlowYamlAbs(workspaceRoot, flowId, flowSource, { archived: false });
+  const yamlRes = getFlowYamlAbs(workspaceRoot, flowId, flowSource, { archived: false, userId: opts.userId });
   if (yamlRes.error || !yamlRes.path) {
     return { success: false, error: yamlRes.error || "找不到流水线" };
   }
@@ -230,7 +230,7 @@ export function archiveFlowPipeline(workspaceRoot, flowId, flowSource) {
   if (fromDir.split(sep).includes(ARCHIVED_PIPELINES_DIR_NAME)) {
     return { success: false, error: "该流水线已在归档目录中" };
   }
-  const toRes = resolveArchivedFlowDirForWrite(workspaceRoot, flowId, flowSource);
+  const toRes = resolveArchivedFlowDirForWrite(workspaceRoot, flowId, flowSource, opts);
   if (toRes.error || !toRes.flowDir) {
     return { success: false, error: toRes.error || "无法解析归档路径" };
   }
@@ -255,7 +255,7 @@ export function archiveFlowPipeline(workspaceRoot, flowId, flowSource) {
  * @param {"user" | "workspace"} toSource
  * @returns {{ success: true, flowSource: "user" | "workspace" } | { success: false, error: string }}
  */
-export function moveFlowDirectory(workspaceRoot, flowId, fromSource, toSource) {
+export function moveFlowDirectory(workspaceRoot, flowId, fromSource, toSource, opts = {}) {
   if (fromSource === toSource) {
     return { success: false, error: "fromSource and toSource must differ" };
   }
@@ -267,16 +267,16 @@ export function moveFlowDirectory(workspaceRoot, flowId, fromSource, toSource) {
   }
   let fromDir;
   if (fromSource === "workspace") {
-    const w = resolveFlowDirForWrite(workspaceRoot, flowId, "workspace");
+    const w = resolveFlowDirForWrite(workspaceRoot, flowId, "workspace", opts);
     if (w.error || !w.flowDir) return { success: false, error: w.error || "invalid source path" };
     fromDir = resolveExistingWorkspaceFlowDir(workspaceRoot, flowId);
     if (!fromDir) return { success: false, error: "source flow not found" };
   } else {
-    const fromRes = resolveFlowDirForWrite(workspaceRoot, flowId, fromSource);
+    const fromRes = resolveFlowDirForWrite(workspaceRoot, flowId, fromSource, opts);
     if (fromRes.error || !fromRes.flowDir) return { success: false, error: fromRes.error || "invalid source path" };
     fromDir = fromRes.flowDir;
   }
-  const toRes = resolveFlowDirForWrite(workspaceRoot, flowId, toSource);
+  const toRes = resolveFlowDirForWrite(workspaceRoot, flowId, toSource, opts);
   if (toRes.error || !toRes.flowDir) return { success: false, error: toRes.error || "invalid target path" };
   const toDir = toRes.flowDir;
   if (!fs.existsSync(path.join(fromDir, FLOW_YAML_FILENAME))) {
@@ -301,7 +301,7 @@ export function moveFlowDirectory(workspaceRoot, flowId, fromSource, toSource) {
  * @param {string} flowId
  * @returns {{ ok: true } | { ok: false, error: string }}
  */
-function assertFlowDirIsSafeToDelete(flowDir, workspaceRoot, flowSource, flowId) {
+function assertFlowDirIsSafeToDelete(flowDir, workspaceRoot, flowSource, flowId, opts = {}) {
   let realDir;
   try {
     realDir = fs.realpathSync(flowDir);
@@ -316,9 +316,9 @@ function assertFlowDirIsSafeToDelete(flowDir, workspaceRoot, flowSource, flowId)
   const allowedRoots = [];
   if (flowSource === "user") {
     try {
-      allowedRoots.push(fs.realpathSync(getUserPipelinesRoot()));
+      allowedRoots.push(fs.realpathSync(getUserPipelinesRoot(opts.userId)));
     } catch {
-      allowedRoots.push(path.resolve(getUserPipelinesRoot()));
+      allowedRoots.push(path.resolve(getUserPipelinesRoot(opts.userId)));
     }
     for (const rel of [PIPELINES_DIR, LEGACY_PIPELINES_DIR]) {
       const base = path.join(root, rel);
@@ -379,12 +379,12 @@ export function deleteFlowPipeline(workspaceRoot, flowId, flowSource, opts = {})
     return { success: false, error: "invalid flowId" };
   }
   const archived = Boolean(opts.archived);
-  const yamlRes = getFlowYamlAbs(workspaceRoot, flowId, flowSource, { archived });
+  const yamlRes = getFlowYamlAbs(workspaceRoot, flowId, flowSource, { archived, userId: opts.userId });
   if (yamlRes.error || !yamlRes.path) {
     return { success: false, error: yamlRes.error || "找不到流水线" };
   }
   const flowDir = path.dirname(yamlRes.path);
-  const guard = assertFlowDirIsSafeToDelete(flowDir, workspaceRoot, flowSource, flowId);
+  const guard = assertFlowDirIsSafeToDelete(flowDir, workspaceRoot, flowSource, flowId, opts);
   if (!guard.ok) return { success: false, error: guard.error };
   try {
     fs.rmSync(flowDir, { recursive: true, force: true });

package/bin/lib/help.mjs

@@ -17,7 +17,7 @@ AgentFlow CLI — 使用 Cursor / OpenCode / Claude Code CLI 流式输出驱动
   agentflow list-remote [--search <q>] [--sort popular|trending] [--json]  浏览 Hub 上的流程
   agentflow download <slug|title> [--user|--workspace] [--as <id>] [--raw [--output <dir>]]  从 Hub 下载流程（默认 --user 安装到 ~/agentflow/pipelines/<id>；--workspace 安装到当前工程 .workspace/agentflow/pipelines/<id>；--raw 仅保留压缩包）
   agentflow list                              列出所有流水线
-  agentflow ui [--host <addr>] [--port <n>] [--scheduler] [--no-open]  本地 HTTP：流水线列表 + React Flow 节点流程图编辑保存（默认 127.0.0.1:8765；可用 AGENTFLOW_UI_HOST）
+  agentflow ui [--host <addr>] [--port <n>] [--scheduler] [--no-open] [--hide-community-links]  本地 HTTP：流水线列表 + React Flow 节点流程图编辑保存（默认 127.0.0.1:8765；可用 AGENTFLOW_UI_HOST）
   agentflow scheduler start [--poll-ms <ms>]  启动定时执行调度器（读取各流水线 schedule.json）
   agentflow scheduler status [--json]         查看定时执行配置与状态
   agentflow scheduler cancel <FlowName> <uuid>  取消某次等待中的 watch/run
@@ -86,7 +86,7 @@ Usage:
   agentflow list-remote [--search <q>] [--sort popular|trending] [--json]  Browse flows on Hub
   agentflow download <slug|title> [--user|--workspace] [--as <id>] [--raw [--output <dir>]]  Download flow (default --user → ~/agentflow/pipelines/<id>; --workspace → current project's .workspace/agentflow/pipelines/<id>; --raw keeps the archive)
   agentflow list                              List all pipelines
-  agentflow ui [--host <addr>] [--port <n>] [--scheduler] [--no-open]  Local HTTP: pipeline list + React Flow node diagram editor (default 127.0.0.1:8765; AGENTFLOW_UI_HOST supported)
+  agentflow ui [--host <addr>] [--port <n>] [--scheduler] [--no-open] [--hide-community-links]  Local HTTP: pipeline list + React Flow node diagram editor (default 127.0.0.1:8765; AGENTFLOW_UI_HOST supported)
   agentflow scheduler start [--poll-ms <ms>]  Start the scheduled-run scheduler (reads each pipeline schedule.json)
   agentflow scheduler status [--json]         Show scheduled-run configuration and state
   agentflow scheduler cancel <FlowName> <uuid>  Cancel a waiting watch/run

package/bin/lib/locales/en.json

@@ -111,7 +111,7 @@
   "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)",
+    "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, pipelineWorkspace, runDir, etc.), values are auto shell-quoted; after CD Workspace, `${workspaceRoot}` is the current execution workspace and `${pipelineWorkspace}` is the pipeline workspace\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",
@@ -265,6 +265,18 @@
       "displayName": "Agent ToBool",
       "description": "AI-powered boolean judgment for non-deterministic scenarios"
     },
+    "control_cd_workspace": {
+      "displayName": "CD Workspace",
+      "description": "Switch downstream execution to another workspace context without changing the pipeline workspace"
+    },
+    "control_load_skills": {
+      "displayName": "Load Skills",
+      "description": "Load SKILL.md files from the current workspace, pipeline workspace, explicit paths, or both"
+    },
+    "tool_git_checkout": {
+      "displayName": "Git Checkout",
+      "description": "Clone or update a Git repository and expose it as a workspace context"
+    },
     "tool_nodejs": {
       "displayName": "Node.js Script",
       "description": "Execute Node.js script, success determined by exit code, stdout as result"
@@ -285,6 +297,18 @@
       "displayName": "Load Key",
       "description": "Load key-value from global storage"
     },
+    "display_markdown": {
+      "displayName": "Markdown Display",
+      "description": "Render Markdown content on the Workspace canvas and pass the text downstream"
+    },
+    "display_mermaid": {
+      "displayName": "Mermaid Display",
+      "description": "Render Mermaid diagram source on the Workspace canvas and pass the source downstream"
+    },
+    "display_ascii": {
+      "displayName": "ASCII Display",
+      "description": "Render ASCII diagram text on the Workspace canvas and pass the text downstream"
+    },
     "provide_str": {
       "displayName": "Text",
       "description": "Provide a text value directly, value will be passed to downstream as-is"

package/bin/lib/locales/zh.json

@@ -111,7 +111,7 @@
   "composer": {
     "edit_context": "## AgentFlow 编辑上下文",
     "tool_nodejs_rules_title": "## tool_nodejs 节点编写规则（必须遵守）",
-    "tool_nodejs_rules_body": "`definitionId: tool_nodejs` 的核心是 **`script` 字段**——必须写完整可执行的 shell/node 命令。\n- **类型选择自检**（写 script 前先问自己）：这事**确定性**吗？相同输入永远产出相同输出、可用普通代码完整描述？是 → 继续写 script；否（需要语义理解/代码翻译/LLM 推理）→ **该节点选错了类型**，应改 `definitionId: agent_subAgent`，删 `script` 字段，任务描述写到 `body`。反例：『Android→RN 页面转换』『代码 review』『生成测试用例』必须 agent。\n- `script`：流水线直接 spawn 执行，stdout 作为 result，exit code 决定成败\n- `body`：有 `script` 时仅作人类可读注释，**不会被执行**\n- `script` 支持 `${}` 占位符引用 input 槽位和系统变量（workspaceRoot、runDir 等），值自动 shell-quote\n- **不要**再对 `${workspaceRoot}` 等占位符外包双引号（如 `node \"${workspaceRoot}/...\"`）；应写 `node ${workspaceRoot}/...`，否则路径会含多余引号导致执行失败\n- **禁止**只在 `body` 中写自然语言描述而不写 `script`——这会导致节点运行时无代码可执行",
+    "tool_nodejs_rules_body": "`definitionId: tool_nodejs` 的核心是 **`script` 字段**——必须写完整可执行的 shell/node 命令。\n- **类型选择自检**（写 script 前先问自己）：这事**确定性**吗？相同输入永远产出相同输出、可用普通代码完整描述？是 → 继续写 script；否（需要语义理解/代码翻译/LLM 推理）→ **该节点选错了类型**，应改 `definitionId: agent_subAgent`，删 `script` 字段，任务描述写到 `body`。反例：『Android→RN 页面转换』『代码 review』『生成测试用例』必须 agent。\n- `script`：流水线直接 spawn 执行，stdout 作为 result，exit code 决定成败\n- `body`：有 `script` 时仅作人类可读注释，**不会被执行**\n- `script` 支持 `${}` 占位符引用 input 槽位和系统变量（workspaceRoot、pipelineWorkspace、runDir 等），值自动 shell-quote；接了 CD Workspace 后 `${workspaceRoot}` 表示当前执行工作区，`${pipelineWorkspace}` 表示流水线工作区\n- **不要**再对 `${workspaceRoot}` 等占位符外包双引号（如 `node \"${workspaceRoot}/...\"`）；应写 `node ${workspaceRoot}/...`，否则路径会含多余引号导致执行失败\n- **禁止**只在 `body` 中写自然语言描述而不写 `script`——这会导致节点运行时无代码可执行",
     "task_title": "## 任务",
     "task_instruction": "请只完成上述单一任务，不要做额外修改。完成后按上下文中的指引同步 UI。",
     "validation_passed": "flow 校验已通过",
@@ -265,6 +265,18 @@
       "displayName": "AI 转布尔",
       "description": "由 AI 判断输入内容的布尔含义，适用于不确定性场景"
     },
+    "control_cd_workspace": {
+      "displayName": "CD 工作区",
+      "description": "切换下游节点的执行工作区上下文，不改变流水线所在工作区"
+    },
+    "control_load_skills": {
+      "displayName": "加载 Skills",
+      "description": "从当前工作区、流水线工作区、显式路径或组合来源加载 SKILL.md"
+    },
+    "tool_git_checkout": {
+      "displayName": "Git 拉取",
+      "description": "克隆或更新 Git 仓库，并输出可供下游使用的工作区上下文"
+    },
     "tool_nodejs": {
       "displayName": "Node.js 脚本",
       "description": "执行 Node.js 脚本，以 exit code 判断成败，stdout 作为结果"
@@ -285,6 +297,18 @@
       "displayName": "加载键值",
       "description": "从全局存储加载键值"
     },
+    "display_markdown": {
+      "displayName": "Markdown 展示",
+      "description": "在 Workspace 画布中渲染 Markdown 内容，并将文本继续传给下游"
+    },
+    "display_mermaid": {
+      "displayName": "Mermaid 展示",
+      "description": "在 Workspace 画布中渲染 Mermaid 图，并将源码继续传给下游"
+    },
+    "display_ascii": {
+      "displayName": "ASCII 图展示",
+      "description": "在 Workspace 画布中渲染等宽 ASCII 图，并将文本继续传给下游"
+    },
     "provide_str": {
       "displayName": "文本",
       "description": "直接提供一段文本，value 会原样供下游引用"

package/bin/lib/main.mjs

@@ -346,6 +346,7 @@ export async function main() {
     let host = process.env.AGENTFLOW_UI_HOST || "127.0.0.1";
     let schedulerEnabled = false;
     let schedulerPollMs;
+    let hideCommunityLinks = /^(1|true|yes|on)$/i.test(String(process.env.AGENTFLOW_HIDE_COMMUNITY_LINKS || ""));
     const portIdx = argv.indexOf("--port");
     if (portIdx >= 0 && argv[portIdx + 1]) {
       port = parseInt(argv[portIdx + 1], 10);
@@ -371,13 +372,17 @@ export async function main() {
     }
     const noOpen = argv.includes("--no-open");
     if (noOpen) argv.splice(argv.indexOf("--no-open"), 1);
+    if (argv.includes("--hide-community-links")) {
+      hideCommunityLinks = true;
+      argv.splice(argv.indexOf("--hide-community-links"), 1);
+    }
     if (Number.isNaN(port) || port <= 0 || port > 65535) {
       throw new Error("Invalid --port (use 1–65535)");
     }
     if (!host) {
       throw new Error("Invalid --host");
     }
-    await startUiServer({ workspaceRoot, port, host });
+    await startUiServer({ workspaceRoot, port, host, hideCommunityLinks });
     if (schedulerEnabled) {
       startScheduler(workspaceRoot, { pollMs: schedulerPollMs }).catch((e) => {
         log.error("Scheduler failed: " + ((e && e.message) || String(e)));

package/bin/lib/node-exec-context.mjs

@@ -18,13 +18,13 @@ import {
  * @param {string} [runId] - specific uuid; if empty, picks the latest run
  * @returns {{ ok: boolean, rounds: Array, runId?: string, error?: string }}
  */
-export function getNodeExecContext(workspaceRoot, flowId, instanceId, runId) {
+export function getNodeExecContext(workspaceRoot, flowId, instanceId, runId, opts = {}) {
   let uuid = runId;
   let runDir = "";
   if (uuid) {
-    runDir = getRunDirCandidates(workspaceRoot, flowId, uuid).find((p) => fs.existsSync(p)) || "";
+    runDir = getRunDirCandidates(workspaceRoot, flowId, uuid, opts).find((p) => fs.existsSync(p)) || "";
   } else {
-    const latest = findLatestRunDir(workspaceRoot, flowId);
+    const latest = findLatestRunDir(workspaceRoot, flowId, opts);
     uuid = latest.uuid;
     runDir = latest.runDir;
   }
@@ -38,9 +38,9 @@ export function getNodeExecContext(workspaceRoot, flowId, instanceId, runId) {
   return { ok: true, rounds, runId: uuid };
 }
 
-function findLatestRunDir(workspaceRoot, flowId) {
+function findLatestRunDir(workspaceRoot, flowId, opts = {}) {
   const roots = [
-    path.join(getFlowRuntimeRoot(workspaceRoot, flowId), "runBuild"),
+    path.join(getFlowRuntimeRoot(workspaceRoot, flowId, opts), "runBuild"),
     path.join(getWorkspaceRunBuildRoot(workspaceRoot), flowId),
     path.join(getLegacyUserRunBuildRoot(), flowId),
   ];

package/bin/lib/node-execute.mjs

@@ -152,11 +152,11 @@ async function healToolNodejsWithAI(workspaceRoot, flowName, uuid, instanceId, r
  * 协议：与 run-tool-nodejs.mjs 一致——validate-script-output 解析 stdout；
  * JSON 时 message 的每个键写入同名 output 槽位（含 result）；纯文本则等价于 message.result。
  */
-async function executeToolNodejsInline(workspaceRoot, flowName, uuid, instanceId, resolvedScript, execId, healOptions) {
+async function executeToolNodejsInline(workspaceRoot, flowName, uuid, instanceId, resolvedScript, execId, healOptions, execWorkspaceRoot = workspaceRoot) {
   let lastError;
   for (let attempt = 1; attempt <= TOOL_NODEJS_MAX_RETRIES + 1; attempt++) {
     try {
-      executeToolNodejsOnce(workspaceRoot, flowName, uuid, instanceId, resolvedScript, execId);
+      executeToolNodejsOnce(workspaceRoot, flowName, uuid, instanceId, resolvedScript, execId, execWorkspaceRoot);
       return;
     } catch (err) {
       lastError = err;
@@ -200,21 +200,22 @@ function persistToolNodejsStderr(outputDir, instanceId, execId, stderr) {
   } catch (_) {}
 }
 
-function executeToolNodejsOnce(workspaceRoot, flowName, uuid, instanceId, resolvedScript, execId) {
+function executeToolNodejsOnce(workspaceRoot, flowName, uuid, instanceId, resolvedScript, execId, execWorkspaceRoot = workspaceRoot) {
   const runDir = getRunDir(workspaceRoot, flowName, uuid);
   const outputDir = path.join(runDir, outputDirForNode(instanceId));
+  fs.mkdirSync(outputDir, { recursive: true });
 
   const { argv, commandLine: normalized } = nodeToolCommandToArgv(resolvedScript);
   let child;
   if (/^node\s/i.test(String(normalized).trim()) && argv.length >= 1) {
     child = spawnSync(process.execPath, argv, {
-      cwd: workspaceRoot,
+      cwd: execWorkspaceRoot,
       shell: false,
       stdio: ["inherit", "pipe", "pipe"],
     });
   } else {
     child = spawnSync(normalized, [], {
-      cwd: workspaceRoot,
+      cwd: execWorkspaceRoot,
       shell: true,
       stdio: ["inherit", "pipe", "pipe"],
     });
@@ -224,8 +225,6 @@ function executeToolNodejsOnce(workspaceRoot, flowName, uuid, instanceId, resolv
   const stderr = child.stderr?.toString("utf-8") ?? "";
   const exitCode = child.status ?? 1;
 
-  fs.mkdirSync(outputDir, { recursive: true });
-
   // 直接写文件模式：stdout 为空 + exit 0 → 脚本已自行写入 output 文件，无需解析
   if (!stdout.trim() && exitCode === 0) {
     persistToolNodejsStderr(outputDir, instanceId, execId, stderr);
@@ -310,6 +309,7 @@ export async function executeNode(workspaceRoot, flowName, uuid, instanceId, pre
   const { definitionId, directCommand, resolvedScript, promptPath, nodeContext, taskBody, resultPath, subagent } = preOutput;
   const runDir = getRunDir(workspaceRoot, flowName, uuid);
   const intermediatePath = runDir;
+  const execWorkspaceRoot = path.resolve(preOutput.workspaceContext?.workspaceRoot || preOutput.workspaceContext?.cwd || workspaceRoot);
 
   if (definitionId && LOCAL_ONLY_DEFINITION_IDS.has(definitionId)) {
     return;
@@ -331,7 +331,7 @@ export async function executeNode(workspaceRoot, flowName, uuid, instanceId, pre
       directCommand: resolvedScript,
     });
     try {
-      await executeToolNodejsInline(workspaceRoot, flowName, uuid, instanceId, resolvedScript, execId, healOptions);
+      await executeToolNodejsInline(workspaceRoot, flowName, uuid, instanceId, resolvedScript, execId, healOptions, execWorkspaceRoot);
       emitEvent(workspaceRoot, flowName, uuid, {
         event: "direct-command-done",
         instanceId,
@@ -356,7 +356,7 @@ export async function executeNode(workspaceRoot, flowName, uuid, instanceId, pre
       directCommand,
     });
     try {
-      const result = spawnSync(directCommand, [], { cwd: workspaceRoot, shell: true, stdio: "inherit" });
+      const result = spawnSync(directCommand, [], { cwd: execWorkspaceRoot, shell: true, stdio: "inherit" });
       if (result.status !== 0) {
         emitEvent(workspaceRoot, flowName, uuid, {
           event: "direct-command-failed",
@@ -398,6 +398,7 @@ export async function executeNode(workspaceRoot, flowName, uuid, instanceId, pre
     resultPathRel: resultPath ?? null,
     modelCli: cli,
     model: model ?? null,
+    execWorkspaceRoot,
   });
   try {
     if (cli === "api") {
@@ -409,6 +410,7 @@ export async function executeNode(workspaceRoot, flowName, uuid, instanceId, pre
           onToolCall: options.onToolCall,
           flowName,
           uuid,
+          execWorkspaceRoot,
         },
       );
     } else if (cli === "opencode") {
@@ -424,6 +426,7 @@ export async function executeNode(workspaceRoot, flowName, uuid, instanceId, pre
           onToolCall: options.onToolCall,
           flowName,
           uuid,
+          execWorkspaceRoot,
         },
       );
     } else if (cli === "claude-code") {
@@ -439,6 +442,7 @@ export async function executeNode(workspaceRoot, flowName, uuid, instanceId, pre
           onToolCall: options.onToolCall,
           flowName,
           uuid,
+          execWorkspaceRoot,
         },
       );
     } else {
@@ -454,6 +458,7 @@ export async function executeNode(workspaceRoot, flowName, uuid, instanceId, pre
           onToolCall: options.onToolCall,
           flowName,
           uuid,
+          execWorkspaceRoot,
         },
       );
     }

package/bin/lib/paths.mjs

@@ -34,6 +34,56 @@ export function getAgentflowDataRoot() {
   return path.join(os.homedir(), "agentflow");
 }
 
+export const AGENTFLOW_DEFAULT_USER_ID = "";
+
+export function sanitizeAgentflowUserId(userId) {
+  const raw = userId == null ? "" : String(userId).trim();
+  if (!raw) return AGENTFLOW_DEFAULT_USER_ID;
+  const normalized = raw.toLowerCase();
+  if (!/^[a-z][a-z0-9_-]{0,63}$/.test(normalized)) return AGENTFLOW_DEFAULT_USER_ID;
+  return normalized;
+}
+
+export function getAgentflowUserDataRoot(userId) {
+  const safe = sanitizeAgentflowUserId(userId ?? process.env.AGENTFLOW_USER_ID);
+  if (!safe) return getAgentflowDataRoot();
+  return path.join(getAgentflowDataRoot(), "users", safe);
+}
+
+export function listAgentflowUserIds() {
+  const usersRoot = path.join(getAgentflowDataRoot(), "users");
+  try {
+    if (!fs.existsSync(usersRoot) || !fs.statSync(usersRoot).isDirectory()) return [];
+    return fs.readdirSync(usersRoot, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => sanitizeAgentflowUserId(entry.name))
+      .filter(Boolean)
+      .sort((a, b) => a.localeCompare(b));
+  } catch {
+    return [];
+  }
+}
+
+export function getAgentflowUserContexts() {
+  const ids = listAgentflowUserIds();
+  return [{}, ...ids.map((userId) => ({ userId }))];
+}
+
+export function resolveUniqueUserPipelineDir(flowName) {
+  const name = flowName == null ? "" : String(flowName).trim();
+  if (!name) return null;
+  const matches = [];
+  for (const userId of listAgentflowUserIds()) {
+    const dir = path.join(getAgentflowDataRoot(), "users", userId, "pipelines", name);
+    try {
+      if (fs.existsSync(path.join(dir, "flow.yaml"))) matches.push(dir);
+    } catch {
+      /* ignore unreadable user dirs */
+    }
+  }
+  return matches.length === 1 ? matches[0] : null;
+}
+
 /** 项目内 runBuild 根目录：`<workspaceRoot>/.workspace/agentflow/runBuild`（legacy：写入路径已迁至 `<flowDir>/runBuild`，仅用于兼容读取） */
 export function getWorkspaceRunBuildRoot(workspaceRoot) {
   const root =
@@ -52,23 +102,21 @@ export function getLegacyUserRunBuildRoot() {
  * 统一 runtime root：每个 flow 的 pipeline 源、scripts、runBuild 共用一个根目录。
  * - 若 `~/agentflow/pipelines/<name>/flow.yaml` 存在 → user-scope：`~/agentflow/pipelines/<name>`
  * - 若 `<ws>/.workspace/agentflow/pipelines/<name>/flow.yaml` 存在 → workspace-scope：`<ws>/.workspace/agentflow/pipelines/<name>`
- * - archived（`_archived/<name>`）按对应 scope 返回
  * - 其他（builtin 只读 / 不存在）→ 默认 user-scope 路径（首次 run 时自动创建，builtin 源仍从包内读取但 runBuild 落到用户目录）
+ * 归档 flow 不参与普通 runtime root 解析，避免同名 archived flow 被误当作活跃 flow。
  */
-export function getFlowRuntimeRoot(workspaceRoot, flowName) {
+export function getFlowRuntimeRoot(workspaceRoot, flowName, opts = {}) {
   const root =
     workspaceRoot != null && String(workspaceRoot).trim() !== ""
       ? path.resolve(String(workspaceRoot))
       : process.cwd();
-  const userRoot = getUserPipelinesRoot();
+  const userRoot = getUserPipelinesRoot(opts.userId);
   const userDir = path.join(userRoot, flowName);
   if (fs.existsSync(path.join(userDir, "flow.yaml"))) return userDir;
-  const userArchived = path.join(userRoot, ARCHIVED_PIPELINES_DIR_NAME, flowName);
-  if (fs.existsSync(path.join(userArchived, "flow.yaml"))) return userArchived;
+  const inferredUserDir = resolveUniqueUserPipelineDir(flowName);
+  if (inferredUserDir) return inferredUserDir;
   const wsDir = path.join(root, PIPELINES_DIR, flowName);
   if (fs.existsSync(path.join(wsDir, "flow.yaml"))) return wsDir;
-  const wsArchived = path.join(root, PIPELINES_DIR, ARCHIVED_PIPELINES_DIR_NAME, flowName);
-  if (fs.existsSync(path.join(wsArchived, "flow.yaml"))) return wsArchived;
   // builtin / legacy / 尚未落盘 → 默认 user 目录，runBuild 首次写入时创建
   return userDir;
 }
@@ -78,8 +126,8 @@ export function getFlowRuntimeRoot(workspaceRoot, flowName) {
  * 新运行走 `<flowRuntimeRoot>/runBuild/<uuid>`；
  * 若该 uuid 在旧位置（legacy workspace/user runBuild 根）已存在，则返回旧位置，保留 resume 兼容。
  */
-export function getRunDir(workspaceRoot, flowName, uuid) {
-  const candidates = getRunDirCandidates(workspaceRoot, flowName, uuid);
+export function getRunDir(workspaceRoot, flowName, uuid, opts = {}) {
+  const candidates = getRunDirCandidates(workspaceRoot, flowName, uuid, opts);
   for (const c of candidates) {
     if (fs.existsSync(c)) return c;
   }
@@ -93,9 +141,9 @@ export function getRunDir(workspaceRoot, flowName, uuid) {
  *   2. 旧 workspace：<ws>/.workspace/agentflow/runBuild/<flow>/<uuid>
  *   3. 旧 user：~/agentflow/runBuild/<flow>/<uuid>
  */
-export function getRunDirCandidates(workspaceRoot, flowName, uuid) {
+export function getRunDirCandidates(workspaceRoot, flowName, uuid, opts = {}) {
   const candidates = [
-    path.join(getFlowRuntimeRoot(workspaceRoot, flowName), "runBuild", uuid),
+    path.join(getFlowRuntimeRoot(workspaceRoot, flowName, opts), "runBuild", uuid),
     path.join(getWorkspaceRunBuildRoot(workspaceRoot), flowName, uuid),
     path.join(getLegacyUserRunBuildRoot(), flowName, uuid),
   ];
@@ -110,8 +158,8 @@ export function getRunDirCandidates(workspaceRoot, flowName, uuid) {
   return out;
 }
 
-export function getUserPipelinesRoot() {
-  return path.join(getAgentflowDataRoot(), "pipelines");
+export function getUserPipelinesRoot(userId) {
+  return path.join(getAgentflowUserDataRoot(userId), "pipelines");
 }
 
 export function getReferenceRootAbs() {
@@ -204,8 +252,11 @@ export const LOCAL_ONLY_DEFINITION_IDS = new Set([
   "control_deadline",
   "control_cancelled",
   "control_interval_loop",
+  "control_cd_workspace",
+  "control_load_skills",
   "control_start",
   "control_end",
+  "tool_git_checkout",
   "tool_print",
   "tool_user_check",
   "tool_user_ask",

package/bin/lib/recent-runs.mjs

@@ -151,9 +151,9 @@ function mapFlowSource(src) {
  * @param {string} workspaceRoot
  * @returns {Array<{ flowId: string, flowSource: 'workspace'|'user', runId: string, at: number, durationMs: number, endedAt: number|null, status: 'success'|'failed'|'running'|'stopped'|'interrupted'|'unknown' }>}
  */
-export function listRecentRunsFromDisk(workspaceRoot) {
+export function listRecentRunsFromDisk(workspaceRoot, opts = {}) {
   const out = [];
-  for (const { flowName, uuid, runDir, source } of listAllRunDirs(workspaceRoot)) {
+  for (const { flowName, uuid, runDir, source } of listAllRunDirs(workspaceRoot, opts)) {
     let at = readKeyFromMemory(runDir, "runStartTime");
     if (at == null) {
       try {

package/bin/lib/run-node-statuses-from-disk.mjs

@@ -36,8 +36,8 @@ function parseElapsedMsLine(filePath) {
  * @param {string} uuid
  * @returns {Record<string, { status: string, elapsed?: string }>}
  */
-export function getRunNodeStatusesFromDisk(workspaceRoot, flowName, uuid) {
-  const runDir = getRunDir(workspaceRoot, flowName, uuid);
+export function getRunNodeStatusesFromDisk(workspaceRoot, flowName, uuid, opts = {}) {
+  const runDir = getRunDir(workspaceRoot, flowName, uuid, opts);
   const flowJsonPath = path.join(runDir, "intermediate", "flow.json");
   if (!fs.existsSync(flowJsonPath)) return {};
 
@@ -51,7 +51,7 @@ export function getRunNodeStatusesFromDisk(workspaceRoot, flowName, uuid) {
 
   const order = Array.isArray(flow.order) ? flow.order : [];
   const nodeDefinitions = flow.nodeDefinitions && typeof flow.nodeDefinitions === "object" ? flow.nodeDefinitions : {};
-  const execIdMap = loadAllExecIds(workspaceRoot, flowName, uuid, order);
+  const execIdMap = loadAllExecIds(workspaceRoot, flowName, uuid, order, opts);
   const intermediateDir = path.join(runDir, "intermediate");
   /** @type {Record<string, { status: string, elapsed?: string }>} */
   const out = {};