@dazitech/cli 3.0.0 → 3.0.2

package/dist/docs/onto/rule-guide.md

@@ -5,6 +5,7 @@
 ## 规则概念
 
 规则（Rule）存储在 `ads_ontology_rules` 表，通过种子脚本写入，通常用于：
+
 - 数据校验规则
 - 业务约束条件
 - 权限规则集
@@ -12,16 +13,16 @@
 ## 列出规则
 
 ```bash
-.\scripts\dazi.ps1 onto rule list --space <space-id>
+dazi onto rule list --space <space-id>
 
 # 按规则集过滤
-.\scripts\dazi.ps1 onto rule list --space <space-id> --rule-set finance_rules
+dazi onto rule list --space <space-id> --rule-set finance_rules
 ```
 
 ## 执行规则种子
 
 ```bash
-.\scripts\dazi.ps1 onto rule run-seed --space <space-id> --stem cw_001_rules_seed
+dazi onto rule run-seed --space <space-id> --stem cw_001_rules_seed
 ```
 
 ## 种子脚本示例
@@ -44,9 +45,9 @@ def main(params: dict, s) -> dict:
 
 ```bash
 # 删除单条
-.\scripts\dazi.ps1 onto rule delete fin_001 --space <space-id>
+dazi onto rule delete fin_001 --space <space-id>
 
 # 按规则集批量删除（先 dry-run）
-.\scripts\dazi.ps1 onto rule delete-all --space <space-id> --rule-set old_rules --dry-run
-.\scripts\dazi.ps1 onto rule delete-all --space <space-id> --rule-set old_rules --yes
+dazi onto rule delete-all --space <space-id> --rule-set old_rules --dry-run
+dazi onto rule delete-all --space <space-id> --rule-set old_rules --yes
 ```

package/dist/docs/onto/space-management.md

@@ -5,6 +5,7 @@
 ## 空间概念
 
 本体空间（Space）是搭子平台的基础组织单位，每个空间包含：
+
 - 函数定义（FunctionDef）
 - 动作定义（ActionDef）
 - 规则（Rule）
@@ -13,16 +14,17 @@
 ## 列出空间
 
 ```bash
-.\scripts\dazi.ps1 onto space list
+dazi onto space list
 ```
 
 ## 初始化本地工作区
 
 ```bash
-.\scripts\dazi.ps1 onto space init --space-id <space-id>
+dazi onto space init --space-id <space-id>
 ```
 
 本地目录结构：
+
 ```
 onto/<space-id>/
   editorial/
@@ -40,7 +42,7 @@ onto/<space-id>/
 将远端本体数据同步到本地：
 
 ```bash
-.\scripts\dazi.ps1 onto space snapshot --space-id <space-id>
+dazi onto space snapshot --space-id <space-id>
 ```
 
 快照保存到 `onto/<space-id>/snapshot.json`。

package/dist/docs/onto//346/234/254/344/275/223/350/204/232/346/234/254/347/274/226/345/206/231/346/214/207/345/215/227.md

@@ -4,14 +4,14 @@
 
 本文说明本体项目内 **Python 脚本的目录、类型、发布与运行**（原独立的「脚本开发与发布」已与本文合并）。
 
-> 终端命令均在 **`dazi-work` 根目录**执行：`.\scripts\dazi.ps1 ...`（见 [CLI 调用约定](../guides/cli-invocation.md)）。
+> 终端命令均在 **`dazi-work` 根目录**执行：`dazi ...`（见 [CLI 调用约定](../guides/cli-invocation.md)）。
 
 ## 环境
 
 - 推荐 **Python 3.10+**
 - 脚本目录：**`<工作区根>/项目/onto_<项目名>/脚本/`**（新建本体项目时自动创建）
 - 扩展默认脚本语言：`dazi.onto.defaultScriptLang` = `python`
-- 平台 API：`dazi.serverUrl`；登录：`.\scripts\dazi.ps1 auth login` / `.\scripts\dazi.ps1 auth set-token`
+- 平台 API：`dazi.serverUrl`；登录：`dazi auth login` / `dazi auth set-token`
 
 ## 目录约定
 
@@ -25,7 +25,7 @@
     └── ...
 ```
 
