NiJingzhe · Oct 15, 2026 · Oct 15, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,40 @@ user-facing notes live in [`docs/updates/`](docs/updates/) (English and
 
 ## Unreleased
 
+## 2.2.5 — 2026-10-15
+
+### Fixed
+
+- Editor: `sca cell` finds the editor through a container's proxy environment: the recorded
+  url is always the loopback (`--host 0.0.0.0` included), the health check and the editor
+  calls bypass `http_proxy`, and a record whose server does not answer is an error naming
+  the record and the url instead of a silent "no editor is running". A record whose pid is
+  gone reports the stale record and the remedy. A fallback to reading the file says so on
+  stderr.
+
+### Added
+
+- Run: `sca run --through N` runs the first N cells only (a stage, numbered the way the
+  editor numbers cells), `--no-product` runs a work-in-progress notebook that has no product
+  yet, and `--timeout SECONDS` fails a run that takes longer (off by default).
+- Editor: a failing or blocked cell's report names its upstream cells (failing ones first),
+  with marimo's own dependency semantics.
+
+### Changed
+
+- Editor: `sca cell put/insert/run` report the console output and every cell left unhealthy
+  by the change, and the dependents a write made stale are run, not left stale. A write whose
+  rerun outlives the call says the edit was applied and names `sca cell ls`
+  (`SCA_EDITOR_CALL_TIMEOUT` raises the wait, default 300s).
+- Inspect: printing a `BRepInspection` shows a one-line summary; the full record is
+  `to_dict()` / `.faces` / `.edges`.
+- Runs are quieter: the cache loaders' degraded-state warnings no longer print at WARNING,
+  and the render paths switch VTK's warning display off process-wide (this also hides VTK
+  chatter from code run in the same process); a real failure is still raised and named.
+- Skill: while an editor runs, `sca cell` is the only way to change a regular cell; `dof=0`
+  says the constraint system closed, not that the shape is right (mirror solutions); modeling
+  projects are version-controlled with git.
+
 ## 2.2.4 — 2026-10-15
 
 ### Fixed

diff --git a/README.md b/README.md
@@ -149,18 +149,21 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.4)
+## Update Notes (2.2.5)
 
 > Validate generated definitions, assembly constraints, and manufacturing
 > geometry before production use.
 
-- **The editor tells you why no model is coming.** A failed build is reported on every run you or
-  an agent asks for (rerun, `sca cell`, a file change, a module reload), and to a page that opens
-  or refreshes afterwards — the "building the model" veil lifts with the reason instead of
-  waiting out its fallback.
-- **The header's jump-to-marimo button is gone.**
+- **`sca cell` works behind container proxies.** The editor's discovery record is loopback and
+  proxy-proof, an unreachable record is reported instead of silently ignored, and file
+  fallbacks say so on stderr.
+- **Cell feedback carries the chain.** put/insert/run return console output and every cell
+  left unhealthy, stale dependents are run, and a failing cell names its upstream.
+- **Validate a stage headlessly.** `sca run --through N / --no-product / --timeout`.
+- **Quieter output, shorter prints.** Cache and VTK chatter is gone; a printed
+  `BRepInspection` is a one-line summary.
 
-Full notes for this version: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md).
+Full notes for this version: [`docs/updates/2.2.5.md`](docs/updates/2.2.5.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -181,7 +184,7 @@ in a compact public API for creating solids, applying features, tagging semantic
 intent, querying topology, exporting manufacturing files, and translating recorded
 models into FreeCAD workflows.
 
-Current release: `simplecadapi==2.2.4`.
+Current release: `simplecadapi==2.2.5`.
 
 ## What It Provides
 
@@ -696,6 +699,7 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 2.2.5 update notes: [`docs/updates/2.2.5.md`](docs/updates/2.2.5.md)
 - 2.2.4 update notes: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md)
 - 2.2.3 update notes: [`docs/updates/2.2.3.md`](docs/updates/2.2.3.md)
 - 2.2.2 update notes: [`docs/updates/2.2.2.md`](docs/updates/2.2.2.md)

diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -133,16 +133,18 @@ CalculiX 静力 FEM（边界面按保真的 `interface.*` 标签选取，仿真
 
 ---
 
-## 更新日志（2.2.4）
+## 更新日志（2.2.5）
 
 > 投入生产前请验证生成的定义、装配约束和制造几何。
 
