@dazitech/cli 3.0.0 → 3.0.1

package/dist/docs/guides/flow-consistency-checklist.md

@@ -0,0 +1,42 @@
+# 流程目录一致性检查表
+
+**文档 ID**: `guides/flow-consistency-checklist`  
+**适用**: 排查「push 无效 / 设计器打不开代码 / flow-exec 少节点」
+
+---
+
+## CLI 一键检查
+
+```powershell
+cd "项目\flow_xxx\流程\<流程名>"
+dazi flow project doctor --dir .
+dazi flow project repair-meta --dir .   # 若 doctor 报错
+```
+
+---
+
+## 手工检查表
+
+| # | 检查项 | 通过标准 |
+|---|--------|----------|
+| 1 | `flow.json` 存在 | 含 `nodes`、`edges` |
+| 2 | `flow.meta.json` 存在 | 含 `flowId`、`nodes` |
+| 3 | 代码节点 uuid 在 meta 中 | 每个 `excel-python` 等有 `dir`+`codeFile` |
+| 4 | meta 条目数 | meta 代码索引数 = flow.json 代码节点数 |
+| 5 | 代码文件存在 | `节点/<名>/code.py` 或 `code.sql` 可读 |
+| 6 | `node.info.json` | pull / repair 后应有（可选但推荐） |
+| 7 | 配置已上平台 | 改配置后执行过 `push --canvas` 且终端有成功提示 |
+| 8 | 代码已上平台 | 改 code 后执行过 `node push` |
+
+---
+
+## 常见症状 → 处理
+
+| 症状 | 处理 |
+|------|------|
+| 设计器打不开代码 | `repair-meta` |
+| `node push` skipped | `repair-meta` |
+| 平台无 managed_file_id | `push --canvas` |
+| flow-exec 只跑开始 | 平台图未更新 → `push --canvas` 后重试 |
+
+详见 [流程本地文件规范](../flow/local-files-spec.md)。

package/dist/docs/guides/mcp-setup.md

@@ -24,53 +24,53 @@
 
 ## 聚合 MCP 工具总览（`mcp stdio`）
 
-运行 `.\scripts\dazi.ps1 mcp tools` 查看完整列表，共 **28 个工具**：
+运行 `dazi mcp tools` 查看完整列表，共 **28 个工具**：
 
 ### 📖 文档与提示词（4 个）
 
-| 工具 | 说明 |
-|------|------|
-| `list_docs` | 列出文档目录（可按分类过滤） |
-| `get_doc` | 获取文档完整内容 |
-| `list_prompts` | 列出提示词目录 |
-| `get_prompt` | 获取提示词完整内容 |
+| 工具           | 说明                         |
+| -------------- | ---------------------------- |
+| `list_docs`    | 列出文档目录（可按分类过滤） |
+| `get_doc`      | 获取文档完整内容             |
+| `list_prompts` | 列出提示词目录               |
+| `get_prompt`   | 获取提示词完整内容           |
 
 ### 🧠 本体 onto（8 个）
 
-| 工具 | 说明 |
-|------|------|
-| `onto_list_spaces` | 列出所有本体空间 |
+| 工具                  | 说明             |
+| --------------------- | ---------------- |
+| `onto_list_spaces`    | 列出所有本体空间 |
 | `onto_list_functions` | 列出空间函数定义 |
-| `onto_get_function` | 查看函数详情 |
-| `onto_run_function` | 执行函数 |
-| `onto_list_actions` | 列出动作定义 |
-| `onto_list_rules` | 列出规则 |
-| `onto_list_scripts` | 列出脚本 |
-| `onto_space_snapshot` | 拉取空间快照 |
+| `onto_get_function`   | 查看函数详情     |
+| `onto_run_function`   | 执行函数         |
+| `onto_list_actions`   | 列出动作定义     |
+| `onto_list_rules`     | 列出规则         |
+| `onto_list_scripts`   | 列出脚本         |
+| `onto_space_snapshot` | 拉取空间快照     |
 
 ### 🔄 流程 flow（9 个）
 
