跳轉到主要內容

​
概覽

CLI（command-line interface，命令列介面）是透過命令執行的工具，而不是透過按鈕操作。很多服務都會提供 CLI，讓使用者用程式化方式管理程式碼倉庫、文件、部署、日誌和工作區資料。 在 Happycapy 中，你不需要記住這些命令。直接用自然語言描述你想完成什麼，Happycapy 可以安裝 CLI、選擇合適的命令、在沙箱中執行、讀取輸出，並在同一個專案裡繼續後續工作。 CLI 可能連接 GitHub、Notion、Lark、Fly.io 這類外部服務，也可能只是處理沙箱中文件、程式碼、媒體或資料的本機工具。

​
什麼時候用 CLI 工具

當某個服務把有用的操作提供為命令時，就適合用 CLI 工具：
  • 處理程式碼倉庫、Pull Request、Issue、日誌和部署
  • 讀取或更新 Notion、Lark 這類工作區系統
  • 執行雲端服務、資料庫或基礎設施命令
  • 把可重複的命令列工作變成專案工作流程

​
CLI 還是 MCP？

CLI 和 MCP 在 Happycapy 裡的使用體驗可能很像：你都可以用自然語言說明目標，讓智慧體判斷需要呼叫哪些工具或寫哪些命令。 差別主要在連接方式。CLI 工具是 Happycapy 在沙箱裡寫並執行命令列程式；MCP 是 Happycapy 呼叫 MCP 伺服器提供的工具能力。 如果某個服務有維護良好的官方 CLI，或者任務涉及部署、日誌、腳本、文件處理、一次性設定，CLI 往往更直接。如果某個服務有維護良好的 MCP 伺服器，或者你希望工具動作透過更結構化的介面提供給智慧體，MCP 可能更合適。如果兩者都支援，優先選擇官方維護、權限清楚、設定最簡單的方式。

​
開始前準備

最好先提供這些資訊：
  • 官方 CLI 名稱或安裝連結
  • 要連接的帳號、工作區、程式碼倉庫或應用程式
  • 需要的認證方式，例如登入流程、token、API key 或工作區權限
  • 設定完成後希望 Happycapy 完成的結果

​
第一次使用

把工具和目標一起告訴 Happycapy： 
在 Happycapy 沙箱中安裝 [CLI 名稱]。
繼續之前，先告訴我需要哪種認證。
準備好之後，用它完成 [目標]。

CLI 連結：[官方連結]

​
推薦 CLI

這些 CLI 很適合在 Happycapy 沙箱中使用，因為它們把真實工作系統提供為命令，智慧體可以安裝、設定並執行。
https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/github.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=679bb093797d36e654af372f853a460a

GitHub CLI

處理程式碼倉庫、Pull Request、Issue 和 GitHub Actions。
https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/notion.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=534c589e6711180fe51fa3b632720e51

ntn

搜尋 Notion 頁面、建立內容、查詢資料庫。
https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/lark.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=adc21fbe2f882fafdd5006135fb05128

lark-cli

處理 Lark/飛書訊息、文件、表格、日曆、任務、郵件和會議。
https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/flyio.svg?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=d9342a993c06f2170919e5f5a526a3d3

flyctl

部署和維運 Fly.io 應用程式、Machines、日誌、密鑰和發布記錄。

​
範例工作流

使用 GitHub CLI。
查看這個程式碼倉庫最近一次失敗的 GitHub Actions 執行記錄。
總結失敗原因，並給出最小修復建議。

使用 ntn。
在我們的 Notion 工作區裡搜尋入門文件。
總結目前流程，並列出缺口。

使用 lark-cli。
從 Lark 文件收集本週專案更新。
整理成一份簡短團隊報告。

使用 flyctl。
檢查這個 Fly.io 應用程式的狀態和最近日誌。
告訴我最新部署是否健康。

​
認證和權限

  • 先說明 CLI 要連接的帳號、工作區、程式碼倉庫或專案。
  • 盡量不要把密鑰寫進提示詞。優先使用 CLI 自己的正常認證流程。
  • 在批准認證前，可以讓 Happycapy 說明它需要哪些權限。
  • 如果使用 token，服務支援的話優先使用限定權限的 token 或短期 token。
  • 對於有破壞性的操作，可以先讓 Happycapy 展示命令和預期影響，再執行。

​
故障排查

​
CLI 無法安裝

提供官方安裝連結，並讓 Happycapy 檢查沙箱環境、套件管理器和平台要求。

​
登入失敗

確認 CLI 需要的是瀏覽器登入、token 登入、工作區授權，還是環境變數。

​
權限不足

讓 Happycapy 說明缺少哪個權限，以及是否需要換 token、角色、工作區、程式碼倉庫或組織。

​
輸出太寬泛

用程式碼倉庫、專案、日期範圍、文件路徑、應用程式名稱或命令目標縮小範圍。

​
下一步

  • 想了解另一種工具連接方式，可以繼續看 MCP。MCP 和 CLI 的使用體驗相近，但底層是呼叫 MCP 伺服器提供的工具，而不是在沙箱裡執行命令列程式。
  • 當同一個 CLI 工作流程需要按計劃重複執行時，使用 Automations。