-- **编辑器会告诉你模型为什么没出来。** 你或 agent 主动发起的每次运行（重跑、`sca cell`、文件变更、
-  模块重载）失败都会重新报告，失败后打开或刷新的页面也会立刻拿到原因——"building the model"
-  遮罩随原因揭开，不再等兜底超时。
-- **顶栏跳转 marimo 的按钮已移除。**
+- **`sca cell` 在容器代理后面也能用。** 编辑器发现记录钉在回环地址并绕过代理，应答不了的记录会报出来
+  而不是被静默忽略，降级读文件会在 stderr 上说明。
+- **cell 反馈带着整条链。** put/insert/run 返回 console 输出和每个不健康的 cell，stale 依赖会被运行，
+  出错 cell 会列出上游。
+- **按阶段做无头校验。** `sca run --through N / --no-product / --timeout`。
+- **更安静的输出、更短的打印。** 缓存与 VTK 噪声消失，打印 `BRepInspection` 是一行摘要。
 
-本版本的完整说明：[`docs/updates/2.2.4.zh-CN.md`](docs/updates/2.2.4.zh-CN.md)。
+本版本的完整说明：[`docs/updates/2.2.5.zh-CN.md`](docs/updates/2.2.5.zh-CN.md)。
 更早的版本：见[更新日志](CHANGELOG.md)和 [`docs/updates/`](docs/updates/)。
 
 ---
@@ -160,7 +162,7 @@ CalculiX 静力 FEM（边界面按保真的 `interface.*` 标签选取，仿真
 
 SimpleCADAPI 是一个基于 OCP 的 Python CAD SDK，提供清晰的函数式建模操作和可重放的模型图。它在 OpenCascade 几何内核之上提供精简的公共 API，可用于创建实体、应用特征、添加语义标签、查询拓扑、导出制造文件，以及将记录的模型转换为 FreeCAD 工作流。
 
-当前版本：`simplecadapi==2.2.4`。
+当前版本：`simplecadapi==2.2.5`。
 
 ## 核心能力
 
@@ -586,6 +588,7 @@ uv run --extra fem python examples/ap242_gmsh_volume_mesh/run_calculix.py
 
 ## 文档
 
+- 2.2.5 更新说明：[`docs/updates/2.2.5.zh-CN.md`](docs/updates/2.2.5.zh-CN.md)
 - 2.2.4 更新说明：[`docs/updates/2.2.4.zh-CN.md`](docs/updates/2.2.4.zh-CN.md)
 - 2.2.3 更新说明：[`docs/updates/2.2.3.zh-CN.md`](docs/updates/2.2.3.zh-CN.md)
 - 2.2.2 更新说明：[`docs/updates/2.2.2.zh-CN.md`](docs/updates/2.2.2.zh-CN.md)

diff --git a/docs/skill/SKILL.md b/docs/skill/SKILL.md
@@ -4,9 +4,9 @@ description: Build, assemble, inspect, reconstruct, and export parametric CAD mo
 license: Apache-2.0
 metadata:
   project: simplecadapi
-  version: 2.2.4
+  version: 2.2.5
   package-name: simplecadapi
-  package-version: 2.2.4
+  package-version: 2.2.5
 ---
 
 # SimpleCAD SDK Skill

