@dazitech/cli 3.0.0 → 3.0.2

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

@@ -6,8 +6,8 @@
 
 **相关文档**
 
-- [数据流程项目开发指南](./flow-project-guide.md) — 目录、`debug_run_id`、开发循环  
-- [节点代码编写指南](./node-code-guide.md) — 各节点 `code.*` 约定  
+- [数据流程项目开发指南](./flow-project-guide.md) — 目录、`debug_run_id`、开发循环
+- [节点代码编写指南](./node-code-guide.md) — 各节点 `code.*` 约定
 - [Flow 运行与测试](./run-guide.md) — `node-exec`、`variable pull/sync`
 
 ---
@@ -16,11 +16,11 @@
 
 流程引擎把 **参数、中间表、最终结果** 统一抽象为 **变量（Variable）**，在一次 Run 内按 **变量名** 读写，而不必处处依赖画布连线传递文件路径。
 
-| 概念 | 说明 |
-|------|------|
-| **变量名** | 字符串标识，如 `sales_raw`、`V1`、`销售表`；由节点配置 **`output_variable_name`** 或脚本 **`set_table_output` / `set_scalar_output`** 登记 |
-| **变量作用域** | 绑定到某次 **`flow_runs`**；日常调试对应 **`ads_flows.debug_run_id`** |
-| **登记时机** | 节点执行成功后，引擎读取 **`output_variable_name`**，将输出写入当前 Run 的 **`flow_run_variables`** |
+| 概念           | 说明                                                                                                                                       |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| **变量名**     | 字符串标识，如 `sales_raw`、`V1`、`销售表`；由节点配置 **`output_variable_name`** 或脚本 **`set_table_output` / `set_scalar_output`** 登记 |
+| **变量作用域** | 绑定到某次 **`flow_runs`**；日常调试对应 **`ads_flows.debug_run_id`**                                                                      |
+| **登记时机**   | 节点执行成功后，引擎读取 **`output_variable_name`**，将输出写入当前 Run 的 **`flow_run_variables`**                                        |
 
 **本地开发时**：变量不在 `flow.json` 里，而在调试 Run 中；CLI/扩展通过 API 拉取 schema + 预览到 **`变量/<名>.json`**。
 
@@ -28,10 +28,10 @@
 
 ## 2. 存储类型
 
-| 类型 | 典型场景 | 存储 | `get_variable` 行为 |
-|------|----------|------|---------------------|
+| 类型                | 典型场景                             | 存储                              | `get_variable` 行为                      |
+| ------------------- | ------------------------------------ | --------------------------------- | ---------------------------------------- |
 | **table（表变量）** | SQL 结果、Python `result_df`、文件源 | Parquet 落盘，库中 `value` 为路径 | 自动 `pd.read_parquet` → **`DataFrame`** |
-| **text（标量）** | 计数、标志位、质检综合分 | 库中 `value` 为字符串 | 返回 Python 原生值（str/int/float 等） |
+| **text（标量）**    | 计数、标志位、质检综合分             | 库中 `value` 为字符串             | 返回 Python 原生值（str/int/float 等）   |
 
 表变量是流程开发中最常用的类型；标量多用于质检分数、状态位等。
 
@@ -87,17 +87,17 @@ GET /flows/{id}/debug-run  →  绑定 ads_flows.debug_run_id
 cd "项目\flow_xxx\流程\MyFlow"
 
 # 先运行产出变量的上游节点，或整流程 debug
-.\scripts\dazi.ps1 flow run node-exec --node <上游uuid> --dir .
+dazi flow run node-exec --node <上游uuid> --dir .
 
 # 拉取单个变量（列信息 + 前 10 行）
-.\scripts\dazi.ps1 flow variable pull --name sales_clean --dir .
+dazi flow variable pull --name sales_clean --dir .
 
 # 同步调试 Run 中全部变量
-.\scripts\dazi.ps1 flow variable sync --dir .
+dazi flow variable sync --dir .
 ```
 
-- 设计器：选中节点 → **`output_variable_name`** 旁 **📊**  
-- 资源管理器：**`变量/<名>.json`**（只读派生，勿手改后当真理源）  
+- 设计器：选中节点 → **`output_variable_name`** 旁 **📊**
+- 资源管理器：**`变量/<名>.json`**（只读派生，勿手改后当真理源）
 - 变量尚未产出时，占位 JSON 会提示：**先运行上游节点**
 
 ---
@@ -119,12 +119,12 @@ cd "项目\flow_xxx\流程\MyFlow"
 [database-sink]    input_variable_name = py_result（或依赖入边 Parquet）
 ```
 