-参考示例（可复制后修改）位于 **`资源/examples/onto/`**（侧栏 **帮助 → 示例** 或 `.\scripts\dazi.ps1 examples sync`）。
+参考示例（可复制后修改）位于 **`资源/examples/onto/`**（侧栏 **帮助 → 示例** 或 `dazi examples sync`）。
 
 > **不再使用** 历史路径 `onto/<space_id>/editorial/`、`editorial/functions/` 等作为本地开发约定。
 
@@ -33,67 +33,67 @@
 
 编写 `脚本/` 下 `.py` 前请阅读：
 
-| 文档 | 说明 |
-|------|------|
-| **[DaziScript SDK 参考](./dazi_script_sdk_reference.md)** | `space` / `s.sql` / `s.onto` / `s.tables` / Cube 等 API 与本体落库顺序 |
-| **[DaziScript 灌数脚本编写指南](./dazi_script_seed_data_guide.md)** | 造数、补数、`insert_rows` 与 ClickHouse `INSERT` 约束、幂等约定 |
+| 文档                                                                | 说明                                                                   |
+| ------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| **[DaziScript SDK 参考](./dazi_script_sdk_reference.md)**           | `space` / `s.sql` / `s.onto` / `s.tables` / Cube 等 API 与本体落库顺序 |
+| **[DaziScript 灌数脚本编写指南](./dazi_script_seed_data_guide.md)** | 造数、补数、`insert_rows` 与 ClickHouse `INSERT` 约束、幂等约定        |
 
-同步到工作区：`.\scripts\dazi.ps1 docs sync` → `资源/docs/onto/`。
+同步到工作区：`dazi docs sync` → `资源/docs/onto/`。
 
 ## 脚本类型
 
 类型由 **发布命令参数** 区分；文件可平铺在 `脚本/`，也可分子目录（如 `脚本/functions/`、`脚本/actions/`）：
 
-| 类型 | 路径约定 | 说明 |
-|------|---------|------|
+| 类型                | 路径约定                          | 说明                                               |
+| ------------------- | --------------------------------- | -------------------------------------------------- |
 | `ontology_function` | `项目/onto_<项目名>/脚本/**/*.py` | **必须**带 `--register-function-id` 发布（见下节） |
-| `ontology_action` | `项目/onto_<项目名>/脚本/**/*.py` | 发布时加 `--register-action-id` 等 Action 参数 |
-| `data_script` | `项目/onto_<项目名>/脚本/**/*.py` | 普通 `script publish`，不注册函数/动作 |
+| `ontology_action`   | `项目/onto_<项目名>/脚本/**/*.py` | 发布时加 `--register-action-id` 等 Action 参数     |
+| `data_script`       | `项目/onto_<项目名>/脚本/**/*.py` | 普通 `script publish`，不注册函数/动作             |
 
 `<space-id>` 从 **`项目/onto_<项目名>/README.md`** 读取，勿手写错空间。
 
 ## 发布预检
 
 ```powershell
-.\scripts\dazi.ps1 onto script publish-preview 项目/onto_<项目名>/脚本/my_func.py --space <space-id>
+dazi onto script publish-preview 项目/onto_<项目名>/脚本/my_func.py --space <space-id>
 ```
 
 ## 发布脚本
 
-> **勿用** 独立命令 `dazi-onto`（v3 未安装到 PATH）。统一使用 **`.\scripts\dazi.ps1 onto ...`**。
+> **勿用** 独立命令 `dazi-onto`（v3 未安装到 PATH）。统一使用 **`dazi onto ...`**。
 
 ### 本体函数：**必须注册**，否则侧栏与测试看不到
 
 `脚本/functions/`（或规划中的本体函数 `.py`）**不能**只执行「普通 publish」：
 
