@dazitech/cli 3.0.7 → 3.0.8

package/dist/docs/onto//346/234/254/344/275/223/350/204/232/346/234/254/347/274/226/345/206/231/346/214/207/345/215/227.md

@@ -2,36 +2,47 @@
 
 **文档 ID**: `onto/script-authoring`
 
-本文说明本体项目内 **Python 脚本的目录、类型、发布与运行**（原独立的「脚本开发与发布」已与本文合并）。
+本文说明本体实现单元内 **Python 脚本的目录、类型、发布与运行**（原独立的「脚本开发与发布」已与本文合并）。
 
 > 终端命令均在 **`dazi-work` 根目录**执行：`dazi ...`（见 [CLI 调用约定](../guides/cli-invocation.md)）。
 
 ## 环境
 
 - 推荐 **Python 3.10+**
-- 脚本目录：**`<工作区根>/项目/onto_<项目名>/脚本/`**（新建本体项目时自动创建）
+- 脚本目录：**`<工作区根>/项目/<业务名>/本体/ontos/<实现名>/setup/`** 与 **`functions/`**（新建本体实现时自动创建）
 - 扩展默认脚本语言：`dazi.onto.defaultScriptLang` = `python`
 - 平台 API：`dazi.serverUrl`；登录：`dazi auth login` / `dazi auth set-token`
 
 ## 目录约定
 
 ```text
-<工作区根>/项目/onto_<项目名>/    ← 扩展「新建项目」；README 含 space_id
-├── README.md
-├── 快速启动.md
-├── 规划/
-└── 脚本/                          ← 所有本体 Python 脚本（函数/动作/灌数/初始化）
-    ├── main.py
-    └── ...
+<工作区根>/项目/<业务名>/              ← 业务项目根
+└── 本体/
+    └── ontos/<实现名>/                ← 本体实现单元；README 含 space_id
+        ├── README.md
+        ├── 快速启动_<实现名>.md
+        ├── plans/                     ← 规划阶段 Markdown 产出
+        ├── setup/                     ← 初始化、灌数脚本
+        └── functions/                 ← 本体函数、动作脚本
+            ├── test_arguments/        ← 各 function_id 的 test_arguments JSON
+            ├── save_test_arguments.ps1  ← 可选：批量写入平台（推荐）
+            └── *.py
 ```
 
-参考示例（可复制后修改）位于 **`资源/examples/onto/`**（侧栏 **帮助 → 示例** 或 `dazi examples sync`）。
+参考示例（可复制后修改）位于 **`资源/examples/onto/`**，按 **利润示例**、**销售示例** 两套打包（侧栏 **帮助 → 示例** 或 `dazi examples sync`）。
 
-> **不再使用** 历史路径 `onto/<space_id>/editorial/`、`editorial/functions/` 等作为本地开发约定。
+| 示例包 | 目录 | 规划文档 | 主要内容 |
+|--------|------|----------|----------|
+| **销售示例**（推荐） | `onto/销售示例/` | [规划示例_产品销售本体规划方案](./规划示例_产品销售本体规划方案.md) | `setup/sales_ontology_init.py`、`sales_seed_data.py`、7 个 `sales_fn_*.py`、`test_arguments/` |
+| **利润示例**（补充） | `onto/利润示例/` | [规划示例_利润分析本体方案](./规划示例_利润分析本体方案.md) | `setup/profit_ontology_init.py`、`profit_seed_data.py`、7 个 `profit_fn_*.py`、`test_arguments/` |
+
+总览说明：`资源/examples/onto/README.md`（`dazi examples show onto/readme`）。
+
+> **不再使用** 历史路径 `onto/<space_id>/editorial/`、`editorial/functions/`、`项目/onto_<名称>/脚本/` 等作为本地开发约定。
 
 ## 必读规范（DaziScript）
 
-编写 `脚本/` 下 `.py` 前请阅读：
+编写 `setup/`、`functions/` 下 `.py` 前请阅读：
 
 | 文档                                                                | 说明                                                                   |
 | ------------------------------------------------------------------- | ---------------------------------------------------------------------- |
@@ -40,22 +51,53 @@
 
 同步到工作区：`dazi docs sync` → `资源/docs/onto/`。
 
