DetWeave v0.3.0 — Conversation-driven geometry / 对话式几何设计

DetWeave v0.3.0 — Conversation-driven geometry / 对话式几何设计

DetWeave v0.3.0 adds continuous conversation, persistent geometry revisions and remembered model settings. English and Chinese interfaces and README demonstrations are included. This is a public preview; signing and platform-validation limits are listed below.

v0.3.0 新增持续对话、几何版本与模型配置记忆，包含中英文界面和更新后的真实操作演示。这是公开测试发行版，签名与平台验证范围见下文。

Downloads / 下载

File	Use and limits / 用途与限制
DetWeave-0.3.0-macOS-universal-adhoc.dmg	macOS application; ad-hoc signed, not Developer ID signed/notarized. / macOS 应用，临时签名，未公证
DetWeave-0.3.0-Windows-x64-unsigned.msi	Windows x64 installer; publisher unsigned. / Windows x64 安装包，无发布者签名
DetWeave-0.3.0-Ubuntu-24.04-amd64.deb	Ubuntu 24.04 amd64; install with sudo apt install ./DetWeave-0.3.0-Ubuntu-24.04-amd64.deb. / 由 apt 安装并处理运行库依赖
DetWeave-0.3.0-Android-debug.apk	Debug-signed Android test APK; build-verified, no physical-phone validation. / 安卓调试签名测试包，尚未真机验证
DetWeave-0.3.0-iOS-simulator.zip	arm64 iOS simulator app for Apple Silicon Macs; not an iPhone IPA. / Apple Silicon Mac 使用的模拟器应用，不是 iPhone 安装包
DetWeave-0.3.0-iOS-Xcode-project.zip	Generated Xcode project and dependencies; physical iPhone use requires your own signing/provisioning. / 可重建工程，真机使用需 Apple 签名配置
detweave-0.3.0-py3-none-any.whl, detweave-0.3.0.tar.gz	Python 3.10+ distribution. / Python 安装包和源码包
BUILD-MANIFEST.json, SHA256SUMS.txt	Actual artifact provenance, tested scope and checksums. / 实际产物来源、验证范围及校验和

Workflow / 使用方式

Create a named project and explicitly choose a storage location. Paste the first discussion, then continue with questions or changes in the left chat. Clarification and answer-only turns keep the current geometry. Changes create revisions with parent links and deterministic parameter differences. Restore a previous version to branch from it; stale confirmations are rejected instead of silently confirming changed values.

新建项目并明确选择保存位置，在左侧粘贴初始讨论，随后持续提问或修改。澄清和普通回答保留当前几何；修改产生记录父版本和参数差异的新版本。可恢复旧版继续设计；过期确认会被拒绝，避免确认了不同于原先看到的数值。

The right panel shows SVG/3D, geometry data and export tools. PDF design-report generation is deferred. Raw Thinking is hidden; concise status, elapsed time and cancellation remain. API settings auto-save per provider in a separate local user file. Storage is permission-protected plaintext, not keychain encryption. Keys and raw reasoning are excluded from project records/exports.

右侧显示 SVG／3D、几何数据和导出工具，PDF 设计报告暂未实现。主界面隐藏原始 Thinking，保留状态、耗时和停止。API 配置按服务商单独自动保存到本机用户文件；当前为权限保护的明文存储，不是钥匙串加密。Key 和原始思考不进入项目记录或导出。

Developer web environment / 网页开发环境

No native build is needed for development. Install the Python project and run:

python -m detweave serve --dev-ui --open --port 0

Follow the English README or 中文 README for full Windows/macOS/Linux setup. This serves one HTML document from a local Python backend; Python calls providers directly. It is not the withdrawn independent file:// HTML/WASM download, and no hosted relay is required.

开发无需编译安装包。按 README 安装 Python 项目后运行上述命令，通过本机网页调试；本机 Python 直接连接服务商，不需要在线转发服务。独立 file:// HTML/WASM 下载不恢复。

Validation / 验证