-| 工具 | 说明 |
-|------|------|
-| `flow_list_flows` | 列出 Flow |
-| `flow_get_flow` | 查看 Flow 详情 |
-| `flow_list_runs` | 列出运行记录 |
-| `flow_start_run` | 启动 Flow |
-| `flow_debug_run` | 调试最近 Run |
-| `flow_list_sources` | 列出数据源 |
-| `flow_source_tables` | 列出数据源中的表 |
-| `flow_table_structure` | 查看表列结构 |
-| `flow_snapshot_pull` | 拉取快照 |
-| `flow_plan_llm_guide` | 生成 LLM 引导文档 |
+| 工具                   | 说明              |
+| ---------------------- | ----------------- |
+| `flow_list_flows`      | 列出 Flow         |
+| `flow_get_flow`        | 查看 Flow 详情    |
+| `flow_list_runs`       | 列出运行记录      |
+| `flow_start_run`       | 启动 Flow         |
+| `flow_debug_run`       | 调试最近 Run      |
+| `flow_list_sources`    | 列出数据源        |
+| `flow_source_tables`   | 列出数据源中的表  |
+| `flow_table_structure` | 查看表列结构      |
+| `flow_snapshot_pull`   | 拉取快照          |
+| `flow_plan_llm_guide`  | 生成 LLM 引导文档 |
 
 ### 🗂 数据 data（4 个）
 
-| 工具 | 说明 |
-|------|------|
-| `data_list_spaces` | 列出数据空间 |
-| `data_list_tables` | 列出数据表 |
-| `data_table_schema` | 查看表字段结构 |
-| `data_table_sample` | 采样数据（前 N 行）|
+| 工具                | 说明                |
+| ------------------- | ------------------- |
+| `data_list_spaces`  | 列出数据空间        |
+| `data_list_tables`  | 列出数据表          |
+| `data_table_schema` | 查看表字段结构      |
+| `data_table_sample` | 采样数据（前 N 行） |
 
 ## Cursor 使用示例
 

package/dist/docs/guides/migrate-v2-v3.md

@@ -7,10 +7,11 @@
 ### 第 1 步：预览变更
 
 ```bash
-.\scripts\dazi.ps1 migrate workspace --dry-run
+dazi migrate workspace --dry-run
 ```
 
 输出示例：
+
 ```
 [计划]
   重命名: ontology/ → onto/
@@ -25,7 +26,7 @@
 ### 第 2 步：执行迁移
 
 ```bash
-.\scripts\dazi.ps1 migrate workspace
+dazi migrate workspace
 ```
 
 迁移前会自动备份到 `.dazi/backup/<timestamp>/`。
@@ -33,8 +34,8 @@
 ### 第 3 步：迁移认证
 
 ```bash
-.\scripts\dazi.ps1 auth migrate --dry-run  # 预览
-.\scripts\dazi.ps1 auth migrate            # 执行（从 ~/.dazi-app/auth.json 迁移）
+dazi auth migrate --dry-run  # 预览
+dazi auth migrate            # 执行（从 ~/.dazi-app/auth.json 迁移）
 ```
 
 ## 配置迁移
@@ -42,7 +43,7 @@
 旧版 `daziAgent.*` / `daziApp.*` 配置会在首次激活时自动提示迁移，也可手动执行：
 
 ```bash
-.\scripts\dazi.ps1 migrate config
+dazi migrate config
 ```
 
 ## 回退

package/dist/docs/guides/quickstart.md

@@ -3,7 +3,7 @@
 **文档 ID**: `guides/quickstart`  
 **适用版本**: dazi-vscode v3.0+
 
-> CLI 调用约定见 **[CLI 调用约定](./cli-invocation.md)**。生产环境在 `dazi-work` 根目录使用 `.\scripts\dazi.ps1`。
+> CLI 调用约定见 **[CLI 调用约定](./cli-invocation.md)**。生产环境在 `dazi-work` 根目录使用 `dazi`。
 
 ## 5 分钟完成首次配置
 
@@ -42,27 +42,27 @@ https://your-dazi-server.example.com
 在命令面板（`Ctrl+Shift+P`）搜索 **搭子: 登录**，或终端：
 
 ```powershell
