LobsterAI：基于 Electron 的开源 AI 助手
LobsterAI：免费、全能的 AI 个人助手
LobsterAI（GitHub 代码仓库: netease-youdao/LobsterAI）是一个开源项目，能将你的桌面变成全天候的智能中心。它采用 Electron、React、TypeScript 和 Anthropic 的 Claude Agent SDK 构建，可实现：
- 生成文档 – Word、PowerPoint、Excel、PDF 以及视频。
- 网络搜索 并实时获取事实。
- 使用 Playwright 自动化浏览器。
- 本地执行或在安全的 Alpine Linux 沙箱中运行任务。
- 通过 cron 语法安排周期性工作流。
- 通过 Telegram、Discord、钉钉、飞书或网易 IM 从手机远程触发工作。
以下是对 LobsterAI 架构、安装、打包以及功能扩展的完整指南。
1. 概览
LobsterAI 的核心是 Cowork 系统——一个轻量级的会话管理器，负责协调基于 Claude 的对话、工具调用以及文件操作。
主要架构组件：
| 层 | 技术 | 说明 |
|---|---|---|
| 前端 | React 18 + Redux Toolkit + Tailwind CSS | UI、用户设置、消息流 |
| 后端 | Electron (Node ≥ 24) | IPC、SQLite 持久化、技能加载器 |
| AI 引擎 | Claude Agent SDK | 处理自然语言请求 |
| 执行 | 本地 Node 或 Alpine VM | 安全沙箱 |
| IM 网关 | Telegram、Discord、钉钉、飞书、网易 IM | 远程指令通道 |
为什么使用 Electron？
Electron 为我们提供了确定性的桌面环境。它将 Node.js 对高 I/O（邮件、数据库）的高速处理与 Chromium 的精美 UI 结合起来。上下文隔离、沙箱和强类型 IPC 保证系统安全。
2. 入门
前置条件
# Node 24 或任何 2025 LTS 都可以。
nvm install 24
# npm >= 10
npm --version
克隆并安装
git clone https://github.com/netease-youdao/LobsterAI.git
cd LobsterAI
npm install
开发模式下运行
npm run electron:dev
程序会在 http://localhost:5175 打开，并弹出 Chromium 窗口。你可以编辑 React 组件并实时热重载。
3. 生产构建
仓库使用 electron-builder。macOS、Windows 和 Linux 的构建目标在 electron-builder.json 中定义。
# TypeScript → 打包
npm run build
# Lint 检查
npm run lint
# 构建
npm run dist
安装包位于 release/ 文件夹中：
| 平台 | 文件 | 安装方式 |
|---|---|---|
| macOS (Intel) | LobsterAI-0.1.21-darwin-x64.dmg |
双击并拖到 Applications |
| macOS (Apple‑Silicon) | ...-arm64.dmg |
同上 |
| Windows (.exe) | ...-win32-x64.exe |
运行并按向导操作 |
| Linux (.AppImage) | ...-linux-x86_64.AppImage |
chmod +x 后执行 |
4. 扩展 LobsterAI — 添加技能
每个技能都是一个轻量级模块，公开 skill.json 架构和可执行的处理器。
- 在
SKILLs/（例如markdown/）下创建一个新文件夹。 - 添加带有名称、描述和
entry点的skill.json。 - 放置 Node 脚本或已编译的二进制文件。
- 在
skills.config.json中启用它。 - 重启程序。
仓库自带 16 个内置技能：web-search、pptx、remotion、playwright、imap-smtp-email 等。可自行克隆并根据需求进行调整。
5. 通过 IM 进行远程控制
LobsterAI 在四个 IM 平台上监听。每个集成都需要你在 设置 → IM 网关中配置令牌/密钥。
一旦令牌存在，应用会暴露一个机器人，接受简单的自然语言命令。例如：
嘘 Lobster，基于最近 10 封邮件生成一份每周总结 PPT。
机器人会进行鉴权、授权，然后生成一个 Cowork 会话，并将结果推送回你的手机。
6. 安全亮点
| 功能 | 描述 |
|---|---|
| 上下文隔离 | 渲染进程不允许访问 Node API |
| 沙箱执行 | 可使用 Alpine VM 运行不安全代码 |
| 权限控制 | 用户必须批准文件或网络操作 |
| 仅磁盘 SQLite | 无外部数据库 |
7. 贡献方式
- Fork → clone。
- 创建功能分支（
git checkout -b feat/new‑skill）。 - 使用规范化提交信息提交（
feat: add markdown skill）。 - Push 后提交 Pull Request。
欢迎提交文档、模板、错误修复。提交前请先运行 npm run lint。
8. 使用场景
| 场景 | LobsterAI 的帮助 |
|---|---|
| 数据分析 | 导入 Excel 文件 → 让 AI 生成洞察和 PPT 图表 |
| 电子邮件整理 | 自动分类收件箱，摘要重要线程 |
| 视频营销 | 输入脚本 → 以秒级速度生成 Remotion 视频 |
| 每日新闻摘要 | 计划周期性任务抓取科技站点并通过邮件发送摘要 |
| 远程工作 | 通过 Telegram 等 IM 进行快速指令控制 |
9. 结论
LobsterAI 展示了在开源工具上构建全功能 AI 个人助手的可能性。从本地文件操作到远程调度，它涵盖了日常生产力任务的全链路。凭借稳健架构、沙箱执行与手机友好的 IM 控制，它已准备好满足业余爱好者的实验需求与企业级部署需求。
快来尝试吧，Fork 代码仓库，开启你自己的 AI 工作流吧！