為什麼需要插件化架構?
隨著專案技術棧的多樣化,AI 助手需要應對的場景也越來越多。例如,在工業自動化專案中,AI 需要懂得如何控制 PLC 或進行影像處理;而在雲端原生專案中,它需要懂得 Kubernetes 編排與 AWS 配置。
如果將所有這些特定領域的知識與工具(MCP 伺服器、提示詞模板、自適應修正規則)都強行塞入 OMC 核心包中,會導致核心包極度臃腫,且難以維護。
Oh My Claude Code (OMC) 實作了靈活的 外掛系統 (Plugin Architecture),允許開發者與社群動態下載、安裝與載入第三方「技能外掛」,實現按需擴充。
插件載入與註冊機制
OMC 外掛本質上是一個符合標準 CommonJS/ESM 規範的 NPM 套件,其內部包含了特定的 mcpServers 配置、ADR 模板以及專屬的 Sisyphus 修復規則。
┌──────────────────────┐ /plugin install ┌──────────────────────┐
│ NPM / Git Repo ├────────────────────▶│ OMC Local Sandbox │
│ (OMC-Plugin-PLC) │ │ (.omc/plugins/) │
└──────────────────────┘ └──────────┬───────────┘
│ 動態掛載與解析
▼
┌──────────────────────┐ API 呼叫擴充 ┌──────────────────────┐
│ Claude Code MCP │◀────────────────────┤ OMC Runtime │
│ New Tools Available│ │ Orchestrator │
└──────────────────────┘ └──────────────────────┘
外掛安裝生命週期:
- 安全沙箱下載 (Sandbox Downloader):
使用/plugin install <git-url>或 NPM 安裝外掛。OMC 會將其下載至隱藏的.omc/plugins/目錄中,並進行程式碼安全審查,防止惡意指令注入。 - MCP 工具動態掛載:
OMC 執行期會自動掃描外掛目錄下的plugin.json,將外掛宣告的外部 MCP 伺服器動態註冊到 Claude Code 的全域設定中。 - 注入 Sisyphus 自修復規則:
外掛可以自訂編譯錯誤碼的 regex 與修復策略(例如:針對 C# 的 CS0246 錯誤提供特定的修復提示),使 Sisyphus 引擎具備更強大的特定語言除錯能力。
插件管理實戰指令
在 OMC 終端機中,您可以使用以下指令管理外掛:
- 列出已安裝外掛:
/plugin list - 從 GitHub 安裝特定外掛(如 PLC 控制外掛):
/plugin install https://github.com/DeusData/omc-plugin-plc - 解除安裝外掛:
/plugin remove omc-plugin-plc
外掛化架構使 OMC 能夠保持核心的極度輕量,同時又具備無限的擴展可能,讓 AI 助手能隨時變身為特定領域的專家。