-.\scripts\dazi.ps1 auth login
+dazi auth login
 # 或直接绑定 Token
-.\scripts\dazi.ps1 auth set-token --token "your-jwt-token"
+dazi auth set-token --token "your-jwt-token"
 ```
 
 ### 6. 初始化工作区
 
 ```powershell
 # 新项目（本体空间）
-.\scripts\dazi.ps1 onto space init --space-id <your-space-id>
+dazi onto space init --space-id <your-space-id>
 
 # 已有 v2 项目迁移
-.\scripts\dazi.ps1 migrate workspace
+dazi migrate workspace
 ```
 
 ### 7. 验证环境
 
 ```powershell
-.\scripts\dazi.ps1 doctor
-.\scripts\dazi.ps1 env
-.\scripts\dazi.ps1 auth whoami
+dazi doctor
+dazi env
+dazi auth whoami
 ```
 
 侧栏「搭子」图标应显示 6 个节点：帮助、数据资源、本体、流程、应用、工作区。

package/dist/docs/guides/troubleshooting.md

@@ -2,7 +2,7 @@
 
 **文档 ID**: `guides/troubleshooting`
 
-> 终端命令统一使用 **`dazi-work` 根目录** 下的 `.\scripts\dazi.ps1`（见 [CLI 调用约定](./cli-invocation.md)）。
+> 终端命令统一使用 **`dazi-work` 根目录** 下的 `dazi`（见 [CLI 调用约定](./cli-invocation.md)）。
 
 ## CLI 命令找不到（优先排查）
 
@@ -13,27 +13,27 @@ cd D:\path\to\dazi-work
 
 常见原因：
 
-| 原因 | 处理 |
-|------|------|
-| 未安装 `dazi-vscode.vsix` | 安装扩展后重跑 doctor-cli |
-| **Trae 已装扩展但 doctor 报未安装** | Trae 扩展在 `%USERPROFILE%\.trae\extensions`；更新 `dazi-work/scripts` 后重跑 doctor，或 `.\scripts\sync-clis-from-extension.ps1` |
-| 扩展在但 `bundled/clis/dazi.js` 缺失 | 用完整 `pnpm run vsix` 重打包装；勿用缺 bundled 的旧包 |
-| 直接输入 `dazi` / `dazi-onto` | 改用 `.\scripts\dazi.ps1 ...`（无全局 `dazi-onto`） |
-| 未安装 Node.js 18+ | 安装 Node 并加入 PATH |
+| 原因                                 | 处理                                                                                                                              |
+| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
+| 未安装 `dazi-vscode.vsix`            | 安装扩展后重跑 doctor-cli                                                                                                         |
+| **Trae 已装扩展但 doctor 报未安装**  | Trae 扩展在 `%USERPROFILE%\.trae\extensions`；更新 `dazi-work/scripts` 后重跑 doctor，或 `.\scripts\sync-clis-from-extension.ps1` |
+| 扩展在但 `bundled/clis/dazi.js` 缺失 | 用完整 `pnpm run vsix` 重打包装；勿用缺 bundled 的旧包                                                                            |
+| 直接输入 `dazi` / `dazi-onto`        | 改用 `dazi ...`（无全局 `dazi-onto`）                                                                                             |
+| 未安装 Node.js 18+                   | 安装 Node 并加入 PATH                                                                                                             |
 
 环境详情：
 
 ```powershell
-.\scripts\dazi.ps1 doctor
-.\scripts\dazi.ps1 env
+dazi doctor
+dazi env
 ```
 
 ## 401 未授权
 
 ```powershell