+## 初始化脚本标准顺序（setup）
+
+`*_ontology_init.py` 建议按以下顺序执行（与 [本体规划指南](./本体规划指南.md) 物理层 + 表间关系章节一致）：
+
+| 步骤 | 内容 | API |
+| ---- | ---- | --- |
+| 1 | 建表 | `s.sql.execute(CREATE TABLE ...)` |
+| 2 | 注册表 | `s.tables.register` + `s.tables.sync_columns` |
+| 3 | **注册表间关系** | `s.tables.add_relationship(...)` |
+| 4 | 注册 Cube / 派生度量 | `s.register_cube`、`s.upsert_derived_measures` |
+| 5 | 本体对象 / 属性 / 链接 | `s.onto.define_*`、`s.sync_metric_refs` |
+
+### 表间关系 `s.tables.add_relationship`
+
+在 **表 register 完成之后、Cube 注册之前** 调用；**幂等**，可重复执行 init。
+
+```python
+s.tables.add_relationship(
+    from_table="sales_order_fact",       # 通常为事实表
+    to_table="product_master",           # 维表
+    join_sql="sales_order_fact.product_id = product_master.product_id",
+    join_keys=[{"from": "product_id", "to": "product_id"}],
+    relationship_type="many_to_one",     # 默认 many_to_one
+    description="销售订单行关联产品主数据",
+)
+```
+
+验收：`dazi onto space get <space-id>` 中 **`relationship_count`** 与规划条数一致；侧栏 **数据资源 → 表间关系** 可见。
+
+> **勿与** `s.onto.define_link_type` 混淆：前者写数据空间元数据，后者写业务对象语义链接，**两者都需实施**。
+
 ## 脚本类型
 
-类型由 **发布命令参数** 区分；文件可平铺在 `脚本/`，也可分子目录（如 `脚本/functions/`、`脚本/actions/`）：
+类型由 **发布命令参数** 区分；初始化与灌数放 `setup/`，本体函数与动作放 `functions/`：
 
-| 类型                | 路径约定                          | 说明                                               |
-| ------------------- | --------------------------------- | -------------------------------------------------- |
-| `ontology_function` | `项目/onto_<项目名>/脚本/**/*.py` | **必须**带 `--register-function-id` 发布（见下节） |
-| `ontology_action`   | `项目/onto_<项目名>/脚本/**/*.py` | 发布时加 `--register-action-id` 等 Action 参数     |
-| `data_script`       | `项目/onto_<项目名>/脚本/**/*.py` | 普通 `script publish`，不注册函数/动作             |
+| 类型                | 路径约定                                                          | 说明                                               |
+| ------------------- | ----------------------------------------------------------------- | -------------------------------------------------- |
+| `ontology_function` | `项目/<业务名>/本体/ontos/<实现名>/functions/**/*.py`             | **必须**带 `--register-function-id` 发布（见下节） |
+| `ontology_action`   | `项目/<业务名>/本体/ontos/<实现名>/functions/**/*.py`             | 发布时加 `--register-action-id` 等 Action 参数     |
+| `data_script`       | `项目/<业务名>/本体/ontos/<实现名>/setup/**/*.py`                 | 普通 `script publish`，不注册函数/动作             |
 
-`<space-id>` 从 **`项目/onto_<项目名>/README.md`** 读取，勿手写错空间。
+`<space-id>` 从 **`项目/<业务名>/本体/ontos/<实现名>/README.md`** 读取，勿手写错空间。
 
 ## 发布预检
 
 ```powershell
-dazi onto script publish-preview 项目/onto_<项目名>/脚本/my_func.py --space <space-id>
+dazi onto script publish-preview 项目/<业务名>/本体/ontos/<实现名>/functions/my_func.py --space <space-id>
 ```
 
 ## 发布脚本
@@ -64,7 +106,7 @@ dazi onto script publish-preview 项目/onto_<项目名>/脚本/my_func.py --spa
 
 ### 本体函数：**必须注册**，否则侧栏与测试看不到
 
-`脚本/functions/`（或规划中的本体函数 `.py`）**不能**只执行「普通 publish」：
+`functions/`（或规划中的本体函数 `.py`）**不能**只执行「普通 publish」：
 
 | 仅 `script publish`（无 `--register-function-id`） | 带 `--register-function-id` 发布             |
 | -------------------------------------------------- | -------------------------------------------- |
