excel-codegen 0.9.0__tar.gz → 0.9.2__tar.gz

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/CHANGELOG.md

@@ -4,9 +4,41 @@
 0.3.0 加公式模式 → 0.4.0 补齐公式模式的验证链 → 0.5.0 派生参数 → 0.5.x 跨平台与文档 →
 0.6.0 取值约束 / `extends` / 行内 `{% if %}` / 质量护栏 → 0.7.0 校验与复用补齐 →
 0.8.0 行列风格 / 成员表落地 / NASTRAN 工况控制 → 0.8.1 环境体检（`setup.sh`）→
-0.9.0 内置示例随包发布（`excel-codegen examples`）。逐条实测证据见
+0.9.0 内置示例随包发布（`excel-codegen examples`）→ 0.9.1 文档修正。逐条实测证据见
 [`abs_fpi/FINDINGS.md`](abs_fpi/FINDINGS.md)。
 
+---
+## 0.9.2 — 弃用跳板：项目已改名为 spreadsheet_codegen（2026-09-30）
+
+**本版本不再演进，功能与 0.9.1 完全相同。**
+
+项目改名为 **`spreadsheet_codegen`**（PyPI：`spreadsheet-codegen`），原因是旧名里带
+Microsoft 的商标 "Excel"，作为**产品名**使用存在商标风险（PyPI 的 Acceptable Use Policy
+禁止侵犯商标，且处罚不可申诉）。完整的排查与法律声明见 `NOTICE.md`。
+
+* 请改用：`pip install spreadsheet-codegen` / `uv tool install spreadsheet-codegen`
+* 新项目：<https://pypi.org/project/spreadsheet-codegen/>
+* **旧名 `excel-codegen` 的所有版本随后会被 yank**（新装的人装不到，已被锁定的依赖不受影响）
+
+---
+
+## 0.9.1 — 文档修正：PyPI 项目描述（2026-09-30）
+
+**纯文档，工具行为无变化。**
+
+0.9.0 是本项目首个 PyPI 版本，但它的项目描述取自**打包那一刻的 README**，而那版 README
+还写着"PyPI 发布流程已就绪、**尚未首次发布**" —— 在一本已经发布的页面上自相矛盾。
+PyPI 的项目描述不能事后编辑，只能发新版本覆盖，于是有了这个补丁版。
+
+* README「安装」拆成两路：**只是要用**（`uv tool install` / `pipx install` /
+  `pip install excel-codegen`）与**改工具本身**（克隆 + `pip install -e ".[dev]"`），
+  并注记当前版本；
+* [`docs/publishing.md`](docs/publishing.md) 记下首次发布已完成，并新增
+  **「排错：`invalid-publisher`」**：含义（OIDC token 有效，但 PyPI 上没有对得上的
+  publisher；**一个字节都没上传，版本没被烧**）、对着日志里的 OIDC claims 逐字核对的
+  5 个字段、两个最常见的错法（Workflow name 写成 `.github/workflows/release.yml`、
+  Environment name 留空），以及改完怎么重发（`rerun-failed-jobs`，或删 tag 重推）。
+
 ---
 
 ## 0.9.0 — 内置示例随包发布 + `excel-codegen examples`（2026-09-30）
@@ -88,6 +120,16 @@ sdist 解包后 `pytest` 全过；`abs_fpi/build.py --check` 公式求值 28 项
 三个工作簿 `check` 全过；探针 A–H / G / N 全部通过；
 净 venv 只装 wheel 后 `examples --copy` / `check` / `render` / `init` / `*_render.sh` 全走通。
 
+### 已发布
+
+**0.9.0 是本项目首个 PyPI 版本**（tag `v0.9.0` → `release.yml` → Trusted Publishing，
+仓库里不存任何 token）：<https://pypi.org/project/excel-codegen/0.9.0/>
+
+发布后做了一次**从 PyPI 装**的闭环验证（不是从本地 dist）：干净 venv 里
+`pip install excel-codegen` → `examples --copy` → 对随包发布的 `abs_fpi_internal.xlsx`
+跑 `check`（OK）→ `render --outdir` 导出 → `init` 生成新工作簿；
+`uv tool install excel-codegen` 同样通过。
+
 ---
 
 ## 0.8.1 — 坏掉的旧 venv 必须在装依赖之前被拦住（2026-09-30）

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/MANIFEST.in

