@dazitech/cli 3.0.6 → 3.0.8

package/dist/prompts/flow/run-fix-loop.md

@@ -10,14 +10,16 @@
 ## 核心原则
 
 1. **扩展不会自动改代码**；你必须在终端**亲自执行** CLI 并读取 `_run/` 错误文件。
-2. **改 → 跑 → 读错 → 再改 → 再跑** 是默认工作方式，不是可选项。
-3. 命令前缀统一：`dazi flow ...`（在 `dazi-work` 根；流程目录用 `--dir .`）。
+2. **改 → push → 跑 →（有输出变量时）variable pull → 读错 → 再改** 是默认工作方式，不是可选项。
+3. **`node-exec` 在平台执行已 push 的代码**；改 `code.*` 后必须先 `node push`，否则测到的仍是旧版。
+4. 命令前缀统一：`dazi flow ...`（在 `dazi-work` 根；流程目录用 `--dir .`）。
 
 ## 命令约束（必须遵守）
 
 - 命令前缀统一：`dazi flow ...`（在 `dazi-work` 根）
 - 在流程目录执行时，保留 `--dir .`，避免误跑到其他流程
 - 配置变更必须 `project push --dir . --canvas`（无 `--canvas` 不会更新平台画布）
+- 改 `code.*` 后测试前必须 `node push --node <node_uuid> --dir .`
 - push 前先 `project doctor`；不一致则 `repair-meta`
 - 禁止输出裸 `dazi-flow ...` 作为最终命令
 - 必读：`flow/local-files-spec`
@@ -33,48 +35,61 @@
 
 `last-error.md` 含：**错误分类**（缺上游变量/配置缺失/代码错误/连接数据源）、traceback、修复指引。
 
+## 成功判据（代码节点，缺一不可）
+
+1. **`node push` 已成功**（`project status` 该节点代码不再脏）
+2. **`node-exec` 返回 `success: true`**（建议带 `--json`）
+3. **若配置了 `output_variable_name`**：`variable pull --name <名>` 后，`变量/<名>.json` 为 ready 且 schema/预览符合预期
+
+> 禁止仅凭 `node-exec` 退出码或「无 last-error 文件」就声称通过；禁止未 `node push` 就测代码。
+
 ## 改错循环（默认最多 3 轮）
 
 ```
 FOR round = 1..3:
   1. 读 flow.json + code.* +（若失败）last-error.md + 变量/<名>.json（如需列名）
   2. 修改 code.* 和/或 flow.json（遵守画布锚点规范）
-  3. 运行验证：
-     - 优先单节点：
-       dazi flow run node-exec --node <node_uuid> --dir .
-     - 需要全链路时：
-       dazi flow run flow-exec --dir . --type debug
-  4. IF 成功 → push（见下）→ 结束
+  3. 若改了 flow.json 拓扑/配置 → project push --dir . --canvas
+  4. 若改了 code.* → node push --node <node_uuid> --dir .（必须先于测试）
+  5. 运行验证（先小后大）：
+     - 单节点：dazi flow run node-exec --node <node_uuid> --dir .
+     - 整流程：dazi flow run flow-exec --dir . --type debug
+  6. 若节点有 output_variable_name → variable pull --name <名> --dir .
+  7. IF 满足「成功判据」→ 结束（本轮无需重复 push，步骤 4 已提交）
      ELSE → 读新生成的 last-error.md → 下一轮
-  5. IF round==3 仍失败 → 输出：失败节点、3 轮尝试摘要、剩余疑点、需用户提供的资料
+  8. IF round==3 仍失败 → 输出：失败节点、3 轮尝试摘要、剩余疑点、需用户提供的资料
 ```
 
 ## 修复决策树
 
-| 错误分类    | 改哪里                   | 验证命令                                                                                                |
+| 错误分类    | 改哪里                   | 验证命令（顺序固定）                                                                                    |
 | ----------- | ------------------------ | ------------------------------------------------------------------------------------------------------- |
