@dazitech/cli 3.0.9 → 3.1.1

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

package/dist/examples/onto/index.json

@@ -0,0 +1,53 @@
+{
+  "version": "1.0",
+  "updatedAt": "2026-06-06",
+  "defaultReadOrder": [],
+  "examples": [
+    {
+      "id": "sales",
+      "dir": "销售示例",
+      "title": "产品销售分析",
+      "domain": [
+        "销售",
+        "订单",
+        "产品",
+        "渠道",
+        "SKU",
+        "客户"
+      ],
+      "planPrimary": "plans/规划示例_产品销售本体规划方案.md",
+      "featured": true
+    },
+    {
+      "id": "profit",
+      "dir": "利润示例",
+      "title": "利润 / GL 分析",
+      "domain": [
+        "利润",
+        "科目",
+        "预算",
+        "GL",
+        "成本中心",
+        "预实"
+      ],
+      "planPrimary": "plans/规划示例_利润分析本体方案.md",
+      "featured": true
+    },
+    {
+      "id": "equip-ops",
+      "dir": "设备运营",
+      "title": "化工设备运营分析",
+      "domain": [
+        "设备",
+        "OEE",
+        "停机",
+        "维保",
+        "能耗",
+        "工厂",
+        "运营"
+      ],
+      "planPrimary": "plans/化工设备运营分析本体方案.md",
+      "featured": true
+    }
+  ]
+}

package/dist/examples/onto/index.yaml

@@ -0,0 +1,29 @@
+version: "1.0"
+updatedAt: "2026-06-07"
+
+# 规划 / 脚本阶段须至少阅读 defaultReadOrder 中一个完整示例（README + plans 主文档）
+defaultReadOrder:
+  - 销售示例
+  - 设备运营
+
+examples:
+  - id: sales
+    dir: 销售示例
+    title: 产品销售分析
+    domain: [销售, 订单, 产品, 渠道, SKU, 客户]
+    planPrimary: plans/规划示例_产品销售本体规划方案.md
+    featured: true
+
+  - id: profit
+    dir: 利润示例
+    title: 利润 / GL 分析
+    domain: [利润, 科目, 预算, GL, 成本中心, 预实]
+    planPrimary: plans/规划示例_利润分析本体方案.md
+    featured: true
+
+  - id: equip-ops
+    dir: 设备运营
+    title: 化工设备运营分析
+    domain: [设备, OEE, 停机, 维保, 能耗, 工厂, 运营]
+    planPrimary: plans/化工设备运营分析本体方案.md
+    featured: true

package/dist/examples/onto//345/210/251/346/266/246/347/244/272/344/276/213/README.md

@@ -0,0 +1,23 @@
+# 利润示例 · GL / 利润分析
+
+## 基本信息
+
+| 字段 | 内容 |
+| --- | --- |
+| 数据空间 | 以示例脚本内 `space_id` 为准（复制后改 README） |
+| 示例 ID | `profit`（见 `../index.yaml` / `index.json`） |
+
+## 目录
+
+| 路径 | 说明 |
+| --- | --- |
+| [plans/规划示例_利润分析本体方案.md](./plans/规划示例_利润分析本体方案.md) | **规划正文** |
+| `setup/` | `profit_ontology_init.py`、`profit_seed_data.py`、`profit_category_mount.py` |
+| `functions/` | 7 个 `profit_fn_*.py`、`test_arguments/` |
+
+## 使用
+
+- **规划阶段**：通读 `plans/*.md`；与 [销售示例](../销售示例/) 对照时写清差异说明
+- **实施阶段**：init **不含** `apply_registry`；分类在 `profit_category_mount.py`（最后执行）
+
+规范指南：`资源/docs/onto/本体规划指南.md`

package/dist/examples/onto//345/210/251/346/266/246/347/244/272/344/276/213/functions/save_test_arguments.ps1

@@ -3,7 +3,6 @@
 # 用法：在 dazi-work 根目录执行 .\项目\DAZI_TEST\本体\ontos\利润分析示例\functions\save_test_arguments.ps1
 
 $spaceId = "space__misc_01"
