@dazitech/cli 3.0.1 → 3.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/clis/dazi-app.js +90 -9
- package/dist/clis/dazi-flow.js +2395 -1680
- package/dist/clis/dazi-onto.js +82 -15
- package/dist/clis/dazi.js +216 -50
- package/dist/docs/flow/ai-workflow-playbook.md +9 -8
- package/dist/docs/flow/flow-project-guide.md +41 -29
- package/dist/docs/flow/flows-guide.md +23 -16
- package/dist/docs/flow/local-files-spec.md +3 -3
- package/dist/docs/flow/node-code-guide.md +7 -7
- package/dist/docs/flow/run-guide.md +3 -3
- package/dist/docs/flow/variables-guide.md +4 -4
- package/dist/docs/guides/cli-invocation.md +3 -2
- package/dist/docs/guides/cli-reference.md +3 -1
- package/dist/docs/guides/flow-consistency-checklist.md +3 -3
- package/dist/docs/guides/quickstart.md +1 -1
- package/dist/docs/guides/troubleshooting.md +12 -11
- package/dist/docs/index.json +1 -1
- package/dist/examples/index.json +1 -1
- package/dist/prompts/index.json +94 -16
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# 数据流程项目开发指南
|
|
2
2
|
|
|
3
3
|
**文档 ID**: `flow/flow-project-guide`
|
|
4
|
-
**适用**: `dazi-vscode` v3.
|
|
4
|
+
**适用**: `dazi-vscode` v3.0.3+、`dazi-work` 工作区、业务项目 `项目/<业务名>/`
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -11,8 +11,8 @@
|
|
|
11
11
|
| ---------- | --------------------------------------------------------------- | ------------------- |
|
|
12
12
|
| CLI 入口 | `dazi flow …` → `dazi-flow`(Trae / VS Code / Cursor 交付环境) |
|
|
13
13
|
| **本地文件** | **[流程本地文件规范](./local-files-spec.md)**(AI 必读) |
|
|
14
|
-
| 工作区 | `dazi-work` +
|
|
15
|
-
| 本地流程树 |
|
|
14
|
+
| 工作区 | `dazi-work` + `项目/<业务名>/`(含 `本体/`、`流程/`、`应用/`) |
|
|
15
|
+
| 本地流程树 | `流程/flows/<流程名>/flow.json` + `节点/<名>/code.*` |
|
|
16
16
|
| 画布真理源 | **`flow.json`**(= 平台 `config_json` 镜像,代码已剥离) |
|
|
17
17
|
| 代码真理源 | \*\*`节点/<名>/code.sql | py`** + `node push` |
|
|
18
18
|
| 主交互 | **资源管理器右键** + MVP 流程设计器 |
|
|
@@ -29,24 +29,28 @@ dazi-work/
|
|
|
29
29
|
├── scripts/
|
|
30
30
|
│ └── dazi.ps1 ← 终端/Trae 中运行搭子 CLI 的入口
|
|
31
31
|
└── 项目/
|
|
32
|
-
└── flow_
|
|
33
|
-
├── README.md
|
|
34
|
-
├──
|
|
35
|
-
├──
|
|
32
|
+
└── 财务分析02/ ← 业务项目名(无 flow_/onto_/app_ 前缀)
|
|
33
|
+
├── README.md
|
|
34
|
+
├── 本体/ontos/…
|
|
35
|
+
├── 应用/apps/…
|
|
36
36
|
└── 流程/
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
37
|
+
├── README.md 流程工作区说明
|
|
38
|
+
├── 规划/
|
|
39
|
+
└── flows/ 各流程实例容器
|
|
40
|
+
└── 客户数据清洗/ ← 一个流程 = 一个目录
|
|
41
|
+
├── 快速启动_<流程名>.md pull 后生成(flowId、绝对路径命令、AI 入口)
|
|
42
|
+
├── flow.json ★ 画布(节点配置 + 边,不含代码正文)
|
|
43
|
+
├── flow.meta.json flowId、uuid 映射、代码指纹(勿手改)
|
|
44
|
+
├── 节点/
|
|
45
|
+
│ └── SQL查询/
|
|
46
|
+
│ ├── code.sql ★ 代码唯一真理源
|
|
47
|
+
│ └── node.info.json
|
|
48
|
+
├── 变量/ 调试 Run 变量只读派生
|
|
49
|
+
└── _run/ 测试/运行产物(*.last-error.md 等)
|
|
48
50
|
```
|
|
49
51
|
|
|
52
|
+
> **禁止**在 `dazi-work` **工作区根**对流程命令使用 `--dir .`(可能误读根目录残留的 `flow.meta.json`,导致 flowId 与目标流程不一致)。`--dir` 必须指向含 `flow.json` 的 `flows/<流程名>/` 目录,**推荐绝对路径**。
|
|
53
|
+
|
|
50
54
|
**关键约定**
|
|
51
55
|
|
|
52
56
|
- 节点 `type` 在画布上恒为 `"custom"`,**业务类型在 `data.type`**(如 `sql-query`、`python-script`)。
|
|
@@ -82,23 +86,30 @@ dazi flow <子命令...>
|
|
|
82
86
|
| `dazi-flow run node-exec …` | `dazi flow run node-exec …` |
|
|
83
87
|
| `dazi-flow variable pull …` | `dazi flow variable pull …` |
|
|
84
88
|
|
|
85
|
-
|
|
89
|
+
**`--dir` 约定**(Trae / Agent 必读):
|
|
90
|
+
|
|
91
|
+
| 方式 | 说明 |
|
|
92
|
+
|------|------|
|
|
93
|
+
| **推荐:绝对路径** | `--dir "D:\path\to\dazi-work\项目\<业务名>\流程\flows\<流程名>"`,不依赖终端 `cd` |
|
|
94
|
+
| 可选:`cd` + `--dir .` | 仅当已确认终端位于目标 `flows/<流程名>/` 时 |
|
|
95
|
+
| **禁止** | 在 `dazi-work` 根执行 `project status/push/pull --dir .` |
|
|
96
|
+
|
|
97
|
+
CLI 会校验目录含 `flow.json`;从 `节点/` 子路径执行时可向上解析到流程目录。
|
|
86
98
|
|
|
87
99
|
```powershell
|
|
88
|
-
#
|
|
100
|
+
# 鉴权(可在 dazi-work 根)
|
|
89
101
|
cd D:\path\to\dazi-work
|
|
90
102
|
dazi auth whoami
|
|
91
103
|
|
|
92
|
-
#
|
|
93
|
-
dazi flow project pull --flow 98 --dir "
|
|
104
|
+
# 拉取平台流程(推荐绝对路径 --dir)
|
|
105
|
+
dazi flow project pull --flow 98 --dir "D:\path\to\dazi-work\项目\财务分析02\流程\flows\MyFlow0529"
|
|
94
106
|
|
|
95
|
-
#
|
|
96
|
-
|
|
97
|
-
dazi flow
|
|
98
|
-
dazi flow node push --node <node_uuid>
|
|
107
|
+
# 状态自检:输出 flowId / 流程名须与 快速启动_*.md 一致
|
|
108
|
+
dazi flow project status --dir "D:\path\to\dazi-work\项目\财务分析02\流程\flows\MyFlow0529"
|
|
109
|
+
dazi flow node push --node <node_uuid> --dir "D:\path\to\dazi-work\项目\财务分析02\流程\flows\MyFlow0529"
|
|
99
110
|
```
|
|
100
111
|
|
|
101
|
-
|
|
112
|
+
**常用子命令速查**见 [Flow 文档索引 · 流程项目常用命令](./flows-guide.md#流程项目业务项目常用命令)。Plan、数据源等见 [执行计划](./plan-guide.md)、[数据源管理](./source-guide.md)。
|
|
102
113
|
|
|
103
114
|
---
|
|
104
115
|
|
|
@@ -106,7 +117,7 @@ dazi flow node push --node <node_uuid>
|
|
|
106
117
|
|
|
107
118
|
```text
|
|
108
119
|
1. 新建或拉取
|
|
109
|
-
|
|
120
|
+
扩展:右键 `流程/flows/` → 新建流程 / 拉取平台流程
|
|
110
121
|
CLI: flow project pull --flow <id> --dir <流程目录>
|
|
111
122
|
|
|
112
123
|
2. 改代码
|
|
@@ -163,7 +174,7 @@ dazi flow node push --node <node_uuid>
|
|
|
163
174
|
| `节点/<名>/code.*` | 提交、测试、拉取 |
|
|
164
175
|
| `变量/` | 同步变量到本地 |
|
|
165
176
|
| `变量/<名>.json` | 刷新变量、查看变量信息 |
|
|
166
|
-
|
|
|
177
|
+
| `流程/flows/`(容器目录) | 新建流程、拉取平台流程 |
|
|
167
178
|
| **数据资源 → 文件上传管理** | 浏览平台登记文件、**拉取到本地资源**、复制 AI 附加说明 |
|
|
168
179
|
|
|
169
180
|
设计器工具栏:**保存 / 校验 / 运行 / 提交 / 拉取**。
|
|
@@ -508,3 +519,4 @@ VS Code **打开流程设计器**(右键 `flow.json`)时:
|
|
|
508
519
|
| 变量查看失败 | 先 **测试节点** 或 **运行流程**;确认 `flow.meta.json` 有 `flowId` |
|
|
509
520
|
| 节点测试报缺上游变量 | 先运行上游节点,或 **运行整流程(debug)** 再测当前节点 |
|
|
510
521
|
| 代码改了平台没更新 | `node push` 或 `project push`;看 `project status` 是否脏 |
|
|
522
|
+
| flowId 与文档不一致 | 在 dazi-work 根或错误目录执行 `--dir .`;改用 `flows/<名>/` 绝对路径 |
|
|
@@ -23,34 +23,41 @@
|
|
|
23
23
|
|
|
24
24
|
## 终端命令前缀
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
命令前缀(Trae、VS Code、Cursor 交付环境):
|
|
27
27
|
|
|
28
28
|
```powershell
|
|
29
29
|
dazi flow <子命令...>
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
等价于开发时的 `dazi-flow
|
|
32
|
+
等价于开发时的 `dazi-flow <子命令...>`。
|
|
33
|
+
|
|
34
|
+
> **流程子命令的 `--dir`** 须指向 `项目/<业务名>/流程/flows/<流程名>/`(含 `flow.json`),**推荐绝对路径**。**禁止**在 `dazi-work` 工作区根使用 `--dir .`。
|
|
35
|
+
|
|
36
|
+
示例:
|
|
33
37
|
|
|
34
38
|
```powershell
|
|
35
39
|
dazi flow flows list
|
|
36
|
-
dazi flow project pull --flow 98 --dir "
|
|
40
|
+
dazi flow project pull --flow 98 --dir "D:\path\to\dazi-work\项目\财务分析02\流程\flows\MyFlow"
|
|
41
|
+
dazi flow project status --dir "D:\path\to\dazi-work\项目\财务分析02\流程\flows\MyFlow"
|
|
37
42
|
```
|
|
38
43
|
|
|
39
44
|
---
|
|
40
45
|
|
|
41
|
-
##
|
|
42
|
-
|
|
43
|
-
| 任务 | 命令
|
|
44
|
-
| ------------------ |
|
|
45
|
-
| 拉取平台流程到本地 | `flow project pull --flow <id> --dir
|
|
46
|
-
| 提交代码 + 画布 | `flow project push --dir
|
|
47
|
-
| 目录一致性检查 | `flow project doctor --dir
|
|
48
|
-
| 修复 meta 索引 | `flow project repair-meta --dir
|
|
49
|
-
| 查看本地改动 | `flow project status --dir
|
|
50
|
-
| 提交单个节点代码 | `flow node push --node <uuid> --dir
|
|
51
|
-
| 单节点测试 | `flow run node-exec --node <uuid> --dir
|
|
52
|
-
| 整流程运行 | `flow run flow-exec --dir
|
|
53
|
-
| 拉取变量 | `flow variable pull --name <名> --dir
|
|
46
|
+
## 流程项目(业务项目)常用命令
|
|
47
|
+
|
|
48
|
+
| 任务 | 命令 |
|
|
49
|
+
| ------------------ | -------------------------------------------------------------------- |
|
|
50
|
+
| 拉取平台流程到本地 | `flow project pull --flow <id> --dir <flows/<名>/绝对路径>` |
|
|
51
|
+
| 提交代码 + 画布 | `flow project push --dir <flows/<名>/绝对路径> --canvas` |
|
|
52
|
+
| 目录一致性检查 | `flow project doctor --dir <flows/<名>/绝对路径>` |
|
|
53
|
+
| 修复 meta 索引 | `flow project repair-meta --dir <flows/<名>/绝对路径>` |
|
|
54
|
+
| 查看本地改动 | `flow project status --dir <flows/<名>/绝对路径>` |
|
|
55
|
+
| 提交单个节点代码 | `flow node push --node <uuid> --dir <flows/<名>/绝对路径>` |
|
|
56
|
+
| 单节点测试 | `flow run node-exec --node <uuid> --dir <flows/<名>/绝对路径>` |
|
|
57
|
+
| 整流程运行 | `flow run flow-exec --dir <flows/<名>/绝对路径> --type debug` |
|
|
58
|
+
| 拉取变量 | `flow variable pull --name <名> --dir <flows/<名>/绝对路径>` |
|
|
59
|
+
|
|
60
|
+
`<flows/<名>/绝对路径>` = `…/项目/<业务名>/流程/flows/<流程名>`。执行 `status` 后核对输出的 **flowId / 流程名** 与 `快速启动_*.md` 一致。
|
|
54
61
|
|
|
55
62
|
扩展侧栏/资源管理器右键与上表 **同源**,见 [flow-project-guide](./flow-project-guide.md#6-资源管理器菜单主交互)。
|
|
56
63
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# 流程本地文件规范与示例
|
|
2
2
|
|
|
3
3
|
**文档 ID**: `flow/local-files-spec`
|
|
4
|
-
**适用**:
|
|
4
|
+
**适用**: `项目/<业务名>/流程/flows/<流程名>/` 目录、AI Agent、流程设计器
|
|
5
5
|
**关联**: [AI 工作手册](./ai-workflow-playbook.md)、[数据流程项目开发指南](./flow-project-guide.md)
|
|
6
6
|
|
|
7
7
|
---
|
|
@@ -24,10 +24,10 @@
|
|
|
24
24
|
## 2. 标准目录树
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
|
|
27
|
+
项目/<业务名>/流程/flows/<流程名>/
|
|
28
28
|
├── flow.json # 画布真理源(轻量,无 pythonCode/sql 正文)
|
|
29
29
|
├── flow.meta.json # 工程索引(CLI 维护)
|
|
30
|
-
├── 快速启动_<流程名>.md # pull
|
|
30
|
+
├── 快速启动_<流程名>.md # pull 后生成(含绝对路径命令、一致性检查)
|
|
31
31
|
├── 节点/
|
|
32
32
|
│ └── Excel成本报表解析/
|
|
33
33
|
│ ├── code.py # 代码真理源
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# 节点代码编写指南
|
|
2
2
|
|
|
3
3
|
**文档 ID**: `flow/node-code-guide`
|
|
4
|
-
**适用**:
|
|
4
|
+
**适用**: `项目/<业务名>/流程/flows/<流程名>/节点/<节点名>/code.*`
|
|
5
5
|
**前置**: **[流程本地文件规范](./local-files-spec.md)**(必读)、[数据流程项目开发指南](./flow-project-guide.md)、[流程变量系统指南](./variables-guide.md)
|
|
6
6
|
|
|
7
7
|
> 设计器「打开代码」依赖 `flow.meta.json` 中该节点的 `dir`+`codeFile`。若打不开,先 `dazi flow project doctor` → `repair-meta`。
|
|
@@ -40,19 +40,19 @@
|
|
|
40
40
|
## 2. 修改代码的标准流程
|
|
41
41
|
|
|
42
42
|
```powershell
|
|
43
|
-
# 1.
|
|
44
|
-
|
|
43
|
+
# 1. 确定流程目录(推荐绝对路径)
|
|
44
|
+
$flowDir = "D:\path\to\dazi-work\项目\<业务名>\流程\flows\MyFlow"
|
|
45
45
|
|
|
46
46
|
# 2. 编辑 节点/SQL查询/code.sql 等
|
|
47
47
|
|
|
48
48
|
# 3. 查看是否有本地改动
|
|
49
|
-
dazi flow project status
|
|
49
|
+
dazi flow project status --dir $flowDir
|
|
50
50
|
|
|
51
|
-
# 4.
|
|
52
|
-
dazi flow run node-exec --node <node_uuid> --dir
|
|
51
|
+
# 4. 单节点测试
|
|
52
|
+
dazi flow run node-exec --node <node_uuid> --dir $flowDir
|
|
53
53
|
|
|
54
54
|
# 5. 提交代码到平台
|
|
55
|
-
dazi flow node push --node <node_uuid> --dir
|
|
55
|
+
dazi flow node push --node <node_uuid> --dir $flowDir
|
|
56
56
|
```
|
|
57
57
|
|
|
58
58
|
`node_uuid` 在 `flow.meta.json` → `nodes.<uuid>`,或设计器属性面板、 `node.info.json` 中查看。
|
|
@@ -3,17 +3,17 @@
|
|
|
3
3
|
**文档 ID**: `flow/run-guide`
|
|
4
4
|
|
|
5
5
|
**命令前缀**(`dazi-work` 根):`dazi flow …`
|
|
6
|
-
|
|
6
|
+
**流程项目**:`--dir` 指向 `项目/<业务名>/流程/flows/<流程名>/`(**推荐绝对路径**;禁止在 `dazi-work` 根 `--dir .`)。
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
## 1. 流程项目:单节点测试(最常用)
|
|
11
11
|
|
|
12
12
|
```powershell
|
|
13
|
-
|
|
13
|
+
$flowDir = "D:\path\to\dazi-work\项目\<业务名>\流程\flows\MyFlow"
|
|
14
14
|
|
|
15
15
|
# 按 node_uuid 测试(CLI 内部翻译为语义 nodeId)
|
|
16
|
-
dazi flow run node-exec --node <node_uuid> --dir
|
|
16
|
+
dazi flow run node-exec --node <node_uuid> --dir $flowDir
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
**行为**
|
|
@@ -84,16 +84,16 @@ GET /flows/{id}/debug-run → 绑定 ads_flows.debug_run_id
|
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
```powershell
|
|
87
|
-
|
|
87
|
+
$flowDir = "D:\path\to\dazi-work\项目\<业务名>\流程\flows\MyFlow"
|
|
88
88
|
|
|
89
89
|
# 先运行产出变量的上游节点,或整流程 debug
|
|
90
|
-
dazi flow run node-exec --node <上游uuid> --dir
|
|
90
|
+
dazi flow run node-exec --node <上游uuid> --dir $flowDir
|
|
91
91
|
|
|
92
92
|
# 拉取单个变量(列信息 + 前 10 行)
|
|
93
|
-
dazi flow variable pull --name sales_clean --dir
|
|
93
|
+
dazi flow variable pull --name sales_clean --dir $flowDir
|
|
94
94
|
|
|
95
95
|
# 同步调试 Run 中全部变量
|
|
96
|
-
dazi flow variable sync --dir
|
|
96
|
+
dazi flow variable sync --dir $flowDir
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
- 设计器:选中节点 → **`output_variable_name`** 旁 **📊**
|
|
@@ -49,7 +49,7 @@ dazi onto function list --space <space-id>
|
|
|
49
49
|
| ---------------------------------------------------------------- | ----------------------------------------------------------------------- |
|
|
50
50
|
| `dazi auth whoami` | 原 `dazi auth whoami` |
|
|
51
51
|
| `dazi onto script publish ...` | 原 `dazi onto script publish ...`(**勿用** `dazi-onto`) |
|
|
52
|
-
| `dazi flow project pull --flow 98 --dir
|
|
52
|
+
| `dazi flow project pull --flow 98 --dir …\项目\<业务名>\流程\flows\MyFlow` | 流程项目拉取(`--dir` 推荐绝对路径) |
|
|
53
53
|
| `dazi flow run node-exec --node <uuid> --dir <流程目录>` | 单节点测试 |
|
|
54
54
|
| `pnpm run dazi-app -- upload ...` | 原 `dazi-app upload ...`(须在**应用项目根**,含 `sdk/`、`templates/`) |
|
|
55
55
|
|
|
@@ -65,7 +65,8 @@ dazi onto function list --space <space-id>
|
|
|
65
65
|
因此文档里的 `dazi-flow project pull …` 在 Trae / VS Code 交付环境中应写为:
|
|
66
66
|
|
|
67
67
|
```powershell
|
|
68
|
-
|
|
68
|
+
# --dir 须指向 flows/<流程名>/(含 flow.json);禁止在 dazi-work 根 --dir .
|
|
69
|
+
dazi flow project pull --flow 98 --dir "D:\path\to\dazi-work\项目\财务分析02\流程\flows\MyFlow"
|
|
69
70
|
```
|
|
70
71
|
|
|
71
72
|
流程项目开发详见 [flow/flow-project-guide](../flow/flow-project-guide.md)。
|
|
@@ -51,7 +51,9 @@
|
|
|
51
51
|
|
|
52
52
|
> **流程项目日常开发**见 [flow/flow-project-guide](../flow/flow-project-guide.md)。
|
|
53
53
|
|
|
54
|
-
###
|
|
54
|
+
### 流程项目(`项目/<业务名>/流程/flows/<流程名>/`)
|
|
55
|
+
|
|
56
|
+
> `--dir` 须含 `flow.json`,推荐绝对路径;禁止在 `dazi-work` 工作区根 `--dir .`。
|
|
55
57
|
|
|
56
58
|
| 命令 | 说明 |
|
|
57
59
|
| ----------------------------------------------------- | ------------------------------------------- |
|
|
@@ -8,9 +8,9 @@
|
|
|
8
8
|
## CLI 一键检查
|
|
9
9
|
|
|
10
10
|
```powershell
|
|
11
|
-
|
|
12
|
-
dazi flow project doctor --dir
|
|
13
|
-
dazi flow project repair-meta --dir
|
|
11
|
+
$flowDir = "D:\path\to\dazi-work\项目\<业务名>\流程\flows\<流程名>"
|
|
12
|
+
dazi flow project doctor --dir $flowDir
|
|
13
|
+
dazi flow project repair-meta --dir $flowDir # 若 doctor 报错
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
---
|
|
@@ -72,6 +72,6 @@ dazi auth whoami
|
|
|
72
72
|
- [CLI 调用约定](./cli-invocation.md)
|
|
73
73
|
- [认证管理](../auth/auth-login.md)
|
|
74
74
|
- [本体开发入门](../onto/space-management.md)
|
|
75
|
-
- [数据流程项目开发](../flow/flow-project-guide.md) —
|
|
75
|
+
- [数据流程项目开发](../flow/flow-project-guide.md) — **推荐**:`项目/<业务名>/流程/flows/`、菜单、pull/push
|
|
76
76
|
- [节点代码编写](../flow/node-code-guide.md) — python-script、sql-query 等
|
|
77
77
|
- [流程开发索引](../flow/flows-guide.md) — Flow 文档入口
|
|
@@ -47,18 +47,19 @@ Token 保存在 `~/.dazi/auth.json`,检查是否过期。
|
|
|
47
47
|
## 流程:设计器打不开代码 / push 后平台仍旧
|
|
48
48
|
|
|
49
49
|
```powershell
|
|
50
|
-
|
|
51
|
-
dazi flow project doctor --dir
|
|
52
|
-
dazi flow project repair-meta --dir
|
|
53
|
-
dazi flow project push --dir
|
|
50
|
+
$flowDir = "D:\path\to\dazi-work\项目\<业务名>\流程\flows\<流程名>"
|
|
51
|
+
dazi flow project doctor --dir $flowDir
|
|
52
|
+
dazi flow project repair-meta --dir $flowDir
|
|
53
|
+
dazi flow project push --dir $flowDir --canvas
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
| 现象
|
|
57
|
-
|
|
58
|
-
| 设计器「打开代码」失败
|
|
59
|
-
| 改了 `managed_file_id` 平台没有
|
|
60
|
-
| `node push` 无效果
|
|
61
|
-
| 本地 flow.json 对、快速启动写 2 节点 | pull 后手改画布未同步 meta
|
|
56
|
+
| 现象 | 原因 | 处理 |
|
|
57
|
+
| ------------------------------------ | ------------------------------------- | --------------- |
|
|
58
|
+
| 设计器「打开代码」失败 | `flow.meta.json` 无该 uuid 的 `dir` | `repair-meta` |
|
|
59
|
+
| 改了 `managed_file_id` 平台没有 | 只用了 `project push` 未加 `--canvas` | `push --canvas` |
|
|
60
|
+
| `node push` 无效果 | meta 未索引该节点 | `repair-meta` |
|
|
61
|
+
| 本地 flow.json 对、快速启动写 2 节点 | pull 后手改画布未同步 meta | `repair-meta` |
|
|
62
|
+
| **status 的 flowId 与快速启动不一致** | 在 dazi-work 根或错误流程目录 `--dir .` | 改用 `flows/<名>/` **绝对路径**;见 `快速启动_*.md` |
|
|
62
63
|
|
|
63
64
|
详见 [流程本地文件规范](../flow/local-files-spec.md)、[一致性检查表](./flow-consistency-checklist.md)。
|
|
64
65
|
|
|
@@ -83,7 +84,7 @@ dazi doctor --workspace-root D:\path\to\dazi-work
|
|
|
83
84
|
检查 `.cursor/mcp.json` 配置。MCP 需能调用 bundled CLI,示例:
|
|
84
85
|
|
|
85
86
|
```powershell
|
|
86
|
-
$env:DAZI_BUNDLED_DIR = "$env:USERPROFILE\.cursor\extensions\dazitech.dazi-vscode-3.0.
|
|
87
|
+
$env:DAZI_BUNDLED_DIR = "$env:USERPROFILE\.cursor\extensions\dazitech.dazi-vscode-3.0.3\bundled\clis"
|
|
87
88
|
node "$env:DAZI_BUNDLED_DIR\dazi.js" mcp stdio
|
|
88
89
|
```
|
|
89
90
|
|
package/dist/docs/index.json
CHANGED
package/dist/examples/index.json
CHANGED
package/dist/prompts/index.json
CHANGED
|
@@ -1,21 +1,99 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "3.0.
|
|
2
|
+
"version": "3.0.3",
|
|
3
3
|
"updatedAt": "2026-05-26T00:00:00.000Z",
|
|
4
4
|
"prompts": [
|
|
5
|
-
{
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
{
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
{
|
|
18
|
-
|
|
19
|
-
|
|
5
|
+
{
|
|
6
|
+
"id": "onto/script-publish-run",
|
|
7
|
+
"title": "本体脚本发布与运行(TRAE/智能体)",
|
|
8
|
+
"category": "onto",
|
|
9
|
+
"file": "onto/script-publish-run.md"
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"id": "onto/function-design",
|
|
13
|
+
"title": "本体函数设计",
|
|
14
|
+
"category": "onto",
|
|
15
|
+
"file": "onto/function-design.md"
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"id": "onto/action-design",
|
|
19
|
+
"title": "本体动作(Action)设计",
|
|
20
|
+
"category": "onto",
|
|
21
|
+
"file": "onto/action-design.md"
|
|
22
|
+
},
|
|
23
|
+
{
|
|
24
|
+
"id": "onto/rule-seed",
|
|
25
|
+
"title": "规则种子脚本",
|
|
26
|
+
"category": "onto",
|
|
27
|
+
"file": "onto/rule-seed.md"
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"id": "flow/flow-design",
|
|
31
|
+
"title": "Flow 设计",
|
|
32
|
+
"category": "flow",
|
|
33
|
+
"file": "flow/flow-design.md",
|
|
34
|
+
"featured": true
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"id": "flow/ai-workflow-playbook",
|
|
38
|
+
"title": "流程 AI 工作手册",
|
|
39
|
+
"category": "flow",
|
|
40
|
+
"file": "flow/ai-workflow-playbook.md",
|
|
41
|
+
"featured": true
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"id": "flow/run-debug",
|
|
45
|
+
"title": "Run 调试分析",
|
|
46
|
+
"category": "flow",
|
|
47
|
+
"file": "flow/run-debug.md"
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
"id": "flow/run-fix-loop",
|
|
51
|
+
"title": "Flow 自主运行改错",
|
|
52
|
+
"category": "flow",
|
|
53
|
+
"file": "flow/run-fix-loop.md",
|
|
54
|
+
"featured": true
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"id": "flow/plan-generate",
|
|
58
|
+
"title": "执行计划生成",
|
|
59
|
+
"category": "flow",
|
|
60
|
+
"file": "flow/plan-generate.md"
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
"id": "app/ui-design",
|
|
64
|
+
"title": "搭子 App UI 设计",
|
|
65
|
+
"category": "app",
|
|
66
|
+
"file": "app/ui-design.md"
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"id": "data/data-analysis",
|
|
70
|
+
"title": "数据分析",
|
|
71
|
+
"category": "data",
|
|
72
|
+
"file": "data/data-analysis.md"
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
"id": "data/sql-query",
|
|
76
|
+
"title": "SQL 查询生成",
|
|
77
|
+
"category": "data",
|
|
78
|
+
"file": "data/sql-query.md"
|
|
79
|
+
},
|
|
80
|
+
{
|
|
81
|
+
"id": "general/ask-dazi",
|
|
82
|
+
"title": "询问搭子平台",
|
|
83
|
+
"category": "general",
|
|
84
|
+
"file": "general/ask-dazi.md"
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"id": "general/troubleshoot",
|
|
88
|
+
"title": "问题排查",
|
|
89
|
+
"category": "general",
|
|
90
|
+
"file": "general/troubleshoot.md"
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"id": "general/code-review",
|
|
94
|
+
"title": "搭子脚本代码审查",
|
|
95
|
+
"category": "general",
|
|
96
|
+
"file": "general/code-review.md"
|
|
97
|
+
}
|
|
20
98
|
]
|
|
21
99
|
}
|