@dazitech/cli 3.0.0 → 3.0.2

package/dist/clis/dazi-onto.js

@@ -3895,7 +3895,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 +3913,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.2" }
               }
             };
             process.stdout.write(JSON.stringify(response) + "\n");
@@ -3934,7 +3936,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.2", "-v, --version");
 program2.addCommand(makeSpaceCommand());
 program2.addCommand(makeFunctionCommand());
 program2.addCommand(makeActionCommand());

package/dist/clis/dazi.js

@@ -3959,7 +3959,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.2",
       node: process.version,
       platform: `${import_os5.default.type()} ${import_os5.default.arch()}`,
       serverUrl: getServerUrl(),
@@ -5001,7 +5001,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 +5078,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 +5107,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 +5193,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 +5220,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 +5246,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 +5273,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 +5385,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 +5424,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 +5456,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 +5520,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 +5548,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 +5580,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 +5629,7 @@ function dispatch(msg) {
         result: {
           protocolVersion: "2024-11-05",
           capabilities: { tools: {} },
-          serverInfo: { name: "dazi", version: "3.0.0" }
+          serverInfo: { name: "dazi", version: "3.0.2" }
         }
       };
     case "initialized":
@@ -5561,7 +5643,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 +5661,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 +5713,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 +5743,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.2", "-v, --version");
 program2.addCommand(makeAuthCommand());
 program2.addCommand(makeDoctorCommand());
 program2.addCommand(makeEnvCommand());

package/dist/docs/app/app-init.md

@@ -5,28 +5,28 @@
 
 ## 推荐：扩展创建
 
-| 场景 | 操作 |
-|------|------|
-| 新建 monorepo + 首个组件 | 侧栏 **新建项目** → **应用项目** → **新建应用项目** |
-| 已有项目加组件 | **新建项目** → **在已有项目下新建组件**，或 `dazi.app.component.new` |
+| 场景                     | 操作                                                                 |
+| ------------------------ | -------------------------------------------------------------------- |
+| 新建 monorepo + 首个组件 | 侧栏 **新建项目** → **应用项目** → **新建应用项目**                  |
+| 已有项目加组件           | **新建项目** → **在已有项目下新建组件**，或 `dazi.app.component.new` |
 
 生成目录：`项目/app_<名称>/apps/<app_id>/`（含 `manifest.json`、`src/`、`drap-assets/` 等）。
 
 ## CLI：从模板创建
 
-**推荐**：在 **`dazi-work` 根目录**执行 `.\scripts\dazi.ps1 app …`（脚本会自动设置 `DAZI_BUNDLED_DIR`，避免「未找到 bundled CLI」）：
+**推荐**：在 **`dazi-work` 根目录**执行 `dazi app …`（脚本会自动设置 `DAZI_BUNDLED_DIR`，避免「未找到 bundled CLI」）：
 
 ```powershell
 cd D:\path\to\dazi-work
 
 # 从模板创建（--dir 相对 dazi-work 根）
-.\scripts\dazi.ps1 app init <template-id> --space <space-id> --dir 项目/app_<名>/apps/<app-id>
+dazi app init <template-id> --space <space-id> --dir 项目/app_<名>/apps/<app-id>
 
 # 查看可用模板（含平台「转为应用模板」的动态模板）
-.\scripts\dazi.ps1 app templates list --remote
+dazi app templates list --remote
 ```
 
-**可选**：在**应用项目根**（`项目/app_<名称>/`，含 `sdk/`、`templates/`）使用 `pnpm run dazi-app -- …`。若报「未找到 bundled CLI」，需将 `DAZI_BUNDLED_DIR` 指向扩展或 `tools/dazi-clis` 下的 `bundled/clis`，或改用上方 `.\scripts\dazi.ps1 app`。
+**可选**：在**应用项目根**（`项目/app_<名称>/`，含 `sdk/`、`templates/`）使用 `pnpm run dazi-app -- …`。若报「未找到 bundled CLI」，需将 `DAZI_BUNDLED_DIR` 指向扩展或 `tools/dazi-clis` 下的 `bundled/clis`，或改用上方 `dazi app`。
 
 `template-id` 对应 `templates/app-template-*` 目录短名（如 `alarm-center` → `app-template-alarm-center`）。
 