-| 步骤 | 节点 | 画布配置 | 代码如何读写变量 |
-|------|------|----------|------------------|
-| 1 | `excel-import` | `output_variable_name: excel_raw` | 无代码；导入后自动登记 |
-| 2 | `sql-query` | `output_variable_name: sales_agg` | SQL 中 **`FROM excel_raw`** |
-| 3 | `python-script` | `output_variable_name: py_result` | **`get_variable('sales_agg')`** → **`result_df`** |
-| 4 | `database-sink` | `input_variable_name: py_result` | 无代码；从变量或入边读表 |
+| 步骤 | 节点            | 画布配置                          | 代码如何读写变量                                  |
+| ---- | --------------- | --------------------------------- | ------------------------------------------------- |
+| 1    | `excel-import`  | `output_variable_name: excel_raw` | 无代码；导入后自动登记                            |
+| 2    | `sql-query`     | `output_variable_name: sales_agg` | SQL 中 **`FROM excel_raw`**                       |
+| 3    | `python-script` | `output_variable_name: py_result` | **`get_variable('sales_agg')`** → **`result_df`** |
+| 4    | `database-sink` | `input_variable_name: py_result`  | 无代码；从变量或入边读表                          |
 
 ---
 
@@ -185,10 +185,10 @@ LIMIT 50000
 **产生变量**：`spaceId` + `code.sql` 在空间存储引擎上查询，结果登记为 **`output_variable_name`**。  
 **不消费** Run 内变量（直连 `ads_dataspaces` + `get_storage`）。
 
-| 配置项 | 说明 |
-|--------|------|
-| `spaceId` | `ads_dataspaces.id`（`dazi-flow dataspace list`） |
-| `output_variable_name` | 产出表变量名 |
+| 配置项                 | 说明                                              |
+| ---------------------- | ------------------------------------------------- |
+| `spaceId`              | `ads_dataspaces.id`（`dazi-flow dataspace list`） |
+| `output_variable_name` | 产出表变量名                                      |
 
 ```sql
 -- output_variable_name = space_sales
@@ -204,15 +204,15 @@ LIMIT 100000
 
 **运行时注入**
 
-| 符号 | 说明 |
-|------|------|
-| `pd` | pandas |
-| `df` | 入边 Parquet（**整图跑**时常有值） |
-| `get_variable("名")` | 从当前调试 Run 按名读表/标量（**单节点测试首选**） |
-| `result_df` | 主输出表 → 对应 **`output_variable_name`** |
-| `set_table_output(name, df)` | 额外表变量 |
-| `set_scalar_output(name, value)` | 标量变量 |
-| `output.print(...)` | 运行日志（勿用裸 `print`） |
+| 符号                             | 说明                                               |
+| -------------------------------- | -------------------------------------------------- |
+| `pd`                             | pandas                                             |
+| `df`                             | 入边 Parquet（**整图跑**时常有值）                 |
+| `get_variable("名")`             | 从当前调试 Run 按名读表/标量（**单节点测试首选**） |
+| `result_df`                      | 主输出表 → 对应 **`output_variable_name`**         |
+| `set_table_output(name, df)`     | 额外表变量                                         |
+| `set_scalar_output(name, value)` | 标量变量                                           |
+| `output.print(...)`              | 运行日志（勿用裸 `print`）                         |
 
 **示例 A：单节点测试（推荐写法）**
 
@@ -324,10 +324,10 @@ output.print("[DQ] 完成")
 
 **消费变量**：画布配置 **`input_variable_name`**，从调试 Run 取表写入目标库；也可依赖入边 Parquet（未配变量名时）。
 
-| 配置项 | 说明 |
-|--------|------|
-| `connectionId` | 目标 `ads_connections` |
-| `tableName` | 目标表名 |
+| 配置项                | 说明                                             |
+| --------------------- | ------------------------------------------------ |
+| `connectionId`        | 目标 `ads_connections`                           |
+| `tableName`           | 目标表名                                         |
 | `input_variable_name` | 可选；显式指定要写入的表变量名（如 `py_result`） |
 
 ---
@@ -336,13 +336,13 @@ output.print("[DQ] 完成")
 
 **消费变量**：与 `database-sink` 相同，通过 **`input_variable_name`** 或入边 Parquet 取表。
 
-| 配置项 | 说明 |
-|--------|------|
-| `spaceId` | 目标 `ads_dataspaces.id` |
-| `tableName` | 空间内目标表（物理表名） |
-| `mode` | `append`（默认）或 `replace` |
-| `syncMetadata` | 写后是否同步元数据（默认 true） |
-| `input_variable_name` | 要写入的表变量名 |
+| 配置项                | 说明                            |
+| --------------------- | ------------------------------- |
+| `spaceId`             | 目标 `ads_dataspaces.id`        |
+| `tableName`           | 空间内目标表（物理表名）        |
+| `mode`                | `append`（默认）或 `replace`    |
+| `syncMetadata`        | 写后是否同步元数据（默认 true） |
+| `input_variable_name` | 要写入的表变量名                |
 
 ---
 
@@ -361,12 +361,12 @@ df.shape[0] > 0 and df["amount"].sum() > 10000
 
 ## 7. `df` 与 `get_variable` 怎么选
 
-| 场景 | 推荐 |
-|------|------|
-| **单节点测试**（`node-exec`） | **`get_variable('上游 output_variable_name')`** |
-| **整流程 debug/preview** | 入边 **`df`** 通常已有值；仍可用 `get_variable` 读 **未连线** 的表 |
-| **多表输入** | 一张走 `df` 或主变量，其余 **`get_variable('名')`** |
-| **写 SQL** | 直接用 **变量名作表名**，不用 `get_variable` |
+| 场景                          | 推荐                                                               |
+| ----------------------------- | ------------------------------------------------------------------ |
+| **单节点测试**（`node-exec`） | **`get_variable('上游 output_variable_name')`**                    |
+| **整流程 debug/preview**      | 入边 **`df`** 通常已有值；仍可用 `get_variable` 读 **未连线** 的表 |
+| **多表输入**                  | 一张走 `df` 或主变量，其余 **`get_variable('名')`**                |
+| **写 SQL**                    | 直接用 **变量名作表名**，不用 `get_variable`                       |
 
 **常见错误**：单节点测试时只写 `result_df = df.groupby(...)`，但 `df` 为空 → 报错或空结果。  
 **修复**：改为 `df = get_variable("上游变量名")`，或先运行上游再测。
@@ -375,10 +375,10 @@ df.shape[0] > 0 and df["amount"].sum() > 10000
 
 ## 8. 开发调试清单
 
-1. 打开设计器，确认各节点 **`output_variable_name`** 已填且 **不重名**。  
-2. **自上游向下** 单节点测试，或一次 **`flow run flow-exec --type debug`**。  
-3. 用 **📊** 或 **`flow variable pull --name <名>`** 核对列名与样例行（交给 AI 时附上 **`变量/<名>.json`**）。  
-4. 写下游代码时 **变量名与画布完全一致**（区分大小写；中文名含全角字符）。  
+1. 打开设计器，确认各节点 **`output_variable_name`** 已填且 **不重名**。
+2. **自上游向下** 单节点测试，或一次 **`flow run flow-exec --type debug`**。
+3. 用 **📊** 或 **`flow variable pull --name <名>`** 核对列名与样例行（交给 AI 时附上 **`变量/<名>.json`**）。
+4. 写下游代码时 **变量名与画布完全一致**（区分大小写；中文名含全角字符）。
 5. 改 `output_variable_name` → **`project push --canvas`**；改 `code.*` → **`node push`**。
 
 ---
@@ -387,20 +387,20 @@ df.shape[0] > 0 and df["amount"].sum() > 10000
 
 ```powershell
 # 单节点测试（会更新 debug_run_id 对应变量）
