Scientific Model Diagram Visio
使用原生可編輯物件在 Microsoft Visio 中建立或修訂科學架構圖。將科學正確性、可讀的幾何佈局與可編輯性視為獨立關卡；全部通過後方可交付。
選擇模式
- 完整重建： 根據驗證過的模型合約與視覺參考，建構要求的頁面。
- 局部修訂： 備份 VSDX 檔案，僅修改指定的階段、符號、尺寸、連線工具、字型或間距。
- 審計/匯出： 檢查現有 VSDX 檔案，僅修正授權的缺陷，重新開啟檔案，並匯出 PDF 與 300 DPI 的 PNG。
若原始邏輯尚未在程式碼、組態、稿件與舊圖之間取得一致，請先使用 scientific-model-diagram-prompting 或在 handoff-contract.md 中執行證據比對。切勿僅憑視覺外觀推斷融合操作或張量維度。
強制工作流程
1. 凍結目標模型
建立模型合約，內容包含：階段順序、每個邊界的張量形狀、操作語義、可學習參數、融合規則、分類器寬度、類別數量與精確標籤。當程式碼或稿件可用時，請引用來源檔案與行號。
除非使用者明確選擇其他目標，否則套用以下證據優先順序：
- 成功建構或執行的模型；
- 訓練實作與實驗組態；
- 稿件方程式與方法文字；
- 舊有 VSDX 或點陣圖；
- 產生的視覺參考。
當矛盾會實質改變架構時，請先停止並報告未解決的矛盾，再開始繪圖。請參閱 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. 分階段繪製
按順序執行以下階段：
- 頁面、圖層與容器；
- 重複的列導引線與連線通道；
- 模組與可重複使用的立方體；
- 數學運算元與獨立運算子；
- 黏附於連接點的連線工具；
- 標籤、尺寸、圖例與標題；
- 對齊、分散與局部群組；
- 以預覽比例與原始細節進行視覺清理。
每個主要階段結束後，在工作目錄中擷取螢幕截圖。若是局部修訂，僅修改受影響區域，並重新檢查其傳入與傳出的連線。
6. 強制路徑與可讀性
- 偏好完全水平的分支線與正交彎折。
- 在放置文字前預留空白連線通道。
- 將每個功能性連線工具黏附至明確的連接點。
- 切勿讓線條穿過文字、運算子、立方體、繪圖卡片或其他箭頭。
- 保持平行行的高度與間距一致；使用「對齊」與「分散」而非目視調整。
- 在將文字縮小至最小尺寸前，先縮短標籤或加寬容器。
- 檢查全頁預覽與縮放後的螢幕截圖。僅在縮放時可閱讀的文字視為不合格。
7. 儲存、重新開啟並驗證可編輯性
將最終 VSDX 儲存至要求路徑，關閉後在 Visio 中重新開啟。個別選取並編輯至少：
- 群組立方體內的一個面；
- 一個數學運算子或符號；
- 一個連線工具與其兩個黏附端點；
- 一個階段標籤。
確認參考影像已移除或隱藏在鎖定的 Reference 圖層上，在要求時不相關頁面已不存在，且沒有任何物件變成單一全頁點陣圖。
儲存後執行 scripts/inspect_vsdx.py。此靜態檢查輔助但絕不取代視覺檢查。
8. 匯出並執行最終 QA
從 Visio 匯出 PDF 與 PNG。對於 16 × 9 英吋的頁面，300 DPI 的點陣圖至少為 4800 × 2700 像素。檢查兩個匯出檔案是否有裁切、字型替代、線條過細/斷裂、陰影瑕疵與頁面邊界錯誤。
執行完整的 qa-checklist.md。只要有任何科學正確性、重疊、連線工具、文字完整性、匯出或可編輯性項目失敗，即不得交付。
局部修訂規則
- 保留未受影響的形狀、樣式、圖層與頁面設定。
- 在編輯前備份，並在獲得接受前以新版本儲存修訂。
- 診斷最小的受影響子圖：傳入連線工具、已編輯物件、傳出連線工具。
- 移動任何物件後，重新路由相鄰的連線工具。
- 重新執行全頁預覽 QA；局部修正可能造成全域碰撞。
必要移交報告
報告以下事項：
- 目標架構與證據基礎；
- 來源、備份、工作目錄與輸出路徑；
- 已移除或保留的頁面；
- VSDX、PDF 與 PNG 路徑，以及 PNG 像素尺寸/DPI；
- 靜態 VSDX 檢查摘要；
- 已執行的重新開啟/可編輯性測試；
- 任何剩餘的不確定性。
切勿僅因檔案已儲存或匯出就宣稱成功。