-.\scripts\dazi.ps1 auth whoami
-.\scripts\dazi.ps1 auth login
-.\scripts\dazi.ps1 auth set-token --token "<new-token>"
+dazi auth whoami
+dazi auth login
+dazi auth set-token --token "<new-token>"
 ```
 
 Token 保存在 `~/.dazi/auth.json`，检查是否过期。
@@ -41,24 +41,42 @@ Token 保存在 `~/.dazi/auth.json`，检查是否过期。
 ## 扩展侧栏空白
 
 1. 检查 `dazi.serverUrl` 配置是否正确
-2. 执行 `.\scripts\dazi.ps1 auth whoami` 确认登录状态
+2. 执行 `dazi auth whoami` 确认登录状态
 3. 右键侧栏节点选「刷新」
 
+## 流程：设计器打不开代码 / push 后平台仍旧
+
+```powershell
+cd "项目\flow_xxx\流程\<流程名>"
+dazi flow project doctor --dir .
+dazi flow project repair-meta --dir .
+dazi flow project push --dir . --canvas
+```
+
+| 现象 | 原因 | 处理 |
+|------|------|------|
+| 设计器「打开代码」失败 | `flow.meta.json` 无该 uuid 的 `dir` | `repair-meta` |
+| 改了 `managed_file_id` 平台没有 | 只用了 `project push` 未加 `--canvas` | `push --canvas` |
+| `node push` 无效果 | meta 未索引该节点 | `repair-meta` |
+| 本地 flow.json 对、快速启动写 2 节点 | pull 后手改画布未同步 meta | `repair-meta` |
+
+详见 [流程本地文件规范](../flow/local-files-spec.md)、[一致性检查表](./flow-consistency-checklist.md)。
+
 ## 工作区目录找不到
 
 ```powershell
-.\scripts\dazi.ps1 doctor --workspace-root D:\path\to\dazi-work
+dazi doctor --workspace-root D:\path\to\dazi-work
 ```
 
 或在 VS Code 设置中配置 `dazi.workspaceRoot`。
 
 ## 从 v2 迁移后命令不匹配
 
-| 旧命令 | v3 命令（dazi-work 根目录） |
-|--------|----------------------------|
-| `dazi-agent snapshot refresh` | `.\scripts\dazi.ps1 onto space snapshot` |
-| `dazi-agent function-def list` | `.\scripts\dazi.ps1 onto function list` |
-| `dazi-agent flow snapshot pull` | `.\scripts\dazi.ps1 flow snapshot pull` |
+| 旧命令                          | v3 命令（dazi-work 根目录） |
+| ------------------------------- | --------------------------- |
+| `dazi-agent snapshot refresh`   | `dazi onto space snapshot`  |
+| `dazi-agent function-def list`  | `dazi onto function list`   |
+| `dazi-agent flow snapshot pull` | `dazi flow snapshot pull`   |
 
 ## MCP 连不上
 
@@ -69,7 +87,7 @@ $env:DAZI_BUNDLED_DIR = "$env:USERPROFILE\.cursor\extensions\dazitech.dazi-vscod
 node "$env:DAZI_BUNDLED_DIR\dazi.js" mcp stdio
 ```
 
-或使用 `.\scripts\dazi.ps1 mcp stdio`（在 dazi-work 根目录）。
+或使用 `dazi mcp stdio`（在 dazi-work 根目录）。
 
 ## DRAP：`dazi-app` 找不到
 

package/dist/docs/guides/workspace-v3.md

@@ -21,30 +21,30 @@
 
 ## 目录说明
 
