Theme / v3.2.0
Archify
把想法變成可互動的圖
Changelog
版本更新紀錄
收錄 Archify 的版本變遷軌跡。每條紀錄以舊值→新值呈現，舊值以紅線劃掉但保留可見，方便對照改動軌跡。
v3.2.0
已同步2026-10-23- 2026-11-06 查核：上游最新 release 仍為 v3.2.0（2026-10-19 發布），其後無新版本。
- 版本定位：v3.1.0→v3.2.0（2026-10-19 發布）。官方主軸：「Create a conclusion-first one-page answer from Markdown, with cited sources, interactive diagrams and browser exports.」——從 Markdown 產出結論先行、帶引用來源的單頁解答頁 (explainer)。
- One-page answers（explainer）（#993）：「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.」——每個 panel 回答一個問題，內容可用散文、表格、步驟、檢查清單、圖表、程式碼與驗證過的原生圖。
- 製作與交付：
finalize explainer負責驗證、原子交付與頁面檢查；圖表來自 Mermaid fence 或 draft 旁的 CSV/JSON 檔，repo 節錄自 pinned commit 讀取；patch explainer可依 ID 取代單一 panel。 - 閱讀互動：步驟與其走訪的圖並列、可逐步走訪；文字與圖節點互相 highlight；點節點開啟聚焦該節點的完整 Viewer；引用與 source-linked 節點開啟 source cards；每個 panel 或選取段落會產生針對該 panel 的 follow-up question。
- 分享與匯出：頁面提供四種風格（clean、editorial、product、Swiss）與深淺主題，可匯出 PNG/WebP/JPG 長圖或列印成 PDF；
docs/cases/explainer/內附四個 live 頁面範例。此方向受 #942（by @goatliamia）的一頁式文件方向塑造，並致謝 @QingYunA 的早期一頁圖解提案與原型。 - 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再次以頁面為基準解析。 - 其他修正：explainer 長圖匯出現保留頁面的風格與主題（修因頁面畫在 SVG 內、其
<html>不是:root而一律輸出淺色 clean 風格）；圖表空白資料（空 CSV 儲存格、JSON null、缺欄位）改為錯誤而非當零，finalize 會指出欄與列名；workflow 遷移語意契約（#497）——layout planning 不再以移除 routed edges 的暫存圖檢查完整拓撲需求，遷移文件保留撰寫的契約且發布前須通過完整驗證；Timeline 時區刻度（#926）按顯示時區的真實 UTC 偏移對齊，修復跨夏令時後日刻度漂移問題，回撥重複時刻保持獨立、跳過的小時或日期不生成虛構刻度。 - 其他變更：閱讀控制與節點索引（緊湊的底部索引列、選單與 roving 鍵盤導覽尊重修飾鍵）；更新通知附 release 摘要與協助更新選項（網路失敗維持非阻塞）；雙語首頁與 gallery 介紹 one-page answers、保留 guides 與 source-backed cases；瀏覽器探索、Windows 命令路徑、原始碼目錄空白與暫存 worktree 清理獲得修正。
- 發布事項：本 release 提供下載
archify.zip；獨立版本號的 DSH plugin 未隨本 release 重新發布，維護者需選擇 pinned source 並在後續跟進中完成 host/package 接受。
v3.1.0
舊版本2026-10-14- 版本定位：v3.0.1→v3.1.0（2026-10-13 發布，單一 release，官方主題「Ten diagram types, Live motion enabled by default」）。主軸：圖表型別從五種倍增為十種、動效與拓撲分離、製作診斷與交付閘門結構化。獨立發布的 DSH plugin 維持 1.0.0／內含 Archify 3.0.1，同步為後續追蹤事項（#916/#917/#918）。
- 五種新圖表型別：ERD、Class/interface、Tree、Timeline 與 Waterfall 加入既有的 Architecture、Workflow、Sequence、Dataflow、Lifecycle；官方明言 Timeline 與 Waterfall 的值需有證據才能標示為 factual/measured。
- 動效預設開啟、與拓撲分離：每種型別的 live motion 預設啟用，type-specific motion 與作者標示的拓撲 (authored topology) 分離，需要時可切為 Still；卡片更清晰、routing 與 label 協調、Sequence 註記、Lifecycle 佈局與長頁讀者導覽一併改進。
- 製作診斷與交付閘門：結構化的製作診斷 (authoring diagnostics)、有界恢復 (bounded recovery)、原始碼驗證 (source verification)，以及輸入／artifact／瀏覽器三種交付閘門各自獨立。
- 修正與已知限制：匯出、剪貼簿與 Windows 路徑可攜性修正；已知限制——長 Sequence 圖的 initial-viewport 控制重疊、Dataflow 共用視覺走廊、長 Class 泛型型別換行不佳。
- 既有使用者影響：讀者開啟的 Guide 內 repo 連結改為在地化選項；DSH adapter 使用者等待後續同步 release。
- 學習重點：把動效從拓撲分離、可整體切 Still，是「事實層與呈現層分離」的範例——Still 模式保證圖的事實內容不因動效而變。
v3.0.0
舊版本2026-09-28- 本站此前未記錄的 v3.0 主版，涵蓋五種圖表型別（architecture、workflow、sequence、dataflow、lifecycle）的型別化 JSON IR、showcase 驗證閘門與獨立 HTML 交付流程。
v3.0.1
舊版本2026-09-28- 2026-10-13 查核：上游最新 release 仍為 v3.0.1（2026-09-28 發布），其後無新版本（2026-10-04 的 archify-dsh-v1.0.0 為 DSH adapter 發布，與 Archify 本體版本號各自獨立）。
- 版本定位：v3.0.x 穩定版收尾（"Update reminders at final delivery"）。主軸是交付時的版本提醒機制——
finalize與獨立deliver的 receipt 內含有限度的 stable-release 檢查，已知有新版時在該任務的最終回覆顯示一次，直到使用者更新或明確忽略。 - 不自動更新：Archify 永遠不會自行下載或安裝更新；是否升級由使用者決定，可設
ARCHIFY_UPDATE_CHECK_DISABLED=1停用檢查網路與提醒狀態寫入。 - 學習重點：把「版本提醒」收斂到最終交付的一個 receipt 欄位，而不是每個指令都跳通知，是對 agent 注意力的尊重——提醒只出現一次，且帶有可操作的升級選擇。
圖例
- 當前版本 本站現在記錄的版本
- 舊版本 已被取代，保留作歷史對照
- 已同步 與上游 release 對齊
- 僅上游變動 上游 main 有 commit，但未發佈新版