-.\scripts\dazi.ps1 flow run node-exec --node <uuid> --dir .
+dazi flow run node-exec --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 sales_agg --dir .
-.\scripts\dazi.ps1 flow variable sync --dir .
+dazi flow variable pull --name sales_agg --dir .
+dazi flow variable sync --dir .
 ```
 
 ---
 
 ## 10. 延伸阅读
 
-- 搭子功能总览：`dazi/docs/279-dazi-dataflow数据流程功能总结.md` §3  
-- devend 变量重构：`devend/docs/20251201-009-变量系统重构.md`  
+- 搭子功能总览：`dazi/docs/279-dazi-dataflow数据流程功能总结.md` §3
+- devend 变量重构：`devend/docs/20251201-009-变量系统重构.md`
 - Excel→SQL→Python 端到端案例：[流程开发最佳实践（VS-flow0 案例）](./流程开发最佳实践-VS-flow0案例.md)

package/dist/docs/flow//346/265/201/347/250/213/345/274/200/345/217/221/346/234/200/344/275/263/345/256/236/350/267/265-VS-flow0/346/241/210/344/276/213.md

@@ -121,18 +121,18 @@ bool(df is not None and not df.empty and df["通过"].all())
 
 ## 三、节点选型速查
 
-| 场景                  | 推荐节点             | 避免                              |
-| --------------------- | -------------------- | --------------------------------- |
+| 场景                    | 推荐节点             | 避免                              |
+| ----------------------- | -------------------- | --------------------------------- |
 | Excel + managed_file_id | **`excel-python`**   | **`file-source`**（不解析 xlsx）  |
-| 多 Sheet、不同 header | `excel-python`       | 多个 `excel-import` 重复配置      |
-| 极简单 Sheet、零代码   | `excel-import`       | 不必要的 Python                   |
-| 行数/非空/外键        | `data-quality-check` | 在 Python 里散落 if/raise         |
-| 通过/不通过两路       | `condition`          | 在 SQL 里写 impossible WHERE      |
-| 多表 JOIN 宽表        | `sql-query`          | 全用 pandas merge（大表时难维护） |
-| 写 ClickHouse / PG 等 | `database-sink`      | 在 Python 里手写 JDBC/HTTP        |
-| 写数据空间表          | `dataspace-sink`     | 先落外部库再回灌空间              |
-| 读外部库              | `database-source`    | 与 sql-query 混用职责             |
-| 读数据空间            | `dataspace-source`   | 误填 `connectionId`               |
+| 多 Sheet、不同 header   | `excel-python`       | 多个 `excel-import` 重复配置      |
+| 极简单 Sheet、零代码    | `excel-import`       | 不必要的 Python                   |
+| 行数/非空/外键          | `data-quality-check` | 在 Python 里散落 if/raise         |
+| 通过/不通过两路         | `condition`          | 在 SQL 里写 impossible WHERE      |
+| 多表 JOIN 宽表          | `sql-query`          | 全用 pandas merge（大表时难维护） |
+| 写 ClickHouse / PG 等   | `database-sink`      | 在 Python 里手写 JDBC/HTTP        |
+| 写数据空间表            | `dataspace-sink`     | 先落外部库再回灌空间              |
+| 读外部库                | `database-source`    | 与 sql-query 混用职责             |
+| 读数据空间              | `dataspace-source`   | 误填 `connectionId`               |
 
 ---
 
@@ -274,23 +274,23 @@ LIMIT 100000
 cd "<流程目录>"
 
 # 同步平台
-.\scripts\dazi.ps1 flow project pull --flow <flowId> --dir .
-.\scripts\dazi.ps1 flow project push --dir . --canvas
+dazi flow project pull --flow <flowId> --dir .
+dazi flow project push --dir . --canvas
 
 # 测试
-.\scripts\dazi.ps1 flow run node-exec --node <node_uuid> --dir .
-.\scripts\dazi.ps1 flow run flow-exec --dir . --type debug
+dazi flow run node-exec --node <node_uuid> --dir .
+dazi flow run flow-exec --dir . --type debug
 
 # 变量
-.\scripts\dazi.ps1 flow variable pull --name 销售明细宽表 --dir .
-.\scripts\dazi.ps1 flow variable sync --dir .
+dazi flow variable pull --name 销售明细宽表 --dir .
+dazi flow variable sync --dir .
 
 # 数据源
-.\scripts\dazi.ps1 flow source list
+dazi flow source list
 
 # 数据空间
-.\scripts\dazi.ps1 flow dataspace list
-.\scripts\dazi.ps1 flow dataspace tables <spaceId>
+dazi flow dataspace list
+dazi flow dataspace tables <spaceId>
 ```
 
 命令前缀与 Trae/VS Code 约定见 [CLI 调用约定](../guides/cli-invocation.md)。
