excel-codegen 0.9.0__py3-none-any.whl

excel_codegen/examples/abs_fpi/ABS_FPI_load_cases_render.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+# ===========================================================================
+#  由 excel_codegen 生成 —— 改完参数跑一次本文件即可把结果写回 Output 表。
+#  重新生成工作簿（init）时会一并覆盖本文件。
+# ===========================================================================
+set -uo pipefail
+cd "$(dirname "$0")"
+
+if command -v uv >/dev/null 2>&1; then
+  uv run excel-codegen render -c "abs_fpi.yaml" -x "ABS_FPI_load_cases.xlsx" --write-excel
+else
+  excel-codegen render -c "abs_fpi.yaml" -x "ABS_FPI_load_cases.xlsx" --write-excel
+fi
+status=$?
+
+echo
+if [ "$status" -ne 0 ]; then
+  echo "[失败] 上面有报错信息。常见原因：依赖没装（跑一次 ./setup.sh 或 uv sync）、"
+  echo "       或者 Excel / WPS 正开着这个文件（先关掉再试）。"
+else
+  echo "[完成] 回到 Excel 打开「Output」表看结果。"
+fi
+exit "$status"

excel_codegen/examples/abs_fpi/README.md

@@ -0,0 +1,121 @@
+# 现场用例：ABS FPI 内外压 → GeniE
+
+用 `excel_codegen` 生成 **GeniE 面载荷函数体**（ABS FPI 2025 Part 5A Ch.3 Sec.2 的内压与外压）。
+
+**成品是一本 Excel**：在 `Global Parameter` / `Local Parameter` 表里填参数，`Code` 表里就是
+可以直接粘进 GeniE 的整段函数体 —— 而且是 **Excel 公式**，改参数后 Excel / WPS 打开即重算，
+**不需要跑任何脚本**。
+
+```
+function(x, y, z) {
+    // 把 Code 表某一列的内容粘在这里
+}
+```
+
+或整段函数交给 `Pressure2dJavascript(userFunction, refinement, positionSystem)`
+（GeniE Help 8.12，8. Loads → 8.1.3.3 Intensity/Pressure，Javascript 项）。
+GeniE 会对被加载面的**每一个离散点**调用它，所以 x/y/z 是当前加载点。
+
+> 这是随包发布的**示例**。开发侧的现场脚本、探针与逐轮实测报告在仓库根的
+> [`abs_fpi/`](../../../abs_fpi/)（不进包）。
+
+---
+
+## 1. 三本工作簿
+
+| 工作簿 | 内容 | 工况 |
+|---|---|---|
+| `abs_fpi_external.xlsx` | 外压 5A-3-2/5.5 单用 | 3 |
+| `abs_fpi_internal.xlsx` | 内压 5A-3-2/5.7 单用 | 4 |
+| `ABS_FPI_load_cases.xlsx` | **项目工作簿**：两套规则、**共用一张 Global 表**（主尺度只填一次） | 7 |
+
+打开任意一本就能改参数 —— 三本都已经填好样例数值。
+
+第三本由 `compose.yaml` 的配方把前两个规则集合并而成，用 `case_filter` 分流
+（`genie_ext` 只对 `kind == 'EXT'` 的工况出代码，`genie_int` 只对 `INT`），
+输出表分成 `Code EXT` / `Summary EXT` / `Code INT` / `Summary INT`。
+
+后两本还有一张 **`Tank Data` 成员表**：一行一个舱（WBT6 / WBT7 / COT1），
+B 列起一个变量一列。舱的参数只写一遍，工况用 `tank_ref` 指向它（指南 §18）。
+
+## 2. 怎么用
+
+```bash
+# 打开工作簿改参数即可；要把代码导出成文件时：
+excel-codegen render -c abs_fpi_internal.yaml -x abs_fpi_internal.xlsx --outdir generated
+
+# 核对「Excel 里算出来的」与「Python 渲染的」是否一致：
+excel-codegen check -c abs_fpi_internal.yaml -x abs_fpi_internal.xlsx
+
+# 改了模板 / YAML 之后，要把新公式写回 Excel：
+excel-codegen render -c abs_fpi_internal.yaml -x abs_fpi_internal.xlsx --write-excel
+```
+
+同目录的 `*_render.bat`（Windows 双击）/ `*_render.sh` 就是最后一条命令。
+
+## 3. 公式模式：什么免重跑、什么不免
+
+**改参数** → 免重跑。打开 Excel 就重算（写公式时同时设了 `fullCalcOnLoad`）。
+
+**改模板 / YAML** → 要重跑 `--write-excel`（公式是写进格子的文本，得刷新一遍）。
+
+**改结构** → 分两种，都实测过：
+
+| 动作 | 结果 |
+|---|---|
+| 插 / 删 **变量行** | ✅ 不用重跑。公式用 `INDEX/MATCH` **按变量名**定位，插行不指错 |
+| 增 / 删 / 移动 **Case 列** | ❌ 必须重跑。公式里的列标是绝对字母，工况一移位就指着别的工况了 |
+| 改 **Tank Data** 里的舱数据 | ✅ 不用重跑。公式按"Case → `tank_ref` → 成员行 → 变量列"两级 `INDEX/MATCH` 定位 |
+| 增 / 删 **Tank Data** 的成员行 | ✅ 不用重跑（同上，按成员名 `MATCH` 找行） |
+
+顺带一个坑：**手加 Case 列时一定要填 `kind`**。留空会回落 `default`（本例是 `EXT`），
+于是这一列会**悄悄进外压规则集**。
+
+## 4. 生成物长什么样
+
+`generated/EXT-T20.559-mu90-kf+1.js`：
+
+```javascript
+// EXT-T20.559-mu90-kf+1
+var t1 = x;
+var t2 = y;
+var t3 = z;
+x = t1;
+y = t2;
+z = t3;
+// --- global parameters (same for every case)
+var L = 340 m;
+...
+var p_s = Math.max(rho_sea * g * (draft - z), 0 Pa);   // still-water pressure, ...
+var p_d = rho_sea * g * ESF_side * k_u * h_de;   // hydrodynamic pressure, ...
+return Math.max(p_s + p_d, 0 Pa);   // the pressure the function returns
+```
+
+坐标映射由 6 个变量纯替换而成（`x = {{ neg_x }}t{{ ax_x }};`），
+所以**公式模式也能表达**：把 `ax_y` 填 `3`、`neg_z` 填 `-` 再打开 Excel，
+变换语句立刻变成 `y = t3; z = -t2;`。
+
+> 恒等映射下这 3 行是空操作（`x = t1;`），仍然会输出 —— 公式模式没有条件，
+> 没法"恒等就不输出"。GeniE 侧无副作用。
+
+## 5. 已知边界
+
+- **`case_filter` 的 Case 必须成块连续**（公式模式横向相对列靠恒定偏移），
+  所以项目工作簿里 EXT 的工况在前、INT 的工况在后。
+- **公式的 `TEXT()` 格式串受区域设置影响**：中文/英文区域小数点是 `.`；
+  换到欧洲区域（`,`）之前要重验一遍。
+- **公式值只活在 Excel / WPS 里**：`--outdir` 导出的文件由 Python 渲染（内容等价，
+  因为模板是纯替换），但"改参数自动同步文件"做不到，要再跑一次 `render`。
+
+## 6. 这个目录里有什么
+
+| 文件 | 作用 |
+|---|---|
+| `abs_fpi_external.yaml` / `abs_fpi_internal.yaml` | 两个规则集真源（变量 + 模板声明） |
+| `abs_fpi.yaml` | 项目工作簿 YAML（由 `compose.yaml` 的配方合并生成） |
+| `compose.yaml` | 合并配方：把哪些规则集并进一本、各自用什么 `case_filter` |
+| `templates/*.j2` | GeniE 函数体与摘要模板 |
+| `generated/` | 导出产物（提交进仓库的实测结果，可用来对照） |
+| `*.xlsx` | 三本已经填好样例参数的工作簿 |
+
+> 用例里的舱容与工况组合只是**示意数值**（随手取的几个数），不代表任何真实船舶。

