概述
Archify v3.2.0（2026-10-19 發布）的官方主軸是一句話：
“Create a conclusion-first one-page answer from Markdown, with cited sources, interactive diagrams and browser exports.”
從 Markdown 產出結論先行 (conclusion-first) 的單頁解答頁——帶引用來源 (cited sources)、互動式圖表 (interactive diagrams) 與瀏覽器匯出 (browser exports)。這個功能稱為 one-page answers（explainer）（#993），是 Archify 從「圖表產生器」走向「單頁解答文件」的方向性擴充。
| 區塊 | 一句話 |
|---|---|
| Explainer 本體 | 結論先行、每個 panel 回答一個問題 |
| 製作與交付 | finalize explainer 驗證後原子交付；patch explainer 依 ID 改單一 panel |
| 閱讀互動 | 步驟與圖並列、節點互相 highlight、follow-up question 針對 panel |
| 分享與匯出 | 四種風格、深淺主題、PNG/WebP/JPG 長圖與 PDF |
| 修正 | 頁面不帶本地路徑、匯出保留風格主題、空白資料是錯誤不是零 |
One-page answers：每個 panel 回答一個問題
“Ask your agent to answer as a page and Archify builds a conclusion-first explainer from a Markdown draft. Each panel answers one question, using prose, tables, steps, checklists, charts, code and validated native diagrams.”
請你的 agent「以一個頁面回答」，Archify 就從 Markdown 草稿 (draft) 建出一個結論先行的 explainer。頁面由多個 panel 組成，每個 panel 只回答一個問題，內容可以是散文 (prose)、表格、步驟、檢查清單、圖表 (charts)、程式碼與驗證過的原生圖 (validated native diagrams)。
「結論先行」是關鍵設計：讀者先看到答案，再往下看支撐它的證據與推理——與 Archify 一貫的「驗證後才交付」原則同源。
製作與交付
finalize explainer負責三件事：驗證 (validates)、原子交付 (delivers atomically) 與頁面檢查 (checks the page)。- 圖表來源有兩種：Mermaid fence 或 draft 旁的 CSV/JSON 檔。
- repo 節錄 (repository excerpts) 從 pinned commit 讀取——與主題既有的「釘選單一公開 commit」來源證據機制一致。
patch explainer可以依 panel ID 取代單一 panel，不必整頁重建。
閱讀互動
官方列出的閱讀體驗設計：
- 步驟與它走訪的圖並列，可以逐步走訪 (step through)。
- 文字與圖節點互相 highlight——選文字亮節點、選節點亮文字。
- 點擊節點會開啟聚焦該節點的完整 Viewer。
- 引用 (citations) 與 source-linked 節點開啟 source cards。
- 每個 panel 或選取的段落會產生一個針對該 panel 的 follow-up question。
分享與匯出
“the page ships in four styles (clean, editorial, product, Swiss) with light and dark themes, and exports a PNG, WebP or JPG long image or prints to PDF.”
頁面提供四種風格（clean、editorial、product、Swiss）與深淺主題，可匯出 PNG/WebP/JPG 長圖或列印成 PDF。docs/cases/explainer/ 內附四個 live 頁面範例可以直接參考。
這個一頁式文件方向的來源，官方也記錄了：
“the one-page document direction of #942 by @goatliamia shaped this work.”
#942（by @goatliamia）的一頁式文件方向塑造了這次工作；官方另致謝 @QingYunA 的早期一頁圖解提案與 demo 原型。
Explainer 頁面不再攜帶本地路徑
分享場景下的一個隱私修正：
“The draft embedded in a page names its source and data files relative to the page, so a shared page does not reveal the author’s directories.”
內嵌在頁面裡的 draft，其原始檔與資料檔改為相對於頁面命名——分享出去的頁面不會洩漏作者的目錄結構。patch explainer 也再次以頁面為基準解析這些路徑。
其他修正
- 匯出保留風格與主題：深色頁面或 editorial/product/Swiss 風格的 PNG/WebP/JPG 匯出，過去一律輸出淺色 clean 風格——因為頁面畫在 SVG 內、其
<html>不是:root；匯出現在改以頁面自身的屬性選取 root。 - 空白圖表資料是錯誤，不是零：空 CSV 儲存格、JSON
null或圖表欄位缺值不再變成零長的 bar；finalize 會指出欄名與列名。 - Workflow 遷移語意契約（#497）：layout planning 不再以「移除 routed edges 的暫存圖」檢查完整拓撲需求；遷移文件保留撰寫的契約，發布前須通過完整驗證。
- Timeline 時區刻度（#926）：刻度按顯示時區在各真實時刻的 UTC 偏移對齊，修復跨夏令時後日刻度漂移到 01:00／23:00 的問題；回撥的重複時刻保持獨立，跳過的小時或日期不生成虛構刻度。
其他變更
- 閱讀控制與節點索引：緊湊的底部索引列把描述放在標題下方；選單與 roving 鍵盤導覽尊重修飾鍵 (modifier keys)。
- 更新通知：可用更新附 release 摘要與「協助更新」選項；網路失敗維持非阻塞。
- 網站與可攜性：雙語首頁與 gallery 介紹 one-page answers，保留 guides 與 source-backed cases；瀏覽器探索、Windows 命令路徑、原始碼目錄空白與暫存 worktree 清理獲得修正。
發布事項
- 本 release 提供
archify.zip下載；stable 更新通知在 archive 驗證後另行發布。 - 獨立版本號的 DSH plugin 未隨本 release 重新發布——維護者需選擇 pinned source 並在後續跟進中完成 host/package 接受。DSH 與 Archify 本體的版本節奏獨立，這一點自 v3.1.0 起延續。
隨堂測驗
v3.2.0 的 explainer 頁面，每個 panel 的設計原則是什麼？
💡 想先看個提示？
關鍵字是 question，不是 diagram。
要只修改 explainer 頁面中的單一 panel，該用什麼？
💡 想先看個提示？
指令名稱就叫 patch。
explainer 頁面分享出去時，為什麼不再洩漏作者的本機目錄？
💡 想先看個提示？
修正的是路徑的寫法，不是移除 draft。
v3.2.0 修復了 explainer 長圖匯出一律輸出淺色 clean 風格的問題，原因是什麼？
💡 想先看個提示？
問題出在 :root 選擇器在 SVG 內的語意。
動手升級檢查清單
升級 v3.2.0：動手檢查清單
逐項勾選，確認你已完成升級必要的步驟（進度會保存在此瀏覽器）
延伸閱讀
- 官方 v3.2.0 release notes
- 前一課：
v310-ten-diagram-types——v3.1.0 的十種圖表型別 - 本主題 Changelog：完整的 v3.2.0 條目