@dazitech/cli 3.0.0 → 3.0.2

package/dist/prompts/flow/flow-design.md

@@ -18,46 +18,60 @@
 3. 明确每个代码节点应写入哪个文件（`节点/<名>/code.sql|py`）
 4. 给出最短执行命令链（拉取/测试/提交）
 
+## 本地文件契约（必须遵守）
+
+必读帮助文档：**`flow/local-files-spec`**、**`flow/ai-workflow-playbook`**。
+
+| 文件 | 规则 |
+|------|------|
+| `flow.json` | 画布与节点配置（`managed_file_id` 等）；禁止手搓 `node_uuid` |
+| `flow.meta.json` | 仅由 `pull` / `node new` / `repair-meta` 维护；设计器靠它打开代码 |
+| `节点/<名>/code.*` | 代码正文唯一位置 |
+
+**禁止**：只改 `flow.json` 而不更新 meta（会导致打不开代码、`node push` 跳过）。
+
 ## 命令与环境约束（必须遵守）
 
-- 默认在 **`dazi-work` 根目录**执行，命令前缀统一：`.\scripts\dazi.ps1 flow ...`
+- 默认在 **`dazi-work` 根目录**执行，命令前缀统一：`dazi flow ...`
 - 进入流程目录后可继续带 `--dir .`，不要省略关键参数
-- `flow.json` 是画布与配置真理源；`节点/<名>/code.*` 是代码真理源
-- 修改拓扑/连线/节点配置后，必须 `flow project push --dir . --canvas`
+- 修改 `managed_file_id`、`output_variable_name`、连线、拓扑 → **`flow project push --dir . --canvas`**
+- 修改 `code.py` / `code.sql` → **`flow node push --node <uuid> --dir .`**
+- 新增代码节点 → **`flow node new`**，禁止手搓 uuid
+- 目录不一致 → **`flow project doctor`** → **`repair-meta`**
 - 禁止使用裸 `dazi-flow ...` 作为最终交付命令
 
 ## 常见节点类型（按业务类型 data.type）
 