excel_codegen/examples/abs_fpi/abs_fpi.yaml

@@ -0,0 +1,310 @@
+# =========================================================================== #
+# 本文件由 compose.py 生成，请不要手改 —— 改了会在下次 compose 时被覆盖。
+#
+# 真源是各规则集 YAML（见 compose.yaml 的 rulesets）：
+#   - abs_fpi_external.yaml
+#   - abs_fpi_internal.yaml
+# 改参数请改工作簿；加规则集请加规则集 YAML 再跑 python compose.py。
+# =========================================================================== #
+version: 1
+excel:
+  output: ABS_FPI_load_cases.xlsx
+  template_sheet: Template
+  howto_sheet: HOWTO
+  sheets:
+    global: Global Parameter
+    local: Local Parameter
+    outputs:
+    - Code EXT
+    - Summary EXT
+    - Code INT
+    - Summary INT
+variables:
+  global:
+  - name: L
+    description: 规范船长 [m]（3-1-1/3）；同时驱动 C_1 / k_lo / k_f
+    default: 340
+    type: float
+    suffix: ' m'
+  - name: B
+    description: 规范型宽 [m]；B/2 决定舭部位置
+    default: 64
+    type: float
+    suffix: ' m'
+  - name: D
+    description: 规范型深 [m]（基线到甲板）
+    default: 32
+    type: float
+    suffix: ' m'
+  - name: r_b
+    description: 舭圆半径 [m]：z_bilge = r_b，平底宽 = B/2 - r_b
+    default: 0.703
+    type: float
+    suffix: ' m'
+  - name: freeboard
+    description: 甲板边线在载重线以上的余量 [m]；Fig. 10 的截断高度用它算
+    default: 0.5
+    type: float
+    suffix: ' m'
+  - name: rho_sea
+    description: 海水密度 [kg/m^3]；规范下限 1.005 N/cm^2-m 即 1025 kg/m^3
+    default: 1025
+    type: float
+    suffix: ' kg/m^3'
+  - name: g
+    description: 重力加速度 [m/s^2]
+    default: 9.81
+    type: float
+    suffix: ' m/s^2'
+  - name: Cb
+    description: 方形系数 [-]（3-1-1/13.3）
+    default: 1
+    type: float
+  - name: ax_x
+    description: 规范 x（自 AP）取自模型哪个轴：1=x, 2=y, 3=z
+    default: '1'
+    type: string
+  - name: ax_y
+    description: 规范 y（自中线，向右舷为正）取自模型哪个轴
+    default: '2'
+    type: string
+  - name: ax_z
+    description: 规范 z（基线以上，向上为正）取自模型哪个轴
+    default: '3'
+    type: string
+  - name: neg_x
+    description: 规范 x 是否取反：填 - 表示取反，留空表示不取反
+    default: ''
+    type: string
+  - name: neg_y
+    description: 规范 y 是否取反：填 - 表示取反，留空表示不取反
+    default: ''
+    type: string
+  - name: neg_z
+    description: 规范 z 是否取反：填 - 表示取反，留空表示不取反
+    default: ''
+    type: string
+  - name: d_f
+    description: 结构吃水 [m]；规范表按它给出，GM 四点表也按它插值
+    default: 20.559
+    type: float
+    suffix: ' m'
+  - name: rho_g_lo
+    description: k_s = 0.878 对应的 rho g [N/m^3]（1.005 N/cm^2-m = 10050）
+    default: 10050
+    type: float
+    suffix: ' N/m^3'
+  - name: rho_g_hi
+    description: k_s 达到 1.0 的 rho g [N/m^3]（1.118 N/cm^2-m = 11180）
+    default: 11180
+    type: float
+    suffix: ' N/m^3'
+  local:
+  - name: kind
+    description: 这个 Case 属于哪一套规则：EXT / INT（多规则集合用时用 case_filter 分流）
+    default: EXT
+    type: string
+  - name: draft
+    description: 工况吃水 [m]；h_s = draft - z，负值截断为 0
+    default: 20.559
+    type: float
+    suffix: ' m'
+  - name: mu_deg
+    description: 浪向角 [deg]，0 = 顶浪，90 = 右舷来浪（Table 1A D）
+    default: 90
+    type: float
+    suffix: ' deg'
+  - name: k_c
+    description: 组合工况相关系数 [-]，进 h_de = k_c h_di（Table 1A B）
+    default: 1
+    type: float
+  - name: k_f0
+    description: 相位因子 +1 / -1 [-]，决定参考站落在哪一端（Table 1A B）
+    default: 1
+    type: float
+  - name: k_u
+    description: 载荷系数 [-]；规范默认 1.0，1.1 用于板与纵骨的工况
+    default: 1.1
+    type: float
+  - name: beta_EPS
+    description: 外压 ESF，右舷 [-]（5A-3-A1/3）
+    default: 0.733
+    type: float
+  - name: beta_EPP
+    description: 外压 ESF，左舷 [-]（5A-3-A1/3）
+    default: 0.733
+    type: float
+  - name: k_esf
+    description: 项目对 ESF 的分项系数 [-]
+    default: 1.1
+    type: float
+  - name: x_o
+    description: 参考站 [m]，自 AP 量起（Fig. 9 脚注）
+    default: 51
+    type: float
+    suffix: ' m'
+  - name: beta_VAC
+    description: 垂向加速度 ESF [-]（5A-3-A1/3）
+    default: 0.66
+    type: float
+  - name: beta_LAC
+    description: 纵向加速度 ESF [-]
+    default: 0.758
+    type: float
+  - name: beta_TAC
+    description: 横向加速度 ESF [-]
+    default: 0.557
+    type: float
+  - name: beta_PMO
+    description: 纵摇 ESF [-]
+    default: 0.686
+    type: float
+  - name: beta_RMO
+    description: 横摇 ESF [-]
+    default: 0.492
+    type: float
+  - name: w_v
+    description: 垂向加速度权重 [-]（Table 1A B）
+    default: 0.75
+    type: float
+  - name: w_l
+    description: 纵向加速度权重 [-]
+    default: 0.25
+    type: float
+  - name: w_t
+    description: 横向加速度权重 [-]
+    default: 0.75
+    type: float
+  - name: xi
+    description: 舱长方向参考位置 [m]（5.7.2(b)）
+    default: 21
+    type: float
+    suffix: ' m'
+  - name: delta_b
+    description: 舱宽方向修正 [m]（5.7.2(b)）；无则填 0
+    default: 0
+    type: float
+    suffix: ' m'
+  - name: delta_h
+    description: 舱高方向修正 [m]（5.7.2(b)）；无则填 0
+    default: 0
+    type: float
+    suffix: ' m'
+  - name: tank_ref
+    description: 本 Case 用哪个舱（成员表的行名）
+    default: WBT6
+    type: string
+    choices:
+    - WBT6
+    - WBT7
+    - COT1
+  group:
+    sheet: Tank Data
+    key: tank_ref
+    members:
+    - WBT6
+    - WBT7
+    - COT1
+    variables:
+    - name: rho_tank
+      description: 舱内液体密度 [kg/m^3]
+      default: 1025
+      type: float
+      suffix: ' kg/m^3'
+    - name: l_tank
+      description: 舱长 [m]（Fig. 11）
+      default: 42
+      type: float
+      suffix: ' m'
+    - name: b_tank
+      description: 舱宽 [m]（Fig. 11）
+      default: 32
+      type: float
+      suffix: ' m'
+    - name: h_tank
+      description: 舱高 [m]（Fig. 11）
+      default: 32
+      type: float
+      suffix: ' m'
+    - name: eta_deck
+      description: 甲板以上高度 [m]
+      default: 0
+      type: float
+      suffix: ' m'
+    - name: eta_overflow
+      description: 溢流管高度 [m]；Fig. 12 要求取 2/3 且不低于 760 mm
+      default: 0
+      type: float
+      suffix: ' m'
+    - name: C_dp
+      description: 舱形系数 [-]（5.7.2(d)）：矩形 1.0，J 形 0.7
+      default: 1
+      type: float
+    - name: C_ru
+      description: 舱形系数 [-]（5.7.2(d)）：矩形 1.0，U 形 0.7
+      default: 1
+      type: float
+    - name: p_vp
+      description: 真空/压力阀整定压力 [N/cm^2]
+      default: 0
+      type: float
+      suffix: ' N/cm^2'
+    - name: GM_full_in
+      description: 完整稳性 GM [m]；填 0 时用规范估算 0.12 B
+      default: 0
+      type: float
+      suffix: ' m'
+    - name: k_r_in
+      description: 横摇惯性半径 [m]；填 0 时用规范估算（0.35 B / 0.45 B）
+      default: 0
+      type: float
+      suffix: ' m'
+    - name: tank_is_ballast
+      description: 压载舱 1 / 货舱 0；决定 k_s 是否取 1
+      default: 1
+      type: int
+    - name: member_11_17
+      description: 构件是否属于 5.7 表 3 的 11..17 项（1 = 是）
+      default: 0
+      type: int
+templates:
+- name: genie_ext
+  description: ABS FPI 5A-3-2/5.5 外压 -- GeniE 强度函数体
+  output_sheet: Code EXT
+  start_cell: B2
+  direction: horizontal
+  write_case_headers: true
+  engine: excel
+  filename: '{{ case_name }}.js'
+  template_file: templates/ext_body.js.j2
+  case_filter: kind == 'EXT'
+- name: ext_summary
+  description: 外压工况输入汇总（Markdown）
+  output_sheet: Summary EXT
+  start_cell: B2
+  direction: vertical
+  write_case_headers: true
+  engine: excel
+  filename: '{{ case_name }}_summary.md'
+  template_file: templates/ext_summary.md.j2
+  case_filter: kind == 'EXT'
+- name: genie_int
+  description: ABS FPI 5A-3-2/5.7 内压 -- GeniE 强度函数体
+  output_sheet: Code INT
+  start_cell: B2
+  direction: horizontal
+  write_case_headers: true
+  engine: excel
+  filename: '{{ case_name }}.js'
+  template_file: templates/int_body.js.j2
+  case_filter: kind == 'INT'
+- name: int_summary
+  description: 内压工况输入汇总（Markdown）
+  output_sheet: Summary INT
+  start_cell: B2
+  direction: vertical
+  write_case_headers: true
+  engine: excel
+  filename: '{{ case_name }}_summary.md'
+  template_file: templates/int_summary.md.j2
+  case_filter: kind == 'INT'

