simplecadapi 2.0.4__tar.gz → 2.0.6__tar.gz

{simplecadapi-2.0.4 → simplecadapi-2.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.0.4
+Version: 2.0.6
 Summary: A simplified CAD modeling Python API based on CADQuery
 Project-URL: Homepage, https://github.com/NiJingzhe/SimpleCADAPI
 Project-URL: Repository, https://github.com/NiJingzhe/SimpleCADAPI
@@ -376,58 +376,58 @@ Description-Content-Type: text/markdown
 
 # SimpleCADAPI
 
-SimpleCADAPI 是一个基于 CADQuery 的命令式 CAD 建模 Python 包，目标是把常见建模动作封装成清晰、可组合、可测试的函数式 API，并支持通过 Skills 方式分发“文档 + 脚本 + 运行时安装”工作流。
+SimpleCADAPI is an imperative CAD modeling Python package based on CADQuery. Its goal is to encapsulate common modeling operations into a clear, composable, testable functional API, and to support distributing "documentation + scripts + runtime installation" workflows via Skills.
 
-## README 定位
+## README Scope
 
-本 README 仅包含包级能力、安装方式、发布/打包流程与 Skills 使用说明。
-实验性脚本和临时建模样例不作为正式文档内容。
+This README only covers package-level capabilities, installation methods, publishing/packaging workflows, and Skills usage instructions.
+Experimental scripts and temporary modeling examples are not included as formal documentation.
 
-## 包安装（Python 包管理器）
+## Package Installation (Python Package Managers)
 
-当前包名：`simplecadapi`，版本：`2.0.4`（见 `pyproject.toml`）。
+Current package name: `simplecadapi`, version: `2.0.6` (see `pyproject.toml`).
 
-### 方式 A：用 pip 从包仓库安装
+### Method A: Install from package repository with pip
 
 ```bash
 pip install simplecadapi
 ```
 
-开发依赖可选安装：
+Optional development dependencies:
 
 ```bash
 pip install "simplecadapi[dev]"
 ```
 
-### 方式 B：用 uv 安装
+### Method B: Install with uv
 
-在当前虚拟环境安装：
+Install in the current virtual environment:
 
 ```bash
 uv pip install simplecadapi
 ```
 
-作为项目依赖写入 `pyproject.toml`：
+Add as a project dependency in `pyproject.toml`:
 
 ```bash
 uv add simplecadapi
 ```
 
-### 方式 C：从本地构建产物安装
+### Method C: Install from local build artifacts
 
-仓库内已有示例构建产物（`dist/`）：
+The repository already contains example build artifacts (`dist/`):
 
 ```bash
-pip install dist/simplecadapi-2.0.4-py3-none-any.whl
+pip install dist/simplecadapi-2.0.6-py3-none-any.whl
 ```
 
-如果你需要重新构建：
+If you need to rebuild:
 
 ```bash
 uv build
 ```
 
-## 快速验证安装
+## Quick Verification of Installation
 
 ```python
 import simplecadapi as scad
@@ -437,36 +437,36 @@ scad.export_stl(box, "example_box.stl")
 scad.export_step(box, "example_box.step")
 ```
 
-## 如何打包并使用 Skills
+## How to Package and Use Skills
 
-本项目提供 `skill-pack` CLI，用于生成轻量技能包（thin mode）：**不内置 SDK 源码**，运行时从包仓库安装 `simplecadapi`。
+This project provides the `skill-pack` CLI for generating lightweight skill packages (thin mode): **No built-in SDK source code**, runtime installs `simplecadapi` from the package repository.
 
-### 1) 打包命令
+### 1) Packaging Command
 
-在仓库根目录执行：
+Execute in the repository root directory:
 
 ```bash
 uv run skill-pack --refresh-docs --archive --skill-name simplecad-self-evolve
 ```
 
-常用参数：
+Common parameters:
 
-- `--output-root <dir>`：输出目录（默认 `./skills`）
-- `--package-name <pkg>`：运行时安装包名（默认读取 `project.name`）
-- `--package-version <ver>`：运行时安装版本（默认读取 `project.version`）
-- `--no-clean`：不清理已有输出目录
-- `--archive`：额外生成 `<skill-name>.tar.gz`
+- `--output-root <dir>`: Output directory (default `./skills`)
+- `--package-name <pkg>`: Runtime installation package name (default reads from `project.name`)
+- `--package-version <ver>`: Runtime installation version (default reads from `project.version`)
+- `--no-clean`: Do not clean existing output directory
+- `--archive`: Additionally generate `<skill-name>.tar.gz`
 
-### 2) 打包结果结构
+### 2) Packaging Result Structure
 
-打包后将得到类似目录：
+After packaging, you will get a directory similar to:
 
 - `skills/simplecad-self-evolve/SKILL.md`
 - `skills/simplecad-self-evolve/scripts/`
 - `skills/simplecad-self-evolve/references/`
 - `skills/simplecad-self-evolve/cases/simplecad_self_evolve_cases/`
 
-### 3) 在 skill 目录中安装并检查运行时
+### 3) Install and Verify Runtime in the Skill Directory
 
 ```bash
 cd skills/simplecad-self-evolve
@@ -474,47 +474,47 @@ PYTHON_BIN=.venv/bin/python scripts/install.sh
 PYTHON_BIN=.venv/bin/python scripts/with_skill.sh --check
 ```
 
-### 4) 用包装脚本运行你的程序
+### 4) Run Your Program with the Wrapper Script
 
 ```bash
 PYTHON_BIN=.venv/bin/python scripts/with_skill.sh -- .venv/bin/python your_script.py
 ```
 
-### 5) 激活 skill-local 案例模块路径
+### 5) Activate skill-local Case Module Path
 
 ```bash
 eval "$(scripts/with_skill.sh --print-env)"
 ```
 
-激活后可直接导入：
+After activation, you can directly import:
 
 ```python
 from simplecad_self_evolve_cases.evolve import make_involute_spur_gear_rsolid
 ```
 
-### 6) 向 skill 本地 evolve 模块追加新函数
+### 6) Add New Functions to the Skill-local evolve Module
 
 ```bash
 scripts/add_new_case.sh path/to/new_case.py
 ```
 
-### 7) Jupyter 与结构校验
+### 7) Jupyter and Structure Validation
 
 ```bash
 scripts/jupyter_with_skill.sh lab
 scripts/validate_skill.sh
 ```
 
-## 自动化工具（Auto Tools）
+## Auto Tools
 
-项目内置 4 个主要 CLI：
+The project includes 4 main CLIs:
 
-- `auto-docs-gen`：从 API 源码生成 `docs/api/` 文档
-- `make-export`：更新 `src/simplecadapi/__init__.py` 的导入导出
-- `evolve`：从脚本提取函数并追加到 evolve 模块
-- `skill-pack`：打包 thin skill（文档 + 脚本 + cases）
+- `auto-docs-gen`: Generate `docs/api/` documentation from API source code
+- `make-export`: Update imports/exports in `src/simplecadapi/__init__.py`
+- `evolve`: Extract functions from scripts and append to the evolve module
+- `skill-pack`: Package thin skill (documentation + scripts + cases)
 
-示例：
+Examples:
 
 ```bash
 uv run make-export --dry-run
@@ -523,19 +523,17 @@ uv run evolve path/to/your_case.py
 uv run skill-pack --refresh-docs --archive
 ```
 
-## RAGFlow 文档同步
+## RAGFlow Documentation Sync
 
-`scripts/sync_ragflow_docs.py` 用于把 `docs/` 下的 Markdown 增量同步到指定
-RAGFlow 数据集，并按二级标题（H2）分块；文档的 `chunk_method` 会设置为
-`manual`。
+`scripts/sync_ragflow_docs.py` is used to incrementally sync Markdown files under `docs/` to the specified RAGFlow dataset, chunked by H2 headings; the document's `chunk_method` is set to `manual`.
 
-准备环境：
+Prepare the environment:
 
 ```bash
 .venv/bin/python -m pip install ragflow-sdk
 ```
 
-建议使用 `.env`（已加入 `.gitignore`）：
+It is recommended to use `.env` (already added to `.gitignore`):
 
 ```bash
 RAGFLOW_API_KEY=your_key_here
@@ -543,52 +541,52 @@ RAGFLOW_BASE_URL=http://localhost
 RAGFLOW_DATASET_NAME=SimpleCADAPI
 ```
 
-运行同步：
+Run the sync:
 
 ```bash
 set -a && source .env && set +a
 .venv/bin/python scripts/sync_ragflow_docs.py --create-dataset
 ```
 
-常用参数：
+Common parameters:
 
-- `--dataset-id` / `RAGFLOW_DATASET_ID`：直接指定数据集 ID（避免同名冲突）
-- `--delete-removed`：同步删除本地已移除的文档
-- `--dry-run`：只预览变更，不执行写入
-- `--progress-interval N`：每 N 篇打印一次进度
+- `--dataset-id` / `RAGFLOW_DATASET_ID`: Directly specify the dataset ID (avoid name conflicts)
+- `--delete-removed`: Delete documents that have been removed locally
+- `--dry-run`: Only preview changes without executing writes
+- `--progress-interval N`: Print progress every N documents
 
-## 开发与测试
+## Development and Testing
 
-本地开发安装（可编辑）：
+Local development installation (editable):
 
 ```bash
 uv pip install -e ".[dev]"
 ```
 
-运行单元测试：
+Run unit tests:
 
 ```bash
 uv run python -m unittest test/test_all_features.py
 ```
 
-运行示例：
+Run examples:
 
 ```bash
 uv run python examples.py
 ```
 
-## 核心设计约束（简要）
+## Core Design Constraints (Brief)
 
-- API 函数统一使用 `snake_case`，并通过函数名体现返回类型（如 `*_rsolid`、`*_rwire`）。
-- 核心类型尽量稳定，功能扩展通过新增函数完成（开放封闭原则）。
-- 支持 `SimpleWorkplane` 上下文进行局部坐标建模。
-- 导出接口支持单实体、多实体及嵌套列表输入。
+- API functions uniformly use `snake_case` and reflect return types in function names (e.g., `*_rsolid`, `*_rwire`).
+- Core types are kept as stable as possible; functionality is extended by adding new functions (Open-Closed Principle).
+- Support `SimpleWorkplane` context for local coordinate modeling.
+- Export interfaces support single entities, multiple entities, and nested list inputs.
 
-## 文档入口
+## Documentation Entry Points
 
-- API 文档：`docs/api/`
-- Core 文档：`docs/core/`
+- API documentation: `docs/api/`
+- Core documentation: `docs/core/`
 
 ## License
 
-MIT，见 `LICENSE`。
+MIT, see `LICENSE`.

simplecadapi-2.0.6/README.md

@@ -0,0 +1,216 @@
+# SimpleCADAPI
+
+SimpleCADAPI is an imperative CAD modeling Python package based on CADQuery. Its goal is to encapsulate common modeling operations into a clear, composable, testable functional API, and to support distributing "documentation + scripts + runtime installation" workflows via Skills.
+
+## README Scope
+
+This README only covers package-level capabilities, installation methods, publishing/packaging workflows, and Skills usage instructions.
+Experimental scripts and temporary modeling examples are not included as formal documentation.
+
+## Package Installation (Python Package Managers)
+
+Current package name: `simplecadapi`, version: `2.0.6` (see `pyproject.toml`).
+
+### Method A: Install from package repository with pip
+
+```bash
+pip install simplecadapi
+```
+
+Optional development dependencies:
+
+```bash
+pip install "simplecadapi[dev]"
+```
+
+### Method B: Install with uv
+
+Install in the current virtual environment:
+
+```bash
+uv pip install simplecadapi
+```
+
+Add as a project dependency in `pyproject.toml`:
+
+```bash
+uv add simplecadapi
+```
+
+### Method C: Install from local build artifacts
+
+The repository already contains example build artifacts (`dist/`):
+
+```bash
+pip install dist/simplecadapi-2.0.6-py3-none-any.whl
+```
+
+If you need to rebuild:
+
+```bash
+uv build
+```
+
+## Quick Verification of Installation
+
+```python
+import simplecadapi as scad
+
+box = scad.make_box_rsolid(10.0, 20.0, 30.0)
+scad.export_stl(box, "example_box.stl")
+scad.export_step(box, "example_box.step")
+```
+
+## How to Package and Use Skills
+
+This project provides the `skill-pack` CLI for generating lightweight skill packages (thin mode): **No built-in SDK source code**, runtime installs `simplecadapi` from the package repository.
+
+### 1) Packaging Command
+
+Execute in the repository root directory:
+
+```bash
+uv run skill-pack --refresh-docs --archive --skill-name simplecad-self-evolve
+```
+
+Common parameters:
+
+- `--output-root <dir>`: Output directory (default `./skills`)
+- `--package-name <pkg>`: Runtime installation package name (default reads from `project.name`)
+- `--package-version <ver>`: Runtime installation version (default reads from `project.version`)
+- `--no-clean`: Do not clean existing output directory
+- `--archive`: Additionally generate `<skill-name>.tar.gz`
+
+### 2) Packaging Result Structure
+
+After packaging, you will get a directory similar to:
+
+- `skills/simplecad-self-evolve/SKILL.md`
+- `skills/simplecad-self-evolve/scripts/`
+- `skills/simplecad-self-evolve/references/`
+- `skills/simplecad-self-evolve/cases/simplecad_self_evolve_cases/`
+
+### 3) Install and Verify Runtime in the Skill Directory
+
+```bash
+cd skills/simplecad-self-evolve
+PYTHON_BIN=.venv/bin/python scripts/install.sh
+PYTHON_BIN=.venv/bin/python scripts/with_skill.sh --check
+```
+
+### 4) Run Your Program with the Wrapper Script
+
+```bash
+PYTHON_BIN=.venv/bin/python scripts/with_skill.sh -- .venv/bin/python your_script.py
+```
+
+### 5) Activate skill-local Case Module Path
+
+```bash
+eval "$(scripts/with_skill.sh --print-env)"
+```
+
+After activation, you can directly import:
+
+```python
+from simplecad_self_evolve_cases.evolve import make_involute_spur_gear_rsolid
+```
+
+### 6) Add New Functions to the Skill-local evolve Module
+
+```bash
+scripts/add_new_case.sh path/to/new_case.py
+```
+
+### 7) Jupyter and Structure Validation
+
+```bash
+scripts/jupyter_with_skill.sh lab
+scripts/validate_skill.sh
+```
+
+## Auto Tools
+
+The project includes 4 main CLIs:
+
+- `auto-docs-gen`: Generate `docs/api/` documentation from API source code
+- `make-export`: Update imports/exports in `src/simplecadapi/__init__.py`
+- `evolve`: Extract functions from scripts and append to the evolve module
+- `skill-pack`: Package thin skill (documentation + scripts + cases)
+
+Examples:
+
+```bash
+uv run make-export --dry-run
+uv run auto-docs-gen
+uv run evolve path/to/your_case.py
+uv run skill-pack --refresh-docs --archive
+```
+
+## RAGFlow Documentation Sync
+
+`scripts/sync_ragflow_docs.py` is used to incrementally sync Markdown files under `docs/` to the specified RAGFlow dataset, chunked by H2 headings; the document's `chunk_method` is set to `manual`.
+
+Prepare the environment:
+
+```bash
+.venv/bin/python -m pip install ragflow-sdk
+```
+
+It is recommended to use `.env` (already added to `.gitignore`):
+
+```bash
+RAGFLOW_API_KEY=your_key_here
+RAGFLOW_BASE_URL=http://localhost
+RAGFLOW_DATASET_NAME=SimpleCADAPI
+```
+
+Run the sync:
+
+```bash
+set -a && source .env && set +a
+.venv/bin/python scripts/sync_ragflow_docs.py --create-dataset
+```
+
+Common parameters:
+
+- `--dataset-id` / `RAGFLOW_DATASET_ID`: Directly specify the dataset ID (avoid name conflicts)
+- `--delete-removed`: Delete documents that have been removed locally
+- `--dry-run`: Only preview changes without executing writes
+- `--progress-interval N`: Print progress every N documents
+
+## Development and Testing
+
+Local development installation (editable):
+
+```bash
+uv pip install -e ".[dev]"
+```
+
+Run unit tests:
+
+```bash
+uv run python -m unittest test/test_all_features.py
+```
+
+Run examples:
+
+```bash
+uv run python examples.py
+```
+
+## Core Design Constraints (Brief)
+
+- API functions uniformly use `snake_case` and reflect return types in function names (e.g., `*_rsolid`, `*_rwire`).
+- Core types are kept as stable as possible; functionality is extended by adding new functions (Open-Closed Principle).
+- Support `SimpleWorkplane` context for local coordinate modeling.
+- Export interfaces support single entities, multiple entities, and nested list inputs.
+
+## Documentation Entry Points
+
+- API documentation: `docs/api/`
+- Core documentation: `docs/core/`
+
+## License
+
+MIT, see `LICENSE`.

simplecadapi-2.0.6/docs/api/README.md

@@ -0,0 +1,119 @@
+# SimpleCAD API Index
+
+This index includes API docs generated from `operations.py`, `evolve.py`, `constraints.py`, and `ql.py`.
+
+## Basic Creation
+
+- [make_angle_arc_redge](make_angle_arc_redge.md) *(from operations.py)*
+- [make_angle_arc_rwire](make_angle_arc_rwire.md) *(from operations.py)*
+- [make_box_rscalarfield](make_box_rscalarfield.md) *(from field.py)*
+- [make_box_rsolid](make_box_rsolid.md) *(from operations.py)*
+- [make_capsule_rscalarfield](make_capsule_rscalarfield.md) *(from field.py)*
+- [make_circle_redge](make_circle_redge.md) *(from operations.py)*
+- [make_circle_rface](make_circle_rface.md) *(from operations.py)*
+- [make_circle_rwire](make_circle_rwire.md) *(from operations.py)*
+- [make_cone_rsolid](make_cone_rsolid.md) *(from operations.py)*
+- [make_cylinder_rsolid](make_cylinder_rsolid.md) *(from operations.py)*
+- [make_ellipsoid_rscalarfield](make_ellipsoid_rscalarfield.md) *(from field.py)*
+- [make_face_from_wire_rface](make_face_from_wire_rface.md) *(from operations.py)*
+- [make_field_surface_rsolid](make_field_surface_rsolid.md) *(from operations.py)*
+- [make_helix_redge](make_helix_redge.md) *(from operations.py)*
+- [make_helix_rwire](make_helix_rwire.md) *(from operations.py)*
+- [make_line_redge](make_line_redge.md) *(from operations.py)*
+- [make_point_rvertex](make_point_rvertex.md) *(from operations.py)*
+- [make_polyline_rwire](make_polyline_rwire.md) *(from operations.py)*
+- [make_rectangle_rface](make_rectangle_rface.md) *(from operations.py)*
+- [make_rectangle_rwire](make_rectangle_rwire.md) *(from operations.py)*
+- [make_segment_redge](make_segment_redge.md) *(from operations.py)*
+- [make_segment_rwire](make_segment_rwire.md) *(from operations.py)*
+- [make_sphere_rscalarfield](make_sphere_rscalarfield.md) *(from field.py)*
+- [make_sphere_rsolid](make_sphere_rsolid.md) *(from operations.py)*
+- [make_spline_redge](make_spline_redge.md) *(from operations.py)*
+- [make_spline_rwire](make_spline_rwire.md) *(from operations.py)*
+- [make_three_point_arc_redge](make_three_point_arc_redge.md) *(from operations.py)*
+- [make_three_point_arc_rwire](make_three_point_arc_rwire.md) *(from operations.py)*
+- [make_wire_from_edges_rwire](make_wire_from_edges_rwire.md) *(from operations.py)*
+
+## Transforms
+
+- [mirror_shape](mirror_shape.md) *(from operations.py)*
+- [rotate_rscalarfield](rotate_rscalarfield.md) *(from field.py)*
+- [rotate_shape](rotate_shape.md) *(from operations.py)*
+- [translate_rscalarfield](translate_rscalarfield.md) *(from field.py)*
+- [translate_shape](translate_shape.md) *(from operations.py)*
+
+## 3D Operations
+
+- [extrude_rsolid](extrude_rsolid.md) *(from operations.py)*
+- [loft_rsolid](loft_rsolid.md) *(from operations.py)*
+- [revolve_rsolid](revolve_rsolid.md) *(from operations.py)*
+- [sweep_rsolid](sweep_rsolid.md) *(from operations.py)*
+
+## Tagging and Selection
+
+- [select_edges_by_tag](select_edges_by_tag.md) *(from operations.py)*
+- [select_faces_by_tag](select_faces_by_tag.md) *(from operations.py)*
+- [set_tag](set_tag.md) *(from operations.py)*
+
+## Boolean Operations
+
+- [cut_rsolidlist](cut_rsolidlist.md) *(from operations.py)*
+- [intersect_rscalarfield](intersect_rscalarfield.md) *(from field.py)*
+- [intersect_rsolidlist](intersect_rsolidlist.md) *(from operations.py)*
+- [union_rscalarfield](union_rscalarfield.md) *(from field.py)*
+- [union_rsolidlist](union_rsolidlist.md) *(from operations.py)*
+
+## Export
+
+- [export_step](export_step.md) *(from operations.py)*
+- [export_stl](export_stl.md) *(from operations.py)*
+
+## Advanced Features
+
+- [chamfer_rsolid](chamfer_rsolid.md) *(from operations.py)*
+- [fillet_rsolid](fillet_rsolid.md) *(from operations.py)*
+- [helical_sweep_rsolid](helical_sweep_rsolid.md) *(from operations.py)*
+- [shell_rsolid](shell_rsolid.md) *(from operations.py)*
+
+## Evolve
+
+- [make_n_hole_flange_rsolid](make_n_hole_flange_rsolid.md) *(from evolve.py)*
+- [make_naca_propeller_blade_rsolid](make_naca_propeller_blade_rsolid.md) *(from evolve.py)*
+- [make_threaded_rod_rsolid](make_threaded_rod_rsolid.md) *(from evolve.py)*
+
+## Assembly Constraints
+
+- [add_part_rassembly](add_part_rassembly.md) *(from constraints.py)*
+- [clear_constraints_rassembly](clear_constraints_rassembly.md) *(from constraints.py)*
+- [clone_assembly_rassembly](clone_assembly_rassembly.md) *(from constraints.py)*
+- [constrain_coincident_rassembly](constrain_coincident_rassembly.md) *(from constraints.py)*
+- [constrain_concentric_rassembly](constrain_concentric_rassembly.md) *(from constraints.py)*
+- [constrain_distance_rassembly](constrain_distance_rassembly.md) *(from constraints.py)*
+- [constrain_offset_rassembly](constrain_offset_rassembly.md) *(from constraints.py)*
+- [make_assembly_rassembly](make_assembly_rassembly.md) *(from constraints.py)*
+- [rotate_part_rassembly](rotate_part_rassembly.md) *(from constraints.py)*
+- [solve_assembly_rresult](solve_assembly_rresult.md) *(from constraints.py)*
+- [stack](stack.md) *(from constraints.py)*
+- [stack_rassembly](stack_rassembly.md) *(from constraints.py)*
+- [translate_part_rassembly](translate_part_rassembly.md) *(from constraints.py)*
+
+## Other
+
+- [and_](and_.md) *(from ql.py)*
+- [bounds_rbbox](bounds_rbbox.md) *(from field.py)*
+- [eval_rarray](eval_rarray.md) *(from field.py)*
+- [eval_rscalar](eval_rscalar.md) *(from field.py)*
+- [geo](geo.md) *(from ql.py)*
+- [linear_pattern_rsolidlist](linear_pattern_rsolidlist.md) *(from operations.py)*
+- [meta](meta.md) *(from ql.py)*
+- [not_](not_.md) *(from ql.py)*
+- [or_](or_.md) *(from ql.py)*
+- [radial_pattern_rsolidlist](radial_pattern_rsolidlist.md) *(from operations.py)*
+- [render_screenshot_rpath](render_screenshot_rpath.md) *(from operations.py)*
+- [scale_rscalarfield](scale_rscalarfield.md) *(from field.py)*
+- [select](select.md) *(from ql.py)*
+- [smooth_subtract_rscalarfield](smooth_subtract_rscalarfield.md) *(from field.py)*
+- [smooth_union_rscalarfield](smooth_union_rscalarfield.md) *(from field.py)*
+- [subtract_rscalarfield](subtract_rscalarfield.md) *(from field.py)*
+- [tag](tag.md) *(from ql.py)*
+- [value](value.md) *(from ql.py)*

{simplecadapi-2.0.4/skills/simplecad-self-evolve/references → simplecadapi-2.0.6}/docs/api/add_part_rassembly.md

@@ -10,4 +10,4 @@ def add_part_rassembly(assembly: Assembly, name: str, solid: Solid, parent: Opti
 
 ## Description
 
-Type-2映射：在装配空间中新增零件并返回新装配对象。
+Type-2 mapping: add a part in assembly space and return a new assembly.

{simplecadapi-2.0.4/skills/simplecad-self-evolve/references → simplecadapi-2.0.6}/docs/api/and_.md

@@ -10,7 +10,7 @@ def and_(*predicates: Predicate) -> Predicate
 
 ## Description
 
-构造 AND 组合谓词。
+Build an AND-composed predicate.
 
 Q.and_(Q.tag("face.top"), Q.tag("role.mounting_surface"))
 
@@ -18,8 +18,8 @@ Q.and_(Q.tag("face.top"), Q.tag("role.mounting_surface"))
 
 ### *predicates
 
-- **Description**: 任意数量谓词。
+- **Description**: Any number of predicates.
 
 ## Returns
 
-Callable[[Any], bool]: 组合谓词。
+Callable[[Any], bool]: Combined predicate.

{simplecadapi-2.0.4/skills/simplecad-self-evolve/references → simplecadapi-2.0.6}/docs/api/bounds_rbbox.md

@@ -10,14 +10,14 @@ def bounds_rbbox(field: ScalarField) -> Tuple[Tuple[float, float, float], Tuple[
 
 ## Description
 
-计算标量场的轴对齐包围盒。
+Compute the axis-aligned bounding box of a scalar field.
 
 ## Parameters
 
 ### field
 
-- **Description**: 标量场。
+- **Description**: Scalar field.
 
 ## Returns
 
-Tuple[min_xyz, max_xyz]: 包围盒。
+Tuple[min_xyz, max_xyz]: Bounding box.

simplecadapi-2.0.6/docs/api/chamfer_rsolid.md

@@ -0,0 +1,13 @@
+# chamfer_rsolid
+
+## API Definition
+
+```python
+def chamfer_rsolid(solid: Solid, edges: List[Edge], distance: float) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Apply chamfers to selected solid edges.