superset

环境要求

• 本机已安装 Git（唯一必需依赖）
• macOS（Apple Silicon 或 Intel，主要支持平台）或 Linux x64（实验性）
• gh CLI 为可选项，装后可解锁 PR 工作流，Superset 会提示帮你安装
• Windows 暂不支持

安装与启动步骤

1. 1确认已装 Git

   Superset 唯一必需的依赖是 Git，因为每个代理任务都跑在独立的 git worktree 里。先在终端确认 Git 可用。

   git --version

   复制

2. 2下载安装包

   按系统选择：macOS Apple Silicon 下载 Superset-arm64.dmg，Intel 下载 Superset-x64.dmg；Linux x64 下载 AppImage。

3. 3安装并启动

   macOS 打开 dmg 把 Superset 拖入「应用程序」后启动；Linux 给 AppImage 加可执行权限再双击运行。

4. 4按提示处理 gh

   首次使用若提示安装 GitHub CLI（gh），它只是可选项，用于解锁 PR 相关工作流，可让 Superset 帮你装或直接跳过。

5. 5打开代码仓库

   在 Superset 中打开一个本地 Git 仓库，它会在其中为每个代理创建隔离工作区，避免多个代理互相改冲突。

6. 6配置工作区脚本

   在项目根目录新建 .superset/config.json，用 setup / teardown / run 声明工作区创建、销毁和运行时要执行的脚本。

   {
     "setup": ["./.superset/setup.sh"],
     "teardown": ["./.superset/teardown.sh"],
     "run": ["./.superset/run.sh"]
   }

   复制

7. 7自定义快捷键

   进入 Settings → Keyboard Shortcuts（快捷键 ⌘/）按自己的习惯调整按键绑定，完整快捷键列表见官方文档。

关键配置

如何确认成功

应用能正常启动并进入工作区界面；终端执行 git --version 能输出版本号，说明依赖齐备。

常见问题

注意事项

• README 只提供桌面客户端下载，没有源码编译或命令行安装方式，不要擅自使用其他包管理器。
• Superset 依赖 Git worktree 隔离各代理任务，因此工作目录必须是 Git 仓库。
• Linux 版本为实验性，功能与稳定性以 macOS 版为准。
• 配置文件的完整说明见 docs.superset.sh/setup-teardown-scripts。