feat: 完善特征编辑和选择稳定性

README.md

@@ -8,10 +8,84 @@
 
 - 这是一个 STEP B-Rep 结果几何查看和受限局部编辑工具，不是完整参数化 CAD 内核。
 - 主入口是 `python main.py`；默认模型是 `assets/models/geom_extract.step`；立方体测试模型是 `assets/models/cube_10mm.step`。
-- 左侧操作面板按工作流排列：STEP 文件、模型结构树、鼠标选择模式、按 ID 选择、编辑、导出、显示、测量、可编辑对象、圆柱面候选、操作历史和对象信息。
+- 左侧操作面板当前优先保留最小建模链路：STEP 文件、选择模式 / 按 ID 选择、当前选中对象、编辑、参数化建模和导出当前完整 STEP；部分辅助面板暂时收起，后续需要时再放回。
 - 局部编辑会先做计划、风险提示、预览和后台执行；失败时会尽量回滚，成功后进入撤销/重做历史。
 - 新开 Codex 聊天框继续开发时，只需要 Codex 阅读 README 末尾的“Codex 项目记忆”；普通开发者可以忽略那一节。
 
+## 怎么运行
+
+你第一次配置或运行这个项目时，可以按下面步骤来。命令默认在 Windows PowerShell 里执行。
+
+1. 进入项目目录。如果你的仓库不在这个路径，把命令里的路径换成你的实际目录：
+
+```powershell
+cd C:\Users\admin\Desktop\python-occt
+```
+
+2. 如果你已经有 `pyocc` 环境，直接激活：
+
+```powershell
+conda activate pyocc
+```
+
+3. 如果你是第一次配置环境，先用仓库里的 `environment.yml` 创建环境，再激活：
+
+```powershell
+conda env create -f environment.yml
+conda activate pyocc
+```
+
+4. 先跑一次烟测，确认入口和依赖能正常加载。这个命令不会进入交互窗口：
+
+```powershell
+python main.py --smoke-test
+```
+
+5. 启动程序并打开默认测试模型：
+
+```powershell
+python main.py
+```
+
+6. 启动时直接打开指定 STEP 文件：
+
+```powershell
+python main.py path\to\model.step
+```
+
+7. 也可以先启动程序，在左侧 `STEP文件` 区域点击 `导入几何模型` 选择 `.step` / `.stp` 文件，再点击 `读取模型`。
+
+8. 打开仓库自带的简单立方体测试模型：
+
+```powershell
+python main.py assets\models\cube_10mm.step
+```
+
+9. 重新生成简单立方体测试模型：
+
+```powershell
+python scripts\generate_cube_step.py
+```
+
+10. 验证立方体上的“只改一条 Edge 长度”基线：
+
+```powershell
+python scripts\verify_edge_length_resize.py
+```
+
+11. 如果当前 PowerShell 没识别 `conda`，你可以直接使用完整路径运行：
+
+```powershell
+C:\Users\admin\miniforge3\Scripts\conda.exe run -n pyocc python main.py
+```
+
+开发时常用的本地检查：
+
+```powershell
+python -m compileall -q main.py step_editor scripts
+git diff --check
+```
+
 ## 最终要实现什么
 
 最终目标是做一个面向 STEP 模型的交互式工具：
@@ -22,7 +96,7 @@
 - 用户可以选择零件、Solid、Face、Edge 和几何特征。
 - 用户可以做基础测量，例如把两个拾取点或对象中心设为 A/B 并计算距离。
 - 程序可以识别孔、圆角、凸台、槽、壳体局部区域等候选特征。
-- 用户可以修改可控的特征，比如平面推拉、孔径调整、槽/半孔宽度调整、盲孔深度调整、凸台直径调整、Edge倒圆、Edge倒角和修改Edge长度。
+- 用户可以修改可控的特征，比如平面推拉和目标法向位置、孔径/半径调整、完整圆柱孔轴心坐标修改、槽/半孔宽度、深度、圆弧长度、圆弧角度、开口角度和槽孔总长度调整、盲孔/盲槽深度调整、凸台直径/半径/高度/轴心坐标调整、普通完整圆柱高度兜底修改、已有圆角半径/圆弧长度调整、圆锥半角、环面直径、Edge倒圆、Edge倒角、圆Edge半径/直径、修改Edge长度和直线Edge起点/终点坐标。
 - 用户可以撤销/重做修改，避免一步编辑做坏。
 - 用户可以导出修改后的完整模型。
 - 如果 STEP 文件里存在多个互不关联的零件，用户可以只导出选中的某个零件。
@@ -44,6 +118,23 @@
 - 能撤销/重做编辑。
 - 先实现少量可控编辑操作，用于验证后续特征编辑路线。
 