• 129 Python tests and browser conversation/settings regression passed. Review corrections include protocol null handling, explicit completion markers, sub-tolerance geometry limits, draft/revision synchronization, secret-echo checks and stale-confirmation protection.
• Live Volcengine ark-code-latest synthetic test: create a 5 mm silicon box, change only thickness to 8 mm, ask its current thickness without a new revision. All three turns passed; provider returned model ID auto, so the underlying routed model is unspecified.
• Fresh Geant4 11.1.3 GDML/C++ builds and runtime checks passed for sampling, beamline, nested and thin-world examples, including overlap rejection, navigation, geantino smoke and material lookup outside the build directory. These are geometry tests, not detector-response physics validation.
• DD4hep 1.28 generated plugin C++ compiled and linked. Full build/runtime validation remains blocked by a missing Boost library in the local installation; no runtime-success claim is made.
• Fixed Linux native bridge injection: ASCII Unicode escapes preserve Chinese alerts while avoiding Toga GTK's character-count/UTF-8-byte-count truncation. A behavioral regression verifies save and folder callbacks.
• Native validation requires the rendered chat/project controls and initialized settings, in addition to backend workflow checks. iOS checks wait for actual DOM readiness rather than a fixed screenshot delay. Platform-native results and build commits are recorded in BUILD-MANIFEST.json. Android is build-verified only; iOS device signing and physical-device testing are not included.

129 项 Python 测试及浏览器回归通过，火山三轮真实合成几何对话通过。Geant4 样例完成重新编译与运行检查；DD4hep 插件编译链接通过，但完整运行验证受本机依赖缺失阻挡。原生验收同时检查聊天与项目控件已显示、配置初始化完成，不再仅检查后端接口；iOS 截图等待页面实际就绪。各平台具体实测结果以构建清单为准，安卓与手机真机验证边界明确保留。

The original Argon fixed-mode suite gives 24 passes and one documented expectation disagreement: it expects an old revision ID to confirm newly edited geometry. DetWeave deliberately rejects that request; independent Python/browser tests verify edited values survive and confirmation works with the new revision. See the review response.

原 Argon 验收套件为 24 项通过、1 项预期分歧：旧版本号不能用于确认已经修改的新几何。独立回归测试已验证修改值不会丢失，新版本可以正确确认。

Attribution / 署名与许可

李衡讷 / Hengne Li — 华南师范大学 / South China Normal University
Hengne.Li@m.scnu.edu.cn · Hengne.Li@cern.ch

Noncommercial use only, with attribution and citation required. Commercial use requires separate written permission. Earlier MIT snapshots and third-party components retain their original licenses. See LICENSE and CITATION.cff.

仅允许非商业使用，须署名和引用；商业用途须作者另行书面授权。历史 MIT 快照和第三方组件保留原许可。

DetWeave v0.2.0 — First public preview / 首个公开测试版

2026-11-09: The standalone HTML application has been withdrawn from public distribution. Direct browser access to Volcengine Coding Plan is blocked by the provider’s CORS configuration, so it does not meet the intended download-and-use workflow. Use a native application from Releases. Experimental source is retained; exported geometry HTML previews remain available.

2026-11-09：单文件 HTML 应用已撤下，不再作为正式下载方式。 火山 Coding Plan 的跨域配置阻止浏览器直接调用，无法满足下载即用的核心流程。请使用发行页中的原生应用。实验源码保留，几何模型导出的 HTML 查看器仍可使用。

DetWeave v0.2.0 is the first public preview release of the conversation-driven detector geometry workbench. The application and documentation include English and Chinese.

DetWeave v0.2.0 是首个公开测试发行版，包含中文和英文界面与说明。将讨论记录转为可追溯的几何草稿，核对后导出 Geant4 C++、GDML、DD4hep 工程。

Downloads / 下载选择

