@dazitech/cli 3.0.7 → 3.0.8

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.7",
+  "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)

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

@@ -1,89 +0,0 @@
-"""YoY (Year-over-Year) Analysis Function
-
-功能：计算指定时间范围内的年度同比分析
-参数：start_date, end_date
-返回：年度利润数据及同比增长率
-
-放置位置：spaces/space__profit0520/editorial/scripts/ontology_functions/profit_fn_yoy_analysis.py
-检索关键字：profit yoy year-over-year
-"""
-
-
-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
-        toYear(order_date) as year,
-        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 toYear(order_date)
-    ORDER BY year
-    """
-
-    result = p.sql.query(sql)
-
-    if not result:
-        return p.function_result(
-            columns=["year", "revenue", "cost", "profit", "profit_margin", "yoy_growth"],
-            data=[],
-            row_count=0
-        )
-
-    data = []
-    prev_profit = None
-
-    for row in result:
-        year = int(row.get("year", 0))
-        profit = float(row.get("profit", 0) or 0)
-
-        if prev_profit is not None and prev_profit != 0:
-            yoy_growth = (profit - prev_profit) / prev_profit
-        else:
-            yoy_growth = 0.0
-
-        data.append({
-            "year": year,
-            "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),
-            "yoy_growth": round(yoy_growth, 4),
-        })
-
-        prev_profit = profit
-
-    return p.function_result(
-        columns=["year", "revenue", "cost", "profit", "profit_margin", "yoy_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)