@@ -299,18 +299,18 @@ cd "<流程目录>"
 
 ## 八、常见问题与对策
 
-| 现象                            | 原因                     | 对策                                  |
-| ------------------------------- | ------------------------ | ------------------------------------- |
-| SQL 单测找不到表                | 上游变量未写入 debug Run | 先跑 Excel 节点或整流程 debug         |
-| excel-python 单测只有主表       | 多表需整图或先跑 Excel   | 用 `flow-exec` 或按序 node-exec       |
-| Condition Error: invalid syntax | 条件脚本非单行表达式     | 改为单行 `bool(...)`                  |
-| 质检失败流程中断                | `fail_on_error: true`    | 改为 `false` + 下游 condition         |
-| 画布 push 失败                  | 未关联 flowId            | 先 `project pull --flow <id>`         |
-| sink 写库失败                   | connectionId / 表名错误  | 对照 `资源/datasources/<连接名>/*.md` |
+| 现象                            | 原因                     | 对策                                               |
+| ------------------------------- | ------------------------ | -------------------------------------------------- |
+| SQL 单测找不到表                | 上游变量未写入 debug Run | 先跑 Excel 节点或整流程 debug                      |
+| excel-python 单测只有主表       | 多表需整图或先跑 Excel   | 用 `flow-exec` 或按序 node-exec                    |
+| Condition Error: invalid syntax | 条件脚本非单行表达式     | 改为单行 `bool(...)`                               |
+| 质检失败流程中断                | `fail_on_error: true`    | 改为 `false` + 下游 condition                      |
+| 画布 push 失败                  | 未关联 flowId            | 先 `project pull --flow <id>`                      |
+| sink 写库失败                   | connectionId / 表名错误  | 对照 `资源/datasources/<连接名>/*.md`              |
 | dataspace-sink 写入失败         | spaceId / tableName 错误 | 先 `flow dataspace list` / `flow dataspace tables` |