-| 缺上游变量  | 先跑上游或整流程         | `dazi flow run flow-exec --dir . --type debug`，再 `dazi flow run node-exec --node <node_uuid> --dir .` |
-| 配置缺失    | `flow.json` 节点 `data`  | `dazi flow run node-exec --node <node_uuid> --dir .` → `dazi flow project push --dir . --canvas`        |
-| 代码错误    | `节点/<名>/code.sql\|py` | `dazi flow run node-exec --node <node_uuid> --dir .` → `dazi flow node push --node <node_uuid> --dir .` |
-| 连接/数据源 | connectionId / spaceId   | 改配置后 `dazi flow project push --dir . --canvas`                                                      |
+| 缺上游变量  | 先跑上游或整流程         | 上游 `node push` → `node-exec` 或 `flow-exec --type debug` → `variable pull` → 再测目标节点（同样先 push） |
+| 配置缺失    | `flow.json` 节点 `data`  | `project push --dir . --canvas` → `node push`（若也改了 code）→ `node-exec` → `variable pull`（若适用） |
+| 代码错误    | `节点/<名>/code.sql\|py` | **`node push`** → **`node-exec`** → **`variable pull`**（若配置了输出变量）                             |
+| 连接/数据源 | connectionId / spaceId   | `project push --dir . --canvas` → 再按上序测试                                                         |
 
 ## 提交规则
 
-- 只改代码：`dazi flow node push --node <node_uuid> --dir .`
-- 改连线/配置/增删节点：`dazi flow project push --dir . --canvas`
-- 确认变量 schema：`dazi flow variable pull --name <output_variable_name> --dir .`
-- **禁止**未验证通过就 push
+- 改 `code.*`：**测试前** `node push`（见改错循环步骤 4）；不要等测试通过才第一次 push
+- 改连线/配置/增删节点：`project push --dir . --canvas`（先于依赖该配置的测试）
+- 有 `output_variable_name`：**成功判据**须包含 `variable pull` 核对
+- **禁止**未满足成功判据就声称完成
+- **禁止**未 `node push` 就 `node-exec` 并声称已验证新代码
 
 ## 回答格式（每轮结束后）
 
-1. **本轮运行**：命令 + 成功/失败
-2. **若失败**：节点、错误分类、根因（引用 last-error 原文）
-3. **本轮修改**：改了哪些文件、改了什么
-4. **下一步**：重跑命令或已 push
+1. **本轮 push**：`node push` / `push --canvas` 是否成功
+2. **本轮运行**：命令 + 成功/失败 +（若适用）variable pull 结果
+3. **若失败**：节点、错误分类、根因（引用 last-error 原文）
+4. **本轮修改**：改了哪些文件、改了什么
+5. **下一步**：重跑命令或已满足成功判据
 
 ## 禁止项
 
 - 未运行就声称修复完成
+- 未 `node push` 就 `node-exec` 验证代码改动
 - 不读 `_run/*.last-error.md` 就猜原因
+- 仅凭 exit code 通过就 push 或声称完成（跳过 variable pull）
 - 使用裸 `dazi-flow` 作为最终命令
 - 把代码正文塞进 `flow.json`

package/dist/prompts/index.json

