CONTAM Studio是一个面向教学与科研的现代化、本地优先、联网增强、中英文双语CONTAM桌面工作台，使人和AI能够通过同一套安全、结构化、可审查的接口使用官方ContamX。
- 建筑环境、暖通、通风和室内空气品质相关专业的学生。
- 使用CONTAM开展教学的教师。
- 使用CONTAM开展科研的研究人员和研究生。
项目当前不面向大众消费者、复杂企业平台或大型设计院完整工作流。
- 保留官方ContamX作为数值求解内核，不重写CONTAM求解算法。
- 提供现代、双语且本地优先、联网增强的教学与科研工作流。
- 让GUI和AI共用语义化领域接口，所有修改均可审查、验证和追溯。
- 将原始PRJ、项目快照和运行结果置于明确的数据安全边界内。
0.3.0桌面主线已经形成可用纵向闭环：打开受支持PRJ，浏览Project/Level/Zone/FlowPath/Species语义树，在不可变草稿中审阅和应用受支持的Zone名称、体积及FlowPath multiplier事务，运行随包官方ContamX/SimRead，执行单参数或多参数研究，分页和筛选可信结果，查看参数关系图与时间序列，并导出HTML、PDF、CSV和JSON报告。未知或不能可靠回写的内容保持只读，原始PRJ不由GUI或AI直接覆盖。
AI助手支持 Codex/ChatGPT 登录，以及用户主动配置的 OpenAI、Anthropic、Gemini、OpenRouter、DeepSeek 和本地 OpenAI-compatible Provider。它复用可信上下文预览、附件证据披露、结构化仿真方案、哈希绑定批准和研究结果解释边界；API Key 只进入 Windows Credential Manager。所有写入均通过GUI共用的领域Patch、Diff、确定性验证和用户确认；未连接AI时，项目、草稿、运行、研究和报告仍可离线使用。图片当前只进入本地预览和受控元数据证据，不宣称已向远程模型发送像素。
Windows x64提供便携版、NSIS安装器和MSI安装器。0.3.0 将冻结 Python Worker 和经NIST官方哈希锁定的 ContamX 工具随应用分发，普通用户不需要源码仓库、项目 .venv、系统 Python 或手动选择工具路径。范围及限制见发布说明和已知限制，产品事实以能力状态矩阵为准。
CONTAM Studio自身源码采用Apache License 2.0。官方CONTAM、ContamX、SimRead、Codex及其他第三方组件不因本仓库许可证而改变其各自许可；本项目不是NIST或OpenAI官方产品，详见第三方声明。
桌面入口在React代码加载前先显示轻量双语启动表面，不再用无说明的黑色窗口承接开发冷启动；较大的ECharts结果图表只在真实结果图表需要时加载。该启动表面不探测账号、不连接Codex，也不发送项目上下文。
普通用户应从GitHub Releases下载，不要从仓库源码页寻找EXE。每个版本提供便携版、NSIS安装器、MSI安装器和SHA-256清单。
0.3.0没有后台自动更新。更新时退出Studio，从GitHub Releases下载更高版本并覆盖安装；便携版必须完整解压，不能只复制主 EXE。用户项目、已保存研究、报告和系统凭据不属于发布资产。详细说明见下载与更新。
0.3.0采用React+TypeScript前端、Tauri 2桌面宿主、随包冻结的Python CONTAM领域核心和NIST官方ContamX/SimRead，Windows 10/11 x64为正式目标平台。Rust拥有桌面权限、活动项目、草稿、运行、结果、附件、AI批准、受控网络、凭据引用、进程树和发布配置边界；Python承担严格文档解析、语义Patch、官方工具编排和结果/报告领域逻辑；React只使用路径受控的语义桌面API。
React GUI
↓
Tauri桌面宿主
├─受控stdio JSON-RPC→本地Codex App Server→ChatGPT订阅
├─受控HTTPS/回环HTTP→用户配置的AI Provider
↓ Windows Job Object拥有的stdio
↓
随包冻结的Python CONTAM领域Worker
↓
官方ContamX
历史阶段证据仍保留在docs/development/，但阶段名不再代表当前产品范围。0.3.0的发布事实来源是能力矩阵、发布说明、已知限制、发布包清单和对应任务记录。
需预先安装Node.js、pnpm、Python 3.12、Rust MSVC工具链和Visual Studio C++桌面开发组件。项目使用自己的python/.venv，不依赖PATH中的任意Python。
py -3.12 -m venv python\.venv
python\.venv\Scripts\python.exe -m pip install -e ".\python[dev]"
pnpm install
pnpm tauri dev仅构建前端可运行pnpm build，前端单元测试运行pnpm test。开发环境可通过CONTAM_STUDIO_PYTHON显式指定一个绝对Python解释器路径；debug 构建未配置时只检查仓库内python\.venv\Scripts\python.exe，不会回退到系统PATH。Release 构建只使用主程序旁的冻结 Worker。
QA-01工具链基线和统一验证入口见工具链基线。依赖已安装后，可从仓库根目录运行powershell -NoProfile -File scripts\verify.ps1 -Mode Full；脚本不会自动安装工具或读取未跟踪用户文件。
Phase 3B的桌面审阅流程和验证状态见开发与验证记录。
完成python/依赖安装后，可对仓库内的官方测试样例执行纯文档读取：
python\.venv\Scripts\python.exe -m contam_studio_core.prj_zone_reader `
fixtures\contam\official-contamxpy\test_GetPrjInfo.prj --json该入口固定使用strict_contam_3_4_simple_zone_v1，只支持文件头ContamW 3.4.0.0和ContamW 3.4.0.4下经验证的19字段简单Zone记录。它不调用contamxpy、ContamX或仿真初始化，不创建结果文件；遇到未知版本、复杂条件字段、非ASCII或未验证布局时整体拒绝。Phase 2C桌面桥复用同一个读取入口，不另建Zone字段解释。详见兼容范围。
计划一个尚未应用的Patch：
python\.venv\Scripts\python.exe -m contam_studio_core.zone_volume_patch plan `
fixtures\contam\official-contamxpy\test_GetPrjInfo.prj `
--zone-number 1 --new-volume 650.0 --json将同一修改应用到调用者指定、尚不存在的新副本：
python\.venv\Scripts\python.exe -m contam_studio_core.zone_volume_patch apply `
fixtures\contam\official-contamxpy\test_GetPrjInfo.prj `
--zone-number 1 --new-volume 650.0 `
--output F:\Codex_File\CONTAM-Studio\phase-3a-zone-volume-patch\new-copy.prj --json该入口只支持volume_m3，不会覆盖源文件或既有输出。应用时会重新验证Patch前置条件，并在落盘后证明输出严格等于单个Vol记号替换、严格读取器可重读且其他已解析Zone字段不变。--diff只显示目标Zone单行预览。详见Zone体积副本Patch架构。
完成python/依赖安装后，可对仓库内的官方测试样例执行隔离Zone检查：
python\.venv\Scripts\python.exe -m contam_studio_core.inspect_prj `
fixtures\contam\official-contamxpy\test_GetPrjInfo.prj --json该命令没有接入桌面界面。它保证源PRJ哈希不变，但检查过程并非无副作用加载：contamxpy会执行稳态初始化并产生结果文件，所有生成物仅存在于已验证哈希的临时副本目录并在完成后清理。
本项目不是新的CONTAM求解器、ContamW换皮、只有聊天框的AI包装、通用BIM平台或多求解器仿真平台。当前不建设完整CAD/三维建模、其他求解器集成、插件市场、云同步、账户与多人协作、企业权限体系，也不承诺macOS或Linux正式发行。
- 2026-07-22全项目审计
- 下一阶段执行任务书
- 能力状态矩阵
- 当前状态
- 下载与更新
- 维护与发布
- 学习入口
- 产品愿景
- v0.1产品契约
- 范围与非目标
- 用户与使用场景
- 架构概览
- PRJ简单Zone只读兼容范围
- Tauri-Python Zone桥
- Zone体积副本Patch
- 不可变项目草稿Revision
- Codex只读助手与上下文披露
- Phase 6A验证记录
- Phase 3C自动与非GUI验证
- ContamX运行工作区
- Phase 4B-1受控桌面运行
- Phase 4B-1自动验证
- Phase 5B-2最新运行结果验证
- Phase 5C结果分析架构
- Zone空气状态CSV契约
- Phase 5C自动与非GUI验证
- Phase 4A开发与验证
- Phase 2C开发与验证
- Phase 3A-0开发与验证
- Phase 3B开发与验证
- 阶段路线图
- 风险登记表
- 架构决策记录
- Phase 2A Zone读取技术Spike
- Phase 2B-0 Zone格式证据调查
- AI安全边界
- 许可策略
- 深度研究报告
Phase 5A已验证使用与Phase 4相同NIST官方包中的simread.exe，从成功的ContamX运行清单复制PRJ和SIM到独立后处理工作区，并严格读取Zone空气状态文本结果。当前只支持zone_air_state（K、Pa、kg/m³）和官方.nfr文本契约；不读取任意SIM或其他结果类型。桌面展示与导出由后续Phase 5B/5C在同一严格结果之上实现。
python\.venv\Scripts\python.exe -m contam_studio_core.zone_air_state_results probe-simread --simread <simread.exe> --json
python\.venv\Scripts\python.exe -m contam_studio_core.zone_air_state_results extract <Phase4-manifest.json> --simread <simread.exe> --result-root <result-root> --zone-number 1 --json详细边界见SimRead结果提取架构和Phase 5A验证记录。
结果提取只接受成功的Phase 4运行清单作为可信入口，不能直接传入NFR或SIM。manifest、PRJ和SIM使用同一份bytes及哈希证据反复复核；day_type当前返回null，因为官方NFR不提供CONTAM日类型，sim_time_seconds表示从首个样本起算的累计秒数。工作区创建后进程或解析失败会使用与成功相同的清单模型保留真实流和生成物证据，wait异常和超时均进入有界进程收口并关闭父管道，且写清单前记录Phase 4、工作区和SimRead最终证据状态；未确认退出的生成物不写最终哈希；入口配置或路径在工作区创建前拒绝时不会伪造清单。
打开受支持PRJ并选择Zone后，Phase 5B-1允许通过原生对话框选择Phase 4运行清单。Phase 5B-2新增无对话框的“加载最新运行结果”：manifest只来自Rust内存中的ActiveRunContext，并严格绑定当前项目session、活动Revision SHA-256、受控运行目录和run_id。Phase 3C之后React始终只提交request、session和稳定zone_id，不提交CONTAM编号或任何路径；Rust负责映射当前Revision中的外部编号。详见Phase 5B架构、Phase 5B-1验证记录和Phase 5B-2验证记录。
结果入口仍不接受任意SIM/NFR；运行成功后不会自动提取结果。Phase 5C在同一结果上增加当前Zone曲线、确定性统计、完整表格和受控CSV导出；仍不支持Excel原生格式、多Zone或多运行比较、运行历史、污染物结果或AI解释。
Phase 5B-2自动、非GUI官方闭环和用户真实Tauri验收均已通过；验收覆盖最新运行直达、Zone 1/2、较早清单过期提示、取消保留、项目切换清理、中英文和双主题，证据见PR #12评论。
当前Zone的严格结果默认进入图表视图：温度K、参考压力Pa和空气密度kg/m³使用一个模块化ECharts实例、等长同范围的三个累计时间横轴和鼠标滚轮同步缩放；不显示独立拖放滑块。数据原序、数值和单位保持不变。纯TypeScript模块用一次遍历确定性计算三项指标的最小值、最大值、平均值和首次极值位置，统计卡明确标注极值时间，原始语义化表格仍完整保留。
CSV只由Rust内存中的ActiveResultContext生成。WebView只提交项目、Zone、运行和提取身份；目标路径来自原生保存对话框。导出使用UTF-8、CRLF、固定13列、RFC兼容转义、文本公式注入防护和同目录原子提交，拒绝现有文件。详见分析架构和CSV契约。
Phase 5C真实GUI复核已通过，证据见PR #13评论。Phase 3C只改变项目草稿与身份边界，不改变结果数值、统计或CSV契约。
顶部“运行”只向Tauri提交request_id和活动project_session_id。Rust绑定当前项目路径和SHA-256，把运行根限制到应用本地数据目录，并通过一次性Python桥调用同一run_contamx()领域接口。成功摘要包含运行ID、官方ContamX 3.4.0.3、时间、退出码和非空SIM数量，不包含求解器、manifest或工作区绝对路径。ContamX通过CONTAM_STUDIO_CONTAMX配置，不回退PATH。
最新成功运行只存在于当前桌面会话，打开其他项目或切换到Patch副本后清除。运行失败保留上一次成功摘要。Phase 4B-1自动与用户手动GUI验收均已通过；手动证据记录在PR #11验收评论。Phase 5B-2允许用户主动把这份最新成功运行加载到当前Zone结果页，但不自动提取。