excel_codegen/examples/abs_fpi/abs_fpi_external.yaml

@@ -0,0 +1,162 @@
+version: 1
+
+# =========================================================================== #
+# 规则集：ABS FPI 5A-3-2/5.5   外压（external sea pressures）
+#
+# 这是"模板数据库"里的一个单元：自带变量定义与模板，可以单独生成一本工作簿，
+# 也可以被 compose.py 合进一本项目工作簿（与内压共用一张 Global 表）。
+#
+#   engine: excel  → Code 表写的是 Excel 公式：改参数后 Excel / WPS 打开即重算，
+#                    不需要重跑任何脚本。代价是模板只能用"占位符替换 + 单行 {% if %}"
+#                    （{{ x }} / .value / .text / .prefix / .suffix / case_name；
+#                    {% if %} 会编译成 Excel 的 IF()，见指南 §14.1.1），
+#                    不支持 {% for %} / 过滤器 / 多行 {% if %}。
+#                    本模板的 if/else 是**GeniE 的字面文本**，不是 Jinja 控制流，
+#                    所以公式模式照样能用；坐标映射也用 6 个变量做纯替换表达。
+# =========================================================================== #
+excel:
+  output: "abs_fpi_external.xlsx"
+  sheets:
+    global: "Global Parameter"
+    local: "Local Parameter"
+    outputs: ["Code", "Summary"]
+
+variables:
+  # ------------------------------------------------------------------ 船 / 海 --
+  global:
+    - name: L
+      description: "规范船长 [m]（3-1-1/3）；同时驱动 C_1 / k_lo / k_f"
+      default: 340
+      type: float
+      suffix: " m"
+    - name: B
+      description: "规范型宽 [m]；B/2 决定舭部位置"
+      default: 64
+      type: float
+      suffix: " m"
+    - name: D
+      description: "规范型深 [m]（基线到甲板）"
+      default: 32
+      type: float
+      suffix: " m"
+    - name: r_b
+      description: "舭圆半径 [m]：z_bilge = r_b，平底宽 = B/2 - r_b"
+      default: 0.703
+      type: float
+      suffix: " m"
+    - name: freeboard
+      description: "甲板边线在载重线以上的余量 [m]；Fig. 10 的截断高度用它算"
+      default: 0.5
+      type: float
+      suffix: " m"
+    - name: rho_sea
+      description: "海水密度 [kg/m^3]；规范下限 1.005 N/cm^2-m 即 1025 kg/m^3"
+      default: 1025
+      type: float
+      suffix: " kg/m^3"
+    - name: g
+      description: "重力加速度 [m/s^2]"
+      default: 9.81
+      type: float
+      suffix: " m/s^2"
+    - name: Cb
+      description: "方形系数 [-]（3-1-1/13.3）"
+      default: 1
+      type: float
+
+    # ------------------------------------------------------- 坐标映射（纯替换）--
+    # 公式模式不能写 {% if %}，所以这里把"取哪个轴 + 是否取反"直接做成可替换的文本：
+    #   x = {{ neg_x }}t{{ ax_x }};   →   x = t1;  或  x = -t3;
+    - name: ax_x
+      description: "规范 x（自 AP）取自模型哪个轴：1=x, 2=y, 3=z"
+      default: "1"
+      type: string
+    - name: ax_y
+      description: "规范 y（自中线，向右舷为正）取自模型哪个轴"
+      default: "2"
+      type: string
+    - name: ax_z
+      description: "规范 z（基线以上，向上为正）取自模型哪个轴"
+      default: "3"
+      type: string
+    - name: neg_x
+      description: "规范 x 是否取反：填 - 表示取反，留空表示不取反"
+      default: ""
+      type: string
+    - name: neg_y
+      description: "规范 y 是否取反：填 - 表示取反，留空表示不取反"
+      default: ""
+      type: string
+    - name: neg_z
+      description: "规范 z 是否取反：填 - 表示取反，留空表示不取反"
+      default: ""
+      type: string
+
+  # ---------------------------------------------------------------- 每个工况 --
+  local:
+    - name: kind
+      description: "这个 Case 属于哪一套规则：EXT / INT（多规则集合用时用 case_filter 分流）"
+      default: "EXT"
+      type: string
+    - name: draft
+      description: "工况吃水 [m]；h_s = draft - z，负值截断为 0"
+      default: 20.559
+      type: float
+      suffix: " m"
+    - name: mu_deg
+      description: "浪向角 [deg]，0 = 顶浪，90 = 右舷来浪（Table 1A D）"
+      default: 90
+      type: float
+      suffix: " deg"
+    - name: k_c
+      description: "组合工况相关系数 [-]，进 h_de = k_c h_di（Table 1A B）"
+      default: 1
+      type: float
+    - name: k_f0
+      description: "相位因子 +1 / -1 [-]，决定参考站落在哪一端（Table 1A B）"
+      default: 1
+      type: float
+    - name: k_u
+      description: "载荷系数 [-]；规范默认 1.0，1.1 用于板与纵骨的工况"
+      default: 1.1
+      type: float
+    - name: beta_EPS
+      description: "外压 ESF，右舷 [-]（5A-3-A1/3）"
+      default: 0.733
+      type: float
+    - name: beta_EPP
+      description: "外压 ESF，左舷 [-]（5A-3-A1/3）"
+      default: 0.733
+      type: float
+    - name: k_esf
+      description: "项目对 ESF 的分项系数 [-]"
+      default: 1.1
+      type: float
+    - name: x_o
+      description: "参考站 [m]，自 AP 量起（Fig. 9 脚注）"
+      default: 51
+      type: float
+      suffix: " m"
+
+templates:
+  # 一列一个工况：整段 GeniE 函数体，逐行铺在 Code 表里（公式模式 → 自动重算）
+  - name: genie_ext
+    description: "ABS FPI 5A-3-2/5.5 外压 -- GeniE 强度函数体"
+    output_sheet: "Code"
+    start_cell: "B2"
+    direction: "horizontal"
+    write_case_headers: true
+    engine: "excel"
+    filename: "{{ case_name }}.js"
+    template_file: "templates/ext_body.js.j2"
+
+  # 一行一个工况：输入参数汇总（Markdown），随代码归档
+  - name: ext_summary
+    description: "外压工况输入汇总（Markdown）"
+    output_sheet: "Summary"
+    start_cell: "B2"
+    direction: "vertical"
+    write_case_headers: true
+    engine: "excel"
+    filename: "{{ case_name }}_summary.md"
+    template_file: "templates/ext_summary.md.j2"

