Solarch 教學：繁中完整上手指南（功能、免費版、實測）

透過這篇 Solarch 教學，你會學到如何從零開始建立後端架構圖，並利用規則引擎即時驗證、生成 NestJS 程式碼——開發流程從「手寫樣板程式碼」變成「架構驅動開發」。Solarch 的思路和多數 AI 編碼工具相反：不是讓 AI 先生成程式碼再回頭修架構，而是先由規則引擎確立架構，AI 只負責填補邏輯細節。

Solarch 是什麼？核心概念與價值

Solarch 是一款專為後端架構設計的工具，核心賣點是「架構優先」（architecture-first）。多數 AI 編碼工具直接輸出程式碼片段，Solarch 反其道而行，要求你先用節點（node）與邊（edge）畫出系統架構圖。

打開 Solarch 的畫布，你會看到官方稱之為 live node/edge canvas 的即時編輯介面。你可以拖曳代表 Controller、Service、Repository、Table 等角色的節點，並連接它們的關係。這一步的關鍵在於官方所稱的 Rules Engine（規則引擎）：採用「default-deny」（預設拒絕）機制，一旦你嘗試連接兩個不合法的節點，系統會立刻擋下並提示錯誤。畫布上的架構圖在生成程式碼之前，就已經被規則引擎檢查過一輪。

這解決的是一個很實際的問題：AI 生成的程式碼常常缺乏整體架構的一致性，維護成本因此墊高。Solarch 的做法是把順序反過來——先確保架構正確，AI 才負責填補函式內容（官方稱為「surgical AI fills the bodies」）。AI 提出架構建議，規則引擎驗證，只有通過驗證的圖才會真正落地到畫布上。

根據官方說明，Solarch 支援 21 種節點類型（分屬 8 大家族）與 16 種邊關係，並具備分形圖（fractal graph）縮放功能，可以從宏觀模組一路放大到微觀節點細節。對於需要快速搭建 NestJS 專案的團隊，Solarch 提供了一條把「意圖」直接轉成「可運行架構與程式碼」的路徑，省去空白畫布的猶豫，也省去重複寫樣板程式碼的時間。

事前準備：環境與帳號設定

開始 Solarch 教學 之前，先確認環境相容性。官方提供的開發介面包括 VS Code Extension、CLI、MCP Server。多數開發者會從安裝 VS Code 擴充功能開始。

系統需求與瀏覽器相容性

支援的平台與系統需求請以官網最新公告為準。若你打算透過 CLI 或 VS Code 擴充功能做本地開發，需要先安裝 Node.js 環境以執行生成指令。實際硬體需求以官方網站為準。

帳號設定與試用方案

方案與定價細節請以官方網站最新公告為準。

註冊流程大致如下：

1. 前往 Solarch 官方網站。
2. 點擊「Try Now」或註冊按鈕。
3. 輸入電子郵件建立帳號。
4. 完成初始設定，進入開發環境。

Solarch 的介面目前以英文為主。若你在尋找「Solarch 中文」介面，建議先熟悉核心英文術語（如 Node Schemas、Edge Taxonomy），這些詞彙在國際開發社群中本來就是通用語言，不會構成太大障礙。

Step 1：安裝與基本介面操作

完成帳號設定後，進入 Solarch 教學 的核心步驟。多數人會選擇透過 VS Code Extension 開發，因為它能做到架構與程式碼的雙向同步。

安裝步驟

1. 開啟 VS Code。
2. 進入擴充功能市集。
3. 搜尋「Solarch」。
4. 安裝官方提供的擴充功能。
5. 安裝完成後，側邊欄會出現 Solarch 圖示，點擊進入。
6. 登入帳號，系統會自動同步雲端專案。

如果你偏好命令列，Solarch 也提供 CLI 工具，可透過官方文件說明的方式安裝，再依官方文件指示建立專案。CLI 具備官方稱為「drift guard」的機制，能檢查本地程式碼與雲端架構圖是否一致。

介面導覽

進入主畫布後，你會看到一片空白的 Canvas，這是操作的起點。介面分成三個區域：

節點面板位於左側，列出所有可用的節點類型，依官方分類共 8 大家族。中央是畫布區域，用來繪製架構圖。右側是屬性面板，用來設定節點的細部參數。

操作方式很直覺：從左側面板把節點拖進畫布；點擊節點上的連接點並拖曳到另一個節點，系統會即時驗證這條連線是否合法，非法連線會被自動擋下並顯示錯誤；用滑鼠滾輪縮放、按住中鍵平移。分形圖功能讓你能從宏觀模組一路縮放進某個模組內部，查看細節節點。

與其急著生成程式碼，不如先利用 default-deny 規則驗證機制，摸熟正確的架構模式——這一步比直接生成程式碼更有學習價值。

Step 2：第一個實作範例：從零開始

進入實作階段，建立你的第一個專案，看 Solarch 如何把想法轉成實際的 NestJS 專案結構。

建立第一個專案

1. 啟動專案：在畫布上點擊「Create Project」，或輸入指令建立新專案。
2. 定義模組：假設要建立一個簡單電商系統，包含訂單（Orders）、支付（Payments）、使用者（Users）三個模組。
3. 繪製架構：

