@dazitech/cli 3.0.0 → 3.0.1

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`。

package/dist/docs/app//344/270/273/350/246/201/350/264/242/345/212/241/346/214/207/346/240/207/345/244/215/346/235/202/346/212/245/350/241/250/345/274/200/345/217/221/345/256/236/350/267/265.md

@@ -10,14 +10,14 @@
 
 ## 1. 适用场景
 
-| 项 | 说明 |
-|----|------|
-| 报表形态 | 多级表头 + 宽表（年度列 + 分月列） |
-| 典型列 | 类别、指标名称、2017–2022 年、2021/2022/2023 分月 |
-| 交互 | 表头固定、左侧两列冻结、类别纵向合并、条件行样式 |
-| 组件 | `@dazi/app-sdk-ui` → `ComplexReport` |
-| 布局 | RLIR（`报表布局.json`）→ `manifest.report_design.layout_snapshot` |
-| 数据 | 开发 `static`；上线 `sql_template` / `ontology_function` |
+| 项       | 说明                                                              |
+| -------- | ----------------------------------------------------------------- |
+| 报表形态 | 多级表头 + 宽表（年度列 + 分月列）                                |
+| 典型列   | 类别、指标名称、2017–2022 年、2021/2022/2023 分月                 |
+| 交互     | 表头固定、左侧两列冻结、类别纵向合并、条件行样式                  |
+| 组件     | `@dazi/app-sdk-ui` → `ComplexReport`                              |
+| 布局     | RLIR（`报表布局.json`）→ `manifest.report_design.layout_snapshot` |
+| 数据     | 开发 `static`；上线 `sql_template` / `ontology_function`          |
 
 ---
 
@@ -25,13 +25,13 @@
 
 ### 2.1 命令行（推荐）
 
-在 **`dazi-work` 根**使用 `.\scripts\dazi.ps1 app`（自动解析 bundled CLI，最稳）：
+在 **`dazi-work` 根**使用 `dazi app`（自动解析 bundled CLI，最稳）：
 
 ```powershell
 cd D:\path\to\dazi-work
 
 # 初始化应用（将 my-fin-report-001、app_<名> 换成你的路径）
-.\scripts\dazi.ps1 app init financial-indicators-complex-report `
+dazi app init financial-indicators-complex-report `
   --space space__0519 `
   --dir 项目/app_<名>/apps/my-fin-report-001
 ```