@@ -84,16 +126,16 @@ dazi onto script publish-preview 项目/onto_<项目名>/脚本/my_func.py --spa
 
 ```powershell
 # 初始化 / 灌数：普通发布即可（不要加 register-function-id）
-dazi onto script publish 项目/onto_<项目名>/脚本/setup/xxx_ontology_init.py --space <space-id> --type setup
-dazi onto script publish 项目/onto_<项目名>/脚本/setup/xxx_seed_data.py --space <space-id> --type data
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/setup/xxx_ontology_init.py --space <space-id> --type setup
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/setup/xxx_seed_data.py --space <space-id> --type data
 
 # ★ 本体函数：必须注册（示例）
-dazi onto script publish 项目/onto_<项目名>/脚本/functions/get_summary.py `
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/functions/get_summary.py `
   --space <space-id> `
   --register-function-id sales.fn.get_summary
 
 # 发布并注册为本体动作（示例）
-dazi onto script publish 项目/onto_<项目名>/脚本/my_action.py `
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/functions/my_action.py `
   --space <space-id> `
   --register-action-id my_action_code `
   --register-action-permission-tag "finance.write"
@@ -103,9 +145,55 @@ dazi onto script publish 项目/onto_<项目名>/脚本/my_action.py `
 
 ```powershell
 dazi onto function list --space <space-id>
-dazi onto function run sales.fn.get_summary --space <space-id>
+dazi onto function run sales.fn.get_summary --space <space-id> --params '{}'
+```
+
+### 函数测试参数（test_arguments，**发布后必做**）
+
+仅 `publish` + `function run` **不会**自动写入测试参数；侧栏 **Onto → 运行函数** 依赖函数定义上的 **`test_arguments`** 预填表单。
+
+**本地约定（与规划文档 § 函数 / test_arguments 一致）**：
+
+1. 每个函数一份 JSON：`functions/test_arguments/<function_id>.json`
+2. 脚本内同名常量 `TEST_ARGUMENTS`（与 JSON **保持同步**）
+3. 函数 `main()` 通过 `ctx.params` 读取的键名 = JSON 内 **`arguments`** 对象的键名
+
+**JSON 格式**（与平台函数定义一致）：
+
+```json
+{
+  "v": 1,
+  "arguments": {
+    "start_date": "2025-01-01",
+    "end_date": "2026-06-30"
+  },
+  "object_type_code": "SalesAnalysis"
+}
+```
+
+**保存到平台**（函数 `run` 验证通过后）：
+
+```powershell
+# 推荐：批量脚本（解析 function list，用内部 id ofn_xxx 调用 PATCH）
+.\项目/<业务名>/本体/ontos/<实现名>/functions/save_test_arguments.ps1
+```
+
+单条保存（**须用平台内部 id `ofn_xxx`**，先 `dazi onto function list --space <space-id>` 查看；直接传 `sales.fn.xxx` 可能 **404**）：
+
+```powershell
+dazi onto function save-test-arguments ofn_156a399fbe0e4636 --space <space-id> `
+  --arguments-json-file 项目/<业务名>/本体/ontos/<实现名>/functions/test_arguments/sales.fn.get_summary.json
 ```
 
+**PowerShell 传 `--params` 易丢引号**；测试运行可省略 `--params`（用 `{}`），或：
+
+```powershell
+$env:DAZI_PARAMS='{"start_date":"2025-01-01","end_date":"2026-06-30"}'
+dazi onto function run sales.fn.get_summary --space <space-id> --params $env:DAZI_PARAMS
+```
+
+验收：`dazi onto function get <function_id> --space <space-id>` 中 **`test_arguments` 非 null**，且 `arguments` 与 JSON 一致。
+
 亦可在 VS Code 侧栏 **Onto 本体 → 发布函数** 发布（须填写/绑定 **function_id**）；发布后在 **函数** 节点下应能看到该函数。
 
 函数生命周期与 `update-code` 详见 **[本体函数开发指南](./function-guide.md)**。给 TRAE 的完整命令模板见内置提示词 **`onto/script-publish-run`**（`dazi prompt sync` 后位于 `资源/prompts/onto/`）。
@@ -115,12 +203,16 @@ dazi onto function run sales.fn.get_summary --space <space-id>
 若需将平台上已有脚本拉回本地对照（**非**日常开发主路径）：
 
 ```powershell
+# 推荐：落盘到本体实现目录（按 setup / functions 分子目录）
+dazi onto script sync --space <space-id> --target-dir 项目/<业务名>/本体/ontos/<实现名>
+dazi onto script sync --space <space-id> --type ontology_function --target-dir 项目/<业务名>/本体/ontos/<实现名>
+dazi onto script sync --space <space-id> --dry-run --target-dir 项目/<业务名>/本体/ontos/<实现名>
+
+# legacy：onto/<space-id>/scripts/（非日常开发入口）
 dazi onto script sync --space <space-id>
-dazi onto script sync --space <space-id> --type ontology_function
-dazi onto script sync --space <space-id> --dry-run
 ```
 