@@ -47,12 +47,12 @@ cd D:\path\to\dazi-work
 
 `manifest.json` 定义应用与平台的绑定关系，常用字段：
 
-| 字段 | 说明 |
-|------|------|
-| `appId` | Registry 全局唯一 ID |
-| `permissions` | 至少 `dataspace:<spaceId>` |
-| `data_sources[]` | 数据集 key + kind |
-| `mount` | `page` 或 `chat_result` |
+| 字段             | 说明                       |
+| ---------------- | -------------------------- |
+| `appId`          | Registry 全局唯一 ID       |
+| `permissions`    | 至少 `dataspace:<spaceId>` |
+| `data_sources[]` | 数据集 key + kind          |
+| `mount`          | `page` 或 `chat_result`    |
 
 扩展 **配置 manifest 数据源**（`dazi.app.editDataSources`）可图形化编辑 `data_sources`。
 
@@ -60,7 +60,7 @@ cd D:\path\to\dazi-work
 
 ```powershell
 # 在 dazi-work 根
-.\scripts\dazi.ps1 app manifest validate --cwd 项目/app_<名>/apps/<app-id> --scan-src
+dazi app manifest validate --cwd 项目/app_<名>/apps/<app-id> --scan-src
 ```
 
 ## 相关文档

package/dist/docs/app/build-upload.md

@@ -5,12 +5,12 @@
 
 ## 工作目录
 
-| 操作 | 目录 |
-|------|------|
-| `.\scripts\dazi.ps1 app …`（init、upload、release 等） | **`dazi-work` 根**；路径用 `--cwd 项目/app_<名>/apps/<app_id>`（相对工作区根） |
-| `pnpm run dazi-app`（可选） | **应用项目根**（含 `sdk/`、`templates/`）；需正确设置 `DAZI_BUNDLED_DIR`，否则易报「未找到 bundled CLI」 |
-| `pnpm run dev` / `build` | **应用组件目录** `apps/<app_id>/` |
-| 扩展「构建并发布」 | 在侧栏选中**应用组件**节点，无需手填路径 |
+| 操作                                     | 目录                                                                                                     |
+| ---------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `dazi app …`（init、upload、release 等） | **`dazi-work` 根**；路径用 `--cwd 项目/app_<名>/apps/<app_id>`（相对工作区根）                           |
+| `pnpm run dazi-app`（可选）              | **应用项目根**（含 `sdk/`、`templates/`）；需正确设置 `DAZI_BUNDLED_DIR`，否则易报「未找到 bundled CLI」 |
+| `pnpm run dev` / `build`                 | **应用组件目录** `apps/<app_id>/`                                                                        |
+| 扩展「构建并发布」                       | 在侧栏选中**应用组件**节点，无需手填路径                                                                 |
 
 发布前确认扩展登录与 **发布目标 API**（`dazi.serverUrl` / `~/.dazi/auth.json`）一致。
 
@@ -20,7 +20,7 @@
 
 ```bash
 pnpm run dev
-# 或（在 dazi-work 根）：.\scripts\dazi.ps1 app dev --cwd 项目/app_<名>/apps/<app_id>
+# 或（在 dazi-work 根）：dazi app dev --cwd 项目/app_<名>/apps/<app_id>
 ```
 
 ## 构建
@@ -39,13 +39,13 @@ pnpm run build
 cd D:\path\to\dazi-work
 
 # 上传到指定空间
-.\scripts\dazi.ps1 app upload --cwd 项目/app_<名>/apps/<app_id> --space <space-id>
+dazi app upload --cwd 项目/app_<名>/apps/<app_id> --space <space-id>
 
 # 上传并立即激活
-.\scripts\dazi.ps1 app upload --cwd 项目/app_<名>/apps/<app_id> --space <space-id> --activate
+dazi app upload --cwd 项目/app_<名>/apps/<app_id> --space <space-id> --activate
 
 # 带更新日志
-.\scripts\dazi.ps1 app upload --cwd 项目/app_<名>/apps/<app_id> --space <space-id> --changelog "修复了 #123 问题"
+dazi app upload --cwd 项目/app_<名>/apps/<app_id> --space <space-id> --changelog "修复了 #123 问题"
 ```
 
 等价写法（须在应用项目根且已配置 `DAZI_BUNDLED_DIR`）：`pnpm run dazi-app -- upload --cwd apps/<app_id> --space <space-id>`。
@@ -55,9 +55,9 @@ cd D:\path\to\dazi-work
 ## 本地预览（上传前）
 
 ```powershell
