@dazitech/cli 3.0.0 → 3.0.1

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.
Files changed (58) hide show
  1. package/README.md +15 -13
  2. package/dist/clis/dazi-app.js +5 -5
  3. package/dist/clis/dazi-flow.js +600 -170
  4. package/dist/docs/app/app-init.md +15 -15
  5. package/dist/docs/app/build-upload.md +13 -13
  6. package/dist/docs/app/release-guide.md +9 -9
  7. 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 +45 -41
  8. package/dist/docs/auth/auth-login.md +4 -4
  9. package/dist/docs/auth/token-management.md +5 -5
  10. package/dist/docs/data/cube-guide.md +2 -2
  11. package/dist/docs/data/data-spaces.md +4 -3
  12. package/dist/docs/data/table-preview.md +6 -6
  13. package/dist/docs/flow/ai-workflow-playbook.md +69 -0
  14. package/dist/docs/flow/flow-project-guide.md +92 -87
  15. package/dist/docs/flow/flows-guide.md +98 -94
  16. package/dist/docs/flow/local-files-spec.md +194 -0
  17. package/dist/docs/flow/node-code-guide.md +57 -55
  18. package/dist/docs/flow/run-guide.md +18 -18
  19. package/dist/docs/flow/variables-guide.md +61 -61
  20. 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 +31 -31
  21. package/dist/docs/guides/cli-invocation.md +30 -29
  22. package/dist/docs/guides/cli-reference.md +72 -71
  23. package/dist/docs/guides/flow-consistency-checklist.md +42 -0
  24. package/dist/docs/guides/mcp-setup.md +34 -34
  25. package/dist/docs/guides/migrate-v2-v3.md +6 -5
  26. package/dist/docs/guides/quickstart.md +8 -8
  27. package/dist/docs/guides/troubleshooting.md +39 -21
  28. package/dist/docs/guides/workspace-v3.md +17 -17
  29. package/dist/docs/index.json +18 -6
  30. package/dist/docs/onto/action-guide.md +4 -3
  31. package/dist/docs/onto/dazi_script_sdk_reference.md +20 -14
  32. package/dist/docs/onto/dazi_script_seed_data_guide.md +14 -14
  33. package/dist/docs/onto/function-guide.md +5 -5
  34. package/dist/docs/onto/rule-guide.md +7 -6
  35. package/dist/docs/onto/space-management.md +5 -3
  36. 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 +35 -35
  37. package/dist/docs/onto//346/234/254/344/275/223/350/247/204/345/210/222/346/214/207/345/215/227.md +21 -21
  38. 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 +11 -11
  39. package/dist/examples/flow/minimal-excel-python/README.md +5 -0
  40. package/dist/examples/flow/minimal-excel-python/flow.json +48 -0
  41. package/dist/examples/flow/minimal-excel-python/flow.meta.json +23 -0
  42. package/dist/examples/flow/minimal-excel-python//350/212/202/347/202/271/Excel/347/244/272/344/276/213/code.py +7 -0
  43. package/dist/examples/flow/minimal-excel-python//350/212/202/347/202/271/Excel/347/244/272/344/276/213/node.info.json +14 -0
  44. package/dist/examples/index.json +6 -0
  45. package/dist/prompts/data/data-analysis.md +2 -2
  46. package/dist/prompts/flow/ai-workflow-playbook.md +69 -0
  47. package/dist/prompts/flow/flow-design.md +33 -19
  48. package/dist/prompts/flow/plan-generate.md +7 -7
  49. package/dist/prompts/flow/run-debug.md +15 -15
  50. package/dist/prompts/flow/run-fix-loop.md +20 -17
  51. package/dist/prompts/general/ask-dazi.md +6 -6
  52. package/dist/prompts/general/troubleshoot.md +4 -3
  53. package/dist/prompts/index.json +1 -0
  54. package/dist/prompts/onto/action-design.md +7 -5
  55. package/dist/prompts/onto/function-design.md +6 -4
  56. package/dist/prompts/onto/rule-seed.md +4 -2
  57. package/dist/prompts/onto/script-publish-run.md +19 -19
  58. package/package.json +1 -1
package/README.md CHANGED
@@ -2,14 +2,16 @@
2
2
 
3
3
  搭子 v3 终端 CLI 的 **pnpm 可发布包**,与 `dazi-vscode` 扩展使用同一套 `bundled/clis` 产物。
4
4
 
5
+ 完整说明见:**`dazi/docs/341-dazi-vscode-cli打包和发布指南.md`**。
6
+
5
7
  ## 与 `dazi.ps1` 的关系
6
8
 