+## 当前可修改范围
+
+这张表描述的是当前版本已经接入到界面或编辑链路里的能力。它们都是基于 STEP 的 B-Rep 结果几何做局部重建，不等于原 CAD 软件里的完整建模历史参数。
+
+| 对象 / 特征 | 现在可以修改 | 暂不能保证或还不能修改 |
+| --- | --- | --- |
+| 平面 Face | `Face目标法向位置`、`Face本次偏移量`；识别到相对平面时可以改薄壁厚度。 | `Face面积` 目前只读；自由曲面、复杂壳体局部区域和带复杂边界的面不能直接按面积修改。 |
+| 圆柱孔 / 圆柱面 | 孔或圆柱直径、半径；完整圆柱孔可以改轴心坐标；完整孔可以尝试封堵。 | 复杂孔、螺纹孔、锥孔、不完整圆柱孔和拓扑不稳定的孔可能失败并回滚。 |
+| 盲孔 / 盲槽 | 识别到疑似底面 Face 时，可以改 `盲孔/盲槽深度`。 | STEP 不保存真实孔深历史；找不到可靠底面或底面被复杂拓扑切碎时，深度只能只读或需要手动辅助。 |
+| 槽 / 半孔 | 可以改槽/半孔宽度、深度、圆弧长度、圆弧角度和开口角度；长圆槽识别到成对半圆端时，可以改槽孔总长度和中心距，也可以手动填写配对端 Face ID。 | 复杂草图槽、非圆柱槽、槽的整体迁移/轴心移动、链式槽和跨多个不规则面的槽还不是稳定能力。 |
+| 圆柱凸台 / 外圆 | 完整圆柱凸台可以改直径、半径、高度和轴心坐标；普通完整圆柱也有高度兜底修改。 | 复杂凸台、异形凸台、多台阶凸台和不完整外圆不能保证稳定重建。 |
+| 已有圆角 / 倒圆面 | 部分规则圆柱倒圆面可以改半径或圆弧长度，使用先移除旧圆角再重建新圆角的路线。 | 复杂 blend、支撑面不明确、圆角链或恢复锐边失败时会阻止或回滚。 |
+| Edge | 直线 Edge 可以尝试改目标长度、起点坐标、中心坐标和终点坐标；直线 Edge 可以加倒圆、对称倒角、不等距倒角和距离+角度倒角；圆形/圆弧 Edge 可以尝试改半径或直径。 | “通用任意 Edge”仍是受限实现；复杂曲线、B-spline、和无法确定局部变形区域的 Edge 可能走高风险 fallback 或失败。 |
+| 圆锥 / 球 / 环面 | 圆锥可以改参考半径、直径或半角；球可以改半径或直径；环面可以改主/副半径或直径。 | 这些属于几何缩放或局部重建能力，不是原始特征历史恢复；复杂相邻拓扑可能失败。 |
+| Solid / 特征整体 | 可以对选中 Solid 或当前单一模型做平移、旋转和按包围盒尺寸 / 体积 / 表面积的缩放类修改。 | 还没有装配约束、零件间关联约束或完整多零件装配编辑。 |
+| 只读信息 | 面积、体积、包围盒、曲面类型、相邻关系、候选特征说明等会展示出来帮助判断。 | 标成只读的值不会被 `参数化建模` 修改；显示、测量和导出不是建模操作。 |
+
 ## 现在已经实现了什么
 
 当前已经实现：
@@ -124,14 +215,16 @@
   - `深度扫描` 会尝试列出更多候选，适合默认列表里没有找到目标对象时使用。
   - 可推拉的平面Face。
   - 可调整孔径的圆柱Face候选。
-  - 可调整槽/半孔宽度的局部圆柱孔/槽候选。
-  - 可调整盲孔深度的圆柱Face候选。
+  - 可调整槽/半孔宽度、深度和圆弧长度的局部圆柱孔/槽候选。
+  - 可调整盲孔/盲槽深度的圆柱Face候选。
+  - 可调整圆柱凸台直径和高度的凸台候选。
   - 可添加新圆角的直线Edge候选。
   - 可添加倒角的直线Edge候选。
   - 可尝试直接调整长度的直线Edge候选，简单平面多面体会优先局部边形变。
+  - 可调整圆Edge半径/直径的圆形或圆弧Edge候选。
   - 表格会显示当前值、状态、风险、置信度和说明。
-  - 盲孔深度候选会在列表阶段先确认疑似底面，列表里的深度值优先使用底面Face轴向位置计算。
-  - 点击表格行会直接选中对应Face或Edge，方便继续执行推拉、孔径调整、槽/半孔宽度调整、盲孔深度调整、Edge倒圆、Edge倒角或修改Edge长度。
+  - 盲孔/盲槽深度候选会在列表阶段先确认疑似底面，列表里的深度值优先使用底面Face轴向位置计算。
+  - 点击表格行会直接选中对应Face或Edge，方便继续执行推拉、孔径调整、槽/半孔宽度/深度/圆弧长度调整、凸台高度调整、盲孔/盲槽深度调整、Edge倒圆、Edge倒角或修改Edge长度。
 - 支持列出圆柱面候选特征。
 - 圆柱面候选会显示在表格中，点击候选行可以直接选中并高亮对应 Face。
 - 圆柱面候选可以按类型筛选：全部、孔/槽候选、圆角候选、凸柱/外圆候选、未明确分类。
