@dazitech/cli 3.1.0 → 3.1.1

package/dist/docs/flow/flow-project-guide.md

@@ -1,7 +1,7 @@
 # 数据流程项目开发指南
 
 **文档 ID**: `flow/flow-project-guide`  
-**适用**: `dazi-vscode` v3.1.0+、`dazi-work` 工作区、业务项目 `项目/<业务名>/`
+**适用**: `dazi-vscode` v3.1.1+、`dazi-work` 工作区、业务项目 `项目/<业务名>/`
 
 ---
 

package/dist/docs/guides/cli-reference.md

@@ -22,15 +22,28 @@
 | `dazi prompt list`        | 列出提示词                                         |
 | `dazi prompt show <id>`   | 显示提示词                                         |
 | `dazi prompt sync`        | 同步内置提示词到 `资源/prompts/`                   |
-| `dazi examples list`      | 列出示例脚本                                       |
-| `dazi examples open <id>` | 显示示例内容                                       |
-| `dazi examples sync`      | 同步内置示例到 `资源/examples/`                    |
+| `dazi examples list`      | 列出示例脚本（`--category onto` 过滤本体类）     |
+| `dazi examples show <id>` | 显示示例内容（如 `onto/sales/plan`）               |
+| `dazi examples sync`      | 同步内置示例到 `资源/examples/`（含完整 `onto/` 树） |
+| `dazi examples onto list` | 列出本体完整示例注册表（读 `onto/index.json`）     |
+| `dazi examples onto suggest [关键词]` | 按业务域推荐对照示例（规划前选用）   |
+| `dazi examples onto show <id>` | 显示示例路径；`--plan` / `--readme` 输出全文  |
 | `dazi migrate workspace`  | 迁移工作区                                         |
 | `dazi migrate config`     | 迁移旧配置                                         |
 | `dazi onto <args>`        | 本体 CLI（**勿用** `dazi-onto`）                   |
 | `dazi flow <args>`        | 流程 CLI                                           |
 | `dazi app <args>`         | 应用 CLI（亦可在应用项目根用 `pnpm run dazi-app`） |
 
+**本体规划阶段常用**：
+
+```powershell
+dazi examples sync
+dazi examples onto suggest 设备 OEE
+dazi examples onto show equip-ops --plan
+```
+
+索引真源：`examples/onto/index.yaml`（人工维护）→ `index.json`（`copy:bundled` 时生成）。详见 [本体规划指南](../onto/本体规划指南.md)。
+
 ## 本体（`dazi onto ...`）
 
 | 命令                                                       | 说明             |

package/dist/docs/guides/troubleshooting.md

@@ -84,7 +84,7 @@ dazi doctor --workspace-root D:\path\to\dazi-work
 检查 `.cursor/mcp.json` 配置。MCP 需能调用 bundled CLI，示例：
 
 ```powershell
-$env:DAZI_BUNDLED_DIR = "$env:USERPROFILE\.cursor\extensions\dazitech.dazi-vscode-3.1.0\bundled\clis"
+$env:DAZI_BUNDLED_DIR = "$env:USERPROFILE\.cursor\extensions\dazitech.dazi-vscode-3.1.1\bundled\clis"
 node "$env:DAZI_BUNDLED_DIR\dazi.js" mcp stdio
 ```
 