-| 仅 `script publish`（无 `--register-function-id`） | 带 `--register-function-id` 发布 |
-|--------------------------------------------------|----------------------------------|
-| 脚本代码进入 `ads_scripts` | 同上 **且** 写入 `ontology_function_defs` |
-| **不会**出现在 **Onto → 函数列表** | 出现在函数列表，可 **运行函数** / 工作台测试 |
-| `.\scripts\dazi.ps1 onto function run <id>` **找不到** | `function run`、侧栏运行可用 |
+| 仅 `script publish`（无 `--register-function-id`） | 带 `--register-function-id` 发布             |
+| -------------------------------------------------- | -------------------------------------------- |
+| 脚本代码进入 `ads_scripts`                         | 同上 **且** 写入 `ontology_function_defs`    |
+| **不会**出现在 **Onto → 函数列表**                 | 出现在函数列表，可 **运行函数** / 工作台测试 |
+| `dazi onto function run <id>` **找不到**           | `function run`、侧栏运行可用                 |
 
 因此：**首次发布本体函数时，命令里必须包含 `--register-function-id`**，且 `function_id` 与规划文档、脚本内约定 **完全一致**（建议带点号命名空间，如 `sales.fn.get_summary`，勿随意简写为 `get_summary`）。
 
 智能体（TRAE 等）实施自检：
 
-1. 发布命令是否包含 `--register-function-id`？  
-2. 发布输出是否含 `functionId: xxx` / `function_registration.ok`？  
-3. `.\scripts\dazi.ps1 onto function list --space <space-id>` 能否看到该 `function_id`？  
+1. 发布命令是否包含 `--register-function-id`？
+2. 发布输出是否含 `functionId: xxx` / `function_registration.ok`？
+3. `dazi onto function list --space <space-id>` 能否看到该 `function_id`？
 
 任一步不满足 → **视为未注册**，需重新 publish（带注册参数），不要仅 `script run` 以为函数已可用。
 
 ```powershell
 # 初始化 / 灌数：普通发布即可（不要加 register-function-id）
-.\scripts\dazi.ps1 onto script publish 项目/onto_<项目名>/脚本/setup/xxx_ontology_init.py --space <space-id> --type setup
-.\scripts\dazi.ps1 onto script publish 项目/onto_<项目名>/脚本/setup/xxx_seed_data.py --space <space-id> --type data
+dazi onto script publish 项目/onto_<项目名>/脚本/setup/xxx_ontology_init.py --space <space-id> --type setup
+dazi onto script publish 项目/onto_<项目名>/脚本/setup/xxx_seed_data.py --space <space-id> --type data
 
 # ★ 本体函数：必须注册（示例）
-.\scripts\dazi.ps1 onto script publish 项目/onto_<项目名>/脚本/functions/get_summary.py `
+dazi onto script publish 项目/onto_<项目名>/脚本/functions/get_summary.py `
   --space <space-id> `
   --register-function-id sales.fn.get_summary
 
 # 发布并注册为本体动作（示例）
-.\scripts\dazi.ps1 onto script publish 项目/onto_<项目名>/脚本/my_action.py `
+dazi onto script publish 项目/onto_<项目名>/脚本/my_action.py `
   --space <space-id> `
   --register-action-id my_action_code `
   --register-action-permission-tag "finance.write"
@@ -102,22 +102,22 @@
 发布后验证：
 
 ```powershell
-.\scripts\dazi.ps1 onto function list --space <space-id>
-.\scripts\dazi.ps1 onto function run sales.fn.get_summary --space <space-id>
+dazi onto function list --space <space-id>
+dazi onto function run sales.fn.get_summary --space <space-id>
 ```
 
 亦可在 VS Code 侧栏 **Onto 本体 → 发布函数** 发布（须填写/绑定 **function_id**）；发布后在 **函数** 节点下应能看到该函数。
 
-函数生命周期与 `update-code` 详见 **[本体函数开发指南](./function-guide.md)**。给 TRAE 的完整命令模板见内置提示词 **`onto/script-publish-run`**（`.\scripts\dazi.ps1 prompt sync` 后位于 `资源/prompts/onto/`）。
+函数生命周期与 `update-code` 详见 **[本体函数开发指南](./function-guide.md)**。给 TRAE 的完整命令模板见内置提示词 **`onto/script-publish-run`**（`dazi prompt sync` 后位于 `资源/prompts/onto/`）。
 
 ## 从平台拉取脚本（可选）
 
 若需将平台上已有脚本拉回本地对照（**非**日常开发主路径）：
 
 ```powershell
-.\scripts\dazi.ps1 onto script sync --space <space-id>
-.\scripts\dazi.ps1 onto script sync --space <space-id> --type ontology_function
-.\scripts\dazi.ps1 onto script sync --space <space-id> --dry-run
+dazi onto script sync --space <space-id>
+dazi onto script sync --space <space-id> --type ontology_function
+dazi onto script sync --space <space-id> --dry-run
 ```
 
 拉取目标目录以 CLI 为准；**新建与修改仍以 `项目/onto_<项目名>/脚本/` 为准**。
