limecloud/lime · 上手攻略
- 仓库：limecloud/lime
- 链接：https://github.com/limecloud/lime
- 分类：AI Agent
- 作者：Jay
- 更新：2026-10-04
是什么
Lime 是一个开源全栈 AI Agent，同时提供桌面 GUI（Electron）和 CLI/TUI 两种界面。它把 Agent 循环、文件系统、终端进程、代码编辑、工具调用、MCP 扩展、Skill 机制、多模态输入输出、模型路由和多 Agent 协作，整合到一条可追踪的任务链（Thread）中。
定位上与 Claude Code、WorkBuddy、Codex 属于同一类"动手型 Agent"，但更强调桌面 GUI 可视化工作区、可配置 Provider（不锁定模型商），以及工程 / 研究 / 内容混合工作流。支持平台：macOS（arm64/x64）、Windows（x64）、Linux（仅 CLI/TUI，桌面版暂停）。
解决什么问题
需要真正能执行任务的 AI Agent，而不只是返回一段文字。Lime 解决以下痛点：
- 代码执行：普通 Chat 只能建议代码，Lime 可以读取文件、改代码、跑测试、展示 diff。
- 上下文保持：每次对话独立割裂，Lime 用 Thread 模型让任务可暂停、可恢复、可审查。
- 多工具协同：文件系统、终端、Skill、MCP 工具在一个 Agent 会话里按需调用。
- 多模态工作流：文本、代码、图片、音频、视频、PDF、表格混合输入输出，不需要切换工具。
- 多 Agent 协作：复杂任务可分发给不同 Agent 子线程，主 Thread 保持共享上下文和审核边界。
快速安装
Desktop（Electron）macOS / Windows
方式一：直接下载安装包
到 Releases 下载对应平台安装包：
- macOS：Lime_*_darwin_*.dmg
- Windows：Lime_*_x64-setup.exe
⚠️ Windows 若出现 SmartScreen 提示，通常是因为安装包未签名，不代表安装包损坏。
方式二：Homebrew（macOS）
brew tap aiclientproxy/tap
brew install --cask lime
⚠️ Linux Desktop 版目前暂停发布，Linux 用户请用 CLI/TUI 模式。
CLI/TUI（全平台）
要求：Node.js ≥ 18
npm install -g @limecloud/lime
lime --version
启动交互式 TUI：
lime # 等同于 lime tui
单次非交互式执行：
lime exec "review this diff"
lime exec --json "review this diff"
远程 App Server 连接
本地命令自动启动配套的 app-server。如需连接远程 App Server：
lime exec \
--remote wss://cloud.example/rpc \
--remote-auth-token-env LIME_REMOTE_TOKEN \
"review this diff"
核心用法
Desktop 首次运行流程
- 打开 Desktop App（或运行
lime启动 CLI/TUI），在 Provider 设置中配置模型服务商和凭证。 - 选择工作区（项目目录），授予文件和终端操作权限。
- 创建 Agent Thread，填写目标、约束条件和验收标准。
- 先让 Agent 输出计划，批准后再执行文件修改、命令或外部工具调用。
- 审查 diff、测试结果和产物；继续任务或关闭。
CLI/TUI 典型工作流
# 交互式对话
lime
# 一次性任务（单行）
lime exec "explain this error: Cannot read property 'map' of undefined"
# 指定线程继续工作（线程 ID 可从历史记录获取）
lime exec --thread <THREAD_ID> "continue fixing the test suite"
MCP 工具集成
Lime 支持通过 MCP（Model Context Protocol）调用外部工具。在 Provider 配置中添加 MCP Server 地址和凭证后，Agent 可动态发现并调用这些工具，无需额外配置。
Skill 机制
将重复性流程（如发布步骤、检查规则、团队规范）编码为 Skill，Agent 可以在会话中主动发现和调用它们，比每次在 Prompt 里重复描述更高效。
典型适用场景
| 场景 | 适用方式 | 说明 |
|---|---|---|
| Bug 修复 | Desktop / CLI | Agent 读取代码和配置，追踪调用路径，提出修复方案并展示 diff |
| 全栈功能开发 | Desktop | 跨越前端、后端、协议、测试并行执行，按依赖顺序推进 |
| 内容调研报告 | Desktop | 导入参考资料、截图、会议记录，Agent 结构化整理并产出报告 |
| CI / 服务器自动化 | CLI/TUI | SSH 会话或脚本中调用 lime exec 执行非交互式任务 |
| 团队知识编码 | Desktop | 将团队规范和检查流程固化为 Skill，Agent 按规则执行 |
坑与注意
- Lime 不提供模型服务：需要自行配置 Provider（OpenAI、Anthropic、DeepSeek 等），模型费用按各服务商标准收取。
- 文件 / 终端权限需主动授权：首次使用需要明确授予工作区目录读写和命令执行权限，高风险操作会暂停等待审批。
- 数据本地优先：项目材料、对话历史和配置默认保存在本地，但模型调用数据会发送到配置的 Provider，需遵守对应服务商的隐私政策。
- Linux Desktop 暂停：目前仅支持 macOS 和 Windows 的桌面版，Linux 用户只能使用 CLI/TUI。
- 未签名安装包（Windows）：Windows 安装包未经代码签名，下载后建议核对 Release 页面提供的 SHA256 校验和。
- 上游快速迭代：DeepSeek Harness 等官方项目破坏性变更频繁，Lime Agent 内核跟随上游更新，可能出现不兼容变更。
与同类对比
| 维度 | Lime | Claude Code | Codex | WorkBuddy |
|---|---|---|---|---|
| 界面 | Desktop + CLI/TUI | CLI 为主 | CLI/API | Desktop |
| 模型绑定 | 不锁定（可配置 Provider） | Anthropic | OpenAI | 不锁定 |
| 多 Agent | 支持（多子线程） | 单 Agent | 单 Agent | 支持 |
| Skill 机制 | 支持 | 不支持 | 不支持 | 支持 |
| MCP 扩展 | 支持 | 有限 | 有限 | 支持 |
| 多模态 | 核心特性 | 有限 | 有限 | 中等 |
| 许可证 | GPLv3 | 自有 | 自有 | 自有 |
| 平台覆盖 | macOS/Win/Linux(CLI) | macOS/Linux | macOS/Linux | 多平台 |
Lime 的差异化优势：同时具备桌面 GUI 可视化和 CLI/TUI 灵活性，不绑定模型商，内置 Skill + MCP 扩展体系，适合需要"既有 Agent 执行力、又有可视化审查体验"的团队用户。
一句话推荐结论
Lime 是一款开源全栈 AI Agent，桌面 GUI + CLI/TUI 双界面、不锁定模型商、内置 Skill/MCP 扩展，适合需要真正完成任务（而非只生成建议）的工程团队和研究人员。Linux 用户目前只能用 CLI/TUI，Windows 用户注意未签名安装包的校验问题。