package/dist/docs/index.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.1.0",
+  "version": "3.1.1",
   "updatedAt": "2026-06-06T12:00:00.000Z",
   "docs": [
     {
@@ -98,18 +98,6 @@
       "category": "onto",
       "file": "onto/本体分类规划与SDK扩展方案.md"
     },
-    {
-      "id": "onto/planning-example-profit",
-      "title": "规划示例：利润分析本体（GL 域）",
-      "category": "onto",
-      "file": "onto/规划示例_利润分析本体方案.md"
-    },
-    {
-      "id": "onto/planning-example-sales",
-      "title": "规划示例：产品销售本体",
-      "category": "onto",
-      "file": "onto/规划示例_产品销售本体规划方案.md"
-    },
     {
       "id": "onto/script-authoring",
       "title": "本体脚本编写指南（含发布）",

package/dist/docs/onto/dazi_script_sdk_reference.md

@@ -239,7 +239,7 @@ dazi onto function run my_func --space <space-id> --params '{}'
 
 **内置参考示例**（在用户工作区：**侧栏 帮助 → 示例 → 下载所有示例**，或执行 `dazi examples sync`，得到 **`资源/examples/`**；可复制到 **`项目/<业务名>/本体/ontos/<实现名>/setup/`** 或 **`functions/`** 再改，勿直接改写同步下来的只读备份）：
 
-- **规划全文（推荐）**：**`资源/docs/onto/规划示例_产品销售本体规划方案.md`**（含表间关系、test_arguments）
+- **规划全文**：`资源/examples/onto/<示例>/plans/*.md`（推荐 `销售示例/plans/规划示例_产品销售本体规划方案.md`）
 - **常见错误**（，**非**通用模板）：`脚本运行常见错误处理.md` 中的已废弃客户路径 — 使用通用占位符
 - **利润示例（GL 域）**：`资源/examples/onto/利润示例/setup/profit_ontology_init.py`、`profit_seed_data.py`、`functions/profit_fn_*.py`、`functions/test_arguments/`
 - **销售示例（推荐，含表间关系 + test_arguments）**：`资源/examples/onto/销售示例/setup/sales_ontology_init.py`、`sales_seed_data.py`、`functions/sales_fn_*.py`

package/dist/docs/onto/dazi_script_seed_data_guide.md

@@ -143,7 +143,7 @@ dazi onto script run --script-id <script-id> --space <space-id> --params '{}'
 
 **参考完整初始化+灌数**：
 
-- **推荐（已落地）**：`资源/examples/onto/销售示例/setup/sales_ontology_init.py`、`sales_seed_data.py`（见 [规划示例_产品销售本体规划方案.md](./规划示例_产品销售本体规划方案.md)）
+- **推荐（已落地）**：`资源/examples/onto/销售示例/setup/sales_ontology_init.py`、`sales_seed_data.py`（规划见同目录 `../plans/规划示例_产品销售本体规划方案.md`）
 - **通用模板**：复制 `资源/examples/onto/利润示例/setup/profit_ontology_init.py` 到 `项目/<业务名>/本体/ontos/<实现名>/setup/` 后按空间改 `space_id` 与表名，再发布执行。
 
 > **已废弃**：`dazi-agent run --file "spaces/.../editorial/..."` — 请改用上表 `dazi onto script publish` / `function run`。

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

@@ -7,8 +7,8 @@
 ## 函数生命周期
 
 ```
-编写 .py → publish-preview（可选）→ publish（--register-function-id 入库）
-  → function run 验证 → save-test-arguments（写入 test_arguments，侧栏预填）
+编写 .py → publish-preview（本地静态预检）→ publish（--register-function-id 入库）
+  → function run 验证（无参回退 TEST_ARGUMENTS）→ save-test-arguments（写入 test_arguments，侧栏预填）
   → 后续改代码：update-code
 ```
 
@@ -56,12 +56,12 @@ PowerShell 下复杂 JSON 建议用环境变量 `DAZI_PARAMS` 或侧栏运行（
 **本地文件**：`functions/test_arguments/<function_id>.json`（格式见 [本体脚本编写指南](./本体脚本编写指南.md)）。
 
 ```bash
-dazi onto function save-test-arguments <ofn_internal_id> \
-  --space <space-id> \
-  --arguments-json-file 项目/<业务名>/本体/ontos/<实现名>/functions/test_arguments/<function_id>.json
+dazi onto function save-test-arguments --function-id domain.fn.my_analysis \
+    --space <space-id> \
+    --arguments-json-file 项目/<业务名>/本体/ontos/<实现名>/functions/test_arguments/<function_id>.json
 ```
 
-> **注意**：须用平台**内部 id** `ofn_xxx`（`dazi onto function list` 返回），不是 `function_id` 字符串。
+> **注意**：亦可用平台**内部 id** `ofn_xxx`（`dazi onto function list --json` 返回）；推荐 `--function-id` 别名。
 
 ## 函数脚本结构（标准模板）
 

package/dist/docs/onto//346/234/254/344/275/223/345/210/206/347/261/273/350/247/204/345/210/222/344/270/216SDK/346/211/251/345/261/225/346/226/271/346/241/210.md

@@ -1,169 +1,169 @@
-# 本体分类规划与 SDK 扩展方案
-
-**文档 ID**：`onto/category-taxonomy-sdk`
-
-> **类型**：规范 + 实施方案（对齐 `ads_categories` 平台分类）  
-> **同步路径**：`dazi docs sync` → `资源/docs/onto/本体分类规划与SDK扩展方案.md`  
-> **前置依据**：[本体命名规范](./本体命名规范_物理表Cube与对象.md)、[本体规划指南](./本体规划指南.md)
-
----
-
-## 1. 目标
-
-将 **规划语义分类**（规划表「类别/分类」列）与 **`ads_categories` 平台分类**（侧栏分组、桥表挂载）打通，支持 init 脚本幂等注册。
-
-> **术语**：下文 **平台标准分类** = 侧栏 `ads_categories` 使用的标准中文名（如「维度表」「总览分析」）。SDK 中的 `category_347`、`ensure_347` 为历史参数/方法名，**含义即平台标准分类**，与文档编号无关。
-
-**约束**：本体规划阶段分类 **全部平级**（挂空间默认根下，不建多层树）。
-
----
-
-## 2. 两类分类，一套语言
-
-| 维度 | 规划语义分类 | ads_categories 平台分类 |
-|------|-------------|------------------------|
-| 作用 | 规划自检、命名约束 | 侧栏展示、资源分组 |
-| 对齐 | 平台 `category_name` **=** 平台标准分类中文名 | 禁止自定义别名 |
-
----
-
-## 3. 平台标准分类字典（6 类资源）
-
-### 3.1 物理表（`category_kind=dataspace_table`）
-
-| 平台分类类别 | 前缀 | 平台分类名 |
-|----------|------|------------|
-| 时间维 | `dim_date` | 时间维 |
-| 维度表 | `dim_` | 维度表 |
-| 事实表 | `fact_` | 事实表 |
-| 桥表 | `bridge_` | 桥表 |
-| 映射表 | `map_` | 映射表 |
-| 配置表 | `cfg_` | 配置表 |
-| 汇总表 | `agg_` | 汇总表 |
-| 临时表 | `tmp_` | 临时表 |
-
-### 3.2 Cube（`category_kind=cube`）
-
-| 平台分类类别 | 平台分类名 |
-|----------|------------|
-| Process | 流程型 |
-| Subject | 主体型 |
-| Comparison | 对比型 |
-| Snapshot | 快照型 |
-
-> 时间增强不单独建 Cube（命名规范 §4.2），不设平台分类。
-
-### 3.3 本体对象（`category_kind=ontology_object_type`）
-
-| 平台分类 | 平台分类名 |
-|----------|------------|
-| Master | 主数据 |
-| Transaction | 事务 |
-| Analytical | 分析 |
-| Reference | 参考 |
-| Configuration | 配置 |
-
-### 3.4 表间关系（`category_kind=relation`，平台扩展）
-
-| 关系类别 | 平台分类名 |
-|----------|------------|
-| 时间关联 | 时间关联 |
-| 主数据关联 | 主数据关联 |
-| 层级自关联 | 层级自关联 |
-| 预实关联 | 预实关联 |
-| 桥接关联 | 桥接关联 |
-
-### 3.5 本体链接（`category_kind=ontology_link_type`，平台扩展）
-
-| 链接类别 | 平台分类名 |
-|----------|------------|
-| 归属/包含 | 归属关系 |
-| 分析归因 | 分析归因 |
-| 层级/结构 | 层级关系 |
-| 对比/映射 | 对比关系 |
-
-### 3.6 本体函数（`category_kind=ontology_function`，平台扩展）
-
-| 函数类别 | 平台分类名 |
-|----------|------------|
-| 总览 | 总览分析 |
-| 趋势 | 趋势分析 |
-| 结构 | 结构分析 |
-| 预实 | 预实分析 |
-| 组织 | 组织分析 |
-
----
-
-## 4. SDK 设计
-
-### 4.1 模块
-
-```python
-s.categories                    # CategoryManager
-s.categories.apply_registry(CATEGORY_REGISTRY)
-s.categories.ensure_347(kind="table", category="维度表")
-s.categories.assign_table("维度表", "dim_account")
-s.categories.auto_assign_tables(["dim_account", "fact_gl_journal_entry"])
-```
-
-### 4.2 分类挂载脚本 `*_category_mount.py`
-
-**方式 A — 批量**（推荐，类灌数）：独立 `setup/*_category_mount.py` 顶部 `CATEGORY_REGISTRY` 与规划 **附录 B** 对齐；在 **init + seed + 全部函数 publish 之后** 执行：
-
-```python
-cat_counts = s.categories.apply_registry(CATEGORY_REGISTRY, skip_missing=True)
-```
-
-**方式 B — 内联**（P2）：各注册 API 支持 `category_347=`，注册后即时挂载（与方式 A 幂等可并存）：
-
-```python
-s.tables.register_with_meta("dim_product", ..., category_347="维度表")
-s.register_cube("SalesCube", ..., category_347="流程型")
-s.onto.define_object_type("Product", "产品", category_347="主数据")
-s.tables.add_relationship(..., category_347="时间关联")
-s.onto.define_link_type(..., category_347="归属关系")
-s.onto.register_function("sales.fn.get_summary", adapter, category_347="总览分析")
-```
-
-函数类资源若 init 未 `register_function`，批量方式须 `skip_missing=True`。
-
----
-
-## 5. 规划与 init 约定
-
-| 产出 | 位置 | 说明 |
-| ---- | ---- | ---- |
-| 规划附录 B | `plans/<主题>.md` | 6 类资源分类对照表 |
-| `CATEGORY_REGISTRY` | `setup/*_category_mount.py` 顶部 | 与附录 B 逐行一致 |
-| 分类步骤 | 流程最后 | publish + run `*_category_mount.py` |
-
-参考：[规划示例_产品销售](./规划示例_产品销售本体规划方案.md#附录-b平台-分类挂载对照表category_registry)、[规划示例_利润分析](./规划示例_利润分析本体方案.md#附录-b平台-分类挂载对照表category_registry)。
-
----
-
-## 6. 验收标准
-
-1. 平台侧栏分类名与平台标准分类表一致
-2. `dim_*` / `fact_*` 自动归入维度表/事实表
-3. init 重跑幂等，桥表不重复
-4. `CATEGORY_REGISTRY` 与规划附录 B 逐行一致
-
----
-
-## 7. 相关文档
-
-| 文档 | 路径（`dazi docs sync` 后） |
-| ---- | --------------------------- |
-| 本体命名规范 | `资源/docs/onto/本体命名规范_物理表Cube与对象.md` |
-| 本体规划指南 | `资源/docs/onto/本体规划指南.md` |
-| SDK 参考 §5.6 | `资源/docs/onto/dazi_script_sdk_reference.md` |
-| 脚本编写指南 | `资源/docs/onto/本体脚本编写指南.md` |
-
----
-
-**变更记录**
-
-| 日期 | 说明 |
-| ---- | ---- |
-| 2026-06-06 | 首版：对齐 平台分类方案 + SDK 设计 |
-| 2026-06-06 | 改为 `dazi-vscode` 完整可同步正文（客户环境不依赖 `dazi/docs/`） |
+# 本体分类规划与 SDK 扩展方案
+
+**文档 ID**：`onto/category-taxonomy-sdk`
+
+> **类型**：规范 + 实施方案（对齐 `ads_categories` 平台分类）  
+> **同步路径**：`dazi docs sync` → `资源/docs/onto/本体分类规划与SDK扩展方案.md`  
+> **前置依据**：[本体命名规范](./本体命名规范_物理表Cube与对象.md)、[本体规划指南](./本体规划指南.md)
+
+---
+
+## 1. 目标
+
+将 **规划语义分类**（规划表「类别/分类」列）与 **`ads_categories` 平台分类**（侧栏分组、桥表挂载）打通，支持 init 脚本幂等注册。
+
+> **术语**：下文 **平台标准分类** = 侧栏 `ads_categories` 使用的标准中文名（如「维度表」「总览分析」）。SDK 中的 `category_347`、`ensure_347` 为历史参数/方法名，**含义即平台标准分类**，与文档编号无关。
+
+**约束**：本体规划阶段分类 **全部平级**（挂空间默认根下，不建多层树）。
+
+---
+
+## 2. 两类分类，一套语言
+
+| 维度 | 规划语义分类 | ads_categories 平台分类 |
+|------|-------------|------------------------|
+| 作用 | 规划自检、命名约束 | 侧栏展示、资源分组 |
+| 对齐 | 平台 `category_name` **=** 平台标准分类中文名 | 禁止自定义别名 |
+
+---
+
+## 3. 平台标准分类字典（6 类资源）
+
+### 3.1 物理表（`category_kind=dataspace_table`）
+
+| 平台分类类别 | 前缀 | 平台分类名 |
+|----------|------|------------|
+| 时间维 | `dim_date` | 时间维 |
+| 维度表 | `dim_` | 维度表 |
+| 事实表 | `fact_` | 事实表 |
+| 桥表 | `bridge_` | 桥表 |
+| 映射表 | `map_` | 映射表 |
+| 配置表 | `cfg_` | 配置表 |
+| 汇总表 | `agg_` | 汇总表 |
+| 临时表 | `tmp_` | 临时表 |
+
+### 3.2 Cube（`category_kind=cube`）
+
+| 平台分类类别 | 平台分类名 |
+|----------|------------|
+| Process | 流程型 |
+| Subject | 主体型 |
+| Comparison | 对比型 |
+| Snapshot | 快照型 |
+
+> 时间增强不单独建 Cube（命名规范 §4.2），不设平台分类。
+
+### 3.3 本体对象（`category_kind=ontology_object_type`）
+
+| 平台分类 | 平台分类名 |
+|----------|------------|
+| Master | 主数据 |
+| Transaction | 事务 |
+| Analytical | 分析 |
+| Reference | 参考 |
+| Configuration | 配置 |
+
+### 3.4 表间关系（`category_kind=relation`，平台扩展）
+
+| 关系类别 | 平台分类名 |
+|----------|------------|
+| 时间关联 | 时间关联 |
+| 主数据关联 | 主数据关联 |
+| 层级自关联 | 层级自关联 |
+| 预实关联 | 预实关联 |
+| 桥接关联 | 桥接关联 |
+
+### 3.5 本体链接（`category_kind=ontology_link_type`，平台扩展）
+
+| 链接类别 | 平台分类名 |
+|----------|------------|
+| 归属/包含 | 归属关系 |
+| 分析归因 | 分析归因 |
+| 层级/结构 | 层级关系 |
+| 对比/映射 | 对比关系 |
+
+### 3.6 本体函数（`category_kind=ontology_function`，平台扩展）
+
+| 函数类别 | 平台分类名 |
+|----------|------------|
+| 总览 | 总览分析 |
+| 趋势 | 趋势分析 |
+| 结构 | 结构分析 |
+| 预实 | 预实分析 |
+| 组织 | 组织分析 |
+
+---
+
+## 4. SDK 设计
+
+### 4.1 模块
+
+```python
+s.categories                    # CategoryManager
+s.categories.apply_registry(CATEGORY_REGISTRY)
+s.categories.ensure_347(kind="table", category="维度表")
+s.categories.assign_table("维度表", "dim_account")
+s.categories.auto_assign_tables(["dim_account", "fact_gl_journal_entry"])
+```
+
+### 4.2 分类挂载脚本 `*_category_mount.py`
+
+**方式 A — 批量**（推荐，类灌数）：独立 `setup/*_category_mount.py` 顶部 `CATEGORY_REGISTRY` 与规划 **附录 B** 对齐；在 **init + seed + 全部函数 publish 之后** 执行：
+
+```python
+cat_counts = s.categories.apply_registry(CATEGORY_REGISTRY, skip_missing=True)
+```
+
+**方式 B — 内联**（P2）：各注册 API 支持 `category_347=`，注册后即时挂载（与方式 A 幂等可并存）：
+
+```python
+s.tables.register_with_meta("dim_product", ..., category_347="维度表")
+s.register_cube("SalesCube", ..., category_347="流程型")
+s.onto.define_object_type("Product", "产品", category_347="主数据")
+s.tables.add_relationship(..., category_347="时间关联")
+s.onto.define_link_type(..., category_347="归属关系")
+s.onto.register_function("sales.fn.get_summary", adapter, category_347="总览分析")
+```
+
+函数类资源若 init 未 `register_function`，批量方式须 `skip_missing=True`。
+
+---
+
+## 5. 规划与 init 约定
+
+| 产出 | 位置 | 说明 |
+| ---- | ---- | ---- |
+| 规划附录 B | `plans/<主题>.md` | 6 类资源分类对照表 |
+| `CATEGORY_REGISTRY` | `setup/*_category_mount.py` 顶部 | 与附录 B 逐行一致 |
+| 分类步骤 | 流程最后 | publish + run `*_category_mount.py` |
+
+参考：`资源/examples/onto/销售示例/plans/`、`利润示例/plans/`、`设备运营/plans/` 各附录 B 与 `setup/*_category_mount.py`。
+
+---
+
+## 6. 验收标准
+
+1. 平台侧栏分类名与平台标准分类表一致
+2. `dim_*` / `fact_*` 自动归入维度表/事实表
+3. init 重跑幂等，桥表不重复
+4. `CATEGORY_REGISTRY` 与规划附录 B 逐行一致
+
+---
+
+## 7. 相关文档
+
+| 文档 | 路径（`dazi docs sync` 后） |
+| ---- | --------------------------- |
+| 本体命名规范 | `资源/docs/onto/本体命名规范_物理表Cube与对象.md` |
+| 本体规划指南 | `资源/docs/onto/本体规划指南.md` |
+| SDK 参考 §5.6 | `资源/docs/onto/dazi_script_sdk_reference.md` |
+| 脚本编写指南 | `资源/docs/onto/本体脚本编写指南.md` |
+
+---
+
+**变更记录**
+
+| 日期 | 说明 |
+| ---- | ---- |
+| 2026-06-06 | 首版：对齐 平台分类方案 + SDK 设计 |
+| 2026-06-06 | 改为 `dazi-vscode` 完整可同步正文（客户环境不依赖 `dazi/docs/`） |

package/dist/docs/onto//346/234/254/344/275/223/345/221/275/345/220/215/350/247/204/350/214/203_/347/211/251/347/220/206/350/241/250Cube/344/270/216/345/257/271/350/261/241.md

@@ -387,8 +387,9 @@ Cube 是 **物理表 → 分析语义 → 本体读模型** 的中间层；命
 | 文档 | 说明 |
 | ---- | ---- |
 | [本体规划指南](./本体规划指南.md) | 规划章节、Cube 强制、自检 |
-| [规划示例：产品销售](./规划示例_产品销售本体规划方案.md) | 完整示例（待按本规范修订表名） |
-| [规划示例：利润分析](./规划示例_利润分析本体方案.md) | GL 域示例（待修订） |
+| [销售示例 plans](../../examples/onto/销售示例/plans/规划示例_产品销售本体规划方案.md) | 完整示例 |
+| [利润示例 plans](../../examples/onto/利润示例/plans/规划示例_利润分析本体方案.md) | GL 域 |
+| [设备运营 plans](../../examples/onto/设备运营/plans/化工设备运营分析本体方案.md) | 设备/OEE |
 | [DaziScript SDK 参考](./dazi_script_sdk_reference.md) | `register_cube`、`define_object_type` API |
 | [本体脚本编写指南](./本体脚本编写指南.md) | init / seed / 表间关系实施 |
 | [本体分类规划与 SDK 扩展方案](./本体分类规划与SDK扩展方案.md) | 平台分类与 CATEGORY_REGISTRY |