@@ -125,15 +125,15 @@
 ## 清理重复脚本
 
 ```powershell
-.\scripts\dazi.ps1 onto script dedupe --space <space-id> --dry-run
-.\scripts\dazi.ps1 onto script dedupe --space <space-id> --yes
+dazi onto script dedupe --space <space-id> --dry-run
+dazi onto script dedupe --space <space-id> --yes
 ```
 
 ## 编写建议
 
 1. 先阅读 `快速启动.md` 与 `README.md` 中的**数据空间 ID**
 2. 在 `脚本/` 中按模块拆分 `.py`（初始化、灌数、本体函数可分机文件）
-3. 发布与运行：`.\scripts\dazi.ps1 onto script publish`（**函数必须** `--register-function-id`）/ 侧栏 **Onto 本体**；函数运行见 **[function-guide](./function-guide.md)**、**[action-guide](./action-guide.md)**
+3. 发布与运行：`dazi onto script publish`（**函数必须** `--register-function-id`）/ 侧栏 **Onto 本体**；函数运行见 **[function-guide](./function-guide.md)**、**[action-guide](./action-guide.md)**
 4. 本地仅调试 Python 语法时可用 VS Code 运行 `脚本/main.py`（**不会**自动连平台；连平台须发布后在侧栏或 CLI 执行）
 
 ## 相关文档

package/dist/docs/onto//346/234/254/344/275/223/350/247/204/345/210/222/346/214/207/345/215/227.md

@@ -25,12 +25,12 @@
 - 接受 **多对一**：多表、多 Cube 可收敛为一种业务对象；一宽表也可拆成多种业务对象。
 - **链接**两端必须是对象类型 **`code`**，不是 Cube 名；表中仅有 `xxx_id` 时，规划文中仍应写清本体链接语义。
 
-**与业界对象中心实践的对照**：上述分层与「对象优先、数据为 backing」的思路，可与 **Palantir Foundry Ontology**（对象类型、链接、Action、Function 分层）等成熟产品对照阅读；落地脚本时以平台当前 API 与 **`.\scripts\dazi.ps1 onto`** 能力为准，**不**假设已实现对方全部特性。
+**与业界对象中心实践的对照**：上述分层与「对象优先、数据为 backing」的思路，可与 **Palantir Foundry Ontology**（对象类型、链接、Action、Function 分层）等成熟产品对照阅读；落地脚本时以平台当前 API 与 **`dazi onto`** 能力为准，**不**假设已实现对方全部特性。
 
 ## 必读文档
 
 1. **本体规划示例**：`规划示例_利润分析本体方案.md`（扩展内置于 `docs/onto/`；同步到工作区后为 `资源/docs/onto/规划示例_利润分析本体方案.md`）
-2. **工作区与 CLI**：`guides/workspace-v3.md`、`guides/cli-reference.md`（`.\scripts\dazi.ps1 docs sync` 后位于 `资源/docs/guides/`）
+2. **工作区与 CLI**：`guides/workspace-v3.md`、`guides/cli-reference.md`（`dazi docs sync` 后位于 `资源/docs/guides/`）
 
 ## 产出约定
 
@@ -44,12 +44,12 @@
 
 ## LLM 执行指引（必须遵循）
 
-面向 **dazi-vscode v3**：终端用 **`.\scripts\dazi.ps1`**（本体/流程/数据/鉴权），DRAP 在 **`项目/app_<名称>/` 应用项目根** 用 **`pnpm run dazi-app --`**；**禁止**全局 `dazi-onto` / 已废弃的 `dazi-agent`。
+面向 **dazi-vscode v3**：终端用 **`dazi`**（本体/流程/数据/鉴权），DRAP 在 **`项目/app_<名称>/` 应用项目根** 用 **`pnpm run dazi-app --`**；**禁止**全局 `dazi-onto` / 已废弃的 `dazi-agent`。
 
 ### 工作区与项目
 
 - **工作区根**：VS Code 已打开的文件夹；多根工作区时在设置 **`dazi.workspaceRoot`** 指定。
