@dazitech/cli 3.0.9 → 3.1.1

package/dist/{docs/onto → examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/plans}//350/247/204/345/210/222/347/244/272/344/276/213_/344/272/247/345/223/201/351/224/200/345/224/256/346/234/254/344/275/223/350/247/204/345/210/222/346/226/271/346/241/210.md

@@ -2,8 +2,10 @@
 
 **文档 ID**: `onto/planning-example-product-sales`
 
-> **推荐**：本体规划阶段**首选参考示例**。覆盖物理表、**表间关系**、Cube、本体链接、函数与 **test_arguments** 完整落地；表/Cube/对象命名遵循 [本体命名规范](./本体命名规范_物理表Cube与对象.md)。  
-> 补充示例（利润分析域）：[规划示例_利润分析本体方案.md](./规划示例_利润分析本体方案.md)
+> **只读参照**：本体规划阶段**首选结构示例**（非可复制模板）。覆盖物理表、**表间关系**、Cube、本体链接、函数与 **test_arguments** 完整落地；**不得**整篇粘贴为本项目 `plans/`。须独立撰写并写差异说明（见 [本体规划指南 · 任务模式](./本体规划指南.md#任务模式与反模式)）。
+
+> 表/Cube/对象命名遵循 [本体命名规范](./本体命名规范_物理表Cube与对象.md)。  
+> 补充示例（利润分析域）：[利润示例 plans](../../利润示例/plans/规划示例_利润分析本体方案.md)
 
 **占位符**（复制到工作区 `plans/` 后替换为实际值）：
 
@@ -53,7 +55,7 @@
 
 **物理表清单**（命名见 [命名规范 §2](./本体命名规范_物理表Cube与对象.md#2-物理表类别与前缀)）：
 
-| 表名 | 前缀类别 | **347 分类** | 显示名 | 说明 | 角色 |
+| 表名 | 前缀类别 | **平台分类** | 显示名 | 说明 | 角色 |
 | ---- | -------- | ------------ | ------ | ---- | ---- |
 | **`dim_date`** | 时间维（**强制**） | **时间维** | 日期维表 | 全空间共享；PK **`date_key`** | 时间维 |
 | `dim_product` | dim | **维度表** | 产品维表 | 可售产品主数据 | dim |
@@ -62,7 +64,7 @@
 | **`fact_sales_order_line`** | fact | **事实表** | 销售订单行事实表 | 订单行粒度销售流水；含 **`date_key`** | fact |
 
 > 规划原则：**先**定义业务对象（Product、SalesOrder 等）与链接，**再**反推 Cube 与物理表。事实表通过 `date_key` 关联 `dim_date`，支撑同比/环比与时间层次分析。  
-> init 脚本 `资源/examples/onto/销售示例/setup/sales_ontology_init.py` 顶部 **`TABLE_REGISTRY`** 与上表及 §3.x 字段 **显示名/说明** 一一对应，经 `s.tables.register_with_meta` 注册；**`CATEGORY_REGISTRY`** 与 [附录 B](#附录-b347-分类挂载对照表category_registry) 及 `apply_registry` 步骤对齐。
+> init 脚本 `资源/examples/onto/销售示例/setup/sales_ontology_init.py` 顶部 **`TABLE_REGISTRY`** 与上表及 §3.x 字段 **显示名/说明** 一一对应，经 `s.tables.register_with_meta` 注册；**`CATEGORY_REGISTRY`** 与 [附录 B](#附录-b平台-分类挂载对照表category_registry) 及 `apply_registry` 步骤对齐。
 
 ---
 
@@ -189,7 +191,7 @@
 
 **关系清单（5 条）**：
 
-| 关系 ID | **347 分类** | 类型 | 从表 | 到表 | join_keys | 说明 |
+| 关系 ID | **平台分类** | 类型 | 从表 | 到表 | join_keys | 说明 |
 | ------- | ------------ | ---- | ---- | ---- | --------- | ---- |
 | rel_sales_date | **时间关联** | many_to_one | fact_sales_order_line | dim_date | date_key → date_key | 订单行关联日历 |
 | rel_sales_product | **主数据关联** | many_to_one | fact_sales_order_line | dim_product | product_id → product_id | 订单行关联产品 |
@@ -235,7 +237,7 @@ s.tables.add_relationship(
 
 ### 4.0 Cube 清单与类别
 
-| Cube | 类别 | **347 分类** | 事实源 | 时间维 | 支撑对象 |
+| Cube | 类别 | **平台分类** | 事实源 | 时间维 | 支撑对象 |
 | ---- | ---- | ------------ | ------ | ------ | -------- |
 | **SalesCube** | Process | **流程型** | fact_sales_order_line | dim_date（year/month/quarter） | SalesOrder, SalesAnalysis |
 | **ProductSalesCube** | Subject | **主体型** | fact_sales_order_line | 同上 | Product |
@@ -299,7 +301,7 @@ s.tables.add_relationship(
 
 ### 5.1 对象类型（5 种）
 
-| code | 分类 | **347 分类** | 名称 | bind_source | 主物理支撑 |
+| code | 分类 | **平台分类** | 名称 | bind_source | 主物理支撑 |
 | ---- | ---- | ------------ | ---- | ------------- | ---------- |
 | Product | Master | **主数据** | 产品 | ProductSalesCube | dim_product |
 | Customer | Master | **主数据** | 客户 | CustomerSalesCube | dim_customer |
@@ -339,7 +341,7 @@ s.tables.add_relationship(
 
 ### 5.3 链接类型（8 种）
 
-| 链接 code              | **347 分类** | 名称           | from          | to            | 说明                 |
+| 链接 code              | **平台分类** | 名称           | from          | to            | 说明                 |
 | ---------------------- | ------------ | -------------- | ------------- | ------------- | -------------------- |
 | order_contains_product | **归属关系** | 订单包含产品   | SalesOrder    | Product       | 订单行对应产品       |
 | order_belongs_customer | **归属关系** | 订单归属客户   | SalesOrder    | Customer      | 订单归属客户         |
@@ -367,7 +369,7 @@ s.tables.add_relationship(
 
 ### 6.1 函数清单
 
-| 函数 ID                           | **347 分类** | 功能         | 参数                                              |
+| 函数 ID                           | **平台分类** | 功能         | 参数                                              |
 | --------------------------------- | ------------ | ------------ | ------------------------------------------------- |
 | sales.fn.get_summary              | **总览分析** | 销售总览     | start_date, end_date（可选）                      |
 | sales.fn.yoy_analysis             | **趋势分析** | 同比分析     | start_date, end_date                              |
@@ -458,24 +460,22 @@ JSON 格式须含 `v`、`arguments`、`object_type_code`（与平台函数定义
 | 11   | define_property（约 29 个）                                  |
 | 12   | define_link_type（8 种）                                     |
 | 13   | sync_metric_refs                                             |
-| 14   | **CATEGORY_REGISTRY** + `s.categories.apply_registry`（347 对齐） |
-
-### 7.4 阶段四：函数与数据（中）
+### 7.4 阶段四：灌数、函数与分类（中）
 
 | 步骤 | 任务                                                                 |
 | ---- | -------------------------------------------------------------------- |
-| 14   | 从 `销售示例/functions/sales_fn_*.py` 复制并适配（SQL 表名按本规划） |
-| 15   | seed 灌数：**dim_date** + 维表 + fact（写入 date_key） |
-| 16   | publish + run 验证                                                   |
-| 17   | **`save-test-arguments`** 写入各函数 `test_arguments`（侧栏预填；见 §6.4） |
+| 14   | seed 灌数：**dim_date** + 维表 + fact（写入 date_key） |
+| 15   | 从 `销售示例/functions/sales_fn_*.py` 复制并适配；**publish --register-function-id** |
+| 16   | `function run` + **`save-test-arguments`**（侧栏预填；见 §6.4） |
+| 17   | **`sales_category_mount.py`**：`CATEGORY_REGISTRY` + `apply_registry`（**最后**，类灌数） |
 
-### 7.5 快速实施路径
+### 7.5 实施阶段参考（须 plans 已定稿后）
 
-本仓库 **`资源/examples/onto/销售示例/setup/sales_ontology_init.py`** 含完整 init 逻辑（含 **`TABLE_REGISTRY`** 与 `register_with_meta`），与本文 §2.3、§3.x 对齐：
+`资源/examples/onto/销售示例/setup/sales_ontology_init.py` 含完整 init 逻辑，与本文 §2.3、§3.x 对齐，供 **对照实施** 时参考：
 
-1. 复制 `sales_ontology_init.py`、`sales_seed_data.py` → 实现单元 `setup/`（`dazi examples sync` 或侧栏 **帮助 → 示例**）
-2. 将 init/seed 内 `space_id` 改为 README 中的 `<space-id>`
-3. 按 [快速启动](./本体规划指南.md) 发布执行
+1. 确认 `plans/` 已定稿并通过自检（快速启动 §3 门禁）
+2. 按需借鉴或复制示例 init/seed，**按本实现 plans 改造**表名与元数据
+3. 改 `space_id` 后按 [本体脚本编写指南](./本体脚本编写指南.md) 发布执行
 
 ---
 
@@ -500,7 +500,7 @@ JSON 格式须含 `v`、`arguments`、`object_type_code`（与平台函数定义
 | **表间关系** | **4 条**（含 fact → dim_date） |
 | Cube | **4 个** Cube；SalesCube 含时间维 |
 | 对象类型 | 5 种 + 分类列；8 种链接 |
-| **347 平台分类** | 侧栏分类名与附录 B 一致；init 重跑幂等 |
+| **平台侧栏分类** | 侧栏分类名与附录 B 一致；`category_mount` 重跑幂等 |
 | 函数 | get_summary、top_products 可运行 |
 | test_arguments | 各 function_id 已 save-test-arguments |
 | 数据 | 种子灌入后指标与手工 SQL 一致 |
@@ -519,13 +519,13 @@ JSON 格式须含 `v`、`arguments`、`object_type_code`（与平台函数定义
 
 ---
 
-## 附录 B：347 分类挂载对照表（CATEGORY_REGISTRY）
+## 附录 B：平台分类挂载对照表（CATEGORY_REGISTRY）
 
-与 `销售示例/setup/sales_ontology_init.py` 顶部 **`CATEGORY_REGISTRY`** 一一对应；平台 `category_name` **=** 347 标准中文名（见 [349 方案](./本体分类规划与SDK扩展方案.md)）。
+与 `销售示例/setup/sales_category_mount.py` 顶部 **`CATEGORY_REGISTRY`** 一一对应；平台 `category_name` **=** 平台标准分类中文名（见 [本体分类规划与SDK扩展方案](./本体分类规划与SDK扩展方案.md)）。**init 不含分类挂载**；本附录在 **全部函数 publish 后** 由 `category_mount` 脚本执行。
 
 ### B.1 物理表（table）
 
-| 347 分类 | 表名 |
+| 平台分类 | 表名 |
 | -------- | ---- |
 | 时间维 | dim_date |
 | 维度表 | dim_product, dim_customer, dim_channel |
@@ -533,14 +533,14 @@ JSON 格式须含 `v`、`arguments`、`object_type_code`（与平台函数定义
 
 ### B.2 Cube（cube）
 
-| 347 分类 | Cube |
+| 平台分类 | Cube |
 | -------- | ---- |
 | 流程型 | SalesCube |
 | 主体型 | ProductSalesCube, CustomerSalesCube, ChannelSalesCube |
 
 ### B.3 对象类型（object）
 
-| 347 分类 | code |
+| 平台分类 | code |
 | -------- | ---- |
 | 主数据 | Product, Customer |
 | 参考 | SalesChannel |
@@ -549,23 +549,23 @@ JSON 格式须含 `v`、`arguments`、`object_type_code`（与平台函数定义
 
 ### B.4 表间关系（relation）
 
-| 347 分类 | 从表 → 到表 |
+| 平台分类 | 从表 → 到表 |
 | -------- | ----------- |
 | 时间关联 | fact_sales_order_line → dim_date |
 | 主数据关联 | fact_sales_order_line → dim_product / dim_customer / dim_channel |
 
 ### B.5 链接类型（link）
 
-| 347 分类 | link code |
+| 平台分类 | link code |
 | -------- | --------- |
 | 归属关系 | order_contains_product, order_belongs_customer, order_via_channel, product_has_orders, customer_places_orders |
 | 分析归因 | analysis_by_product, analysis_by_customer, analysis_by_channel |
 
 ### B.6 本体函数（function）
 
-init 脚本**不**注册函数；函数发布后单独执行 `apply_registry` 的 `function` 段，或 `skip_missing=True` 跳过。建议分类：
+函数在 `functions/` 中 **publish 注册**；`sales_category_mount.py` 在 **init + seed + 全部函数 publish 之后** 统一 `apply_registry`（含 function 段，`skip_missing=True` 可重跑）。建议分类：
 
-| 347 分类 | function_id |
+| 平台分类 | function_id |
 | -------- | ----------- |
 | 总览分析 | sales.fn.get_summary |
 | 趋势分析 | sales.fn.yoy_analysis, sales.fn.mom_analysis |
@@ -595,7 +595,7 @@ init 脚本**不**注册函数；函数发布后单独执行 `apply_registry`
 | 8 | 函数清单 | ☑ |
 | 9 | test_arguments | ☑ |
 | 10 | 实施与验收 | ☑ |
-| 6a–6e | 347 平台分类 | ☑（附录 B + init 步骤 10） |
+| 6a–6e | 平台侧栏分类 | ☑（附录 B + `sales_category_mount.py`） |
 
 ---
 
@@ -609,8 +609,8 @@ init 脚本**不**注册函数；函数发布后单独执行 `apply_registry`
 | 函数开发 | [function-guide.md](./function-guide.md) |
 | 参考实现（init/seed/函数） | `资源/examples/onto/销售示例/` → 复制到 `<item-path>/` |
 | **内置脚本示例** | `资源/examples/onto/销售示例/`（`dazi examples sync` 后复制到实现单元） |
-| 补充示例（利润） | [规划示例_利润分析本体方案.md](./规划示例_利润分析本体方案.md) · `资源/examples/onto/利润示例/` |
-| 349 · 分类方案 | [本体分类规划与 SDK 扩展方案](./本体分类规划与SDK扩展方案.md) |
+| 补充示例（利润） | [利润示例 plans](../../利润示例/plans/规划示例_利润分析本体方案.md) |
+| 分类方案 | [本体分类规划与 SDK 扩展方案](./本体分类规划与SDK扩展方案.md) |
 
 ---
 

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/setup/sales_category_mount.py

@@ -0,0 +1,82 @@
+"""产品销售本体 — 平台分类挂载（CATEGORY_REGISTRY）
+
+与灌数脚本类似，**独立步骤、放在实施流程最后**：
+init → seed → 发布全部函数 → **本脚本**。
+
+放置：资源/examples/onto/销售示例/setup/sales_category_mount.py
+发布：dazi onto script publish <item-path>/setup/sales_category_mount.py --space <space-id> --type setup
+规划对照：资源/examples/onto/销售示例/plans/规划示例_产品销售本体规划方案.md 附录 B
+"""
+
+import json
+
+CATEGORY_REGISTRY = {
+    "table": {
+        "时间维": ["dim_date"],
+        "维度表": ["dim_product", "dim_customer", "dim_channel"],
+        "事实表": ["fact_sales_order_line"],
+    },
+    "cube": {
+        "流程型": ["SalesCube"],
+        "主体型": ["ProductSalesCube", "CustomerSalesCube", "ChannelSalesCube"],
+    },
+    "object": {
+        "主数据": ["Product", "Customer"],
+        "参考": ["SalesChannel"],
+        "事务": ["SalesOrder"],
+        "分析": ["SalesAnalysis"],
+    },
+    "relation": {
+        "时间关联": [("fact_sales_order_line", "dim_date")],
+        "主数据关联": [
+            ("fact_sales_order_line", "dim_product"),
+            ("fact_sales_order_line", "dim_customer"),
+            ("fact_sales_order_line", "dim_channel"),
+        ],
+    },
+    "link": {
+        "归属关系": [
+            "order_contains_product",
+            "order_belongs_customer",
+            "order_via_channel",
+            "product_has_orders",
+            "customer_places_orders",
+        ],
+        "分析归因": [
+            "analysis_by_product",
+            "analysis_by_customer",
+            "analysis_by_channel",
+        ],
+    },
+    "function": {
+        "总览分析": ["sales.fn.get_summary"],
+        "趋势分析": ["sales.fn.yoy_analysis", "sales.fn.mom_analysis"],
+        "结构分析": [
+            "sales.fn.top_products",
+            "sales.fn.customer_segmentation",
+            "sales.fn.channel_mix",
+        ],
+        "组织分析": ["sales.fn.region_breakdown"],
+    },
+}
+
+
+def main():
+    space_id = "space__misc_01"
+    s = space.get(space_id)
+
+    output.print("=== 产品销售 — 平台分类挂载 ===")
+    output.print(f"空间: {space_id}")
+
+    cat_counts = s.categories.apply_registry(CATEGORY_REGISTRY, skip_missing=True)
+    for kind, cnt in cat_counts.items():
+        if cnt:
+            output.print(f"OK 分类[{kind}] 挂载 {cnt} 项")
+
+    summary = {
+        "ok": True,
+        "space_id": space_id,
+        "category_mounts": cat_counts,
+    }
+    output.success("平台分类挂载完成")
+    output.print("__JSON_SUMMARY__" + json.dumps(summary, ensure_ascii=True, default=str))

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/setup/sales_ontology_init.py

@@ -1,4 +1,4 @@
-"""产品销售本体初始化脚本 — space__misc_01
+"""产品销售本体初始化脚本 — space__misc_01
 
 初始化内容：
 1. 创建物理表（dim_date + 3 维表 + 1 事实表）
@@ -7,11 +7,11 @@
 4. 注册 Cube（4 个）及派生度量
 5. 定义对象类型（5 种）、绑定数据源、属性、链接
 6. 同步指标引用
-7. 配置 347 对齐分类（ads_categories + 桥表）
+7. 配置 平台分类对齐分类（ads_categories + 桥表）
 
 放置：资源/examples/onto/销售示例/setup/sales_ontology_init.py（复制到项目 ontos/<实现名>/setup/）
 发布：dazi onto script publish <item-path>/setup/sales_ontology_init.py --space <space-id> --type setup
-规划对照：资源/docs/onto/规划示例_产品销售本体规划方案.md
+规划对照：资源/examples/onto/销售示例/plans/规划示例_产品销售本体规划方案.md
 """
 
 import json
@@ -98,48 +98,6 @@ TABLE_REGISTRY = {
     },
 }
 
-# 与 347 + 附录 B 对齐；category 值必须是 347 标准中文名
-CATEGORY_REGISTRY = {
-    "table": {
-        "时间维": ["dim_date"],
-        "维度表": ["dim_product", "dim_customer", "dim_channel"],
-        "事实表": ["fact_sales_order_line"],
-    },
-    "cube": {
-        "流程型": ["SalesCube"],
-        "主体型": ["ProductSalesCube", "CustomerSalesCube", "ChannelSalesCube"],
-    },
-    "object": {
-        "主数据": ["Product", "Customer"],
-        "参考": ["SalesChannel"],
-        "事务": ["SalesOrder"],
-        "分析": ["SalesAnalysis"],
-    },
-    "relation": {
-        "时间关联": [("fact_sales_order_line", "dim_date")],
-        "主数据关联": [
-            ("fact_sales_order_line", "dim_product"),
-            ("fact_sales_order_line", "dim_customer"),
-            ("fact_sales_order_line", "dim_channel"),
-        ],
-    },
-    "link": {
-        "归属关系": [
-            "order_contains_product",
-            "order_belongs_customer",
-            "order_via_channel",
-            "product_has_orders",
-            "customer_places_orders",
-        ],
-        "分析归因": [
-            "analysis_by_product",
-            "analysis_by_customer",
-            "analysis_by_channel",
-        ],
-    },
-}
-
-
 def main():
     space_id = "space__misc_01"
     s = space.get(space_id)
@@ -515,14 +473,6 @@ def main():
     s.sync_metric_refs()
     output.print("OK sync_metric_refs")
 
-    # 10. 347 对齐分类
-    output.print("\n[10/10] 配置对象分类（347 对齐）...")
-
-    cat_counts = s.categories.apply_registry(CATEGORY_REGISTRY, skip_missing=True)
-    for kind, cnt in cat_counts.items():
-        if cnt:
-            output.print(f"OK 分类[{kind}] 挂载 {cnt} 项")
-
     summary = {
         "ok": True,
         "space_id": space_id,
@@ -532,7 +482,6 @@ def main():
         "object_types": 5,
         "properties": len(properties),
         "link_types": len(link_types),
-        "category_mounts": cat_counts,
     }
     output.success("本体初始化完成")
     output.print(f"space_id: {space_id}")

package/dist/prompts/index.json

@@ -1,7 +1,14 @@
 {
-  "version": "3.0.9",
+  "version": "3.1.1",
   "updatedAt": "2026-06-05T00:00:00.000Z",
   "prompts": [
+    {
+      "id": "onto/planning-design",
+      "title": "本体规划设计（TRAE/智能体 · 默认）",
+      "category": "onto",
+      "file": "onto/planning-design.md",
+      "featured": true
+    },
     {
       "id": "onto/script-publish-run",
       "title": "本体脚本发布与运行（TRAE/智能体）",

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

@@ -1,73 +1,73 @@
-# 提示词：本体函数设计
-
-**提示词 ID**: `onto/function-design`  
-**场景**: 设计新的本体函数
-
----
-
-你是一名搭子平台本体工程师。请根据以下需求设计一个本体函数（ontology function）。
-
-**执行脚本前必读**：`资源/docs/onto/脚本运行纠错_商务成本方案开发过程.md`（`onto/script-run-troubleshooting`）。  
-**必须复制结构**：`资源/examples/onto/_templates/ontology_function_template.py` 或 `销售示例/functions/sales_fn_get_summary.py`。
-
-## 函数需求
-
-{{function_description}}
-
-## 要求
-
-1. 文件名 `snake_case`，如 `cost_fn_get_summary.py`；`function_id` 如 `domain.fn.get_summary`
-2. **`def main():` 无参** — 禁止 `main(params: dict)`；入参来自 `ctx.params`
-3. 业务逻辑写在 **`_ontology_fn_body(p)`**；`main()` 末尾 **`return _ontology_fn_body(p)`**
-4. 输出使用 **`return p.function_result(columns=..., data=..., row_count=...)`** — **禁止** `output.print_json()`、`print()` 作为平台输出
-5. SQL 用 **`p.sql.query()`** 取多列；聚合勿误用 `query_one().get()`
-6. 脚本顶部 **`TEST_ARGUMENTS`** 与 `functions/test_arguments/<function_id>.json` 同步
-7. 中文 docstring：目的、参数、返回值、发布命令
-
-## 输出格式（必须遵循）
-
-```python
-TEST_ARGUMENTS = {
-    "v": 1,
-    "arguments": { ... },
-    "object_type_code": "<ObjectTypeCode>",
-}
-
-
-def _ontology_fn_body(p):
-    params = dict(p.get_params() or {})
-    # ... p.sql.query(...)
-    return p.function_result(
-        columns=[...],
-        data=[{...}],
-        row_count=1,
-    )
-
-
-def main():
-    s = space.get(ctx.space_id or "")
-    _Ports = type(
-        "_Ports",
-        (),
-        {
-            "get_params": lambda self: dict(ctx.params or {}),
-            "function_result": lambda self, **kw: onto.function_result(**kw),
-        },
-    )
-    p = _Ports()
-    p.sql = s.sql
-    return _ontology_fn_body(p)
-```
-
-脚本落盘：`项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py`
-
-发布与运行（dazi-work 根；**勿用** `dazi-onto`）：
-
-```powershell
-dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py --space <space-id> --register-function-id <id>
-dazi onto function run <id> --space <space-id>
-dazi onto function save-test-arguments <ofn_internal_id> --space <space-id> `
-  --arguments-json-file 项目/<业务名>/本体/ontos/<实现名>/functions/test_arguments/<id>.json
-```
-
-详见 `onto/script-publish-run`、`onto/function-guide`。
+# 提示词：本体函数设计
+
+**提示词 ID**: `onto/function-design`  
+**场景**: 设计新的本体函数
+
+---
+
+你是一名搭子平台本体工程师。请根据以下需求设计一个本体函数（ontology function）。
+
+**执行脚本前必读**：`资源/docs/onto/脚本运行常见错误处理.md`（`onto/script-run-troubleshooting`）。  
+**必须复制结构**：`资源/examples/onto/_templates/ontology_function_template.py` 或 `销售示例/functions/sales_fn_get_summary.py`。
+
+## 函数需求
+
+{{function_description}}
+
+## 要求
+
+1. 文件名 `snake_case`，如 `cost_fn_get_summary.py`；`function_id` 如 `domain.fn.get_summary`
+2. **`def main():` 无参** — 禁止 `main(params: dict)`；入参来自 `ctx.params`
+3. 业务逻辑写在 **`_ontology_fn_body(p)`**；`main()` 末尾 **`return _ontology_fn_body(p)`**
+4. 输出使用 **`return p.function_result(columns=..., data=..., row_count=...)`** — **禁止** `output.print_json()`、`print()` 作为平台输出
+5. SQL 用 **`p.sql.query()`** 取多列；聚合勿误用 `query_one().get()`
+6. 脚本顶部 **`TEST_ARGUMENTS`** 与 `functions/test_arguments/<function_id>.json` 同步
+7. 中文 docstring：目的、参数、返回值、发布命令
+
+## 输出格式（必须遵循）
+
+```python
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": { ... },
+    "object_type_code": "<ObjectTypeCode>",
+}
+
+
+def _ontology_fn_body(p):
+    params = dict(p.get_params() or {})
+    # ... p.sql.query(...)
+    return p.function_result(
+        columns=[...],
+        data=[{...}],
+        row_count=1,
+    )
+
+
+def main():
+    s = space.get(ctx.space_id or "")
+    _Ports = type(
+        "_Ports",
+        (),
+        {
+            "get_params": lambda self: dict(ctx.params or {}),
+            "function_result": lambda self, **kw: onto.function_result(**kw),
+        },
+    )
+    p = _Ports()
+    p.sql = s.sql
+    return _ontology_fn_body(p)
+```
+
+脚本落盘：`项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py`
+
+发布与运行（dazi-work 根；**勿用** `dazi-onto`）：
+
+```powershell
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py --space <space-id> --register-function-id <id>
+dazi onto function run <id> --space <space-id>
+dazi onto function save-test-arguments <ofn_internal_id> --space <space-id> `
+  --arguments-json-file 项目/<业务名>/本体/ontos/<实现名>/functions/test_arguments/<id>.json
+```
+
+详见 `onto/script-publish-run`、`onto/function-guide`。