@dazitech/cli 3.0.5 → 3.0.7

package/README.md

@@ -78,7 +78,7 @@ pnpm run publish:cli
 
 ```powershell
 # 全局
-pnpm add -g @dazitech/cli@3.0.5
+pnpm add -g @dazitech/cli@3.0.7
 
 # 确认 PATH（pnpm 全局 bin）
 pnpm bin -g

package/dist/clis/dazi-app.js

@@ -3057,7 +3057,7 @@ function fromLegacyAuthFile() {
   }
   return null;
 }
-function loadAuth() {
+function loadAuth2() {
   return fromV3AuthFile() ?? fromLegacyAuthFile();
 }
 function saveAuth(cfg) {
@@ -12827,7 +12827,7 @@ __export(templateRemote_exports, {
   fetchRemoteTemplateToDir: () => fetchRemoteTemplateToDir
 });
 async function fetchTemplateBodyZip(templateId, version) {
-  const auth = loadAuth();
+  const auth = loadAuth2();
   if (!auth?.accessToken) {
     throw new Error("\u8BF7\u5148 dazi-app auth login\uFF08\u62C9\u53D6\u670D\u52A1\u7AEF\u6B63\u6587\u9700\u8981\u767B\u5F55\uFF09");
   }
@@ -13076,10 +13076,13 @@ var {
   Help
 } = import_index.default;
 
+// cli/shared/src/version.ts
+var DAZI_VERSION = true ? "3.0.7" : readDevVersion();
+
 // cli/dazi-app/src/lib/httpClient.ts
 init_config();
 async function apiRequest(method, path31, opts) {
-  const auth = loadAuth();
+  const auth = loadAuth2();
   const base = (opts?.baseUrl || auth?.baseUrl || "http://localhost:8001/api").replace(
     /\/$/,
     ""
@@ -14622,7 +14625,7 @@ function collectSourceSnapshot(cwd) {
 // cli/dazi-app/src/commands/upload.ts
 function registerUpload(program3) {
   program3.command("upload").description("\u6253\u5305\u5E76\u4E0A\u4F20\u5230 Registry\uFF08\u65E0 app \u5219\u5148 create\uFF09").option("--cwd <dir>", "DRAP \u9879\u76EE\u76EE\u5F55\uFF08\u9ED8\u8BA4\u81EA\u52A8\u8BC6\u522B\uFF1Ashell \u76EE\u5F55\u6216\u542B manifest.json \u7684\u7956\u5148\uFF09").option("--space <id>", "\u6570\u636E\u7A7A\u95F4 id\uFF08\u5FC5\u586B\uFF0C\u9996\u6B21 create\uFF09").option("--activate", "\u4E0A\u4F20\u540E\u6FC0\u6D3B", false).option("--changelog <text>", "\u53D8\u66F4\u8BF4\u660E").option("--file <path>", "\u5DF2\u6709 .dazi-app\uFF0C\u8DF3\u8FC7 package").option("--skip-validate", "\u8DF3\u8FC7 manifest \u6821\u9A8C\uFF08\u4E0D\u63A8\u8350\uFF09").option("--no-source", "\u4E0D\u4E0A\u4F20\u6E90\u7801\u5FEB\u7167\uFF08\u9ED8\u8BA4\u4E0A\u4F20\uFF0C\u4F9B release \u8F6C\u6A21\u677F\uFF09").option("--json").action(async (opts) => {
-    if (!loadAuth()) throw new Error("\u8BF7\u5148 dazi-app auth login");
+    if (!loadAuth2()) throw new Error("\u8BF7\u5148 dazi-app auth login");
     const cwd = requireProjectCwd(opts.cwd);
     const manifestEarly = JSON.parse(
       import_node_fs13.default.readFileSync(import_node_path12.default.join(cwd, "manifest.json"), "utf8")
@@ -14740,7 +14743,7 @@ function readAppId(explicitCwd) {
 }
 function attachReleaseCommands(rel) {
   rel.command("list").option("--cwd <dir>", "DRAP \u9879\u76EE\u76EE\u5F55\uFF08\u9ED8\u8BA4\u8BC6\u522B shell \u76EE\u5F55\uFF09").option("--json").action(async (opts) => {
-    if (!loadAuth()) throw new Error("\u8BF7\u5148\u767B\u5F55");
+    if (!loadAuth2()) throw new Error("\u8BF7\u5148\u767B\u5F55");
     const appId = readAppId(opts.cwd);
     const out = await apiRequest(
       "GET",
@@ -14749,7 +14752,7 @@ function attachReleaseCommands(rel) {
     printJsonSummary({ ok: true, app_id: appId, ...out }, !!opts.json);
   });
   rel.command("activate").argument("<semver>", "\u7248\u672C\u53F7").option("--cwd <dir>", "DRAP \u9879\u76EE\u76EE\u5F55\uFF08\u9ED8\u8BA4\u8BC6\u522B shell \u76EE\u5F55\uFF09").option("--json").action(async (semver, opts) => {
-    if (!loadAuth()) throw new Error("\u8BF7\u5148\u767B\u5F55");
+    if (!loadAuth2()) throw new Error("\u8BF7\u5148\u767B\u5F55");
     const appId = readAppId(opts.cwd);
     const listed = await apiRequest(
       "GET",
@@ -14764,7 +14767,7 @@ function attachReleaseCommands(rel) {
     printJsonSummary({ ok: true, activated }, !!opts.json);
   });
   rel.command("revoke").argument("<semver>", "\u7248\u672C\u53F7").option("--cwd <dir>", "DRAP \u9879\u76EE\u76EE\u5F55\uFF08\u9ED8\u8BA4\u8BC6\u522B shell \u76EE\u5F55\uFF09").option("--json").action(async (semver, opts) => {
-    if (!loadAuth()) throw new Error("\u8BF7\u5148\u767B\u5F55");
+    if (!loadAuth2()) throw new Error("\u8BF7\u5148\u767B\u5F55");
     const appId = readAppId(opts.cwd);
     const listed = await apiRequest(
       "GET",
@@ -14857,7 +14860,7 @@ function registerTemplates(program3) {
       source_ref: t.dirName
     }));
     let remote = [];
-    if (opts.remote && loadAuth()) {
+    if (opts.remote && loadAuth2()) {
       try {
         const out = await apiRequest("GET", "/runtime-apps/templates");
         remote = (out.items || []).map((r) => ({
@@ -14887,7 +14890,7 @@ function registerTemplates(program3) {
     printJsonSummary({ ok: true, items: merged, total: merged.length }, !!opts.json);
   });
   tpl.command("from-release").description("\u4ECE Registry release \u6E90\u7801\u5FEB\u7167\u521B\u5EFA\u52A8\u6001\u5E94\u7528\u6A21\u677F\uFF08\u670D\u52A1\u7AEF\u5B58\u50A8\uFF09").requiredOption("--id <template_id>", "\u65B0\u6A21\u677F id\uFF08\u5C0F\u5199\u8FDE\u5B57\u7B26\uFF09").requiredOption("--name <n>", "\u6A21\u677F\u663E\u793A\u540D\u79F0").option("--release-id <id>", "\u6307\u5B9A release id\uFF08\u9ED8\u8BA4\u7528 app \u6FC0\u6D3B\u7248\u672C\uFF09").option("--app-id <id>", "\u5E94\u7528 id\uFF08\u4E0E --release-id \u4E8C\u9009\u4E00\uFF09").option("--category <c>", "\u5206\u7C7B\uFF1A\u5206\u6790 / \u7BA1\u7406 / \u76D1\u63A7 / \u804A\u5929").option("--scene-tag <t>", "\u573A\u666F tag").option("--description <d>", "\u7B80\u4ECB").option("--version <v>", "\u6A21\u677F\u7248\u672C", "0.1.0").option("--json").action(async (opts) => {
-    if (!loadAuth()) throw new Error("\u8BF7\u5148 dazi-app auth login");
+    if (!loadAuth2()) throw new Error("\u8BF7\u5148 dazi-app auth login");
     if (!opts.releaseId && !opts.appId) {
       throw new Error("\u8BF7\u63D0\u4F9B --release-id \u6216 --app-id");
     }
@@ -15546,7 +15549,7 @@ function registerInit(program3) {
 init_config();
 function registerWhoami(program3) {
   program3.command("whoami").description("\u5F53\u524D\u767B\u5F55\u7528\u6237\u4E0E API \u57FA\u5740").option("--json").action(async (opts) => {
-    const auth = loadAuth();
+    const auth = loadAuth2();
     if (!auth?.accessToken) {
       throw new Error("\u672A\u767B\u5F55\uFF0C\u8BF7\u5148 dazi-app auth login");
     }
@@ -15933,7 +15936,7 @@ var import_node_path27 = __toESM(require("node:path"), 1);
 init_config();
 function runDoctor(cwd) {
   const checks = [];
-  const auth = loadAuth();
+  const auth = loadAuth2();
   if (auth) {
     checks.push({
       id: "auth",
@@ -16222,7 +16225,7 @@ async function postPreview(kind, body) {
   return res.dataset;
 }
 async function runInlinePreview(opts) {
-  if (!loadAuth()) {
+  if (!loadAuth2()) {
     throw new Error("\u8BF7\u5148 dazi-app auth login");
   }
   const { text, sizeBytes } = readInlineAssetFile(opts.appDir, opts.decl.source);
@@ -16753,7 +16756,7 @@ function registerLegacyCompatCommands(program3) {
 var program2 = new Command();
 program2.name("dazi-app").description(
   "\u642D\u5B50 App CLI \u2014 DRAP \u524D\u7AEF\u5E94\u7528\uFF08manifest / build / upload / preview\uFF09"
-).version("3.0.5", "-v, --version");
+).version(DAZI_VERSION, "-v, --version");
 registerAuth(program2);
 registerBuild(program2);
 registerDev(program2);

package/dist/clis/dazi-flow.js

@@ -3578,6 +3578,7 @@ function buildFlowConsistencyMarkdown(audit, localFilesSpecLink = "../../\u8D44\
     '| **\u65B0\u589E\u4EE3\u7801\u8282\u70B9** | `dazi flow node new --type <type> --dir . --label "<\u540D>"` \u2192 \u6539\u914D\u7F6E \u2192 `push --canvas` \u2192 \u5199 code \u2192 `node push` |',
     "",
     "> \u7981\u6B62\u53EA\u6539 `flow.json` \u800C\u4E0D\u66F4\u65B0 `flow.meta.json`\uFF08\u987B `node new` / `pull` / `repair-meta`\uFF09\u3002",
+    "> \u6539 `code.*` \u540E\u9A8C\u8BC1\u987A\u5E8F\uFF1A**`node push` \u2192 `node-exec` \u2192 `variable pull`**\uFF08\u6709\u8F93\u51FA\u53D8\u91CF\u65F6\uFF09\uFF1B`node-exec` \u6267\u884C\u5E73\u53F0\u5DF2 push \u7684\u4EE3\u7801\u3002",
     ""
   );
   return lines;
@@ -3707,11 +3708,15 @@ var require_flowScaffoldDocs = __commonJS({
         "",
         "\u4E0D\u4F9D\u8D56\u7EC8\u7AEF\u5F53\u524D\u76EE\u5F55\uFF0C\u907F\u514D `cd` \u5230\u9519\u8BEF\u6D41\u7A0B\uFF1A",
         "",
+        "> \u6539 `code.*` \u540E\u6D4B\u8BD5\u987A\u5E8F\uFF1A**`node push` \u2192 `node-exec` \u2192 `variable pull`**\uFF08\u6709 `output_variable_name` \u65F6\uFF09\uFF1B`node-exec` \u4E0D\u8BFB\u672C\u5730\u672A\u63D0\u4EA4\u4EE3\u7801\u3002",
+        "",
         "```powershell",
         (0, flowCliText_1.psFlowLine)(`project status --dir "${absDir}"`),
         (0, flowCliText_1.psFlowLine)(`project pull --flow ${opts.flowId} --dir "${absDir}"`),
         (0, flowCliText_1.psFlowLine)(`project push --dir "${absDir}" --canvas`),