-拉取目标目录以 CLI 为准；**新建与修改仍以 `项目/onto_<项目名>/脚本/` 为准**。
+拉取目标目录以 CLI 为准；**新建与修改仍以 `项目/<业务名>/本体/ontos/<实现名>/setup/` 与 `functions/` 为准**。
 
 ## 清理重复脚本
 
@@ -131,10 +223,21 @@ dazi onto script dedupe --space <space-id> --yes
 
 ## 编写建议
 
-1. 先阅读 `快速启动.md` 与 `README.md` 中的**数据空间 ID**
-2. 在 `脚本/` 中按模块拆分 `.py`（初始化、灌数、本体函数可分机文件）
-3. 发布与运行：`dazi onto script publish`（**函数必须** `--register-function-id`）/ 侧栏 **Onto 本体**；函数运行见 **[function-guide](./function-guide.md)**、**[action-guide](./action-guide.md)**
-4. 本地仅调试 Python 语法时可用 VS Code 运行 `脚本/main.py`（**不会**自动连平台；连平台须发布后在侧栏或 CLI 执行）
+1. 先阅读 `快速启动_<实现名>.md` 与 `README.md` 中的**数据空间 ID**，并对照 `plans/` 中**表间关系**与**函数 test_arguments** 章节
+2. 在 `setup/`、`functions/` 中按模块拆分 `.py`（初始化、灌数、本体函数可分机文件）
+3. **init 脚本**必须包含 `s.tables.add_relationship`（若规划有表间关系）
+4. 发布与运行：`dazi onto script publish`（**函数必须** `--register-function-id`）→ `function run` 验证 → **`save-test-arguments`**
+5. 本地仅调试 Python 语法时可在 VS Code 中直接运行 `.py`（**不会**自动连平台；连平台须发布后在侧栏或 CLI 执行）
+
+## 实施自检（智能体 / 人工）
+
+| 检查项 | 命令 / 位置 |
+| ------ | ----------- |
+| 表已注册 | 侧栏 **数据资源** 或 `dazi onto space get` → `table_count` |
+| **表间关系已注册** | `relationship_count` > 0；侧栏 **表间关系** |
+| 函数已注册 | `dazi onto function list --space <space-id>` |
+| **test_arguments 已保存** | `dazi onto function get <function_id>` → `test_arguments.arguments` |
+| 函数可运行 | `dazi onto function run <function_id> --space <space-id> --params '{}'` |
 
 ## 相关文档
 
@@ -142,4 +245,5 @@ dazi onto script dedupe --space <space-id> --yes
 - [本体规划指南](./本体规划指南.md)
 - [本体函数开发指南](./function-guide.md)
 - [本体动作开发](./action-guide.md)
-- [规划示例：利润分析本体](./规划示例_利润分析本体方案.md)
+- [规划示例：产品销售本体（推荐）](./规划示例_产品销售本体规划方案.md)
+- [规划示例：利润分析本体（补充）](./规划示例_利润分析本体方案.md)

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

@@ -2,12 +2,14 @@
 
 ## 目标
 
-在 `规划/` 目录中完成本体项目的概念设计，包括：
+在 `plans/` 目录中完成本体实现单元的概念设计，包括：
 
 - 业务域与边界
 - 对象类型（Object Type）与关键属性
-- 链接类型（Link Type）与基数
+- **物理表间关系**（事实表 → 维表的 JOIN / FK 语义）
+- 链接类型（Link Type）与基数（**业务对象层**，与表间关系分层写清）
 - 动作（Action）与规则（Rule）的初步清单
+- 本体函数清单及 **test_arguments**（默认测试入参）约定
 
 ## 本体、Cube 与物理表：三者关系与「业务世界」方法
 
@@ -25,22 +27,46 @@
 - 接受 **多对一**：多表、多 Cube 可收敛为一种业务对象；一宽表也可拆成多种业务对象。
 - **链接**两端必须是对象类型 **`code`**，不是 Cube 名；表中仅有 `xxx_id` 时，规划文中仍应写清本体链接语义。
 