-$itemPath = "项目/DAZI_TEST/本体/ontos/利润分析示例/functions"
 
 $functions = @(
     @{fn_id="profit.fn.get_summary"; file="profit.fn.get_summary.json"},
@@ -16,23 +15,25 @@ $functions = @(
 )
 
 Write-Host "获取函数列表..."
-$fnList = & dazi onto function list --space $spaceId 2>$null
+$fnListRaw = & dazi onto function list --space $spaceId --json 2>&1
+$jsonLines = ($fnListRaw | Where-Object { $_ -notmatch '__JSON_SUMMARY__' }) -join "`n"
+$fnList = $jsonLines | ConvertFrom-Json
 
 foreach ($fn in $functions) {
     $fnId = $fn.fn_id
     $fileName = $fn.file
     $jsonPath = "$PSScriptRoot/test_arguments/$fileName"
 
-    $ofnId = $fnList | Where-Object { $_ -match $fnId } | ForEach-Object {
-        if ($_ -match 'id:\s*(\S+)') { $matches[1] }
+    if (-not (Test-Path $jsonPath)) {
+        Write-Host "跳过 $fnId：找不到 $jsonPath"
+        continue
     }
-    
-    if ($ofnId) {
-        Write-Host "保存 $fnId (ofnId=$ofnId)..."
-        & dazi onto function save-test-arguments $ofnId --space $spaceId --arguments-json-file $jsonPath
-    } else {
-        Write-Host "函数 $fnId 未找到，请先发布函数"
+
+    Write-Host "保存 $fnId ..."
+    & dazi onto function save-test-arguments --function-id $fnId --space $spaceId --arguments-json-file $jsonPath
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "  ✗ 保存失败" -ForegroundColor Red
     }
 }
 
-Write-Host "完成"
+Write-Host "完成"

package/dist/{docs/onto → examples/onto//345/210/251/346/266/246/347/244/272/344/276/213/plans}//350/247/204/345/210/222/347/244/272/344/276/213_/345/210/251/346/266/246/345/210/206/346/236/220/346/234/254/344/275/223/346/226/271/346/241/210.md

@@ -2,8 +2,10 @@
 
 **文档 ID**: `onto/planning-example-profit`
 
+> **只读参照**：本文档供学习 GL 域规划**结构**与验收口径，**不得**整篇复制为本项目 `plans/` 充数。新建实现须在 `plans/` **独立撰写**，并含「与参照示例的差异说明」章节（见 [本体规划指南 · 任务模式](./本体规划指南.md#任务模式与反模式)）。
+
 > 表/Cube/对象命名遵循 [本体命名规范](./本体命名规范_物理表Cube与对象.md)。  
-> 工程模式参考：[规划示例_产品销售本体规划方案.md](./规划示例_产品销售本体规划方案.md)
+> 工程模式参考：[销售示例 plans](../../销售示例/plans/规划示例_产品销售本体规划方案.md)
 
 **占位符**（复制到工作区 `plans/` 后替换为实际值）：
 
@@ -59,7 +61,7 @@
 
 **物理表清单**（命名见 [命名规范 §2](./本体命名规范_物理表Cube与对象.md#2-物理表类别与前缀)）：
 
-| 表名 | 前缀类别 | **347 分类** | 显示名 | 说明 | 角色 |
+| 表名 | 前缀类别 | **平台分类** | 显示名 | 说明 | 角色 |
 | ---- | -------- | ------------ | ------ | ---- | ---- |
 | **`dim_date`** | 时间维（**强制**） | **时间维** | 日期维表 | 与 sales 域共用；PK **`date_key`** | 时间维 |
 | `dim_account` | dim | **维度表** | 科目维表 | 会计科目主数据 | dim |
@@ -68,13 +70,13 @@
 | **`fact_budget_entry`** | fact | **事实表** | 预算明细 | 预算行粒度编制数据；含 **date_key** | fact |
 
 > 规划原则：先定义 **Account、JournalEntry、BudgetLine** 等业务对象与链接，再反推 Cube 与物理表。旧版 `profit_analysis_fact`（订单粒度）**不作为主模型**。  
-> init 脚本 `资源/examples/onto/利润示例/setup/profit_ontology_init.py` 顶部 **`TABLE_REGISTRY`** 与上表及 §3.x 字段 **显示名/说明** 一一对应，经 `s.tables.register_with_meta` 注册；**`CATEGORY_REGISTRY`** 见 [附录 B](#附录-b347-分类挂载对照表category_registry)。
+> init 脚本 `资源/examples/onto/利润示例/setup/profit_ontology_init.py` 顶部 **`TABLE_REGISTRY`** 与上表及 §3.x 字段 **显示名/说明** 一一对应，经 `s.tables.register_with_meta` 注册；**`CATEGORY_REGISTRY`** 见 [附录 B](#附录-b平台-分类挂载对照表category_registry)，由 **`profit_category_mount.py`** 在流程最后执行（init **不含**分类挂载）。
 
 ## 三、物理层设计
 
 ### 3.0 时间维：dim_date（强制）
 
-与销售域共用；字段定义见 [销售规划示例 §3.0](./规划示例_产品销售本体规划方案.md#30-时间维dim_date强制)。分录 **`date_key = toYYYYMMDD(posting_date)`**；预算行可用 **`toYYYYMMDD(toDate(concat(toString(fiscal_year), '-', lpad(toString(fiscal_period), 2, '0'), '-01')))`** 或 period 末代表日，规划须写清口径。
+与销售域共用；字段定义见 [销售示例 §3.0](../../销售示例/plans/规划示例_产品销售本体规划方案.md#30-时间维dim_date强制)。分录 **`date_key = toYYYYMMDD(posting_date)`**；预算行可用 **`toYYYYMMDD(toDate(concat(toString(fiscal_year), '-', lpad(toString(fiscal_period), 2, '0'), '-01')))`** 或 period 末代表日，规划须写清口径。
 
 ### 3.1 维度表：dim_account
 
@@ -203,7 +205,7 @@
 
 **关系清单（8 条）**：
 
-| 关系 ID | **347 分类** | 类型 | 从表 | 到表 | join_keys | 说明 |
+| 关系 ID | **平台分类** | 类型 | 从表 | 到表 | join_keys | 说明 |
 | ------- | ------------ | ---- | ---- | ---- | --------- | ---- |
 | rel_journal_date | **时间关联** | many_to_one | fact_gl_journal_entry | dim_date | date_key → date_key | 分录关联日历 |
 | rel_budget_date | **时间关联** | many_to_one | fact_budget_entry | dim_date | date_key → date_key | 预算关联日历 |
@@ -244,16 +246,16 @@ s.tables.add_relationship(
 
 ### 4.0 Cube 清单与类别
 
-| Cube | 类别 | **347 分类** | 事实源 | 时间维 | 支撑对象 |
+| Cube | 类别 | **平台分类** | 事实源 | 时间维 | 支撑对象 |
 | ---- | ---- | ------------ | ------ | ------ | -------- |
 | **ActualCube** | Process | **流程型** | fact_gl_journal_entry | dim_date + fiscal_* | JournalEntry, ProfitAnalysis |
 | **AccountActualCube** | Subject | **主体型** | fact_gl_journal_entry | 同上 | Account |
 | **CostCenterActualCube** | Subject | **主体型** | fact_gl_journal_entry | 同上 | CostCenter |
 | **BudgetCube** | Process | **流程型** | fact_budget_entry | 同上 | BudgetLine, BudgetAnalysis |
-| **TimeActualCube** | Subject | **主体型** | fact_gl_journal_entry | 同上 | （时间切片；**init 已注册**，347 建议后续并入 Process） |
+| **TimeActualCube** | Subject | **主体型** | fact_gl_journal_entry | 同上 | （时间切片；**init 已注册**，命名规范建议后续并入 Process） |
 | **BudgetVsActualCube** | Comparison | **对比型** | fact_budget_entry + fact_gl_journal_entry | fiscal_year/period | BudgetAnalysis（预实；**规划目标，init 待补**） |
 
-> 347 §4.2 建议时间增强不单独建 Cube；当前示例 init 仍含 **TimeActualCube** 并归 **主体型**，后续可合并进 ActualCube 后从注册表移除。
+> 命名规范 §4.2 建议时间增强不单独建 Cube；当前示例 init 仍含 **TimeActualCube** 并归 **主体型**，后续可合并进 ActualCube 后从注册表移除。
 
 ### 4.1 ActualCube（Process · 实际发生主 Cube）
 
@@ -322,7 +324,7 @@ s.tables.add_relationship(
 
 ### 5.1 对象类型（6 种）
 
-| code | 分类 | **347 分类** | 名称 | bind_source | 主物理支撑 |
+| code | 分类 | **平台分类** | 名称 | bind_source | 主物理支撑 |
 | ---- | ---- | ------------ | ---- | ------------- | ---------- |
 | Account | Master | **主数据** | 会计科目 | AccountActualCube | dim_account |
 | CostCenter | Master | **主数据** | 成本中心 | CostCenterActualCube | dim_cost_center |
@@ -376,7 +378,7 @@ s.tables.add_relationship(
 
 ### 5.3 链接类型（10 种）
 
-| 链接 code                      | **347 分类** | 名称             | from           | to             | 说明             |
+| 链接 code                      | **平台分类** | 名称             | from           | to             | 说明             |
 | ------------------------------ | ------------ | ---------------- | -------------- | -------------- | ---------------- |
 | entry_belongs_account          | **归属关系** | 分录归属科目     | JournalEntry   | Account        | 分录行对应科目   |
 | entry_belongs_cost_center      | **归属关系** | 分录归属成本中心 | JournalEntry   | CostCenter     | 分录行对应组织   |
@@ -407,7 +409,7 @@ s.tables.add_relationship(
 
 ### 6.1 函数清单
 
-| 函数 ID                      | **347 分类** | 功能         | 参数                                                               |
+| 函数 ID                      | **平台分类** | 功能         | 参数                                                               |
 | ---------------------------- | ------------ | ------------ | ------------------------------------------------------------------ |
 | profit.fn.get_summary        | **总览分析** | 利润总览     | start_date, end_date, cost_center_id（可选）                       |
 | profit.fn.yoy_analysis       | **趋势分析** | 同比分析     | start_date, end_date, pl_category（可选）                          |
@@ -517,22 +519,22 @@ s.tables.add_relationship(
 | 12 | define_property（约 42 个） |
 | 13 | define_link_type（10 种） |
 | 14 | sync_metric_refs |
-| 15 | **CATEGORY_REGISTRY** + `s.categories.apply_registry`（347 对齐） |
 
-### 7.4 阶段四：函数与数据（中）
+### 7.4 阶段四：灌数、函数与分类（中）
 
 | 步骤 | 任务 |
 | ---- | ---- |
-| 15 | profit_ontology_init.py、profit_seed_data.py（含 dim_date / date_key） |
-| 16 | 7 个 profit_fn_*.py |
-| 17 | publish + run → save-test-arguments |
+| 15 | seed 灌数：**dim_date** + 维表 + fact（写入 date_key） |
+| 16 | 7 个 `profit_fn_*.py`：**publish --register-function-id** |
+| 17 | `function run` + **`save-test-arguments`** |
+| 18 | **`profit_category_mount.py`**：`CATEGORY_REGISTRY` + `apply_registry`（**最后**，类灌数） |
 
-### 7.5 快速实施路径
+### 7.5 实施阶段参考（须 plans 已定稿后）
 
-| 来源                                                       | 可复用内容                        | 需改造                         |
-| ---------------------------------------------------------- | --------------------------------- | ------------------------------ |
-| `资源/examples/onto/利润示例/` | init/seed/函数完整示例 | 复制到 `<item-path>/` 后改 `<space-id>` |
-| [规划示例：产品销售](./规划示例_产品销售本体规划方案.md) | 工程模式对照 | 表结构与函数逻辑不同 |
+| 来源 | 用途 | 注意 |
+| ---- | ---- | ---- |
+| `资源/examples/onto/利润示例/` | 对照 API 写法或复制后按 **本实现 plans** 改造 | **禁止**无 plans 直接复制 init |
+| [销售示例](../../销售示例/plans/规划示例_产品销售本体规划方案.md) | 跨域工程模式只读对照 | 表结构与函数逻辑不同 |
 
 **seed 数据建议**：
 
@@ -566,7 +568,7 @@ s.tables.add_relationship(
 | **表间关系** | **8 条** |
 | Cube | **5 个** + 派生度量 |
 | 对象 | 6 种 + 分类；10 种链接 |
-| **347 平台分类** | 侧栏分类名与附录 B 一致；`category_mounts` 非空 |
+| **平台侧栏分类** | 侧栏分类名与附录 B 一致；`category_mount` 重跑幂等 |
 | 函数 | get_summary、budget_vs_actual、account_breakdown 可运行 |
 | 数据         | 种子灌入后预实差异可解释                                |
 
@@ -586,13 +588,13 @@ s.tables.add_relationship(
 
 ---
 
-## 附录 B：347 分类挂载对照表（CATEGORY_REGISTRY）
+## 附录 B：平台分类挂载对照表（CATEGORY_REGISTRY）
 
-与 `利润示例/setup/profit_ontology_init.py` 顶部 **`CATEGORY_REGISTRY`** 一一对应（见 [349 方案](./本体分类规划与SDK扩展方案.md)）。
+与 `利润示例/setup/profit_category_mount.py` 顶部 **`CATEGORY_REGISTRY`** 一一对应（见 [本体分类规划与SDK扩展方案](./本体分类规划与SDK扩展方案.md)）。**init 不含分类挂载**；本附录在 **全部函数 publish 后** 由 `category_mount` 脚本执行。
 
 ### B.1 物理表（table）
 
-| 347 分类 | 表名 |
+| 平台分类 | 表名 |
 | -------- | ---- |
 | 维度表 | dim_account, dim_cost_center |
 | 事实表 | fact_gl_journal_entry, fact_budget_entry |
@@ -601,14 +603,14 @@ s.tables.add_relationship(
 
 ### B.2 Cube（cube）
 
-| 347 分类 | Cube |
+| 平台分类 | Cube |
 | -------- | ---- |
 | 流程型 | ActualCube, BudgetCube |
 | 主体型 | AccountActualCube, CostCenterActualCube, TimeActualCube |
 
 ### B.3 对象类型（object）
 
-| 347 分类 | code |
+| 平台分类 | code |
 | -------- | ---- |
 | 主数据 | Account, CostCenter |
 | 事务 | JournalEntry, BudgetLine |
@@ -616,7 +618,7 @@ s.tables.add_relationship(
 
 ### B.4 表间关系（relation）
 
-| 347 分类 | 从表 → 到表 |
+| 平台分类 | 从表 → 到表 |
 | -------- | ----------- |
 | 时间关联 | fact_gl_journal_entry → dim_date；fact_budget_entry → dim_date |
 | 主数据关联 | fact_gl_journal_entry → dim_account / dim_cost_center；fact_budget_entry → dim_account / dim_cost_center |
@@ -624,7 +626,7 @@ s.tables.add_relationship(
 
 ### B.5 链接类型（link）
 
-| 347 分类 | link code |
+| 平台分类 | link code |
 | -------- | --------- |
 | 归属关系 | entry_belongs_account, entry_belongs_cost_center, budget_for_account, budget_for_cost_center |
 | 分析归因 | analysis_by_account, analysis_by_cost_center, account_contributes_profit, cost_center_contributes_profit |
@@ -633,9 +635,9 @@ s.tables.add_relationship(
 
 ### B.6 本体函数（function）
 
-init **不**注册函数；`apply_registry(..., skip_missing=True)` 跳过未发布函数。建议分类：
+函数在 `functions/` 中 **publish 注册**；`profit_category_mount.py` 在 **init + seed + 全部函数 publish 之后** 统一 `apply_registry`（含 function 段，`skip_missing=True` 可重跑）。建议分类：
 
-| 347 分类 | function_id |
+| 平台分类 | function_id |
 | -------- | ----------- |
 | 总览分析 | profit.fn.get_summary |
 | 趋势分析 | profit.fn.yoy_analysis, profit.fn.mom_analysis |
@@ -658,7 +660,7 @@ init **不**注册函数；`apply_registry(..., skip_missing=True)` 跳过未发
 | 4 | Cube 层 | ☑（**5 个**，§4.0） |
 | 5 | 对象 + 分类 | ☑（§5.1、§5.4） |
 | 6–10 | 同指南 | ☑ |
-| 6a–6e | 347 平台分类 | ☑（附录 B + init 步骤 10） |
+| 6a–6e | 平台侧栏分类 | ☑（附录 B + `profit_category_mount.py`） |
 
 ---
 
@@ -668,13 +670,13 @@ init **不**注册函数；`apply_registry(..., skip_missing=True)` 跳过未发
 | ---- | ---- |
 | 本体命名规范 | [本体命名规范_物理表Cube与对象.md](./本体命名规范_物理表Cube与对象.md) |
 | 本体规划指南 | [本体规划指南.md](./本体规划指南.md) |
-| 规划示例（产品销售） | [规划示例_产品销售本体规划方案.md](./规划示例_产品销售本体规划方案.md) |
+| 销售示例 | [规划示例_产品销售本体规划方案.md](../../销售示例/plans/规划示例_产品销售本体规划方案.md) |
 | **内置脚本示例** | `资源/examples/onto/利润示例/`（`dazi examples sync`；表名迁移中） |
-| 349 · 分类方案 | [本体分类规划与 SDK 扩展方案](./本体分类规划与SDK扩展方案.md) |
+| 分类方案 | [本体分类规划与 SDK 扩展方案](./本体分类规划与SDK扩展方案.md) |
 
 ---
 
-**方案版本**：v2.2（+347 分类列与附录 B CATEGORY_REGISTRY）  
+**方案版本**：v2.3（分类挂载迁至 `profit_category_mount.py`，类灌数）  
 **创建日期**：（定稿日）  
 **适用**：复制到 `<item-path>/plans/`；`<space-id>` 以该实现单元 `README.md` 为准  
 **状态**：规划示例（公共模板）

package/dist/examples/onto//345/210/251/346/266/246/347/244/272/344/276/213/setup/profit_category_mount.py

@@ -0,0 +1,85 @@
+"""利润分析本体 — 平台分类挂载（CATEGORY_REGISTRY）
+
+与灌数脚本类似，**独立步骤、放在实施流程最后**：
+init → seed → 发布全部函数 → **本脚本**。
+
+放置：资源/examples/onto/利润示例/setup/profit_category_mount.py
+发布：dazi onto script publish <item-path>/setup/profit_category_mount.py --space <space-id> --type setup
+规划对照：资源/examples/onto/利润示例/plans/规划示例_利润分析本体方案.md 附录 B
+"""
+
+import json
+
+# 与规划附录 B 一一对应；category 值必须是平台标准分类中文名
+CATEGORY_REGISTRY = {
+    "table": {
+        "维度表": ["dim_account", "dim_cost_center"],
+        "事实表": ["fact_gl_journal_entry", "fact_budget_entry"],
+    },
+    "cube": {
+        "流程型": ["ActualCube", "BudgetCube"],
+        "主体型": ["AccountActualCube", "CostCenterActualCube", "TimeActualCube"],
+    },
+    "object": {
+        "主数据": ["Account", "CostCenter"],
+        "事务": ["JournalEntry", "BudgetLine"],
+        "分析": ["ProfitAnalysis", "BudgetAnalysis"],
+    },
+    "relation": {
+        "时间关联": [
+            ("fact_gl_journal_entry", "dim_date"),
+            ("fact_budget_entry", "dim_date"),
+        ],
+        "主数据关联": [
+            ("fact_gl_journal_entry", "dim_account"),
+            ("fact_gl_journal_entry", "dim_cost_center"),
+            ("fact_budget_entry", "dim_account"),
+            ("fact_budget_entry", "dim_cost_center"),
+        ],
+        "层级自关联": [("dim_account", "dim_account")],
+    },
+    "link": {
+        "归属关系": [
+            "entry_belongs_account",
+            "entry_belongs_cost_center",
+            "budget_for_account",
+            "budget_for_cost_center",
+        ],
+        "分析归因": [
+            "analysis_by_account",
+            "analysis_by_cost_center",
+            "account_contributes_profit",
+            "cost_center_contributes_profit",
+        ],
+        "层级关系": ["account_has_parent"],
+        "对比关系": ["budget_compared_to_actual"],
+    },
+    "function": {
+        "总览分析": ["profit.fn.get_summary"],
+        "趋势分析": ["profit.fn.yoy_analysis", "profit.fn.mom_analysis"],
+        "结构分析": ["profit.fn.account_breakdown", "profit.fn.top_accounts"],
+        "预实分析": ["profit.fn.budget_vs_actual"],
+        "组织分析": ["profit.fn.cost_center_profit"],
+    },
+}
+
+
+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//345/210/251/346/266/246/347/244/272/344/276/213/setup/profit_ontology_init.py

@@ -1,4 +1,4 @@
-"""利润分析本体初始化脚本 — space__misc_01
+"""利润分析本体初始化脚本 — space__misc_01
 
 初始化内容：
 1. 创建物理表（科目表、成本中心维表、实际分录表、预算表）
@@ -7,11 +7,11 @@
 4. 注册Cube（5个）及派生度量
 5. 定义对象类型（6种）、绑定数据源、属性、链接
 6. 同步指标引用
-7. 配置 347 对齐分类（ads_categories + 桥表）
+7. 平台分类挂载见 profit_category_mount.py（init/seed/函数 publish 之后执行）
 
 放置：资源/examples/onto/利润示例/setup/profit_ontology_init.py（复制到项目 ontos/<实现名>/setup/）
 发布：dazi onto script publish <item-path>/setup/profit_ontology_init.py --space <space-id> --type setup
-规划对照：资源/docs/onto/规划示例_利润分析本体方案.md
+规划对照：资源/examples/onto/利润示例/plans/规划示例_利润分析本体方案.md
 """
 
 import json
@@ -105,60 +105,6 @@ TABLE_REGISTRY = {
     },
 }
 
-# 与 347 + 附录 B 对齐；category 值必须是 347 标准中文名
-CATEGORY_REGISTRY = {
-    "table": {
-        "维度表": ["dim_account", "dim_cost_center"],
-        "事实表": ["fact_gl_journal_entry", "fact_budget_entry"],
-    },
-    "cube": {
-        "流程型": ["ActualCube", "BudgetCube"],
-        "主体型": ["AccountActualCube", "CostCenterActualCube", "TimeActualCube"],
-    },
-    "object": {
-        "主数据": ["Account", "CostCenter"],
-        "事务": ["JournalEntry", "BudgetLine"],
-        "分析": ["ProfitAnalysis", "BudgetAnalysis"],
-    },
-    "relation": {
-        "时间关联": [
-            ("fact_gl_journal_entry", "dim_date"),
-            ("fact_budget_entry", "dim_date"),
-        ],
-        "主数据关联": [
-            ("fact_gl_journal_entry", "dim_account"),
-            ("fact_gl_journal_entry", "dim_cost_center"),
-            ("fact_budget_entry", "dim_account"),
-            ("fact_budget_entry", "dim_cost_center"),
-        ],
-        "层级自关联": [("dim_account", "dim_account")],
-    },
-    "link": {
-        "归属关系": [
-            "entry_belongs_account",
-            "entry_belongs_cost_center",
-            "budget_for_account",
-            "budget_for_cost_center",
-        ],
-        "分析归因": [
-            "analysis_by_account",
-            "analysis_by_cost_center",
-            "account_contributes_profit",
-            "cost_center_contributes_profit",
-        ],
-        "层级关系": ["account_has_parent"],
-        "对比关系": ["budget_compared_to_actual"],
-    },
-    "function": {
-        "总览分析": ["profit.fn.get_summary"],
-        "趋势分析": ["profit.fn.yoy_analysis", "profit.fn.mom_analysis"],
-        "结构分析": ["profit.fn.account_breakdown", "profit.fn.top_accounts"],
-        "预实分析": ["profit.fn.budget_vs_actual"],
-        "组织分析": ["profit.fn.cost_center_profit"],
-    },
-}
-
-
 def main():
     space_id = "space__misc_01"
     s = space.get(space_id)
@@ -654,14 +600,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,
@@ -671,7 +609,6 @@ def main():
         "object_types": 6,
         "properties": 42,
         "link_types": 10,
-        "category_mounts": cat_counts,
     }
 
     output.print("\n=== 利润分析本体初始化完成 ===")