diff --git a/docs/updates/2.2.5.md b/docs/updates/2.2.5.md
@@ -0,0 +1,51 @@
+# 2.2.5 Update Notes
+
+From a container agent's field report: the editor now works the way agents actually use it,
+and says what happened instead of leaving silence.
+
+## `sca cell` works behind container proxies
+
+Before, a container's `http_proxy` swallowed the editor's health check and `sca cell`
+answered "no editor is running" while one was. Now the editor's discovery record always
+carries a loopback url (`--host 0.0.0.0` included), the checks bypass the proxy environment,
+and a record whose server does not answer is reported with its path and url instead of being
+skipped quietly. A record whose pid is gone says "stale record … delete it or restart the
+editor". When `sca cell ls`/`get` fall back to reading the file, they say so on stderr.
+
+## Cell feedback carries the chain
+
+`sca cell put/insert/run` now return the console output and every cell left unhealthy by the
+change, and the dependents a write made stale are run instead of waiting. A failing cell's
+report names its upstream cells (the failing ones first), so the error you see can be traced
+to its cause. A write whose rerun takes longer than the call now answers "the edit was
+applied and the rerun is still going; check `sca cell ls`" instead of a raw socket error
+(`SCA_EDITOR_CALL_TIMEOUT` raises the wait, default 300s).
+
+## Validate a stage headlessly
+
+```bash
+sca run stage.py --through 3 --no-product    # the first 3 cells, no product needed
+sca run stage.py --timeout 600               # a wall clock for heavy fillets
+```
+
+`--through N` runs the first N cells, numbered the way the editor numbers them; `--no-product`
+runs a work-in-progress notebook that has no product yet; `--timeout` fails a run that takes
+longer (off by default).
+
+## Quieter output, shorter prints
+
+The cache loaders' degraded-state warnings (unsigned entries, a value restored as a stub) no
+longer print at WARNING, and the render paths switch VTK's warning display off process-wide —
+this also hides VTK chatter from code you run in the same process. A real failure is still
+raised and named. Printing a `BRepInspection` shows a one-line summary; the per-face records
+are `to_dict()` / `.faces` / `.edges`.
+
+## Skill
+
+While an editor runs, `sca cell` is the only way to change a regular cell — the file only when
+no editor runs, or for the setup / `@app.function` cells `sca cell` refuses. `dof=0` says the
+constraint system closed, not that the shape is right (angle constraints can solve to the
+mirror solution): verify by measurement. And a modeling project is managed like software:
+git from the first file, commits at verified milestones.
+
+See the [changelog](../../CHANGELOG.md) for the complete list.
diff --git a/docs/updates/2.2.5.zh-CN.md b/docs/updates/2.2.5.zh-CN.md
@@ -0,0 +1,41 @@
+# 2.2.5 更新说明
+
+来自容器 agent 的实战复盘：编辑器现在按 agent 真实的使用方式工作，并且把发生的事说出来，而不是留下沉默。
+
+## `sca cell` 在容器代理后面也能找到编辑器
+
+以前容器的 `http_proxy` 会吞掉编辑器的健康检查，`sca cell` 在编辑器明明运行时回答"no editor is running"。
+现在编辑器的发现记录始终携带回环地址（`--host 0.0.0.0` 也是），检查绕过代理环境，应答不了的服务器记录会带着
+路径和 url 报出来，而不是被悄悄跳过。pid 已消失的记录会说"stale record … delete it or restart the editor"。
+`sca cell ls`/`get` 降级读文件时会在 stderr 上说明。
+
+## cell 反馈带着整条链
+
+`sca cell put/insert/run` 现在返回 console 输出和这次修改留下的每一个不健康的 cell，写操作导致的 stale 依赖
+会被运行而不是晾着。出错 cell 的报告会列出它的上游 cell（先列出同样在报错的），让错误能追溯到根因。重跑超出
+调用时长的写操作现在回答"the edit was applied and the rerun is still going; check `sca cell ls`"而不是裸的
+socket 错误（`SCA_EDITOR_CALL_TIMEOUT` 可加大等待，默认 300 秒）。
+
+## 按阶段做无头校验
+
+```bash
+sca run stage.py --through 3 --no-product    # 只跑前 3 个 cell，不需要产品
+sca run stage.py --timeout 600               # 给重 fillet 一个墙上时钟
+```
+
+`--through N` 只跑前 N 个 cell（按编辑器的编号方式计）；`--no-product` 运行还没有产品的半成品 notebook；
+`--timeout` 让超时的运行失败（默认不限时）。
+
+## 更安静的输出、更短的打印
+
+缓存加载器的降级警告（未签名的条目、以 stub 恢复的值）不再以 WARNING 打印，渲染路径进程级关闭 VTK 的警告
+显示——同一进程里你自己代码的 VTK 警告也会被隐藏。真正的失败仍然会大声报出并点名。打印 `BRepInspection`
+现在是一行摘要；逐面记录在 `to_dict()` / `.faces` / `.edges`。
+
+## Skill
+
+编辑器运行时，`sca cell` 是修改普通 cell 的唯一方式——直接改文件只在没有编辑器运行时，或用于 `sca cell`
+拒绝的 setup / `@app.function` cell。`dof=0` 说明约束系统闭合了，不说明形状是对的（角度约束可能解出镜像
+解）：用测量来验证。建模项目按软件工程的方式管理：从第一个文件就用 git，在验证通过的节点提交。
+
+完整列表见[更新日志](../../CHANGELOG.md)。
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "simplecadapi"
-version = "2.2.4"
+version = "2.2.5"
 description = "A simplified OCP-native CAD modeling Python API"
 readme = "README.md"
 license = { file = "LICENSE" }

diff --git a/uv.lock b/uv.lock