+### 物理表间关系 vs 本体链接（强制分层）
+
+| 维度 | **物理表间关系** | **本体链接（Link Type）** |
+| ---- | ---------------- | ------------------------- |
+| 所在层 | 数据空间 / ClickHouse | 本体 Ontology |
+| 规划章节 | 物理层设计 → **「表间关系」**（建议 §3.x） | 本体层设计 → **「链接类型」** |
+| 侧栏可见 | **数据资源 → 数据空间 → 表间关系** | **Onto 本体 → 链接** |
+| 实施 API | `s.tables.add_relationship(...)`（init 脚本，**表 register 之后**） | `s.onto.define_link_type(...)` |
+| 典型形态 | 事实表 `many_to_one` 维表（`product_id` → `product_master`） | `SalesOrder` → `Product`（订单包含产品） |
+
+**常见遗漏**：只写本体 `define_link_type`，init 脚本未调用 `add_relationship` → 空间 **`relationship_count` 为 0**，流程多表 JOIN、AI 读空间上下文时缺少关系元数据。
+
+**规划文档必含「表间关系」小节**，至少列清：
+
+| 列 | 说明 |
+| -- | ---- |
+| 从表 / 到表 | 物理表名，通常 **从事实表到维表** |
+| 关系类型 | 如 `many_to_one` |
+| join_keys | 如 `product_id → product_id` |
+| join_sql | 如 `sales_order_fact.product_id = product_master.product_id` |
+| 对应本体链接 | 可选对照表，便于评审 |
+
 **与业界对象中心实践的对照**：上述分层与「对象优先、数据为 backing」的思路，可与 **Palantir Foundry Ontology**（对象类型、链接、Action、Function 分层）等成熟产品对照阅读；落地脚本时以平台当前 API 与 **`dazi onto`** 能力为准，**不**假设已实现对方全部特性。
 
 ## 必读文档
 
-1. **本体规划示例**：`规划示例_利润分析本体方案.md`（扩展内置于 `docs/onto/`；同步到工作区后为 `资源/docs/onto/规划示例_利润分析本体方案.md`）
-2. **工作区与 CLI**：`guides/workspace-v3.md`、`guides/cli-reference.md`（`dazi docs sync` 后位于 `资源/docs/guides/`）
+1. **本体规划示例（推荐）**：[`规划示例_产品销售本体规划方案.md`](./规划示例_产品销售本体规划方案.md) — 含表间关系、test_arguments 与完整脚本对照（`dazi docs sync` 后位于 `资源/docs/onto/`）
+2. **补充示例**：[`规划示例_利润分析本体方案.md`](./规划示例_利润分析本体方案.md) — 利润分析域参考
+3. **工作区与 CLI**：`guides/workspace-v3.md`、`guides/cli-reference.md`（`dazi docs sync` 后位于 `资源/docs/guides/`）
+4. **可运行脚本示例**：`资源/examples/onto/销售示例/`（推荐）、`资源/examples/onto/利润示例/`（`dazi examples sync` 或侧栏 **帮助 → 示例**）
 
 ## 产出约定
 
-- **本体方案（规划文档）**：新建/修改的 Markdown **必须**落在 **`项目/{{项目名称}}/规划/<规划主题>.md`**（这是规划阶段的真产出；**不是**改 `本体规划指南.md`）。
+- **本体方案（规划文档）**：新建/修改的 Markdown **必须**落在 **`项目/<业务名>/本体/ontos/<实现名>/plans/<规划主题>.md`**（这是规划阶段的真产出；**不是**改 `本体规划指南.md`）。
 - 进入脚本实现阶段：遵循 **`本体脚本编写指南.md`**（含发布）、**`function-guide.md`**。
 
 ## 空间约束（强制）
 
-- 本体项目创建时已绑定 **数据空间**；`space_id` 以 **`项目/<文件夹名>/README.md`** 为准。
-- 若 README 中无 `space_id`（非扩展「新建项目」创建的本体项目），不得新建规划文件，须先让用户补全空间或重新创建项目。
+- 本体实现单元创建时已绑定 **数据空间**；`space_id` 以 **`项目/<业务名>/本体/ontos/<实现名>/README.md`** 为准。
+- 若 README 中无 `space_id`（非扩展「新建本体实现」创建），不得新建规划文件，须先让用户补全空间或重新创建实现单元。
 
 ## LLM 执行指引（必须遵循）
 
