@dazitech/cli 3.1.0 → 3.1.1

package/dist/prompts/index.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.1.0",
+  "version": "3.1.1",
   "updatedAt": "2026-06-05T00:00:00.000Z",
   "prompts": [
     {

package/dist/prompts/onto/planning-design.md

@@ -1,104 +1,226 @@
-# 本体规划设计（TRAE / 智能体）
-
-**文档 ID**: `onto/planning-design`  
-**场景**: 新建本体实现、撰写 `plans/` 规划、能力评估（**默认任务模式**）  
-**前置**: 已打开本体实现单元；`README.md` / `快速启动_*.md` 中有 `space_id`
-
----
-
-## 0. 任务边界（强制）
-
-本提示词用于 **规划阶段**，产出仅为 **`plans/<主题>.md`**（及自检附录）。
-
-| 允许 | 禁止（未获用户明确要求「快速 demo」前） |
-| ---- | ---------------------------------------- |
-| 阅读 `资源/docs/onto/规划示例_*.md` **学结构** | 复制 `资源/examples/onto/**/setup/*.py` 到本项目 |
-| 阅读 `本体规划指南.md`、`本体命名规范_*.md` | 复制 `项目/*/本体/ontos/*` 整目录到其他实现 |
-| 在 `plans/` **独立撰写**业务方案 | 把规划示例全文另存为 `plans/` |
-| 对照侧栏 **数据资源** 了解现网表/Cube | `dazi onto script publish` / 写 `setup/`、`functions/` |
-
-**用户说「创建/设计本体方案」** → 先规划，**不是**先复制 init。
-
----
-
-## 1. 开始前读取
-
-1. `项目/<业务>/本体/ontos/<实现名>/README.md` — **space_id**
-2. `快速启动_<实现名>.md` — §0 任务模式、§2 域路由表
-3. `dazi docs sync` 后：`资源/docs/onto/本体规划指南.md`
-
-```powershell
-dazi doctor
-dazi auth whoami
-dazi onto space get <space-id>   # 可选：现网资产
-```
-
----
-
-## 2. 业务域路由（只读参照）
-
-| 用户意图关键词 | 只读对照规划 | 勿混用 |
-| -------------- | ------------ | ------ |
-| 销售、订单、产品、渠道、SKU | `规划示例_产品销售本体规划方案.md` | 利润 GL 表结构 |
-| 利润、科目、预算、GL、成本中心、预实 | `规划示例_利润分析本体方案.md` | 销售订单事实表 |
-
-规划示例是 **参照答案**，须结合本实现的业务背景 **重写**，并写 **「与参照示例的差异说明」** 章节。
-
----
-
-## 3. 规划方法（业务世界 → 三层）
-
-**顺序**：对象类型 + 链接（业务语言）→ 反推物理表 + 表间关系 → Cube 读模型 → 函数清单。
-
-每层须 **独立成章**（见规划指南标准结构）：
-
-| 章节 | 必填要点 |
-| ---- | -------- |
-| 业务场景 | 域边界、分析问题、空间约束 |
-| 物理层 | `dim_date` + `fact_*` 含 `date_key`；表/列 **显示名+说明** |
-| 表间关系 | 从事实到维表；`join_keys`；与本体链接对照 |
-| **Cube 层** | 每 Cube：类别、事实源、维度、度量、派生度量、支撑对象 |
-| 本体层 | 对象 `code`、分类、bind_source、属性、链接 |
-| 函数 | function_id、参数、返回值、test_arguments |
-| 差异说明 | 与所选规划示例的业务/表/Cube/对象差异 |
-| 附录 B | CATEGORY_REGISTRY 对照（平台分类） |
-
----
-
-## 4. 产出路径
-
-```
-项目/<业务>/本体/ontos/<实现名>/plans/<主题>.md
-```
-
-定稿前勾选 [规划完整性自检清单](资源/docs/onto/本体规划指南.md)（含 Cube 层、6a–6e 分类）。
-
-规划阶段 **不** 创建或发布 `setup/`、`functions/` 脚本。
-
----
-
-## 5. 反模式（视为不合格）
-
-- `plans/` 为空即开始写 init
-- 表名/Cube/对象与规划示例 **逐字相同** 且无差异说明
-- 利润域任务却使用销售域 `fact_sales_order_line` 等且无业务论证
-- 复制潘达石化或其他 `项目/` 下历史实现充数
-- 规划缺 **Cube 独立章节**（仅表+对象+函数）
-
----
-
-## 6. 进入实施
-
-规划定稿且用户确认后，切换提示词 **`onto/script-publish-run`**，按 `plans/` 实现 `setup/`、`functions/`。
-
-实施顺序：**init → seed → 发布全部函数 → `*_category_mount.py`**（类灌数，含附录 B 全量六类）。可选：各 publish 带 `--register-platform-category` 与 category_mount 幂等并存。
-
----
-
-## 7. 相关文档
-
-- `onto/本体规划指南.md`
-- `onto/规划示例_产品销售本体规划方案.md`
-- `onto/规划示例_利润分析本体方案.md`
-- `onto/本体命名规范_物理表Cube与对象.md`
-- `onto/本体分类规划与SDK扩展方案.md`
+# 本体规划设计（TRAE / 智能体）
+
+
+
+**文档 ID**: `onto/planning-design`  
+
+**场景**: 新建本体实现、撰写 `plans/` 规划、能力评估（**默认任务模式**）  
+
+**前置**: 已打开本体实现单元；`README.md` / `快速启动_*.md` 中有 `space_id`
+
+
+
+---
+
+
+
+## 0. 任务边界（强制）
+
+
+
+本提示词用于 **规划阶段**，产出仅为 **`plans/<主题>.md`**（及自检附录）。
+
+
+
+| 允许 | 禁止（未获用户明确要求「快速 demo」前） |
+
+| ---- | ---------------------------------------- |
+
+| 阅读 `资源/examples/onto/<示例>/plans/*.md` **学结构** | 复制 `资源/examples/onto/**/setup/*.py` 到本项目 |
+
+| 阅读 `本体规划指南.md`、`本体命名规范_*.md` | 复制 `项目/*/本体/ontos/*` 整目录到其他实现 |
+
+| 在 `plans/` **独立撰写**业务方案 | 把示例 `plans/*.md` **全文**另存为 `plans/` |
+
+| 对照侧栏 **数据资源** 了解现网表/Cube | `dazi onto script publish` / 写 `setup/`、`functions/` |
+
+
+
+**用户说「创建/设计本体方案」** → 先规划，**不是**先复制 init。
+
+
+
+---
+
+
+
+## 1. 开始前读取
+
+
+
+1. `项目/<业务>/本体/ontos/<实现名>/README.md` — **space_id**
+
+2. `快速启动_<实现名>.md` — §0 任务模式、§2 示例参照表
+
+3. `dazi docs sync` 后：`资源/docs/onto/本体规划指南.md`
+
+4. **`dazi examples sync` 后**：`资源/examples/onto/index.json` + **至少一个**示例的 `README.md` + `plans/*.md`
+
+
+
+```powershell
+
+dazi doctor
+
+dazi auth whoami
+
+dazi examples sync
+
+dazi examples onto list
+
+dazi examples onto suggest 利润 GL
+
+dazi examples onto show profit --plan   # 可选：输出规划全文
+
+dazi onto space get <space-id>   # 可选：现网资产
+
+```
+
+
+
+---
+
+
+
+## 2. 业务域路由（只读参照）
+
+
+
+完整索引：`资源/examples/onto/index.json`（`dazi examples onto list`）。下表为常用路由（规划正文均在各示例 **`plans/`** 下）：
+
+
+
+| 用户意图关键词 | 对照示例目录 | 规划正文（plans/） |
+
+| -------------- | ------------ | ------------------ |
+
+| 销售、订单、产品、渠道、SKU | `销售示例/` | `规划示例_产品销售本体规划方案.md` |
+
+| 利润、科目、预算、GL、成本中心、预实 | `利润示例/` | `规划示例_利润分析本体方案.md` |
+
+| 设备、OEE、停机、维保、能耗、工厂 | `设备运营/` | `化工设备运营分析本体方案.md` |
+
+
+
+示例是 **参照答案**，须结合本实现 **重写**，并写 **「与参照示例的差异说明」** 章节。
+
+
+
+---
+
+
+
+## 3. 规划方法（业务世界 → 三层）
+
+
+
+**顺序**：对象类型 + 链接（业务语言）→ 反推物理表 + 表间关系 → Cube 读模型 → 函数清单。
+
+
+
+每层须 **独立成章**（见规划指南标准结构）：
+
+
+
+| 章节 | 必填要点 |
+
+| ---- | -------- |
+
+| 业务场景 | 域边界、分析问题、空间约束 |
+
+| 物理层 | `dim_date` + `fact_*` 含 `date_key`；表/列 **显示名+说明** |
+
+| 表间关系 | 从事实到维表；`join_keys`；与本体链接对照 |
+
+| **Cube 层** | 每 Cube：类别、事实源、维度、度量、派生度量、支撑对象 |
+
+| 本体层 | 对象 `code`、分类、bind_source、属性、链接 |
+
+| 函数 | function_id、参数、返回值、test_arguments |
+
+| 差异说明 | 与所选示例的业务/表/Cube/对象差异 |
+
+| 附录 B | CATEGORY_REGISTRY 对照（平台分类） |
+
+
+
+---
+
+
+
+## 4. 产出路径
+
+
+
+```
+
+项目/<业务>/本体/ontos/<实现名>/plans/<主题>.md
+
+```
+
+
+
+定稿前勾选 [规划完整性自检清单](资源/docs/onto/本体规划指南.md)（含 Cube 层、6a–6e 分类）。
+
+
+
+规划阶段 **不** 创建或发布 `setup/`、`functions/` 脚本。
+
+
+
+---
+
+
+
+## 5. 反模式（视为不合格）
+
+
+
+- `plans/` 为空即开始写 init
+
+- 表名/Cube/对象与示例 **逐字相同** 且无差异说明
+
+- 利润域任务却使用销售域 `fact_sales_order_line` 等且无业务论证
+
+- 复制潘达石化或其他 `项目/` 下历史实现充数
+
+- 规划缺 **Cube 独立章节**（仅表+对象+函数）
+
+- 只读 `docs/onto/` 旧路径而不打开 `examples/onto/*/plans/` 正文
+
+
+
+---
+
+
+
+## 6. 进入实施
+
+
+
+规划定稿且用户确认后，切换提示词 **`onto/script-publish-run`**，按 `plans/` 实现 `setup/`、`functions/`。
+
+
+
+实施顺序：**init → seed → 发布全部函数 → `*_category_mount.py`**（类灌数，含附录 B 全量六类）。可选：各 publish 带 `--register-platform-category` 与 category_mount 幂等并存。
+
+
+
+---
+
+
+
+## 7. 相关文档
+
+
+
+- `onto/本体规划指南.md`
+
+- `资源/examples/onto/README.md`（完整示例总览）
+
+- `资源/examples/onto/index.json`（示例索引 · `dazi examples onto suggest`）
+
+- `onto/本体命名规范_物理表Cube与对象.md`
+
+- `onto/本体分类规划与SDK扩展方案.md`
+

package/dist/prompts/onto/script-publish-run.md

@@ -18,7 +18,7 @@
 
 - **`资源/docs/onto/脚本运行常见错误处理.md`**（`dazi docs show onto/script-run-troubleshooting`）
 
-重点：setup API 勿猜方法名；多列聚合用 `query()` 勿误用 `query_one()`；**本体函数 `main()` 须 `return _ontology_fn_body(p)`，禁止 `output.print_json()`**；`function run` **不支持** `--arguments-json-file`；`save-test-arguments` 须 **`ofn_xxx` 内部 id**。
+重点：setup API 勿猜方法名；**无 bind_source 禁止 define_property**（见错误处理 §1.1）；多列聚合用 `query()` 勿误用 `query_one()`；**本体函数 `main()` 须 `return _ontology_fn_body(p)`，禁止 `output.print_json()`**；`function run` 无 `--params` 时**回退 TEST_ARGUMENTS**；`save-test-arguments` 推荐 **`--function-id`**；publish-preview 含静态预检。
 
 ## 强制规则（违反会导致 CommandNotFound 或 404）
 
@@ -143,9 +143,9 @@ dazi onto script run --file <项目路径>/setup/xxx_seed_data.py --space <空
 dazi onto function run <function_id> --space <空间>
 ```
 
-> **`function run` 不支持 `--arguments-json-file`**。须先用 §7 `save-test-arguments` 写入默认参数，再不带 JSON 文件运行。误用示例见 `资源/docs/onto/脚本运行常见错误处理.md`（`onto/script-run-troubleshooting`）。
+> **无 `--params` 时**：CLI 自动回退已保存 `test_arguments`，否则脚本内 `TEST_ARGUMENTS.arguments`。推荐顺序：**publish → run 验证 → save-test-arguments**（侧栏预填）。详见 `onto/script-run-troubleshooting` §4.1。
 
-PowerShell 传 JSON 参数易丢引号；可省略 `--params` 使用函数默认，或：
+PowerShell 显式传参：
 
 ```powershell
 $env:DAZI_PARAMS='{"start_date":"2025-01-01","end_date":"2026-12-31"}'
@@ -165,17 +165,19 @@ dazi onto function run <function_id> --space <空间> --params $env:DAZI_PARAMS
 **保存到平台**（`function run` 验证通过后）：
 
 ```powershell
-# 推荐：批量脚本（解析 function list，用内部 id ofn_xxx 调用 PATCH）
+# 推荐：批量脚本（使用 --function-id）
 .\<项目路径>\functions\save_test_arguments.ps1
 ```
 
-单条保存（**须用平台内部 id `ofn_xxx`**，先 `dazi onto function list --space <空间>` 查看；直接传 `sales.fn.xxx` 等 function_id 字符串可能 **404**）：
+单条保存（**推荐 `--function-id`**，亦可用 `ofn_xxx`）：
 
 ```powershell
-dazi onto function save-test-arguments <ofn_internal_id> --space <空间> `
+dazi onto function save-test-arguments --function-id <domain>.fn.<name> --space <空间> `
   --arguments-json-file <项目路径>/functions/test_arguments/<function_id>.json
 ```
 
+全部函数 publish 后，可运行 `onto_preflight.ps1`（模板见 `资源/examples/onto/_templates/`）核对文件数与静态预检。
+
 验收：
 
 ```powershell

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dazitech/cli",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "搭子 v3 命令行工具（Onto / Flow / App），与 dazi-vscode 同版本",
   "license": "MIT",
   "engines": {