-| 变量列为空                      | 单测时只用了 `df`        | Python 改用 `get_variable`            |
-| AI 不知道 connectionId          | 未拉取连接文档           | 侧栏数据连接 → **拉取连接信息**       |
-| AI 不知道 spaceId               | 未拉取空间文档           | 侧栏数据空间 → **拉取空间信息**       |
+| 变量列为空                      | 单测时只用了 `df`        | Python 改用 `get_variable`                         |
+| AI 不知道 connectionId          | 未拉取连接文档           | 侧栏数据连接 → **拉取连接信息**                    |
+| AI 不知道 spaceId               | 未拉取空间文档           | 侧栏数据空间 → **拉取空间信息**                    |
 
 ---
 

package/dist/docs/guides/cli-invocation.md

@@ -5,16 +5,17 @@
 
 ## 原则
 
-v3 **不会**把 `dazi` / `dazi-onto` / `dazi-app` 安装到系统 PATH。  
-终端中请使用 **`dazi-work` 包装脚本** 或 **扩展内置 bundled CLI**。
+默认交付（仅 `dazi-work` + vsix）**不**要求全局 PATH；请用 **`dazi`**。  
+开发机可选安装 **`@dazitech/cli`**（pnpm 全局）后直接使用 `dazi` / `dazi-flow`。
 
 ## 命令前缀
 
-| 场景 | 工作目录 | 命令形式 |
-|------|----------|----------|
-| 本体 / 流程 / 鉴权 / 数据 / 文档 | **`dazi-work` 根** | `.\scripts\dazi.ps1 <子命令...>` |
-| DRAP 应用 | **`dazi-work/项目/app_<名称>/`**（应用项目根） | `pnpm run dazi-app -- <子命令...>` |
-| 环境自检 | **`dazi-work` 根** | `.\scripts\doctor-cli.ps1` |
+| 场景                                     | 工作目录                                       | 命令形式                            |
+| ---------------------------------------- | ---------------------------------------------- | ----------------------------------- |
+| 本体 / 流程 / 鉴权 / 数据 / 文档（默认） | **`dazi-work` 根**                             | `dazi <子命令...>`                  |
+| 同上（已 `pnpm add -g @dazitech/cli`）   | **`dazi-work` 根**（自动识别）或任意目录       | `dazi <子命令...>`、`dazi flow ...` |
+| DRAP 应用                                | **`dazi-work/项目/app_<名称>/`**（应用项目根） | `pnpm run dazi-app -- <子命令...>`  |
+| 环境自检                                 | **`dazi-work` 根**                             | `.\scripts\doctor-cli.ps1`          |
 
 CMD 用户：`scripts\dazi.cmd`、`scripts\doctor-cli.cmd`（转发到同名 `.ps1`）。
 
@@ -31,32 +32,32 @@ cd D:\path\to\dazi-work
 .\scripts\doctor-cli.ps1
 
 # 4) 登录
-.\scripts\dazi.ps1 auth login
+dazi auth login
 # 或
-.\scripts\dazi.ps1 auth set-token --token "<jwt>"
+dazi auth set-token --token "<jwt>"
 
 # 5) 验证