@@ -50,22 +76,27 @@
 
 - **工作区根**：VS Code 已打开的文件夹；多根工作区时在设置 **`dazi.workspaceRoot`** 指定。
 - **平台与登录**：`dazi.serverUrl`；`dazi auth login` 或 `dazi auth set-token`（Token 存 `.dazi/auth.json`）。
-- **本体项目即工作单元**（扩展「新建项目」时已选定数据空间，**无需**再建 `onto/<space_id>/` 等平行目录）：
+- **业务项目与本体实现单元**（扩展「新建本体实现」时已选定数据空间，**无需**再建 `onto/<space_id>/` 等平行目录）：
 
 ```text
 <工作区根>/
-  项目/onto_<名称>/
-    README.md       ← 数据空间 ID、项目元信息（规划/实施均以此为准）
-    规划/           ← 规划阶段 Markdown 产出
-    脚本/           ← 本体 Python 脚本
-  资源/docs/onto/   ← 本体指南与规划示例（dazi docs sync）
-  资源/dataspaces/  ← 侧栏下载的表结构 Markdown
+  项目/<业务名>/                    ← 业务项目根
+    本体/                           ← 本体根目录
+      ontos/<实现名>/               ← 本体实现单元（工作单元）
+        README.md                   ← 数据空间 ID、实现元信息（规划/实施均以此为准）
+        快速启动_<实现名>.md
+        plans/                      ← 规划阶段 Markdown 产出
+        setup/                      ← 初始化 / 灌数脚本
+        functions/                  ← 本体函数 / 动作脚本
+          test_arguments/           ← 各 function_id 的 test_arguments JSON（与 .py 内 TEST_ARGUMENTS 同步）
+  资源/docs/onto/                   ← 本体指南与规划示例（dazi docs sync）
+  资源/dataspaces/                  ← 侧栏下载的表结构 Markdown
 ```
 
 ### 规划开始前
 
-1. 从 **`项目/<文件夹名>/README.md`** 读取 **数据空间 ID**（可与设置 `dazi.spaceId` 对照，以 README 为准）。
-2. 未绑定 `space_id` 时 **不得** 新建规划 Markdown，须先让用户通过扩展创建本体项目或明确空间。
+1. 从 **`项目/<业务名>/本体/ontos/<实现名>/README.md`** 读取 **数据空间 ID**（可与设置 `dazi.spaceId` 对照，以 README 为准）。
+2. 未绑定 `space_id` 时 **不得** 新建规划 Markdown，须先让用户通过扩展创建本体实现单元或明确空间。
 
 ### 规划阶段最小流程
 
@@ -77,7 +108,7 @@ dazi auth whoami
 dazi docs sync    # 可选：同步帮助文档到 资源/docs/
 ```
 
-**核对数据空间与现网资产**（`<space_id>` 取自当前项目的 `README.md`，勿另猜目录）：
+**核对数据空间与现网资产**（`<space_id>` 取自当前实现单元的 `README.md`，勿另猜目录）：
 
 ```bash
 dazi onto space list
@@ -86,32 +117,40 @@ dazi onto space get <space_id>    # 可选：查看空间详情
 
 **扩展侧栏（规划阶段主要入口）**：
 
-| 目的          | 操作                                                  |
-| ------------- | ----------------------------------------------------- |
-| 确认绑定空间  | 打开 **`项目/onto_<名称>/README.md`** 中的数据空间 ID |
-| 查看表 / Cube | **数据资源** → 对应数据空间 → 展开表、Cube            |
-| 下载表结构    | 表节点右键「下载表信息」→ `资源/dataspaces/`          |
-| 同步帮助文档  | **帮助** → 下载文档（`dazi docs sync`）               |
+| 目的          | 操作                                                                                  |
+| ------------- | ------------------------------------------------------------------------------------- |
+| 确认绑定空间  | 打开 **`项目/<业务名>/本体/ontos/<实现名>/README.md`** 中的数据空间 ID               |
+| 查看表 / Cube | **数据资源** → 对应数据空间 → 展开表、Cube                                            |
+| 下载表结构    | 表节点右键「下载表信息」→ `资源/dataspaces/`                                          |
+| 同步帮助文档  | **帮助** → 下载文档（`dazi docs sync`）                                               |
 
 > 规划阶段**不**要求本地 `snapshot.json`、`editorial/` 或 `onto/<space_id>/` 目录；以侧栏 **数据资源** 与项目内文档为准即可。
 
