MCP

ArchLang 平面圖 DSL 與編譯器：適合誰、3 分鐘首用與使用邊界

ArchLang 最適合把平面圖寫成 .arch 源碼（可交給 AI agent 代寫）並編譯成 SVG/DXF/PDF，配合 lint 與幾何校驗；前提是本機能以 npx 執行 @chanmeng666/archlang，首次可先用 context 子命令一次取回整套語言說明，而 compile 會在本機寫出產物檔案。

官方來源 · ArchLang

安裝

npx -y skills add ChanMeng666/archlang --yes

適合誰

  • 最適合兩類人：一是想讓智慧代理代寫平面圖源碼、再編譯成圖的人，官方定位就是「寫 .arch 源碼，或讓 AI agent 代寫」；二是需要快速取得 SVG、DXF 或 PDF 格式平面圖，並用 lint 與幾何校驗為源碼把關的人。
  • 也適合把圖面檢查放進腳本的人：describe 與 validate 都支援 --json 輸出，便於以程式判斷源碼狀態。
  • 它把平面圖當作程式碼來維護：原始檔是純文字，佈局描述可重現、可比對，也方便交給智慧代理修改；編譯產物則是向量或文件格式的圖面檔案。
  • 使用前提：官方指令全部透過 npx 執行 npm 套件，本機要能執行 npx；主安裝路徑面向 coding agent 的 skills，不接入 MCP 客戶端也能直接在終端機執行命令列子命令。
  • 不適合與未知：證據裡沒有視覺化編輯、拖曳作圖的能力，想所見即所得畫圖的人不適合；.arch 的語法範例未出現在證據裡，第一份原始檔要自己寫或交給智慧代理寫；正式工程圖面的精度與規範符合性、支援的作業系統與授權條款，證據均未說明。

3 分鐘完成第一次嘗試

主路徑只有一條：skills 安裝，四步走完。

  1. 前提：終端機可用 npx；官方指令本身不含金鑰或帳號參數，不必先準備憑證。是否還需要其他環境設定，證據未說明。
  2. 安裝：執行 npx -y skills add ChanMeng666/archlang --yes，把本儲存庫的 skills 裝給你的 coding agent。
  3. 低成本首試：執行 npx -y @chanmeng666/archlang context。官方對它的定位是「一次呼叫給出整套 ArchLang 語言」，智慧代理不必預先載入語言知識。成功訊號：終端機印出語言說明。該指令是否存取網路及其他讀寫細節，證據未說明。
  4. 拿到第一個產物：準備一份 plan.arch 後執行 npx -y @chanmeng666/archlang compile plan.arch -o plan.svg --json，成功訊號是在本機產生 plan.svg，並輸出 JSON 狀態。注意 compile 會寫入本機檔案，屬於本機寫入、不是唯讀操作，建議放在確認原始檔內容之後。

次要說明（另一條官方路徑，不與主路徑並列）：MCP 客戶端可執行 claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp，以 npx 啟動獨立的 npm 套件 @chanmeng666/archlang-mcp，註冊名為 archlang 的伺服器；該伺服器註冊後暴露哪些 MCP 工具，證據未說明。

使用案例

案例一：先查再編。情境：手頭已有 plan.arch，想在出圖前確認內容可靠。做法：先執行 describe plan.arch --json 查看結構描述，再執行 validate plan.arch --strict --json 做嚴格校驗，兩者與 compile 是同一命令前綴；按校驗結果修正源碼後重新編譯，官方給出的工作流程正是修復後重編。可期待的結果：JSON 格式的描述與校驗結果，幾何問題在編譯成圖之前暴露。兩條指令都帶 --json，適合接進腳本作為編譯前的前置檢查；校驗輸出的具體欄位結構，證據未給出。

案例二：讓智慧代理代寫圖面。情境：不熟悉 .arch 語法，想把源碼交給智慧代理完成。做法：先執行 npx -y @chanmeng666/archlang context，把整套語言一次性交給智慧代理，官方明確說明這樣無需預載語言知識；再讓智慧代理產出 .arch 源碼，最後用 compile 指令編譯出圖。源碼由智慧代理產出，編譯與校驗仍由本機指令完成。可期待的結果：拿到源碼與第一張 plan.svg。專案定位支援輸出 SVG、DXF 或 PDF，但逐字可複製的編譯指令證據只有 SVG 一例，DXF 與 PDF 的確切輸出參數未確認，不要自行類推。

使用邊界

  • 讀寫性質：compile 讀取 plan.arch、按 -o 在本機寫出 plan.svg，是明確的本機寫入；describe、validate、context 未被官方標註為唯讀工具，context 僅被描述為輸出語言說明，其餘讀寫細節證據未說明。
  • 憑證與設定：上述官方指令均未包含金鑰、權杖等憑證參數，也沒有出現姓名、信箱之類的必填資訊；是否存在額外的環境設定要求，證據未說明。
  • 路徑區分：本文的首次嘗試基於命令列子命令與 skills 安裝；若目標是讓 MCP 客戶端裡的智慧代理呼叫，需另行執行註冊指令，兩條路徑安裝的內容與前提不同。
  • 副作用與確認點：compile 會寫入本機檔案，執行前確認輸出路徑；官方未提供撤銷路徑說明，因此不應把它稱作「可撤銷」。skills 安裝具體寫入哪些位置，證據未說明。
  • 兩個製品彼此獨立：skills 安裝面向智慧代理的技能包；claude mcp add 註冊的是另一個 npm 套件。兩者關係、能否只裝其一，證據未說明。
  • 授權條款、支援平台、網路行為與資料邊界未在證據中出現；「未找到說明」不等於沒有風險，本文不作獨立安全結論。