superset-setup

Superset 项目设置

目标：每个新工作区（隔离的 Git worktree）都能开箱即用——已安装依赖、已准备好环境、服务可访问，无需手动操作。

1. 检查仓库

了解全新 worktree 需要什么，并询问任何不明确的事项：

• 包管理器和安装命令（根据锁文件判断：bun/pnpm/yarn/npm、cargo、uv 等）
• 环境文件：.env 通常会被 Git 忽略，因此需要将其从主检出目录复制到新 worktree，或根据 .env.example 生成
• 服务（docker-compose、数据库）、开发命令和端口
• Monorepo 布局（设置是否需要 cwd？）

2. 编写 .superset/config.json

此文件用于接入生命周期脚本——只有 setup.sh 而没有 config.json 不会被加载。架构如下：

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"],
  "run": ["bun dev"],
  "cwd": "optional/subdir"
}

每个键对应一个命令数组，这些 shell 命令会在创建、删除或运行工作区时于 worktree 内执行。指南：

• 设置必须幂等且快速（目标是不超过一分钟；耗时的步骤会让每次创建工作区都很痛苦）
• 在设置时从主检出目录复制机密信息和环境文件——切勿提交
• .superset/config.local.json（被 Git 忽略）允许单个用户通过 before/after 数组扩展脚本，而无需修改共享配置

向用户展示拟议的文件，并在写入前征得明确同意。

3. 实际验证

使用 superset workspaces create --project <id> --name "setup-test" 创建一个临时工作区，并查看“Workspace Setup”终端输出。修复问题并重复操作，直到顺利完成，然后删除测试工作区。只有真实工作区成功启动，设置才算完成。