为什么选择 Superset？
Superset 是一个加速终端，允许您运行任何 CLI 代码代理，并附带工具来 10 倍提升您的开发工作流程。
- 同时运行多个代理，无需上下文切换开销
- 每个任务独立隔离，在各自的 git 工作树中运行，代理互不干扰
- 集中监控所有代理，在需要时收到通知
- 快速查看变更，内置差异查看器和编辑器
减少等待时间，加速交付。
功能
| 功能 | 描述 |
|---|---|
| 并行执行 | 在您的机器上同时运行 10+ 个代码代理 |
| 工作树隔离 | 每个任务拥有独立的分支和工作目录 |
| 代理监控 | 追踪代理状态，变更时及时通知 |
| 内置差异查看器 | 无需离开应用即可检查和编辑代理变更 |
| 工作区预设 | 自动化环境设置、依赖安装等操作 |
| 通用兼容性 | 兼容任何在终端中运行的 CLI 代理 |
| 快速上下文切换 | 在任务间灵活切换以应对需求 |
| IDE 集成 | 一键在喜爱的编辑器中打开工作区 |
支持的代理
Superset 兼容任何基于 CLI 的代码代理，包括：
| 代理 | 状态 |
|---|---|
| Claude Code | 全部支持 |
| OpenAI Codex CLI | 全部支持 |
| Cursor Agent | 全部支持 |
| Gemini CLI | 全部支持 |
| GitHub Copilot | 全部支持 |
| OpenCode | 全部支持 |
| 任何 CLI 代理 | 均可使用 |
只要能在终端运行，就能在 Superset 上运行
要求
入门指南
快速启动（预构建版）
从源代码构建
点击展开构建说明
1. 克隆仓库
git clone https://github.com/superset-sh/superset.git
cd superset
2. 设置环境变量 (选择一种方式):
选项 A: 完整设置
cp .env.example .env
# 编辑 .env 并填写值
选项 B: 跳过环境验证 (用于快速本地测试)
cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env
3. 设置 Caddy (用于 Electric SQL 流的反向代理):
# 安装 caddy: brew install caddy (macOS) 或参考 https://caddyserver.com/docs/install
cp Caddyfile.example Caddyfile
4. 安装依赖并运行
bun install
bun run dev
5. 构建桌面应用
bun run build
open apps/desktop/release
快捷键
所有快捷键均可通过 设置 > 快捷键 (⌘/) 自定义。查看 完整文档。
工作区导航
| 快捷键 | 操作 |
|---|---|
⌘1-9 | 切换到工作区 1-9 |
⌘⌥↑/↓ | 上一个/下一个工作区 |
⌘N | 新建工作区 |
⌘⇧N | 快速创建工作区 |
⌘⇧O | 打开项目 |
终端
| 快捷键 | 操作 |
|---|---|
⌘T | 新建标签页 |
⌘W | 关闭面板/终端 |
⌘D | 向右分割 |
⌘⇧D | 向下分割 |
⌘K | 清空终端 |
⌘F | 终端内查找 |
⌘⌥←/→ | 上一个/下一个标签页 |
Ctrl+1-9 | 打开预设 1-9 |
布局
| 快捷键 | 操作 |
|---|---|
⌘B | 切换工作区侧边栏 |
⌘L | 切换变更面板 |
⌘O | 在外部应用中打开 |
⌘⇧C | 复制路径 |
配置
在 .superset/config.json 中配置工作区的创建和删除。查看 完整文档。
{
"setup": ["./.superset/setup.sh"],
"teardown": ["./.superset/teardown.sh"]
}
| 选项 | 类型 | 描述 |
|---|---|---|
setup | string[] | 创建工作区时运行的命令 |
teardown | string[] | 删除工作区时运行的命令 |
示例设置脚本
#!/bin/bash
# .superset/setup.sh
# 复制环境变量
cp ../.env .env
# 安装依赖
bun install
# 运行其他设置任务
echo "工作区已准备就绪!"
脚本可以访问环境变量:
SUPERSET_WORKSPACE_NAME— 工作区名称SUPERSET_ROOT_PATH— 主仓库路径
内部依赖覆盖
关于此仓库使用的内部 mastracode 分叉/捆绑工作流程，请参阅 docs/mastracode-fork-workflow.md。
技术栈
贡献
我们欢迎任何改进 Superset 的建议：
- 分叉仓库
- 创建您的特性分支 (
git checkout -b feature/amazing-feature) - 提交您的变更 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开 Pull Request
您也可以 打开问题 反映 Bug 或提出功能请求。
查看 CONTRIBUTING.md 了解详细说明和行为准则。
社区
加入 Superset 社区获取帮助、分享反馈并与其他用户连接：
- Discord — 与团队和社区交流
- Twitter — 关注获取更新和公告
- GitHub Issues — 报告 Bug 和请求功能
- GitHub Discussions — 提问并分享想法
团队
许可证
遵循 Apache 2.0 许可证分发。更多信息请参阅 LICENSE.md。