@@ -68,7 +68,7 @@ src/fixtures/generated/*.json
     ↓ 本地验收
 pnpm run dev
     ↓ 发布
-pnpm run build → .\scripts\dazi.ps1 app upload --activate（在 dazi-work 根，带 --cwd）
+pnpm run build → dazi app upload --activate（在 dazi-work 根，带 --cwd）
 ```
 
 VS Code 分步说明见应用内 `.ai/implement-from-managed-file.md`。
@@ -128,20 +128,24 @@ const ds = useReportDataset({ visibleFields, wideTable: layout.wideTable });
   dataset={ds.data}
   maxHeight={640}
   onVisibleFieldsChange={handleVisibleFieldsChange}
-  pagination={{ page: ds.page, pageSize: ds.pageSize, onPageChange: ds.setPage }}
-/>
+  pagination={{
+    page: ds.page,
+    pageSize: ds.pageSize,
+    onPageChange: ds.setPage,
+  }}
+/>;
 ```
 
 `handleVisibleFieldsChange` 须 `useCallback`，并用 `join("\0")` 比较列集合，避免无意义重渲染。
 
 ### 5.2 业务规则（模板默认）
 
-| 规则 | 配置 |
-|------|------|
-| 类别合并 | `category` 列 `rowMerge: true` |
-| 利润总额加粗 | `features.rowEmphasis` → 指标含「利润总额」 |
+| 规则                 | 配置                                              |
+| -------------------- | ------------------------------------------------- |
+| 类别合并             | `category` 列 `rowMerge: true`                    |
+| 利润总额加粗         | `features.rowEmphasis` → 指标含「利润总额」       |
 | 万元产值综合能耗标红 | `features.rowDanger` → 指标含「万元产值综合能耗」 |
-| 数值格式 | 除类别/指标外 `format: "number"` |
+| 数值格式             | 除类别/指标外 `format: "number"`                  |
 
 ### 5.3 应用级样式
 
@@ -153,11 +157,11 @@ const ds = useReportDataset({ visibleFields, wideTable: layout.wideTable });
 
 ### 6.1 开发阶段
 
-| 文件 | 用途 |
-|------|------|
-| `generated/reportRows.json` | 静态样例行 |
-| `datasets.ts` | 包装为 `report_data` |
-| `manifest.data_sources` | `kind: static` |
+| 文件                        | 用途                 |
+| --------------------------- | -------------------- |
+| `generated/reportRows.json` | 静态样例行           |
+| `datasets.ts`               | 包装为 `report_data` |
+| `manifest.data_sources`     | `kind: static`       |
 
 建议 `refresh.on_mount: false`，由宿主首次注入 + 本地投影，避免重复请求。
 
@@ -207,13 +211,13 @@ SQL / 资产放在 `drap-assets/`，勿把 Excel 放进 `drap-assets/report-desi
 
 ## 8. 常见问题
 
-| 现象 | 原因 | 处理 |
-|------|------|------|
-| 分月表头错位 | `leaf:false` 父列未过滤 | `normalizeReportLayout` |
-| 类别未合并 | 未配置 `rowMerge` | `category` 列开启 |
-| 行样式无效 | `features` 未写入 layout | manifest 或 normalize 补全 |
-| 页面狂刷接口 | refetch 循环 / 未部署 SDK 补丁 | 见 §7.1，重建并发布 |
-| 运行时无数据 | 未绑定设计稿或未写快照 | 绑定 + 发布快照 |
+| 现象         | 原因                           | 处理                       |
+| ------------ | ------------------------------ | -------------------------- |
+| 分月表头错位 | `leaf:false` 父列未过滤        | `normalizeReportLayout`    |
+| 类别未合并   | 未配置 `rowMerge`              | `category` 列开启          |
+| 行样式无效   | `features` 未写入 layout       | manifest 或 normalize 补全 |
+| 页面狂刷接口 | refetch 循环 / 未部署 SDK 补丁 | 见 §7.1，重建并发布        |
+| 运行时无数据 | 未绑定设计稿或未写快照         | 绑定 + 发布快照            |
 
 ---
 
@@ -225,8 +229,8 @@ SQL / 资产放在 `drap-assets/`，勿把 Excel 放进 `drap-assets/report-desi
 - [ ] `manifest.report_design` 含 `managed_file_id` 与 `layout_snapshot`
 - [ ] `pnpm run dev` 验收：表头、合并、冻结列、行样式、无接口风暴
 - [ ] `pnpm run build`
-- [ ] `.\scripts\dazi.ps1 app manifest validate --scan-src`（`--cwd` 指向组件目录）
-- [ ] `.\scripts\dazi.ps1 app upload --activate`（在 dazi-work 根）
+- [ ] `dazi app manifest validate --scan-src`（`--cwd` 指向组件目录）
+- [ ] `dazi app upload --activate`（在 dazi-work 根）
 - [ ] 主站 frontend 已部署（含 static 本地投影）
 
 ---
@@ -241,21 +245,21 @@ pnpm run build
 
 # 校验与发布：在 dazi-work 根
 cd D:\path\to\dazi-work
-.\scripts\dazi.ps1 app manifest validate --cwd 项目/app_<名>/apps/my-fin-report-001 --scan-src
-.\scripts\dazi.ps1 app upload --cwd 项目/app_<名>/apps/my-fin-report-001 --space space__0519 --activate
+dazi app manifest validate --cwd 项目/app_<名>/apps/my-fin-report-001 --scan-src
+dazi app upload --cwd 项目/app_<名>/apps/my-fin-report-001 --space space__0519 --activate
 ```
 
 ---
 
 ## 11. 相关文档
 
-| 文档 | 说明 |
-|------|------|
-| [337-中国式复杂报表开发方案.md](../337-中国式复杂报表开发方案.md) | 平台架构与 Phase 规划 |
-| [问题和分析/复杂报表记录.md](../问题和分析/复杂报表记录.md) | 线上问题排查记录 |
-| `dazi-vscode/docs/app/release-guide.md` | 应用发布总览 |
-| 模板 `README.md` | `runtime-apps/templates/app-template-financial-indicators-complex-report/` |
+| 文档                                                              | 说明                                                                       |
+| ----------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| [337-中国式复杂报表开发方案.md](../337-中国式复杂报表开发方案.md) | 平台架构与 Phase 规划                                                      |
+| [问题和分析/复杂报表记录.md](../问题和分析/复杂报表记录.md)       | 线上问题排查记录                                                           |
+| `dazi-vscode/docs/app/release-guide.md`                           | 应用发布总览                                                               |
+| 模板 `README.md`                                                  | `runtime-apps/templates/app-template-financial-indicators-complex-report/` |
 
 ---
 
-*文档版本：2026-05-31 · 基于 complex-report-003 实践整理，对应模板 financial-indicators-complex-report*
+_文档版本：2026-05-31 · 基于 complex-report-003 实践整理，对应模板 financial-indicators-complex-report_

package/dist/docs/auth/auth-login.md

@@ -7,7 +7,7 @@
 ### Token 登录（推荐 CI/CD）
 
 ```bash
-.\scripts\dazi.ps1 auth set-token --token "eyJ..."
+dazi auth set-token --token "eyJ..."
 ```
 
 Token 存储在 `~/.dazi/auth.json`，可在多个项目间共享。
@@ -15,13 +15,13 @@ Token 存储在 `~/.dazi/auth.json`，可在多个项目间共享。
 ### 用户名密码登录
 
 ```bash
-.\scripts\dazi.ps1 auth login --username your@email.com --password yourpassword
+dazi auth login --username your@email.com --password yourpassword
 ```
 
 ### 验证登录状态
 
 ```bash
-.\scripts\dazi.ps1 auth whoami
+dazi auth whoami
 ```
 
 ## 多环境支持
@@ -30,7 +30,7 @@ Token 存储在 `~/.dazi/auth.json`，可在多个项目间共享。
 
 ```powershell
 $env:DAZI_BASE_URL = "https://staging.dazi.tech"
-.\scripts\dazi.ps1 auth whoami
+dazi auth whoami
 ```
 
 或在 `.env` 文件中配置：

package/dist/docs/auth/token-management.md

@@ -19,10 +19,10 @@ Token 存储在 `~/.dazi/auth.json`，格式：
 
 ```bash
 # 预览
-.\scripts\dazi.ps1 auth migrate --dry-run
+dazi auth migrate --dry-run
 
 # 执行（从 ~/.dazi-app/auth.json 迁移）
-.\scripts\dazi.ps1 auth migrate
+dazi auth migrate
 ```
 
 ## Token 刷新
@@ -30,13 +30,13 @@ Token 存储在 `~/.dazi/auth.json`，格式：
 Token 过期后重新登录，旧 Token 自动覆盖：
 
 ```bash
-.\scripts\dazi.ps1 auth login
+dazi auth login
 # 或
-.\scripts\dazi.ps1 auth set-token --token "<new-token>"
+dazi auth set-token --token "<new-token>"
 ```
 
 ## 清除 Token
 
 ```bash
-.\scripts\dazi.ps1 auth logout
+dazi auth logout
 ```

package/dist/docs/data/cube-guide.md

@@ -9,13 +9,13 @@ Cube 是预聚合的数据集，基于数据表或视图构建，支持快速查
 ## 列出 Cube
 
 ```bash
-.\scripts\dazi.ps1 data cube list --space <space-id>
+dazi data cube list --space <space-id>
 ```
 
 ## 查看 Cube 详情
 
 ```bash
-.\scripts\dazi.ps1 data cube info <cube-id> --space <space-id>
+dazi data cube info <cube-id> --space <space-id>
 ```
 
 ## 在扩展中使用

package/dist/docs/data/data-spaces.md

@@ -5,24 +5,25 @@
 ## 列出数据空间
 
 ```bash
-.\scripts\dazi.ps1 data space list
+dazi data space list
 ```
 
 ## 创建数据空间
 
 ```bash
-.\scripts\dazi.ps1 data space create --name "财务数据" --category-id finance
+dazi data space create --name "财务数据" --category-id finance
 ```
 
 ## 刷新数据空间
 
 ```bash
-.\scripts\dazi.ps1 data space refresh <space-id>
+dazi data space refresh <space-id>
 ```
 
 ## 扩展侧栏
 
 在 VS Code 侧栏「🗂 数据资源」节点下，按空间分组展示：
+
 - 数据表（Tables）
 - 数据集（Cubes）
 - 数据源（Sources）

package/dist/docs/data/table-preview.md

@@ -5,19 +5,19 @@
 ## 列出数据表
 
 ```bash
-.\scripts\dazi.ps1 data table list --space <space-id>
+dazi data table list --space <space-id>
 ```
 
 ## 查看表结构
 
 ```bash
-.\scripts\dazi.ps1 data table schema <table-id> --space <space-id>
+dazi data table schema <table-id> --space <space-id>
 ```
 
 ## 采样数据
 
 ```bash
-.\scripts\dazi.ps1 data table sample <table-id> --space <space-id> --rows 10
+dazi data table sample <table-id> --space <space-id> --rows 10
 ```
 
 ## 在扩展中预览
@@ -31,11 +31,11 @@
 
 ```bash
 # 列出平台文件
-.\scripts\dazi.ps1 data file list --space <space-id>
+dazi data file list --space <space-id>
 
 # 上传本地文件
-.\scripts\dazi.ps1 data file upload ./data.csv --space <space-id>
+dazi data file upload ./data.csv --space <space-id>
 
 # 下载文件
-.\scripts\dazi.ps1 data file pull remote/path.csv --space <space-id>
+dazi data file pull remote/path.csv --space <space-id>
 ```

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

@@ -0,0 +1,69 @@
+# 流程项目 AI 工作手册
+
+**文档 ID**: `flow/ai-workflow-playbook`  
+**适用**: Cursor / Trae / 任何 Agent 修改 `项目/flow_*/流程/<名>/`
+
+> 完整文件规范见 [流程本地文件规范](./local-files-spec.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`（⭐）。