@@ -172,6 +265,22 @@
   - 只对已识别为 `partial-cylindrical-groove` 的部分圆柱孔/槽候选开放。
   - 输入目标槽宽后，会按当前圆弧角度把槽宽换算为目标圆柱直径，再复用圆柱孔/槽重建路线执行。
   - 这不是完整 CAD 槽参数编辑；复杂槽、非圆柱槽或圆弧角度不稳定时仍可能失败并回滚。
+- 当前版本支持槽/半孔深度调整：
+  - 只对已识别为 `partial-cylindrical-groove` 的部分圆柱孔/槽候选开放。
+  - 输入目标槽深后，会按当前圆弧角度把槽深换算为目标圆柱直径，再复用圆柱孔/槽重建路线执行。
+  - 这仍是 B-Rep 几何近似，不是完整 CAD 槽深参数编辑。
+- 当前版本支持槽/半孔圆弧长度调整：
+  - 只对已识别为 `partial-cylindrical-groove` 的部分圆柱孔/槽候选开放。
+  - 输入目标圆弧长度后，会按当前圆弧角度把圆弧长度换算为目标圆柱直径，再复用圆柱孔/槽重建路线执行。
+  - 这仍是 B-Rep 几何近似，不是完整 CAD 槽参数编辑。
+- 当前版本支持槽/半孔圆弧角度和开口角度调整：
+  - 只对已识别为 `partial-cylindrical-groove` 的部分圆柱孔/槽候选开放。
+  - 输入目标圆弧角度时，程序会保持当前圆柱半径，先补旧扇形槽，再按目标角度重切局部扇形槽。
+  - 输入目标开口角度时，会先换算为 `2π - 开口角` 的圆弧角度后执行。
+  - 如果检测到成对长圆槽端，当前角度修改仍只重建所选局部扇形槽。
+- 当前版本支持长圆槽/槽孔总长度和中心距调整：
+  - 自动识别到成对半圆槽端时，程序会保持槽宽不变，先补旧长圆槽体，再切出目标总长度。
+  - 如果自动配对失败，可以在当前选中对象表中填写 `槽孔配对端Face ID`，后续槽宽、槽深、圆弧长度和总长度调整会优先尝试使用这个手动配对端。
 - 当前版本支持薄壁/壳体局部厚度调整：
   - 对已找到投影重叠相对平面的平面候选开放。
   - 输入目标厚度后，程序会把厚度变化换算成当前平面区域的推拉距离，保留相对平面不动。
@@ -183,7 +292,7 @@
   - 会识别已有圆角Face和相邻支撑Face，并在特征模式下一起高亮。
   - `可编辑对象` 会把已有圆角候选单独列为 `修改已有圆角半径`，点击后会选中该圆角 Face，并把圆角半径输入框预填为当前估算半径的参考目标值。
   - 选中已有圆角候选时，不会再误把它填入 `孔直径`，避免把圆角当孔径修改。
-  - 当前版本的已有圆角半径修改会先尝试移除圆角Face，再在恢复出的锐边上重新倒圆；只对较规整的圆柱圆角候选开放，复杂 blend 可能失败并回滚。
+  - 当前版本的已有圆角半径修改会先尝试移除圆角Face，再在恢复出的锐边上重新倒圆；也可以在当前选中对象表中输入已有圆角圆弧长度，程序会按当前圆弧角度换算成目标半径。只对较规整的圆柱圆角候选开放，复杂 blend 可能失败并回滚。
 - 当前版本支持圆柱孔封堵：
   - 只对 `hole/groove candidate` 且角度跨度接近完整圆柱的孔开放。
   - 不对半孔/槽开放，避免用完整圆柱补料时把不该补的位置也补上。
@@ -197,6 +306,11 @@
   - 目标直径变小时，会先用旧外形包络体移除原凸台范围，再 Fuse 目标直径圆柱重建，避免环形 cutter 在部分场景下把实体切空。
   - 会先显示半透明预览：绿色表示扩大/重建补料范围，红色表示缩小移除范围。
   - 当前默认模型可能没有明确凸台候选；包含完整圆柱凸台的 STEP 文件可以使用这个能力。
+- 当前版本支持圆柱凸台高度和轴心坐标调整：
+  - 只对已识别为完整圆柱凸台、并找到可推拉端盖 Face 的候选开放。
+  - 输入目标高度后，程序会选择凸台端盖并把高度变化换算成端盖推拉距离。
+  - 输入目标轴心坐标后，程序会先移除旧凸台包络，再按同直径在目标轴心补出凸台。
+  - 这不是 CAD 历史里的拉伸特征高度参数；端盖识别不稳定或推拉计划被阻止时会拒绝执行。
 - 当前版本支持直线Edge添加圆角：
   - 只对直线Edge开放。
   - 会先检查边长、相邻Face数量和目标半径相对边长的比例。
