跳转到主要内容

​
概览

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。