科学模型图 Visio

科学模型图 Visio 是做什么的？

在 Microsoft Visio 中创建或修改科学架构图，使用原生可编辑对象。将科学正确性、可读的几何布局和可编辑性视为独立的检查门；在交付前需通过所有三项检查。

选择模式

• 完全重建： 根据已验证的模型契约和视觉参考，在请求的页面中构建图形。
• 局部修改： 备份 VSDX 文件，仅修改指定的阶段、符号、尺寸、连接线、排版或间距。
• 审计/导出： 检查现有的 VSDX 文件，仅修正授权的缺陷，重新打开文件，并导出 PDF 和 300 DPI 的 PNG。

如果源逻辑尚未在代码、配置、手稿和旧图之间对齐，请首先使用 scientific-model-diagram-prompting 或在 handoff-contract.md 中执行证据传递。切勿仅凭视觉外观推断融合操作或张量维度。

强制工作流程

1. 冻结目标模型

创建一份模型契约，包含阶段顺序、每个边界的张量形状、操作语义、可学习参数、融合规则、分类器宽度、类别数量和精确标签。当代码或手稿可用时，应引用源文件和行号。

除非用户明确选择其他目标，否则应用以下证据优先级：

1. 成功构建或执行的模型；
2. 训练实现和实验配置；
3. 手稿中的方程和方法文本；
4. 旧的 VSDX 或光栅图；
5. 生成的视觉参考。

在绘制前，如果发现未解决的矛盾且这些矛盾会实质性地改变架构，请停止并报告。阅读 handoff-contract.md 了解所需的移交方案。

2. 保护源文件并隔离工作文件

• 在编辑前，确定源 VSDX 和确切的输出路径。
• 使用用户的命名工作目录。如果未指定，则创建一个同级目录 _visio_work。
• 将截图、参考光栅图、带时间戳的备份、临时导出、QA 渲染和辅助输出保存在该工作目录中。
• 在第一次修改前备份源 VSDX 文件。不要覆盖唯一的副本。
• 仅在用户授权并已在工作日志中记录页面名称后，才能删除无关页面。

3. 有目的地控制 Microsoft Visio

当可用时，使用 computer-use Windows 自动化技能。在全新会话中的第一个 UI 操作之前，初始化其运行时并读取 sky.documentation("guidance")；在可能要求确认的操作之前，读取 sky.documentation("confirmations")。通过应用程序/窗口标识定位 Visio 窗口，并检查截图，避免使用盲坐标序列。

在 Microsoft Visio 中打开 VSDX 文件。当用户要求使用 Visio 时，不要使用光栅图、SVG 截图、PowerPoint 或通用图表编辑器来替代 Visio 执行。

在控制 Visio 之前，请阅读 visio-execution.md。

4. 先构建几何布局，后处理细节

在放置模块之前，先设置页面大小、方向、页边距、图层、阶段容器、行基线以及连接线走廊。对并行分支使用坐标规划和重复的几何结构。

对于重复的组件，创建可复用的原生主控形状或组合形状。保持操作数、运算符、维度和连接线独立。一个 3D 长方体必须保持为一组可编辑的前/顶/侧面；切勿展平页面。

关于布局标记、字号、长方体构造、连接线、分组以及用户的出版标准，请参考 layout-and-style.md。

5. 分阶段绘制

按以下顺序逐阶段进行：

1. 页面、图层和容器；
2. 重复的行引导线和连接线走廊；
3. 模块和可复用的长方体；
4. 数学操作数和独立运算符；
5. 粘合到连接点的连接线；
6. 标签、尺寸、图例和标题；
7. 对齐、分布和局部分组；
8. 在预览比例和原始细节下进行视觉清理。

每个主要阶段完成后，在工作目录中截图。如果请求的是局部修改，则仅更改受影响的区域，并重新检查其输入和输出连接。

6. 强制执行路由和可读性

• 优先使用完全水平的支线路径和正交拐角。
• 在放置文本前，预留空的连接线通道。
• 将每条功能性连接线粘合到明确的连接点上。
• 切勿让线条穿过文本、运算符、长方体、绘图卡片或其他箭头头部。
• 保持平行的行具有相同的高度和间距；使用“对齐”和“分布”功能，而非目测。
• 在将文本大小降低到最小值之前，先缩短标签或加宽容器。
• 同时检查整页预览和放大后的截图。仅当放大后才能看清的文字视为不合格。

7. 保存、重新打开并验证可编辑性

将最终的 VSDX 文件保存到指定路径，关闭它，然后在 Visio 中重新打开。单独选择并至少编辑：

• 组合长方体中的一个面；
• 一个数学运算符或符号；
• 一条连接线及其粘合的两个端点；
• 一个阶段标签。

确认参考图像已被移除或隐藏在锁定的“参考”图层上，按要求删除或保留无关页面，并且没有对象变为单页位图。

保存后运行 scripts/inspect_vsdx.py。此静态检查补充但绝不取代视觉检查。

8. 导出并执行最终 QA

从 Visio 导出 PDF 和 PNG。对于 16 × 9 英寸的页面，300 DPI 的光栅图至少为 4800 × 2700 像素。检查两个导出文件是否存在裁剪、字体替换、细/断线、阴影伪影和页面边界错误。

运行完整的 qa-checklist.md。当任何科学保真度、重叠、连接线、文本完整性、导出或可编辑性项目失败时，不得交付。

局部修改规则

• 保留未受影响的形状、样式、图层和页面设置。
• 在编辑前备份，并将修改版保存为新版本，直至被接受。
• 诊断最小的受影响子图：输入连接线、编辑对象、输出连接线。
• 移动任何对象后，重新路由相邻的连接线。
• 重新运行整页预览 QA；局部修复可能会造成全局冲突。

必需的交接信息

报告：

1. 目标架构和证据基础；
2. 源文件、备份、工作目录和输出路径；
3. 已删除或保留的页面；
4. VSDX、PDF 和 PNG 路径，以及 PNG 像素尺寸/DPI；
5. 静态 VSDX 检查摘要；
6. 执行的重新打开/可编辑性测试；
7. 任何仍然存在的不确定性。

不要仅仅因为文件已保存或导出就声称成功。