@@ -207,14 +321,18 @@
 - 当前版本支持直线Edge添加倒角：
   - 只对直线Edge开放。
   - 会先检查边长、相邻Face数量和倒角距离相对边长的比例。
+  - 当前选中对象表支持 `新增倒角距离` 的对称距离倒角、`新增不等距倒角D1/D2` 的两侧不同距离倒角，以及 `新增距离+角度倒角D/角度`。
   - 橙色半透明预览表示目标Edge和输入倒角距离的大致范围。
   - 真实编辑使用 OCCT `BRepFilletAPI_MakeChamfer` 在后台执行。
   - STEP 没有建模历史，某些边仍可能被 OCCT 拒绝；失败时会自动尝试恢复编辑前状态。
 - 当前版本支持修改Edge长度：
   - 选中Edge后，`Edge目标长度` 会自动填入当前Edge长度。
+  - 对圆形/圆弧Edge，当前选中对象表会额外提供圆Edge半径和圆Edge直径可编辑行，内部会换算为等比例Edge目标长度。
   - 可以选择Edge长度基准：自动、中心、固定起点、固定终点。
+  - 对直线Edge，当前选中对象表会额外提供 `Edge起点坐标`、`Edge中心坐标` 和 `Edge终点坐标`，可以直接输入目标 X/Y/Z 坐标来移动单个端点或整条边。
   - 对正方体这类全平面多面体，直线Edge会优先走“局部边形变”：只移动被选Edge的一个端点或两个端点，并重建周边平面。
   - 局部边形变不会把整个端面拉走，因此正方体不会默认变成长方体；相邻面会按被移动的边自然变成梯形或拆成三角面。
+  - 直线Edge端点/中心坐标修改复用同一套局部边形变；当前只对简单全平面多面体开放，复杂曲面、带内孔Face或大型复杂Solid会阻止执行。
   - `自动` 默认固定起点、移动终点；`固定起点` / `固定终点` 会明确控制哪一端不动；`中心` 会让两端各移动一半。
   - 如果模型不是简单全平面多面体，直线Edge会继续尝试寻找端点附近、方向匹配的平面端面，并把“改边长”转换成该端面的平面推拉操作。
   - 圆形/圆弧Edge会优先检查相邻圆柱面；如果能复用孔/槽或凸台直径编辑，就把Edge目标长度按比例换算成目标圆柱直径再执行局部编辑。
@@ -243,6 +361,7 @@
 - 如果后台编辑失败，程序会自动尝试恢复到编辑前快照，避免出现“提示失败但模型已经被部分改动”的状态。
 - 当前版本支持圆柱孔/圆柱面扩大切削。
 - 当前版本支持圆柱孔/圆柱面缩小孔径：先补料，再用目标直径重切。
+- 当前版本支持完整圆柱孔轴心坐标修改：在当前选中对象表里修改 `孔轴心坐标`，程序会先补旧孔，再按同直径在目标轴心位置重切新孔；半孔/开放槽暂不放行这条路线，避免整圆柱工具误补材料。
 - 圆柱孔/圆柱面孔径调整现在会先生成切削计划：
   - 目标直径必须大于 0；如果目标直径与当前直径几乎相同，会直接阻止。
   - 会计算直径变化比例；变化超过当前直径 35% 会提高到中风险，超过 100% 会提高到高风险。
@@ -277,7 +396,7 @@
 - 鼠标拾取模型时会显示三维拾取点坐标。
 - 编辑历史会记录目标对象和当时的拾取点。
 - 支持把本软件加载后的编辑历史导出为 JSON v2；除摘要和详情外，也会保存 `operation_name`、`target`、`parameters` 和 `result_message`，为后续安全复放做准备。
-- 点击操作历史记录时，程序会尝试重新高亮目标对象，并显示当时的拾取点标记。
+- 点击操作历史记录时，程序会尝试重新高亮目标对象，并在详情里保留当时的拾取点坐标；3D 视图里不会再额外显示拾取点小球。
 - 对非 `hole/groove candidate` 的圆柱切削会先弹出确认，避免误切外圆角或凸柱。
 - 提供 `--smoke-test` 启动检查，用于验证 Qt + VTK 窗口组件能正常初始化。
 
@@ -302,7 +421,7 @@ vertices: 3262
 
 - 复杂特征识别：已经有平面、圆柱、边、孔/槽候选、槽/半孔候选、已有圆角候选、圆柱凸台候选等基础候选列表，但还不是完整 CAD 语义级识别。
 - 盲孔/盲槽深度：已经能对部分可识别候选做深度估算和编辑，并会优先使用疑似底面Face的轴向位置计算当前深度；但还不能保证所有模型都能恢复真实 CAD 语义深度。