-> **完整节点清单与配置说明**见帮助文档 [flow/flows-guide §流程节点组件](../docs/flow/flows-guide.md#流程节点组件)，或流程目录 **快速启动_<流程名>.md §可用流程节点**。
+> **完整节点清单与配置说明**见帮助文档 [flow/flows-guide §流程节点组件](../docs/flow/flows-guide.md#流程节点组件)，或流程目录 **快速启动\_<流程名>.md §可用流程节点**。
 
-| 节点类型 | 说明 |
-|---------|------|
-| `excel-import` / `excel-python` | Excel：**有 `managed_file_id` 时优先 `excel-python`**（勿用 `file-source`）；极简单单 Sheet 才用 `excel-import` |
-| `database-source` / `dataspace-source` | 外部库 / 数据空间 SQL 读取，产出表变量 |
-| `sql-query` | 消费上游变量（变量名即 SQL 表名） |
-| `python-script` | Python 转换，输出 `result_df` |
-| `condition` | 条件分支，出边使用 `true/false` |
-| `data-quality-check` | 数据质量检查 |
-| `database-sink` / `dataspace-sink` | 写出到外部库 / 数据空间（通常无 `code.*`） |
-| `file-source` / `delay` / `folder-resource-*` | 文件输入、延时、文件夹资源 |
+| 节点类型                                      | 说明                                                                                                            |
+| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `excel-import` / `excel-python`               | Excel：**有 `managed_file_id` 时优先 `excel-python`**（勿用 `file-source`）；极简单单 Sheet 才用 `excel-import` |
+| `database-source` / `dataspace-source`        | 外部库 / 数据空间 SQL 读取，产出表变量                                                                          |
+| `sql-query`                                   | 消费上游变量（变量名即 SQL 表名）                                                                               |
+| `python-script`                               | Python 转换，输出 `result_df`                                                                                   |
+| `condition`                                   | 条件分支，出边使用 `true/false`                                                                                 |
+| `data-quality-check`                          | 数据质量检查                                                                                                    |
+| `database-sink` / `dataspace-sink`            | 写出到外部库 / 数据空间（通常无 `code.*`）                                                                      |
+| `file-source` / `delay` / `folder-resource-*` | 文件输入、延时、文件夹资源                                                                                      |
 
 ## 推荐开发流程（流程项目）
 
 ```powershell
 # 1) 拉取/同步到本地流程目录
-.\scripts\dazi.ps1 flow project pull --flow <flow_id> --dir "项目\flow_xxx\流程\<流程名>"
+dazi flow project pull --flow <flow_id> --dir "项目\flow_xxx\流程\<流程名>"
 
 # 2) 若需新增节点（不要伪造 uuid）
-.\scripts\dazi.ps1 flow node new --type <node_type> --dir . --label "<节点名>"
+dazi flow node new --type <node_type> --dir . --label "<节点名>"
 
 # 3) 修改 flow.json（节点配置与连线）+ 修改 节点/<名>/code.*
 
 # 4) 单节点测试
-.\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .
+dazi flow run node-exec --node <node_uuid> --dir .
 
 # 5) 提交（代码可用 node push；拓扑/配置变更必须 canvas push）
-.\scripts\dazi.ps1 flow node push --node <node_uuid> --dir .
-.\scripts\dazi.ps1 flow project push --dir . --canvas
+dazi flow node push --node <node_uuid> --dir .
+dazi flow project push --dir . --canvas
 ```
 
 ## 一致性检查（回答末尾必须自检）

package/dist/prompts/flow/plan-generate.md

@@ -29,7 +29,7 @@
 
 ## 命令约束（必须遵守）
 
-- 命令前缀统一：`.\scripts\dazi.ps1 flow ...`（在 `dazi-work` 根）
+- 命令前缀统一：`dazi flow ...`（在 `dazi-work` 根）
 - 在流程目录执行时，命令建议显式带 `--dir .`
 - 禁止输出裸 `dazi-flow ...` 作为最终交付命令
 
@@ -37,20 +37,20 @@
 
 ```powershell
 # 查看当前状态
-.\scripts\dazi.ps1 flow project status --dir .
+dazi flow project status --dir .
 
 # 新增节点（若需要）
-.\scripts\dazi.ps1 flow node new --type <node_type> --dir . --label "<节点名>"
+dazi flow node new --type <node_type> --dir . --label "<节点名>"
 
 # 单节点验证
-.\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .
+dazi flow run node-exec --node <node_uuid> --dir .
 
 # 整流程验证
-.\scripts\dazi.ps1 flow run flow-exec --dir . --type debug
+dazi flow run flow-exec --dir . --type debug
 
 # 提交（改画布/配置时必须 canvas）
-.\scripts\dazi.ps1 flow node push --node <node_uuid> --dir .
-.\scripts\dazi.ps1 flow project push --dir . --canvas
+dazi flow node push --node <node_uuid> --dir .
+dazi flow project push --dir . --canvas
 ```
 
 ## 回答格式要求

package/dist/prompts/flow/run-debug.md

@@ -14,7 +14,7 @@
 {{debug_output}}
 ```
 
-> 若用户未粘贴输出：AI **应主动读取** `_run/*.last-error.md`、`_run/flow.last-run.md`（及 `变量/` 下 schema），必要时自行执行 `.\scripts\dazi.ps1 flow run ...` 复现；Agent 模式见 `flow/run-fix-loop`。
+> 若用户未粘贴输出：AI **应主动读取** `_run/*.last-error.md`、`_run/flow.last-run.md`（及 `变量/` 下 schema），必要时自行执行 `dazi flow run ...` 复现；Agent 模式见 `flow/run-fix-loop`。
 
 ## 分析要求
 
@@ -26,18 +26,18 @@
 
 ## 常见问题类型
 
-| 症状 | 可能原因 |
-|------|---------|
-| `KeyError` | 字段名不一致，检查上游变量 schema（`变量/<name>.json`） |
-| `TypeError` | 数据类型不符，检查字段类型 |
-| `ConnectionError` | 数据源连接失败，检查数据源配置 |
-| `PermissionError` | 缺少权限，检查登录状态与权限 |
-| 节点超时 | 数据量过大或查询未优化 |
-| 上游变量缺失 | 未先运行上游节点或整流程 |
+| 症状              | 可能原因                                                |
+| ----------------- | ------------------------------------------------------- |
+| `KeyError`        | 字段名不一致，检查上游变量 schema（`变量/<name>.json`） |
+| `TypeError`       | 数据类型不符，检查字段类型                              |
+| `ConnectionError` | 数据源连接失败，检查数据源配置                          |
+| `PermissionError` | 缺少权限，检查登录状态与权限                            |
+| 节点超时          | 数据量过大或查询未优化                                  |
+| 上游变量缺失      | 未先运行上游节点或整流程                                |
 
 ## 命令约束（必须遵守）
 
-- 命令前缀统一：`.\scripts\dazi.ps1 flow ...`（在 `dazi-work` 根）
+- 命令前缀统一：`dazi flow ...`（在 `dazi-work` 根）
 - 在流程目录执行时，保留 `--dir .`，避免误跑到其他流程
 - 禁止输出裸 `dazi-flow ...` 作为最终命令
 
@@ -47,13 +47,13 @@
 
 ```powershell
 # 仅重测失败节点（优先）
-.\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .
+dazi flow run node-exec --node <node_uuid> --dir .
 
 # 整流程回归（必要时）
-.\scripts\dazi.ps1 flow run flow-exec --dir . --type debug
+dazi flow run flow-exec --dir . --type debug
 
 # 拉取变量确认修复效果
-.\scripts\dazi.ps1 flow variable pull --name <output_variable_name> --dir .
+dazi flow variable pull --name <output_variable_name> --dir .
 ```
 
 ## 回答格式要求
@@ -62,5 +62,5 @@
 2. **修复动作**：改 `flow.json` 还是改 `节点/<名>/code.*`
 3. **执行命令**：按顺序给出可直接复制的命令
 4. **提交动作**：
-   - 只改代码：`.\scripts\dazi.ps1 flow node push --node <node_uuid> --dir .`
-   - 改了拓扑或节点配置：`.\scripts\dazi.ps1 flow project push --dir . --canvas`
+   - 只改代码：`dazi flow node push --node <node_uuid> --dir .`
+   - 改了拓扑或节点配置：`dazi flow project push --dir . --canvas`

package/dist/prompts/flow/run-fix-loop.md

@@ -11,20 +11,23 @@
 
 1. **扩展不会自动改代码**；你必须在终端**亲自执行** CLI 并读取 `_run/` 错误文件。
 2. **改 → 跑 → 读错 → 再改 → 再跑** 是默认工作方式，不是可选项。
-3. 命令前缀统一：`.\scripts\dazi.ps1 flow ...`（在 `dazi-work` 根；流程目录用 `--dir .`）。
+3. 命令前缀统一：`dazi flow ...`（在 `dazi-work` 根；流程目录用 `--dir .`）。
 
 ## 命令约束（必须遵守）
 
-- 命令前缀统一：`.\scripts\dazi.ps1 flow ...`（在 `dazi-work` 根）
+- 命令前缀统一：`dazi flow ...`（在 `dazi-work` 根）
 - 在流程目录执行时，保留 `--dir .`，避免误跑到其他流程
+- 配置变更必须 `project push --dir . --canvas`（无 `--canvas` 不会更新平台画布）
+- push 前先 `project doctor`；不一致则 `repair-meta`
 - 禁止输出裸 `dazi-flow ...` 作为最终命令
+- 必读：`flow/local-files-spec`
 
 ## 错误发现（跑完必做）
 
-| 运行 | 失败时必读 | 步骤/日志 |
-|------|------------|-----------|
-| `.\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .` | `_run/<节点名>.last-error.md` | — |
-| `.\scripts\dazi.ps1 flow run flow-exec --dir . --type debug` | `_run/flow.last-error.md` | `_run/flow.last-run.md` |
+| 运行                                                 | 失败时必读                    | 步骤/日志               |
+| ---------------------------------------------------- | ----------------------------- | ----------------------- |
+| `dazi flow run node-exec --node <node_uuid> --dir .` | `_run/<节点名>.last-error.md` | —                       |
+| `dazi flow run flow-exec --dir . --type debug`       | `_run/flow.last-error.md`     | `_run/flow.last-run.md` |
 
 带 `--json` 时同时检查：`success: false`、`errorFile` 路径。
 
@@ -38,9 +41,9 @@ FOR round = 1..3:
   2. 修改 code.* 和/或 flow.json（遵守画布锚点规范）
   3. 运行验证：
      - 优先单节点：
-       .\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .
+       dazi flow run node-exec --node <node_uuid> --dir .
      - 需要全链路时：
-       .\scripts\dazi.ps1 flow run flow-exec --dir . --type debug
+       dazi flow run flow-exec --dir . --type debug
   4. IF 成功 → push（见下）→ 结束
      ELSE → 读新生成的 last-error.md → 下一轮
   5. IF round==3 仍失败 → 输出：失败节点、3 轮尝试摘要、剩余疑点、需用户提供的资料
@@ -48,18 +51,18 @@ FOR round = 1..3:
 
 ## 修复决策树
 
-| 错误分类 | 改哪里 | 验证命令 |
-|----------|--------|----------|
-| 缺上游变量 | 先跑上游或整流程 | `.\scripts\dazi.ps1 flow run flow-exec --dir . --type debug`，再 `.\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .` |
-| 配置缺失 | `flow.json` 节点 `data` | `.\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .` → `.\scripts\dazi.ps1 flow project push --dir . --canvas` |
-| 代码错误 | `节点/<名>/code.sql\|py` | `.\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .` → `.\scripts\dazi.ps1 flow node push --node <node_uuid> --dir .` |
-| 连接/数据源 | connectionId / spaceId | 改配置后 `.\scripts\dazi.ps1 flow project push --dir . --canvas` |
+| 错误分类    | 改哪里                   | 验证命令                                                                                                |
+| ----------- | ------------------------ | ------------------------------------------------------------------------------------------------------- |
+| 缺上游变量  | 先跑上游或整流程         | `dazi flow run flow-exec --dir . --type debug`，再 `dazi flow run node-exec --node <node_uuid> --dir .` |
+| 配置缺失    | `flow.json` 节点 `data`  | `dazi flow run node-exec --node <node_uuid> --dir .` → `dazi flow project push --dir . --canvas`        |
+| 代码错误    | `节点/<名>/code.sql\|py` | `dazi flow run node-exec --node <node_uuid> --dir .` → `dazi flow node push --node <node_uuid> --dir .` |
+| 连接/数据源 | connectionId / spaceId   | 改配置后 `dazi flow project push --dir . --canvas`                                                      |
 
 ## 提交规则
 
-- 只改代码：`.\scripts\dazi.ps1 flow node push --node <node_uuid> --dir .`
-- 改连线/配置/增删节点：`.\scripts\dazi.ps1 flow project push --dir . --canvas`
-- 确认变量 schema：`.\scripts\dazi.ps1 flow variable pull --name <output_variable_name> --dir .`
+- 只改代码：`dazi flow node push --node <node_uuid> --dir .`
+- 改连线/配置/增删节点：`dazi flow project push --dir . --canvas`
+- 确认变量 schema：`dazi flow variable pull --name <output_variable_name> --dir .`
 - **禁止**未验证通过就 push
 
 ## 回答格式（每轮结束后）

package/dist/prompts/general/ask-dazi.md

@@ -7,12 +7,12 @@
 
 你是一名搭子（Dazi）平台专家，熟悉以下所有模块：
 
-- **`.\scripts\dazi.ps1 onto`**：本体管理（函数、动作、规则、脚本）
-- **`.\scripts\dazi.ps1 flow`**：数据流程（Flow 创建、运行、调试）
+- **`dazi onto`**：本体管理（函数、动作、规则、脚本）
+- **`dazi flow`**：数据流程（Flow 创建、运行、调试）
 - **`pnpm run dazi-app --`**（`runtime-apps`）：前端应用（Vue 3 应用开发、发布）
-- **`.\scripts\dazi.ps1 data`**：数据资源（数据空间、数据表、数据集）
-- **`.\scripts\dazi.ps1 auth`**：认证管理
-- **`.\scripts\dazi.ps1 migrate`**：迁移工具
+- **`dazi data`**：数据资源（数据空间、数据表、数据集）
+- **`dazi auth`**：认证管理
+- **`dazi migrate`**：迁移工具
 
 ## 用户问题
 
@@ -27,4 +27,4 @@
 
 ## 平台文档索引
 
-可通过 `.\scripts\dazi.ps1 docs list` 查看所有文档，`.\scripts\dazi.ps1 docs open <id>` 打开。
+可通过 `dazi docs list` 查看所有文档，`dazi docs open <id>` 打开。

package/dist/prompts/general/troubleshoot.md

@@ -18,12 +18,13 @@
 ```powershell
 # 在 dazi-work 根目录运行
 .\scripts\doctor-cli.ps1
-.\scripts\dazi.ps1 doctor
-.\scripts\dazi.ps1 env
-.\scripts\dazi.ps1 auth whoami
+dazi doctor
+dazi env
+dazi auth whoami
 ```
 
 环境输出：
+
 ```
 {{env_output}}
 ```

package/dist/prompts/index.json

@@ -1,20 +1,99 @@
 {
-  "version": "3.0.0-beta.3",
+  "version": "3.0.2",
   "updatedAt": "2026-05-26T00:00:00.000Z",
   "prompts": [
-    { "id": "onto/script-publish-run", "title": "本体脚本发布与运行（TRAE/智能体）", "category": "onto", "file": "onto/script-publish-run.md" },
-    { "id": "onto/function-design", "title": "本体函数设计",          "category": "onto",    "file": "onto/function-design.md" },
-    { "id": "onto/action-design",   "title": "本体动作（Action）设计", "category": "onto",    "file": "onto/action-design.md" },
-    { "id": "onto/rule-seed",       "title": "规则种子脚本",           "category": "onto",    "file": "onto/rule-seed.md" },
-    { "id": "flow/flow-design",     "title": "Flow 设计",             "category": "flow",    "file": "flow/flow-design.md", "featured": true },
-    { "id": "flow/run-debug",       "title": "Run 调试分析",          "category": "flow",    "file": "flow/run-debug.md" },
-    { "id": "flow/run-fix-loop",  "title": "Flow 自主运行改错",      "category": "flow",    "file": "flow/run-fix-loop.md", "featured": true },
-    { "id": "flow/plan-generate",   "title": "执行计划生成",           "category": "flow",    "file": "flow/plan-generate.md" },
-    { "id": "app/ui-design",        "title": "搭子 App UI 设计",      "category": "app",     "file": "app/ui-design.md" },
-    { "id": "data/data-analysis",   "title": "数据分析",              "category": "data",    "file": "data/data-analysis.md" },
-    { "id": "data/sql-query",       "title": "SQL 查询生成",          "category": "data",    "file": "data/sql-query.md" },
-    { "id": "general/ask-dazi",     "title": "询问搭子平台",          "category": "general", "file": "general/ask-dazi.md" },
-    { "id": "general/troubleshoot", "title": "问题排查",              "category": "general", "file": "general/troubleshoot.md" },
-    { "id": "general/code-review",  "title": "搭子脚本代码审查",      "category": "general", "file": "general/code-review.md" }
+    {
+      "id": "onto/script-publish-run",
+      "title": "本体脚本发布与运行（TRAE/智能体）",
+      "category": "onto",
+      "file": "onto/script-publish-run.md"
+    },
+    {
+      "id": "onto/function-design",
+      "title": "本体函数设计",
+      "category": "onto",
+      "file": "onto/function-design.md"
+    },
+    {
+      "id": "onto/action-design",
+      "title": "本体动作（Action）设计",
+      "category": "onto",
+      "file": "onto/action-design.md"
+    },
+    {
+      "id": "onto/rule-seed",
+      "title": "规则种子脚本",
+      "category": "onto",
+      "file": "onto/rule-seed.md"
+    },
+    {
+      "id": "flow/flow-design",
+      "title": "Flow 设计",
+      "category": "flow",
+      "file": "flow/flow-design.md",
+      "featured": true
+    },
+    {
+      "id": "flow/ai-workflow-playbook",
+      "title": "流程 AI 工作手册",
+      "category": "flow",
+      "file": "flow/ai-workflow-playbook.md",
+      "featured": true
+    },
+    {
+      "id": "flow/run-debug",
+      "title": "Run 调试分析",
+      "category": "flow",
+      "file": "flow/run-debug.md"
+    },
+    {
+      "id": "flow/run-fix-loop",
+      "title": "Flow 自主运行改错",
+      "category": "flow",
+      "file": "flow/run-fix-loop.md",
+      "featured": true
+    },
+    {
+      "id": "flow/plan-generate",
+      "title": "执行计划生成",
+      "category": "flow",
+      "file": "flow/plan-generate.md"
+    },
+    {
+      "id": "app/ui-design",
+      "title": "搭子 App UI 设计",
+      "category": "app",
+      "file": "app/ui-design.md"
+    },
+    {
+      "id": "data/data-analysis",
+      "title": "数据分析",
+      "category": "data",
+      "file": "data/data-analysis.md"
+    },
+    {
+      "id": "data/sql-query",
+      "title": "SQL 查询生成",
+      "category": "data",
+      "file": "data/sql-query.md"
+    },
+    {
+      "id": "general/ask-dazi",
+      "title": "询问搭子平台",
+      "category": "general",
+      "file": "general/ask-dazi.md"
+    },
+    {
+      "id": "general/troubleshoot",
+      "title": "问题排查",
+      "category": "general",
+      "file": "general/troubleshoot.md"
+    },
+    {
+      "id": "general/code-review",
+      "title": "搭子脚本代码审查",
+      "category": "general",
+      "file": "general/code-review.md"
+    }
   ]
 }

package/dist/prompts/onto/action-design.md

@@ -23,25 +23,27 @@
 def main(params: dict, context: dict, s=None) -> dict:
     """
     [动作说明]
-    
+
     Args:
         params: 动作参数
         context: 触发上下文（user_id, org_id, permission_tags 等）
-        
+
     Returns:
         {"status": "ok", ...}
     """
     # 权限检查（可选）
     if "finance.write" not in context.get("permission_tags", []):
         raise PermissionError("缺少 finance.write 权限")
-    
+
     # 执行写操作
-    
+
     return {"status": "ok"}
 ```
 
 发布命令（v3；**勿用** `dazi-onto`）：
+
 ```powershell
-.\scripts\dazi.ps1 onto script publish 项目/onto_<名>/脚本/<file>.py --space <space-id> --register-action-id <action_code> --register-action-permission-tag "finance.write"
+dazi onto script publish 项目/onto_<名>/脚本/<file>.py --space <space-id> --register-action-id <action_code> --register-action-permission-tag "finance.write"
 ```
+
 详见提示词 `onto/script-publish-run`。

package/dist/prompts/onto/function-design.md

@@ -26,10 +26,10 @@
 def main(params: dict, s=None) -> dict:
     """
     [函数说明]
-    
+
     Args:
         params: 包含 xxx（说明）
-        
+
     Returns:
         包含 xxx（说明）
     """
@@ -37,8 +37,10 @@ def main(params: dict, s=None) -> dict:
 ```
 
 发布与运行（v3，工作区根目录；**勿用** `dazi-onto`）：
+
 ```powershell
-.\scripts\dazi.ps1 onto script publish 项目/onto_<名>/脚本/functions/<file>.py --space <space-id> --register-function-id <id>
-.\scripts\dazi.ps1 onto function run <id> --space <space-id>
+dazi onto script publish 项目/onto_<名>/脚本/functions/<file>.py --space <space-id> --register-function-id <id>
+dazi onto function run <id> --space <space-id>
 ```
+
 详见提示词 `onto/script-publish-run`（侧栏 帮助 → 提示词）。

package/dist/prompts/onto/rule-seed.md

@@ -29,13 +29,15 @@ def main(params: dict, s=None) -> dict:
             "metadata": {}
         },
     ]
-    
+
     result = s.ontology_rules.upsert(rules)
     return {"upserted": len(rules), "result": result}
 ```
 
 执行命令（v3；**勿用** `dazi-onto`）：
+
 ```powershell
-.\scripts\dazi.ps1 onto rule run-seed --space <space-id> --stem <seed_file_stem>
+dazi onto rule run-seed --space <space-id> --stem <seed_file_stem>
 ```
+
 详见提示词 `onto/script-publish-run`。

package/dist/prompts/onto/script-publish-run.md

@@ -13,7 +13,7 @@
 1. **禁止**在终端使用独立命令 `dazi-onto`（v3 未安装到系统 PATH）。
 2. **禁止**用旧版 `dazi-agent` / `dazi-agent.exe` 发布 v3 本体脚本（API 与路径不一致）。
 3. **必须**使用下列之一调用 CLI：
-   - **推荐（工作区含 `scripts/dazi.ps1`）**：`.\scripts\dazi.ps1 onto <子命令> ...`
+   - **推荐（工作区含 `scripts/dazi.ps1`）**：`dazi onto <子命令> ...`
    - **仅开发仓库**：`node bundled/clis/dazi.js onto ...`（维护方打包用；客户环境用 `dazi.ps1`）
    - **完整路径**：`node <搭子仓库>/dazi/dazi-vscode/bundled/clis/dazi.js onto <子命令> ...`，并设置环境变量 `DAZI_BUNDLED_DIR=<同目录 bundled/clis>`
 4. **工作目录**必须是搭子工作区根（含 `项目/` 目录），例如 `dazi-work`。
@@ -29,7 +29,7 @@
     脚本/
       setup/           ← 初始化、灌数（先 init 后 seed）
       functions/       ← 本体函数
-  资源/docs/           ← .\scripts\dazi.ps1 docs sync 后的指南
+  资源/docs/           ← dazi docs sync 后的指南
   scripts/             ← dazi.ps1 / dazi.cmd 包装（客户工作区模板应包含）
 ```
 
@@ -40,9 +40,9 @@
 
 ```powershell
 cd <工作区根>
-.\scripts\dazi.ps1 auth whoami
+dazi auth whoami
 # 未登录则：
-.\scripts\dazi.ps1 auth login
+dazi auth login
 ```
 
 若提示找不到 `bundled/clis/dazi.js`，在搭子源码目录执行一次：`cd dazi/dazi-vscode && pnpm run bundle:clis`（实施方仓库维护，客户环境由交付包或 VSIX 提供）。
@@ -54,19 +54,19 @@ cd <工作区根>
 ### 1. 预检（可选）
 
 ```powershell
-.\scripts\dazi.ps1 onto script publish-preview <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间> --type setup
+dazi onto script publish-preview <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间> --type setup
 ```
 
 ### 2. 发布初始化脚本（setup）
 
 ```powershell
-.\scripts\dazi.ps1 onto script publish <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间> --type setup
+dazi onto script publish <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间> --type setup
 ```
 
 ### 3. 发布灌数脚本（data）
 
 ```powershell
-.\scripts\dazi.ps1 onto script publish <项目路径>/脚本/setup/xxx_seed_data.py --space <空间> --type data
+dazi onto script publish <项目路径>/脚本/setup/xxx_seed_data.py --space <空间> --type data
 ```
 
 ### 4. 发布本体函数（**必须** `--register-function-id`，否则函数列表看不到）
@@ -76,16 +76,16 @@ cd <工作区根>
 发布后必须确认输出含 `functionId` / `function_registration.ok`，并执行 `function list` 能看到该 id。
 
 ```powershell
-.\scripts\dazi.ps1 onto script publish <项目路径>/脚本/functions/xxx_fn_yyy.py --space <空间> --register-function-id <domain>.fn.<name>
-.\scripts\dazi.ps1 onto function list --space <空间>
+dazi onto script publish <项目路径>/脚本/functions/xxx_fn_yyy.py --space <空间> --register-function-id <domain>.fn.<name>
+dazi onto function list --space <空间>
 ```
 
 ### 5. 执行脚本
 
 ```powershell
 # 按 publish 返回的 scriptId，或：
-.\scripts\dazi.ps1 onto script run --file <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间>
-.\scripts\dazi.ps1 onto script run --file <项目路径>/脚本/setup/xxx_seed_data.py --space <空间>
+dazi onto script run --file <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间>
+dazi onto script run --file <项目路径>/脚本/setup/xxx_seed_data.py --space <空间>
 ```
 
 **顺序**：先 run init，再 run seed，再发布/运行函数。
@@ -93,23 +93,23 @@ cd <工作区根>
 ### 6. 运行本体函数
 
 ```powershell
-.\scripts\dazi.ps1 onto function run <function_id> --space <空间>
+dazi onto function run <function_id> --space <空间>
 ```
 
 PowerShell 传 JSON 参数易丢引号；可省略 `--params` 使用函数默认，或：
 
 ```powershell
 $env:DAZI_PARAMS='{"start_date":"2025-01-01","end_date":"2026-12-31"}'
-.\scripts\dazi.ps1 onto function run <function_id> --space <空间> --params $env:DAZI_PARAMS
+dazi onto function run <function_id> --space <空间> --params $env:DAZI_PARAMS
 ```
 
 ## 脚本类型与路径推断
 
-| 本地路径特征 | `--type` | 平台目录 |
-|--------------|----------|----------|
-| `脚本/setup/*init*.py` | `setup` | `setup/` |
-| `脚本/setup/*seed*.py` | `data` | `data/` |
-| `脚本/functions/*.py` | （默认 ontology_function） | `ontology_functions/` |
+| 本地路径特征           | `--type`                   | 平台目录              |
+| ---------------------- | -------------------------- | --------------------- |
+| `脚本/setup/*init*.py` | `setup`                    | `setup/`              |
+| `脚本/setup/*seed*.py` | `data`                     | `data/`               |
+| `脚本/functions/*.py`  | （默认 ontology_function） | `ontology_functions/` |
 
 ## 编写脚本时注意
 
@@ -131,7 +131,7 @@ VS Code 用户也可在侧栏 **搭子 → Onto 本体** 使用「发布脚本
 
 命令失败时向用户报告：**完整 stderr**、使用的**完整命令行**、`space_id`、是否已 `auth whoami`。不要改用 `dazi-agent` 重试。
 
-## 相关同步文档（`.\scripts\dazi.ps1 docs sync` → `资源/docs/onto/`）
+## 相关同步文档（`dazi docs sync` → `资源/docs/onto/`）
 
 - `本体规划指南.md`、`本体脚本编写指南.md`
 - `dazi_script_sdk_reference.md`、`dazi_script_seed_data_guide.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dazitech/cli",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "搭子 v3 命令行工具（Onto / Flow / App），与 dazi-vscode 同版本",
   "license": "MIT",
   "engines": {