@@ -10,6 +10,7 @@
 # `excel-codegen examples --copy DIR` 就能拿到（见 excel_codegen/example_pack.py）。
 
 include LICENSE
+include NOTICE.md
 include README.md
 include CHANGELOG.md
 include pyproject.toml

excel_codegen-0.9.2/NOTICE.md

@@ -0,0 +1,56 @@
+# 商标、版权与免责声明（NOTICE）
+
+本文件是 [excel_codegen](README.md) 的法律声明汇总。
+
+> **本项目与下列任何厂商均无关联，也未获得其赞助、认可或背书。**
+
+---
+
+## 1. 商标归属
+
+文档与示例中会出现下列名称。它们仅用于**说明兼容性、或说明所依据的规范**（描述性 /
+指示性使用），相关商标归各自所有者所有：
+
+| 名称 | 商标所有者 | 在本项目中的用途 |
+| --- | --- | --- |
+| Microsoft Excel / Excel | Microsoft Corporation | 说明本工具生成与读写的是 Excel 工作簿（`.xlsx`） |
+| NASTRAN | MSC Software Corporation（最初由 NASA 开发） | 说明示例生成的是 NASTRAN 工况控制语句 |
+| GeniE | DNV AS | 说明示例生成的是 GeniE 的 JavaScript 函数体 |
+| ABS（含 ABS FPI / Rules for Building and Classing） | American Bureau of Shipping | 说明示例实现的是一种船级社规范的载荷计算方法 |
+| WPS | 金山办公（Kingsoft Office） | 说明生成的工作簿也能用 WPS 打开 |
+| STM32 | STMicroelectronics | 示例中的 MCU 名称，仅作举例 |
+| Python、PyPI | Python Software Foundation | 运行环境与分发平台 |
+
+**本项目不使用**上述任何厂商的 logo、图标、字体或其他品牌视觉元素。
+
+---
+
+## 2. 关于规范文本与工程计算
+
+`abs_fpi` 示例实现的是 **ABS《Rules for Building and Classing》**（5A-3-2/5.5 外压、
+5.7 内压）中的面载荷计算方法。请注意：
+
+* **规范文本本身受版权保护，版权归 American Bureau of Shipping 所有。** 本仓库只包含
+  为演示工具用法所必需的公式与系数，**不包含**规范原文、表格或图表；
+* 使用者应**自行取得正式规范**，并以其为准；本项目的实现**未经 ABS 审核或认可**；
+* 本项目**不是**任何船级社的送审工具，输出结果**不能替代**船级社的审查与批准。
+
+---
+
+## 3. 工程用途免责
+
+本工具生成的是**工程计算代码**。生成结果可能因输入数据、模板版本、区域设置
+（例如公式里 `TEXT()` 的数字格式串）等原因而与预期不符：
+
+* **用于实际设计、建造或送审之前，必须由具备资格的人员独立复核**；
+* 作者与贡献者**不对任何使用后果承担责任**（另见 [`LICENSE`](LICENSE) 的免责条款）。
+
+---
+
+## 4. 关于 AI 生成
+
+本项目由 AI（DeepSeek）生成，人工负责提需求、定方向与验收（见 [README](README.md)）。
+
+请注意：纯 AI 生成内容在部分法域可能**不构成受版权保护的客体** —— 也就是说，
+[`LICENSE`](LICENSE) 里的 MIT 授权对这部分内容未必可执行，你也未必能阻止他人复制。
+这不影响你使用本项目，但会限制你**主张权利**。

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: excel_codegen
-Version: 0.9.0
+Version: 0.9.2
 Summary: Excel 模板参数填写 + Jinja2 代码生成器（支持 Prefix/Value/Suffix 组合）
 Author: JG. Luo
 License-Expression: MIT