-- **平台与登录**：`dazi.serverUrl`；`.\scripts\dazi.ps1 auth login` 或 `.\scripts\dazi.ps1 auth set-token`（Token 存 `.dazi/auth.json`）。
+- **平台与登录**：`dazi.serverUrl`；`dazi auth login` 或 `dazi auth set-token`（Token 存 `.dazi/auth.json`）。
 - **本体项目即工作单元**（扩展「新建项目」时已选定数据空间，**无需**再建 `onto/<space_id>/` 等平行目录）：
 
 ```text
@@ -58,7 +58,7 @@
     README.md       ← 数据空间 ID、项目元信息（规划/实施均以此为准）
     规划/           ← 规划阶段 Markdown 产出
     脚本/           ← 本体 Python 脚本
-  资源/docs/onto/   ← 本体指南与规划示例（.\scripts\dazi.ps1 docs sync）
+  资源/docs/onto/   ← 本体指南与规划示例（dazi docs sync）
   资源/dataspaces/  ← 侧栏下载的表结构 Markdown
 ```
 
@@ -72,26 +72,26 @@
 在 **工作区根目录** 打开终端执行：
 
 ```bash
-.\scripts\dazi.ps1 doctor
-.\scripts\dazi.ps1 auth whoami
-.\scripts\dazi.ps1 docs sync    # 可选：同步帮助文档到 资源/docs/
+dazi doctor
+dazi auth whoami
+dazi docs sync    # 可选：同步帮助文档到 资源/docs/
 ```
 
 **核对数据空间与现网资产**（`<space_id>` 取自当前项目的 `README.md`，勿另猜目录）：
 
 ```bash
-.\scripts\dazi.ps1 onto space list
-.\scripts\dazi.ps1 onto space get <space_id>    # 可选：查看空间详情
+dazi onto space list
+dazi onto space get <space_id>    # 可选：查看空间详情
 ```
 
 **扩展侧栏（规划阶段主要入口）**：
 
-| 目的           | 操作 |
-| -------------- | ---- |
-| 确认绑定空间   | 打开 **`项目/onto_<名称>/README.md`** 中的数据空间 ID |
-| 查看表 / Cube  | **数据资源** → 对应数据空间 → 展开表、Cube |
-| 下载表结构     | 表节点右键「下载表信息」→ `资源/dataspaces/` |
-| 同步帮助文档   | **帮助** → 下载文档（`.\scripts\dazi.ps1 docs sync`） |
+| 目的          | 操作                                                  |
+| ------------- | ----------------------------------------------------- |
+| 确认绑定空间  | 打开 **`项目/onto_<名称>/README.md`** 中的数据空间 ID |
+| 查看表 / Cube | **数据资源** → 对应数据空间 → 展开表、Cube            |
+| 下载表结构    | 表节点右键「下载表信息」→ `资源/dataspaces/`          |
+| 同步帮助文档  | **帮助** → 下载文档（`dazi docs sync`）               |
 
 > 规划阶段**不**要求本地 `snapshot.json`、`editorial/` 或 `onto/<space_id>/` 目录；以侧栏 **数据资源** 与项目内文档为准即可。
 
@@ -102,21 +102,21 @@
 脚本写在 **`项目/<onto_项目>/脚本/`**（Python，见 `dazi.onto.defaultScriptLang`）。发布与运行见 **`本体脚本编写指南.md`**、**`function-guide.md`**：
 
 ```bash
-.\scripts\dazi.ps1 onto script publish-preview 项目/onto_<名称>/脚本/my_func.py --space <space_id>
-.\scripts\dazi.ps1 onto script publish 项目/onto_<名称>/脚本/my_func.py \
+dazi onto script publish-preview 项目/onto_<名称>/脚本/my_func.py --space <space_id>
+dazi onto script publish 项目/onto_<名称>/脚本/my_func.py \
   --space <space_id> \
   --register-function-id <function_id>
-.\scripts\dazi.ps1 onto function run <function_id> --space <space_id> --params '{}'
+dazi onto function run <function_id> --space <space_id> --params '{}'
 ```
 
 亦可在侧栏 **Onto 本体** 使用「发布函数」「运行函数」等命令（与终端 CLI **同源** bundled；`--space` 与项目 README 中的 `space_id` 一致）。
 
