optiland-gui-zh 0.1.0__tar.gz

optiland_gui_zh-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,129 @@
+# 贡献指南
+
+三条路，按所需技能从低到高。
+
+## 一、补词条（不需要懂 Python）
+
+1. 跑一遍提取器看还缺什么：
+
+   ```sh
+   python -m optiland_zh.extract --diff src/optiland_zh/catalogs/zh_CN.json
+   ```
+
+   它按源文件分组列出没翻译的字符串。`strings.json` 里每个词条还带**出现位置**
+   （文件 + 行号），想确认上下文就去翻那一行。
+
+2. 在 `src/optiland_zh/catalogs/zh_CN.json` 的 `entries` 里加一条：
+
+   ```json
+   "Analysis Settings": "分析设置"
+   ```
+
+3. 验证覆盖率涨了：
+
+   ```sh
+   optiland-zh --coverage
+   ```
+
+**术语请对齐 Zemax 中文版**，见 README 底部的对照表。新术语先查一下
+《光学名词》或 Zemax 中文界面，不要自己造词。
+
+### 什么不该翻
+
+| 类型 | 例子 | 原因 |
+|---|---|---|
+| 字体名 | `Cascadia Code` | 翻了会换成别的字体 |
+| 第三方算法名 | `BFGS`、`SLSQP`、`trust-constr` | 是 scipy 的标识符，中文界也照写 |
+| Qt 内部标识符 | `QuickActionsToolbar` | objectName，翻了会破坏控件查找和样式表 |
+| 品牌名 | `Optiland` | 产品名 |
+
+### 翻译时要注意的地方
+
+- **`&` 是快捷键标记**，中文惯例写成 `文件(&F)`，不要丢掉它。
+- **`%s` / `%d` 是 printf 占位符**，必须原样保留、数量一致。
+- **文件对话框过滤器**形如 `JSON Files (*.json);;All Files (*)`，
+  只翻描述部分，`*.json` 和 `;;` 分隔符不能动。
+- **HTML 标签**（`<b>` `<h3>`）要保留。
+
+## 二、加一种语言（也不需要懂 Python）
+
+1. 复制 `src/optiland_zh/catalogs/zh_CN.json`
+2. 改名成目标语言代码（如 `zh_TW.json`、`ja_JP.json`）
+3. 改 `language`（必须和文件名一致）和 `display_name`
+4. 翻译 `entries` 的值，以及 `patterns` 里每条规则的 `replace`
+   —— **`match` 字段绝对不能改**，它是匹配用的模板
+5. 验证：
+
+   ```sh
+   optiland-zh --list-languages
+   optiland-zh -l ja_JP --coverage
+   optiland-zh -l ja_JP --self-test
+   ```
+
+`patterns` 用 `{0} {1}` 位置占位符，写法和 `str.format` 一样。
+占位符的**数量和顺序**可以和 `match` 不同（比如中文语序不同），
+但不能引用不存在的编号。
+
+## 三、改引擎（需要懂 Python + Qt）
+
+### 先读这两件事
+
+1. **回译机制不能删。** `currentText()` / `QLineEdit.text()` 必须把原文还给
+   程序内部，否则分析、面型编辑、优化变量会静默失效。详见 README 的
+   「最难的部分」。
+2. **`itemText()` 故意不打补丁。** Qt 用它渲染下拉列表。要动它之前先想清楚
+   列表显示怎么办。
+
+### 加一个拦截点
+
+界面上还有英文，先判断它是怎么产生的：
+
+```sh
+python -m optiland_zh.audit          # 走一遍真实控件树，列出没翻的文字
+```
+
+如果 `audit` 报了「命中英文键，补丁没生效」，说明词库里有译文但补丁没拦到。
+这时去 `engine.py` 看：
+
+- 控件**构造时**传的文字 → 加进 `_CONSTRUCTORS`
+- 控件**建立后**设的文字 → 加进 `_TEXT_METHODS`
+- 参数是字符串列表 → 加进 `_LIST_METHODS`
+- 静态对话框（`QMessageBox.information` 等）→ 加进 `_DIALOG_STATICS`
+- 下拉框、输入框这种需要回译的 → 单独写包装器
+
+**判断某个类该不该进 `_CONSTRUCTORS`**：看它的 `__init__` 有没有"一上来就是
+标题"的位置参数。只收 `parent` 的（`QWidget` / `QMainWindow` / `QDialog` /
+`QTabWidget`）不要加。
+
+加完必须：
+
+```sh
+optiland-zh --self-test
+python -m optiland_zh.audit
+```
+
+### 别忘了改提取器
+
+新增了一个界面文字接口，`extract.py` 里的 `TEXT_APIS` 通常也要跟着加，
+否则提取器捞不到通过它传的字符串，下次升级算差集就会漏。
+
+反过来说：**往 `TEXT_APIS` 里加之前先确认那个接口收的全是给人看的文字。**
+`_create_dock` 就是个反例——它第二个参数是 objectName，加了会把内部标识符
+当成待翻译项收进来。
+
+## 提交
+
+- 一个小 PR 只做一件事：要么补词条，要么加语言，要么改引擎。
+- 改引擎的 PR 请在描述里贴 `--self-test` 和 `--audit` 的输出。
+- 加语言的 PR 请贴 `--coverage` 的数字，别低得离谱（目前 zh_CN 是 99.5%）。
+
+## 报告问题
+
+带上这些信息，排查会快很多：
+
+```sh
+optiland-zh --list-languages
+python -c "import PySide6, optiland; print(PySide6.__version__, optiland.__version__)"
+```
+
+以及出问题的那块界面的截图。

