From 09816658f2156077d3f49829e0ad26a2d5598fb0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=8C=82=E4=B9=8B=E9=92=B3?= <dev@hdtime.space>
Date: Tue, 28 Jul 2026 17:22:33 +0800
Subject: [PATCH] =?UTF-8?q?docs(feedback):=20VDE-027=20fixed=20=E2=80=94?=
 =?UTF-8?q?=20face=5Fcentroid=20=E4=BD=9C=E7=94=A8=E5=9F=9F=E9=94=99?=
 =?UTF-8?q?=E8=AF=AF=E5=B7=B2=E5=9C=A8=20v1.0.3=20=E4=BF=AE=E5=A4=8D?=
 =?UTF-8?q?=EF=BC=8C=E6=9B=B4=E6=96=B0=20overview?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/feedback/00-overview.md | 13 ++++++++++---
 docs/feedback/VDE-027.md     | 29 +++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+), 3 deletions(-)
 create mode 100644 docs/feedback/VDE-027.md

diff --git a/docs/feedback/00-overview.md b/docs/feedback/00-overview.md
index d2e8a69..b5f035f 100644
--- a/docs/feedback/00-overview.md
+++ b/docs/feedback/00-overview.md
@@ -27,13 +27,20 @@ VDE 团队快速响应了反馈，v1.0.1+ 更新修复了 7 个问题，引入
 | VDE-011 | write_stl 返回 void | 改为 bool |
 | VDE-012 | double/float 精度 | 新增 StlTrianglef |
 
-### 新增（3 个）
+### 新增（3 个）— 全部已修复
 
 | 问题 | 内容 | 状态 |
 |------|------|:--:|
 | VDE-014 | write_stl 新旧声明并存 | 已修复 (v1.0.2) |
 | VDE-015 | Vector3F/Point3F 拼写错误 | 已修复 (v1.0.2) |
-| VDE-016 | ssi_boolean.cpp 两阶段查找修正不完整 | 部分修复 (VDE-018 遗留) |
+| VDE-016 | ssi_boolean.cpp 两阶段查找修正不完整 | 已修复 (v1.0.2) |
+| VDE-017 | configure_file CMAKE_SOURCE_DIR | 已修复 (v1.0.2) |
+
+### v1.0.3 修复（1 个）
+
+| 问题 | 内容 | 状态 |
+|------|------|:--:|
+| VDE-027 | face_centroid 作用域错误 | 已修复 (v1.0.3) |
 
 ### 当前可用模块（10/10）
 
@@ -61,7 +68,7 @@ vde_capi       ✓
 
 ### P0 已全部解决
 
-所有 P0 阻塞问题（VDE-001/002/005/010/013/016/018）已解决。VDE 全部 10 个模块在 GCC 下可构建。
+所有 P0 阻塞问题（VDE-001/002/005/010/013/016/017/018/027）已解决。VDE 全部 10 个模块在 GCC 下可构建。
 
 ### 后续重点关注
 
diff --git a/docs/feedback/VDE-027.md b/docs/feedback/VDE-027.md
new file mode 100644
index 0000000..1ec8496
--- /dev/null
+++ b/docs/feedback/VDE-027.md
@@ -0,0 +1,29 @@
+# VDE-027: VDE update build failure (auto-detected)
+
+- **ID**: VDE-027
+- **Date**: 2026-07-28
+- **Status**: fixed
+- **Severity**: Critical
+- **Category**: BUILD
+- **Source**: vde_auto_sync.ps1
+
+## Trigger
+- **From**: `fbf9b400b542bb49b4246258df63c0827e191fbf`
+- **To**: `aeb29ab`
+- **New commits**:
+  - aeb29ab fix(v1.0.3): VDE-019 center参数 + VDE-020 cone/torus + VDE-022 位置查询 + VDE-026 BVH索引
+
+## Build Errors
+```
+  error: 'face_centroid' was not declared in this scope
+```
+
+Full log: ViewDesign `build/vde_build_errors.txt`
+
+## Root Cause
+
+Commit `aeb29ab` 将 `modeling.cpp` 中 `get_face_index_by_position` 函数的 centroid 内联计算替换为 `face_centroid(body, ...)` 调用。但 `face_centroid` 仅在 `ssi_boolean.cpp` 和 `brep_boolean.cpp` 内部定义，未在任何公共头文件中声明，导致 ViewDesign 作为子模块构建时 GCC 报错。
+
+## Fix
+
+Commit `4a6abd9` 将 `face_centroid` 调用恢复为内联 centroid 计算，避免跨翻译单元的未声明引用。无需将 `face_centroid` 提升到公共 API。