@dazitech/cli 3.0.1 → 3.0.3

package/dist/clis/dazi-onto.js

@@ -3061,11 +3061,27 @@ var AuthError = class extends DaziError {
   }
 };
 var NetworkError = class extends DaziError {
-  constructor(message, status) {
+  constructor(message, status, request) {
     super(message, "ERR_NETWORK", 3);
     this.status = status;
+    this.request = request;
     this.name = "NetworkError";
   }
+  /** 多行人类可读详情，写入 stderr / OutputChannel */
+  formatDetailLines() {
+    const lines = [`\u9519\u8BEF: ${this.message}`];
+    const r = this.request;
+    if (!r)
+      return lines;
+    if (r.label)
+      lines.push(`\u6B65\u9AA4: ${r.label}`);
+    lines.push(`\u8BF7\u6C42: ${r.method} ${r.path}`);
+    lines.push(`\u5B8C\u6574 URL: ${r.url}`);
+    lines.push(`HTTP \u72B6\u6001: ${r.status}`);
+    if (r.responseSnippet)
+      lines.push(`\u54CD\u5E94\u6458\u8981: ${r.responseSnippet}`);
+    return lines;
+  }
 };
 
 // cli/shared/src/auth.js
@@ -3084,30 +3100,74 @@ function loadAuth() {
 }
 
 // cli/shared/src/httpClient.js
+var SNIPPET_MAX = 280;
+function truncateSnippet(text) {
+  const oneLine = text.replace(/\s+/g, " ").trim();
+  if (oneLine.length <= SNIPPET_MAX)
+    return oneLine;
+  return `${oneLine.slice(0, SNIPPET_MAX)}\u2026`;
+}
+function buildHttpErrorMessage(ctx, detail) {
+  const parts = [
+    ctx.label ? `${ctx.label}\u5931\u8D25` : "HTTP \u8BF7\u6C42\u5931\u8D25",
+    `[${ctx.status} ${ctx.method} ${ctx.path}]`,
+    detail
+  ].filter(Boolean);
+  return parts.join(" \u2014 ");
+}
 async function apiRequest(path7, opts = {}) {
   const auth = opts.token || opts.serverUrl ? { token: opts.token ?? "", serverUrl: opts.serverUrl ?? "" } : loadAuth();
-  const url = `${auth.serverUrl.replace(/\/$/, "")}${path7}`;
+  const method = (opts.method ?? "GET").toUpperCase();
+  const serverBase = auth.serverUrl.replace(/\/$/, "");
+  const url = `${serverBase}${path7}`;
   const headers = {
     "Content-Type": "application/json",
     Authorization: `Bearer ${auth.token}`,
     ...opts.headers
   };
   const res = await fetch(url, {
-    method: opts.method ?? "GET",
+    method,
     headers,
     body: opts.body != null ? JSON.stringify(opts.body) : void 0
   });
   if (!res.ok) {
-    let msg = `HTTP ${res.status} ${res.statusText}`;
-    try {
-      const j = await res.json();
-      if (j.message)
-        msg = j.message;
-    } catch {
+    let detail = `HTTP ${res.status} ${res.statusText}`;
+    let responseSnippet;
+    const rawText = await res.text();
+    if (rawText) {
+      responseSnippet = truncateSnippet(rawText);
+      try {
+        const j = JSON.parse(rawText);
+        if (typeof j.detail === "string" && j.detail.trim()) {
+          detail = j.detail;
+        } else if (Array.isArray(j.detail) && j.detail.length) {
+          detail = j.detail.map((d) => d.msg ?? JSON.stringify(d)).join("; ");
+        } else if (j.message) {
+          detail = j.message;
+        }
+      } catch {
+        if (rawText.trim() && detail.startsWith("HTTP ")) {
+          detail = `\u975E JSON \u54CD\u5E94\uFF08\u53EF\u80FD\u662F\u7F51\u5173/\u524D\u7AEF 404\uFF09`;
+        }
+      }
     }
-    throw new NetworkError(msg, res.status);
+    const ctx = {
+      method,
+      path: path7,
+      url,
+      status: res.status,
+      label: opts.label,
+      responseSnippet
+    };
+    throw new NetworkError(buildHttpErrorMessage(ctx, detail), res.status, ctx);
+  }
+  if (res.status === 204 || res.headers.get("content-length") === "0") {
+    return void 0;
   }
-  return res.json();
+  const text = await res.text();
+  if (!text.trim())
+    return void 0;
+  return JSON.parse(text);
 }
 
 // cli/shared/src/output.js
@@ -3121,7 +3181,12 @@ function fail(code, message) {
   printJsonSummary({ ok: false, error: { code, message } });
 }
 function handleError(err) {
-  if (err instanceof Error) {
+  if (err instanceof NetworkError) {
+    for (const line of err.formatDetailLines()) {
+      console.error(line);
+    }
+    fail(err.code, err.message);
+  } else if (err instanceof Error) {
     const code = err.code ?? "ERR_UNKNOWN";
     console.error(`\u9519\u8BEF: ${err.message}`);
     fail(code, err.message);
@@ -3895,7 +3960,9 @@ function makeObjectCommand() {
 function makeMcpCommand() {
   const cmd = new Command("mcp").description("MCP \u670D\u52A1\uFF08\u672C\u4F53\u4FA7\uFF09");
   cmd.command("serve").description("\u4EE5 stdio JSON-RPC \u6A21\u5F0F\u542F\u52A8\u672C\u4F53 MCP \u670D\u52A1").option("--space <spaceId>", "\u9ED8\u8BA4\u7A7A\u95F4 ID").action((opts) => {
-    process.stderr.write("[dazi-onto mcp serve] MCP stdio \u670D\u52A1 \u2014 Phase 5 \u5B8C\u6574\u5B9E\u73B0\n");
+    process.stderr.write(
+      "[dazi-onto mcp serve] MCP stdio \u670D\u52A1 \u2014 Phase 5 \u5B8C\u6574\u5B9E\u73B0\n"
+    );
     process.stderr.write("\u5F53\u524D\u7248\u672C\u4EC5\u8F93\u51FA\u5360\u4F4D\u54CD\u5E94\n");
     process.stdin.setEncoding("utf-8");
     process.stdin.on("data", (data) => {
@@ -3911,7 +3978,7 @@ function makeMcpCommand() {
               result: {
                 protocolVersion: "2024-11-05",
                 capabilities: { tools: {} },
-                serverInfo: { name: "dazi-onto", version: "3.0.0-beta.1" }
+                serverInfo: { name: "dazi-onto", version: "3.0.3" }
               }
             };
             process.stdout.write(JSON.stringify(response) + "\n");
@@ -3934,7 +4001,7 @@ function makeMcpCommand() {
 
 // cli/dazi-onto/src/index.ts
 var program2 = new Command();
-program2.name("dazi-onto").description("\u642D\u5B50 Onto CLI \u2014 \u672C\u4F53\uFF08Ontology\uFF09\u7BA1\u7406").version("3.0.0", "-v, --version");
+program2.name("dazi-onto").description("\u642D\u5B50 Onto CLI \u2014 \u672C\u4F53\uFF08Ontology\uFF09\u7BA1\u7406").version("3.0.3", "-v, --version");
 program2.addCommand(makeSpaceCommand());
 program2.addCommand(makeFunctionCommand());
 program2.addCommand(makeActionCommand());

package/dist/clis/dazi.js

@@ -3659,11 +3659,27 @@ var AuthError = class extends DaziError {
   }
 };
 var NetworkError = class extends DaziError {
-  constructor(message, status) {
+  constructor(message, status, request) {
     super(message, "ERR_NETWORK", 3);
     this.status = status;
+    this.request = request;
     this.name = "NetworkError";
   }
+  /** 多行人类可读详情，写入 stderr / OutputChannel */
+  formatDetailLines() {
+    const lines = [`\u9519\u8BEF: ${this.message}`];
+    const r = this.request;
+    if (!r)
+      return lines;
+    if (r.label)
+      lines.push(`\u6B65\u9AA4: ${r.label}`);
+    lines.push(`\u8BF7\u6C42: ${r.method} ${r.path}`);
+    lines.push(`\u5B8C\u6574 URL: ${r.url}`);
+    lines.push(`HTTP \u72B6\u6001: ${r.status}`);
+    if (r.responseSnippet)
+      lines.push(`\u54CD\u5E94\u6458\u8981: ${r.responseSnippet}`);
+    return lines;
+  }
 };
 
 // cli/shared/src/auth.js
@@ -3700,30 +3716,74 @@ function tryLoadAuth() {
 }
 
 // cli/shared/src/httpClient.js
+var SNIPPET_MAX = 280;
+function truncateSnippet(text2) {
+  const oneLine = text2.replace(/\s+/g, " ").trim();
+  if (oneLine.length <= SNIPPET_MAX)
+    return oneLine;
+  return `${oneLine.slice(0, SNIPPET_MAX)}\u2026`;
+}
+function buildHttpErrorMessage(ctx, detail) {
+  const parts = [
+    ctx.label ? `${ctx.label}\u5931\u8D25` : "HTTP \u8BF7\u6C42\u5931\u8D25",
+    `[${ctx.status} ${ctx.method} ${ctx.path}]`,
+    detail
+  ].filter(Boolean);
+  return parts.join(" \u2014 ");
+}
 async function apiRequest(path13, opts = {}) {
   const auth = opts.token || opts.serverUrl ? { token: opts.token ?? "", serverUrl: opts.serverUrl ?? "" } : loadAuth();
-  const url = `${auth.serverUrl.replace(/\/$/, "")}${path13}`;
+  const method = (opts.method ?? "GET").toUpperCase();
+  const serverBase = auth.serverUrl.replace(/\/$/, "");
+  const url = `${serverBase}${path13}`;
   const headers = {
     "Content-Type": "application/json",
     Authorization: `Bearer ${auth.token}`,
     ...opts.headers
   };
   const res = await fetch(url, {
-    method: opts.method ?? "GET",
+    method,
     headers,
     body: opts.body != null ? JSON.stringify(opts.body) : void 0
   });
   if (!res.ok) {
-    let msg = `HTTP ${res.status} ${res.statusText}`;
-    try {
-      const j = await res.json();
-      if (j.message)
-        msg = j.message;
-    } catch {
+    let detail = `HTTP ${res.status} ${res.statusText}`;
+    let responseSnippet;
+    const rawText = await res.text();
+    if (rawText) {
+      responseSnippet = truncateSnippet(rawText);
+      try {
+        const j = JSON.parse(rawText);
+        if (typeof j.detail === "string" && j.detail.trim()) {
+          detail = j.detail;
+        } else if (Array.isArray(j.detail) && j.detail.length) {
+          detail = j.detail.map((d) => d.msg ?? JSON.stringify(d)).join("; ");
+        } else if (j.message) {
+          detail = j.message;
+        }
+      } catch {
+        if (rawText.trim() && detail.startsWith("HTTP ")) {
+          detail = `\u975E JSON \u54CD\u5E94\uFF08\u53EF\u80FD\u662F\u7F51\u5173/\u524D\u7AEF 404\uFF09`;
+        }
+      }
     }
-    throw new NetworkError(msg, res.status);
+    const ctx = {
+      method,
+      path: path13,
+      url,
+      status: res.status,
+      label: opts.label,
+      responseSnippet
+    };
+    throw new NetworkError(buildHttpErrorMessage(ctx, detail), res.status, ctx);
+  }
+  if (res.status === 204 || res.headers.get("content-length") === "0") {
+    return void 0;
   }
-  return res.json();
+  const text2 = await res.text();
+  if (!text2.trim())
+    return void 0;
+  return JSON.parse(text2);
 }
 
 // cli/shared/src/output.js
@@ -3737,7 +3797,12 @@ function fail(code, message) {
   printJsonSummary({ ok: false, error: { code, message } });
 }
 function handleError(err2) {
-  if (err2 instanceof Error) {
+  if (err2 instanceof NetworkError) {
+    for (const line of err2.formatDetailLines()) {
+      console.error(line);
+    }
+    fail(err2.code, err2.message);
+  } else if (err2 instanceof Error) {
     const code = err2.code ?? "ERR_UNKNOWN";
     console.error(`\u9519\u8BEF: ${err2.message}`);
     fail(code, err2.message);
@@ -3959,7 +4024,7 @@ function makeEnvCommand() {
   return new Command("env").description("\u663E\u793A\u73AF\u5883\u4FE1\u606F").action(() => {
     const auth = tryLoadAuth();
     const env = {
-      version: "3.0.0-alpha.0",
+      version: "3.0.3",
       node: process.version,
       platform: `${import_os5.default.type()} ${import_os5.default.arch()}`,
       serverUrl: getServerUrl(),
@@ -5001,7 +5066,8 @@ function resolveCli(name) {
 }
 function callCli(cliName, args) {
   const cliPath = resolveCli(cliName);
-  if (!cliPath) return { error: `CLI ${cliName} \u672A\u627E\u5230\uFF0C\u8BF7\u786E\u8BA4 DAZI_BUNDLED_DIR \u5DF2\u8BBE\u7F6E` };
+  if (!cliPath)
+    return { error: `CLI ${cliName} \u672A\u627E\u5230\uFF0C\u8BF7\u786E\u8BA4 DAZI_BUNDLED_DIR \u5DF2\u8BBE\u7F6E` };
   const result = (0, import_child_process.spawnSync)(process.execPath, [cliPath, ...args], {
     encoding: "utf-8",
     timeout: 3e4,
@@ -5077,7 +5143,10 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string", description: "\u6587\u6863 ID\uFF0C\u5982 guides/quickstart\u3001onto/function-guide" }
+        id: {
+          type: "string",
+          description: "\u6587\u6863 ID\uFF0C\u5982 guides/quickstart\u3001onto/function-guide"
+        }
       },
       required: ["id"]
     }
@@ -5103,7 +5172,10 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string", description: "\u63D0\u793A\u8BCD ID\uFF0C\u5982 onto/function-design" }
+        id: {
+          type: "string",
+          description: "\u63D0\u793A\u8BCD ID\uFF0C\u5982 onto/function-design"
+        }
       },
       required: ["id"]
     }
@@ -5186,7 +5258,10 @@ var MCP_TOOLS = [
       type: "object",
       properties: {
         space_id: { type: "string" },
-        script_type: { type: "string", description: "\u811A\u672C\u7C7B\u578B\uFF08\u5982 ontology_function\uFF09" }
+        script_type: {
+          type: "string",
+          description: "\u811A\u672C\u7C7B\u578B\uFF08\u5982 ontology_function\uFF09"
+        }
       },
       required: ["space_id"]
     }
@@ -5210,7 +5285,10 @@ var MCP_TOOLS = [
       type: "object",
       properties: {
         space_id: { type: "string", description: "\u6309\u7A7A\u95F4\u8FC7\u6EE4\uFF08\u53EF\u9009\uFF09" },
-        status: { type: "string", description: "\u6309\u72B6\u6001\u8FC7\u6EE4\uFF08active/draft/archived\uFF09" }
+        status: {
+          type: "string",
+          description: "\u6309\u72B6\u6001\u8FC7\u6EE4\uFF08active/draft/archived\uFF09"
+        }
       }
     }
   },
@@ -5233,7 +5311,10 @@ var MCP_TOOLS = [
       properties: {
         flow_id: { type: "string" },
         limit: { type: "number", description: "\u6700\u591A\u8FD4\u56DE\u6761\u6570\uFF08\u9ED8\u8BA4 10\uFF09" },
-        status: { type: "string", description: "\u6309\u72B6\u6001\u8FC7\u6EE4\uFF08running/success/failed\uFF09" }
+        status: {
+          type: "string",
+          description: "\u6309\u72B6\u6001\u8FC7\u6EE4\uFF08running/success/failed\uFF09"
+        }
       },
       required: ["flow_id"]
     }
@@ -5257,7 +5338,10 @@ var MCP_TOOLS = [
       type: "object",
       properties: {
         flow_id: { type: "string" },
-        run_id: { type: "string", description: "\u6307\u5B9A Run ID\uFF08\u53EF\u9009\uFF0C\u9ED8\u8BA4\u6700\u8FD1\u4E00\u6B21\uFF09" }
+        run_id: {
+          type: "string",
+          description: "\u6307\u5B9A Run ID\uFF08\u53EF\u9009\uFF0C\u9ED8\u8BA4\u6700\u8FD1\u4E00\u6B21\uFF09"
+        }
       },
       required: ["flow_id"]
     }
@@ -5366,27 +5450,33 @@ function handleToolCall(name, args) {
   switch (name) {
     case "list_docs": {
       let docs = loadDocs();
-      if (args.category) docs = docs.filter((d) => d.category === args.category);
+      if (args.category)
+        docs = docs.filter((d) => d.category === args.category);
       return json(docs);
     }
     case "get_doc": {
       const root = resolveBundledRoot();
       if (!root) return err("DAZI_BUNDLED_DIR \u672A\u8BBE\u7F6E");
       const entry = loadDocs().find((d) => d.id === String(args.id));
-      if (!entry) return err(`\u6587\u6863\u672A\u627E\u5230: ${args.id}\uFF08\u4F7F\u7528 list_docs \u67E5\u770B\u53EF\u7528\u6587\u6863\uFF09`);
+      if (!entry)
+        return err(`\u6587\u6863\u672A\u627E\u5230: ${args.id}\uFF08\u4F7F\u7528 list_docs \u67E5\u770B\u53EF\u7528\u6587\u6863\uFF09`);
       const content = readFile(import_path10.default.join(root, "docs", entry.file));
       return content ? text(content) : err(`\u6587\u6863\u6587\u4EF6\u4E0D\u5B58\u5728: ${entry.file}`);
     }
     case "list_prompts": {
       let prompts = loadPrompts();
-      if (args.category) prompts = prompts.filter((p) => p.category === args.category);
+      if (args.category)
+        prompts = prompts.filter((p) => p.category === args.category);
       return json(prompts);
     }
     case "get_prompt": {
       const root = resolveBundledRoot();
       if (!root) return err("DAZI_BUNDLED_DIR \u672A\u8BBE\u7F6E");
       const entry = loadPrompts().find((p) => p.id === String(args.id));
-      if (!entry) return err(`\u63D0\u793A\u8BCD\u672A\u627E\u5230: ${args.id}\uFF08\u4F7F\u7528 list_prompts \u67E5\u770B\u53EF\u7528\u63D0\u793A\u8BCD\uFF09`);
+      if (!entry)
+        return err(
+          `\u63D0\u793A\u8BCD\u672A\u627E\u5230: ${args.id}\uFF08\u4F7F\u7528 list_prompts \u67E5\u770B\u53EF\u7528\u63D0\u793A\u8BCD\uFF09`
+        );
       const content = readFile(import_path10.default.join(root, "prompts", entry.file));
       return content ? text(content) : err(`\u63D0\u793A\u8BCD\u6587\u4EF6\u4E0D\u5B58\u5728: ${entry.file}`);
     }
@@ -5399,11 +5489,22 @@ function handleToolCall(name, args) {
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "onto_list_functions": {
-      const data = callCli("dazi-onto", ["function", "list", "--space", String(args.space_id)]);
+      const data = callCli("dazi-onto", [
+        "function",
+        "list",
+        "--space",
+        String(args.space_id)
+      ]);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "onto_get_function": {
-      const data = callCli("dazi-onto", ["function", "get", String(args.function_id), "--space", String(args.space_id)]);
+      const data = callCli("dazi-onto", [
+        "function",
+        "get",
+        String(args.function_id),
+        "--space",
+        String(args.space_id)
+      ]);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "onto_run_function": {
@@ -5420,23 +5521,43 @@ function handleToolCall(name, args) {
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "onto_list_actions": {
-      const data = callCli("dazi-onto", ["action", "list", "--space", String(args.space_id)]);
+      const data = callCli("dazi-onto", [
+        "action",
+        "list",
+        "--space",
+        String(args.space_id)
+      ]);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "onto_list_rules": {
-      const ruleArgs = ["rule", "list", "--space", String(args.space_id)];
+      const ruleArgs = [
+        "rule",
+        "list",
+        "--space",
+        String(args.space_id)
+      ];
       if (args.rule_set) ruleArgs.push("--rule-set", String(args.rule_set));
       const data = callCli("dazi-onto", ruleArgs);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "onto_list_scripts": {
-      const scriptArgs = ["script", "list", "--space", String(args.space_id)];
+      const scriptArgs = [
+        "script",
+        "list",
+        "--space",
+        String(args.space_id)
+      ];
       if (args.script_type) scriptArgs.push("--type", String(args.script_type));
       const data = callCli("dazi-onto", scriptArgs);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "onto_space_snapshot": {
-      const data = callCli("dazi-onto", ["space", "snapshot", "--space-id", String(args.space_id)]);
+      const data = callCli("dazi-onto", [
+        "space",
+        "snapshot",
+        "--space-id",
+        String(args.space_id)
+      ]);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "flow_list_flows": {
@@ -5464,7 +5585,13 @@ function handleToolCall(name, args) {
     }
     case "flow_start_run": {
       const input = args.input ? JSON.stringify(args.input) : "{}";
-      const data = callCli("dazi-flow", ["run", "start", String(args.flow_id), "--input", input]);
+      const data = callCli("dazi-flow", [
+        "run",
+        "start",
+        String(args.flow_id),
+        "--input",
+        input
+      ]);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "flow_debug_run": {
@@ -5486,17 +5613,31 @@ function handleToolCall(name, args) {
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "flow_table_structure": {
-      const strArgs = ["source", "table-structure", String(args.source_id), String(args.table_name)];
+      const strArgs = [
+        "source",
+        "table-structure",
+        String(args.source_id),
+        String(args.table_name)
+      ];
       if (args.schema) strArgs.push("--schema", String(args.schema));
       const data = callCli("dazi-flow", strArgs);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "flow_snapshot_pull": {
-      const data = callCli("dazi-flow", ["snapshot", "pull", "--flow", String(args.flow_id)]);
+      const data = callCli("dazi-flow", [
+        "snapshot",
+        "pull",
+        "--flow",
+        String(args.flow_id)
+      ]);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "flow_plan_llm_guide": {
-      const data = callCli("dazi-flow", ["plan", "llm-guide", String(args.flow_id)]);
+      const data = callCli("dazi-flow", [
+        "plan",
+        "llm-guide",
+        String(args.flow_id)
+      ]);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "data_list_spaces": {
@@ -5504,7 +5645,13 @@ function handleToolCall(name, args) {
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "data_list_tables": {
-      const data = callCli("dazi", ["data", "table", "list", "--space", String(args.space_id)]);
+      const data = callCli("dazi", [
+        "data",
+        "table",
+        "list",
+        "--space",
+        String(args.space_id)
+      ]);
       return "error" in data ? err(String(data.error)) : json(data);
     }
     case "data_table_schema": {
@@ -5547,7 +5694,7 @@ function dispatch(msg) {
         result: {
           protocolVersion: "2024-11-05",
           capabilities: { tools: {} },
-          serverInfo: { name: "dazi", version: "3.0.0" }
+          serverInfo: { name: "dazi", version: "3.0.3" }
         }
       };
     case "initialized":
@@ -5561,7 +5708,11 @@ function dispatch(msg) {
         const result = handleToolCall(toolName, toolArgs);
         return { jsonrpc: "2.0", id, result };
       } catch (e) {
-        return { jsonrpc: "2.0", id, result: err(e instanceof Error ? e.message : String(e)) };
+        return {
+          jsonrpc: "2.0",
+          id,
+          result: err(e instanceof Error ? e.message : String(e))
+        };
       }
     }
     case "ping":
@@ -5575,20 +5726,32 @@ function dispatch(msg) {
   }
 }
 function makeMcpCommand() {
-  const cmd = new Command("mcp").description("MCP \u670D\u52A1\uFF08\u805A\u5408\uFF1Aonto + flow + data + docs + prompts\uFF09");
-  cmd.command("stdio").description("\u4EE5 stdio JSON-RPC \u6A21\u5F0F\u542F\u52A8\u642D\u5B50\u805A\u5408 MCP\uFF08\u4F9B Cursor/Claude \u8C03\u7528\uFF09").action(() => {
+  const cmd = new Command("mcp").description(
+    "MCP \u670D\u52A1\uFF08\u805A\u5408\uFF1Aonto + flow + data + docs + prompts\uFF09"
+  );
+  cmd.command("stdio").description(
+    "\u4EE5 stdio JSON-RPC \u6A21\u5F0F\u542F\u52A8\u642D\u5B50\u805A\u5408 MCP\uFF08\u4F9B Cursor/Claude \u8C03\u7528\uFF09"
+  ).action(() => {
     const docs = loadDocs().length;
     const prompts = loadPrompts().length;
-    process.stderr.write(`[dazi mcp stdio] \u642D\u5B50\u805A\u5408 MCP \u5DF2\u542F\u52A8 \u2014 ${MCP_TOOLS.length} \u4E2A\u5DE5\u5177
-`);
+    process.stderr.write(
+      `[dazi mcp stdio] \u642D\u5B50\u805A\u5408 MCP \u5DF2\u542F\u52A8 \u2014 ${MCP_TOOLS.length} \u4E2A\u5DE5\u5177
+`
+    );
     process.stderr.write(`  \u6587\u6863: ${docs} \u7BC7  \u63D0\u793A\u8BCD: ${prompts} \u7BC7
 `);
-    process.stderr.write(`  onto: ${MCP_TOOLS.filter((t) => t.name.startsWith("onto_")).length} \u4E2A\u5DE5\u5177
-`);
-    process.stderr.write(`  flow: ${MCP_TOOLS.filter((t) => t.name.startsWith("flow_")).length} \u4E2A\u5DE5\u5177
-`);
-    process.stderr.write(`  data: ${MCP_TOOLS.filter((t) => t.name.startsWith("data_")).length} \u4E2A\u5DE5\u5177
-`);
+    process.stderr.write(
+      `  onto: ${MCP_TOOLS.filter((t) => t.name.startsWith("onto_")).length} \u4E2A\u5DE5\u5177
+`
+    );
+    process.stderr.write(
+      `  flow: ${MCP_TOOLS.filter((t) => t.name.startsWith("flow_")).length} \u4E2A\u5DE5\u5177
+`
+    );
+    process.stderr.write(
+      `  data: ${MCP_TOOLS.filter((t) => t.name.startsWith("data_")).length} \u4E2A\u5DE5\u5177
+`
+    );
     let buffer = "";
     process.stdin.setEncoding("utf-8");
     process.stdin.on("data", (chunk) => {
@@ -5615,7 +5778,8 @@ function makeMcpCommand() {
     let tools = MCP_TOOLS;
     if (opts.category) {
       tools = tools.filter((t) => {
-        if (opts.category === "docs") return t.name.startsWith("list_docs") || t.name.startsWith("get_doc") || t.name.startsWith("list_prompts") || t.name.startsWith("get_prompt");
+        if (opts.category === "docs")
+          return t.name.startsWith("list_docs") || t.name.startsWith("get_doc") || t.name.startsWith("list_prompts") || t.name.startsWith("get_prompt");
         return t.name.startsWith(`${opts.category}_`);
       });
     }
@@ -5644,14 +5808,16 @@ function forwardToCli(cliName, extraArgs) {
   const bundled = resolveBundledCli(cliName);
   let result;
   if (bundled) {
-    result = (0, import_child_process2.spawnSync)(process.execPath, [bundled, ...extraArgs], { stdio: "inherit" });
+    result = (0, import_child_process2.spawnSync)(process.execPath, [bundled, ...extraArgs], {
+      stdio: "inherit"
+    });
   } else {
     result = (0, import_child_process2.spawnSync)(cliName, extraArgs, { stdio: "inherit", shell: true });
   }
   process.exit(result.status ?? 1);
 }
 var program2 = new Command();
-program2.name("dazi").description("\u642D\u5B50 v3 \u2014 Onto / Flow / App \u7EDF\u4E00 CLI").version("3.0.0", "-v, --version");
+program2.name("dazi").description("\u642D\u5B50 v3 \u2014 Onto / Flow / App \u7EDF\u4E00 CLI").version("3.0.3", "-v, --version");
 program2.addCommand(makeAuthCommand());
 program2.addCommand(makeDoctorCommand());
 program2.addCommand(makeEnvCommand());

package/dist/docs/flow/ai-workflow-playbook.md

@@ -1,7 +1,7 @@
 # 流程项目 AI 工作手册
 
 **文档 ID**: `flow/ai-workflow-playbook`  
-**适用**: Cursor / Trae / 任何 Agent 修改 `项目/flow_*/流程/<名>/`
+**适用**: Cursor / Trae / 任何 Agent 修改 `项目/<业务名>/流程/flows/<流程名>/`
 
 > 完整文件规范见 [流程本地文件规范](./local-files-spec.md)。
 
@@ -34,20 +34,21 @@
 ## 3. 标准流程（改现有 excel-python）
 
 ```powershell
-cd "项目\flow_xxx\流程\<流程名>"
+# 推荐绝对路径（禁止在 dazi-work 根 --dir .）
+$flowDir = "D:\path\to\dazi-work\项目\<业务名>\流程\flows\<流程名>"
 
-dazi flow project doctor --dir .
+dazi flow project doctor --dir $flowDir
 # 若不一致：
-dazi flow project repair-meta --dir .
+dazi flow project repair-meta --dir $flowDir
 
 # 改 flow.json 配置后：
-dazi flow project push --dir . --canvas
+dazi flow project push --dir $flowDir --canvas
 
 # 改 code.py 后：
-dazi flow node push --node <node_uuid> --dir .
+dazi flow node push --node <node_uuid> --dir $flowDir
 
-dazi flow run node-exec --node <node_uuid> --dir .
-dazi flow run flow-exec --dir . --type debug
+dazi flow run node-exec --node <node_uuid> --dir $flowDir
+dazi flow run flow-exec --dir $flowDir --type debug
 ```
 
 确认终端出现 **`✅ 画布已全量推送`**。