simplecadapi 2.0.0__tar.gz → 2.0.2__tar.gz

{simplecadapi-2.0.0 → simplecadapi-2.0.2}/.gitignore

@@ -9,6 +9,14 @@ wheels/
 # Virtual environments
 .venv
 
+.env
+
 output/
 
-.DS_Store
+# Sandbox artifacts
+sandbox/
+
+# Generated skills archives
+skills/*.tar.gz
+
+.DS_Store

{simplecadapi-2.0.0 → simplecadapi-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.0.0
+Version: 2.0.2
 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
@@ -374,90 +374,221 @@ Provides-Extra: editor
 Requires-Dist: cq-editor>=0.5.0; extra == 'editor'
 Description-Content-Type: text/markdown
 
-# CAD建模形式化Python API设计与实现
+# SimpleCADAPI
 
----
+SimpleCADAPI 是一个基于 CADQuery 的命令式 CAD 建模 Python 包，目标是把常见建模动作封装成清晰、可组合、可测试的函数式 API，并支持通过 Skills 方式分发“文档 + 脚本 + 运行时安装”工作流。
 
-## 简介
+## README 定位
 
-本项目旨在使用CadQuery的occ impl.shapes中提供的方法，编写一套命令式的Python API，以简化通过代码进行CAD建模的过程。API设计遵循开放封闭原则，核心类型封闭，所有的操作和扩展都通过新建函数实现。
-同时兼容Numpy库，允许用户在几何体上进行高效的数学运算和变换。
+本 README 仅包含包级能力、安装方式、发布/打包流程与 Skills 使用说明。
+实验性脚本和临时建模样例不作为正式文档内容。
 
-## 详细文档
+## 包安装（Python 包管理器）
 
-![Document](./docs/)
+当前包名：`simplecadapi`，版本：`2.0.2`（见 `pyproject.toml`）。
 
-## 基础类型
+### 方式 A：用 pip 从包仓库安装
 
-### 图元类型
+```bash
+pip install simplecadapi
+```
 
-图元类型和OCP的TopoDS_Shape类型一一对应，主要包括以下几种：
+开发依赖可选安装：
 
-- `Solid`: 实体类型，表示封闭的三维几何体。
-- `Face`: 面类型，表示单个表面。
-- `Edge`: 边类型，表示曲线边界。
-- `Vertex`: 顶点类型，表示几何体的点。
-- `Wire`: 线类型，表示边的集合。
+```bash
+pip install "simplecadapi[dev]"
+```
 
-### 坐标系类型
+### 方式 B：用 uv 安装
 
-坐标系类型用于定义三维空间中的位置和方向，我们对于世界坐标系的定义是：一个右手坐标系，原点在(0, 0, 0)，默认X轴向前，Y轴向右，Z轴向上。坐标系类型包括：
+在当前虚拟环境安装：
 
-- `SimpleWorkplane`: 工作平面类型，表示一个二维平面，本质上统计一个原点和一个法向量和一个X轴方向向量。作为一个上下文变量，可以通过with语法包裹操作，那么这些操作就会在这个工作平面下进行。允许嵌套定义Workplane，那么嵌套定义的平面将在上一个平面的基础上进行变换。
+```bash
+uv pip install simplecadapi
+```
 
-## API命名风格
+作为项目依赖写入 `pyproject.toml`：
 
-- 所有函数名使用小写字母和下划线分隔（snake_case），要求使用动词开头，表示操作或行为，同时需要包含API的返回类型(因为同名API可能会重载为返回不同类型的对象，但我们想要避免这一点)，例如：`make_circle_rwire`, `make_circle_redge`, `make_circle_rface`, `extrude_rsolid`等
-- 类名使用驼峰命名法（CamelCase）
-- 函数和类的文档字符串使用Google风格，包含参数、返回值和异常说明
-- 所有函数和类都应有类型注解，确保代码的可读性和可维护性
-- 所有函数和类都应有详细的文档字符串，描述其功能、参数、返回值和异常
-- 所有函数和类都应有示例代码，便于用户理解和使用
-- 所有的代码实现都要有严格且详细的try catch和异常抛出，异常抛出的内容中要求明确指出错误原因，以及用户应当如何在调用层做出怎样的改进可能可以避免这个问题。
+```bash
+uv add simplecadapi
+```
 
-## 扩展原则
+### 方式 C：从本地构建产物安装
 
-开放封闭原则，核心类型封闭，所有的操作和扩展都通过新建函数实现。我们可以通过利用现有的函数和操作来组合出新的高级操作并封装为函数来实现功能的扩展。
+仓库内已有示例构建产物（`dist/`）：
 
-## 自动化工具 (Auto Tools)
+```bash
+pip install dist/simplecadapi-2.0.2-py3-none-any.whl
+```
 
-项目包含一套自动化工具，用于支持API的自进化开发流程：
+如果你需要重新构建：
 
-### 主要CLI工具
+```bash
+uv build
+```
 
-#### 1. `auto_docs_gen.py` - 动态文档生成
-- **功能**: 自动从`operations.py`和`evolve.py`中提取所有API函数
-- **特点**:
-  - 解析函数签名、文档字符串、参数说明、返回值、异常信息
-  - 自动清理已删除API对应的过期文档
-  - 支持多源文件与多输出目录参数（`--source`、`--output-dir`）
-- **输出**: 生成格式统一的Markdown文档到`docs/api/`目录（默认）
-- **使用**: `auto-docs-gen [--source <path>] [--output-dir <dir>] [--no-clean]`
+## 快速验证安装
 
-#### 2. `make_export.py` - 动态修改__init__.py
-- **功能**: 自动更新`__init__.py`文件中的导入和导出
-- **特点**: 
-  - 自动检测新增的API函数
-  - 按功能分类组织导入语句
-  - 生成友好的别名映射
-  - 支持预览模式(`--dry-run`)和强制模式(`--force`)
-- **使用**: `python make_export.py [--dry-run] [--force]`
+```python
+import simplecadapi as scad
 
-#### 3. `evolution.py` - 代码自进化
-- **功能**: 从指定脚本中自动抽取新的建模函数并添加到`evolve.py`
-- **特点**: 
-  - 提取函数完整实现代码
-  - 自动处理导入语句
-  - 支持代码自进化开发流程
-- **使用**: `python evolution.py <script_path>`
+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")
+```
 
-### 自进化开发流程
+## 如何打包并使用 Skills
 
-这套工具支持以下自进化开发流程：
+本项目提供 `skill-pack` CLI，用于生成轻量技能包（thin mode）：**不内置 SDK 源码**，运行时从包仓库安装 `simplecadapi`。
 
-1. **开发新API**: 在`operations.py`或`evolve.py`中添加新函数
-2. **自动导出**: 运行`make_export.py`更新`__init__.py`
-3. **生成文档**: 运行`auto_docs_gen.py`生成API文档
-4. **持续进化**: 重复上述流程实现API的持续进化
+### 1) 打包命令
 
-所有工具都支持错误处理和详细的日志输出，确保开发流程的稳定性和可追踪性。
+在仓库根目录执行：
+
+```bash
+uv run skill-pack --refresh-docs --archive --skill-name simplecad-self-evolve
+```
+
+常用参数：
+
+- `--output-root <dir>`：输出目录（默认 `./skills`）
+- `--package-name <pkg>`：运行时安装包名（默认读取 `project.name`）
+- `--package-version <ver>`：运行时安装版本（默认读取 `project.version`）
+- `--no-clean`：不清理已有输出目录
+- `--archive`：额外生成 `<skill-name>.tar.gz`
+
+### 2) 打包结果结构
+
+打包后将得到类似目录：
+
+- `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 目录中安装并检查运行时
+
+```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) 用包装脚本运行你的程序
+
+```bash
+PYTHON_BIN=.venv/bin/python scripts/with_skill.sh -- .venv/bin/python your_script.py
+```
+
+### 5) 激活 skill-local 案例模块路径
+
+```bash
+eval "$(scripts/with_skill.sh --print-env)"
+```
+
+激活后可直接导入：
+
+```python
+from simplecad_self_evolve_cases.evolve import make_involute_spur_gear_rsolid
+```
+
+### 6) 向 skill 本地 evolve 模块追加新函数
+
+```bash
+scripts/add_new_case.sh path/to/new_case.py
+```
+
+### 7) Jupyter 与结构校验
+
+```bash
+scripts/jupyter_with_skill.sh lab
+scripts/validate_skill.sh
+```
+
+## 自动化工具（Auto Tools）
+
+项目内置 4 个主要 CLI：
+
+- `auto-docs-gen`：从 API 源码生成 `docs/api/` 文档
+- `make-export`：更新 `src/simplecadapi/__init__.py` 的导入导出
+- `evolve`：从脚本提取函数并追加到 evolve 模块
+- `skill-pack`：打包 thin skill（文档 + 脚本 + cases）
+
+示例：
+
+```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 文档同步
+
+`scripts/sync_ragflow_docs.py` 用于把 `docs/` 下的 Markdown 增量同步到指定
+RAGFlow 数据集，并按二级标题（H2）分块；文档的 `chunk_method` 会设置为
+`manual`。
+
+准备环境：
+
+```bash
+.venv/bin/python -m pip install ragflow-sdk
+```
+
+建议使用 `.env`（已加入 `.gitignore`）：
+
+```bash
+RAGFLOW_API_KEY=your_key_here
+RAGFLOW_BASE_URL=http://localhost
+RAGFLOW_DATASET_NAME=SimpleCADAPI
+```
+
+运行同步：
+
+```bash
+set -a && source .env && set +a
+.venv/bin/python scripts/sync_ragflow_docs.py --create-dataset
+```
+
+常用参数：
+
+- `--dataset-id` / `RAGFLOW_DATASET_ID`：直接指定数据集 ID（避免同名冲突）
+- `--delete-removed`：同步删除本地已移除的文档
+- `--dry-run`：只预览变更，不执行写入
+- `--progress-interval N`：每 N 篇打印一次进度
+
+## 开发与测试
+
+本地开发安装（可编辑）：
+
+```bash
+uv pip install -e ".[dev]"
+```
+
+运行单元测试：
+
+```bash
+uv run python -m unittest test/test_all_features.py
+```
+
+运行示例：
+
+```bash
+uv run python examples.py
+```
+
+## 核心设计约束（简要）
+
+- API 函数统一使用 `snake_case`，并通过函数名体现返回类型（如 `*_rsolid`、`*_rwire`）。
+- 核心类型尽量稳定，功能扩展通过新增函数完成（开放封闭原则）。
+- 支持 `SimpleWorkplane` 上下文进行局部坐标建模。
+- 导出接口支持单实体、多实体及嵌套列表输入。
+
+## 文档入口
+
+- API 文档：`docs/api/`
+- Core 文档：`docs/core/`
+
+## License
+
+MIT，见 `LICENSE`。

simplecadapi-2.0.2/README.md

@@ -0,0 +1,218 @@
+# SimpleCADAPI
+
+SimpleCADAPI 是一个基于 CADQuery 的命令式 CAD 建模 Python 包，目标是把常见建模动作封装成清晰、可组合、可测试的函数式 API，并支持通过 Skills 方式分发“文档 + 脚本 + 运行时安装”工作流。
+
+## README 定位
+
+本 README 仅包含包级能力、安装方式、发布/打包流程与 Skills 使用说明。
+实验性脚本和临时建模样例不作为正式文档内容。
+
+## 包安装（Python 包管理器）
+
+当前包名：`simplecadapi`，版本：`2.0.2`（见 `pyproject.toml`）。
+
+### 方式 A：用 pip 从包仓库安装
+
+```bash
+pip install simplecadapi
+```
+
+开发依赖可选安装：
+
+```bash
+pip install "simplecadapi[dev]"
+```
+
+### 方式 B：用 uv 安装
+
+在当前虚拟环境安装：
+
+```bash
+uv pip install simplecadapi
+```
+
+作为项目依赖写入 `pyproject.toml`：
+
+```bash
+uv add simplecadapi
+```
+
+### 方式 C：从本地构建产物安装
+
+仓库内已有示例构建产物（`dist/`）：
+
+```bash
+pip install dist/simplecadapi-2.0.2-py3-none-any.whl
+```
+
+如果你需要重新构建：
+
+```bash
+uv build
+```
+
+## 快速验证安装
+
+```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")
+```
+
+## 如何打包并使用 Skills
+
+本项目提供 `skill-pack` CLI，用于生成轻量技能包（thin mode）：**不内置 SDK 源码**，运行时从包仓库安装 `simplecadapi`。
+
+### 1) 打包命令
+
+在仓库根目录执行：
+
+```bash
+uv run skill-pack --refresh-docs --archive --skill-name simplecad-self-evolve
+```
+
+常用参数：
+
+- `--output-root <dir>`：输出目录（默认 `./skills`）
+- `--package-name <pkg>`：运行时安装包名（默认读取 `project.name`）
+- `--package-version <ver>`：运行时安装版本（默认读取 `project.version`）
+- `--no-clean`：不清理已有输出目录
+- `--archive`：额外生成 `<skill-name>.tar.gz`
+
+### 2) 打包结果结构
+
+打包后将得到类似目录：
+
+- `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 目录中安装并检查运行时
+
+```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) 用包装脚本运行你的程序
+
+```bash
+PYTHON_BIN=.venv/bin/python scripts/with_skill.sh -- .venv/bin/python your_script.py
+```
+
+### 5) 激活 skill-local 案例模块路径
+
+```bash
+eval "$(scripts/with_skill.sh --print-env)"
+```
+
+激活后可直接导入：
+
+```python
+from simplecad_self_evolve_cases.evolve import make_involute_spur_gear_rsolid
+```
+
+### 6) 向 skill 本地 evolve 模块追加新函数
+
+```bash
+scripts/add_new_case.sh path/to/new_case.py
+```
+
+### 7) Jupyter 与结构校验
+
+```bash
+scripts/jupyter_with_skill.sh lab
+scripts/validate_skill.sh
+```
+
+## 自动化工具（Auto Tools）
+
+项目内置 4 个主要 CLI：
+
+- `auto-docs-gen`：从 API 源码生成 `docs/api/` 文档
+- `make-export`：更新 `src/simplecadapi/__init__.py` 的导入导出
+- `evolve`：从脚本提取函数并追加到 evolve 模块
+- `skill-pack`：打包 thin skill（文档 + 脚本 + cases）
+
+示例：
+
+```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 文档同步
+
+`scripts/sync_ragflow_docs.py` 用于把 `docs/` 下的 Markdown 增量同步到指定
+RAGFlow 数据集，并按二级标题（H2）分块；文档的 `chunk_method` 会设置为
+`manual`。
+
+准备环境：
+
+```bash
+.venv/bin/python -m pip install ragflow-sdk
+```
+
+建议使用 `.env`（已加入 `.gitignore`）：
+
+```bash
+RAGFLOW_API_KEY=your_key_here
+RAGFLOW_BASE_URL=http://localhost
+RAGFLOW_DATASET_NAME=SimpleCADAPI
+```
+
+运行同步：
+
+```bash
+set -a && source .env && set +a
+.venv/bin/python scripts/sync_ragflow_docs.py --create-dataset
+```
+
+常用参数：
+
+- `--dataset-id` / `RAGFLOW_DATASET_ID`：直接指定数据集 ID（避免同名冲突）
+- `--delete-removed`：同步删除本地已移除的文档
+- `--dry-run`：只预览变更，不执行写入
+- `--progress-interval N`：每 N 篇打印一次进度
+
+## 开发与测试
+
+本地开发安装（可编辑）：
+
+```bash
+uv pip install -e ".[dev]"
+```
+
+运行单元测试：
+
+```bash
+uv run python -m unittest test/test_all_features.py
+```
+
+运行示例：
+
+```bash
+uv run python examples.py
+```
+
+## 核心设计约束（简要）
+
+- API 函数统一使用 `snake_case`，并通过函数名体现返回类型（如 `*_rsolid`、`*_rwire`）。
+- 核心类型尽量稳定，功能扩展通过新增函数完成（开放封闭原则）。
+- 支持 `SimpleWorkplane` 上下文进行局部坐标建模。
+- 导出接口支持单实体、多实体及嵌套列表输入。
+
+## 文档入口
+
+- API 文档：`docs/api/`
+- Core 文档：`docs/core/`
+
+## License
+
+MIT，见 `LICENSE`。

{simplecadapi-2.0.0/src → simplecadapi-2.0.2}/docs/api/README.md

@@ -1,18 +1,22 @@
-# SimpleCAD API 文档索引
+# SimpleCAD API Index
 
-本文档包含了 SimpleCAD API (来自 `operations.py` 和 `evolve.py`) 的所有函数说明。
+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) *(来自 operations.py)*
 - [make_angle_arc_rwire](make_angle_arc_rwire.md) *(来自 operations.py)*
+- [make_box_rscalarfield](make_box_rscalarfield.md) *(来自 field.py)*
 - [make_box_rsolid](make_box_rsolid.md) *(来自 operations.py)*
+- [make_capsule_rscalarfield](make_capsule_rscalarfield.md) *(来自 field.py)*
 - [make_circle_redge](make_circle_redge.md) *(来自 operations.py)*
 - [make_circle_rface](make_circle_rface.md) *(来自 operations.py)*
 - [make_circle_rwire](make_circle_rwire.md) *(来自 operations.py)*
 - [make_cone_rsolid](make_cone_rsolid.md) *(来自 operations.py)*
 - [make_cylinder_rsolid](make_cylinder_rsolid.md) *(来自 operations.py)*
+- [make_ellipsoid_rscalarfield](make_ellipsoid_rscalarfield.md) *(来自 field.py)*
 - [make_face_from_wire_rface](make_face_from_wire_rface.md) *(来自 operations.py)*
+- [make_field_surface_rsolid](make_field_surface_rsolid.md) *(来自 operations.py)*
 - [make_helix_redge](make_helix_redge.md) *(来自 operations.py)*
 - [make_helix_rwire](make_helix_rwire.md) *(来自 operations.py)*
 - [make_line_redge](make_line_redge.md) *(来自 operations.py)*
@@ -22,6 +26,7 @@
 - [make_rectangle_rwire](make_rectangle_rwire.md) *(来自 operations.py)*
 - [make_segment_redge](make_segment_redge.md) *(来自 operations.py)*
 - [make_segment_rwire](make_segment_rwire.md) *(来自 operations.py)*
+- [make_sphere_rscalarfield](make_sphere_rscalarfield.md) *(来自 field.py)*
 - [make_sphere_rsolid](make_sphere_rsolid.md) *(来自 operations.py)*
 - [make_spline_redge](make_spline_redge.md) *(来自 operations.py)*
 - [make_spline_rwire](make_spline_rwire.md) *(来自 operations.py)*
@@ -29,50 +34,86 @@
 - [make_three_point_arc_rwire](make_three_point_arc_rwire.md) *(来自 operations.py)*
 - [make_wire_from_edges_rwire](make_wire_from_edges_rwire.md) *(来自 operations.py)*
 
-## 变换操作
+## Transforms
 
 - [mirror_shape](mirror_shape.md) *(来自 operations.py)*
+- [rotate_rscalarfield](rotate_rscalarfield.md) *(来自 field.py)*
 - [rotate_shape](rotate_shape.md) *(来自 operations.py)*
+- [translate_rscalarfield](translate_rscalarfield.md) *(来自 field.py)*
 - [translate_shape](translate_shape.md) *(来自 operations.py)*
 
-## 3D操作
+## 3D Operations
 
 - [extrude_rsolid](extrude_rsolid.md) *(来自 operations.py)*
 - [loft_rsolid](loft_rsolid.md) *(来自 operations.py)*
 - [revolve_rsolid](revolve_rsolid.md) *(来自 operations.py)*
 - [sweep_rsolid](sweep_rsolid.md) *(来自 operations.py)*
 
-## 标签和选择
+## Tagging and Selection
 
 - [select_edges_by_tag](select_edges_by_tag.md) *(来自 operations.py)*
 - [select_faces_by_tag](select_faces_by_tag.md) *(来自 operations.py)*
 - [set_tag](set_tag.md) *(来自 operations.py)*
 
-## 布尔运算
+## Boolean Operations
 
 - [cut_rsolidlist](cut_rsolidlist.md) *(来自 operations.py)*
+- [intersect_rscalarfield](intersect_rscalarfield.md) *(来自 field.py)*
 - [intersect_rsolidlist](intersect_rsolidlist.md) *(来自 operations.py)*
+- [union_rscalarfield](union_rscalarfield.md) *(来自 field.py)*
 - [union_rsolidlist](union_rsolidlist.md) *(来自 operations.py)*
 
-## 导出功能
+## Export
 
 - [export_step](export_step.md) *(来自 operations.py)*
 - [export_stl](export_stl.md) *(来自 operations.py)*
 
-## 高级特征
+## Advanced Features
 
 - [chamfer_rsolid](chamfer_rsolid.md) *(来自 operations.py)*
 - [fillet_rsolid](fillet_rsolid.md) *(来自 operations.py)*
 - [helical_sweep_rsolid](helical_sweep_rsolid.md) *(来自 operations.py)*
 - [shell_rsolid](shell_rsolid.md) *(来自 operations.py)*
 
-## 自进化
+## Evolve
 
 - [make_n_hole_flange_rsolid](make_n_hole_flange_rsolid.md) *(来自 evolve.py)*
 - [make_naca_propeller_blade_rsolid](make_naca_propeller_blade_rsolid.md) *(来自 evolve.py)*
 - [make_threaded_rod_rsolid](make_threaded_rod_rsolid.md) *(来自 evolve.py)*
 
-## 其他
-
+## Assembly Constraints
+
+- [add_part_rassembly](add_part_rassembly.md) *(来自 constraints.py)*
+- [clear_constraints_rassembly](clear_constraints_rassembly.md) *(来自 constraints.py)*
+- [clone_assembly_rassembly](clone_assembly_rassembly.md) *(来自 constraints.py)*
+- [constrain_coincident_rassembly](constrain_coincident_rassembly.md) *(来自 constraints.py)*
+- [constrain_concentric_rassembly](constrain_concentric_rassembly.md) *(来自 constraints.py)*
+- [constrain_distance_rassembly](constrain_distance_rassembly.md) *(来自 constraints.py)*
+- [constrain_offset_rassembly](constrain_offset_rassembly.md) *(来自 constraints.py)*
+- [make_assembly_rassembly](make_assembly_rassembly.md) *(来自 constraints.py)*
+- [rotate_part_rassembly](rotate_part_rassembly.md) *(来自 constraints.py)*
+- [solve_assembly_rresult](solve_assembly_rresult.md) *(来自 constraints.py)*
+- [stack](stack.md) *(来自 constraints.py)*
+- [stack_rassembly](stack_rassembly.md) *(来自 constraints.py)*
+- [translate_part_rassembly](translate_part_rassembly.md) *(来自 constraints.py)*
+
+## Other
+
+- [and_](and_.md) *(来自 ql.py)*
+- [bounds_rbbox](bounds_rbbox.md) *(来自 field.py)*
+- [eval_rarray](eval_rarray.md) *(来自 field.py)*
+- [eval_rscalar](eval_rscalar.md) *(来自 field.py)*
+- [geo](geo.md) *(来自 ql.py)*
 - [linear_pattern_rsolidlist](linear_pattern_rsolidlist.md) *(来自 operations.py)*
+- [meta](meta.md) *(来自 ql.py)*
+- [not_](not_.md) *(来自 ql.py)*
+- [or_](or_.md) *(来自 ql.py)*
 - [radial_pattern_rsolidlist](radial_pattern_rsolidlist.md) *(来自 operations.py)*
+- [render_screenshot_rpath](render_screenshot_rpath.md) *(来自 operations.py)*
+- [scale_rscalarfield](scale_rscalarfield.md) *(来自 field.py)*
+- [select](select.md) *(来自 ql.py)*
+- [smooth_subtract_rscalarfield](smooth_subtract_rscalarfield.md) *(来自 field.py)*
+- [smooth_union_rscalarfield](smooth_union_rscalarfield.md) *(来自 field.py)*
+- [subtract_rscalarfield](subtract_rscalarfield.md) *(来自 field.py)*
+- [tag](tag.md) *(来自 ql.py)*
+- [value](value.md) *(来自 ql.py)*

simplecadapi-2.0.2/docs/api/add_part_rassembly.md

@@ -0,0 +1,13 @@
+# add_part_rassembly
+
+## API Definition
+
+```python
+def add_part_rassembly(assembly: Assembly, name: str, solid: Solid, parent: Optional[Union[str, PartHandle]] = None, local_transform: Optional[Union[np.ndarray, Sequence[Sequence[float]]]] = None) -> Assembly
+```
+
+*Source: constraints.py*
+
+## Description
+
+Type-2映射：在装配空间中新增零件并返回新装配对象。

simplecadapi-2.0.2/docs/api/and_.md

@@ -0,0 +1,25 @@
+# and_
+
+## API Definition
+
+```python
+def and_(*predicates: Predicate) -> Predicate
+```
+
+*Source: ql.py*
+
+## Description
+
+构造 AND 组合谓词。
+
+Q.and_(Q.tag("face.top"), Q.tag("role.mounting_surface"))
+
+## Parameters
+
+### *predicates
+
+- **Description**: 任意数量谓词。
+
+## Returns
+
+Callable[[Any], bool]: 组合谓词。