-- 槽、凸台、壳体局部区域：已经有圆柱孔、槽/半孔候选结构化识别、槽/半孔宽度调整、完整圆柱凸台直径修改，以及平面薄壁/壳体相对面厚度估算和当前版本厚度调整；复杂槽、复杂凸台和完整壳体区域仍需要继续做。
+- 槽、凸台、壳体局部区域：已经有圆柱孔、槽/半孔候选结构化识别、槽/半孔宽度/深度/圆弧长度/圆弧角度/开口角度调整、长圆槽总长度/中心距调整和手动配对端 Face ID、完整圆柱凸台直径/半径/高度/轴心坐标修改、普通完整圆柱高度兜底修改，以及平面薄壁/壳体相对面厚度估算和当前版本厚度调整；复杂槽、复杂凸台和完整壳体区域仍需要继续做。
 - 已有圆角/倒圆面半径：已经有当前版本的受限修改实现，使用 defeature + refillet 路线，但复杂 blend、支撑面不明确或恢复锐边失败时仍会阻止或回滚。
 - 局部偏差分析：已经有编辑前后体积、面积、包围盒、距离热力图和差异报告，但还不是工程公差级的局部区域偏差报告。
 - 错误恢复和模型修复：已经有编辑前快照、失败回滚、基础 B-Rep 校验、同域面合并、布尔结果自动修复，以及一键修复当前模型或选中零件/solid，但还不是完整的模型修复流水线。
@@ -318,75 +437,12 @@ vertices: 3262
 建议下一步按这个顺序推进：
 
 1. 继续补齐更多最小可用特征入口，优先覆盖复杂槽、复杂凸台、完整壳体区域和装配用例。
-2. 继续验证平面推拉、孔径调整、槽/半孔宽度调整、薄壁厚度调整、盲孔/盲槽深度调整、圆柱凸台直径调整和直接边长调整，记录哪些对象稳定、哪些对象会失败。
+2. 继续验证平面推拉、孔径/半径调整、槽/半孔宽度/深度/圆弧长度调整、薄壁厚度调整、盲孔/盲槽深度调整、圆柱凸台直径/半径/高度/轴心坐标调整和直接边长调整，记录哪些对象稳定、哪些对象会失败。
 3. 改进盲孔/槽底面识别，减少“看起来像 blind 但找不到可靠底面Face”的候选。
 4. 继续加固已有圆角半径修改：扩大可成功场景，记录哪些圆角能 defeature + refillet，哪些需要更复杂的重建策略。
 5. 完善本软件编辑历史的导入/复放能力；当前 JSON v2 已保存机器可读的动作名和参数，但自动复放还需要按操作类型逐步加安全规则。
 6. 继续做性能和稳定性优化，重点是扫描分批刷新、局部显示重建缓存，以及高风险 OCC 操作隔离。
 
-## 怎么运行
-
-先打开 PowerShell，进入项目目录：
-
-```powershell
-cd C:\Users\admin\Desktop\python-occt
-```
-
-激活环境：
-
-```powershell
-conda activate pyocc
-```
-
-如果是在一台新电脑上第一次配置环境，可以使用仓库里的 `environment.yml` 创建环境：
-
-```powershell
-conda env create -f environment.yml
-conda activate pyocc
-```
-
-运行默认模型：
-
-```powershell
-python main.py
-```
-
-打开指定 STEP 文件：
-
-```powershell
-python main.py path\to\model.step
-```
-
-打开简单立方体测试模型：
-
-```powershell
-python main.py assets\models\cube_10mm.step
-```
-
-重新生成简单立方体测试模型：
-
-```powershell
-python scripts\generate_cube_step.py
-```
-
-如果当前 PowerShell 没识别 `conda`，可以直接使用完整路径运行：
-
-```powershell
-C:\Users\admin\miniforge3\Scripts\conda.exe run -n pyocc python main.py
-```
-
-启动烟测，不进入交互窗口：
-
-```powershell
-python main.py --smoke-test
-```
-
-验证立方体上的“只改一条 Edge 长度”基线：
-
-```powershell
-python scripts\verify_edge_length_resize.py
-```
-
 ## 怎么使用
 
 打开程序后，右侧是 3D 模型窗口，左侧是操作面板。
@@ -459,10 +515,10 @@ python scripts\verify_edge_length_resize.py
 - 当前默认显示一批代表性的可编辑对象，详细几何判断会尽量延后到选中对象或执行编辑前，避免扫描过慢。
 - `推拉平面` 行表示这个Face是平面，可以配合 `Face偏移` 和 `推拉平面` 使用。
 - `调整圆柱孔径` 行表示这个 Face 是圆柱面候选，可以配合 `孔直径` 和 `调整圆柱孔径` 使用。