• 拖曳一個 Module 節點，命名為 "Orders"。
• 在 "Orders" 內拖曳 Controller 節點，命名為 "OrderController"。
• 拖曳 Service 節點，命名為 "OrderService"。
• 拖曳 Repository 節點，命名為 "OrderRepository"。
• 拖曳 Table 節點，命名為 "OrderTable"。

1. 建立連線：

• OrderController 連到 OrderService（HTTP 請求進入 Service 層）。
• OrderService 連到 OrderRepository（業務邏輯呼叫資料庫操作）。
• OrderRepository 連到 OrderTable（資料存取層）。

1. 驗證規則：試著把 OrderController 直接連到 OrderTable。系統會拒絕，因為這違反分層架構的基本邏輯——這正是 Rules Engine 該做的事。

預期結果

點擊「Generate Code」或「Push to Code」後，Solarch 會依畫布上的節點與連線，自動生成標準 NestJS 專案結構，包含 order.controller.ts、order.service.ts、order.repository.ts 等檔案。AI 不會生成整個專案的邏輯，只負責填補函式體內的具體實作，例如基本的 CRUD 方法。透過 VS Code 擴充功能，這些檔案會直接同步到你的本地專案資料夾。

最明顯的效果是架構一致性。傳統開發得手動建目錄、手動寫 import，Solarch 確保所有檔案的命名、路徑、依賴關係都跟架構圖完全對應。目前 Solarch 主要輸出 NestJS 專案；若你用的是 Express 或 Fastify 等其他框架，是否支援請以官方文件為準。

Step 3：進階技巧與最佳實踐

熟悉基本操作後，可以往效率更高的方向走。Solarch 不只是繪圖工具，而是一整套開發環境。

Agent Instruct：Solarch 提供一個 Omni-bar（全能指令列），可以直接輸入自然語言指令，例如「建立一個包含 Auth 和 Billing 模組的專案」。AI 代理會解析指令並自動畫出對應模組與節點，再即時驗證合法性，比手動拖拉節點快得多。

Vector Export：可以把架構圖匯出成官方所稱「AI 可讀取的記憶格式」，作為上下文提供給 Cursor、Claude 等其他 AI 工具，讓它們在生成程式碼時理解整體架構，而不只是看到局部片段。

Autonomous QA：官方稱內建 red team 與 smart seeding 機制，能對架構做壓力測試與邏輯檢查，有助於在部署前抓出架構性錯誤。

常見陷阱

不要過度依賴 AI 生成——AI 只負責填補函式內容，核心業務邏輯仍需要你自己寫，它給的是骨架和標準化程式碼，不是完整的商業邏輯。

不要試圖繞過規則驗證。Solarch 的設計哲學是 default-deny，硬改架構圖可能導致生成的程式碼根本跑不起來，遇到錯誤提示就該照著修正，而不是想辦法閃過去。

注意版本同步問題。用 CLI 時，如果本地程式碼跟雲端架構圖不一致，系統會用「drift guard」提示。定期同步，或透過 VS Code 的 Push/Pull 按鈕保持同步，避免資料遺失。

官方另外提供 MCP Server，讓 AI 代理能在架構上下文中進行規則檢查的寫入操作。進階使用者可以研究如何把 Solarch 整合進 CI/CD 流程，朝架構即程式碼的自動化部署方向走。

常見問題 FAQ

Solarch 免費版有哪些限制？

方案與功能細節（含是否提供免費版、額度限制等）請以官方網站最新公告為準。

如何解決中文顯示問題？

Solarch 目前介面以英文為主，尚未完全本地化。如果你不熟悉英文術語，可以搭配瀏覽器翻譯功能輔助閱讀，同時把 Node、Edge、Controller、Service 這幾個核心詞彙記熟——這些是國際開發社群共通的說法，用久了自然不會構成障礙。

Solarch 與其他 AI 編碼工具相比優勢何在？

多數 AI 編碼工具是「程式碼優先」，先生成程式碼、架構品質事後補救，容易讓系統結構越改越亂。Solarch 反過來走「架構優先」路線：畫布上的每一條連線都先經過 Rules Engine 的 default-deny 驗證，不合法的連線當場被擋下，確保生成的程式碼在架構層面就是乾淨的。此外，Solarch 同時提供 VS Code Extension、CLI、MCP Server 三種介面，可以直接嵌進既有的開發流程，而不是另立一套獨立工具鏈。

下一步：開啟你的架構驅動開發之旅

這篇 Solarch 教學 走完了從帳號設定、安裝到建立第一個專案的完整流程。Solarch 的核心主張很清楚：與其追求程式碼生成的數量，不如先把架構的嚴謹性顧好。

建議直接動手建一個小專案，體會從畫圖到生成程式碼的完整過程。至於方案內容與更進階的功能規劃，請以 Solarch 官網最新的頁面為準。

打開 VS Code，安裝 Solarch 擴充功能，開始畫你的下一個系統架構圖。

免責聲明：本文依官方公開資料整理撰寫，非合作推廣。工具品質與安全性請讀者自行評估，使用前建議查證官方最新資訊。