7
- | 方式 | 适用 |
8
- |------|------|
9
- | `.\scripts\dazi.ps1` | 仅拷贝 `dazi-work`、未装全局 CLI |
10
- | **`dazi` / `dazi-flow`(本包)** | 开发机全局短命令 |
9
+ | 方式 | 适用 |
10
+ | -------------------------------- | -------------------------------- |
11
+ | `dazi` | 仅拷贝 `dazi-work`、未装全局 CLI |
12
+ | **`dazi` / `dazi-flow`(本包)** | 开发机全局短命令 |
11
13
 
12
- 二者等价:`dazi flow …` ≈ `.\scripts\dazi.ps1 flow …`。
14
+ 二者等价:`dazi flow …` ≈ `dazi flow …`。
13
15
 
14
16
  ## 研发:准备发布目录
15
17
 
@@ -58,15 +60,15 @@ pnpm run publish:cli
58
60
 
59
61
  **方式 B — Granular Access Token + `.npmrc`(纯文本文件):**
60
62
 
63
+ **推荐**把 token 写在 `%USERPROFILE%\.npmrc`(避免 `pnpm run vsix` 把密钥打进扩展包):
64
+
61
65
  ```powershell
62
- cd packages\cli-dist
63
- copy .npmrc.example .npmrc
64
- # 用编辑器打开 .npmrc,把 YOUR_NPM_TOKEN_HERE 换成 npm_ 开头的 token
65
- cd ..\..
66
+ copy packages\cli-dist\.npmrc.example %USERPROFILE%\.npmrc
67
+ notepad %USERPROFILE%\.npmrc
66
68
  pnpm run publish:cli
67
69
  ```
68
70
 
69
- `.npmrc` 已加入 `.gitignore`,不要提交到 Git。也可放在用户目录 `%USERPROFILE%\.npmrc` 供本机所有项目使用。
71
+ 勿在 `packages\cli-dist\.npmrc` 长期保存真实 token。若已泄露,请在 npm Revoke 该 token 并重建。
70
72
 
71
73
  内网 registry:把 `registry=` 和 token 行改成你们私服地址。
72
74
 
@@ -98,7 +100,7 @@ dazi flow project status --dir "项目\flow_xxx\流程\MyFlow"
98
100
 
99
101
  ## 环境变量
100
102
 
101
- | 变量 | 说明 |
102
- |------|------|
103
- | `DAZI_BUNDLED_DIR` | 默认:包内 `dist/clis` |
103
+ | 变量 | 说明 |
104
+ | --------------------- | ------------------------------------------------- |
105
+ | `DAZI_BUNDLED_DIR` | 默认:包内 `dist/clis` |
104
106
  | `DAZI_WORKSPACE_ROOT` | 默认:从 cwd 向上查找含 `scripts/dazi.ps1` 的目录 |
@@ -14907,9 +14907,9 @@ function formatAppCliCommands(opts) {
14907
14907
  if (work) {
14908
14908
  lines.push(
14909
14909
  `# \u5728 dazi-work \u6839\u6267\u884C\uFF08\u63A8\u8350\uFF0C\u81EA\u52A8 bundled CLI\uFF09`,
14910
- `.\\scripts\\dazi.ps1 app manifest validate --cwd ${work.cwdRel} --scan-src`,
14911
- `.\\scripts\\dazi.ps1 app doctor --cwd ${work.cwdRel}`,
14912
- `.\\scripts\\dazi.ps1 app upload --cwd ${work.cwdRel} --space ${opts.spaceId} --activate`
14910
+ `dazi app manifest validate --cwd ${work.cwdRel} --scan-src`,
14911
+ `dazi app doctor --cwd ${work.cwdRel}`,
14912
+ `dazi app upload --cwd ${work.cwdRel} --space ${opts.spaceId} --activate`
14913
14913
  );
14914
14914
  return lines.join("\n");
14915
14915
  }
@@ -14936,8 +14936,8 @@ function buildInitNextSteps(outDir, spaceId, installOk, workspaceRoot) {
14936
14936
  "pnpm run dev",
14937
14937
  "pnpm run build",
14938
14938
  `# \u5728 dazi-work \u6839\uFF1A`,
14939
- `.\\scripts\\dazi.ps1 app doctor --cwd ${work.cwdRel}`,
14940
- `.\\scripts\\dazi.ps1 app upload --cwd ${work.cwdRel} --space ${spaceId} --activate`
14939
+ `dazi app doctor --cwd ${work.cwdRel}`,
14940
+ `dazi app upload --cwd ${work.cwdRel} --space ${spaceId} --activate`
14941
14941
  ];
14942
14942
  }
14943
14943
  return [