-- `调整槽/半孔宽度` 行表示这个Face是槽/半孔候选，可以配合 `槽/半孔宽度` 和 `调整槽/半孔宽度` 使用。
-- `调整圆柱凸台直径` 行表示这个Face是较明确的完整圆柱凸台候选，可以配合 `凸台直径` 和 `调整圆柱凸台直径` 使用。
+- `调整槽/半孔宽度` / `调整槽/半孔深度` / `调整槽/半孔圆弧长度` 行表示这个Face是槽/半孔候选，可以在当前选中对象表里修改槽宽、槽深或圆弧长度。
+- `调整圆柱凸台直径` / `调整圆柱凸台高度` 行表示这个Face是较明确的完整圆柱凸台候选，可以在当前选中对象表里修改凸台直径、半径、高度或轴心坐标。
 - `封堵圆柱孔` 行表示这个Face是接近完整圆柱的孔候选，可以点击后直接使用 `封堵圆柱孔`。
-- `调整盲孔深度` 行表示这个Face是较明确的盲孔/盲槽候选，可以配合 `孔深度` 和 `调整盲孔深度` 使用。
+- `调整盲孔/盲槽深度` 行表示这个Face是较明确的盲孔/盲槽候选，可以在当前选中对象表里修改盲孔/盲槽深度。
 - `给Edge添加圆角` 行表示这个对象是直线Edge，可以配合 `圆角半径` 和 `给Edge添加圆角` 使用。
 - `给Edge添加倒角` 行表示这个对象是直线Edge，可以配合 `倒角距离` 和 `给Edge添加倒角` 使用。
 - `修改已有圆角半径` 行表示这个Face是已有圆角/倒圆候选，点击后会切到 `特征` 模式并预填圆角半径参考值；真正执行需要再点击编辑区里的 `修改已有圆角半径` 按钮并确认。
@@ -546,6 +602,23 @@ python scripts\verify_edge_length_resize.py
   - 输入目标槽宽后点击 `调整槽/半孔宽度`。
   - 程序会用当前圆弧角度把目标槽宽换算成目标圆柱直径，再复用圆柱孔/槽调整流程。
   - 这一步仍是 B-Rep 几何近似；复杂槽、非圆柱槽或圆弧角度不稳定时可能失败并回滚。
+- `槽/半孔深度`：
+  - 先选择一个槽/半孔候选 Face。
+  - 在当前选中对象表里修改 `槽/半孔深度`，点击该行的 `可修改` 或点击 `参数化建模`。
+  - 程序会按当前圆弧角度把目标槽深换算成目标圆柱直径，再复用圆柱孔/槽调整流程。
+- `槽/半孔圆弧长度`：
+  - 先选择一个槽/半孔候选 Face。
+  - 在当前选中对象表里修改 `槽/半孔圆弧长度`，点击该行的 `可修改` 或点击 `参数化建模`。
+  - 程序会按当前圆弧角度把目标圆弧长度换算成目标圆柱直径，再复用圆柱孔/槽调整流程。
+- `槽/半孔圆弧角度` / `槽/半孔开口角度`：
+  - 先选择一个槽/半孔候选 Face。
+  - 在当前选中对象表里修改角度值，角度输入单位是度。
+  - 圆弧角度会直接换算成局部扇形槽目标角度；开口角度会换算成 `2π - 开口角`。
+  - 程序会保持当前圆柱半径，先补旧扇形槽，再按目标角度重切局部扇形槽。
+- `槽孔配对端Face ID` / `槽孔总长度` / `槽孔中心距`：
+  - 对长圆槽或成对半圆槽，程序会自动寻找另一个槽端。
+  - 如果自动配对失败，可以先在 `槽孔配对端Face ID` 行填入另一个半圆端的 Face ID 并点击 `设置`。
+  - 修改 `槽孔总长度` 或 `槽孔中心距` 时，会保持槽宽不变并重建完整长圆槽体。
 - `薄壁厚度` + `调整薄壁厚度`：
   - 先选择一个平面 Face，建议从 `可编辑对象` 中点击 `调整薄壁厚度` 行进入。
   - 选中符合条件的薄壁/壳体平面后，`薄壁厚度` 会自动填入一个比当前估算厚度略大的建议值。
@@ -560,6 +633,14 @@ python scripts\verify_edge_length_resize.py
   - 目标直径小于当前直径时，会先用旧外形包络体移除原凸台范围，再 Fuse 目标直径圆柱重建。
   - 点击后会显示半透明预览：绿色表示扩大/重建补料范围，红色表示缩小移除范围。
   - 这不是 CAD 历史里的“修改凸台特征参数”，而是基于当前 B-Rep 的受限几何布尔编辑。
+- `凸台高度`：
+  - 先选择一个完整圆柱凸台 Face。
+  - 在当前选中对象表里修改 `凸台高度`，点击该行的 `可修改` 或点击 `参数化建模`。
+  - 程序会尝试找到凸台外端盖 Face，并通过推拉端盖改变高度。
+- `凸台轴心坐标`：
+  - 先选择一个完整圆柱凸台 Face。
+  - 在当前选中对象表里修改 `凸台轴心坐标`，点击该行的 `应用` 或点击 `参数化建模`。
+  - 程序会切掉旧凸台包络，再按原直径和原高度范围在目标轴心位置补出新凸台；目标位置离基体太远时风险会升高。
 - `封堵圆柱孔`：
   - 先选择一个完整圆柱孔 Face，建议从 `可编辑对象` 中点击 `封堵圆柱孔` 行进入。
   - 点击 `封堵圆柱孔` 后，程序会先生成补料计划。