Download	Use / 用途
DetWeave-0.2.0-macOS-universal-adhoc.dmg	macOS application, arm64 + x86_64. Ad-hoc signed; no Developer ID or notarization. / 通用架构应用，未公证
DetWeave-0.2.0-Windows-x64-unsigned.msi	Windows x64 installer; unsigned. / Windows 安装包，未进行发布者签名
DetWeave-0.2.0-Ubuntu-24.04-amd64.deb	Ubuntu 24.04 amd64 package. Install with sudo apt install ./DetWeave-0.2.0-Ubuntu-24.04-amd64.deb; apt resolves system runtime dependencies. / Ubuntu 安装包，由 apt 处理运行库依赖
DetWeave-0.2.0-Android-debug.apk	Installable, debug-signed Android testing build. Device installation, document-picker behavior and upgrades need device-specific testing. / 安卓调试签名安装包，尚未完成真机验证
DetWeave-0.2.0-iOS-simulator.zip	Compiled arm64 simulator app for Apple Silicon Macs; installed and launched in CI. Not an iPhone IPA. / Apple Silicon Mac 使用的 arm64 iOS 模拟器应用，已安装启动验证，不是 iPhone 安装包
DetWeave-0.2.0-iOS-Xcode-project.zip	Generated Xcode project with Python dependencies for rebuilding; physical iPhone installation requires the user's Apple signing identity/provisioning. / 可重建的 Xcode 工程，真机安装需 Apple 签名配置
detweave-0.2.0-py3-none-any.whl / .tar.gz	Python distribution, Python 3.10+. / Python 安装包与源码包
SHA256SUMS.txt, BUILD-MANIFEST.json	Download integrity and build/validation provenance. / 文件校验和与构建验证记录

New projects and storage / 新建项目与保存位置

Choose New project, enter a title and explicitly select a storage location. Each named project retains discussion versions, extraction outcomes, accepted models, validation reports and geometry exports. Failed and cancelled submissions also stay in history. API keys and provider reasoning text are not saved in project records.

选择新建项目、填写标题并选择保存位置。项目保留每次保存或提交的讨论版本、运行结果、模型、校验报告及导出文件，失败或取消的提交也保留；不保存 API Key 和模型思考原文。

• Desktop native/Python editions: a system folder picker or an explicitly entered parent directory creates a named subfolder. / 桌面端可选择系统目录，再创建标题对应的子文件夹。
• iOS: project documents are stored inside the app's Documents area, exposed through Files sharing. / iOS 项目在应用 Documents 区域，可通过“文件”访问。
• Android: project history stays in app-private storage; exported files use the system document picker. Arbitrary external project folders are not supported in this preview. Export important data before uninstalling. / 安卓项目历史保存在应用私有目录，导出使用系统文件选择器；本版暂不支持任意外部项目目录。

Features and validation / 功能与验证

• Provider catalogue: Volcengine, DeepSeek, Kimi Code, GLM, Alibaba Token Plan, Tencent general and Hunyuan plans, OpenAI, Anthropic and Gemini. Users supply their own keys; no keys are bundled. / 多家 API 与订阅预设，用户自行填写密钥。
• Run progress shows actual provider-exposed thinking, output fragments, timers and connection activity; cancellation and incomplete-response rejection preserve the previously accepted model. / 展示服务商公开的思考与输出片段，支持取消，拒绝截断输出。
• Boxes and full z-axis tubes, translations, repeated placements, nesting, source evidence, clarification and deterministic exports. Unsupported geometry is flagged. / 支持盒体、完整 z 轴管体、平移、重复、嵌套和来源核对。
• 83 Python tests passed. Offline HTML tests cover reload persistence, real browser filesystem handles, storage failure rollback, revoked permissions, external-file conflicts and second-tab exclusion. Synthetic streaming tests cover thinking display, cancellation and incomplete streams. / 83 项 Python 测试通过，并验证单文件离线与存储、模拟流式接口。
• Platform build and runtime details are recorded in BUILD-MANIFEST.json. Android is build-verified only; no physical-phone test is claimed. / 各平台构建与运行范围见构建清单，安卓只完成构建验证。

The workbench does not bundle Geant4 or DD4hep. Compile and check generated simulation projects in the intended environment; successful application packaging is not detector-physics validation.

工作台不包含 Geant4/DD4hep 运行时，生成的仿真代码应在目标环境编译检查。

Attribution and license / 署名与许可

Hengne Li / 李衡讷 — South China Normal University / 华南师范大学
Hengne.Li@m.scnu.edu.cn · Hengne.Li@cern.ch

DetWeave 0.2.0 is source-available for noncommercial use, with attribution and citation required. Commercial use requires the author's separate written authorization. Earlier MIT snapshots retain their original license. Third-party components retain their own licenses.

本版本仅允许非商业使用，须保留作者署名并在公开使用成果中引用；商业用途须作者另行书面授权。历史 MIT 版本及第三方组件保留原许可。

See License, Citation, English demonstration, and 中文演示.