optiland_gui_zh-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 optiland-zh contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

optiland_gui_zh-0.1.0/MANIFEST.in

@@ -0,0 +1,15 @@
+# sdist 的默认内容只有 LICENSE / README.md / pyproject.toml / 包本体。
+# 下面这些是"应该跟源码一起分发"的东西，默认不会被带上。
+#
+# 尤其是 NOTICE.md：LICENSE 讲了本项目的授权，NOTICE 讲了它和
+# Optiland、PySide6/Qt 的关系。只发前者会让下游看不懂依赖边界。
+
+include NOTICE.md
+include CONTRIBUTING.md
+include README.en.md
+
+# 项目介绍（叙述式技术文档，对下游读源码有帮助）
+recursive-include docs *.md
+
+# 不用带 docs/*.png：README 和 intro.md 里的截图走的是
+# raw.githubusercontent 绝对地址，sdist 里再塞一份是白增 230KB。

optiland_gui_zh-0.1.0/NOTICE.md

@@ -0,0 +1,42 @@
+# 第三方声明
+
+本文件是补充说明，**不是许可证**。本项目的许可证是 [MIT](LICENSE)。
+
+## Optiland
+
+本项目汉化的对象是 [Optiland](https://github.com/optiland/optiland) 的图形界面。
+
+```
+MIT License
+Copyright (c) 2024 Kramer Harrison
+```
+
+项目主页：<https://github.com/optiland/optiland>
+
+### 本项目与 Optiland 的关系
+
+`optiland-zh` **不分发、不修改、也不链接** Optiland 的源码。它的工作方式是
+在用户自己的进程里，于运行期给 PySide6 的绑定方法重新赋值，从而在文字进入
+Qt 之前把它替换掉。
+
+本仓库只包含自己的源代码和翻译数据。Optiland 是运行期依赖，需要单独安装：
+
+```sh
+pip install "optiland[gui]"
+```
+
+## PySide6 / Qt
+
+本项目的汉化层依赖 PySide6 提供的 Qt 绑定，并在运行期加载 PySide6 自带的
+Qt 翻译文件（`qtbase_zh_CN.qm`）来覆盖 Qt 内置的文字（对话框按钮、
+文件选择器的标签等）。
+
+PySide6 由 Qt 公司及其贡献者提供，采用 LGPL v3 / 商业双许可。
+本项目不打包、不修改这些文件，只是在运行期引用它们。
+
+## 术语参考
+
+词库里的中文术语对齐 Zemax OpticStudio 中文版的习惯用法（Lens Data Editor →
+镜头数据编辑器、Aperture → 孔径、Spot Diagram → 点列图 等）。
+
+这里只是术语惯例的参考，不涉及任何 Zemax 的代码、数据或文件格式实现。

optiland_gui_zh-0.1.0/PKG-INFO

@@ -0,0 +1,329 @@
+Metadata-Version: 2.4
+Name: optiland-gui-zh
+Version: 0.1.0
+Summary: Optiland GUI 简体中文汉化包 —— 运行时翻译层，不改上游源码
+Author: optiland-zh contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Kino2315/optiland-zh
+Project-URL: Repository, https://github.com/Kino2315/optiland-zh
+Project-URL: Issues, https://github.com/Kino2315/optiland-zh/issues
+Project-URL: Changelog, https://github.com/Kino2315/optiland-zh/releases
+Keywords: optiland,optical-design,optics,ray-tracing,gui,i18n,localization,chinese,zh-cn,pyside6
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Software Development :: Localization
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: build>=1; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Requires-Dist: tomli>=2; python_version < "3.11" and extra == "dev"
+Dynamic: license-file
+
+# optiland-zh  
+vibe coding
+
+**Optiland GUI 简体中文汉化包** —— 运行期翻译层，不改上游源码一行。
+
+[English](https://github.com/Kino2315/optiland-zh/blob/main/README.en.md) | 中文
+
+![效果](https://raw.githubusercontent.com/Kino2315/optiland-zh/main/docs/screenshot-zh.png)
+
+> 这份 README 是**查阅手册**：怎么装、怎么用、怎么改。
+> 想看这个项目的**来龙去脉和技术看点**（文字即逻辑键的陷阱、六个实测踩出来的坑、
+> 覆盖率数字该怎么审查），读 [项目介绍](https://github.com/Kino2315/optiland-zh/blob/main/docs/intro.md)。
+
+## 这是什么
+
+[Optiland](https://github.com/optiland/optiland) 是一个功能完整的开源光学设计软件（序列/非序列光线追迹、优化、公差、MTF、Zemax 文件导入……），自带一个 Qt 图形界面。但它**只有英文，也没有任何多语言开关**——源码里 `self.tr()` 出现 0 次，没有 `.qm/.ts` 翻译文件，而且它还主动把语言钉死：
+
+```python
+QLocale.setDefault(QLocale(QLocale.Language.English, QLocale.Country.UnitedStates))
+```
+
+这个包把界面变成中文。**不修改 `site-packages`**，所以 `pip install -U optiland` 之后汉化依然有效。
+
+## 安装
+
+分三种人，三条路。**绝大多数人只需要第一段。**
+
+### 一、普通用户
+
+```sh
+pip install "optiland[gui]"      # ① Optiland 本体（约 300 MB）
+pip install optiland-gui-zh      # ② 本汉化包（46 KB）
+```
+
+**两条都要写。** 本包刻意不声明 `optiland` 依赖——那样会强制拉一份完整的 Qt
+和 VTK，和你已经装好的版本打架。所以 pip 不会替你带上它。
+
+装完直接跑：
+
+```sh
+optiland-zh
+```
+
+就这一条命令。它会装上汉化补丁，然后拉起 Optiland GUI。
+
+> **这一路完全不碰 git。** 用户不需要 clone 仓库，也不需要下载 Optiland 的源码——
+> 本包**不含**上游源码，只在运行期给自己进程里的 Qt 打补丁。原因见
+> [为什么不直接改源码](#为什么不直接改源码)。
+
+### 二、从源码安装
+
+想读代码、想改，或者 PyPI 上还没发布时：
+
+```sh
+pip install "optiland[gui]"
+git clone https://github.com/Kino2315/optiland-zh
+cd optiland-zh
+pip install .
+```
+
+### 三、开发
+
+```sh
+git clone https://github.com/Kino2315/optiland-zh
+cd optiland-zh
+pip install -e ".[dev]"     # -e 是 editable：改完代码立刻生效，不用重装
+pytest -q
+```
+
+### 只装了汉化包、没装上游？
+
+你会看到这段提示，而不是一坨 traceback：
+
+```
+[optiland-zh] 找不到：PySide6、optiland_gui
+
+本包只是汉化层，**不含 Optiland 本体**。请先装上游：
+
+    pip install "optiland[gui]"
+```
+
+照着做即可。`--list-languages` 和 `--help` 不需要 Qt，任何环境下都能用。
+
+## 使用
+
+```sh
+optiland-zh
+```
+
+就这一条。它会装上汉化，然后拉起 Optiland GUI。
+
+```sh
+optiland-zh --list-languages    # 有哪些语言
+optiland-zh --coverage          # 词库覆盖率报告
+optiland-zh --self-test         # 离屏自检，不开窗口
+optiland-zh -c my.json          # 用自定义词库调试
+optiland-zh --no-locale         # 只换文字，不动 locale
+```
+
+也可以在自己的脚本里用：
+
+```python
+import optiland_zh
+
+optiland_zh.install()                    # 必须早于 QApplication
+from optiland_gui.run_gui import main
+main()
+```
+
+## 为什么不直接改源码
+
+改 `site-packages` 里的文件最简单，但 `pip install -U optiland` 一升级就全没了，而且没法作为独立项目分发。
+
+所以这里的做法是：**在文字进入 Qt 之前把它换掉**。补丁打在 PySide6 的绑定类型上（PySide6 允许给它们赋值，这点已经实测确认）。
+
+## 最难的部分：回译
+
+汉化 Qt 应用有个隐藏陷阱，不注意就会把程序改坏。
+
+Optiland GUI 里有 **18 处拿控件文字当逻辑键**用的代码：
+
+```python
+self.on_analysis_type_changed(self.analysisTypeCombo.currentText())
+```
+
+这一句是拿下拉框里**显示的文字**去查"分析类注册表"。如果把 `"Spot Diagram"` 翻成 `"点列图"`，`currentText()` 就返回 `"点列图"`，注册表查不到——**整个分析功能直接失效**。
+
+`QLineEdit` 更危险，面型编辑就是这么写的：
+
+```python
+new_type = self.type_edit.text()                            # lens_editor.py:205
+if new_type.lower().strip() in get_available_surface_types():
+```
+
+后面比的是**英文**面型表。只做单向翻译，`"标准" in ["standard", ...]` 是 `False`，面型修改会静默失效。
+
+所以本项目的核心不是"替换字符串"，而是**双向**的：
+
+| 方向 | 做法 |
+|---|---|
+| 文字**进入** Qt | 英译中（构造器 / `setText` / `addItem` / `addMenu` / …） |
+| 原文**存起来** | 下拉框存进该项的 `userData`（自定义角色）；输入框存进 Qt 动态属性 |
+| 逻辑**读出来** | `currentText()` / `QLineEdit.text()` 还原成英文 |
+| 按文字**查找** | `findText()` / `setCurrentText()` 的查询词先中译英 |
+
+界面是中文，程序内部看到的仍是英文，两边都不坏。
+
+> `itemText()` **故意不回译**：Qt 拿它渲染下拉列表，回译了列表就变英文。
+> 全库只有一处调用它，是喂给 `setCurrentText`，那条路径本来就是通的。
+
+## 还拦了哪些"看不见"的地方
+
+光拦 `QLabel` 是不够的，实测踩到过这些：
+
+| 陷阱 | 后果 | 处理 |
+|---|---|---|
+| `QFormLayout.addRow("标签", 控件)` | 那个 QLabel 由 Qt 在 **C++ 内部**创建，Python 层看不到 | 补丁打在 `addRow` 上（一开始漏了 19 个标签） |
+| `QDockWidget("标题", parent)` | 构造器不在白名单里就不翻 | 加入构造器清单 |
+| Qt 自带的 OK / Cancel / 打开 / 保存 | 那些字是 Qt 内部产生的，Optiland 源码里根本没有 | 载入 `qtbase_zh_CN.qm`（PySide6 自带） |
+| 优化器下拉项带前导空格做对齐 | `" Least Squares"` 精确匹配不上 `"Least Squares"` | 词库匹配容忍首尾空白，并保留原缩进 |
+| `Toggle {0}` 这类模板 | `{0}` 里的 `"Analysis"` 不会自动翻，结果是「显示/隐藏 Analysis」 | 动态规则捕获到的内容再过一遍静态词条 |
+
+## 词库
+
+词库是**纯数据**，一种语言一个 JSON，放在 `src/optiland_zh/catalogs/`。
+
+```json
+{
+  "language": "zh_CN",
+  "entries": {
+    "&File": "文件(&F)",
+    "Lens Data Editor": "镜头数据编辑器"
+  },
+  "patterns": [
+    { "match": "Field {0}: ({1}, {2})", "replace": "视场 {0}：({1}, {2})" }
+  ]
+}
+```
+
+动态消息用 `{0} {1}` 占位，运行期编译成正则——比让译者写 `(?P<n>.+?)` 友好得多。
+
+### 加词条 / 加语言
+
+1. 复制 `src/optiland_zh/catalogs/zh_CN.json`
+2. 改 `language` / `display_name`
+3. 翻译 `entries` 和 `patterns` 的 `replace`（**不要动 `match`**）
+4. 跑 `optiland-zh -l <你的语言> --coverage` 看覆盖率
+
+## 升级 Optiland 之后
+
+上游加了新界面文字，词库就落后了。用提取器算差集：
+
+```sh
+python -m optiland_zh.extract --diff src/optiland_zh/catalogs/zh_CN.json
+```
+
+它会扫源码里的 AST，告诉你哪些新字符串还没翻，并按文件分组。提取器是**上下文感知**的，会自动排除：
+
+- `setObjectName("AnalysisPanel")` 里的内部标识符
+- 文档字符串（`"""..."""`）
+- `print()` / `logger.debug()` 的控制台输出
+- 样式表（QSS）、快捷键（`Ctrl+Q`）、配置键（`Layouts/Config`）
+- 示例代码片段
+
+不排除这些的话，第一次跑会得到 857 条候选，其中一大半是噪音；正确的过滤能压到 312 条，且都是真要翻的。
+
+## 验证
+
+```sh
+optiland-zh --self-test     # 7 项断言：构造器/setText/菜单/下拉显示/回译/findText
+optiland-zh --coverage      # 对源码的静态覆盖率
+python -m optiland_zh.audit # 离屏建真实主窗口，遍历控件树逐条核对
+```
+
+`--audit` 是最硬的证据：它把所有面板都建出来（含未展开的菜单、未激活的标签页），
+逐个文字节点和词库比对。当前结果：
+
+```
+窗口树里的文字节点: 1082
+  已覆盖: 1047  (96.8%)
+  未覆盖: 35
+
+判定分档（强度从高到低）:
+    974  exact-value           文字正好等于词库里的某条译文
+     73  cjk-heuristic         含中文即算已汉化（宽松）
+     35  MISS:not-translatable 本就是数字/objectName/第三方标识符
+
+严格口径（只认 exact-value）: 974 / 1082 = 90.0%
+真缺口（补丁没生效 + 仍是英文原文）: 0
+```
+
+**为什么要分档。** 单看"96.8% 已覆盖"没法判断里面有多少是靠宽松规则凑的。
+`exact-value` 是硬证据；`cjk-heuristic`（含中文就算汉化）覆盖的是动态规则
+拼出来的结果——它不会出现在词条值里，但也显然已经汉化。想逐条核查：
+
+```sh
+python -m optiland_zh.audit --rule cjk-heuristic
+```
+
+那 73 条实测全部属实：Qt 自动派生的 tooltip（`文件(&F)` → `文件(F)`）、
+动态消息（`显示/隐藏 分析`、`视场 1：(0.000, 0.000)`）、带缩进的下拉项。
+
+真正该盯的数字是 **`真缺口 = 0`**：没有任何一处"词库有译文却没生效"，
+也没有任何一处"仍是英文原文"。剩下 35 条**本来就该是英文**：
+Qt 的 objectName（`QuickActionsToolbar`）、scipy 算法名（`BFGS` / `SLSQP` /
+`trust-constr`）、序号、品牌名 `Optiland`、装饰符 `|||`。
+
+> 两个百分比别混：`--coverage` 是 **99.5%**，量的是"源码里的字符串翻了多少"；
+> `--audit` 是 **96.8%**，量的是"界面上实际出现的文字有多少是中文"。
+> 前者按源文件算，后者按运行时控件算——同一个字符串可能出现在几十个控件上，
+> 反过来动态拼出来的字符串在源码里根本不存在，所以两个数不会相等。
+
+> `--audit` 会临时关掉 VTK：离屏平台拿不到 OpenGL 像素格式，
+> 3D 视图会让进程段错误（Windows 上 0xC0000005）。关掉后 GUI 走
+> "VTK 不可用" 的降级分支，界面文字照样齐全。
+
+## 已知限制
+
+- **画在图里的文字够不到。** 绘图窗口标题（如 `System: Default System (2D)`）
+  是 matplotlib 画的，不是 Qt 控件，本方案的补丁层碰不到。
+  需要 matplotlib 自己的翻译机制，暂未处理。
+- **只覆盖 Optiland 的界面。** 第三方控件（Jupyter 控制台的右键菜单等）
+  能翻的部分靠 Qt 通用补丁顺带覆盖，剩余依赖它们自己的 i18n。
+- **PySide6 版本差异。** 个别类在不同版本里位置不同（`QStandardItem` 在
+  `QtGui` 而非 `QtWidgets`），引擎遇到找不到的类会跳过而不是崩，
+  对应控件则不汉化。
+
+## 本项目使用的术语
+
+对齐 Zemax 中文版习惯：
+
+| 英文 | 中文 |
+|---|---|
+| Lens Data Editor | 镜头数据编辑器 |
+| Aperture / Field / Wavelength | 孔径 / 视场 / 波长 |
+| Radius / Thickness / Material / Conic | 半径 / 厚度 / 材料 / 圆锥系数 |
+| Stop / Sag / Semi-Diameter | 光阑 / 矢高 / 半口径 |
+| Spot Diagram / Ray Fan | 点列图 / 光线扇形图 |
+| OPD / MTF / PSF | 光程差 / 调制传递函数 / 点扩散函数 |
+
+**故意不翻译**：`Cascadia Code`（字体名，翻了会换字体）、scipy 算法名、
+Qt 的 objectName。
+
+## 许可
+
+MIT，见 [LICENSE](https://github.com/Kino2315/optiland-zh/blob/main/LICENSE)。
+
+上游 [Optiland](https://github.com/optiland/optiland) 同为 MIT
+（Copyright © 2024 Kramer Harrison）。本项目通过运行期补丁工作，不分发也不修改
+其源码。第三方组件与术语来源的说明见 [NOTICE.md](https://github.com/Kino2315/optiland-zh/blob/main/NOTICE.md)。
+
+## 贡献
+
+见 [CONTRIBUTING.md](https://github.com/Kino2315/optiland-zh/blob/main/CONTRIBUTING.md)。最需要的贡献是**新语言**和**补词条**——
+那两件事不需要懂 Python。