@@ -591,6 +672,7 @@ python scripts\verify_edge_length_resize.py
   - 先切换到 `特征` 选择模式并选择一个已有圆角/倒圆候选 Face，或从 `可编辑对象` 中点击 `修改已有圆角半径` 行进入。
   - 选中已有圆角候选后，`圆角半径` 会自动填入一个基于当前估算半径的参考目标值。
   - 输入目标半径后点击 `修改已有圆角半径`。
+  - 也可以在当前选中对象表里修改 `已有圆角圆弧长度`，程序会按当前圆弧角度换算成目标半径后执行同一条修改路线。
   - 程序会先检查该Face是否为 `round/fillet candidate`、是否识别到至少两个支撑Face、目标半径是否有效，以及当前零件是否为单Solid。
   - 通过检查后，会显示蓝色半透明预览，表示将尝试移除并重建的已有圆角面。
   - 真实编辑会先用 OCCT defeaturing 移除已有圆角面，再从恢复出的候选锐边中寻找可重新倒圆的边并调用 OCCT 倒圆 API。
@@ -599,19 +681,26 @@ python scripts\verify_edge_length_resize.py
   - 先切换到 `Edge` 选择模式并选择一条直线Edge，或从 `可编辑对象` 中点击 `给Edge添加倒角` 行进入。
   - 选中直线Edge后，`倒角距离` 会自动填入一个较小的建议距离。
   - 输入目标倒角距离后点击 `给Edge添加倒角`。
+  - 如果需要两侧不同距离，在当前选中对象表里填写 `新增不等距倒角D1/D2`，格式为 `D1, D2`。
+  - 如果需要距离+角度倒角，在当前选中对象表里填写 `新增距离+角度倒角D/角度`，格式为 `距离, 角度`，角度单位是度。
+  - `倒角参考Face ID` 决定 D1/D2 的方向；默认使用当前Edge的第一个相邻Face，也可以改成另一个相邻Face后点击 `设置`。
   - 程序会先检查倒角距离是否大于 0、是否相对边长过大，以及该Edge是否检测到至少两个相邻Face。
   - 点击后会显示橙色半透明圆管预览，用于提示目标边和倒角距离范围。
   - 真实编辑会在后台调用 OCCT 倒角 API，完成后刷新模型。
-  - 当前只支持对称距离倒角，不支持两侧不同距离或距离+角度倒角。
+  - 当前支持对称距离倒角、两侧不同距离倒角和距离+角度倒角。
   - 由于 STEP 不带建模历史，某些边会被 OCCT 判断为不适合倒角；失败时程序会提示并尝试恢复编辑前状态。
 - `Edge目标长度` + `修改Edge长度`：
   - 先切换到 `Edge` 选择模式并选择一条Edge，或从 `可编辑对象` 中点击Edge长度相关行进入。
   - 选中Edge后，`Edge目标长度` 会自动填入当前Edge长度。
   - 右侧Edge长度基准下拉框可以选择 `自动`、`中心`、`固定起点` 或 `固定终点`。
   - 把它改成目标长度后点击 `修改Edge长度`。
+  - 如果选中的是直线Edge，也可以在当前选中对象表中直接修改 `Edge起点坐标`、`Edge中心坐标` 或 `Edge终点坐标`，格式是 `X, Y, Z`，然后点击该行的 `可修改` 按钮。
+  - 修改 `Edge中心坐标` 会保持这条直线Edge长度不变，两个端点一起移动；修改起点或终点则只移动对应端点。
   - 对 `assets/models/cube_10mm.step` 这类全平面多面体，直线Edge会优先只移动被选Edge的端点并重建周边平面。
   - 这时正方体不会默认变成长方体；相邻面会跟着被移动的边自然变成梯形，必要时非共面的面会拆成三角面。
   - 如果确认窗口里的策略是 `local-edge-only-deform`，说明走的就是“只变这条边”的局部形变路径。
+  - 如果确认窗口里的策略是 `local-edge-endpoint-deform`，说明走的是“移动起点/终点坐标”的局部形变路径。
+  - 如果确认窗口里的策略是 `local-edge-center-deform`，说明走的是“移动整条Edge中心坐标”的局部形变路径。
   - 如果模型不是简单全平面多面体，直线Edge会继续尝试端面推拉后备路径，并计算需要移动的端面Face和推拉距离。
   - 圆形/圆弧Edge会优先尝试复用相邻圆柱面的孔/槽或凸台直径编辑，并在确认窗口显示换算出来的目标直径。
   - 如果圆边没有可复用圆柱面，但能读取圆心和轴线，会走 `围绕圆边轴线径向缩放` 后备策略，尽量不改变轴向厚度/高度；执行后部分解析几何可能变成 B-spline。