-| 路径 | 对应 CLI | 用途 |
-|------|----------|------|
-| `项目/onto_<名称>/` | `.\scripts\dazi.ps1 onto ...` | 本体规划、脚本、发布 |
-| `项目/app_<名称>/` | `pnpm run dazi-app -- ...`（在应用项目根） | DRAP monorepo；组件在 `apps/<app_id>/` |
-| `项目/app_<名称>/apps/<app_id>/` | 同上 + `--cwd apps/<app_id>` | 单个应用组件源码 |
-| `资源/docs/` | `.\scripts\dazi.ps1 docs ...` | 同步后的内置文档 |
-| `scripts/` | `.\scripts\dazi.ps1 ...` | 本体/流程/鉴权/数据（非 DRAP） |
-| `~/.dazi/auth.json` | 共享 | 登录凭据（扩展与 CLI 共用） |
+| 路径                             | 对应 CLI                                   | 用途                                   |
+| -------------------------------- | ------------------------------------------ | -------------------------------------- |
+| `项目/onto_<名称>/`              | `dazi onto ...`                            | 本体规划、脚本、发布                   |
+| `项目/app_<名称>/`               | `pnpm run dazi-app -- ...`（在应用项目根） | DRAP monorepo；组件在 `apps/<app_id>/` |
+| `项目/app_<名称>/apps/<app_id>/` | 同上 + `--cwd apps/<app_id>`               | 单个应用组件源码                       |
+| `资源/docs/`                     | `dazi docs ...`                            | 同步后的内置文档                       |
+| `scripts/`                       | `dazi ...`                                 | 本体/流程/鉴权/数据（非 DRAP）         |
+| `~/.dazi/auth.json`              | 共享                                       | 登录凭据（扩展与 CLI 共用）            |
 
 ## 扩展侧栏对应
 
-| 侧栏 | 工作区路径 |
-|------|------------|
-| 本体 | `项目/onto_*` |
+| 侧栏     | 工作区路径                                |
+| -------- | ----------------------------------------- |
+| 本体     | `项目/onto_*`                             |
 | App 应用 | `项目/app_*`（monorepo）→ `apps/<app_id>` |
-| 数据资源 | 平台数据空间（非目录） |
+| 数据资源 | 平台数据空间（非目录）                    |
 
 ## v2 → v3 目录映射
 
-| v2 | v3（搭子工作区） |
-|----|----------------|
-| `ontology/` | `项目/onto_*` |
-| `runtime-apps/apps/*` | `项目/app_*/apps/*`（推荐）或 `<ws>/runtime-apps/apps/*`（兼容） |
-| `.dazi-agent/auth.json` | `~/.dazi/auth.json` |
+| v2                      | v3（搭子工作区）                                                 |
+| ----------------------- | ---------------------------------------------------------------- |
+| `ontology/`             | `项目/onto_*`                                                    |
+| `runtime-apps/apps/*`   | `项目/app_*/apps/*`（推荐）或 `<ws>/runtime-apps/apps/*`（兼容） |
+| `.dazi-agent/auth.json` | `~/.dazi/auth.json`                                              |
 
 ## 相关文档
 

package/dist/docs/index.json

@@ -110,12 +110,30 @@
       "category": "onto",
       "file": "onto/dazi_script_seed_data_guide.md"
     },
+    {
+      "id": "flow/local-files-spec",
+      "title": "流程本地文件规范与示例",
+      "category": "flow",
+      "file": "flow/local-files-spec.md"
+    },
+    {
+      "id": "flow/ai-workflow-playbook",
+      "title": "流程项目 AI 工作手册",
+      "category": "flow",
+      "file": "flow/ai-workflow-playbook.md"
+    },
     {
       "id": "flow/flow-project-guide",
       "title": "数据流程项目开发指南",
       "category": "flow",
       "file": "flow/flow-project-guide.md"
     },
+    {
+      "id": "guides/flow-consistency-checklist",
+      "title": "流程目录一致性检查表",
+      "category": "guides",
+      "file": "guides/flow-consistency-checklist.md"
+    },
     {
       "id": "flow/流程开发最佳实践-VS-flow0案例",
       "title": "流程开发最佳实践（VS-flow0 案例）",
@@ -146,12 +164,6 @@
       "category": "flow",
       "file": "flow/run-guide.md"
     },