+        (0, flowCliText_1.psFlowLine)(`node push --node <node_uuid> --dir "${absDir}"`),
         (0, flowCliText_1.psFlowLine)(`run node-exec --node <node_uuid> --dir "${absDir}"`),
+        (0, flowCliText_1.psFlowLine)(`variable pull --name <output_variable_name> --dir "${absDir}"`),
         (0, flowCliText_1.psFlowLine)(`run flow-exec --dir "${absDir}" --type debug`),
         (0, flowCliText_1.psFlowLine)(`variable sync --dir "${absDir}"`),
         "```",
@@ -3745,7 +3750,7 @@ var require_flowScaffoldDocs = __commonJS({
         "",
         "| \u8DEF\u5F84 | \u8BF4\u660E |",
         "|------|------|",
-        "| `\u89C4\u5212/` | \u6D41\u7A0B\u8BBE\u8BA1\u6587\u6863\uFF08\u6570\u636E\u6E90\u3001\u62D3\u6251\u8349\u6848\u7B49\uFF09 |",
+        "| `plans/` | \u6D41\u7A0B\u8BBE\u8BA1\u6587\u6863\uFF08\u6570\u636E\u6E90\u3001\u62D3\u6251\u8349\u6848\u7B49\uFF09 |",
         "| `flows/` | \u5404\u6D41\u7A0B\u5B9E\u4F8B\u76EE\u5F55\uFF08`flow.json`\u3001`\u8282\u70B9/`\u3001`\u53D8\u91CF/`\uFF09 |",
         "",
         "\u5355\u4E2A\u6D41\u7A0B\u4F4D\u4E8E `flows/<\u6D41\u7A0B\u540D>/`\uFF1A",
@@ -3784,9 +3789,10 @@ var require_flowScaffoldDocs = __commonJS({
         "## 3. \u5F00\u53D1\u4E0E\u63D0\u4EA4",
         "",
         "1. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql` \u6216 `code.py`",
-        "2. \u53F3\u952E **\u6D4B\u8BD5\u8FD0\u884C\u8282\u70B9** \u6216 `flow run node-exec --node <uuid>`",
-        "3. \u53F3\u952E **\u63D0\u4EA4\u8282\u70B9** / **\u63D0\u4EA4\u6D41\u7A0B** \u6216 `flow node push` / `flow project push --canvas`",
-        "4. \u67E5\u770B\u8868\u53D8\u91CF\uFF1A\u8BBE\u8BA1\u5668 **output_variable_name** \u65C1 \u{1F4CA}\uFF0C\u6216 `flow variable pull --name <\u540D>`",
+        "2. \u53F3\u952E **\u63D0\u4EA4\u8282\u70B9** \u6216 `flow node push`\uFF08**\u5148\u4E8E\u6D4B\u8BD5**\uFF1B`node-exec` \u8DD1\u5E73\u53F0\u5DF2 push \u7684\u4EE3\u7801\uFF09",
+        "3. \u53F3\u952E **\u6D4B\u8BD5\u8FD0\u884C\u8282\u70B9** / \u8BBE\u8BA1\u5668 **\u642D\u5B50\u6267\u884C**\uFF0C\u6216 `flow run node-exec --node <uuid>`",
+        "4. \u67E5\u770B\u8868\u53D8\u91CF\uFF1A\u8BBE\u8BA1\u5668 **output_variable_name** \u65C1 \u{1F4CA}\uFF0C\u6216 `flow variable pull --name <\u540D>`\uFF08\u6709\u8F93\u51FA\u53D8\u91CF\u65F6\u5EFA\u8BAE\u5FC5\u505A\uFF09",
+        "5. \u6539\u8FDE\u7EBF/\u914D\u7F6E\uFF1A\u53F3\u952E **\u63D0\u4EA4\u6D41\u7A0B** \u6216 `flow project push --canvas`",
         "",
         "\u547D\u4EE4\u524D\u7F00\uFF1A" + cliPrefix(),
         "",
@@ -3803,7 +3809,7 @@ var require_flowScaffoldDocs = __commonJS({
         "| \u5206\u6790\u7528\u6237\u7C98\u8D34\u7684\u9519\u8BEF | `flow/run-debug` |",
         "",
         "\u4FA7\u680F **\u5E2E\u52A9 \u2192 \u{1F916} \u63D0\u793A\u8BCD** \u4E2D \u2B50 \u4E3A\u6D41\u7A0B\u63A8\u8350\u3002\u53F3\u952E **`flow.json`** \u2192 **\u6253\u5F00 AI \u6539\u9519\u63D0\u793A\u8BCD**\u3002",
-        "\u7ED9 AI \u7684\u4EFB\u52A1\u793A\u4F8B\uFF1A\u300C\u6539 XX \u8282\u70B9\uFF0C\u81EA\u5DF1\u8DD1\u6D4B\u8BD5\uFF0C\u5931\u8D25\u6309 last-error \u6539\u5230\u901A\u8FC7\u518D push\u300D\u3002",
+        "\u7ED9 AI \u7684\u4EFB\u52A1\u793A\u4F8B\uFF1A\u300C\u6539 XX \u8282\u70B9\uFF0C**\u5148 node push \u518D\u6D4B**\uFF0C\u5931\u8D25\u6309 last-error \u6539\u5230\u6EE1\u8DB3\u6210\u529F\u5224\u636E\uFF08\u542B variable pull\uFF09\u300D\u3002",
         "",
         ...buildDocsTable("project-root")
       ].join("\n");
@@ -3902,7 +3908,9 @@ var require_flowScaffoldDocs = __commonJS({
         (0, flowCliText_1.psFlowLine)('project status --dir "<FLOW_DIR>"'),
         (0, flowCliText_1.psFlowLine)(`project pull --flow ${opts.flowId} --dir "<FLOW_DIR>"`),
         (0, flowCliText_1.psFlowLine)('project push --dir "<FLOW_DIR>" --canvas'),
+        (0, flowCliText_1.psFlowLine)('node push --node <node_uuid> --dir "<FLOW_DIR>"'),
         (0, flowCliText_1.psFlowLine)('run node-exec --node <node_uuid> --dir "<FLOW_DIR>"'),
+        (0, flowCliText_1.psFlowLine)('variable pull --name <output_variable_name> --dir "<FLOW_DIR>"'),
         (0, flowCliText_1.psFlowLine)('run flow-exec --dir "<FLOW_DIR>" --type debug'),
         (0, flowCliText_1.psFlowLine)('variable sync --dir "<FLOW_DIR>"'),
         "```",
@@ -3918,14 +3926,17 @@ var require_flowScaffoldDocs = __commonJS({
         `2. **\u5FC5\u987B**\u7528 CLI \u65B0\u5EFA\u8282\u70B9\uFF08\u7981\u6B62\u624B\u6413 uuid\uFF09\uFF1A${(0, flowCliText_1.mdFlowCmd)('node new --type <node_type> --dir . --label "<\u8282\u70B9\u540D>"')}`,
         "3. \u5728 `flow.json` \u91CC\u8865 `nodes/edges`\uFF08\u9075\u5B88\u951A\u70B9\uFF1A`sourceHandle` \u4EC5 `r/b/true/false`\uFF0C`targetHandle` \u4EC5 `l/t`\uFF09",
         "4. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql|py`\uFF08`node new` \u4F1A\u521B\u5EFA\u76EE\u5F55\u4E0E meta \u7D22\u5F15\uFF09",
-        `5. \u5355\u8282\u70B9\u6D4B\u8BD5\uFF1A${(0, flowCliText_1.mdFlowCmd)("run node-exec --node <node_uuid> --dir .")}`,
-        `6. \u63D0\u4EA4\u753B\u5E03\uFF08\u542B\u8FDE\u7EBF/\u914D\u7F6E\uFF09\uFF1A${(0, flowCliText_1.mdFlowCmd)("project push --dir . --canvas")}`,
+        `5. \u63D0\u4EA4\u4EE3\u7801\uFF1A${(0, flowCliText_1.mdFlowCmd)("node push --node <node_uuid> --dir .")}\uFF08\u5148\u4E8E\u6D4B\u8BD5\uFF09`,
+        `6. \u5355\u8282\u70B9\u6D4B\u8BD5\uFF1A${(0, flowCliText_1.mdFlowCmd)("run node-exec --node <node_uuid> --dir .")}`,
+        `7. \u6838\u5BF9\u53D8\u91CF\uFF08\u82E5\u914D\u7F6E\u4E86 output_variable_name\uFF09\uFF1A${(0, flowCliText_1.mdFlowCmd)("variable pull --name <\u540D> --dir .")}`,
+        `8. \u63D0\u4EA4\u753B\u5E03\uFF08\u542B\u8FDE\u7EBF/\u914D\u7F6E\uFF09\uFF1A${(0, flowCliText_1.mdFlowCmd)("project push --dir . --canvas")}`,
         "",
         "### \u573A\u666F B\uFF1A\u4EC5\u6539\u8282\u70B9\u4EE3\u7801",
         "",
         "1. \u7F16\u8F91 `\u8282\u70B9/<\u540D>/code.sql|py`\uFF08\u4E0D\u8981\u628A\u6B63\u6587\u5199\u56DE `flow.json`\uFF09",
-        `2. \u8FD0\u884C\u8282\u70B9\uFF1A${(0, flowCliText_1.mdFlowCmd)("run node-exec --node <node_uuid> --dir .")}`,
-        `3. \u63D0\u4EA4\u4EE3\u7801\uFF1A${(0, flowCliText_1.mdFlowCmd)("node push --node <node_uuid> --dir .")}`,
+        `2. \u63D0\u4EA4\u4EE3\u7801\uFF08\u5148\u4E8E\u6D4B\u8BD5\uFF09\uFF1A${(0, flowCliText_1.mdFlowCmd)("node push --node <node_uuid> --dir .")}`,
+        `3. \u8FD0\u884C\u8282\u70B9\uFF1A${(0, flowCliText_1.mdFlowCmd)("run node-exec --node <node_uuid> --dir .")}`,
+        `4. \u6838\u5BF9\u8F93\u51FA\u53D8\u91CF\uFF08\u82E5\u9002\u7528\uFF09\uFF1A${(0, flowCliText_1.mdFlowCmd)("variable pull --name <output_variable_name> --dir .")}`,
         "",
         "### \u573A\u666F C\uFF1A\u753B\u5E03\u548C\u4EE3\u7801\u4E0D\u540C\u6B65",
         "",
@@ -3941,13 +3952,18 @@ var require_flowScaffoldDocs = __commonJS({
         "- `code.*` \u662F\u5426\u4E0E\u8282\u70B9\u4E1A\u52A1\u7C7B\u578B\u4E00\u81F4\uFF08SQL \u8282\u70B9 `code.sql`\uFF0CPython \u8282\u70B9 `code.py`\uFF09",
         "- \u6761\u4EF6\u8282\u70B9\u51FA\u8FB9\u662F\u5426\u4EC5\u4F7F\u7528 `true/false`\uFF0C\u672A\u8BEF\u7528 `r/b`",
         "- \u82E5\u6539\u52A8\u753B\u5E03\uFF0C\u662F\u5426\u6267\u884C\u4E86 `flow project push --canvas`",
+        "- \u6539 `code.*` \u540E\u662F\u5426 **\u5148\u4E8E `node-exec` \u6267\u884C\u4E86 `node push`**",
+        "- `node-exec` \u662F\u5426 JSON `success: true`",
+        "- \u6709 `output_variable_name` \u65F6\u662F\u5426 **`variable pull` \u4E14\u53D8\u91CF\u5408\u7406**",
+        "- \u662F\u5426\u7981\u6B62\u672A push \u5C31\u6D4B\u4EE3\u7801\u3001\u7981\u6B62\u4EC5\u51ED exit code \u58F0\u79F0\u901A\u8FC7",
         "",
         "## \u5E38\u89C1\u9519\u8BEF\u4E0E\u4FEE\u590D",
         "",
         "| \u73B0\u8C61 | \u5E38\u89C1\u539F\u56E0 | \u4FEE\u590D |",
         "|------|----------|------|",
         `| \u547D\u4EE4\u627E\u4E0D\u5230 | \u672A\u88C5\u5168\u5C40 CLI \u6216\u4E0D\u5728 dazi-work | \`pnpm add -g @dazitech/cli\` \u6216 ${(0, flowCliText_1.mdFlowCmd)("...")} / \`.scriptsdazi.ps1 flow ...\` |`,
-        "| \u8282\u70B9\u6D4B\u8BD5\u62A5\u4E0A\u6E38\u53D8\u91CF\u4E0D\u5B58\u5728 | \u672A\u5148\u8FD0\u884C\u4E0A\u6E38\u8282\u70B9\u4EA7\u51FA\u53D8\u91CF | \u5148\u8DD1\u4E0A\u6E38\uFF0C\u6216\u6574\u6D41\u7A0B `flow run flow-exec --type debug` \u540E\u518D\u6D4B |",
+        "| \u8282\u70B9\u6D4B\u8BD5\u62A5\u4E0A\u6E38\u53D8\u91CF\u4E0D\u5B58\u5728 | \u672A\u5148\u8FD0\u884C\u4E0A\u6E38\u8282\u70B9\u4EA7\u51FA\u53D8\u91CF | \u4E0A\u6E38 **`node push` \u2192 `node-exec`**\uFF0C\u6216\u6574\u6D41\u7A0B `flow-exec --type debug`\uFF0C\u518D `variable pull` \u540E\u6D4B\u76EE\u6807\u8282\u70B9 |",
+        "| \u672C\u5730\u5DF2\u6539\u4EE3\u7801\u4F46\u6D4B\u8BD5\u4ECD\u50CF\u65E7\u7248 | \u672A `node push` \u5C31 `node-exec` | **\u5148 `node push`\uFF0C\u518D `node-exec`** |",
         "| excel-python \u627E\u4E0D\u5230\u6587\u4EF6 | code.py \u5199\u4E86\u6587\u4EF6\u540D/\u672C\u5730\u8DEF\u5F84 | \u753B\u5E03\u914D `managed_file_id`\uFF08UUID\uFF09\uFF1B\u4EE3\u7801\u7528 `excel_source_path` |",
         "| Excel \u7528\u4E86 file-source | file-source \u4E0D\u89E3\u6790 xlsx | \u6539\u4E3A **`excel-python`** + `managed_file_id` |",
         "| excel-python \u65E0\u4E3B\u8F93\u51FA | \u672A `set_table_output` \u6216\u540D\u79F0\u4E0E `output_variable_name` \u4E0D\u4E00\u81F4 | \u89C1 node-code-guide \xA75 |",
@@ -3957,13 +3973,13 @@ var require_flowScaffoldDocs = __commonJS({
         "",
         "## AI \u81EA\u4E3B\u8FD0\u884C\u4E0E\u6539\u9519\u95ED\u73AF\uFF08Agent \u5FC5\u8BFB\uFF09",
         "",
-        "> **\u6269\u5C55/\u83DC\u5355\u4E0D\u4F1A\u81EA\u52A8\u6539\u4EE3\u7801**\uFF08\u5E73\u53F0 D6\uFF09\uFF1B\u7528\u6237\u59D4\u6258\u4F60\u6539\u6D41\u7A0B\u65F6\uFF0C\u4F60**\u5FC5\u987B\u4E3B\u52A8**\u6267\u884C\u300C\u6539 \u2192 \u8DD1 \u2192 \u8BFB\u9519 \u2192 \u518D\u6539 \u2192 \u518D\u8DD1\u300D\uFF0C\u76F4\u5230\u901A\u8FC7\u6216\u8FBE\u5230\u91CD\u8BD5\u4E0A\u9650\u3002",
+        "> **\u6269\u5C55/\u83DC\u5355\u4E0D\u4F1A\u81EA\u52A8\u6539\u4EE3\u7801**\uFF08\u5E73\u53F0 D6\uFF09\uFF1B\u7528\u6237\u59D4\u6258\u4F60\u6539\u6D41\u7A0B\u65F6\uFF0C\u4F60**\u5FC5\u987B\u4E3B\u52A8**\u6267\u884C\u300C\u6539 \u2192 **push** \u2192 \u8DD1 \u2192 **variable pull**\uFF08\u82E5\u9002\u7528\uFF09\u2192 \u8BFB\u9519 \u2192 \u518D\u6539\u300D\uFF0C\u76F4\u5230\u6EE1\u8DB3\u6210\u529F\u5224\u636E\u6216\u8FBE\u5230\u91CD\u8BD5\u4E0A\u9650\u3002",
         "",
         "### \u9519\u8BEF\u843D\u5728\u54EA\u91CC\uFF08\u8DD1\u5B8C\u5FC5\u67E5\uFF09",
         "",
         "| \u8FD0\u884C\u65B9\u5F0F | \u5931\u8D25\u65F6\u8BFB | \u6210\u529F/\u6B65\u9AA4\u6458\u8981 |",
         "|----------|----------|---------------|",
-        "| \u5355\u8282\u70B9 `run node-exec` | `_run/<\u8282\u70B9\u540D>.last-error.md` | \u65E0 error \u6587\u4EF6\u5373\u901A\u8FC7 |",
+        "| \u5355\u8282\u70B9 `run node-exec` | `_run/<\u8282\u70B9\u540D>.last-error.md` | push \u6210\u529F + JSON `success:true` +\uFF08\u6709\u8F93\u51FA\u53D8\u91CF\u65F6\uFF09`variable pull` \u6838\u5BF9 |",
         "| \u6574\u6D41\u7A0B `run flow-exec` | `_run/flow.last-error.md` | `_run/flow.last-run.md`\uFF08\u6B65\u9AA4+\u65E5\u5FD7\uFF09 |",
         "",
         "CLI \u5E26 `--json` \u65F6\uFF1A\u770B\u8FD4\u56DE `success: false` \u6216 `errorFile` \u5B57\u6BB5\uFF0C**\u518D\u6253\u5F00\u5BF9\u5E94 md \u6587\u4EF6**\uFF0C\u4E0D\u8981\u53EA\u770B\u7EC8\u7AEF\u4E00\u884C\u62A5\u9519\u3002",
@@ -3972,12 +3988,14 @@ var require_flowScaffoldDocs = __commonJS({
         "",
         "1. **\u5B9A\u4F4D**\uFF1A\u8BFB `flow.json` + \u76EE\u6807 `\u8282\u70B9/<\u540D>/code.*` + `flow.meta.json`\uFF08\u53D6 `node_uuid`\uFF09",
         "2. **\u4FEE\u6539**\uFF1A\u53EA\u6539\u5FC5\u8981\u6587\u4EF6\uFF08\u4EE3\u7801 \u2192 `code.*`\uFF1B\u8FDE\u7EBF/\u914D\u7F6E \u2192 `flow.json`\uFF09",
-        "3. **\u9A8C\u8BC1**\uFF08\u5148\u5C0F\u540E\u5927\uFF09\uFF1A",
+        "3. **\u63D0\u4EA4**\uFF08\u5148\u4E8E\u6D4B\u8BD5\uFF09\uFF1A\u6539 `code.*` \u2192 `node push`\uFF1B\u6539\u753B\u5E03/\u914D\u7F6E \u2192 `project push --canvas`",
+        "4. **\u9A8C\u8BC1**\uFF08\u5148\u5C0F\u540E\u5927\uFF09\uFF1A",
         `   - \u5355\u8282\u70B9\uFF1A${(0, flowCliText_1.mdFlowCmd)("run node-exec --node <node_uuid> --dir .")}`,
         `   - \u6574\u6D41\u7A0B\uFF1A${(0, flowCliText_1.mdFlowCmd)("run flow-exec --dir . --type debug")}`,
-        "4. **\u5224\u9519**\uFF1A\u9000\u51FA\u7801\u975E 0 / JSON `success:false` \u2192 \u6253\u5F00 `_run/*.last-error.md`\uFF0C\u6309\u5176\u4E2D**\u9519\u8BEF\u5206\u7C7B**\u4E0E traceback \u4FEE\u590D",
-        "5. **\u91CD\u8BD5**\uFF1A\u56DE\u5230\u6B65\u9AA4 2\uFF1B\u82E5 3 \u8F6E\u4ECD\u5931\u8D25\uFF0C\u6C47\u603B\u5DF2\u5C1D\u8BD5\u4FEE\u590D\u70B9\u5E76\u8BF7\u6C42\u7528\u6237\u4ECB\u5165",
-        "6. **\u63D0\u4EA4**\uFF08\u4EC5\u901A\u8FC7\u540E\uFF09\uFF1A\u4EE3\u7801 `node push`\uFF1B\u753B\u5E03 `project push --canvas`",
+        `   - \u6709 output_variable_name\uFF1A${(0, flowCliText_1.mdFlowCmd)("variable pull --name <\u540D> --dir .")}`,
+        "5. **\u6210\u529F\u5224\u636E**\uFF1Apush \u6210\u529F \u2192 node-exec `success:true` \u2192 \u53D8\u91CF\u5408\u7406\uFF08\u82E5\u9002\u7528\uFF09\uFF1B\u7981\u6B62\u4EC5\u51ED exit code",
+        "6. **\u5224\u9519**\uFF1AJSON `success:false` \u2192 \u6253\u5F00 `_run/*.last-error.md`\uFF0C\u6309**\u9519\u8BEF\u5206\u7C7B**\u4E0E traceback \u4FEE\u590D",
+        "7. **\u91CD\u8BD5**\uFF1A\u56DE\u5230\u6B65\u9AA4 2\uFF1B\u82E5 3 \u8F6E\u4ECD\u5931\u8D25\uFF0C\u6C47\u603B\u5DF2\u5C1D\u8BD5\u4FEE\u590D\u70B9\u5E76\u8BF7\u6C42\u7528\u6237\u4ECB\u5165",
         "",
         "### \u5E38\u89C1\u5931\u8D25 \u2192 \u4F18\u5148\u52A8\u4F5C",
         "",
@@ -3985,14 +4003,15 @@ var require_flowScaffoldDocs = __commonJS({
         "|-----------------|----------|",
         "| \u7F3A\u4E0A\u6E38\u53D8\u91CF | \u5148\u8DD1\u4E0A\u6E38\u8282\u70B9\u6216\u6574\u6D41\u7A0B debug\uFF0C\u518D `variable pull` \u770B schema |",
         "| \u914D\u7F6E\u7F3A\u5931 | `flow.json` \u8BE5\u8282\u70B9 `data`\uFF08connectionId / output_variable_name \u7B49\uFF09 |",
-        "| \u4EE3\u7801\u9519\u8BEF | `code.*` \u4E0E traceback\uFF1B\u6539\u540E\u53EA `node push` |",
+        "| \u4EE3\u7801\u9519\u8BEF | `code.*` \u4E0E traceback\uFF1B\u6539\u540E **`node push` \u2192 `node-exec` \u2192 `variable pull`**\uFF08\u82E5\u9002\u7528\uFF09 |",
         "| \u8FDE\u63A5/\u6570\u636E\u6E90 | connectionId / spaceId \u662F\u5426\u6709\u6548 |",
         "",
         "### Agent \u7981\u6B62\u9879",
         "",
         "- **\u7981\u6B62**\u672A\u5B9E\u9645\u8FD0\u884C\u5C31\u58F0\u79F0\u300C\u5DF2\u4FEE\u590D/\u5DF2\u901A\u8FC7\u300D",
         "- **\u7981\u6B62**\u4E0D\u8BFB `_run/*.last-error.md` \u5C31\u731C\u6D4B\u539F\u56E0",
-        "- **\u7981\u6B62**\u4FEE\u590D\u540E\u8DF3\u8FC7\u9A8C\u8BC1\u76F4\u63A5 `push`",
+        "- **\u7981\u6B62**\u672A `node push` \u5C31 `node-exec` \u9A8C\u8BC1\u4EE3\u7801",
+        "- **\u7981\u6B62**\u4EC5\u51ED exit code \u901A\u8FC7\u5C31\u58F0\u79F0\u5B8C\u6210\uFF08\u987B variable pull\uFF0C\u82E5\u9002\u7528\uFF09",
         "- **\u7981\u6B62**\u628A SQL/Python \u6B63\u6587\u5199\u56DE `flow.json`",
         "",
         "\u4FA7\u680F\u63D0\u793A\u8BCD\u53EF\u9009\u7528 **`flow/run-fix-loop`**\uFF08\u81EA\u4E3B\u6539\u9519\u4E13\u7528\uFF09\u3002",
@@ -4454,7 +4473,7 @@ var require_flowWorkspaceAudit = __commonJS({
           lines.push(`- ${w}`);
         lines.push("", "\u4FEE\u590D\uFF08\u5728\u6D41\u7A0B\u76EE\u5F55\uFF09\uFF1A", "", "```powershell", "dazi flow project repair-meta --dir .", "dazi flow project doctor --dir .", "```", "", `\u8BE6\u89C1 [\u6D41\u7A0B\u672C\u5730\u6587\u4EF6\u89C4\u8303](${localFilesSpecLink})\u3002`, "");
       }
-      lines.push("## \u53D8\u66F4\u63D0\u4EA4\u547D\u4EE4\u77E9\u9635", "", "| \u6539\u4E86\u4EC0\u4E48 | \u547D\u4EE4 |", "|----------|------|", "| `managed_file_id`\u3001`output_variable_name`\u3001\u8FDE\u7EBF\u3001\u589E\u5220\u8282\u70B9 | `dazi flow project push --dir . --canvas` |", "| `\u8282\u70B9/<\u540D>/code.py` \u6216 `code.sql` | `dazi flow node push --node <uuid> --dir .` |", '| **\u65B0\u589E\u4EE3\u7801\u8282\u70B9** | `dazi flow node new --type <type> --dir . --label "<\u540D>"` \u2192 \u6539\u914D\u7F6E \u2192 `push --canvas` \u2192 \u5199 code \u2192 `node push` |', "", "> \u7981\u6B62\u53EA\u6539 `flow.json` \u800C\u4E0D\u66F4\u65B0 `flow.meta.json`\uFF08\u987B `node new` / `pull` / `repair-meta`\uFF09\u3002", "");
+      lines.push("## \u53D8\u66F4\u63D0\u4EA4\u547D\u4EE4\u77E9\u9635", "", "| \u6539\u4E86\u4EC0\u4E48 | \u547D\u4EE4 |", "|----------|------|", "| `managed_file_id`\u3001`output_variable_name`\u3001\u8FDE\u7EBF\u3001\u589E\u5220\u8282\u70B9 | `dazi flow project push --dir . --canvas` |", "| `\u8282\u70B9/<\u540D>/code.py` \u6216 `code.sql` | `dazi flow node push --node <uuid> --dir .` |", '| **\u65B0\u589E\u4EE3\u7801\u8282\u70B9** | `dazi flow node new --type <type> --dir . --label "<\u540D>"` \u2192 \u6539\u914D\u7F6E \u2192 `push --canvas` \u2192 \u5199 code \u2192 `node push` |', "", "> \u7981\u6B62\u53EA\u6539 `flow.json` \u800C\u4E0D\u66F4\u65B0 `flow.meta.json`\uFF08\u987B `node new` / `pull` / `repair-meta`\uFF09\u3002", "> \u6539 `code.*` \u540E\u9A8C\u8BC1\u987A\u5E8F\uFF1A**`node push` \u2192 `node-exec` \u2192 `variable pull`**\uFF08\u6709\u8F93\u51FA\u53D8\u91CF\u65F6\uFF09\uFF1B`node-exec` \u6267\u884C\u5E73\u53F0\u5DF2 push \u7684\u4EE3\u7801\u3002", "");
       return lines;
     }
     exports2.buildFlowConsistencyMarkdown = buildFlowConsistencyMarkdown2;
@@ -4480,7 +4499,7 @@ var require_flowDirResolve = __commonJS({
       if (m)
         return m[1];
       m = norm.match(/(?:^|\/)项目\/([^/]+)\/流程\/([^/]+)(?:\/|$)/);
-      if (m && m[2] !== "flows" && m[2] !== "\u89C4\u5212")
+      if (m && m[2] !== "flows" && m[2] !== "plans" && m[2] !== "\u89C4\u5212")
         return m[1];
       m = norm.match(/(?:^|\/)项目\/(flow_[^/]+)\/流程(?:\/|$)/);
       if (m)
@@ -4517,12 +4536,12 @@ var require_flowDirResolve = __commonJS({
         return false;
       const norm = path_1.default.resolve(dir).replace(/\\/g, "/");
       const base = path_1.default.basename(norm.replace(/\/$/, ""));
-      if (["flows", "\u89C4\u5212", "\u6D41\u7A0B", "\u9879\u76EE", "\u8282\u70B9", "\u53D8\u91CF", "_run"].includes(base))
+      if (["flows", "plans", "\u89C4\u5212", "\u6D41\u7A0B", "\u9879\u76EE", "\u8282\u70B9", "\u53D8\u91CF", "_run"].includes(base))
         return false;
       if (/(?:^|\/)项目\/[^/]+\/流程\/flows\/[^/]+(?:\/|$)/.test(norm))
         return true;
       const legacy = norm.match(/(?:^|\/)项目\/([^/]+)\/流程\/([^/]+)(?:\/|$)/);
-      if (legacy && legacy[2] !== "flows" && legacy[2] !== "\u89C4\u5212")
+      if (legacy && legacy[2] !== "flows" && legacy[2] !== "plans" && legacy[2] !== "\u89C4\u5212")
         return true;
       if (/(?:^|\/)项目\/flow_[^/]+\/流程\/[^/]+(?:\/|$)/.test(norm))
         return true;
@@ -4783,10 +4802,6 @@ var {
   Help
 } = import_index.default;
 
-// cli/dazi-flow/src/commands/flows.ts
-var import_path3 = __toESM(require("path"), 1);
-var import_fs2 = __toESM(require("fs"), 1);
-
 // cli/shared/src/auth.js
 var import_os = __toESM(require("os"), 1);
 var import_path = __toESM(require("path"), 1);
@@ -4966,7 +4981,12 @@ function resolveWorkspace(cwd = process.cwd()) {
   };
 }
 
+// cli/shared/src/version.ts
+var DAZI_VERSION = true ? "3.0.7" : readDevVersion();
+
 // cli/dazi-flow/src/commands/flows.ts
+var import_path3 = __toESM(require("path"), 1);
+var import_fs2 = __toESM(require("fs"), 1);
 function makeFlowsCommand() {
   const cmd = new Command("flows").description("Flow \u7BA1\u7406");
   cmd.command("list").description("\u5217\u51FA\u6240\u6709 Flow").option("--space <spaceId>", "\u8FC7\u6EE4\u7A7A\u95F4").option("--status <status>", "\u8FC7\u6EE4\u72B6\u6001\uFF08active/draft/archived\uFF09").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
@@ -5607,7 +5627,7 @@ function makeProjectCommand() {
         process.exit(1);
       }
       import_fs8.default.mkdirSync(import_path9.default.join(projectRoot, "\u6D41\u7A0B", "flows"), { recursive: true });
-      import_fs8.default.mkdirSync(import_path9.default.join(projectRoot, "\u6D41\u7A0B", "\u89C4\u5212"), { recursive: true });
+      import_fs8.default.mkdirSync(import_path9.default.join(projectRoot, "\u6D41\u7A0B", "plans"), { recursive: true });
       import_fs8.default.writeFileSync(
         import_path9.default.join(projectRoot, "README.md"),
         `# ${folder}
@@ -7237,7 +7257,7 @@ function makeManagedFilesCommand() {
 
 // cli/dazi-flow/src/index.ts
 var program2 = new Command();
-program2.name("dazi-flow").description("\u642D\u5B50 Flow CLI \u2014 \u5DE5\u4F5C\u6D41\u7BA1\u7406").version("3.0.5", "-v, --version");
+program2.name("dazi-flow").description("\u642D\u5B50 Flow CLI \u2014 \u5DE5\u4F5C\u6D41\u7BA1\u7406").version(DAZI_VERSION, "-v, --version");
 program2.addCommand(makeFlowsCommand());
 program2.addCommand(makeSnapshotCommand());
 program2.addCommand(makeProjectCommand());

package/dist/clis/dazi-onto.js

@@ -3036,10 +3036,6 @@ var {
   Help
 } = import_index.default;
 
-// cli/dazi-onto/src/commands/space.ts
-var import_path3 = __toESM(require("path"), 1);
-var import_fs2 = __toESM(require("fs"), 1);
-
 // cli/shared/src/auth.js
 var import_os = __toESM(require("os"), 1);
 var import_path = __toESM(require("path"), 1);
@@ -3219,7 +3215,12 @@ function resolveWorkspace(cwd = process.cwd()) {
   };
 }
 
+// cli/shared/src/version.ts
+var DAZI_VERSION = true ? "3.0.7" : readDevVersion();
+
 // cli/dazi-onto/src/commands/space.ts
+var import_path3 = __toESM(require("path"), 1);
+var import_fs2 = __toESM(require("fs"), 1);
 function makeSpaceCommand() {
   const cmd = new Command("space").description("\u5DE5\u4F5C\u7A7A\u95F4\u7BA1\u7406");
   cmd.command("list").description("\u5217\u51FA\u6240\u6709\u7A7A\u95F4").option("--json", "\u8F93\u51FA JSON").action(async (opts) => {
@@ -3978,7 +3979,7 @@ function makeMcpCommand() {
               result: {
                 protocolVersion: "2024-11-05",
                 capabilities: { tools: {} },
-                serverInfo: { name: "dazi-onto", version: "3.0.5" }
+                serverInfo: { name: "dazi-onto", version: DAZI_VERSION }
               }
             };
             process.stdout.write(JSON.stringify(response) + "\n");
@@ -4001,7 +4002,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.5", "-v, --version");
+program2.name("dazi-onto").description("\u642D\u5B50 Onto CLI \u2014 \u672C\u4F53\uFF08Ontology\uFF09\u7BA1\u7406").version(DAZI_VERSION, "-v, --version");
 program2.addCommand(makeSpaceCommand());
 program2.addCommand(makeFunctionCommand());
 program2.addCommand(makeActionCommand());

package/dist/clis/dazi.js

@@ -3633,11 +3633,6 @@ var {
   Help
 } = import_index.default;
 
-// cli/dazi/src/commands/auth.ts
-var import_os3 = __toESM(require("os"), 1);
-var import_path4 = __toESM(require("path"), 1);
-var import_fs3 = __toESM(require("fs"), 1);
-
 // cli/shared/src/auth.js
 var import_os = __toESM(require("os"), 1);
 var import_path = __toESM(require("path"), 1);
@@ -3856,7 +3851,13 @@ function resolveWorkspace(cwd = process.cwd()) {
   };
 }
 
+// cli/shared/src/version.ts
+var DAZI_VERSION = true ? "3.0.7" : readDevVersion();
+
 // cli/dazi/src/commands/auth.ts
+var import_os3 = __toESM(require("os"), 1);
+var import_path4 = __toESM(require("path"), 1);
+var import_fs3 = __toESM(require("fs"), 1);
 function makeAuthCommand() {
   const cmd = new Command("auth").description("\u8D26\u53F7\u8BA4\u8BC1");
   cmd.command("login").description("\u767B\u5F55\u642D\u5B50\u5E73\u53F0").option("-s, --server <url>", "\u5E73\u53F0\u5730\u5740", getServerUrl()).option("--token <token>", "\u76F4\u63A5\u4F7F\u7528 token \u767B\u5F55\uFF08CI / Token \u6A21\u5F0F\uFF09").option("-u, --username <username>", "\u7528\u6237\u540D\u6216\u90AE\u7BB1\uFF08\u8D26\u53F7\u5BC6\u7801\u6A21\u5F0F\uFF09").option("-p, --password <password>", "\u5BC6\u7801\uFF08\u8D26\u53F7\u5BC6\u7801\u6A21\u5F0F\uFF09").action(async (opts) => {
@@ -4024,7 +4025,7 @@ function makeEnvCommand() {
   return new Command("env").description("\u663E\u793A\u73AF\u5883\u4FE1\u606F").action(() => {
     const auth = tryLoadAuth();
     const env = {
-      version: "3.0.5",
+      version: DAZI_VERSION,
       node: process.version,
       platform: `${import_os5.default.type()} ${import_os5.default.arch()}`,
       serverUrl: getServerUrl(),
@@ -5694,7 +5695,7 @@ function dispatch(msg) {
         result: {
           protocolVersion: "2024-11-05",
           capabilities: { tools: {} },
-          serverInfo: { name: "dazi", version: "3.0.5" }
+          serverInfo: { name: "dazi", version: DAZI_VERSION }
         }
       };
     case "initialized":
@@ -5817,7 +5818,7 @@ function forwardToCli(cliName, extraArgs) {
   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.5", "-v, --version");
+program2.name("dazi").description("\u642D\u5B50 v3 \u2014 Onto / Flow / App \u7EDF\u4E00 CLI").version(DAZI_VERSION, "-v, --version");
 program2.addCommand(makeAuthCommand());
 program2.addCommand(makeDoctorCommand());
 program2.addCommand(makeEnvCommand());

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

@@ -59,9 +59,11 @@ dazi flow run flow-exec --dir $flowDir --type debug
 
 - [ ] `doctor` 为 ✅
 - [ ] 配置变更已 `push --canvas`
-- [ ] 代码变更已 `node push`
+- [ ] 改 `code.*` 后已 **`node push`**（先于 `node-exec`）
+- [ ] `node-exec` JSON `success: true`
+- [ ] 有 `output_variable_name` 时已 **`variable pull`** 且 `变量/<名>.json` 合理
 - [ ] `flow.json` 无代码正文
-- [ ] 测试通过后再声称完成
+- [ ] 以上均满足后再声称完成（禁止仅凭 exit code、禁止未 push 就测代码）
 
 ---
 

package/dist/docs/flow/flow-project-guide.md

@@ -1,7 +1,7 @@
 # 数据流程项目开发指南
 
 **文档 ID**: `flow/flow-project-guide`  
-**适用**: `dazi-vscode` v3.0.4+、`dazi-work` 工作区、业务项目 `项目/<业务名>/`
+**适用**: `dazi-vscode` v3.0.5+、`dazi-work` 工作区、业务项目 `项目/<业务名>/`
 
 ---
 
@@ -128,15 +128,19 @@ dazi flow node push --node <node_uuid> --dir "D:\path\to\dazi-work\项目\财务
    右键 flow.json → 打开流程设计器 → 保存 flow.json
    （AI 手改拓扑须遵守 [§6.2 画布节点与连线规范](#62-画布节点与连线规范ai-创建--编辑-flowjson-必读)）
 
-4. 单节点测试
-   右键 节点/ 或 code.* → 测试运行节点
+4. 提交节点代码（改 code.* 后、测试前必做）
+   右键 code.* → 提交节点
+   CLI： flow node push --node <uuid> --dir .
+
+5. 单节点测试（平台执行已 push 的代码）
+   设计器/运行面板「搭子执行」，或右键 节点/ / code.*
    CLI： flow run node-exec --node <uuid> --dir .
 
-5. 查看变量（表变量 schema + 前 10 行）
+6. 查看变量（表变量 schema + 前 10 行；有 output_variable_name 时建议必做）
    设计器属性面板 output_variable_name 旁 📊
    或： flow variable pull --name <变量名> --dir .
 
-6. 提交到平台
+7. 提交画布（改连线/配置/增删节点时）
    右键 → 提交流程（智能：代码脏节点 + 画布变更）
    CLI： flow project push --dir . --canvas
 

package/dist/docs/flow/flows-guide.md

@@ -52,8 +52,8 @@ dazi flow project status --dir "D:\path\to\dazi-work\项目\财务分析02\流
 | 目录一致性检查     | `flow project doctor --dir <flows/<名>/绝对路径>`                    |
 | 修复 meta 索引     | `flow project repair-meta --dir <flows/<名>/绝对路径>`               |
 | 查看本地改动       | `flow project status --dir <flows/<名>/绝对路径>`                    |
-| 提交单个节点代码   | `flow node push --node <uuid> --dir <flows/<名>/绝对路径>`           |
-| 单节点测试         | `flow run node-exec --node <uuid> --dir <flows/<名>/绝对路径>`       |
+| 提交单个节点代码   | `flow node push --node <uuid> --dir <flows/<名>/绝对路径>`（改 `code.*` 后**先于测试**） |
+| 单节点测试         | `flow run node-exec --node <uuid> --dir <flows/<名>/绝对路径>`（执行**平台已 push** 的代码） |
 | 整流程运行         | `flow run flow-exec --dir <flows/<名>/绝对路径> --type debug`        |
 | 拉取变量           | `flow variable pull --name <名> --dir <flows/<名>/绝对路径>`         |