多数 AI 产品是一扇转门：打开浏览器，登录，对话，关闭——下次回来一切从零。它不记得你昨天在做什么，碰不到你的文件系统，更不会在你睡觉时推进任何事。
Lume 运行在你自己的电脑上。记忆、对话、项目上下文、技能配置，全部是 ~/.lume/ 下可直接读写的本地文件；配合完整工具集和有性格的角色团队，它能真正参与你的工作流，而不是旁观。
- 本地优先 — 所有数据存在
~/.lume/。Markdown 是真源、向量索引只是缓存：cat ~/.lume/memories/*.md随时可读，可 grep、可备份、可迁移。 - 持久记忆 — 三层作用域（global / workspace / thread）× 六种类型（fact / preference / decision / lesson / episode / milestone），新对话中自然召回；矛盾记忆并存，由你决定取舍，绝不静默覆盖。
- 角色团队 — 11 位有独立风格与专长的角色（开发者、作家、分析师、调研员、画师、设计师……），主线程理解任务后分发给最合适的人。
- 27+ Skills — 每个 Skill 是一个
SKILL.md提示词模板，支持热加载，修改即生效；配合自我进化机制，越用越准。 - 完整工具集 — 文件系统（Read / Write / Edit / Glob / Grep）、Bash（超时 + 后台）、LSP 代码智能、Office 文档（docx / pptx / xlsx / pdf 创建编辑 + OOXML 修复）、Web 搜索与抓取、图片生成、标准 MCP 客户端。
- 自动化 — cron 定时任务、每日日程，到点自动执行并把结果推送到指定渠道。
- IM 与阅读 — 微信接入（消息自动绑定工作区线程）；微信读书书架/划线同步 + 两阶段智能笔记管线。
- 多模型 — OpenAI 兼容接口接入 OpenAI / Anthropic / Gemini / DeepSeek / GLM / 通义 / 豆包 / Moonshot 等，可按任务分配不同模型。
前置要求：Node.js >= 20、Bun >= 1.0；构建桌面 native 能力另需 Rust stable。
git clone https://github.com/CavinHuang/lume.git
cd lume
bun install
# 开发模式：同时启动前端 + 桌面端
bun dev
# 构建桌面应用
bun build:desktop桌面运行时只有 Electron。Rust 能力构建为 apps/desktop/resources/natives/<platform>-<arch>/lume-natives.node，由 UtilityProcess sidecar 加载。
Agent 引擎以独立 SDK 提供，完整的 Agent 循环——工具调用、上下文管理、流式输出——全在进程内完成，无本地 CLI 依赖，可部署到云端、Serverless、Docker、CI/CD：
import { createAgent } from '@lume/agent-sdk'
const agent = createAgent({
model: 'claude-sonnet-4-6',
maxTurns: 10,
})
for await (const event of agent.query('Read package.json and summarize the project.')) {
// 流式事件：assistant 文本 / 工具调用 / result 统计
}全局配置入口：~/.lume/lume.yaml
# 模型配置
models:
default: openai/gpt-4o
# 工作区
workspaces:
my-project:
path: ~/projects/my-project
context: .context/
# MCP 服务器
mcp:
my-server:
command: npx
args: ["-y", "my-mcp-server"]Lume
├── apps/
│ ├── desktop/ # Electron 桌面应用
│ ├── web/ # Vite + React 前端
│ └── sidecar/ # Electron 子进程核心（Agent runtime + 工具 + 记忆 + IM）
├── packages/
│ ├── sdk/ # @lume/agent-sdk — 可嵌入的 Agent SDK
│ ├── natives/ # @lume/natives — Rust N-API 性能模块加载器
│ ├── shared/ # 跨端共享类型和工具
│ └── ui/ # 共享 UI 组件库
├── crates/
│ ├── lume-ast/ # Rust AST 摘要能力
│ └── lume-natives/ # 输出 .node 动态库，不是桌面 runtime
└── plugins/ # 外部插件
技术栈：Electron · React · TypeScript · Bun（包管理与构建）· Rust N-API（仅构建 .node 性能模块）
欢迎贡献！请先阅读 AGENTS.md 了解工作协议。Commit 格式：
✨ feat(web): 添加流式工具执行器
🐛 fix(sidecar): 修复子代理串行执行问题
♻️ refactor(sdk): 重构 provider 类型定义
Lume — 本地优先，记忆持久，属于你。