用途:通过 TOML 配置文件定义 iTerm2 工作区布局,实现配置与代码分离(私有路径放 TOML,可公开的布局逻辑放 Python 脚本)。
主要能力:配置左右窗格比例与命令、定义多个工作区标签页(含自定义名称与目录)、设置 AutoLaunch 脚本、可选启用 git worktree 标签自动发现并生成缩写式标签名。
用法:配置文件位于 ~/.config/iterm2/layout.toml,脚本位于 ~/scripts/iterm2/default-layout.py,模板为 ~/scripts/iterm2/layout.example.toml。首次设置可执行 mkdir -p ~/.config/iterm2 并复制模板 cp ~/scripts/iterm2/layout.example.toml ~/.config/iterm2/layout.toml 后编辑路径,重启 iTerm2 测试。新增标签只需添加 [[tabs]] 条目(dir 必填,name 可选,缺省用目录 basename);删除则注释或移除该条目。校验 TOML 可用 python3 -c "import tomllib; tomllib.load(open('~/.config/iterm2/layout.toml', 'rb'))"。
限制:仅面向 iTerm2,配置错误或目录不存在时脚本以“打印并提前返回”方式处理,错误信息需在 iTerm2 的 Scripts > Manage > Console 中查看。部分价格、收费或效果等信息暂未提供。