前言¶
接手一個陌生倉庫時，往往先看目錄樹，再找入口文件，然後靠註釋和 README 拼出架構印象。這種人工讀碼的方式在小型項目裏夠用，面對中大型項目時問題就顯現了：架構設計是否清晰、技術棧選型是否合理、安全與性能這類特殊設計有沒有落到位，往往只能靠經驗和零散記憶。
下面介紹的架構可視化分析（architecture-visualization-analysis）Skill，做的就是這件事：以系統架構設計師的視角，對指定項目做六維深度分析，再通過雙渲染引擎把結果輸出成一張可交互的單文件 HTML。它的價值不在於”畫圖”，而在於把架構判斷結構化、可追溯、可交付。
這是什麼¶
架構可視化分析是一個項目架構分析與可視化產物生成 Skill，座標 @user_989eb8f0/tri-html，版本 1.5.0，來源 community，分類 dev-programming，由 user_989eb8f0 發佈維護，官方地址爲 https://www.skillhub.cn/skills/user_989eb8f0/tri-html。
它面向一個具體問題：如何把一個項目的架構設計（而不是代碼實現細節）系統化地講清楚，併產出一個能直接交付的可視化產物。輸入是項目路徑（默認當前項目），輸出是一份單文件 HTML，中間經過六維分析、結構化診斷與修復回執。
核心功能¶
六維架構分析¶
分析視角固定爲六維：架構設計、目錄結構、技術棧選型、代碼設計、功能設計、特殊設計（安全/性能等）。這一步先對項目做全面深度掃描，再進入可視化生成，避免只畫目錄樹就當架構圖。
雙渲染引擎¶
產物由兩條渲染通道生成：
- 高精度 viewer 引擎：以 Typed JSON IR 爲中間表示，經過確定性校驗的 showcase 門禁後，生成單文件交互 HTML，包含五類視圖：架構圖、工作流、時序圖、數據流、生命週期。交互能力包括深淺主題、聚焦、路徑探查、角色透鏡、故事播放，導出格式支持 PNG、SVG、WebM。
- Mermaid 兼容模式：生成目錄樹、類圖、ER 圖、旅程圖，適配已有 Mermaid 渲染鏈路的環境。
showcase 門禁與結構化診斷回執¶
viewer 引擎在渲染前經過確定性校驗的 showcase 門禁，即產物必須先滿足客觀門檻才能輸出，而不是渲染出來再看效果。診斷結果以結構化回執形式給出修復建議，最多兩輪。
上游依賴檢測與引擎降級鏈¶
內置上游依賴檢測的三態邏輯，以及渲染引擎的 Node 探測降級鏈：環境探測到不同條件時按既定鏈路選擇渲染方式，減少”裝完跑不起來”的情況。
受控語言模式與解說視頻選項¶
1.4.0 起新增受控語言模式與解說視頻可選項，解說視頻默認關閉。受控語言模式對標 ASD-STE100 風格，1.5.0 起默認 lite 檔，並修正了句長計數校準缺陷。
安裝與啓用¶
官方資料未給出可直接執行的安裝命令與配置文件字段。可確認的信息如下：
- 座標：
@user_989eb8f0/tri-html，支持獨立安裝。 - 激活方式：當上遊路由建議指向本 skill（L2=I10、L3=arch-viz）時激活，也可在支持通用 SKILL.md 格式的 Agent（Cursor、Codex CLI、Claude Code 等）中按座標安裝後手動調用。
- 上游依賴檢測爲三態邏輯，渲染引擎帶 Node 探測降級鏈，安裝後首次運行會按探測結果決定渲染通道，無需手動指定。
具體安裝命令與目錄佈局，請以官方頁面 https://www.skillhub.cn/skills/user_989eb8f0/tri-html 爲準。
典型用法¶
官方資料給出的最簡調用是直接指定項目路徑（默認當前項目）：
/architecture-visualization-analysis
或顯式傳入路徑：
/architecture-visualization-analysis /path/to/project
流程上，Skill 會先完成六維分析，再進入雙引擎渲染，輸出單文件 HTML。診斷階段給出結構化回執，回執在兩輪後結束，不再無限追問。
適用場景與注意¶
適合：接手陌生項目需要快速建立架構全貌、需要向團隊或評審交付一份可交互架構文檔、需要把架構設計判斷結構化留檔。
注意：
- 輸出是架構設計視角的分析產物，不是代碼文檔生成器，實現細節以架構層級爲邊界。
- 受控語言模式默認 lite 檔，措辭受限於 ASD-STE100 風格對齊，若需要自由措辭需確認該模式的檔位設置。
- 解說視頻默認關閉，如需開啓須顯式指定。
- 上游依賴與 Node 探測降級是自動鏈路，遇到渲染異常時先確認運行環境是否滿足探測前置條件，而不是先改產物。
結語¶
架構可視化分析把”架構圖”從人工畫圖變成了六維分析 + 雙引擎渲染的確定性流程，產物是單文件 HTML，可直接交付。它的定位是下游執行 Skill，銜接上游路由建議（L2=I10、L3=arch-viz），不是獨立架構諮詢工具。
官方地址：https://www.skillhub.cn/skills/user_989eb8f0/tri-html
本文事實均依據 Skill 官方頁面資料（版本 1.5.0），未包含未經覈實的用戶反饋與額外數據。
