視覺圖譜¶

這一頁是整個 repo 的圖像索引。Mermaid 用來描述會隨程式演進的關係；SVG 用來建立穩定的心智模型與簡報級總覽。每張圖都連回對應的 Wiki 主題。

系統一覽¶

MedPaper Assistant cross-agent system map — Agent 可替換；共用契約、MCP 工具、filesystem artifacts 與 audit trail 才是系統核心。

閱讀 Harness 架構 →

產品與使用情境¶

MedPaper Assistant product overview — Search、Think、Write 是使用者面向；底層由跨 Agent harness 與共享 project state 支撐。

從五分鐘開始 →

系統與 DDD 邊界¶

MedPaper Assistant architecture overview — 外層介面透過 application use cases 驅動 domain；infrastructure 只實作向內定義的 ports。

查看 Repo 導覽 →

研究管線¶

Auto-Paper core pipeline — 0–10 是主要研究與學習迴圈；Phase 2.1 與 6.5 是巢狀 gate，Phase 11 在 audit 完成後交付。

閱讀研究管線 →

證據迴圈¶

Evidence and exemplar loop — 證據支撐 claim；範文只校準寫作慣例。兩者角色分離並各自留下 audit。

閱讀證據、引用與範文 →

正式產出地圖¶

Academic output landscape — 同一套 artifact pipeline 依 output profile 套用不同段落、字數、引用與品質限制。

探索 13 種正式產出 →

品質演進層¶

Three-layer quality and evolution system — 事件 Hook、程式約束與跨輪次演進共同構成可稽核的品質控制。

閱讀品質與稽核 →

何時用 Mermaid，何時用 SVG¶

flowchart TD
    Need{要表達什麼？}
    Need -->|phase / state / dependency| Mermaid[Mermaid]
    Need -->|品牌總覽 / 固定心智模型| SVG[Hand-authored SVG]
    Mermaid --> Diff[文字可 diff<br/>容易隨程式更新]
    SVG --> Polish[精確版面<br/>可重用於 README / release]
    Diff --> Docs[嵌入主題頁]
    Polish --> Docs
    Docs --> Check{內容仍符合實作？}
    Check -->|yes| Publish[Strict build + Pages]
    Check -->|no| Update[更新圖與相鄰說明]
    Update --> Check

圖不是裝飾，而是架構文件。任何工具數、phase、依賴方向或品質 gate 改動，都要同步檢查對應 Mermaid、SVG、caption 與文字敘述。

可存取性規則

SVG 必須有 <title> 與 <desc>；Markdown 圖片必須有具體 alt text；顏色不能是唯一訊息載體；動畫要尊重 prefers-reduced-motion。