-规划阶段 **只产出 Markdown**：写入 **`项目/<onto_项目>/规划/<主题>.md`**，可参考 **`规划示例_利润分析本体方案.md`**。此阶段不发布脚本。
+规划阶段 **只产出 Markdown**：写入 **`项目/<业务名>/本体/ontos/<实现名>/plans/<主题>.md`**，**首选参考** [`规划示例_产品销售本体规划方案.md`](./规划示例_产品销售本体规划方案.md)。此阶段不发布脚本。
 
 ### 进入脚本实施
 
-脚本写在 **`项目/<onto_项目>/脚本/`**（Python，见 `dazi.onto.defaultScriptLang`）。发布与运行见 **`本体脚本编写指南.md`**、**`function-guide.md`**：
+脚本写在 **`项目/<业务名>/本体/ontos/<实现名>/setup/`**（初始化、灌数）与 **`functions/`**（本体函数、动作；Python，见 `dazi.onto.defaultScriptLang`）。发布与运行见 **`本体脚本编写指南.md`**、**`function-guide.md`**：
 
 ```bash
-dazi onto script publish-preview 项目/onto_<名称>/脚本/my_func.py --space <space_id>
-dazi onto script publish 项目/onto_<名称>/脚本/my_func.py \
+dazi onto script publish-preview 项目/<业务名>/本体/ontos/<实现名>/functions/my_func.py --space <space_id>
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/functions/my_func.py \
   --space <space_id> \
   --register-function-id <function_id>
 dazi onto function run <function_id> --space <space_id> --params '{}'
+# 函数测试通过后，保存 test_arguments（侧栏「运行函数」预填参数，见本体脚本编写指南）
 ```
 
-亦可在侧栏 **Onto 本体** 使用「发布函数」「运行函数」等命令（与终端 CLI **同源** bundled；`--space` 与项目 README 中的 `space_id` 一致）。
+亦可在侧栏 **Onto 本体** 使用「发布函数」「运行函数」等命令（与终端 CLI **同源** bundled；`--space` 与实现单元 README 中的 `space_id` 一致）。
+
+**实施顺序（强制）**：
+
+1. `setup/*_ontology_init.py`：建表 → `tables.register` → **`tables.add_relationship`** → Cube → 本体对象/链接  
+2. `setup/*_seed_data.py`：灌数（幂等）  
+3. `functions/*.py`：发布并 **`--register-function-id`**  
+4. 运行函数验证 → **`save-test-arguments`** 写入各函数定义的 `test_arguments`
 
-实施前可用 `dazi onto function list --space <space_id>` 核对平台已有函数定义，**开发入口始终是 `项目/<onto_项目>/脚本/`**，不以历史 `onto/`、`editorial` 目录为约定路径。
+实施前可用 `dazi onto function list --space <space_id>` 核对平台已有函数定义；`dazi onto space get <space_id>` 核对 **`relationship_count`** 是否与规划一致。
 
 ### 失败处理
 
@@ -121,11 +160,14 @@ dazi onto function run <function_id> --space <space_id> --params '{}'
 ## 自检
 
 - 是否写清对象类型、链接、函数/Action、规则（如适用）
+- **物理表间关系**：是否单独成章（从表/到表、join_keys、join_sql、关系类型）；是否与 init 脚本步骤对应
 - **`define_link_type` 与对象类型 code**：链接两端须为**已规划且将先创建**的对象类型 **`code`**（与 `define_object_type` 一致）；**勿**将 **Cube 名** 或表名当作对象类型 `code`。勿混用仅中文名而无稳定 `code`。
-- 是否给出实施步骤、风险与验收
+- **函数 test_arguments**：每个 `function_id` 是否在规划中列出默认参数；是否与 `functions/test_arguments/<function_id>.json` 一致
+- 是否给出实施步骤、风险与验收（含 **relationship_count**、**test_arguments 非 null**）
 
 ## 相关文档
 
 - [本体脚本编写指南](./本体脚本编写指南.md)
 - [本体规划指南](./本体规划指南.md)
-- [本体规划示例文档](./规划示例_利润分析本体方案.md)
+- [规划示例：产品销售本体（推荐）](./规划示例_产品销售本体规划方案.md)
+- [规划示例：利润分析本体（补充）](./规划示例_利润分析本体方案.md)