@dazitech/cli 3.0.0 → 3.0.2

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`（⭐）。