@dazitech/cli 3.1.0 → 3.1.1

package/dist/docs/onto//346/234/254/344/275/223/350/247/204/345/210/222/346/214/207/345/215/227.md

@@ -86,7 +86,7 @@
 
 **字段表**建议列：`字段名 | 类型 | 显示名 | 说明`（原单列「说明」若混有 FK/PK 标记，拆到 **说明** 列；**显示名** 写面向用户的短标签）。
 
-init 脚本在 `setup/*_ontology_init.py` 顶部维护 `TABLE_REGISTRY`，与规划 **一一对应**。内置参考：`资源/examples/onto/利润示例`、`销售示例` 的 init 与 `资源/docs/onto/规划示例_*.md`；详见 [本体脚本编写指南 §表注册](./本体脚本编写指南.md#表注册-table_registry--register_with_meta)。
+init 脚本在 `setup/*_ontology_init.py` 顶部维护 `TABLE_REGISTRY`，与规划 **一一对应**。内置完整示例位于 **`资源/examples/onto/<示例名>/`**（规划在 `plans/`，脚本在 `setup/`、`functions/`）；索引见 `index.yaml` / `index.json`、总览见 `README.md`（`dazi examples sync`）。规划前可用 **`dazi examples onto suggest <关键词>`** 选对照示例。详见 [本体脚本编写指南 §表注册](./本体脚本编写指南.md#表注册-table_registry--register_with_meta)。
 
 ## 平台分类（平台分类对齐 · 强制）
 
@@ -114,7 +114,7 @@ init 脚本在 `setup/*_ontology_init.py` 顶部维护 `TABLE_REGISTRY`，与规
 | 链接 | — | 归属关系 / 分析归因 / 层级关系 / 对比关系 |
 | 函数 | — | 总览分析 / 趋势分析 / 结构分析 / 预实分析 / 组织分析 |
 
-参考附录 B：[规划示例_产品销售](./规划示例_产品销售本体规划方案.md#附录-b平台-分类挂载对照表category_registry)、[规划示例_利润分析](./规划示例_利润分析本体方案.md#附录-b平台-分类挂载对照表category_registry)。
+参考附录 B：各示例 `plans/*.md` 附录 B，与同目录 `setup/*_category_mount.py` 一致。路径示例：`资源/examples/onto/销售示例/plans/…`、`利润示例/plans/…`、`设备运营/plans/…`。
 
 ## 规划文档标准结构（建议章节）
 
@@ -134,7 +134,7 @@ init 脚本在 `setup/*_ontology_init.py` 顶部维护 `TABLE_REGISTRY`，与规
 | **附录 B：平台分类挂载对照** | `CATEGORY_REGISTRY` 与 `*_category_mount.py` 一致 |
 | **附录：规划完整性自检清单** | 见本文 [§规划文档完整性自检清单](#规划文档完整性自检清单) |
 
-参考全文结构：[规划示例_产品销售本体规划方案.md](./规划示例_产品销售本体规划方案.md)、[规划示例_利润分析本体方案.md](./规划示例_利润分析本体方案.md)。
+参考全文结构：`资源/examples/onto/` 下各示例的 `plans/*.md`（推荐 [销售示例 plans](../../examples/onto/销售示例/plans/规划示例_产品销售本体规划方案.md) 或 [设备运营 plans](../../examples/onto/设备运营/plans/化工设备运营分析本体方案.md)）。CLI：`dazi examples onto show sales --plan`。
 
 ## Cube 层设计（强制独立章节）
 
@@ -157,11 +157,10 @@ Cube 是 **表 → 分析语义 → 本体读模型** 的中间层。规划阶
 
 ## 必读文档
 
-1. **本体规划示例（推荐）**：[`规划示例_产品销售本体规划方案.md`](./规划示例_产品销售本体规划方案.md) — 含表间关系、test_arguments 与完整脚本对照（`dazi docs sync` 后位于 `资源/docs/onto/`）
-2. **本体命名规范**：[`本体命名规范_物理表Cube与对象.md`](./本体命名规范_物理表Cube与对象.md)（`onto/naming-conventions`）— 物理表前缀、`dim_date`、Cube 类别、对象 Palantir 式分类
-3. **补充示例**：[`规划示例_利润分析本体方案.md`](./规划示例_利润分析本体方案.md) — 利润分析域参考
-4. **工作区与 CLI**：`guides/workspace-v3.md`、`guides/cli-reference.md`（`dazi docs sync` 后位于 `资源/docs/guides/`）
-5. **可运行脚本示例**：`资源/examples/onto/销售示例/`（推荐）、`资源/examples/onto/利润示例/`（`dazi examples sync` 或侧栏 **帮助 → 示例**）
+1. **内置本体示例（规划 + 脚本，至少读一个）**：`资源/examples/onto/` — `dazi examples sync` 或侧栏 **帮助 → 示例**；索引 `index.json`（`dazi examples onto list`）、总览 `README.md`。每个子目录含 `plans/`、`setup/`、`functions/`，与业务 `ontos/<实现>/` 同构。
+2. **本体命名规范**：[`本体命名规范_物理表Cube与对象.md`](./本体命名规范_物理表Cube与对象.md)（`onto/naming-conventions`）
+3. **工作区与 CLI**：`guides/workspace-v3.md`、`guides/cli-reference.md`
+4. **规范指南（无案例正文）**：本文、[本体脚本编写指南](./本体脚本编写指南.md)、[脚本运行常见错误处理](./脚本运行常见错误处理.md)
 
 ## 产出约定
 
@@ -195,7 +194,8 @@ Cube 是 **表 → 分析语义 → 本体读模型** 的中间层。规划阶
         setup/                      ← 初始化 / 灌数脚本
         functions/                  ← 本体函数 / 动作脚本
           test_arguments/           ← 各 function_id 的 test_arguments JSON（与 .py 内 TEST_ARGUMENTS 同步）
-  资源/docs/onto/                   ← 本体指南与规划示例（dazi docs sync）
+  资源/docs/onto/                   ← 规范指南（规划示例正文已迁至 examples/onto）
+  资源/examples/onto/               ← ★ 完整本体示例（plans + setup + functions）
   资源/dataspaces/                  ← 侧栏下载的表结构 Markdown
 ```
 
@@ -212,6 +212,9 @@ Cube 是 **表 → 分析语义 → 本体读模型** 的中间层。规划阶
 dazi doctor
 dazi auth whoami
 dazi docs sync    # 可选：同步帮助文档到 资源/docs/
+dazi examples sync   # 同步完整示例到 资源/examples/
+dazi examples onto suggest 销售   # 按关键词推荐对照示例（可选）
+dazi examples onto show sales --plan   # 输出规划全文（可选）
 ```
 
 **核对数据空间与现网资产**（`<space_id>` 取自当前实现单元的 `README.md`，勿另猜目录）：
@@ -232,7 +235,7 @@ dazi onto space get <space_id>    # 可选：查看空间详情
 
 > 规划阶段**不**要求本地 `snapshot.json`、`editorial/` 或 `onto/<space_id>/` 目录；以侧栏 **数据资源** 与项目内文档为准即可。
 
-规划阶段 **只产出 Markdown**：写入 **`项目/<业务名>/本体/ontos/<实现名>/plans/<主题>.md`**，**首选参考** [`规划示例_产品销售本体规划方案.md`](./规划示例_产品销售本体规划方案.md)。此阶段不发布脚本。
+规划阶段 **只产出 Markdown**：写入 **`项目/<业务名>/本体/ontos/<实现名>/plans/<主题>.md`**。**须至少阅读一个** `资源/examples/onto/<示例>/` 的 `README.md` + `plans/*.md` 学结构（`dazi examples onto suggest <关键词>` 或见 `index.json` 域路由）。此阶段不发布脚本。
 
 **定稿门槛**：对照 [§规划文档完整性自检清单](#规划文档完整性自检清单)，**尤其第 4 项 Cube 层**；未通过不得进入脚本实施。
 
@@ -297,8 +300,6 @@ dazi onto function run <function_id> --space <space_id> --params '{}'
 ## 相关文档
 
 - [本体脚本编写指南](./本体脚本编写指南.md)
-- [本体规划指南](./本体规划指南.md)
-- [规划示例：产品销售本体（推荐）](./规划示例_产品销售本体规划方案.md)
-- [规划示例：利润分析本体（补充）](./规划示例_利润分析本体方案.md)
+- [内置示例总览](../../examples/onto/README.md)（`资源/examples/onto/`）
 - [本体分类规划与 SDK 扩展方案](./本体分类规划与SDK扩展方案.md)
 - [脚本运行常见错误处理](./脚本运行常见错误处理.md)

package/dist/docs/onto//350/204/232/346/234/254/350/277/220/350/241/214/345/270/270/350/247/201/351/224/231/350/257/257/345/244/204/347/220/206.md

@@ -19,9 +19,43 @@
 | `bind_source(source_type=..., source_name=...)` | `bind_source(obj_code, "dazi_cube", config={"cube": "CubeName"})` | 见利润/销售示例 |
 | `define_property(object_type_code=..., title=...)` | `define_property(obj_code, code, name, ...)` | 位置参数 |
 | `define_link_type(title=..., from_object_type=...)` | `define_link_type(name=..., from_object_type_code=..., to_object_type_code=...)` | 以 `_code` 结尾 |
+| **Reference 对象无 Cube 仍 define_property** | 参考型对象不 `bind_source` 则**禁止** `define_property` | 见 §1.1 |
 
 **教训**：对照 `资源/examples/onto/利润示例`、`销售示例` 的 init，勿猜 API。
 
+### 1.1 无 Cube 绑定的对象禁止 define_property
+
+| 对象分类（347） | bind_source | define_property |
+| --------------- | ----------- | --------------- |
+| 主数据 / 事务 / 分析 | **必须**绑定 Cube | ✅ 可定义属性 |
+| 参考 / 配置（无 Cube） | 无 | ❌ **禁止** — 会报「对象类型未绑定任何 DaziCube」 |
+
+规划阶段：Reference/Master 无 Cube 时，属性章节须标注「跳过或需补 Cube + bind_source」。
+
+### 1.2 本域首次 init 检查表（5 条）
+
+init `script run` 前逐项确认：
+
+| # | 检查项 | 通过标准 |
+| --- | ------ | -------- |
+| 1 | **dim_date** | 共用空间时确认已存在，或 init 含幂等 `ensure_dim_date` |
+| 2 | **bind_source** | 每个需读模型的分析/主数据/事务对象已绑定 Cube |
+| 3 | **define_property** | 无 Cube 的参考对象未调用 define_property |
+| 4 | **function_result** | 函数模板使用 `columns=`/`data=` kwargs，非 dict positional |
+| 5 | **relationship_count** | init 日志关系数与 plans §表间关系一致 |
+| 6 | **init 不含 apply_registry** | 分类在 `*_category_mount.py`；init 只做表/Cube/对象/链接 |
+
+### 1.3 init 与 category_mount 职责分离
+
+| 脚本 | 职责 | 时机 |
+| ---- | ---- | ---- |
+| `*_ontology_init.py` | 建表、register_with_meta、关系、Cube、对象/链接、sync_metric_refs | init → seed 之前 |
+| `*_category_mount.py` | `CATEGORY_REGISTRY` + `apply_registry` | **最后**（全部函数 publish 后） |
+
+**禁止**：在 init 内调用 `s.categories.apply_registry`（函数未 publish 时 function 段会被 skip；重跑 init 成本高）。
+
+`dazi onto script publish-preview` 对 `*init*.py` 会报错 `[init-no-apply-registry]`。
+
 ---
 
 ## 2. SQL 聚合：`query_one` 返回类型
@@ -71,26 +105,36 @@ def main():
 
 ## 4. CLI 参数误用
 
-### 4.1 `function run` 不支持 `--arguments-json-file`
+### 4.1 `function run` 与默认参数
+
+**推荐顺序**：`publish` → `function run`（验证）→ `save-test-arguments`（侧栏预填）。
+
+未传 `--params` 或 `--params '{}'` 时，CLI **自动回退**：
+
+1. 已保存的 `test_arguments.arguments`
+2. 否则脚本内 `TEST_ARGUMENTS.arguments`
 
 ```powershell
-# 错误
-dazi onto function run <function_id> --space <空间> --arguments-json-file xxx.json
+# 首次 run（无 save-test-arguments 也可，回退脚本内 TEST_ARGUMENTS）
+dazi onto function run sales.fn.yoy_analysis --space <空间>
 
-# 正确：先 save-test-arguments，再 run（不带 JSON 文件）
-dazi onto function run <function_id> --space <空间>
+# 显式传参
+dazi onto function run sales.fn.yoy_analysis --space <空间> --params '{"start_date":"2025-01-01","end_date":"2025-12-31"}'
 ```
 
-### 4.2 `save-test-arguments` 须用 `ofn_xxx` 内部 ID
+**不支持** `--arguments-json-file`（勿与 save-test-arguments 混淆）。
+
+### 4.2 `save-test-arguments`：ofn_xxx 或 --function-id
 
 ```powershell
-# 错误 — function_id 字符串
-dazi onto function save-test-arguments profit.fn.get_summary --space <空间> ...
+# 推荐：function_id 别名（无需查 ofn_xxx）
+dazi onto function save-test-arguments --function-id profit.fn.get_summary --space <空间> `
+  --arguments-json-file <项目路径>/functions/test_arguments/profit.fn.get_summary.json
 
-# 正确 — list 返回的 id 字段
-dazi onto function list --space <空间>
+# 或使用平台内部 id
+dazi onto function list --space <空间> --json   # 含 save_command 字段
 dazi onto function save-test-arguments ofn_xxxxxxxx --space <空间> `
-  --arguments-json-file <项目路径>/functions/test_arguments/<function_id>.json
+  --arguments-json-file <项目路径>/functions/test_arguments/profit.fn.get_summary.json
 ```
 
 ### 4.3 函数发布未带 `--register-function-id`
@@ -117,7 +161,18 @@ dazi onto function list --space <空间>   # 必须能看到该 id
 
 **结论**：init **不负责**注册本体函数；每个 `functions/*.py` 须单独 publish 并注册。
 
-**门禁**：规划函数数 = `functions/*.py` 数 = `function list` 条数。
+**门禁**：规划函数数 = `functions/*.py` 数 = `function list` 条数。可运行 `functions/onto_preflight.ps1`（见 `资源/examples/onto/_templates/`）自动核对。
+
+## 5.1 本体函数 publish-preview 静态预检
+
+`dazi onto script publish-preview` / `script publish`（本体函数）会在本地检查：
+
+| 级别 | 规则 |
+| ---- | ---- |
+| error | 禁止 `output.print_json`；须 `def main():`；须 `function_result(columns=...)` kwargs |
+| warn | 缺少 `TEST_ARGUMENTS`；`params.get("start_date", "")` 空串默认 |
+
+有 **error** 时预检失败，须修复后再 publish。
 
 ---
 
@@ -225,9 +280,9 @@ dazi onto function run <function_id> --space <空间>
 | 发布 data | `dazi onto script publish <path> --space <空间> --type data` |
 | 发布并注册函数 | `... --register-function-id <id> [--register-platform-category <分类>]` |
 | 执行脚本 | `dazi onto script run --file <path> --space <空间>` |
-| 运行函数 | `dazi onto function run <function_id> --space <空间>` |
-| 函数列表 | `dazi onto function list --space <空间>` |
-| 保存默认参数 | `dazi onto function save-test-arguments <ofn_id> --space <空间> --arguments-json-file <json>` |
+| 运行函数 | `dazi onto function run <function_id> --space <空间>`（无参时回退 TEST_ARGUMENTS） |
+| 函数列表 | `dazi onto function list --space <空间> [--json]` |
+| 保存默认参数 | `dazi onto function save-test-arguments --function-id <id> --space <空间> --arguments-json-file <json>` |
 
 ---
 

package/dist/examples/index.json

@@ -1,18 +1,222 @@
 {
-  "version": "3.1.0",
-  "updatedAt": "2026-06-05T18:00:00.000Z",
+  "version": "3.1.1",
+  "updatedAt": "2026-06-07T12:00:00.000Z",
   "examples": [
     {
       "id": "onto/readme",
-      "title": "Onto 示例总览（利润 + 销售）",
+      "title": "Onto 内置示例总览（销售 + 利润 + 设备运营）",
       "category": "onto",
       "file": "onto/README.md"
     },
     {
-      "id": "onto/template/ontology-function",
-      "title": "本体函数脚本模板（标准 main + function_result）",
+      "id": "onto/template/onto-preflight",
+      "title": "Onto 函数 publish 门禁脚本模板",
       "category": "onto-模板",
-      "file": "onto/_templates/ontology_function_template.py"
+      "file": "onto/_templates/onto_preflight.ps1"
+    },
+    {
+      "id": "onto/index",
+      "title": "Onto 示例索引（index.yaml）",
+      "category": "onto",
+      "file": "onto/index.yaml"
+    },
+    {
+      "id": "onto/index-json",
+      "title": "Onto 示例索引（index.json，CLI 机器可读）",
+      "category": "onto",
+      "file": "onto/index.json"
+    },
+    {
+      "id": "onto/sales/readme",
+      "title": "销售示例 · 总览",
+      "category": "onto-销售",
+      "file": "onto/销售示例/README.md"
+    },
+    {
+      "id": "onto/sales/plan",
+      "title": "销售示例 · 规划正文",
+      "category": "onto-销售",
+      "file": "onto/销售示例/plans/规划示例_产品销售本体规划方案.md"
+    },
+    {
+      "id": "onto/profit/readme",
+      "title": "利润示例 · 总览",
+      "category": "onto-利润",
+      "file": "onto/利润示例/README.md"
+    },
+    {
+      "id": "onto/profit/plan",
+      "title": "利润示例 · 规划正文",
+      "category": "onto-利润",
+      "file": "onto/利润示例/plans/规划示例_利润分析本体方案.md"
+    },
+    {
+      "id": "onto/equip-ops/readme",
+      "title": "设备运营 · 总览",
+      "category": "onto-设备运营",
+      "file": "onto/设备运营/README.md"
+    },
+    {
+      "id": "onto/equip-ops/plan",
+      "title": "设备运营 · 规划正文",
+      "category": "onto-设备运营",
+      "file": "onto/设备运营/plans/化工设备运营分析本体方案.md"
+    },
+    {
+      "id": "onto/equip-ops/setup/ontology-init",
+      "title": "设备运营 · 本体初始化",
+      "category": "onto-设备运营-初始化",
+      "file": "onto/设备运营/setup/equip_ops_ontology_init.py"
+    },
+    {
+      "id": "onto/equip-ops/setup/seed-data",
+      "title": "设备运营 · 演示灌数",
+      "category": "onto-设备运营-初始化",
+      "file": "onto/设备运营/setup/equip_ops_seed_data.py"
+    },
+    {
+      "id": "onto/equip-ops/setup/category-mount",
+      "title": "设备运营 · 平台分类挂载",
+      "category": "onto-设备运营-初始化",
+      "file": "onto/设备运营/setup/equip_ops_category_mount.py"
+    },
+    {
+      "id": "onto/equip-ops/function/get-summary",
+      "title": "设备运营 · 运营总览",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_get_summary.py"
+    },
+    {
+      "id": "onto/equip-ops/function/oee",
+      "title": "设备运营 · OEE 分析",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_oee_analysis.py"
+    },
+    {
+      "id": "onto/equip-ops/function/availability",
+      "title": "设备运营 · 可用率分析",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_availability_analysis.py"
+    },
+    {
+      "id": "onto/equip-ops/function/downtime-breakdown",
+      "title": "设备运营 · 停机分解",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_downtime_breakdown.py"
+    },
+    {
+      "id": "onto/equip-ops/function/maintenance-compliance",
+      "title": "设备运营 · 维保合规",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_maintenance_compliance.py"
+    },
+    {
+      "id": "onto/equip-ops/function/energy-intensity",
+      "title": "设备运营 · 能耗强度",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_energy_intensity.py"
+    },
+    {
+      "id": "onto/equip-ops/function/plan-vs-actual",
+      "title": "设备运营 · 计划 vs 实际",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_plan_vs_actual.py"
+    },
+    {
+      "id": "onto/equip-ops/function/unit-comparison",
+      "title": "设备运营 · 装置对比",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_unit_comparison.py"
+    },
+    {
+      "id": "onto/equip-ops/function/top-fault-equipment",
+      "title": "设备运营 · 故障设备 Top N",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_top_fault_equipment.py"
+    },
+    {
+      "id": "onto/equip-ops/function/yoy",
+      "title": "设备运营 · 同比 (YoY)",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_yoy_analysis.py"
+    },
+    {
+      "id": "onto/equip-ops/function/mom",
+      "title": "设备运营 · 环比 (MoM)",
+      "category": "onto-设备运营-函数",
+      "file": "onto/设备运营/functions/equip_ops_fn_mom_analysis.py"
+    },
+    {
+      "id": "onto/equip-ops/function/save-test-arguments",
+      "title": "设备运营 · 批量保存 test_arguments",
+      "category": "onto-设备运营-工具",
+      "file": "onto/设备运营/functions/save_test_arguments.ps1"
+    },
+    {
+      "id": "onto/equip-ops/test-args/get-summary",
+      "title": "test_arguments · equip_ops.fn.get_summary",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.get_summary.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/oee",
+      "title": "test_arguments · equip_ops.fn.oee_analysis",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.oee_analysis.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/availability",
+      "title": "test_arguments · equip_ops.fn.availability_analysis",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.availability_analysis.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/downtime-breakdown",
+      "title": "test_arguments · equip_ops.fn.downtime_breakdown",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.downtime_breakdown.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/maintenance-compliance",
+      "title": "test_arguments · equip_ops.fn.maintenance_compliance",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.maintenance_compliance.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/energy-intensity",
+      "title": "test_arguments · equip_ops.fn.energy_intensity",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.energy_intensity.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/plan-vs-actual",
+      "title": "test_arguments · equip_ops.fn.plan_vs_actual",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.plan_vs_actual.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/unit-comparison",
+      "title": "test_arguments · equip_ops.fn.unit_comparison",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.unit_comparison.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/top-fault-equipment",
+      "title": "test_arguments · equip_ops.fn.top_fault_equipment",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.top_fault_equipment.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/yoy",
+      "title": "test_arguments · equip_ops.fn.yoy_analysis",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.yoy_analysis.json"
+    },
+    {
+      "id": "onto/equip-ops/test-args/mom",
+      "title": "test_arguments · equip_ops.fn.mom_analysis",
+      "category": "onto-设备运营-测试参数",
+      "file": "onto/设备运营/functions/test_arguments/equip_ops.fn.mom_analysis.json"
     },
     {
       "id": "onto/profit/setup/ontology-init",
@@ -26,6 +230,12 @@
       "category": "onto-利润-初始化",
       "file": "onto/利润示例/setup/profit_seed_data.py"
     },
+    {
+      "id": "onto/profit/setup/category-mount",
+      "title": "利润分析 · 平台分类挂载",
+      "category": "onto-利润-初始化",
+      "file": "onto/利润示例/setup/profit_category_mount.py"
+    },
     {
       "id": "onto/profit/function/get-summary",
       "title": "利润分析 · 利润总览",
@@ -128,6 +338,12 @@
       "category": "onto-销售-初始化",
       "file": "onto/销售示例/setup/sales_seed_data.py"
     },
+    {
+      "id": "onto/sales/setup/category-mount",
+      "title": "产品销售 · 平台分类挂载",
+      "category": "onto-销售-初始化",
+      "file": "onto/销售示例/setup/sales_category_mount.py"
+    },
     {
       "id": "onto/sales/function/get-summary",
       "title": "产品销售 · 销售概览",

package/dist/examples/onto/README.md

@@ -1,51 +1,49 @@
 # Onto 内置示例
 
-`dazi examples sync` 后位于 **`资源/examples/onto/`**。复制到业务项目的 **`项目/<业务名>/本体/ontos/<实现名>/`** 对应子目录后再改 `space_id` 与业务字段。
+`dazi examples sync` 后位于 **`资源/examples/onto/`**。每个子目录是**完整本体单元**（与业务 `ontos/<实现>/` 同构）：
 
-## 利润示例（`利润示例/`）
+```text
+<示例名>/
+├── README.md
+├── plans/          ← ★ 规划正文（真理源）
+├── setup/          ← init、seed、category_mount
+└── functions/      ← 本体函数 + test_arguments
+```
+
+**规划 / 脚本前**：须至少阅读 **一个** 示例的 `README.md` + `plans/*.md`。索引见 **`index.yaml`** / **`index.json`**（`dazi examples onto list`）。
 
-| 路径 | 说明 | 规划文档 |
-|------|------|----------|
-| `setup/profit_ontology_init.py` | GL 域 init（科目/分录/预算表、Cube、对象、链接） | [规划示例_利润分析本体方案](../../docs/onto/规划示例_利润分析本体方案.md) |
-| `setup/profit_seed_data.py` | 演示灌数（科目树、成本中心、实际分录、预算） | 同上 |
-| `functions/profit_fn_*.py` | 7 个 GL 分析函数（总览/同比/环比/预实/科目/组织/Top 科目） | 同上 |
-| `functions/test_arguments/*.json` | 各 `profit.fn.*` 默认测试入参 | 规划 §6.5 |
-| `functions/save_test_arguments.ps1` | 批量写入平台 `test_arguments` | 发布函数后执行 |
+## 示例一览
 
-发布后须 **`function run` 验证** → **`save-test-arguments`** 写入默认测试入参（见规划 §6.5）。
+| 目录 | 域 | 规划（plans/） | 函数数 |
+|------|-----|----------------|--------|
+| [销售示例](./销售示例/) | 销售、订单、渠道 | `规划示例_产品销售本体规划方案.md` | 7 |
+| [利润示例](./利润示例/) | GL、科目、预实 | `规划示例_利润分析本体方案.md` | 7 |
+| [设备运营](./设备运营/) | 设备、OEE、停机 | `化工设备运营分析本体方案.md` | 11 |
 
-推荐空间：`space__zlj`（以你的实现单元 README 为准）。
+> 规划正文仅在 `examples/onto/<示例>/plans/`；`dazi examples onto show <id> --plan`。
 
-## 销售示例（`销售示例/`）
+## 复制到业务项目
 
-| 路径 | 说明 | 规划文档 |
-|------|------|----------|
-| `setup/sales_ontology_init.py` | 产品销售 init（表间关系 + Cube + 本体） | [规划示例_产品销售本体规划方案](../../docs/onto/规划示例_产品销售本体规划方案.md) |
-| `setup/sales_seed_data.py` | 演示灌数（产品/销售/维表） | 同上 |
-| `functions/sales_fn_*.py` | 7 个销售分析函数 | 同上 |
-| `functions/test_arguments/*.json` | 各 `function_id` 默认测试入参 | 与规划 §函数清单一致 |
-| `functions/save_test_arguments.ps1` | 批量写入平台 `test_arguments` | 发布函数后执行 |
+```text
+资源/examples/onto/<示例>/setup/*       → 项目/<业务>/本体/ontos/<实现>/setup/
+资源/examples/onto/<示例>/functions/*   → 项目/<业务>/本体/ontos/<实现>/functions/
+```
 
-推荐空间：`space__zlj`（以你的实现单元 README 为准）。
+规划须在本项目 **`plans/` 独立撰写**；示例 `plans/` 仅供只读对照（见快速启动 §0）。
 
-## 模板（`_templates/`）
+## 模板与工具
 
 | 路径 | 说明 |
 |------|------|
-| `_templates/ontology_function_template.py` | **新建本体函数时复制此文件**；`main()` → `return _ontology_fn_body(p)`，禁止 `output.print_json()` |
-
-`dazi examples show onto/template/ontology-function`
-
-## 复制示例
-
-```text
-资源/examples/onto/利润示例/setup/*.py              → 项目/<业务>/本体/ontos/<实现>/setup/
-资源/examples/onto/利润示例/functions/*.py            → 项目/<业务>/本体/ontos/<实现>/functions/
-资源/examples/onto/利润示例/functions/test_arguments/ → .../functions/test_arguments/
-
-资源/examples/onto/销售示例/setup/*.py              → 项目/<业务>/本体/ontos/<实现>/setup/
-资源/examples/onto/销售示例/functions/*.py            → 项目/<业务>/本体/ontos/<实现>/functions/
-资源/examples/onto/销售示例/functions/test_arguments/ → .../functions/test_arguments/
+| [_templates/ontology_function_template.py](./_templates/ontology_function_template.py) | 新建函数结构模板 |
+| [_templates/onto_preflight.ps1](./_templates/onto_preflight.ps1) | 函数数 / publish-preview 门禁 |
+
+```powershell
+dazi examples onto list
+dazi examples onto suggest 设备 OEE
+dazi examples onto show equip-ops --plan
+dazi examples list --category onto
+dazi examples show onto/readme
 ```
 
-侧栏 **帮助 → 示例** 可按分类浏览；`dazi examples list --category onto-利润-函数` 可过滤。
+侧栏 **帮助 → 示例** 可按 `onto-销售-函数`、`onto-设备运营-函数` 等分类浏览。

package/dist/examples/onto/_templates/onto_preflight.ps1

@@ -0,0 +1,84 @@
+# onto_preflight.ps1 — 本体实施门禁（规划 ↔ 函数文件 ↔ 平台注册）
+# 用法（在 dazi-work 根目录）：
+#   .\项目\<业务>\本体\ontos\<实现>\functions\onto_preflight.ps1
+# 或复制到 functions/ 后修改下方 $spaceId、$itemRel
+
+param(
+    [string]$SpaceId = "space__misc_01",
+    [string]$ItemRel = "项目/DAZI_TEST/本体/ontos/销售本体示例"
+)
+
+$ErrorActionPreference = "Stop"
+$functionsDir = Join-Path $PSScriptRoot "."
+$plansDir = Join-Path (Split-Path $PSScriptRoot -Parent) "plans"
+
+Write-Host "=== 本体 preflight ===" -ForegroundColor Cyan
+Write-Host "空间: $SpaceId"
+Write-Host "实现: $ItemRel"
+
+$exitCode = 0
+
+# 1. functions/*.py 数量
+$pyFiles = @(Get-ChildItem -Path $functionsDir -Filter "*.py" -File | Where-Object { $_.Name -notmatch "^_" })
+$pyCount = $pyFiles.Count
+Write-Host "`n[1] functions/*.py 数量: $pyCount"
+
+# 2. 平台 function list
+Write-Host "[2] 拉取 function list ..."
+$fnListRaw = & dazi onto function list --space $SpaceId --json 2>&1
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "  ✗ function list 失败" -ForegroundColor Red
+    exit 1
+}
+# 去掉 __JSON_SUMMARY__ 行后解析
+$jsonLines = ($fnListRaw | Where-Object { $_ -notmatch '__JSON_SUMMARY__' }) -join "`n"
+$fnList = $jsonLines | ConvertFrom-Json
+$listCount = @($fnList).Count
+Write-Host "  平台已注册: $listCount"
+
+if ($pyCount -ne $listCount) {
+    Write-Host "  ✗ 文件数 ($pyCount) ≠ 平台注册数 ($listCount)" -ForegroundColor Red
+    $exitCode = 1
+} else {
+    Write-Host "  ✓ 文件数与平台注册数一致" -ForegroundColor Green
+}
+
+# 3. 规划函数表行数（粗略：plans/*.md 中含 .fn. 的行）
+$planFnCount = 0
+if (Test-Path $plansDir) {
+    $planFiles = Get-ChildItem -Path $plansDir -Filter "*.md" -File
+    foreach ($pf in $planFiles) {
+        $content = Get-Content $pf.FullName -Raw -Encoding UTF8
+        $matches = [regex]::Matches($content, '\w+\.fn\.\w+')
+        $planFnCount += $matches.Count
+    }
+}
+if ($planFnCount -gt 0) {
+    Write-Host "`n[3] plans 中 .fn. 引用约: $planFnCount"
+    if ($planFnCount -ne $pyCount) {
+        Write-Host "  ⚠ 规划引用数 ($planFnCount) ≠ functions/*.py ($pyCount)" -ForegroundColor Yellow
+    } else {
+        Write-Host "  ✓ 与 functions/*.py 数量一致" -ForegroundColor Green
+    }
+} else {
+    Write-Host "`n[3] 跳过 plans 计数（无 plans/*.md 或未找到 .fn.）" -ForegroundColor Yellow
+}
+
+# 4. 本地 publish-preview 静态预检（每个函数）
+Write-Host "`n[4] 本体函数 publish-preview 静态预检 ..."
+foreach ($py in $pyFiles) {
+    $rel = "$ItemRel/functions/$($py.Name)"
+    Write-Host "  → $($py.Name)"
+    & dazi onto script publish-preview $rel --space $SpaceId 2>&1 | Out-Host
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "  ✗ $($py.Name) 预检失败" -ForegroundColor Red
+        $exitCode = 1
+    }
+}
+
+if ($exitCode -eq 0) {
+    Write-Host "`n=== preflight 通过 ===" -ForegroundColor Green
+} else {
+    Write-Host "`n=== preflight 未通过 ===" -ForegroundColor Red
+}
+exit $exitCode