-    {
-      "id": "flow/snapshot-guide",
-      "title": "Flow 快照管理",
-      "category": "flow",
-      "file": "flow/snapshot-guide.md"
-    },
     {
       "id": "flow/source-guide",
       "title": "数据源管理",

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

@@ -5,6 +5,7 @@
 ## Action 概念
 
 Action 是可被外部系统触发的本体操作，通常用于：
+
 - 写入数据
 - 触发业务流程
 - 执行审批操作
@@ -12,7 +13,7 @@ Action 是可被外部系统触发的本体操作，通常用于：
 ## 列出动作
 
 ```bash
-.\scripts\dazi.ps1 onto action list --space <space-id>
+dazi onto action list --space <space-id>
 ```
 
 ## 发布 Action
@@ -20,7 +21,7 @@ Action 是可被外部系统触发的本体操作，通常用于：
 脚本放在 **`项目/onto_<项目名>/脚本/`**（可与函数脚本同目录，用文件名区分）：
 
 ```bash
-.\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"
@@ -31,7 +32,7 @@ Action 是可被外部系统触发的本体操作，通常用于：
 ## 更新 Action 代码
 
 ```bash
-.\scripts\dazi.ps1 onto action update-code my_action_code \
+dazi onto action update-code my_action_code \
   --space <space-id> \
   --stem my_action
 ```

package/dist/docs/onto/dazi_script_sdk_reference.md

@@ -3,16 +3,16 @@
 **文档 ID**: `onto/dazi-script-sdk-reference`  
 **适用**: dazi-vscode v3 + 搭子平台 DaziScript（ClickHouse 数据空间）
 
-> 给 LLM 与开发者提供精简、可执行的 SDK 规范。脚本目录、类型与 **`.\scripts\dazi.ps1 onto script publish`** 等见 **[本体脚本编写指南](./本体脚本编写指南.md)**。
+> 给 LLM 与开发者提供精简、可执行的 SDK 规范。脚本目录、类型与 **`dazi onto script publish`** 等见 **[本体脚本编写指南](./本体脚本编写指南.md)**。
 
 ## 1. 工作区与脚本放置（dazi-vscode）
 
-| 用途 | 路径 |
-|------|------|
-| **日常开发**（推荐） | `<工作区根>/项目/onto_<项目名>/脚本/*.py` |
-| **空间 ID** | `项目/onto_<项目名>/README.md` 中的数据空间 ID |
-| **参考示例** | `资源/examples/onto/setup/`、`资源/examples/onto/function/`（侧栏 **帮助 → 示例** 或 `.\scripts\dazi.ps1 examples sync`） |
-| **本文档** | `资源/docs/onto/dazi_script_sdk_reference.md`（`.\scripts\dazi.ps1 docs sync` 后） |
+| 用途                 | 路径                                                                                                        |
+| -------------------- | ----------------------------------------------------------------------------------------------------------- |
+| **日常开发**（推荐） | `<工作区根>/项目/onto_<项目名>/脚本/*.py`                                                                   |
+| **空间 ID**          | `项目/onto_<项目名>/README.md` 中的数据空间 ID                                                              |
+| **参考示例**         | `资源/examples/onto/setup/`、`资源/examples/onto/function/`（侧栏 **帮助 → 示例** 或 `dazi examples sync`） |
+| **本文档**           | `资源/docs/onto/dazi_script_sdk_reference.md`（`dazi docs sync` 后）                                        |
 
 - **禁止**将 `onto/<space_id>/editorial/` 作为 v3 本地开发约定（历史路径，仅 CLI `script sync` 可能拉回平台副本）。
 - 脚本入口仅需定义 **`main()`**；平台执行时自动调用，**不要**写 `if __name__ == "__main__":`。
@@ -23,7 +23,7 @@
 - 新建空间须显式指定（若脚本内创建空间）：
   - `storage_engine="clickhouse"`
   - `connection_config={"database": "<db_name>"}`
-- 执行前确认已登录（`.\scripts\dazi.ps1 auth whoami`）且 `dazi.serverUrl` 正确。
+- 执行前确认已登录（`dazi auth whoami`）且 `dazi.serverUrl` 正确。
 
 ## 3. 顶层对象与推荐调用
 
@@ -66,7 +66,13 @@
   "updated": [],
   "skipped": [],
   "errors": [],
-  "summary": { "requested": 0, "created": 0, "updated": 0, "skipped": 0, "errors": 0 }
+  "summary": {
+    "requested": 0,
+    "created": 0,
+    "updated": 0,
+    "skipped": 0,
+    "errors": 0
+  }
 }
 ```
 
@@ -140,18 +146,18 @@
 
 ```bash
 # 预检
-.\scripts\dazi.ps1 onto script publish-preview 项目/onto_<项目名>/脚本/my_setup.py --space <space-id>
+dazi onto script publish-preview 项目/onto_<项目名>/脚本/my_setup.py --space <space-id>
 
 # 发布（初始化/灌数类脚本）
-.\scripts\dazi.ps1 onto script publish 项目/onto_<项目名>/脚本/my_setup.py --space <space-id>
+dazi onto script publish 项目/onto_<项目名>/脚本/my_setup.py --space <space-id>
 
 # 发布并注册为本体函数
-.\scripts\dazi.ps1 onto script publish 项目/onto_<项目名>/脚本/my_func.py \
+dazi onto script publish 项目/onto_<项目名>/脚本/my_func.py \
   --space <space-id> \
   --register-function-id my_func
 
 # 运行已入库函数
-.\scripts\dazi.ps1 onto function run my_func --space <space-id> --params '{}'
+dazi onto function run my_func --space <space-id> --params '{}'
 ```
 
 亦可用侧栏 **Onto 本体** → 发布函数 / 运行函数。
@@ -162,7 +168,7 @@
 - 非 0 退出码即失败
 - 会改写数据的步骤须提供跳过/禁用开关
 
-**内置参考示例**（在用户工作区：**侧栏 帮助 → 示例 → 下载所有示例**，或执行 `.\scripts\dazi.ps1 examples sync`，得到 **`资源/examples/`**；可复制到 **`项目/<onto_项目名>/脚本/`** 再改，勿直接改写同步下来的只读备份）：
+**内置参考示例**（在用户工作区：**侧栏 帮助 → 示例 → 下载所有示例**，或执行 `dazi examples sync`，得到 **`资源/examples/`**；可复制到 **`项目/<onto_项目名>/脚本/`** 再改，勿直接改写同步下来的只读备份）：
 
 - 初始化：**`<工作区根>/资源/examples/onto/setup/profit_ontology_init.py`**
 - 函数样例：**`<工作区根>/资源/examples/onto/function/profit_fn_*.py`**

package/dist/docs/onto/dazi_script_seed_data_guide.md

@@ -14,13 +14,13 @@
 
 ### 1.1 放置位置（v3）
 
-| 类型 | 推荐路径 |
-|------|----------|
-| **项目内开发** | `<工作区根>/项目/onto_<项目名>/脚本/<名称>.py` |
-| **参考示例** | `资源/examples/onto/setup/`（初始化+灌数一体）、`资源/examples/onto/function/`（分析函数，非灌数专篇） |
+| 类型           | 推荐路径                                                                                               |
+| -------------- | ------------------------------------------------------------------------------------------------------ |
+| **项目内开发** | `<工作区根>/项目/onto_<项目名>/脚本/<名称>.py`                                                         |
+| **参考示例**   | `资源/examples/onto/setup/`（初始化+灌数一体）、`资源/examples/onto/function/`（分析函数，非灌数专篇） |
 
 - `space_id` 以 **`项目/onto_<项目名>/README.md`** 为准（扩展「新建项目」时已绑定）。
-- 侧栏 **帮助 → 📎 示例 → 下载所有示例**，或：`.\scripts\dazi.ps1 examples sync` → `资源/examples/`。
+- 侧栏 **帮助 → 📎 示例 → 下载所有示例**，或：`dazi examples sync` → `资源/examples/`。
 - 须定义 **`main()`**，**不要**写 `if __name__ == "__main__":`。
 
 > 不再使用 `spaces/<space_id>/editorial/scripts/setup/` 作为 v3 本地约定路径。
@@ -53,11 +53,11 @@
 
 ## 3. 推荐模式对照
 
-| 场景 | 推荐做法 |
-|------|----------|
-| 少量固定行 | 单条 `INSERT ... VALUES`，元组间**无**行间 `--`；或拆多条 `INSERT` |
-| 多批次、多行 | **`s.sql.insert_rows`** + Python 生成 `list[dict]` |
-| 需读 SQL 文件 | 注释写在 **INSERT 块上方**（Python 侧），不要塞进 `VALUES` 中间 |
+| 场景          | 推荐做法                                                           |
+| ------------- | ------------------------------------------------------------------ |
+| 少量固定行    | 单条 `INSERT ... VALUES`，元组间**无**行间 `--`；或拆多条 `INSERT` |
+| 多批次、多行  | **`s.sql.insert_rows`** + Python 生成 `list[dict]`                 |
+| 需读 SQL 文件 | 注释写在 **INSERT 块上方**（Python 侧），不要塞进 `VALUES` 中间    |
 
 ---
 
@@ -132,18 +132,18 @@ def main():
 
 ```bash
 # 预检
-.\scripts\dazi.ps1 onto script publish-preview 项目/onto_<项目名>/脚本/demo_seed.py --space <space-id>
+dazi onto script publish-preview 项目/onto_<项目名>/脚本/demo_seed.py --space <space-id>
 
 # 发布到平台（data_script / 初始化脚本）
-.\scripts\dazi.ps1 onto script publish 项目/onto_<项目名>/脚本/demo_seed.py --space <space-id>
+dazi onto script publish 项目/onto_<项目名>/脚本/demo_seed.py --space <space-id>
 
 # 若已入库且已知 script-id，可在平台侧执行；或通过 Onto 侧栏运行
-.\scripts\dazi.ps1 onto script run --script-id <script-id> --space <space-id> --params '{}'
+dazi onto script run --script-id <script-id> --space <space-id> --params '{}'
 ```
 
 **参考完整初始化+灌数**：复制 `资源/examples/onto/setup/profit_ontology_init.py` 到 `项目/.../脚本/` 后按空间改 `space_id` 与表名，再发布执行。
 
-> **已废弃**：`dazi-agent run --file "spaces/.../editorial/..."` — 请改用上表 `.\scripts\dazi.ps1 onto script publish` / `function run`。
+> **已废弃**：`dazi-agent run --file "spaces/.../editorial/..."` — 请改用上表 `dazi onto script publish` / `function run`。
 
 ---
 

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

@@ -12,7 +12,7 @@
 
 ```bash
 # 发布新函数（路径指向本体项目 脚本/ 目录）
-.\scripts\dazi.ps1 onto function publish 项目/onto_<项目名>/脚本/my_func.py \
+dazi onto function publish 项目/onto_<项目名>/脚本/my_func.py \
   --space <space-id> \
   --function-id my_function \
   --display-name "我的函数" \
@@ -22,7 +22,7 @@
 或使用 `script publish`（等价，见 [本体脚本编写指南](./本体脚本编写指南.md)）：
 
 ```bash
-.\scripts\dazi.ps1 onto script publish 项目/onto_<项目名>/脚本/my_func.py \
+dazi onto script publish 项目/onto_<项目名>/脚本/my_func.py \
   --space <space-id> \
   --register-function-id my_function
 ```
@@ -33,7 +33,7 @@
 
 ```bash
 # 用工作副本快速更新（不做完整 publish 流程）
-.\scripts\dazi.ps1 onto function update-code <function-id> \
+dazi onto function update-code <function-id> \
   --space <space-id> \
   --stem my_func
 ```
@@ -43,7 +43,7 @@
 ## 运行函数
 
 ```bash
-.\scripts\dazi.ps1 onto function run <function-id> \
+dazi onto function run <function-id> \
   --space <space-id> \
   --params '{"key": "value"}'
 ```
@@ -51,7 +51,7 @@
 ## 保存测试参数
 
 ```bash
-.\scripts\dazi.ps1 onto function save-test-arguments <function-id> \
+dazi onto function save-test-arguments <function-id> \
   --space <space-id> \
   --params '{"test_param": 42}'
 ```