@@ -653,7 +742,7 @@ python scripts\verify_edge_length_resize.py
   - `导出差异报告` 会把当前选中的历史记录导出为 `.txt`，里面包含操作详情、拓扑变化、几何变化和热力图统计。
   - `导出编辑历史` 会把当前会话中的本软件编辑记录导出为 `.json`，用于留档和后续复盘；当前格式是 `step-editor-operation-history-v2`，包含机器可读的动作名、目标和参数。
   - 当前热力图是“编辑后模型顶点到编辑前模型表面”的距离估算，不是完整 CAD 公差报告。
-  - 点击某条历史记录时，程序也会尝试重新高亮当时编辑的目标Face，并用青色小点标出当时的拾取位置。
+  - 点击某条历史记录时，程序也会尝试重新高亮当时编辑的目标Face，并在详情里显示当时的拾取位置；3D 视图里不会额外画拾取点小球。
   - 由于布尔编辑后拓扑 ID 可能重新分配，历史里的Face ID只能作为定位参考，不能视为稳定的 CAD 建模历史 ID。
   - 撤销后对应记录会从列表里退回。
   - 重做后对应记录会重新显示。
@@ -799,7 +888,7 @@ git diff --check
 - STEP 后台加载：首次先显示粗略网格，再异步切到精细显示，并可隐藏同域内部边。
 - 选择：支持零件、Solid、Face、Edge、特征。鼠标悬停红色预高亮，选中黄色高亮。
 - 同域面：Face/特征会尽量把共面或同轴同半径的连续碎面合成逻辑区域。
-- 编辑：平面推拉、孔径、槽/半孔宽度、盲孔/盲槽深度、凸台直径、已有圆角半径当前版本修改、Edge圆角、Edge倒角、薄壁厚度、修改Edge长度、零件/Solid 平移和旋转。
+- 编辑：平面推拉和目标法向位置、孔径/半径、槽/半孔宽度、深度、圆弧长度、圆弧角度、开口角度、槽孔总长度和中心距、盲孔/盲槽深度、凸台直径/半径/高度/轴心坐标、普通完整圆柱高度兜底修改、已有圆角半径/圆弧长度当前版本修改、圆锥半角、环面直径、Edge圆角、Edge倒角、圆Edge半径/直径、薄壁厚度、修改Edge长度、直线Edge起点/中心/终点坐标、零件/Solid 平移和旋转。Face 面积当前作为只读属性展示，不再伪装成直接可修改参数。
 - 恢复：编辑前快照、后台执行、失败回滚、撤销/重做、差异预览、热力图和差异报告。
 - 导出：完整模型、零件、Solid、Face、特征区域和 Edge，导出前做基础质量检查。
 
@@ -810,9 +899,10 @@ git diff --check
 当前策略顺序：
 
 1. `local-edge-only-deform`：直线Edge位于简单全平面多面体时，优先只移动被选Edge的端点并重建所属Solid/零件。对立方体测试模型，默认固定起点移动终点；相邻面会自然变成梯形，必要时非共面四边面拆三角面，而不是把整个正方体缩放成长方体。
-2. `move-edge-end-plane-by-push-pull`：如果不适合局部形变，尝试找端点附近、方向匹配的平面端面，把改边长转成端面推拉。
-3. `resize-adjacent-cylinder-from-circular-edge-length`：圆形/圆弧Edge尝试复用相邻圆柱孔/槽或凸台直径编辑。
-4. `scale-owning-shape-from-edge`：圆边、椭圆边和可采样为平面的非直线Edge会优先用 `radial-affine` 围绕曲线平面法向做径向缩放；其他无明确局部路径的Edge才按Edge轴向或整体做几何缩放 fallback，风险高，会影响其它尺寸。
+2. `local-edge-endpoint-deform`：直线Edge起点/终点坐标直接修改，同样只在简单全平面多面体上移动单个端点并重建周边平面。
+3. `move-edge-end-plane-by-push-pull`：如果不适合局部形变，尝试找端点附近、方向匹配的平面端面，把改边长转成端面推拉。
+4. `resize-adjacent-cylinder-from-circular-edge-length`：圆形/圆弧Edge尝试复用相邻圆柱孔/槽或凸台直径编辑。
+5. `scale-owning-shape-from-edge`：圆边、椭圆边和可采样为平面的非直线Edge会优先用 `radial-affine` 围绕曲线平面法向做径向缩放；其他无明确局部路径的Edge才按Edge轴向或整体做几何缩放 fallback，风险高，会影响其它尺寸。
 
 确认窗口和操作历史里要尽量记录策略、目标范围、目标Edge长度、基准、移动端点、重建面数和风险，方便用户判断结果是否符合预期。