@@ -18,6 +18,7 @@ Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+License-File: NOTICE.md
 Requires-Dist: openpyxl>=3.1.2
 Requires-Dist: jinja2>=3.1.2
 Requires-Dist: pyyaml>=6.0
@@ -31,9 +32,23 @@ Requires-Dist: ruff>=0.6; extra == "dev"
 Requires-Dist: mypy>=1.11; extra == "dev"
 Dynamic: license-file
 
+> # ⛔ 本项目已改名，请勿再使用
+>
+> **`excel-codegen` 已弃用**，请改用 **`spreadsheet-codegen`**：
+>
+> ```bash
+> pip install spreadsheet-codegen        # 或 uv tool install spreadsheet-codegen
+> ```
+>
+> 改名原因：旧名里带 Microsoft 的商标 "Excel"，存在被投诉下架的商标风险。
+> 本版本（`0.9.2`）只是**弃用跳板** —— 功能与 `0.9.1` 完全相同，**不会再有任何更新**。
+> 新项目：<https://pypi.org/project/spreadsheet-codegen/>
+>
+> ---
+
 # excel_codegen
 
-**在 Excel 里填参数，用 YAML + Jinja2 出代码。**
+**在 Microsoft Excel 里填参数，用 YAML + Jinja2 出代码。**
 
 [![ci](https://github.com/Dog-Chest/excel_codegen/actions/workflows/ci.yml/badge.svg)](https://github.com/Dog-Chest/excel_codegen/actions/workflows/ci.yml)
 ![python](https://img.shields.io/badge/python-3.11%2B-blue)
@@ -137,11 +152,25 @@ excel-codegen render -c examples/basic/example_formula.yaml \
 | [`CHANGELOG.md`](CHANGELOG.md) | 版本变更历史 |
 | [`abs_fpi/README.md`](abs_fpi/README.md) | 现场项目：怎么用、边界、四层校验链 |
 | [`docs/publishing.md`](docs/publishing.md) | 维护者向：发布到 GitHub / PyPI、密钥与隐私 |
+| [`NOTICE.md`](NOTICE.md) | **商标归属、规范版权与免责声明**（含 AI 生成与版权归属说明） |
 
 ## 安装
 
 需要 **Python 3.11+**（Windows / Linux / macOS 均可）。
 
+**只是要用它**（不克隆仓库）：
+
+```bash
+uv tool install excel-codegen        # 推荐
+pipx install excel-codegen           # 或
+pip install excel-codegen            # 或
+```
+
+装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`），
+`excel-codegen examples --copy ./examples` 就能拿到带工作簿的示例。
+
+**改这个工具本身**（开发）：
+
 ```bash
 # 推荐：uv —— 不用建 venv、不用 pip、不用管本机 Python 版本
 curl -LsSf https://astral.sh/uv/install.sh | sh     # Windows 见 docs/setup.md
@@ -151,11 +180,10 @@ python3 -m venv ~/.venvs/excel_codegen && source ~/.venvs/excel_codegen/bin/acti
 pip install -e ".[dev]"
 ```
 
-装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`）。
 跨平台细节、外置盘注意事项与 Python 版本策略见 [`docs/setup.md`](docs/setup.md)。
 
-> **PyPI 发布流程已就绪、尚未首次发布**（[`docs/publishing.md`](docs/publishing.md) 里有一次性登记步骤）。
-> 发布之后就可以不克隆仓库、直接 `uv tool install excel-codegen`（或 `pipx install excel-codegen`）。
+> **已发布到 PyPI**：当前版本 **0.9.1**（[PyPI 页面](https://pypi.org/project/excel-codegen/)）。
+> 之后的发版流程（Trusted Publishing，仓库里不存 token）见 [`docs/publishing.md`](docs/publishing.md)。
 
 ## 开发
 
@@ -174,6 +202,18 @@ CI（[配置](.github/workflows/ci.yml)）在 **Windows / macOS / Linux × Pytho
 > 语法错误，而在本地 3.12 上跑得好好的），`[tool.coverage.report]` 的 `fail_under = 85`
 > 让覆盖率掉了就直接红。
 
+## 商标与免责
+
+* 本项目与 **Microsoft**、**MSC Software**、**DNV**、**ABS**、**金山办公**、**ST**
+  等厂商**均无关联**，也未获得其赞助或背书；文档中出现的产品名仅为说明兼容性或所依据
+  规范的**描述性使用**，相关商标归各自所有者所有；
+* `abs_fpi` 示例依据 **ABS 规范**实现：**规范文本版权归 ABS 所有**，本仓库不含规范原文
+  与表格；该实现**未经 ABS 审核或认可**，使用前请自行取得正式规范并独立复核；
+* 本工具生成的是**工程计算代码**：用于实际设计 / 建造 / 送审之前必须由具备资格的人员
+  独立复核，**不能替代**船级社审查；作者不对使用后果负责。
+
+完整声明（含各商标的所有者清单、AI 生成与版权归属说明）见 [`NOTICE.md`](NOTICE.md)。
+
 ## License
 
-MIT —— 见 [`LICENSE`](LICENSE)。
+MIT —— 见 [`LICENSE`](LICENSE)；商标、规范版权与免责声明见 [`NOTICE.md`](NOTICE.md)。

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/README.md

@@ -1,6 +1,20 @@
+> # ⛔ 本项目已改名，请勿再使用
+>
+> **`excel-codegen` 已弃用**，请改用 **`spreadsheet-codegen`**：
+>
+> ```bash
+> pip install spreadsheet-codegen        # 或 uv tool install spreadsheet-codegen
+> ```
+>
+> 改名原因：旧名里带 Microsoft 的商标 "Excel"，存在被投诉下架的商标风险。
+> 本版本（`0.9.2`）只是**弃用跳板** —— 功能与 `0.9.1` 完全相同，**不会再有任何更新**。
+> 新项目：<https://pypi.org/project/spreadsheet-codegen/>
+>
+> ---
+
 # excel_codegen
 
-**在 Excel 里填参数，用 YAML + Jinja2 出代码。**
+**在 Microsoft Excel 里填参数，用 YAML + Jinja2 出代码。**
 
 [![ci](https://github.com/Dog-Chest/excel_codegen/actions/workflows/ci.yml/badge.svg)](https://github.com/Dog-Chest/excel_codegen/actions/workflows/ci.yml)
 ![python](https://img.shields.io/badge/python-3.11%2B-blue)
@@ -104,11 +118,25 @@ excel-codegen render -c examples/basic/example_formula.yaml \
 | [`CHANGELOG.md`](CHANGELOG.md) | 版本变更历史 |
 | [`abs_fpi/README.md`](abs_fpi/README.md) | 现场项目：怎么用、边界、四层校验链 |
 | [`docs/publishing.md`](docs/publishing.md) | 维护者向：发布到 GitHub / PyPI、密钥与隐私 |
+| [`NOTICE.md`](NOTICE.md) | **商标归属、规范版权与免责声明**（含 AI 生成与版权归属说明） |
 
 ## 安装
 
 需要 **Python 3.11+**（Windows / Linux / macOS 均可）。
 
+**只是要用它**（不克隆仓库）：
+
+```bash
+uv tool install excel-codegen        # 推荐
+pipx install excel-codegen           # 或
+pip install excel-codegen            # 或
+```
+
+装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`），
+`excel-codegen examples --copy ./examples` 就能拿到带工作簿的示例。
+
+**改这个工具本身**（开发）：
+
 ```bash
 # 推荐：uv —— 不用建 venv、不用 pip、不用管本机 Python 版本
 curl -LsSf https://astral.sh/uv/install.sh | sh     # Windows 见 docs/setup.md
@@ -118,11 +146,10 @@ python3 -m venv ~/.venvs/excel_codegen && source ~/.venvs/excel_codegen/bin/acti
 pip install -e ".[dev]"
 ```
 
-装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`）。
 跨平台细节、外置盘注意事项与 Python 版本策略见 [`docs/setup.md`](docs/setup.md)。
 
-> **PyPI 发布流程已就绪、尚未首次发布**（[`docs/publishing.md`](docs/publishing.md) 里有一次性登记步骤）。
-> 发布之后就可以不克隆仓库、直接 `uv tool install excel-codegen`（或 `pipx install excel-codegen`）。
+> **已发布到 PyPI**：当前版本 **0.9.1**（[PyPI 页面](https://pypi.org/project/excel-codegen/)）。
+> 之后的发版流程（Trusted Publishing，仓库里不存 token）见 [`docs/publishing.md`](docs/publishing.md)。
 
 ## 开发
 
@@ -141,6 +168,18 @@ CI（[配置](.github/workflows/ci.yml)）在 **Windows / macOS / Linux × Pytho
 > 语法错误，而在本地 3.12 上跑得好好的），`[tool.coverage.report]` 的 `fail_under = 85`
 > 让覆盖率掉了就直接红。
 
+## 商标与免责
+
+* 本项目与 **Microsoft**、**MSC Software**、**DNV**、**ABS**、**金山办公**、**ST**
+  等厂商**均无关联**，也未获得其赞助或背书；文档中出现的产品名仅为说明兼容性或所依据
+  规范的**描述性使用**，相关商标归各自所有者所有；
+* `abs_fpi` 示例依据 **ABS 规范**实现：**规范文本版权归 ABS 所有**，本仓库不含规范原文
+  与表格；该实现**未经 ABS 审核或认可**，使用前请自行取得正式规范并独立复核；
+* 本工具生成的是**工程计算代码**：用于实际设计 / 建造 / 送审之前必须由具备资格的人员
+  独立复核，**不能替代**船级社审查；作者不对使用后果负责。
+
+完整声明（含各商标的所有者清单、AI 生成与版权归属说明）见 [`NOTICE.md`](NOTICE.md)。
+
 ## License
 
-MIT —— 见 [`LICENSE`](LICENSE)。
+MIT —— 见 [`LICENSE`](LICENSE)；商标、规范版权与免责声明见 [`NOTICE.md`](NOTICE.md)。

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/docs/publishing.md

@@ -79,6 +79,9 @@ git push -u origin main
 用 **Trusted Publishing（OIDC）** —— 仓库里不存任何 token，GitHub 每次发布时向 PyPI
 换一张短期凭据。
 
+> ✅ **首次发布已完成**：`v0.9.0` → <https://pypi.org/project/excel-codegen/0.9.0/>
+> 下面的一次性配置留档，之后每次发版直接跳到「每次发版」。
+
 ### 一次性配置（只在第一次做）
 
 1. **注册 PyPI 账号**并开启两步验证（发版必需）。
@@ -94,7 +97,6 @@ git push -u origin main
 
    > 项目名写成 `excel-codegen`（连字符）是因为**分发的名字**与**导入的名字**可以不同：
    > `pip install excel-codegen` 装进来的是 `import excel_codegen`。
-   > 已确认 PyPI 上 `excel-codegen` 与 `excel_codegen` 都还没被占用。
 3. GitHub 仓库 → Settings → Environments → 新建一个叫 **`pypi`** 的环境
    （可以顺手加 "Required reviewers"，发版前多一道人工确认）。
 4. 确认 `pyproject.toml` 的 `[project.urls]` 都是真地址（占位符在 PyPI 页面上会变成
@@ -134,4 +136,42 @@ pipx install excel-codegen
 pip install excel-codegen
 ```
 
+> 装完 `excel-codegen examples --copy ./examples` 就能拿到带工作簿的内置示例。
+
+---
+
+### 排错：`invalid-publisher`
+
+```
+Trusted publishing exchange failure:
+* `invalid-publisher`: valid token, but no corresponding publisher
+```
+
+**含义**：OIDC token 本身没问题（签名有效），只是 PyPI 上**没有能对上的 (pending) publisher**。
+**一个字节都没上传**，所以版本号没有被烧掉 —— 改完直接重跑即可。
+
+对着日志里渲染出来的 claims 逐字核对 PyPI 表单（下面是 `v0.9.0` 的实际值）：
+
+| 日志里的 claim | PyPI 表单字段 | 实际值 |
+| --- | --- | --- |
+| `repository_owner` | Owner | `Dog-Chest` |
+| `repository` | Repository name | `excel_codegen`（**下划线**） |
+| `workflow_ref` 的文件名 | Workflow name | `release.yml`（**只写文件名**，别写路径） |
+| `environment` | Environment name | `pypi`（**留空就对不上**） |
+| 发行包 METADATA 的 `Name` | PyPI Project Name | `excel_codegen` → 归一化成 `excel-codegen` |
+
+最常见的两个错：**Workflow name 写成 `.github/workflows/release.yml`**、
+**Environment name 留空**（workflow 里用的是 `pypi`）。
+另外确认加的是 **pypi.org 生产站**的 pending publisher，不是 TestPyPI 的。
+
+**改完怎么重发**（不用重新走一遍 build）：
+
+1. 首选：Actions 页面打开上次失败的 run → **Re-run failed jobs**
+   （用 API 则是 `POST /repos/{owner}/{repo}/actions/runs/{id}/rerun-failed-jobs`，
+   需要 `actions: write` 权限的 token）；
+2. 没有那个权限时：**删掉 tag 再重推**，同样安全（版本没烧）：
+   ```bash
+   git push origin --delete v0.9.0 && git push origin v0.9.0
+   ```
+
 这样同事就不需要克隆仓库了 —— 「多平台零配置」这条线到此才算闭环。

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/docs/template_guide.md

@@ -776,6 +776,7 @@ Prefix/Suffix 是按变量（不是按 Case）生效的。见 4.4：再加一个
 | **0.8.0** | **行列风格 `excel.local_direction`**：Local 表可切成“一行一个工况”（见 §19）；公式模式与求值器支持二维 `INDEX` / 行区间 `MATCH`；**`filename` 里可用任意参数**；abs_fpi 舱数据改用成员表；新增 NASTRAN 工况控制用例（§20） |
 | 0.8.1 | 只动开发环境脚本 `setup.sh` 与测试：复用旧 venv 之前先体检（解释器版本 / `site-packages` / `pip`），拦住在换过 Python 后"能执行却什么也 import 不到"的坏环境（见 `docs/setup.md`）。**工具行为无变化** |
 | **0.9.0** | **内置示例随包发布 + 新增 `excel-codegen examples`**：`basic` / `nastran` / `abs_fpi` 三个示例（含已填好样例参数的工作簿）进 wheel 与 sdist，`--copy DIR` 一键拷出 —— 装了 pip 包、没克隆仓库的人也能用（见 [`excel_codegen/examples/README.md`](../excel_codegen/examples/README.md)）；`docs/setup.md` 补 Windows 用法。另修一个真 bug：**`setup.sh` 在 macOS（bash 3.2）上第一屏就 `unbound variable` 退出** —— `$VAR` 紧邻中文要写成 `${VAR}` |
+| 0.9.1 | 纯文档：0.9.0 的 PyPI 项目描述取自打包时的 README，上面还写着"尚未首次发布"，发这个补丁版覆盖；README「安装」拆成"只是要用 / 改工具本身"两路；`docs/publishing.md` 记下首次发布并新增 `invalid-publisher` 排错。**工具行为无变化** |
 
 ---
 

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/excel_codegen/__init__.py

@@ -92,7 +92,7 @@ from .utils import (
     to_text,
 )
 
-__version__ = "0.9.0"
+__version__ = "0.9.2"
 
 __all__ = [
     "FIRST_CASE_COLUMN",

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/excel_codegen/examples/abs_fpi/README.md

@@ -19,6 +19,19 @@ GeniE 会对被加载面的**每一个离散点**调用它，所以 x/y/z 是当
 > 这是随包发布的**示例**。开发侧的现场脚本、探针与逐轮实测报告在仓库根的
 > [`abs_fpi/`](../../../abs_fpi/)（不进包）。
 
+> ⚠️ **规范版权与免责**
+>
+> * 本示例依据 **ABS《Rules for Building and Classing》**（5A-3-2/5.5 外压、5.7 内压）
+>   实现。**规范文本版权归 American Bureau of Shipping 所有**；本仓库只包含演示所必需的
+>   公式与系数，**不含**规范原文、表格或图表。
+> * 使用者须**自行取得正式规范**并以其为准。本实现**未经 ABS 审核或认可**，
+>   本项目与 ABS **无关联**，`ABS` 是 American Bureau of Shipping 的商标。
+> * 输出**不能替代**船级社审查与批准。用于实际设计 / 建造 / 送审前，必须由具备资格的人员
+>   独立复核。
+> * 示例中的舱容与工况只是**示意数值**，不代表任何真实船舶。
+>
+> 完整声明见仓库根的 `NOTICE.md`（也随发行包发布在 `.dist-info/licenses/` 下）。
+
 ---
 
 ## 1. 三本工作簿

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/excel_codegen.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: excel_codegen
-Version: 0.9.0
+Version: 0.9.2
 Summary: Excel 模板参数填写 + Jinja2 代码生成器（支持 Prefix/Value/Suffix 组合）
 Author: JG. Luo
 License-Expression: MIT
@@ -18,6 +18,7 @@ Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+License-File: NOTICE.md
 Requires-Dist: openpyxl>=3.1.2
 Requires-Dist: jinja2>=3.1.2
 Requires-Dist: pyyaml>=6.0
@@ -31,9 +32,23 @@ Requires-Dist: ruff>=0.6; extra == "dev"
 Requires-Dist: mypy>=1.11; extra == "dev"
 Dynamic: license-file
 
+> # ⛔ 本项目已改名，请勿再使用
+>
+> **`excel-codegen` 已弃用**，请改用 **`spreadsheet-codegen`**：
+>
+> ```bash
+> pip install spreadsheet-codegen        # 或 uv tool install spreadsheet-codegen
+> ```
+>
+> 改名原因：旧名里带 Microsoft 的商标 "Excel"，存在被投诉下架的商标风险。
+> 本版本（`0.9.2`）只是**弃用跳板** —— 功能与 `0.9.1` 完全相同，**不会再有任何更新**。
+> 新项目：<https://pypi.org/project/spreadsheet-codegen/>
+>
+> ---
+
 # excel_codegen
 
-**在 Excel 里填参数，用 YAML + Jinja2 出代码。**
+**在 Microsoft Excel 里填参数，用 YAML + Jinja2 出代码。**
 
 [![ci](https://github.com/Dog-Chest/excel_codegen/actions/workflows/ci.yml/badge.svg)](https://github.com/Dog-Chest/excel_codegen/actions/workflows/ci.yml)
 ![python](https://img.shields.io/badge/python-3.11%2B-blue)
@@ -137,11 +152,25 @@ excel-codegen render -c examples/basic/example_formula.yaml \
 | [`CHANGELOG.md`](CHANGELOG.md) | 版本变更历史 |
 | [`abs_fpi/README.md`](abs_fpi/README.md) | 现场项目：怎么用、边界、四层校验链 |
 | [`docs/publishing.md`](docs/publishing.md) | 维护者向：发布到 GitHub / PyPI、密钥与隐私 |
+| [`NOTICE.md`](NOTICE.md) | **商标归属、规范版权与免责声明**（含 AI 生成与版权归属说明） |
 
 ## 安装
 
 需要 **Python 3.11+**（Windows / Linux / macOS 均可）。
 
+**只是要用它**（不克隆仓库）：
+
+```bash
+uv tool install excel-codegen        # 推荐
+pipx install excel-codegen           # 或
+pip install excel-codegen            # 或
+```
+
+装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`），
+`excel-codegen examples --copy ./examples` 就能拿到带工作簿的示例。
+
+**改这个工具本身**（开发）：
+
 ```bash
 # 推荐：uv —— 不用建 venv、不用 pip、不用管本机 Python 版本
 curl -LsSf https://astral.sh/uv/install.sh | sh     # Windows 见 docs/setup.md
@@ -151,11 +180,10 @@ python3 -m venv ~/.venvs/excel_codegen && source ~/.venvs/excel_codegen/bin/acti
 pip install -e ".[dev]"
 ```
 
-装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`）。
 跨平台细节、外置盘注意事项与 Python 版本策略见 [`docs/setup.md`](docs/setup.md)。
 
-> **PyPI 发布流程已就绪、尚未首次发布**（[`docs/publishing.md`](docs/publishing.md) 里有一次性登记步骤）。
-> 发布之后就可以不克隆仓库、直接 `uv tool install excel-codegen`（或 `pipx install excel-codegen`）。
+> **已发布到 PyPI**：当前版本 **0.9.1**（[PyPI 页面](https://pypi.org/project/excel-codegen/)）。
+> 之后的发版流程（Trusted Publishing，仓库里不存 token）见 [`docs/publishing.md`](docs/publishing.md)。
 
 ## 开发
 
@@ -174,6 +202,18 @@ CI（[配置](.github/workflows/ci.yml)）在 **Windows / macOS / Linux × Pytho
 > 语法错误，而在本地 3.12 上跑得好好的），`[tool.coverage.report]` 的 `fail_under = 85`
 > 让覆盖率掉了就直接红。
 
+## 商标与免责
+
+* 本项目与 **Microsoft**、**MSC Software**、**DNV**、**ABS**、**金山办公**、**ST**
+  等厂商**均无关联**，也未获得其赞助或背书；文档中出现的产品名仅为说明兼容性或所依据
+  规范的**描述性使用**，相关商标归各自所有者所有；
+* `abs_fpi` 示例依据 **ABS 规范**实现：**规范文本版权归 ABS 所有**，本仓库不含规范原文
+  与表格；该实现**未经 ABS 审核或认可**，使用前请自行取得正式规范并独立复核；
+* 本工具生成的是**工程计算代码**：用于实际设计 / 建造 / 送审之前必须由具备资格的人员
+  独立复核，**不能替代**船级社审查；作者不对使用后果负责。
+
+完整声明（含各商标的所有者清单、AI 生成与版权归属说明）见 [`NOTICE.md`](NOTICE.md)。
+
 ## License
 
-MIT —— 见 [`LICENSE`](LICENSE)。
+MIT —— 见 [`LICENSE`](LICENSE)；商标、规范版权与免责声明见 [`NOTICE.md`](NOTICE.md)。

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/excel_codegen.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@
 CHANGELOG.md
 LICENSE
 MANIFEST.in
+NOTICE.md
 README.md
 pyproject.toml
 setup.sh

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "excel_codegen"
-version = "0.9.0"
+version = "0.9.2"
 description = "Excel 模板参数填写 + Jinja2 代码生成器（支持 Prefix/Value/Suffix 组合）"
 readme = "README.md"
 # 支持下限 = **CI 真正测过的最老版本**（见 .github/workflows/ci.yml）。
@@ -13,7 +13,8 @@ readme = "README.md"
 # 只需把这里、CI 矩阵、以及 README 的说明一起改掉（不要让文档比代码乐观）。
 requires-python = ">=3.11"
 license = "MIT"
-license-files = ["LICENSE"]
+# NOTICE.md 一起进 wheel 的 .dist-info/licenses/ 与 sdist —— 商标与免责声明要跟着分发走
+license-files = ["LICENSE", "NOTICE.md"]
 authors = [{ name = "JG. Luo" }]
 keywords = ["excel", "openpyxl", "jinja2", "codegen", "template"]
 classifiers = [

{excel_codegen-0.9.0 → excel_codegen-0.9.2}/uv.lock

@@ -227,7 +227,7 @@ wheels = [
 
 [[package]]
 name = "excel-codegen"
-version = "0.9.0"
+version = "0.9.2"
 source = { editable = "." }
 dependencies = [
     { name = "jinja2" },