操作入口索引
本页对应当前仓库及本地验证候选，适用 Windows x64、Blender 5.1.1。公开 Alpha 包可能早于下述新增入口，先按候选与验证范围核对版本。版本及安装包可用性见 README，技术范围见 验证记录。
安装、导入、渲染、导出与保存按 人工 SOP 执行。案例、截图和安装包集中在 validation，下面提供操作入口索引。
操作入口与对象选择
跳转到“操作入口与对象选择”先切换物体模式，选中对应 QC 对象。每次换对象后，点击 N 侧栏 → 当前 QC 对象 → 打开对象属性，核对按钮旁的目标名。展开表中指定面板；按钮灰显时查看其下方原因。
N 侧栏 指 3D Viewport → N → QCBlender；对象属性 指 Properties → Object → QCBlender · 对象与量子化学。
| 操作 | 需要选中的对象 | 编辑器与面板路径 | 可见按钮或控件 |
|---|---|---|---|
| 导入计算结果 | 无 | N 侧栏 → 导入与导出 → 导入 | 导入 Gaussian / Cube / XYZ / ORCA |
| 生成 MO、密度或 ESP | 含轨道的 FCHK 原子视图 | 对象属性 → 创建视图与工具 → 计算 | 生成量子化学场 |
| 查看能量、选择振动模式 | 含相应记录的原子视图 | 对象属性 → 科学记录与振动模式 | 能量列表、模式列表 |
| 振动显示参数 | 已选模式的原子视图 | 对象属性 → 高级参数 | Animate、Amplitude (angstrom)、Phase、Cycles per second |
| 原子电荷着色 | 含电荷记录且未绑定着色场的原子视图 | 对象属性 → 科学记录与振动模式 | 设置原子电荷着色 |
| 创建偶极 | 含偶极记录的原子视图 | 对象属性 → 创建视图与工具 → 空间工具 | 创建偶极矢量 |
| 声明 Cube 量与单位 | unknown_scalar 场视图 | 对象属性的 QCBlender 主面板 | 声明 Cube 物理量与单位 |
| 绑定或替换着色场 | 要着色的几何视图 | 对象属性 → 颜色映射 | 选择／替换着色场 |
| 应用色带预设、反转颜色 | 已有标量着色或电荷着色的 QC 表面、切片或原子视图 | Properties → Material → QCBlender · 节点材质 → Color map | 应用色带预设…；色带预设：QC Default / Viridis / Cividis；Reverse (0 or 1) |
| 创建切片、等值面或体积雾 | 有关联体场的标量视图 | 对象属性 → 创建视图与工具 → 空间工具（切片）／显示视图（等值面、体积雾） | 创建切片、创建等值面层、创建体积雾 |
| 采样线剖面数据 | 有关联体场的场视图或切片 | 对象属性 → 创建视图与工具 → 场值采样 | 记录剖面起点、采样线剖面数据 |
| 导出科学记录或当前视图摘要 | 含相应数据的原子、场或分析记录 | N 侧栏 → 导入与导出 → 导出 | 导出数据与参数摘要；数据（Data）选择当前视图参数摘要或IR/optimization/IRC/Mayer/profile/paired/ESP_AREA |
| 查看与播放 XYZ 多帧 | XYZ 多帧原子对象 | 对象属性 → XYZ 帧（XYZ Frames）→ XYZ 原始帧播放（Original XYZ Playback） | Previous、Next、Choose XYZ Frame；播放 XYZ 原始帧（Play Original XYZ Frames）、停止 XYZ 播放（Stop XYZ Playback） |
| Mayer 逐键着色 | 已导入 Mayer 结果的 IRC path 或其 Mayer 记录 | 对象属性 → IRC 路径 | 显示 Mayer 连线、Mayer 显示设置；整路径色域、手动范围、键级下限 |
| 表面距离投影 | 生成时同朝向的静态原子视图 | N 侧栏 → 导入与导出 → 导入外部结果 → 空间场分析 | 表面距离投影；生成后在对象属性中设置色表、等值线并读取网格点；CSV 类型 PROJECTION |
| AICD张量与电流响应 | 同原子顺序、同生成坐标的静态原子视图 | N 侧栏 → 导入与导出 → 导入外部结果 → 空间场分析 | AICD张量；生成后在对象属性设置磁场、箭头和Aniso等值面，读取原始采样点；CSV类型AICD |
| 局部选择、氢显隐 | 原子视图 | 对象属性 → 局部选择与标注 | 设置局部选择、隐藏氢等 |
| 创建标注、优化视图 | 原子视图；优化需有逐步数据 | 对象属性 → 局部选择与标注（标注）／Optimization Trajectory（优化视图） | 原子（Atoms）、距离（Distance）、角度（Angle）、二面角（Dihedral）；创建优化轨迹视图（Create Optimization View） |
| 查看来源 | 对应 QC 视图 | 对象属性的 QCBlender 主面板 | 来源详情、刷新来源、关联选中数据源 |
| 浏览外部结果 | 对应外部结果显示层 | 对象属性 → External Result Browser | 应用筛选、Apply Filter、Swap value columns |
| 管理显示层 | 对应 QC 显示层 | 对象属性 → 显示层管理 | 视口可见性、渲染可见性、复制、移除、上移、下移 |
| 复制显示参数 | 多选同类 QC 视图，最后选参数来源 | 3D Viewport → 对象右键菜单 → QCBlender | 复制显示参数到选中视图 |
| 创建相机与设置输出 | 选中需要出图的 QC 视图 | 对象属性 → 创建视图与工具 → 相机 | 创建取景相机、应用 QC 出图方案（Apply QC Output）、恢复原出图设置（Restore Original Output） |
| 保存与归档 | 已打开的 QC 工程 | N 侧栏 → 工程与维护 → 保存与归档 | 保存自包含工程、归档工程 |
| 恢复显示缓存或数据路径 | 受影响的 QC 视图 | N 侧栏 → 工程与维护 → 恢复与维护 | 重建显示缓存、重新定位数据 |
| 浏览、筛选及定位科学记录 | 含原生或导入结果的 QC 视图 | N 侧栏 → 科学结果（Scientific Results） | 刷新、结果表、查找文字、排序、页码、定位、固定显示、原子着色、元素配色 |
| 导入定量分析或 FMO | 对应同源静态原子视图 | N 侧栏 → 科学结果 | 导入分析（Import analysis）、冻结前线轨道反应性（Frozen-Frontier Reactivity） |
| 导出筛选表、光谱、SVG 或文献 | 含对应记录的 QC 视图 | N 侧栏 → 科学结果 | 导出科学 CSV / SVG（Export Scientific CSV / SVG） |
| 外观、零点锚定、vdW 壳与标签 | 支持的原子、场、切片或标签对象；控件随对象变化 | N 侧栏 → 外观与标签（Appearance and Labels） | 应用外观预设、将颜色中心锚定于零点、使用自由颜色中心、升级零点锚定颜色映射、创建或更新 vdW 外壳、按当前视角整理标签一次 |
| 叠合构型或创建关键帧副本 | 原子视图；叠合最后选活动参考 | 对象属性 → 构型显示比较（Display Comparison） | 将所选视图叠合到活动视图、恢复显示变换、创建关键帧显示副本（Create Keyframe Display Copies） |
| 图像与单周期振动输出 | 现有相机及 QC 视图；振动需选定模式 | Properties → Render → 图像与振动输出（Image and Vibration Output） | 设置单个振动周期（Set One Vibration Cycle）、导出三维图像或振动（Export 3D Image or Vibration） |
| 分组检查来源与恢复 | 当前工程；修复时选受影响对象 | N 侧栏 → 工程来源恢复（Project Source Recovery） | 检查工程来源（Check Project Sources）、受影响对象、重新定位数据、重建显示缓存 |
界面名称随 Blender 所选语言显示；中英文对照见 人工 SOP。后文英文名称用于辨认控件或日志。
了解编号边界、NOCV 与 NBO 记录选择
轨道编号按当前自旋的源轨道数限制，步、帧、原子和记录行按当前数据限制；输入超过范围时回到对应边界。NOCV Pair number 从该自旋实际存在的源编号中选择。NBO 记录先选择日志并确认检查，随后在第二个对话框选择 Gaussian job 和 NBO block；更换 Job 会同步更新 block 的范围。
导入与导出分流
跳转到“导入与导出分流”三类导入分别接收计算文件、场景分析层和定量结果。先按目标选择入口，再核对生成构型、原子顺序、量名、单位及来源。
| 导入目标 | 入口 | 输入与结果 |
|---|---|---|
| 计算文件、结构与路径 | N 侧栏 → 导入与导出 → 导入 | 导入 Gaussian / Cube / XYZ / ORCA 接收 FCHK、Gaussian/ORCA 文本结果、Cube、XYZ 和 HESS；导入 IRC 路径使用有序 FCHK 清单。ORCA .gbw 不支持 |
| 外部三维场景与分析层 | N 侧栏 → 导入与导出 → 导入外部结果 | IGMH/IRI 成对场、ESP 表面分析、表面距离投影、AICD 张量、NBO 记录、AIM 拓扑、ETS-NOCV 表及 NOCV 对 Cube |
| 定量结果与证据 | N 侧栏 → 科学结果 → 导入分析／冻结前线轨道反应性 | 原子电荷、静态键级、Hirshfeld MO 组成、IGMH 积分及贡献、ESP 指标/分区/面积分布/顶点、Bader 盆、ALIE/RDG 成对场、通用原子/键 CSV；FMO 另需同源凭据。结果表与受支持的原始证据随自包含工程保存 |
| 导出目标 | 入口 | 产物与用途 |
|---|---|---|
| 既有记录及视图参数 | N 侧栏 → 导入与导出 → 导出 → 导出数据与参数摘要 | IR、优化/收敛、IRC/Mayer、剖面、成对体素、ESP 面积、投影及 AICD 等 CSV；当前视图参数摘要生成 Markdown 与 JSON |
| 筛选快照、二维科学图与文献 | N 侧栏 → 科学结果 → 导出科学 CSV / SVG | 导出全部符合筛选条件的行，包含当前页以外的行；光谱、轨道能级、IRC/Mayer/剖面 CSV、metadata 及静态 SVG；工程文献核对单和已核对 BibTeX/RIS |
| 渲染媒体 | 渲染属性 → 图像与振动输出 → 导出三维图像或振动 | 三维 PNG、振动 PNG 序列或 MP4，使用场景相机和灯光；可检查极值越框并使用临时相机取景，结束后恢复输出设置 |
上述导出不替代 保存自包含工程。.blend 与同名 .qcdata/ 仍需一起保留。
按任务进入教程
跳转到“按任务进入教程”| 任务 | 教程位置 |
|---|---|
| 安装、对象/编辑器选择、第一张 MO 图 | 入门主流程 |
| Gaussian 计算段、能量、优化、振动、NBO 与振动媒体 | 公开Gaussian日志专题 |
| Cube 单位、双符号、多场叠加与跨场着色 | Cube 专题 |
| 密度、ESP、电荷/偶极、零点锚定、vdW 壳与 ALIE/RDG | 电子分布专题 |
| 切片、探针、剖面 CSV、裁剪和体积雾 | 空间观察专题 |
| 氢显隐、局部选择、标签整理、显示层、XYZ 播放与显示叠合 | 分子显示专题 |
| IGMH/IRI、空间积分及片段/原子对贡献 | 成对场专题 |
| ESP 极值、全表面/分区统计、AIM 与 Bader 双重收敛 | 点、路径和分析记录 |
| IRC/Mayer、关键帧显示副本与静态 SVG | 反应路径专题 |
| ETS-NOCV 和 pair Cube | NOCV 专题 |
| 公共几何节点 | 节点专题 |
| 表面距离图、原子投影、三态与等值线 | 距离投影专题（本机限定案例） |
| AICD 张量、Aniso 等值面、电流响应与原始点值 | AICD 专题（本机限定案例） |
| IR/Raman、展宽曲线、峰表与 SVG | 光谱专题 13 |
| 原子电荷、静态键级、轨道组成与结果着色 | 原子结果专题 14 |
| 闭壳层冻结前线轨道反应性与同源凭据 | FMO 专题 15 |
| ORCA OUT、配对 HESS、原生 IR/Raman 记录 | ORCA 专题 16 |
| 取景、渲染、参数摘要和保存重开 | 导出与保存 |
| 错误输入、筛选/取消、关联、恢复等技术边界 | Agent 检查覆盖 |
保存使用 N 侧栏 → 工程与维护 → 保存与归档 → 保存自包含工程，并将同名 .blend 与 .qcdata/ 一起移动。
了解科学值、源编号与显示参数
源文件始终决定科学值和单位，显示操作不改科学数组。源编号从1起，坐标Å；普通几何键由距离推断，Mayer 连线来自导入的计算原子对。MO两符号表示相位，振动播放速度属于显示参数。两个来源关联、Cube单位声明、外部分析参数均须核对真实生成记录。显示叠合只做刚体显示变换，不改源坐标、不建立科学关联；关键帧副本仅含几何，不继承静态科学属性。FMO 要求有凭据的闭壳层 canonical 非简并前线；η=I−A、S=1/η，不等同 ΔSCF。Raman 活性与激光/温度换算后的非共振 Stokes 相对强度分别保留，频率缩放不改原始权重。
色带预设与多场显示
跳转到“色带预设与多场显示”按 色带预设步骤选择预设、确认应用，并练习反转、取消、撤销和重做。需要独立配色时，先在 对象属性 → 显示层管理 → 复制（Duplicate） 创建展示副本。
了解共享材质、预设保留项与目标限制
对话框显示目标材质，并说明共享它的视图会同步更新。需要独立配色时，先在 对象属性 → 显示层管理 → 复制（Duplicate） 创建展示副本。预设用于标准标量/电荷着色；自定义图无法确认目标、目标只读或对话框打开后目标改变时，操作会报告原因，重新选择有效目标后再打开对话框。
在 Properties → Material → QCBlender · 节点材质 的 Color map 下点击 应用色带预设…，选择 QC Default、Viridis 或 Cividis，确认后替换当前材质的色阶与插值；选择菜单选项时尚未应用，取消保留原色带。Reverse (0 or 1) 独立控制反转。应用预设保留数值范围、中心值、反转值、透明度与图例布局；表面和图例使用同一材质。操作可通过 Blender 的 Edit → Undo / Redo 撤销或恢复。
多份 Cube 可以在同一场景各自生成表面，分别调整阈值与视口/渲染可见性；同构型示例见 多 Cube 叠加。把第二个场用于第一表面的着色，另用 选择／替换着色场。源文件的物理量与单位分别保留。
原子选择与标注始终使用源原子编号。
了解多场显示与源原子属性
球棍求值后，一个原子会生成多个球面顶点；求值网格的顶点行号不能当作源原子编号，球面位置也不是核位置。源 POINT 属性、缺失属性和有效标志的读法见 节点专题。
当前步骤关联与共享对象
跳转到“当前步骤关联与共享对象”IRC和优化关联比较双方当前步骤的源Å坐标。最后选择的对象作为活动参考；在对象属性主面板点击 关联选中数据源。任一端换步后，来源详情中的Geometry association显示stale；返回原步仍需重新关联。旧工程关联、复制层和当前版本新视图也需重新建立关联。
原生Alt+D产生的共享原子mesh不能切换IRC/优化步骤。仅选要独立调整的副本，使用 3D Viewport → Object → Relations → Make Single User → Object & Data，再点击对应面板的Previous/Next/Choose Step。选择顺序、关联失效、单用户恢复和Undo/Redo检查见Agent 覆盖。
Gaussian 优化轨迹浏览
跳转到“Gaussian 优化轨迹浏览”按 公开Gaussian日志专题导入 shared/data/public/gaussian-v2/P02/water_neutral_nbo_opt_freq.out 的 Job1，在 对象属性 → Optimization Trajectory 点击 创建优化轨迹视图（Create Optimization View）。选中新轨迹对象并重新打开对象属性，使用 Previous / Next / Choose Step 切步。本例优化共5步。Job2 的三个模式和能量在 科学记录与振动模式；IR数值通过数据导出取得。旧的本机限定日志仍由历史本机案例定位，其数值不用于本专题。
查阅新建视图默认值与导出目录规则
新建原子显示外层Quality=3，新建切片每轴201点；生成网格初值0.2 Å、边缘3 Å、512 MiB。公共QC Style Atoms and Bonds的Quality=2、QC Planar Slice的Resolution=101仍保留。Addon偏好“数据导出目录”留空时使用已保存.blend父目录，否则真实系统Documents；导出对话框Output directory可单次覆盖。导出目录不替代.qcdata工程数据。
Alpha 首次出图与资源检查
跳转到“Alpha 首次出图与资源检查”按 人工主流程 完成 P01、Alpha 源 MO9、0.2 Å / margin 3 Å / 512 MiB、等值 0.045 bohr^-3/2 的路线。
了解首次预检与资源预算
首次点击生成先异步科学预检，通过后打开参数对话框；网格、结果大小和求值预算即时更新，超限显示原因。资格绑定源 manifest 与科学指纹，重绑或新进程重开后重新检查。
选最终视图，在“N 侧栏 → 导入与导出 → 导出 → 导出数据与参数摘要”选择“当前视图参数摘要”，得到中文 view-summary.md 与 metadata.json。
了解参数摘要的可核实范围
摘要读取当前节点和材质，无法核实的自定义图和缺字段显示 partial/unverified。源科学数组、现有 CSV 数据格式不变。