muselab

muselab 是一个基于 Claude Agent SDK 构建的自托管 Agent 原生工作台

支持 Agent 交互、多工作区切换、全局任务管理与多端同步。

Muse 来自希腊神话中的缪斯女神，象征灵感、艺术与知识。

桌面工作台 · 文件、多会话标签与 HTML 预览

更多截图：任务中心、深色主题与移动端


任务管理中心 · 运行中、失败与已完成任务	桌面端 · 深色主题


移动端 · 文件区	移动端 · Agent 对话	移动端 · HTML 预览

## 核心特性 | 功能 | 说明 | |---|---| | **Agent 原生工作台** | 围绕 Agent 任务集成文件、会话、预览与真实终端，支持查看执行过程、编辑文件和验证结果 | | **多工作区** | 按项目切换工作区，以项目指令、记忆文件、文档与 Skills 组织 Agent 的工作上下文 | | **Agent 执行与扩展** | 展示工具调用、子代理时间线、代码差异、Hook 状态和模型用量，支持 Skills、MCP 与 Hook 配置 | | **连续的会话工作流** | 支持多会话标签、后台执行、持久消息队列、会话分支与末轮重问 | | **全局任务管理** | 集中查看跨会话的任务状态与执行结果，支持后台任务、定时任务和推送通知 | | **长期记忆** | 通过做梦机制整理任务经历；Agent 可用 MCP 工具自主检索、回溯原始证据并维护记忆，Claude Code / Ducc 等外部 CLI 可共享同一份记忆；支持人工修订，默认关闭，需单独配置 | | **多模型与 Provider** | 支持 Claude OAuth、API Key，以及经独立本地网关接入的 Codex；可配置 Anthropic-compatible 端点 | | **文件预览与编辑** | 支持 Markdown、HTML、图片、PDF、XLSX、CSV、TSV 与文本预览，以及 Markdown 编辑和分屏预览 | | **桌面、移动端与 Apple Watch** | 桌面浏览器与移动端 PWA 共享工作文件和会话，支持中英双语与多主题；Apple Watch 通过快捷指令支持语音发送消息、查看最近会话与回复，并继续对话 | 配置说明：[工作区](docs/personalize-claude-md_zh.md) · [模型接入](docs/providers_zh.md) · [Codex Gateway](docs/codex-gateway_zh.md) · [长期记忆](docs/memory_zh.md)。 ## 快速开始 **一行命令安装**（Linux + macOS + WSL2）： ```bash curl -fsSL https://raw.githubusercontent.com/hesorchen/muselab/main/scripts/quick-install.sh | bash ``` **手动安装**（先安装 [uv](https://docs.astral.sh/uv/getting-started/installation/)）： ```bash git clone https://github.com/hesorchen/muselab && cd muselab bash scripts/install-linux.sh # 或 install-macos.sh ``` 需要 Python 3.12 及以上版本；前端无需 npm 构建。引导脚本会安装 `uv`，平台安装器会同步依赖并在需要时尝试补装 Node 与 CLI。Docker、开发模式和详细环境要求见[快速入门](docs/quickstart_zh.md)。 **安装后验证**： 1. 在安装机器的浏览器中打开 `http://localhost:8765`。 2. 使用安装时配置的 `MUSELAB_TOKEN` 登录。 3. 选择工作区，并配置至少一种模型。配置方式见 [Providers](docs/providers_zh.md)。 4. 发送 `你好`，确认 Muse 正常响应，再打开一个文件检查预览。安装或运行异常时，可在仓库目录运行 `bash scripts/doctor.sh`，检查环境并获取修复建议。 > **Windows 用户：** 请通过 WSL2 安装（参见[快速入门](docs/quickstart_zh.md#windows-用户走-wsl2)）。 > > **无人值守安装：** `MUSELAB_NONINTERACTIVE=1 bash scripts/install-linux.sh`。配置要求见平台安装文档。 ## 文档 **[📚 完整文档索引](docs/README_zh.md)** - **上手：** [快速入门](docs/quickstart_zh.md) · [Linux 安装](docs/install-linux_zh.md) · [macOS 安装](docs/install-macos_zh.md) · [升级](docs/upgrade_zh.md) - **使用：** [工作台操作](docs/workbench-ui_zh.md) · [配置工作区 CLAUDE.md](docs/personalize-claude-md_zh.md) · [Skills](docs/skills_zh.md) · [终端](docs/terminal_zh.md) · [手机端 PWA](docs/mobile_zh.md) · [Apple Watch](docs/apple-watch-console_zh.md) · [定时任务](docs/scheduler_zh.md) · [长期记忆](docs/memory_zh.md) - **模型：** [Providers](docs/providers_zh.md) · [Codex Gateway](docs/codex-gateway_zh.md) · [接入新 provider](docs/add-provider_zh.md) · [模型路由](docs/routing_zh.md) - **内部机制：** [架构](docs/architecture_zh.md) · [会话](docs/backend-sessions_zh.md) · [Files API](docs/backend-files_zh.md) · [安全模型](docs/backend-security_zh.md) · [前端](docs/frontend_zh.md) · [基础设施](docs/infrastructure_zh.md) - **参考：** [配置](docs/configuration_zh.md) · [数据与备份](docs/data-and-backup_zh.md) · [排错](docs/troubleshooting_zh.md) · [词汇表](docs/glossary_zh.md) - **概念：** [同类对比](docs/comparison_zh.md) · [九位缪斯](docs/muses_zh.md) - **项目：** [安全](SECURITY.md) · [贡献指南](CONTRIBUTING.md) · [第三方授权](THIRD_PARTY_LICENSES.md) ## 状态当前版本为 v2.1.0。升级已有安装前，请阅读[升级说明](docs/upgrade_zh.md)并备份数据。 [MIT](LICENSE)