Linggen Vibe 项目

项目简介

Linggen（灵根）是一款本地优先的 AI Agent 平台，同时提供 macOS 应用和 iPhone 伴侣 App。其核心理念是将 AI 智能体的运行引擎、用户数据存储和推理能力完全留在用户自有设备上，而非云端服务器。平台命名取自"灵根"——中国传统文化中指代天赋与根基的概念，寓意这套系统是 AI Agent 成长的根本。

Linggen 的最大特色是"本地优先 + 开源自举"：运行引擎完全开源，数据不上云，用户可自由选择使用本地 Ollama 模型、已有的 ChatGPT 订阅，或第三方 API Key。目前在 GitHub 上有独立的开源代码仓库，同时在 App Store 提供 iOS 应用，在官网提供 macOS 安装包。

核心功能

Linggen 平台由四大模块组成，共同构成一套完整的本地 AI 工作站：

Yinyue（银月）— 设备伴侣

银月是 Linggen 内置的数字伴侣形象，基于 VRM 虚拟形象技术呈现。她运行在 Mac 和 iPhone 两端，负责与用户进行自然语言对话、记忆跨会话上下文，并在重要事件发生时主动通知用户。在 iPhone 上，银月直接处理个人事务（播放音乐、查看消费、清理照片），技术性工作则转交给 Mac 上的 Ling 智能体处理。

DJ 模块 — 音乐管理

DJ 模块负责管理用户音乐库，支持从 Mac 同步音乐到 iPhone 并离线播放。亮点功能包括卡拉 OK 歌词实时显示、CarPlay 实时歌词，以及跨设备的播放列表管理。用户可通过自然语言指令让银月播放特定风格的音乐，或将指定歌单同步到手机。

CFO 模块 — 私人财务

CFO 模块接管个人财务分析，用户只需将银行账单 PDF 导入应用，无需绑定银行账户即可自动解析交易记录、生成预算追踪和消费趋势报告。整个过程不经过任何服务器，账单文件仅在本地处理，严格保护财务隐私。

Shifu 模块 — 设备健康

Shifu 负责 iPhone 和 Mac 的存储健康、照片清理和空间回收工作。它会扫描重复照片、模糊照片和屏幕截图，按时间线展示可清理的空间，并给出具体的清理建议。所有删除操作均需系统确认确认，数据不会静默消失。

技术实现

Linggen 的技术架构围绕"本地优先"和"开放标准"两个核心原则设计。

运行时引擎

底层 ling 引擎以 CLI 形式运行，支持 macOS（Apple Silicon + Intel）和 Linux。它以 Web UI 形式提供控制面板（默认 localhost:9527），macOS 版 Linggen.app 将其封装为桌面应用程序。引擎本身完全开源，代码托管于 GitHub，用户可通过 curl -fsSL https://linggen.dev/install.sh | bash 一键安装。

模型路由策略

平台不绑定特定模型供应商，采用灵活的路由策略：本地优先时自动调用 Ollama；云端优先时可接入 OpenAI、Claude、Gemini、DeepSeek 等任意支持 API 的模型；用户也可直接使用已有的 ChatGPT Plus/Pro 订阅（通过 OAuth 登录，无须 API Key）。配置文件 linggen.runtime.toml 管理所有模型参数。

Agent Skills 标准

Linggen 应用（即上述 DJ/CFO/Shifu 等模块）遵循开放的 Agent Skills 标准开发，每一个应用即为一个 SKILL.md 文件加对应页面，可从社区市场安装或自行编写。Skills 还可跨平台使用，兼容 Claude Code 和 Codex 等开发工具。

P2P 远程访问

iPhone 与 Mac 的配对通过 QR 码完成，连接建立后走 WebRTC P2P 加密隧道传输音乐、照片、文件等数据，不经过 linggen.dev 中转服务器。Mac 休眠时 iPhone 独立运行，Mac 唤醒后自动重连并同步状态。

MCP 协议支持

ling 引擎同时暴露 MCP（Model Context Protocol）服务器端点（http://127.0.0.1:9527/mcp），提供 22 个工具函数，覆盖 memory*（持久化跨主机记忆）、browser（控制浏览器标签页）、x_（读取 X/Twitter 会话）和 agent_run（向本地智能体下发任务并获取结果）。第三方 MCP 客户端（如 Cursor、Continue）可直接连接使用。

快速上手

第一步：安装 Mac 版

在终端运行以下命令下载并安装 macOS 桌面应用：

curl -fsSL https://linggen.dev/install-app.sh | bash

或仅安装 CLI 引擎（适合已有桌面环境的高级用户）：

curl -fsSL https://linggen.dev/install.sh | bash

第二步：配置模型

启动应用后打开 http://localhost:9527，进入 Settings → Models 添加模型。三种方式任选其一：ChatGPT 订阅登录（Option A）、本地 Ollama 模型（Option B）或第三方 API Key（Option C）。配置完成后健康指示灯变绿即表示连接成功。

第三步：配对 iPhone

在 Mac 端 Settings → Phone 页面显示配对 QR 码，打开 iPhone Linggen App 的 Settings → This Mac 扫描二维码。配对请求确认后，两台设备自动建立加密 P2P 连接。

第四步：开始使用

配对完成后，直接对 iPhone 上的银月说话即可完成各种任务——"播放点轻音乐"、"我七月在超市花了多少钱"、"帮我清理截图"。技术性问题银月会自动转给 Mac 上的 Ling 处理，用户无需手动切换。

适用人群

Linggen 主要面向以下用户群体：

对数据隐私高度敏感、希望 AI 处理过程完全不经过云端的用户，可完全掌控自己的对话记录、财务数据和文件。需要在 macOS/iPhone 跨设备场景下使用 AI 辅助日常生活（音乐、财务、设备管理）的苹果生态用户。追求AI辅助工作效率、愿意配置本地模型以降低使用成本的技术爱好者与开发者，MCP 支持使其可作为后台智能体融入现有工作流。希望在多设备间同步 AI 记忆和工作状态的高级用户，银月和 Ling 的双智能体设计提供了跨会话的持久化上下文能力。

官方链接

• 产品官网：https://linggen.dev
• GitHub 仓库：https://github.com/linggen/linggen
• Skills 市场：https://github.com/linggen/skills
• iOS App：App Store 搜索"Linggen"（免费）