-.\scripts\dazi.ps1 auth whoami
-.\scripts\dazi.ps1 onto function list --space <space-id>
+dazi auth whoami
+dazi onto function list --space <space-id>
 ```
 
 ## 文档中的写法对照
 
-内置帮助文档里的可运行示例统一采用 **`.\scripts\dazi.ps1`**，等价关系如下：
+内置帮助文档里的可运行示例统一采用 **`dazi`**，等价关系如下：
 
-| 文档示例 | 含义 |
-|----------|------|
-| `.\scripts\dazi.ps1 auth whoami` | 原 `dazi auth whoami` |
-| `.\scripts\dazi.ps1 onto script publish ...` | 原 `dazi onto script publish ...`（**勿用** `dazi-onto`） |
-| `.\scripts\dazi.ps1 flow project pull --flow 98 --dir 项目\flow_x\流程\MyFlow` | 流程项目拉取 |
-| `.\scripts\dazi.ps1 flow run node-exec --node <uuid> --dir <流程目录>` | 单节点测试 |
-| `pnpm run dazi-app -- upload ...` | 原 `dazi-app upload ...`（须在**应用项目根**，含 `sdk/`、`templates/`） |
+| 文档示例                                                         | 含义                                                                    |
+| ---------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| `dazi auth whoami`                                               | 原 `dazi auth whoami`                                                   |
+| `dazi onto script publish ...`                                   | 原 `dazi onto script publish ...`（**勿用** `dazi-onto`）               |
+| `dazi flow project pull --flow 98 --dir 项目\flow_x\流程\MyFlow` | 流程项目拉取                                                            |
+| `dazi flow run node-exec --node <uuid> --dir <流程目录>`         | 单节点测试                                                              |
+| `pnpm run dazi-app -- upload ...`                                | 原 `dazi-app upload ...`（须在**应用项目根**，含 `sdk/`、`templates/`） |
 
 扩展侧栏、命令面板触发的操作与上述 CLI **同源**（bundled `clis/*.js`）。
 
 ### 流程子命令（`flow` → `dazi-flow`）
 
-`.\scripts\dazi.ps1 flow …` **不会**执行独立的 `dazi-flow.exe`，而是：
+`dazi flow …` **不会**执行独立的 `dazi-flow.exe`，而是：
 
 1. `dazi.ps1` 设置 `DAZI_BUNDLED_DIR`，在 **dazi-work 根**执行 `node bundled/clis/dazi.js`
 2. `dazi.js` 将 `flow` 后所有参数 **转发**给 `node bundled/clis/dazi-flow.js`
@@ -64,7 +65,7 @@ cd D:\path\to\dazi-work
 因此文档里的 `dazi-flow project pull …` 在 Trae / VS Code 交付环境中应写为：
 
 ```powershell
-.\scripts\dazi.ps1 flow project pull --flow 98 --dir "项目\flow_xxx\流程\MyFlow"
+dazi flow project pull --flow 98 --dir "项目\flow_xxx\流程\MyFlow"
 ```
 
 流程项目开发详见 [flow/flow-project-guide](../flow/flow-project-guide.md)。
@@ -73,18 +74,18 @@ cd D:\path\to\dazi-work
 
 1. 环境变量 `DAZI_BUNDLED_DIR`
 2. `dazi-work/tools/dazi-clis/`（可选离线包）
-3. 已安装扩展（路径因 IDE 而异）  
-   - Trae：`%USERPROFILE%\.trae\extensions\dazitech.dazi-vscode-*\bundled\clis`  
-   - Cursor / VS Code：`.cursor\extensions` 或 `.vscode\extensions`  
+3. 已安装扩展（路径因 IDE 而异）
+   - Trae：`%USERPROFILE%\.trae\extensions\dazitech.dazi-vscode-*\bundled\clis`
+   - Cursor / VS Code：`.cursor\extensions` 或 `.vscode\extensions`
    - 也可：`%VSCODE_EXTENSIONS%`、`dazi-work\tools\dazi-clis`（`sync-clis-from-extension.ps1`）
 
 ## 常见错误
 
-| 现象 | 原因 | 处理 |
-|------|------|------|
-| `dazi-onto` 找不到 | v3 无此全局命令 | 改用 `.\scripts\dazi.ps1 onto ...` |
-| `dazi` 找不到 | 未装 vsix / 未用包装脚本 | `doctor-cli.ps1` → 安装 vsix |
-| `dazi-app` 找不到 | 未在应用项目根或未 pnpm install | `cd 项目/app_<名> && pnpm install` |
+| 现象               | 原因                                      | 处理                                            |
+| ------------------ | ----------------------------------------- | ----------------------------------------------- |
+| `dazi-onto` 找不到 | v3 无此全局命令                           | 改用 `dazi onto ...`                            |
+| `dazi` 找不到      | 未装 vsix / 未用包装脚本 / 未全局安装 CLI | `doctor-cli.ps1` 或 `pnpm add -g @dazitech/cli` |
+| `dazi-app` 找不到  | 未在应用项目根或未 pnpm install           | `cd 项目/app_<名> && pnpm install`              |
 
 ## 相关文档
 

package/dist/docs/guides/cli-reference.md

@@ -3,84 +3,85 @@
 **文档 ID**: `guides/cli-reference`
 
 > **生产环境**：在 `dazi-work` 根目录，所有 `dazi` / `dazi onto` / `dazi flow` 命令写作  
-> **`.\scripts\dazi.ps1 <子命令>`**；DRAP 在**应用项目根**（`项目/app_<名称>/`，含 `sdk/`）用 **`pnpm run dazi-app -- <子命令>`**。  
+> **`dazi <子命令>`**；DRAP 在**应用项目根**（`项目/app_<名称>/`，含 `sdk/`）用 **`pnpm run dazi-app -- <子命令>`**。  
 > 详见 [CLI 调用约定](./cli-invocation.md)。首次安装后运行 **`.\scripts\doctor-cli.ps1`**。
 
-## 主 CLI（`.\scripts\dazi.ps1`）
-
-| 命令                                    | 说明                                    |
-| --------------------------------------- | --------------------------------------- |
-| `.\scripts\dazi.ps1 auth login`         | 用户名密码登录                          |
-| `.\scripts\dazi.ps1 auth set-token`     | 绑定 JWT Token                          |
-| `.\scripts\dazi.ps1 auth whoami`        | 显示当前账号                            |
-| `.\scripts\dazi.ps1 auth migrate`       | 迁移旧版认证                            |
-| `.\scripts\dazi.ps1 doctor`             | 环境诊断                                |
-| `.\scripts\dazi.ps1 env`                | 显示环境信息                            |
-| `.\scripts\dazi.ps1 docs list`          | 列出文档                                |
-| `.\scripts\dazi.ps1 docs open <id>`     | 打开文档                                |
-| `.\scripts\dazi.ps1 docs sync`          | 同步内置文档到 `资源/docs/`             |
-| `.\scripts\dazi.ps1 prompt list`        | 列出提示词                              |
-| `.\scripts\dazi.ps1 prompt show <id>`   | 显示提示词                              |
-| `.\scripts\dazi.ps1 prompt sync`        | 同步内置提示词到 `资源/prompts/`        |
-| `.\scripts\dazi.ps1 examples list`      | 列出示例脚本                            |
-| `.\scripts\dazi.ps1 examples open <id>` | 显示示例内容                            |
-| `.\scripts\dazi.ps1 examples sync`      | 同步内置示例到 `资源/examples/`         |
-| `.\scripts\dazi.ps1 migrate workspace`  | 迁移工作区                              |
-| `.\scripts\dazi.ps1 migrate config`     | 迁移旧配置                              |
-| `.\scripts\dazi.ps1 onto <args>`        | 本体 CLI（**勿用** `dazi-onto`）        |
-| `.\scripts\dazi.ps1 flow <args>`        | 流程 CLI                                |
-| `.\scripts\dazi.ps1 app <args>`         | 应用 CLI（亦可在应用项目根用 `pnpm run dazi-app`） |
-
-## 本体（`.\scripts\dazi.ps1 onto ...`）
-
-| 命令                                                                     | 说明             |
-| ------------------------------------------------------------------------ | ---------------- |
-| `.\scripts\dazi.ps1 onto space list`                                     | 空间列表         |
-| `.\scripts\dazi.ps1 onto space snapshot`                                 | 拉取空间快照     |
-| `.\scripts\dazi.ps1 onto space init`                                     | 初始化空间工作区 |
-| `.\scripts\dazi.ps1 onto function list`                                  | 函数定义列表     |
-| `.\scripts\dazi.ps1 onto function run`                                   | 执行函数         |
-| `.\scripts\dazi.ps1 onto function publish`                               | 发布函数         |
-| `.\scripts\dazi.ps1 onto function update-code`                           | 更新函数代码     |
-| `.\scripts\dazi.ps1 onto action list/update-code/delete`                 | 动作管理         |
-| `.\scripts\dazi.ps1 onto rule list/run-seed/delete`                      | 规则管理         |
-| `.\scripts\dazi.ps1 onto script sync/publish/publish-preview/run/dedupe` | 脚本管理         |
-| `.\scripts\dazi.ps1 onto mcp serve`                                      | 启动本体 MCP     |
-
-## 流程（`.\scripts\dazi.ps1 flow ...`）
-
-> **流程项目日常开发**见 [flow/flow-project-guide](../flow/flow-project-guide.md)。  
-> 下列 `flow` 子命令均写作 `.\scripts\dazi.ps1 flow <...>`。
+## 主 CLI（`dazi`）
+
+| 命令                      | 说明                                               |
+| ------------------------- | -------------------------------------------------- |
+| `dazi auth login`         | 用户名密码登录                                     |
+| `dazi auth set-token`     | 绑定 JWT Token                                     |
+| `dazi auth whoami`        | 显示当前账号                                       |
+| `dazi auth migrate`       | 迁移旧版认证                                       |
+| `dazi doctor`             | 环境诊断                                           |
+| `dazi env`                | 显示环境信息                                       |
+| `dazi docs list`          | 列出文档                                           |
+| `dazi docs open <id>`     | 打开文档                                           |
+| `dazi docs sync`          | 同步内置文档到 `资源/docs/`                        |
+| `dazi prompt list`        | 列出提示词                                         |
+| `dazi prompt show <id>`   | 显示提示词                                         |
+| `dazi prompt sync`        | 同步内置提示词到 `资源/prompts/`                   |
+| `dazi examples list`      | 列出示例脚本                                       |
+| `dazi examples open <id>` | 显示示例内容                                       |
+| `dazi examples sync`      | 同步内置示例到 `资源/examples/`                    |
+| `dazi migrate workspace`  | 迁移工作区                                         |
+| `dazi migrate config`     | 迁移旧配置                                         |
+| `dazi onto <args>`        | 本体 CLI（**勿用** `dazi-onto`）                   |
+| `dazi flow <args>`        | 流程 CLI                                           |
+| `dazi app <args>`         | 应用 CLI（亦可在应用项目根用 `pnpm run dazi-app`） |
+
+## 本体（`dazi onto ...`）
+
+| 命令                                                       | 说明             |
+| ---------------------------------------------------------- | ---------------- |
+| `dazi onto space list`                                     | 空间列表         |
+| `dazi onto space snapshot`                                 | 拉取空间快照     |
+| `dazi onto space init`                                     | 初始化空间工作区 |
+| `dazi onto function list`                                  | 函数定义列表     |
+| `dazi onto function run`                                   | 执行函数         |
+| `dazi onto function publish`                               | 发布函数         |
+| `dazi onto function update-code`                           | 更新函数代码     |
+| `dazi onto action list/update-code/delete`                 | 动作管理         |
+| `dazi onto rule list/run-seed/delete`                      | 规则管理         |
+| `dazi onto script sync/publish/publish-preview/run/dedupe` | 脚本管理         |
+| `dazi onto mcp serve`                                      | 启动本体 MCP     |
+
+## 流程（`dazi flow ...`）
+
+> **流程项目日常开发**见 [flow/flow-project-guide](../flow/flow-project-guide.md)。
 
 ### 流程项目（`项目/flow_*/流程/<名>/`）
 
-| 命令 | 说明 |
-|------|------|
-| `flow project pull --flow <id> --dir <流程目录>` | 拉取 snapshot 并拆分为 flow.json + 节点代码 |
-| `flow project push --dir <dir> [--canvas]` | 提交脏代码节点；`--canvas` 含画布 |
-| `flow project status --dir <dir>` | 本地代码改动 |
-| `flow node push --node <uuid> --dir <dir>` | 提交单节点代码 |
-| `flow node pull --node <uuid> --dir <dir>` | 拉取单节点代码 |
-| `flow run node-exec --node <uuid> --dir <dir>` | 单节点测试 |
-| `flow run flow-exec --dir <dir> --type debug` | 整流程运行 |
-| `flow variable pull --name <名> --dir <dir>` | 拉取变量到 `变量/<名>.json` |
-| `flow variable sync --dir <dir>` | 同步全部调试变量 |
+| 命令                                                  | 说明                                        |
+| ----------------------------------------------------- | ------------------------------------------- |
+| `dazi flow project pull --flow <id> --dir <流程目录>` | 拉取 snapshot 并拆分为 flow.json + 节点代码 |
+| `dazi flow project push --dir <dir> [--canvas]`       | 提交脏代码节点；**配置变更必须** `--canvas`   |
+| `dazi flow project doctor --dir <dir>`                | 检查 flow.json / meta / 节点/ 一致性        |
+| `dazi flow project repair-meta --dir <dir>`           | 修复 flow.meta.json 索引                    |
+| `dazi flow project status --dir <dir>`                | 本地代码改动                                |
+| `dazi flow node push --node <uuid> --dir <dir>`       | 提交单节点代码                              |
+| `dazi flow node pull --node <uuid> --dir <dir>`       | 拉取单节点代码                              |
+| `dazi flow run node-exec --node <uuid> --dir <dir>`   | 单节点测试                                  |
+| `dazi flow run flow-exec --dir <dir> --type debug`    | 整流程运行                                  |
+| `dazi flow variable pull --name <名> --dir <dir>`     | 拉取变量到 `变量/<名>.json`                 |
+| `dazi flow variable sync --dir <dir>`                 | 同步全部调试变量                            |
 
 ### 平台级 / 旧式
 
-| 命令 | 说明 |
-|------|------|
-| `flow flows list` | Flow 列表 |
-| `flow flows get <id>` | Flow 详情 |
-| `flow flows create` | 新建 Flow |
-| `flow snapshot pull --flow <id>` | 拉取快照到 `flows/<id>/` |
-| `flow snapshot push-graph` | 推送图快照 |
-| `flow run start <id>` / `run debug <id>` | 启动 / 调试 Run |
-| `flow run variables-list` | 查看变量 |
-| `flow source list/tables/table-structure` | 数据源 |
-| `flow plan compile/apply/markdown` | 执行计划 |
-| `flow file list/upload/pull` | 文件管理 |
-| `flow mcp serve` | Flow MCP |
+| 命令                                           | 说明                     |
+| ---------------------------------------------- | ------------------------ |
+| `dazi flow flows list`                         | Flow 列表                |
+| `dazi flow flows get <id>`                     | Flow 详情                |
+| `dazi flow flows create`                       | 新建 Flow                |
+| `dazi flow snapshot pull --flow <id>`          | 拉取快照到 `flows/<id>/` |
+| `dazi flow snapshot push-graph`                | 推送图快照               |
+| `dazi flow run start <id>` / `run debug <id>`  | 启动 / 调试 Run          |
+| `dazi flow run variables-list`                 | 查看变量                 |
+| `dazi flow source list/tables/table-structure` | 数据源                   |
+| `dazi flow plan compile/apply/markdown`        | 执行计划                 |
+| `dazi flow file list/upload/pull`              | 文件管理                 |
+| `dazi flow mcp serve`                          | Flow MCP                 |
 
 ## 应用（`项目/app_<名称>/` 应用项目根）
 
@@ -95,4 +96,4 @@
 | `pnpm run dazi-app -- asset list`                                    | drap-assets 列表 |
 | `pnpm run dazi-app -- manifest validate --cwd apps/<app> --scan-src` | 校验 manifest    |
 
-等价写法（仍在 `dazi-work` 根）：`.\scripts\dazi.ps1 app <子命令>`。
+等价写法（仍在 `dazi-work` 根）：`dazi app <子命令>`。