-实施前可用 `.\scripts\dazi.ps1 onto function list --space <space_id>` 核对平台已有函数定义，**开发入口始终是 `项目/<onto_项目>/脚本/`**，不以历史 `onto/`、`editorial` 目录为约定路径。
+实施前可用 `dazi onto function list --space <space_id>` 核对平台已有函数定义，**开发入口始终是 `项目/<onto_项目>/脚本/`**，不以历史 `onto/`、`editorial` 目录为约定路径。
 
 ### 失败处理
 
 - 命令失败时输出 **完整错误** 与修复建议（登录、`dazi.serverUrl`、工作区路径、`space_id`），**不得** 静默跳过。
-- v2 → v3 命令对照见 `guides/troubleshooting.md`（`.\scripts\dazi.ps1 docs sync` 后位于 `资源/docs/guides/`）。
+- v2 → v3 命令对照见 `guides/troubleshooting.md`（`dazi docs sync` 后位于 `资源/docs/guides/`）。
 
 ## 自检
 

package/dist/docs/onto//350/247/204/345/210/222/347/244/272/344/276/213_/345/210/251/346/266/246/345/210/206/346/236/220/346/234/254/344/275/223/346/226/271/346/241/210.md

@@ -417,9 +417,9 @@
 ## 七、实施计划
 
 > **dazi-vscode v3 命令对照**（`space_id` 见本文「一、空间概述」；项目目录 `项目/onto_<名称>/` 在新建项目时绑定该空间）  
-> 环境：`.\scripts\dazi.ps1 doctor` · 现网表/Cube：**数据资源** 侧栏 ·  
-> 发布：`.\scripts\dazi.ps1 onto script publish 项目/onto_<名称>/脚本/<file>.py --space space__profit0520 --register-function-id <id>` ·  
-> 运行：`.\scripts\dazi.ps1 onto function run <function_id> --space space__profit0520 --params '{}'`  
+> 环境：`dazi doctor` · 现网表/Cube：**数据资源** 侧栏 ·  
+> 发布：`dazi onto script publish 项目/onto_<名称>/脚本/<file>.py --space space__profit0520 --register-function-id <id>` ·  
+> 运行：`dazi onto function run <function_id> --space space__profit0520 --params '{}'`  
 > 细则见 **`本体规划指南.md`**「LLM 执行指引」。
 
 ### 7.1 阶段一：物理层（优先级：高）
@@ -460,7 +460,7 @@
 | 17   | 开发 mom_analysis          | 环比分析函数                                                                  |
 | 18   | 开发 top_products          | 产品排行函数                                                                  |
 | 19   | 开发 customer_segmentation | 客户分层函数                                                                  |
-| 20   | 发布并注册函数             | `.\scripts\dazi.ps1 onto script publish … --space space__profit0520 --register-function-id` |
+| 20   | 发布并注册函数             | `dazi onto script publish … --space space__profit0520 --register-function-id` |
 
 ### 7.5 阶段五：数据层（优先级：中）
 
@@ -473,7 +473,7 @@
 
 | 步骤 | 任务     | 说明                                                                                    |
 | ---- | -------- | --------------------------------------------------------------------------------------- |
-| 23   | 验收核对 | 侧栏 **数据资源** 查表/Cube；`.\scripts\dazi.ps1 onto function list --space space__profit0520` 查函数 |
+| 23   | 验收核对 | 侧栏 **数据资源** 查表/Cube；`dazi onto function list --space space__profit0520` 查函数 |
 | 24   | 函数测试 | 验证函数功能                                                                            |
 | 25   | 文档归档 | 更新规划文档                                                                            |
 
@@ -526,12 +526,12 @@
 
 ## 十、相关文档
 
