swforge 0.9.1__tar.gz

swforge-0.9.1/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# SolidWorks 产物（不提交二进制）
+*.SLDPRT
+*.SLDASM
+*.SLDDRW
+*.sldmat
+!examples/*.sldmat
+*.step
+*.x_t
+*.igs
+*.stl
+*.buildlog.txt
+*.operations.jsonl
+*.verification.json
+
+# 运行日志与临时
+_tmp/
+*.log
+out/
+
+# 编辑器
+.vscode/
+.idea/
+*.swp
+
+# OS
+Thumbs.db
+desktop.ini
+# 演示产物
+demo/out/
+
+demo/batch_parts/
+

swforge-0.9.1/CHANGELOG.en.md

@@ -0,0 +1,169 @@
+[中文](CHANGELOG.md) | **English**
+
+# Changelog
+
+This project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.9.1] - 2026-11-03
+
+First release published to PyPI. All fixes relative to v0.9.0, no new features.
+
+### Added
+- **PyPI publishing** `.github/workflows/publish.yml`: tag to publish, using
+  Trusted Publishing (OIDC) so no token is stored in the repository. Three
+  pre-publish checks: exactly one wheel, package version matches the tag, and
+  the sdist carries docs/.
+- **MCP server usability for external agents**: 17 lines of `instructions`
+  (the first thing an agent reads), a fix so `serverInfo.version` reports
+  swforge's version instead of the MCP SDK's, and multi-client setup in the
+  README.
+- `tests/test_mcp.py`, six contract tests driving a real stdio session.
+
+### Fixed
+- `swforge --help` crashed on a non-Chinese Windows: with a cp1252 stdout,
+  printing Chinese raised `UnicodeEncodeError`. Now `errors='replace'` keeps it
+  from crashing, and JSON output escapes to `\uXXXX` on a single-byte codec so
+  it stays machine-readable.
+- `produce()` connected to SolidWorks even for a fresh drawing (regression
+  introduced in v0.9.0), dragging pure-logic unit tests into a real connection.
+  It now connects only when the target file already exists.
+- CI: `package build` failed because PowerShell does not expand `dist/*.whl`;
+  switched to bash and to `python -m swforge.cli`.
+- CI: the marker check moved from a static text scan to a runtime guard in
+  conftest. The static version produced four false positives on tests that only
+  exercise parameter validation.
+
+## [0.9.0] - 2026-11-03
+
+### Added
+- **Batch drawings** `swforge batch`: one folder of parts becomes a stack of GB-framed
+  drawings. Measured 5 parts in 15.7 s; one failure does not sink the batch; existing
+  drawings are skipped so an interrupted run resumes.
+- **API capability probe** `swforge capabilities --api`: reflects over the locally
+  installed Interop library and reports, for 28 risky APIs, whether each exists and its
+  highest overload. Measured 0.43 s with a clear verdict. A wrong declared type triggers
+  a global scan that reports the real location (`InsertModelAnnotations4` lives on
+  `IDrawingDoc`).
+- **Overall dimensions now work on revolved parts**: fall back from vertices to edge
+  endpoints, then to single-entity dimensions, so cylinders and rings get outer and
+  inner diameters (measured flange 120/60, bushing 40/24).
+- **CI**: `.github/workflows/tests.yml`, Python 3.10-3.13 matrix running the 106 offline
+  tests, plus package build, sdist content check and an `sw` marker guard.
+- Tests 124 -> **138** (106 offline + 32 live).
+
+### Fixed
+- `produce()` returned `err=1` when the target drawing already existed, because the
+  previous drawing was still open and locked the file. It now closes any document
+  pointing at the target path first.
+- `add_dimensions(overall=True)` referenced an undefined `overall_result` (NameError).
+- sdist did not carry `docs/` or `demo/`; `MANIFEST.in` added, 65 files now.
+- Batch failed from the 5th part on after hitting SolidWorks' 8-document cap; documents
+  are now released after each part.
+
+### Docs
+- README gained a "Not yet" section and a three-layer "Verification boundary" table
+  (L1 offline / L2 CI / L3 live).
+- Chinese and English READMEs kept in sync.
+
+## [0.8.0] - 2026-11-03
+
+### Added
+- **Overall dimensions** `dims.py`: explicit overall length/height generated from each
+  view's extreme visible vertices (`InsertModelAnnotations4` cannot produce overall
+  dimensions and deduplicates across views)
+- **Mates** `mates.py`: concentric / coincident with automatic face selection
+  (equal-radius cylinders, parallel planes), implemented in C# early binding
+- **Exact interference** `interference.py`: body boolean intersection, measured 500.000 mm³
+- Tests 111 → **124**
+
+### Fixed
+- Interference intersection returning error code 1: `swBodyOperationNonApiBody` —
+  document bodies are not API temporary bodies and need `Copy2(False)` first
+- Mate success criterion: `swAddMateError_NoError = 1` (not 0)
+- Assembly coordinate units: `AddComponent5` expects metres; millimetres were being
+  passed, placing parts 60 metres away
+- Drawing template selection: now scans by year and prefers Chinese `gb_<paper>.drwdot`
+- `_ensure_mm_units` could not read the unit value (`_value()` calling a method that
+  requires arguments)
+
+## [0.7.0] - 2026-11-03
+
+### Added
+- GB frame and title block (auto-filled material / weight / scale)
+- Millimetre unit verification
+
+### Changed
+- `_default_template()` prefers Chinese GB templates (previously preferred the English
+  template, which produced inches and no frame)
+- `add_dimensions(..., relayout=True)`: automatically re-lays out views after annotation
+
+### Known issues
+- Interference intersection returned `(None, 1)`, unresolved
+- Mates not implemented
+
+## [0.6.0] - 2026-11-02
+
+### Added
+- `revolve()` on all three axes (volume error 0.00% on all three)
+- Automatic annotation `add_dimensions()` / `count_dimensions()`
+- Assembly `AssemblyBuilder` (insert + fix)
+
+### Fixed
+- `_view_list()` used `GetViews`, which returns a native PyIDispatch; the exception was
+  silently swallowed by `except: continue`, so counting always returned 0 views
+
+### Discovered
+- `AddComponent5` requires the part to be **opened first**, otherwise it silently returns None
+
+## [0.5.0] - 2026-11-02
+
+### Added
+- Two-level connection fallback (`GetActiveObject` → `CreateInstance`) with actionable errors
+- GB material library `gb_materials.py`: 20 grades, auto-deployed into SolidWorks' scan path
+- Honesty regression tests (4)
+
+### Fixed
+- **Physical material was never assigned to SolidWorks**, so the default density was
+  1000 kg/m³ (water) — mass was wrong by 7.85×
+
+## [0.4.1] - 2026-11-02
+
+### Added
+- Three-tier resource guard (ok / warn / critical) plus safe sweeping `sweep_documents()`
+
+### Fixed
+- `conftest.py` cleaned the project root but missed pytest's temp dir, so the live suite
+  locked itself out at the 8th document
+- `max_documents=0` was rejected as an invalid parameter
+
+## [0.4.0] - 2026-11-01
+
+### Added
+- Document cap and automatic release in batch runs
+- Straight-edge selection rule `edges_rule` plus read-only preview `preview_edges`
+- PDF content verification (PDFium parse + render)
+
+## [0.3.0] - 2026-11-01
+
+### Added
+- Three-axis cylinders, revolve about Y, all-edge fillet and chamfer
+- Single-STA serialization (MCP concurrency safety)
+
+### Fixed
+- World coordinates no longer mirror Z; `merge` actually takes effect; body count is read
+  back from SolidWorks instead of counting successful features
+
+## [0.2.0] - 2026-11-01
+
+### Added
+- Colour coverage 57% → **100%** (face-level write + readback)
+- View layout solver (measured sizes + long-align / height-align / auto scale)
+- MCP server (15 tools)
+- 5 integration tests
+
+### Fixed
+- `swAllBodies = -1` (was mistakenly 2), so `purge_*` had been iterating 0 bodies
+
+## [0.1.0] - 2026-11-01
+
+First usable version: DSL → C# modeling, coloring, import cleanup, PDF atlas, CLI.

swforge-0.9.1/CHANGELOG.md

@@ -0,0 +1,148 @@
+**中文** | [English](CHANGELOG.en.md)
+
+# Changelog
+
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.9.1] - 2026-11-03
+
+首个发布到 PyPI 的版本。相比 v0.9.0 全是修复，没有新功能。
+
+### 新增
+- **PyPI 发布流程** `.github/workflows/publish.yml`：打标签即发布，
+  用 Trusted Publishing（OIDC），仓库里不存任何 token。
+  发布前做三项校验：wheel 数量、包版本与标签一致、sdist 含 docs/。
+- **MCP 服务器对外可用性**：补 17 行 `instructions`（Agent 读到的第一段话），
+  修正 `serverInfo.version` 报成 SDK 版本的问题，README 补多客户端配置。
+- `tests/test_mcp.py` 6 条契约测试，走真实 stdio 协议。
+
+### 修复
+- `swforge --help` 在非中文 Windows 上崩溃：stdout 编码为 cp1252 时
+  打印中文抛 `UnicodeEncodeError`。现在用 `errors='replace'` 兜底，
+  且 JSON 输出在单字节编码下自动转义成 `\uXXXX`，保证机器可读。
+- `produce()` 在全新出图时也白连一次 SolidWorks（v0.9.0 引入的回归），
+  导致纯逻辑单测被拖进真实连接。改成只有旧文件存在时才连。
+- CI：`package build` 因 PowerShell 不展开 `dist/*.whl` 通配符而失败；
+  改成 bash 并统一用 `python -m swforge.cli`。
+- CI：marker 检查从静态文本扫描改为 conftest 运行时守卫。
+  静态版误报了 4 个「只测参数校验」的合法用例。
+
+## [0.9.0] - 2026-11-03
+
+### 新增
+- **批量出图** `swforge batch`：一个文件夹的零件 → 一批带 GB 图框的工程图。
+  实测 5 件 15.7 秒；单件失败不影响整批；默认跳过已存在的图，断了能续跑。
+- **API 能力探测** `swforge capabilities --api`：用反射查本机 Interop 库，
+  逐个确认 28 个风险 API 存在性与最高重载参数个数，实测 0.43 秒给出明确结论。
+  类型写错会自动全局扫描纠正（`InsertModelAnnotations4` 实际在 `IDrawingDoc` 上）。
+- **总尺寸支持回转体**：没有可见顶点时退回「边端点」→ 再退回「单实体标注」，
+  圆柱/圆环现在能拿到外径和内径（实测法兰 120/60、轴套 40/24）。
+- **CI**：`.github/workflows/tests.yml`，Python 3.10~3.13 矩阵跑 106 项离线测试，
+  外加打包构建、sdist 内容检查、`sw` marker 守卫。
+- 测试 124 → **138 项**（106 离线 + 32 实机）。
+
+### 修复
+- `produce()` 在目标图已存在时返回 `err=1`：上一张图还开着锁住文件。
+  现在出图前先关掉指向同一路径的已打开文档。
+- `add_dimensions(overall=True)` 引用未定义的 `overall_result`（NameError）。
+- sdist 不含 `docs/` 和 `demo/`：加 `MANIFEST.in`，现在 65 个文件。
+- 批量出图第 5 件撞 SolidWorks 8 文档上限后整批失败：每件结束显式释放文档。
+
+### 文档
+- README 增加「尚未做到」小节和「验证边界」三层表（L1 离线 / L2 CI / L3 实机）
+- 中英文 README 同步更新
+
+## [0.8.0] - 2026-11-03
+
+### 新增
+- **总尺寸标注** `dims.py`：按视图可见顶点极值显式生成总长/总高
+  （`InsertModelAnnotations4` 拿不到总尺寸，且会跨视图去重）
+- **配合** `mates.py`：同心 / 重合，自动选面（等径圆柱、平行平面），C# 早期绑定实现
+- **精确干涉** `interference.py`：实体布尔求交，实测 500.000 mm³
+- 测试 111 → **124 项**
+
+### 修复
+- 干涉求交返回错误码 1：`swBodyOperationNonApiBody` —— 文档体不是 API 临时体，
+  需先 `Copy2(False)`
+- 配合判据：`swAddMateError_NoError = 1`（不是 0）
+- 装配坐标单位：`AddComponent5` 内部要米，此前把毫米当米传，零件被放到 60 米外
+- 工程图模板选型：改为按年份扫描 + 中文 `gb_<纸张>.drwdot` 优先
+- `_ensure_mm_units` 读不到单位值（`_value()` 无参调用带参方法）
+
+## [0.7.0] - 2026-11-03
+
+### 新增
+- GB 图框与标题栏（自动带材料 / 重量 / 比例）
+- 毫米单位校验
+
+### 变更
+- `_default_template()` 优先中文 GB 模板（此前优先英文模板导致英寸 + 无图框）
+- `add_dimensions(..., relayout=True)`：标注后自动重排
+
+### 已知问题
+- 干涉求交返回 `(None, 1)`，未解决
+- 配合未实现
+
+## [0.6.0] - 2026-11-02
+
+### 新增
+- `revolve()` 支持 x/y/z 三轴（三轴体积误差 0.00%）
+- 自动标注 `add_dimensions()` / `count_dimensions()`
+- 装配 `AssemblyBuilder`（插入 + 固定）
+
+### 修复
+- `_view_list()` 用 `GetViews` 拿原生 PyIDispatch 被 `except: continue` 静默吞掉，
+  导致统计永远返回 0 视图
+
+### 发现
+- `AddComponent5` 要求零件**先打开**，否则静默返回 None
+
+## [0.5.0] - 2026-11-02
+
+### 新增
+- 连接两级 fallback（`GetActiveObject` → `CreateInstance`）+ 可操作错误提示
+- GB 材质库 `gb_materials.py`：20 个牌号 + 自动部署到 SW 扫描目录
+- 诚实性回归测试（4 项）
+
+### 修复
+- **物理材料从未赋给 SW**，默认密度 1000 kg/m³（水），质量错 7.85 倍
+
+## [0.4.1] - 2026-11-02
+
+### 新增
+- 资源守卫三档分级（ok / warn / critical）+ 安全清扫 `sweep_documents()`
+
+### 修复
+- `conftest.py` 清理根目录漏了 pytest 临时目录，导致实测套件跑到第 8 个文档自锁
+- `max_documents=0` 被判为参数非法
+
+## [0.4.0] - 2026-11-01
+
+### 新增
+- 文档数量上限与批处理自动释放
+- 直边选边规则 `edges_rule` + 只读预览 `preview_edges`
+- PDF 内容验证（PDFium 解析 + 渲染）
+
+## [0.3.0] - 2026-11-01
+
+### 新增
+- 三轴圆柱、绕 Y 轴旋转、全边圆角与倒角
+- 单 STA 线程串行化（MCP 并发安全）
+
+### 修复
+- 世界坐标不再镜像 Z；`merge` 真正生效；实体数改为从 SW 回读
+
+## [0.2.0] - 2026-11-01
+
+### 新增
+- 配色覆盖率 57% → **100%**（面级写入 + 回读）
+- 视图排版求解器（实测尺寸 + 长对正 / 高平齐 / 自动缩放）
+- MCP 服务器（15 工具）
+- 集成测试 5 项
+
+### 修复
+- `swAllBodies = -1`（原误写成 2），`purge_*` 一直遍历 0 个实体
+
+## [0.1.0] - 2026-11-01
+
+首个可用版本：DSL → C# 建模、分色、导入清理、PDF 图集、CLI。

swforge-0.9.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-sw-toolkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

swforge-0.9.1/MANIFEST.in

@@ -0,0 +1,13 @@
+include LICENSE
+include README.md
+include README.en.md
+include CHANGELOG.md
+include CHANGELOG.en.md
+include .gitignore
+recursive-include docs *.md
+recursive-include demo *.py
+recursive-include examples *.py *.json
+recursive-include tests *.py
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.SLDPRT *.SLDDRW *.SLDASM *.pdf