-.\scripts\dazi.ps1 app preview all --cwd 项目/app_<名>/apps/<app_id>
-.\scripts\dazi.ps1 app preview sql --cwd 项目/app_<名>/apps/<app_id>
-.\scripts\dazi.ps1 app preview script --cwd 项目/app_<名>/apps/<app_id>
+dazi app preview all --cwd 项目/app_<名>/apps/<app_id>
+dazi app preview sql --cwd 项目/app_<名>/apps/<app_id>
+dazi app preview script --cwd 项目/app_<名>/apps/<app_id>
 ```
 
 ## 相关文档

package/dist/docs/app/release-guide.md

@@ -1,7 +1,7 @@
 # 应用发布管理
 
 **文档 ID**: `app/release-guide`  
-**适用**：在 **`dazi-work` 根**通过 `.\scripts\dazi.ps1 app …` 管理发布；`--cwd` 指向 `项目/app_<名>/apps/<app_id>/`。
+**适用**：在 **`dazi-work` 根**通过 `dazi app …` 管理发布；`--cwd` 指向 `项目/app_<名>/apps/<app_id>/`。
 
 场景实践：[主要财务指标复杂报表开发实践](./主要财务指标复杂报表开发实践.md)（模板 `financial-indicators-complex-report`）。
 
@@ -9,7 +9,7 @@
 cd D:\path\to\dazi-work
 
 # 查看某应用的发布版本
-.\scripts\dazi.ps1 app release list <app-id> --cwd 项目/app_<名>/apps/<app-id>
+dazi app release list <app-id> --cwd 项目/app_<名>/apps/<app-id>
 ```
 
 扩展 **构建并发布** 会调用同一套 API；发布目标由 `dazi.serverUrl` / `~/.dazi/auth.json` 决定（见 §333）。
@@ -17,19 +17,19 @@ cd D:\path\to\dazi-work
 ## 查看发布版本
 
 ```powershell
-.\scripts\dazi.ps1 app release list <app-id> --cwd 项目/app_<名>/apps/<app-id>
+dazi app release list <app-id> --cwd 项目/app_<名>/apps/<app-id>
 ```
 
 ## 激活指定版本
 
 ```powershell
-.\scripts\dazi.ps1 app release activate <app-id> --semver 1.2.0 --cwd 项目/app_<名>/apps/<app-id>
+dazi app release activate <app-id> --semver 1.2.0 --cwd 项目/app_<名>/apps/<app-id>
 ```
 
 ## 撤回版本
 
 ```powershell
-.\scripts\dazi.ps1 app release revoke <app-id> --semver 1.2.0 --cwd 项目/app_<名>/apps/<app-id>
+dazi app release revoke <app-id> --semver 1.2.0 --cwd 项目/app_<名>/apps/<app-id>
 ```
 
 ## 版本号规范
@@ -43,9 +43,9 @@ cd D:\path\to\dazi-work
 ## 资源管理
 
 ```powershell
-.\scripts\dazi.ps1 app asset list --cwd 项目/app_<名>/apps/<app-id>
-.\scripts\dazi.ps1 app asset new-sql --cwd 项目/app_<名>/apps/<app-id>
-.\scripts\dazi.ps1 app asset new-script --cwd 项目/app_<名>/apps/<app-id>
+dazi app asset list --cwd 项目/app_<名>/apps/<app-id>
+dazi app asset new-sql --cwd 项目/app_<名>/apps/<app-id>
+dazi app asset new-script --cwd 项目/app_<名>/apps/<app-id>
 ```
 
-> **说明**：亦可在应用项目根使用 `pnpm run dazi-app -- release list …` 等等价命令，但需先配置 `DAZI_BUNDLED_DIR`；推荐统一使用 `.\scripts\dazi.ps1 app`。
+> **说明**：亦可在应用项目根使用 `pnpm run dazi-app -- release list …` 等等价命令，但需先配置 `DAZI_BUNDLED_DIR`；推荐统一使用 `dazi app`。