FixAtoms Studio v1.0.0

FixAtoms Studio v1.0.0

本地原子结构固定工具 · 纯离线运行 · 基于 Python + PySide6 (Qt 6) + 3Dmol.js + ASE。

✨ 主要功能

• 📥 支持 CIF / POSCAR (CONTCAR) / XSD 读取，统一输出 POSCAR（Selective dynamics）
• 🖱️ 旋转 / 点选 / 框选（Shift 反选）三种交互，右键平移、滚轮缩放
• 🎯 完全固定 = 彩色实心球 + 黑色网格球；部分方向固定 = 橙色网格
• 🎨 内置 118 元素周期表，可自定义颜色与球直径，偏好自动保存
• 🧭 前 / 后 / 左 / 右 / 上 / 下六个晶胞标准视图
• 📷 正交 / 透视投影、透视视角 (FOV)、深度雾化
• ↩️ 撤销 / 重做（最多 100 步）
• 🚀 打包便携版，开箱即用，运行无需联网

📦 下载与使用

1. 下载 FixAtomsStudio-Windows-x64-portable.zip
2. 完整解压到可写目录（如桌面或 D 盘）
3. 双击 FixAtomsStudio.exe 启动

⚠️ 请保留 FixAtomsStudio.exe 与 _internal 文件夹的相对位置，不能单独复制 EXE；不要在压缩包预览窗口中直接运行，先完整解压。

适用环境：Windows 10 / 11 64 位，需系统支持 QtWebEngine / WebGL。无需安装 Python、Conda、Qt 或 ASE。

✅ 校验

• 文件名：FixAtomsStudio-Windows-x64-portable.zip
• 大小：约 274 MB
• SHA256：723c80fd6cbd180be1a8dd50d29d617b991b7a523dcfbaec9174f7282f73385c

校验命令（PowerShell）：

Get-FileHash .\FixAtomsStudio-Windows-x64-portable.zip -Algorithm SHA256

🔍 自检

解压后在 PowerShell 中可运行便携包自检，检查内置文件读取、3D 渲染、约束导出与视图操作，写入 report.json 与截图后自动退出：

.\FixAtomsStudio.exe --self-test .\自检结果

🧾 说明

• 上 / 下视图按当前定义使用相同朝向；非正交晶胞保留真实夹角
• 外观偏好写入 EXE 同目录的 ball_settings.json
• 3Dmol-min.js 为第三方库，使用与再分发需遵守其上游许可：3Dmol.js 项目

更多文档与源码请见 README。