-| 文档路径                                | 说明                                           |
-| --------------------------------------- | ---------------------------------------------- |
-| `本体规划指南.md`                       | 规划方法、空间约束、**LLM 执行指引（v3 CLI）** |
-| `本体脚本编写指南.md`                   | 项目内 `脚本/` 目录约定                        |
-| `本体脚本编写指南.md` / `function-guide.md` | `.\scripts\dazi.ps1 onto` 脚本发布与函数生命周期 |
-| `guides/workspace-v3.md`                | 工作区 `项目/`、`资源/` 布局                   |
+| 文档路径                                    | 说明                                           |
+| ------------------------------------------- | ---------------------------------------------- |
+| `本体规划指南.md`                           | 规划方法、空间约束、**LLM 执行指引（v3 CLI）** |
+| `本体脚本编写指南.md`                       | 项目内 `脚本/` 目录约定                        |
+| `本体脚本编写指南.md` / `function-guide.md` | `dazi onto` 脚本发布与函数生命周期             |
+| `guides/workspace-v3.md`                    | 工作区 `项目/`、`资源/` 布局                   |
 
 ---
 

package/dist/examples/flow/minimal-excel-python/README.md

@@ -0,0 +1,5 @@
+# 示例：minimal-excel-python
+
+标准三文件结构参考，详见 `docs/flow/local-files-spec.md`。
+
+勿直接当作可运行流程；`flowId` / `managed_file_id` 需替换为平台真实值。

package/dist/examples/flow/minimal-excel-python/flow.json

@@ -0,0 +1,48 @@
+{
+  "nodes": [
+    {
+      "id": "start-node",
+      "type": "custom",
+      "position": { "x": 50, "y": 250 },
+      "data": { "label": "开始", "type": "start" },
+      "deletable": false,
+      "node_uuid": "00000000-0000-4000-8000-000000000001"
+    },
+    {
+      "id": "n-excel-demo",
+      "type": "custom",
+      "position": { "x": 310, "y": 250 },
+      "data": {
+        "label": "Excel示例",
+        "type": "excel-python",
+        "managed_file_id": "<平台文件 UUID>",
+        "output_variable_name": "示例输出表"
+      },
+      "node_uuid": "00000000-0000-4000-8000-000000000002"
+    },
+    {
+      "id": "end-node",
+      "type": "custom",
+      "position": { "x": 850, "y": 250 },
+      "data": { "label": "结束", "type": "end" },
+      "deletable": false,
+      "node_uuid": "00000000-0000-4000-8000-000000000003"
+    }
+  ],
+  "edges": [
+    {
+      "id": "e1",
+      "source": "start-node",
+      "sourceHandle": "r",
+      "target": "n-excel-demo",
+      "targetHandle": "l"
+    },
+    {
+      "id": "e2",
+      "source": "n-excel-demo",
+      "sourceHandle": "r",
+      "target": "end-node",
+      "targetHandle": "l"
+    }
+  ]
+}

package/dist/examples/flow/minimal-excel-python/flow.meta.json

@@ -0,0 +1,23 @@
+{
+  "flowId": "<平台 flowId>",
+  "flowName": "minimal-excel-python",
+  "nodes": {
+    "00000000-0000-4000-8000-000000000001": {
+      "nodeId": "start-node",
+      "nodeType": "start"
+    },
+    "00000000-0000-4000-8000-000000000002": {
+      "nodeId": "n-excel-demo",
+      "nodeType": "excel-python",
+      "dir": "节点/Excel示例",
+      "codeFile": "code.py",
+      "codeLanguage": "python",
+      "codeHash": ""
+    },
+    "00000000-0000-4000-8000-000000000003": {
+      "nodeId": "end-node",
+      "nodeType": "end"
+    }
+  },
+  "graphFingerprint": "sha1:example"
+}

package/dist/examples/flow/minimal-excel-python//350/212/202/347/202/271/Excel/347/244/272/344/276/213/code.py

@@ -0,0 +1,7 @@
+# -*- coding: utf-8 -*-
+# 示例：excel-python 最小代码（复制到真实流程目录后替换 managed_file_id）
+import pandas as pd
+
+OUTPUT_VAR = "示例输出表"
+raw = pd.read_excel(excel_source_path, sheet_name=0)
+set_table_output(OUTPUT_VAR, raw)

package/dist/examples/flow/minimal-excel-python//350/212/202/347/202/271/Excel/347/244/272/344/276/213/node.info.json