excel_codegen/examples/abs_fpi/abs_fpi_external_render.bat

@@ -0,0 +1,22 @@
+@echo off
+REM ===========================================================================
+REM  由 excel_codegen 生成 —— 改完参数双击本文件即可把结果写回 Output 表。
+REM  重新生成工作簿（init）时会一并覆盖本文件。
+REM ===========================================================================
+cd /d "%~dp0"
+
+where uv >nul 2>nul
+if %errorlevel%==0 (
+  uv run excel-codegen render -c "abs_fpi_external.yaml" -x "abs_fpi_external.xlsx" --write-excel
+) else (
+  excel-codegen render -c "abs_fpi_external.yaml" -x "abs_fpi_external.xlsx" --write-excel
+)
+
+echo.
+if errorlevel 1 (
+  echo [失败] 上面有报错信息。常见原因：依赖没装（跑一次 setup.sh / uv sync）、
+  echo        或者 Excel 正开着这个文件（先关掉再试）。
+) else (
+  echo [完成] 回到 Excel 打开「Output」表看结果。
+)
+pause

excel_codegen/examples/abs_fpi/abs_fpi_external_render.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+# ===========================================================================
+#  由 excel_codegen 生成 —— 改完参数跑一次本文件即可把结果写回 Output 表。
+#  重新生成工作簿（init）时会一并覆盖本文件。
+# ===========================================================================
+set -uo pipefail
+cd "$(dirname "$0")"
+
+if command -v uv >/dev/null 2>&1; then
+  uv run excel-codegen render -c "abs_fpi_external.yaml" -x "abs_fpi_external.xlsx" --write-excel
+else
+  excel-codegen render -c "abs_fpi_external.yaml" -x "abs_fpi_external.xlsx" --write-excel
+fi
+status=$?
+
+echo
+if [ "$status" -ne 0 ]; then
+  echo "[失败] 上面有报错信息。常见原因：依赖没装（跑一次 ./setup.sh 或 uv sync）、"
+  echo "       或者 Excel / WPS 正开着这个文件（先关掉再试）。"
+else
+  echo "[完成] 回到 Excel 打开「Output」表看结果。"
+fi
+exit "$status"