DSH 架構圖：讓 agent 畫出一張可驗證的系統圖
Mermaid 給你一張圖，archify skill 給你一份帶型別的規格、一個自帶互動的 HTML 架構圖，以及一份驗證報告——它的倉庫裡還寫明了一條社群版 DeepSeek Harness 接入路徑。下面是真實的一次「一句話生成」實錄。
最近更新: 2026-11-12
Mermaid 程式碼區塊仍然是在對話裡最快拿到一張圖的辦法，但它到圖就停了。這一頁講的是下一步：agent 讀你的倉庫或你的描述，寫出一份帶型別的規格，算繪成一個自帶互動的 HTML 架構圖，並且在產物通過自己的檢查之前拒絕交付。背後的 skill 叫 archify（tt-a1i/archify——我們 2026-09-27 核對時 72,468 stars），它的倉庫裡帶了一套有文件的 DeepSeek Harness 接入方案。
看截圖前先說清一件事：這段畫面裡沒有出現 DeepSeek Harness 介面。出現的是作者的 GitHub 頁面、archify 官網，以及一個通用 agent IDE 的分割畫面工作階段，所以請把它當成這個 skill 的產出與工作流紀錄，而不是 dsh 操作示範。下文所有指令與數字都在 2026-09-27 對照 github.com/tt-a1i/archify、它的 integrations/deepseek-harness README 與 npm registry 重新核對過。錄影裡那個 GitHub 頁面顯示 'Starred 19.1k'，因為它是專案更早期錄的。
結論速覽
- ▸archify 是 agent skill，不是 dsh 內建功能。通用安裝：npx skills add tt-a1i/archify -g；要在 dsh 裡用，就裝社群套件：dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0。
- ▸不需要倉庫也能起步，一句話就夠。想要有來源支撐的圖，就讓 agent 分析倉庫並給出 8–12 個核心元件、一條主要路徑、外部相依與信任邊界。
- ▸交付物是兩個檔案：一份帶型別的架構規格，和一個自帶互動的 HTML 架構圖——開啟、轉傳、匯出都不需要裝任何東西。
- ▸交付被驗證報告卡住：9/9 showcase 檢查、0 errors、0 warnings、visual_review passed、四種桌面寬度無溢出，外加規格與產物的 sha256。
Archify 的 GitHub 倉庫：安裝方式與這段時間的變化
Archify 是 agent skill，不是應用程式，也不是 dsh 的功能：把它裝進你在用的 agent，描述系統或讓 agent 去讀倉庫，它就會寫出一份帶型別的規格，再算繪成一個自帶互動的 HTML 圖。倉庫是 Apache-2.0，官網 archify.si，README 自己的一句話是「把你想理解、想規劃或想分享的東西，變成可互動的視覺化」。
下表是 2026-11-12 當天從 GitHub API、倉庫 README 與 npm registry 讀到的值，只代表那一天，不是即時計數。
倉庫與套件狀態，核實於 2026-11-12
- GitHub stars
- 95,759
- Fork
- 6,548
- 貢獻者
- 86
- main 最新提交
- 7e45f36 · 2026-11-10
- Archify 最新發佈
- v3.2.0 · 2026-10-19
- npm 上的 DSH 轉接套件
- @tt-a1i/archify-dsh@1.1.0 · 2026-11-08
- 轉接套件接受的宿主
- @deepseek-ai/dsh@0.2.1-rc.2
- npm 週下載量
- 14,465 · 2026-11-04 → 2026-11-10
在 DeepSeek Harness 裡怎麼裝
倉庫的 integrations/deepseek-harness README 只給一條受支援的路徑，而且隨 1.1.0 改了：裝精確版本，不要從 Git 原始碼裝。
第 1 行把 Skill-only 的 bundle 裝進 web profile，第 2 行是讓 dsh 載入它的那句話，第 3 行是移除。不要用 dsh plugin add tt-a1i/archify——倉庫根目錄不是 dsh 套件（issue #341）。README 還強調兩件事：轉接套件只接受 developer-preview 的 @deepseek-ai/dsh@0.2.1-rc.2；個人或專案裡同名的 archify skill 優先於 bundle，所以升級外掛不等於升級真正被載入的那個 skill，排查前先看實際載入的來源路徑。
integrations/deepseek-harness README
和 2026-09-27 那次核對相比，變了什麼
- ▸stars 從 72,468 增加到 95,759，Fork 6,548，貢獻者 86。錄影裡的 19.1k 和正文的 72,468 都是更早的讀數，不是筆誤。
- ▸DSH 轉接套件從 0.1.0 走到 1.0.0、再到 1.1.0：0.1.0 內建 Archify 2.14.0、對應宿主 0.1.0-rc.6（也就是下面 TL;DR 與分步教學還寫著的版本）；1.0.0 換成 Archify 3.0.1、宿主 0.1.2-rc.1；1.1.0 內建 Archify 3.2.0、接受 0.2.1-rc.2。
- ▸Archify 本體從 2.14.0 到 3.2.0：3.0 重做閱讀器並移除引導視圖與 story 視圖（下面第 6 步截圖裡的引導章節是 2.x 時代的產物），3.1 把圖型別擴到十種（ERD、Class、Tree、Timeline、Waterfall），3.2 增加了一頁式 explainer。
- ▸授權：skill 轉為 Apache-2.0，倉庫現在標示的也是 Apache-2.0；DSH 轉接套件仍是 MIT，套件內保留 Skill 的 LICENSE 與 NOTICE。
- ▸通用安裝指令也換了：README 不再以 npx skills add tt-a1i/archify -g 為主，而是讓 agent 讀 llms.txt，或執行 npx -y skills@latest add https://archify.si --skill archify --agent <agent> --global --copy --yes；只想試用不安裝可用 npx skills use tt-a1i/archify@archify --agent codex。
- ▸1.1.0 也修了 #906：1.0.0 關掉宿主的預設 skill 根目錄，導致個人與專案 skill 消失，1.1.0 改回 includeDefaultRoots: true。
上面的 TL;DR、分步教學與原有 FAQ 的數字與措辭刻意保留在 2026-09-27，因為它們描述的是那支錄影。要看目前狀態請看本節，安裝前也自己再核一次：宿主仍是 developer-preview，而 npm 上 dsh 的 latest 在 2026-11-12 已是 0.2.2-rc.1，比轉接套件宣告支援的版本更新。
從安裝到拿到驗證報告，一步一步來
裝之前先弄清它到底是什麼
- 1
先讀倉庫，再決定裝不裝
開啟 github.com/tt-a1i/archify 看目錄：179 次提交、25 個分支，有 .impeccable、benchmarks/ordinary-model-floor、experiments 這些目錄——以及跟我們最相關的 integrations/deepseek-harness，它最近一筆提交是 'ci(dsh): install acceptance runtime with pnpm'。About 一行把它定義為把可驗證的架構圖、工作流圖、時序圖、資料流圖與生命週期圖算繪成自帶 HTML 的 agent skill，標籤裡能看到 deepseek-harness、dsh-plugin 和 mermaid-alternative。
npx skills add tt-a1i/archify -g
先看目錄：dsh 轉接層在倉庫裡，不在 skill 核心裡。跳到影片 2:40 - 2
裝通用 skill，再決定要不要 dsh 社群套件
通用安裝路徑同時支援 Cursor、Claude Code、Codex CLI 與 OpenCode。倉庫另外寫明了一條 DSH 社群接入：@tt-a1i/archify-dsh@0.1.0，一個只裝 skill 的套件，宣告對 developer-preview 版 @deepseek-ai/dsh@0.1.0-rc.6 與 Node ^22.19.0 或 >=24.0.0 的實驗性相容，內建 Archify Skill 2.14.0，並在自己的 README 裡明說這不是 DeepSeek 官方產品、也不代表 DeepSeek 背書。不要試 dsh plugin add tt-a1i/archify——倉庫根目錄沒有 DSH 套件中介資料（issue #341）。另有一個第三方移植 GongYuanCaiJi/dsh-archify，2026 年 8 月建立，自述為移植自 tt-a1i/archify。
dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0Use the archify skill to map this repository's runtime architecture.
安裝指令與它的適用邊界，都寫在 README 和 releases 頁裡。跳到影片 2:30
它承諾交付什麼
- 3
先去官網確認輸出形態
官網主標題是 'From plain English to architecture you can trust'，LIVE PROOF 面板播放的是真實產生出來的產物而不是效果圖，下面還有三張可以點開看的樣本：S-01 Agent Tool Call、S-02 Production Deployment、S-03 Cache Miss。真正值得記的是下面那排數字：5 種圖類型、4 套視覺預設、2 套配好色的主題、4× 原生匯出倍率——以及 0 相依，這正是這個 HTML 能隨手轉傳的原因。
05 DIAGRAM TYPES · 04 VISUAL PRESETS · 02 COORDINATED THEMES4× NATIVE EXPORT SCALE · 00 DEPENDENCIES
LIVE PROOF 播的是真實產物，計數器最後一項停在 00 相依。跳到影片 0:48 - 4
先定圖類型，再寫提示詞
展示區裡列了五種視覺語言——Architecture、Workflow、Sequence、Data Flow、Lifecycle，而倉庫裡簽入的 Proof Lab 有 11 個情境，連同它們的 JSON 來源檔案、命名檢視與驗證報告。畫面上的 Architecture 例子是一條 Web 請求路徑：CloudFront → Load Balancer → API Server → PostgreSQL，旁邊掛著 S3、SQS 與一個 worker，圖例統計出 2 個資料庫、3 個雲端資源、1 個安全群組、1 個訊息匯流排、1 個外部系統。倉庫也明確寫了自動解析 Mermaid 不在範圍內，所以類型要在提示詞裡說清楚，別指望它吞一個 .mmd 檔案。
Architecture · Workflow · Sequence · Data Flow · LifecycleT-01 Architecture · T-03 Sequence · T-04 Data Flow · T-05 Lifecycle
帶類型圖例的 Architecture，同一展示區裡還有 Sequence、Data Flow 與 Lifecycle。跳到影片 0:55
跑一次真實任務，連同那份驗證報告
- 5
一句話下需求，然後逐行讀驗證報告
錄影裡整句提示詞就是「Archify 生成這個專案的架構圖」（畫面上的原文）。耗時 2 分 44 秒，回傳兩件產物——架構圖 HTML 與架構圖規格，並在上面列出必須通過的檢查：diagram_type: architecture、validation: 9/9 showcase, 0 errors, 0 warnings、visual_review: passed，以及 1440×900、1600×1000、1920×1080、2048×1320 四種桌面尺寸均無溢出。工作階段裡還會印出 specification_sha256 與 artifact_sha256，diff 計數器顯示規格被改動 +52 行、刪除 0 行。
diagram_type: architecturevalidation: 9/9 showcase, 0 errors, 0 warningsvisual_review: passed桌面尺寸: 1440×900 · 1600×1000 · 1920×1080 · 2048×1320 均无溢出
2 分 44 秒、一句話，換來一份可以逐行讀的驗證報告。跳到影片 1:24 - 6
走一遍引導章節，看這張圖到底主張了什麼
產生的 HTML 自帶作者寫好的引導章節。第 3/3 章「WorkFlow 執行」按順序走五個停靠點——Workflow Runtime、Child Session、Tool Surface、Runtime Evidence、Project Workspace——並放大到 145%，每個節點還帶自己的細節標籤：Child Session 是 in-process · bounded tools · fail-closed，Tool Surface 是 ordinary · package tools，Workflow Runtime 是 graph · runner · journal，Runtime Evidence 是 journal · artifacts · receipts。靜態算繪給不了這一層；頁面圖例同時統計出 5 個後端節點、1 個資料庫、1 個安全邊界、1 個外部系統。
引导视图 3 / 3 · WorkFlow 执行01 Workflow Runtime → 02 Child Session → 03 Tool Surface → 04 Runtime Evidence → 05 Project Workspace
引導章節把圖變成講解動線，每個節點還保留自己的細節標籤。跳到影片 2:06 - 7
把產物留在工作區，並把路徑要回來
產物最後那三張卡——Pi-native composition、Runtime authority、Evidence boundary——是這張圖在自我宣告權力與證據的邊界：session、模型、skill、信任與一般工具歸 Pi 所有；子工作階段繼承上下文，拿到的是 fail-closed 的工具交集；完成與否由終局證據確立，而不是介面標籤。在 dsh 裡還要記住這個套件寫明的限制：shell 指令建立的檔案不會自動出現在 Web Produced Files 橫條裡，所以最後一句要請 agent 回傳規格 JSON 與 HTML 產物在工作區裡的正確路徑。
After delivery, return the exact workspace paths of the specification JSON and the HTML artifact.
產物自己劃了界：執行階段擁有什麼，什麼才算證據。跳到影片 2:13
Mermaid 先畫，要經得起評審時再上 archify
兩者不是對手，而 archify 倉庫對這條邊界說得相當直白。
- ▸Mermaid 就地算繪，成本是一個程式碼區塊：適合隨手就丟的草圖，或者只需讀一遍的時序。
- ▸Mermaid 的產出是一次算繪。你沒辦法點節點、沒辦法沿命名路徑走、沒辦法開啟來源指標，也沒辦法交給別人一份「這個產物可重現」的報告。
- ▸archify 自己就寫著：'Archify is not a general-purpose drawing editor or a Mermaid theme'，而自動解析 Mermaid 被明確列在範圍之外。
- ▸它換來的是另一套交付契約——帶型別的 JSON IR，對 schema、版面、HTML/SVG、路徑與標籤到路徑間距做原子化驗證，檢查不過時給出機器可讀的修正報告。
- ▸一個可行的分工：對話裡那張圖用 Mermaid，要進設計評審、事後檢討或新手文件的那張圖用 archify。
常見問題
這段畫面真正會引出的問題，答案來自倉庫與 npm registry 的實測。
DSH 有官方的架構圖外掛嗎？
沒有。dsh 這條路是社群接入，發布為 @tt-a1i/archify-dsh@0.1.0；它的 README 明說這不是 DeepSeek 官方產品、也不代表 DeepSeek 背書，目標是 developer-preview 的 @deepseek-ai/dsh@0.1.0-rc.6，內建 Archify Skill 2.14.0。另有一個第三方移植 GongYuanCaiJi/dsh-archify，2026 年 8 月出現，自述移植自 tt-a1i/archify。兩者都是同一個 skill 外面的轉接層。
影片裡是 DeepSeek Harness 在跑 archify 嗎？
不是。畫面裡是 GitHub 倉庫頁、archify 官網，以及一個分割畫面的 agent IDE 工作階段，dsh 的 Web 介面從未出現。它能證明的是這個 skill 的產出與作者的工作流，不是一次 dsh 工作階段。本頁所有指令都來自倉庫 README 或 npm registry，均在 2026-09-27 核對。
能把我現有的 Mermaid 圖變成互動式產物嗎？
不能自動完成。倉庫把自動解析 Mermaid 明確列在範圍之外，所以沒有 .mmd 匯入通道。你仍然可以用文字描述同一個系統，讓 agent 據此寫出帶型別的規格。
「validation: 9/9 showcase, 0 errors, 0 warnings」到底證明了什麼？
它證明產物與作者寫的規格一致，並在這四種桌面寬度下通過了內建的 schema、版面、算繪、路徑與標籤到路徑間距檢查——所以這個檔案可重現，也可以放心轉傳。它不證明架構本身是對的：圖來自你或你的來源的描述，而且倉庫自己也說明這類產物不會去探測線上基礎設施。
Archify 的 GitHub 倉庫在哪裡，還在維護嗎？
在 github.com/tt-a1i/archify，Apache-2.0。仍在活躍維護：95,759 stars、6,548 Fork、86 位貢獻者，main 上最後一次提交是 2026-11-10 的 7e45f36，Archify 最新發佈 v3.2.0（2026-10-19），DSH 轉接套件 @tt-a1i/archify-dsh 1.1.0 於 2026-11-08 發佈，截至 2026-11-10 那一週 npm 下載 14,465 次（均為 2026-11-12 核實）。需要打問號的是 DSH 這條路而不是倉庫本身：轉接套件由社群維護，只接受 @deepseek-ai/dsh@0.2.1-rc.2，落後於 npm 上 dsh 的 latest（0.2.2-rc.1）。
相關教學
畫出第一張可驗證的圖之後，往下看這些。
來源與署名
畫面來源：下方署名的這一支 B 站影片，每一步都深層連結到對應秒數。本頁所有指令與數字均在 2026-09-27 對照 github.com/tt-a1i/archify、它的 integrations/deepseek-harness README 與 npm registry 核對；錄影裡的 GitHub 頁面顯示 19.1k stars，因為它是專案更早期錄的。第一次接觸 skill 這種形式？可以看 skill 撰寫指南