@@ -0,0 +1,14 @@
+{
+  "_readonly": "示例文件；真实流程由 pull / repair-meta 生成",
+  "node_uuid": "00000000-0000-4000-8000-000000000002",
+  "nodeId": "n-excel-demo",
+  "nodeType": "excel-python",
+  "label": "Excel示例",
+  "codeFile": "code.py",
+  "codeLanguage": "python",
+  "data": {
+    "type": "excel-python",
+    "managed_file_id": "<平台文件 UUID>",
+    "output_variable_name": "示例输出表"
+  }
+}

package/dist/examples/index.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.0.0",
+  "version": "3.0.2",
   "updatedAt": "2026-05-25T00:00:00.000Z",
   "examples": [
     {
@@ -31,6 +31,12 @@
       "title": "客户分层",
       "category": "onto-function",
       "file": "onto/function/profit_fn_customer_segmentation.py"
+    },
+    {
+      "id": "flow/minimal-excel-python",
+      "title": "流程目录标准示例（excel-python）",
+      "category": "flow",
+      "file": "flow/minimal-excel-python/README.md"
     }
   ]
 }

package/dist/prompts/data/data-analysis.md

@@ -32,10 +32,10 @@
 
 ```bash
 # 查看表结构
-.\scripts\dazi.ps1 data table schema <table-id> --space <space-id>
+dazi data table schema <table-id> --space <space-id>
 
 # 采样数据（在 VS Code 侧栏点击表名）
-.\scripts\dazi.ps1 data table sample <table-id> --space <space-id> --rows 20
+dazi data table sample <table-id> --space <space-id> --rows 20
 
 # 使用 Flow 做批量分析
 dazi-flow run start <analysis-flow-id>

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

@@ -0,0 +1,69 @@
+# 流程项目 AI 工作手册（提示词）
+
+**文档 ID**: `flow/ai-workflow-playbook`  
+**适用**: Cursor / Trae / 任何 Agent 修改 `项目/flow_*/流程/<名>/`
+
+> 完整文件规范见资源文档 `flow/local-files-spec`；与 `docs/flow/ai-workflow-playbook.md` 同步维护。
+
+---
+
+## 1. 一分钟决策树
+
+```text
+要做什么？
+├─ 新增代码节点 → node new（禁止手搓 uuid）
+├─ 改 managed_file_id / output_variable_name / 连线 → project push --canvas
+├─ 改 code.py / code.sql → node push --node <uuid>
+├─ 目录 doctor 报错 → repair-meta，再 push --canvas / node push
+└─ 运行前 → 先 push 成功，再 flow-exec / node-exec
+```
+
+---
+
+## 2. 禁止清单
+
+1. **禁止**只编辑 `flow.json` 而不更新 `flow.meta.json`
+2. **禁止**伪造 `node_uuid`
+3. **禁止**把 SQL/Python 正文写入 `flow.json`
+4. **禁止**用 `project push`（无 `--canvas`）提交画布配置
+5. **禁止**在本地画布节点多于平台时直接 `project pull`（覆盖本地）
+6. **禁止**未 `push --canvas` 就 `flow-exec` 并声称配置已上线
+
+---
+
+## 3. 标准流程（改现有 excel-python）
+
+```powershell
+cd "项目\flow_xxx\流程\<流程名>"
+
+dazi flow project doctor --dir .
+# 若不一致：
+dazi flow project repair-meta --dir .
+
+# 改 flow.json 配置后：
+dazi flow project push --dir . --canvas
+
+# 改 code.py 后：
+dazi flow node push --node <node_uuid> --dir .
+
+dazi flow run node-exec --node <node_uuid> --dir .
+dazi flow run flow-exec --dir . --type debug
+```
+
+确认终端出现 **`✅ 画布已全量推送`**。
+
+---
+
+## 4. 提交前自检
+
+- [ ] `doctor` 为 ✅
+- [ ] 配置变更已 `push --canvas`
+- [ ] 代码变更已 `node push`
+- [ ] `flow.json` 无代码正文
+- [ ] 测试通过后再声称完成
+
+---
+
+## 5. 相关提示词
+
+`flow/flow-design`、`flow/run-fix-loop`（⭐）。