@@ -1,6 +1,6 @@
 {
-  "version": "3.0.6",
-  "updatedAt": "2026-05-26T00:00:00.000Z",
+  "version": "3.0.8",
+  "updatedAt": "2026-06-05T00:00:00.000Z",
   "prompts": [
     {
       "id": "onto/script-publish-run",

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

@@ -40,10 +40,13 @@ def main(params: dict, context: dict, s=None) -> dict:
     return {"status": "ok"}
 ```
 
+脚本落盘路径：`项目/<业务名>/本体/ontos/<实现名>/setup/` 或 `functions/`（按脚本类型选择）。  
+`space_id` 取自 `ontos/<实现名>/README.md`。
+
 发布命令（v3；**勿用** `dazi-onto`）：
 
 ```powershell
-dazi onto script publish 项目/onto_<名>/脚本/<file>.py --space <space-id> --register-action-id <action_code> --register-action-permission-tag "finance.write"
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/setup/<file>.py --space <space-id> --register-action-id <action_code> --register-action-permission-tag "finance.write"
 ```
 
 详见提示词 `onto/script-publish-run`。

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

@@ -19,6 +19,7 @@
 4. 包含完整的 docstring（中文），说明：函数目的、参数说明、返回值说明
 5. 包含基本的错误处理（try/except）
 6. 引用的搭子数据空间对象通过 `s` 上下文访问
+7. 在脚本顶部定义 `TEST_ARGUMENTS` 常量（与 `functions/test_arguments/<function_id>.json` 同步），供发布后 `save-test-arguments` 入库
 
 ## 输出格式
 
@@ -36,11 +37,17 @@ def main(params: dict, s=None) -> dict:
     # 实现
 ```
 
+脚本落盘路径：`项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py`  
+`space_id` 取自同目录上级的 `README.md`（`ontos/<实现名>/README.md`）。
+
 发布与运行（v3，工作区根目录；**勿用** `dazi-onto`）：
 
 ```powershell
-dazi onto script publish 项目/onto_<名>/脚本/functions/<file>.py --space <space-id> --register-function-id <id>
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py --space <space-id> --register-function-id <id>
 dazi onto function run <id> --space <space-id>
+# run 验证通过后，保存 test_arguments（侧栏「运行函数」预填；须用 ofn_xxx 内部 id，见 script-publish-run §7）
+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/script-publish-run`（侧栏 帮助 → 提示词），含 `test_arguments` JSON 格式与批量 `save_test_arguments.ps1`。

package/dist/prompts/onto/rule-seed.md

@@ -13,6 +13,9 @@
 
 ## 种子脚本模板
 
+建议将种子脚本保存到 `项目/<业务名>/本体/ontos/<实现名>/setup/<stem>_seed_rules.py`（与同实现的 init/seed 脚本并列）。  
+`space_id` 取自 `ontos/<实现名>/README.md`。
+
 ```python
 def main(params: dict, s=None) -> dict:
     """
@@ -34,9 +37,10 @@ def main(params: dict, s=None) -> dict:
     return {"upserted": len(rules), "result": result}
 ```
 
-执行命令（v3；**勿用** `dazi-onto`）：
+发布与执行（v3；**勿用** `dazi-onto`）：
 
 ```powershell
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/setup/<stem>_seed_rules.py --space <space-id> --type data
 dazi onto rule run-seed --space <space-id> --stem <seed_file_stem>
 ```
 

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

@@ -6,7 +6,7 @@
 
 ---
 
-你是搭子平台 **dazi-vscode v3** 本体实施助手。用户已完成或正在完成 `项目/onto_<名称>/规划/` 中的方案，你的任务是编写 `脚本/` 下 Python，并**用正确命令**发布与运行。
+你是搭子平台 **dazi-vscode v3** 本体实施助手。用户已完成或正在完成 `项目/<业务名>/本体/ontos/<实现名>/plans/` 中的方案，你的任务是编写 `setup/`、`functions/` 下 Python，并**用正确命令**发布与运行。
 
 ## 强制规则（违反会导致 CommandNotFound 或 404）
 
@@ -17,20 +17,35 @@
    - **仅开发仓库**：`node bundled/clis/dazi.js onto ...`（维护方打包用；客户环境用 `dazi.ps1`）
    - **完整路径**：`node <搭子仓库>/dazi/dazi-vscode/bundled/clis/dazi.js onto <子命令> ...`，并设置环境变量 `DAZI_BUNDLED_DIR=<同目录 bundled/clis>`
 4. **工作目录**必须是搭子工作区根（含 `项目/` 目录），例如 `dazi-work`。
-5. **`space_id`** 只从 `项目/onto_<名称>/README.md` 的「数据空间 ID」读取，禁止猜测。
+5. **`space_id`** 只从 `项目/<业务名>/本体/ontos/<实现名>/README.md` 的「数据空间 ID」读取，禁止猜测。
 
 ## 工作区目录（v3）
 
 ```text
 <工作区根>/
-  项目/onto_<名称>/
-    README.md          ← space_id（权威）
-    规划/              ← 规划 Markdown（本阶段不 publish）
-    脚本/
-      setup/           ← 初始化、灌数（先 init 后 seed）
-      functions/       ← 本体函数
-  资源/docs/           ← dazi docs sync 后的指南
-  scripts/             ← dazi.ps1 / dazi.cmd 包装（客户工作区模板应包含）
+  项目/<业务名>/
+    README.md                    ← 业务项目元信息
+    本体/
+      README.md                  ← 容器说明（onto-assets + ontos 索引）
+      onto-assets/               ← 平台元数据缓存（业务项目级，侧栏懒拉取）
+        objects/ functions/ actions/ rules/
+      ontos/
+        <实现名>/                ← ★ 本体实现工作单元
+          README.md              ← space_id（权威）
+          快速启动_<实现名>.md   ← 动态生成，含本实现命令模板
+          plans/                 ← 规划 Markdown（本阶段不 publish）
+          setup/                 ← 初始化、灌数（先 init 后 seed）
+          functions/             ← 本体函数
+            test_arguments/      ← 各 function_id 的默认测试入参 JSON
+            save_test_arguments.ps1  ← 可选：批量 save-test-arguments
+    流程/
+      plans/
+      flows/<流程名>/...
+    应用/
+      plans/
+      apps/<组件名>/...
+  资源/docs/                     ← dazi docs sync 后的指南
+  scripts/                       ← dazi.ps1 / dazi.cmd 包装（客户工作区模板应包含）
 ```
 
 本地开发路径 **不是** `onto/<space_id>/editorial/`；发布时 CLI 自动映射为平台路径  
@@ -49,24 +64,25 @@ dazi auth login
 
 ## 标准发布与运行顺序
 
-将 `<空间>`、`<项目路径>` 替换为实际值，例如 `space__0519`、`项目/onto_本体项目01`。
+将 `<业务名>`、`<实现名>`、`<空间>` 替换为实际值，例如 `潘达石化`、`本体01`、`space__0519`。  
+脚本路径前缀记为 `<项目路径>` = `项目/<业务名>/本体/ontos/<实现名>`。
 
 ### 1. 预检（可选）
 
 ```powershell
-dazi onto script publish-preview <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间> --type setup
+dazi onto script publish-preview <项目路径>/setup/xxx_ontology_init.py --space <空间> --type setup
 ```
 
 ### 2. 发布初始化脚本（setup）
 
 ```powershell
-dazi onto script publish <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间> --type setup
+dazi onto script publish <项目路径>/setup/xxx_ontology_init.py --space <空间> --type setup
 ```
 
 ### 3. 发布灌数脚本（data）
 
 ```powershell
-dazi onto script publish <项目路径>/脚本/setup/xxx_seed_data.py --space <空间> --type data
+dazi onto script publish <项目路径>/setup/xxx_seed_data.py --space <空间> --type data
 ```
 
 ### 4. 发布本体函数（**必须** `--register-function-id`，否则函数列表看不到）
@@ -76,7 +92,7 @@ dazi onto script publish <项目路径>/脚本/setup/xxx_seed_data.py --space <
 发布后必须确认输出含 `functionId` / `function_registration.ok`，并执行 `function list` 能看到该 id。
 
 ```powershell
-dazi onto script publish <项目路径>/脚本/functions/xxx_fn_yyy.py --space <空间> --register-function-id <domain>.fn.<name>
+dazi onto script publish <项目路径>/functions/xxx_fn_yyy.py --space <空间> --register-function-id <domain>.fn.<name>
 dazi onto function list --space <空间>
 ```
 
@@ -84,8 +100,8 @@ dazi onto function list --space <空间>
 
 ```powershell
 # 按 publish 返回的 scriptId，或：
-dazi onto script run --file <项目路径>/脚本/setup/xxx_ontology_init.py --space <空间>
-dazi onto script run --file <项目路径>/脚本/setup/xxx_seed_data.py --space <空间>
+dazi onto script run --file <项目路径>/setup/xxx_ontology_init.py --space <空间>
+dazi onto script run --file <项目路径>/setup/xxx_seed_data.py --space <空间>
 ```
 
 **顺序**：先 run init，再 run seed，再发布/运行函数。
@@ -103,13 +119,44 @@ $env:DAZI_PARAMS='{"start_date":"2025-01-01","end_date":"2026-12-31"}'
 dazi onto function run <function_id> --space <空间> --params $env:DAZI_PARAMS
 ```
 
+### 7. 保存测试参数（test_arguments，**发布后必做**）
+
+`publish` + `function run` **不会**自动写入测试参数。侧栏 **Onto → 运行函数** 依赖函数定义上的 **`test_arguments`** 预填表单；未保存时侧栏参数为空。
+
+**本地约定**（与 `plans/` 规划文档一致）：
+
+1. 每个函数一份 JSON：`<项目路径>/functions/test_arguments/<function_id>.json`
+2. 脚本内常量 `TEST_ARGUMENTS` 与 JSON **保持同步**
+3. JSON 格式：`{"v":1,"arguments":{...},"object_type_code":"<ObjectTypeCode>"}`
+
+**保存到平台**（`function run` 验证通过后）：
+
+```powershell
+# 推荐：批量脚本（解析 function list，用内部 id ofn_xxx 调用 PATCH）
+.\<项目路径>\functions\save_test_arguments.ps1
+```
+
+单条保存（**须用平台内部 id `ofn_xxx`**，先 `dazi onto function list --space <空间>` 查看；直接传 `sales.fn.xxx` 等 function_id 字符串可能 **404**）：
+
+```powershell
+dazi onto function save-test-arguments <ofn_internal_id> --space <空间> `
+  --arguments-json-file <项目路径>/functions/test_arguments/<function_id>.json
+```
+
+验收：
+
+```powershell
+dazi onto function get <function_id> --space <空间>
+# 确认 test_arguments 非 null，且 arguments 与 JSON 一致
+```
+
 ## 脚本类型与路径推断
 
-| 本地路径特征           | `--type`                   | 平台目录              |
-| ---------------------- | -------------------------- | --------------------- |
-| `脚本/setup/*init*.py` | `setup`                    | `setup/`              |
-| `脚本/setup/*seed*.py` | `data`                     | `data/`               |
-| `脚本/functions/*.py`  | （默认 ontology_function） | `ontology_functions/` |
+| 本地路径特征              | `--type`                   | 平台目录              |
+| ------------------------- | -------------------------- | --------------------- |
+| `.../setup/*init*.py`     | `setup`                    | `setup/`              |
+| `.../setup/*seed*.py`     | `data`                     | `data/`               |
+| `.../functions/*.py`      | （默认 ontology_function） | `ontology_functions/` |
 
 ## 编写脚本时注意
 
@@ -122,7 +169,7 @@ dazi onto function run <function_id> --space <空间> --params $env:DAZI_PARAMS
 ```powershell
 $env:DAZI_BUNDLED_DIR = "<绝对路径>/dazi/dazi-vscode/bundled/clis"
 cd <工作区根>
-node "<绝对路径>/dazi/dazi-vscode/bundled/clis/dazi.js" onto script publish <相对路径> --space <空间> --type setup
+node "<绝对路径>/dazi/dazi-vscode/bundled/clis/dazi.js" onto script publish 项目/<业务名>/本体/ontos/<实现名>/setup/xxx_ontology_init.py --space <空间> --type setup
 ```
 
 VS Code 用户也可在侧栏 **搭子 → Onto 本体** 使用「发布脚本」「运行函数」，无需终端。
@@ -141,6 +188,7 @@ VS Code 用户也可在侧栏 **搭子 → Onto 本体** 使用「发布脚本
 
 **用户补充上下文（可选）**：
 
-- 项目名称：{{project_name}}
+- 业务项目：{{business_name}}
+- 本体实现：{{item_name}}
 - 数据空间 ID：{{space_id}}
 - 当前任务：{{task}}（如：发布 training_ontology_init 并执行）

package/package.json

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

package/dist/examples/onto/function/profit_fn_customer_segmentation.py

@@ -1,117 +0,0 @@
-"""Customer Segmentation Function
-
-功能：基于利润贡献对客户进行分层
-参数：metric, method, start_date, end_date
-返回：客户分层数据（VIP/High/Medium/Low）
-
-放置位置：spaces/space__profit0520/editorial/scripts/ontology_functions/profit_fn_customer_segmentation.py
-检索关键字：profit customer_segmentation
-"""
-
-
-def _ontology_fn_body(p):
-    params = dict(p.get_params() or {})
-
-    metric = params.get("metric", "profit")
-    method = params.get("method", "quartile")
-    start_date = params.get("start_date", "")
-    end_date = params.get("end_date", "")
-
-    where_clause = ""
-    if start_date and end_date:
-        where_clause = f"WHERE order_date >= '{start_date}' AND order_date <= '{end_date}'"
-
-    sql = f"""
-    SELECT
-        customer_id,
-        customer_region,
-        sum(revenue) as revenue,
-        sum(cost) as cost,
-        sum(revenue) - sum(cost) as profit
-    FROM profit_analysis_fact
-    {where_clause}
-    GROUP BY customer_id, customer_region
-    ORDER BY profit DESC
-    """
-
-    result = p.sql.query(sql)
-
-    if not result:
-        return p.function_result(
-            columns=["customer_id", "customer_region", "revenue", "cost", "profit", "segment"],
-            data=[],
-            row_count=0
-        )
-
-    profits = [float(row.get("profit", 0) or 0) for row in result]
-    total = len(profits)
-
-    if total == 0:
-        return p.function_result(
-            columns=["customer_id", "customer_region", "revenue", "cost", "profit", "segment"],
-            data=[],
-            row_count=0
-        )
-
-    if method == "percentile":
-        sorted_profits = sorted(profits, reverse=True)
-        p80_idx = min(int(total * 0.8), total - 1)
-        p50_idx = min(int(total * 0.5), total - 1)
-        p20_idx = min(int(total * 0.2), total - 1)
-        p80 = sorted_profits[p80_idx]
-        p50 = sorted_profits[p50_idx]
-        p20 = sorted_profits[p20_idx]
-    else:
-        sorted_profits = sorted(profits, reverse=True)
-        q1_idx = min(int(total * 0.25), total - 1)
-        q2_idx = min(int(total * 0.5), total - 1)
-        q3_idx = min(int(total * 0.75), total - 1)
-        p80 = sorted_profits[q1_idx]
-        p50 = sorted_profits[q2_idx]
-        p20 = sorted_profits[q3_idx]
-
-    def get_segment(profit_val):
-        if profit_val >= p80:
-            return "VIP"
-        elif profit_val >= p50:
-            return "High"
-        elif profit_val >= p20:
-            return "Medium"
-        else:
-            return "Low"
-
-    data = []
-    for row in result:
-        profit = float(row.get("profit", 0) or 0)
-        data.append({
-            "customer_id": str(row.get("customer_id", "")),
-            "customer_region": str(row.get("customer_region", "")),
-            "revenue": round(float(row.get("revenue", 0) or 0), 2),
-            "cost": round(float(row.get("cost", 0) or 0), 2),
-            "profit": round(profit, 2),
-            "segment": get_segment(profit),
-        })
-
-    return p.function_result(
-        columns=["customer_id", "customer_region", "revenue", "cost", "profit", "segment"],
-        data=data,
-        row_count=len(data)
-    )
-
-
-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.space_id = str(ctx.space_id or "")
-    p.sql = s.sql
-
-    return _ontology_fn_body(p)

package/dist/examples/onto/function/profit_fn_mom_analysis.py

@@ -1,89 +0,0 @@
-"""MoM (Month-over-Month) Analysis Function
-
-功能：计算指定时间范围内的月度环比分析
-参数：start_date, end_date
-返回：月度利润数据及环比增长率
-
-放置位置：spaces/space__profit0520/editorial/scripts/ontology_functions/profit_fn_mom_analysis.py
-检索关键字：profit mom month-over-month
-"""
-
-
-def _ontology_fn_body(p):
-    params = dict(p.get_params() or {})
-
-    start_date = params.get("start_date", "")
-    end_date = params.get("end_date", "")
-
-    where_clause = ""
-    if start_date and end_date:
-        where_clause = f"WHERE order_date >= '{start_date}' AND order_date <= '{end_date}'"
-
-    sql = f"""
-    SELECT
-        formatDateTime(order_date, '%Y-%m') as year_month,
-        sum(revenue) as revenue,
-        sum(cost) as cost,
-        sum(revenue) - sum(cost) as profit,
-        if(sum(revenue) > 0, (sum(revenue) - sum(cost)) / sum(revenue), 0) as profit_margin
-    FROM profit_analysis_fact
-    {where_clause}
-    GROUP BY formatDateTime(order_date, '%Y-%m')
-    ORDER BY year_month
-    """
-
-    result = p.sql.query(sql)
-
-    if not result:
-        return p.function_result(
-            columns=["year_month", "revenue", "cost", "profit", "profit_margin", "mom_growth"],
-            data=[],
-            row_count=0
-        )
-
-    data = []
-    prev_profit = None
-
-    for row in result:
-        year_month = str(row.get("year_month", ""))
-        profit = float(row.get("profit", 0) or 0)
-
-        if prev_profit is not None and prev_profit != 0:
-            mom_growth = (profit - prev_profit) / prev_profit
-        else:
-            mom_growth = 0.0
-
-        data.append({
-            "year_month": year_month,
-            "revenue": round(float(row.get("revenue", 0) or 0), 2),
-            "cost": round(float(row.get("cost", 0) or 0), 2),
-            "profit": round(profit, 2),
-            "profit_margin": round(float(row.get("profit_margin", 0) or 0), 4),
-            "mom_growth": round(mom_growth, 4),
-        })
-
-        prev_profit = profit
-
-    return p.function_result(
-        columns=["year_month", "revenue", "cost", "profit", "profit_margin", "mom_growth"],
-        data=data,
-        row_count=len(data)
-    )
-
-
-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.space_id = str(ctx.space_id or "")
-    p.sql = s.sql
-
-    return _ontology_fn_body(p)

package/dist/examples/onto/function/profit_fn_top_products.py

@@ -1,89 +0,0 @@
-"""Top Products Profit Ranking Function
-
-功能：按利润或利润率排序，获取Top N产品
-参数：limit, metric, start_date, end_date
-返回：产品利润排行数据
-
-放置位置：spaces/space__profit0520/editorial/scripts/ontology_functions/profit_fn_top_products.py
-检索关键字：profit top_products ranking
-"""
-
-
-def _ontology_fn_body(p):
-    params = dict(p.get_params() or {})
-
-    limit = int(params.get("limit", 10) or 10)
-    metric = params.get("metric", "profit")
-    start_date = params.get("start_date", "")
-    end_date = params.get("end_date", "")
-
-    where_clause = ""
-    if start_date and end_date:
-        where_clause = f"WHERE order_date >= '{start_date}' AND order_date <= '{end_date}'"
-
-    if metric == "margin":
-        order_by = "profit_margin DESC"
-    else:
-        order_by = "profit DESC"
-
-    sql = f"""
-    SELECT
-        product_id,
-        product_category,
-        sum(revenue) as revenue,
-        sum(cost) as cost,
-        sum(revenue) - sum(cost) as profit,
-        if(sum(revenue) > 0, (sum(revenue) - sum(cost)) / sum(revenue), 0) as profit_margin
-    FROM profit_analysis_fact
-    {where_clause}
-    GROUP BY product_id, product_category
-    ORDER BY {order_by}
-    LIMIT {limit}
-    """
-
-    result = p.sql.query(sql)
-
-    if not result:
-        return p.function_result(
-            columns=["rank", "product_id", "product_category", "revenue", "cost", "profit", "profit_margin"],
-            data=[],
-            row_count=0
-        )
-
-    data = []
-    rank = 1
-    for row in result:
-        data.append({
-            "rank": rank,
-            "product_id": str(row.get("product_id", "")),
-            "product_category": str(row.get("product_category", "")),
-            "revenue": round(float(row.get("revenue", 0) or 0), 2),
-            "cost": round(float(row.get("cost", 0) or 0), 2),
-            "profit": round(float(row.get("profit", 0) or 0), 2),
-            "profit_margin": round(float(row.get("profit_margin", 0) or 0), 4),
-        })
-        rank += 1
-
-    return p.function_result(
-        columns=["rank", "product_id", "product_category", "revenue", "cost", "profit", "profit_margin"],
-        data=data,
-        row_count=len(data)
-    )
-
-
-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.space_id = str(ctx.space_id or "")
-    p.sql = s.sql
-
-    return _ontology_fn_body(p)