Supacode自定义脚本完全教程: 为仓库配置自动化命令, Agent运行状态实时提醒【免费下载链接】supacodeworktree coding agents command center.项目地址: https://gitcode.com/gh_mirrors/su/supacodeSupacode 是一款 macOS 原生的 worktree 编码 Agent 指挥中心每个任务独享一个 git worktree 和真实终端。它的自定义脚本功能让你为每个仓库配置自动化命令——一键运行、测试、部署配合 Agent 运行状态实时提醒在 Claude、Codex 等编码助手需要你介入的瞬间立即收到通知。本文带你从零配好脚本、跑通自动化并掌握 CLI 与深链两种触发方式。 Supacode 自定义脚本是什么Supacode 把仓库常用命令抽象成带图标和颜色的命名脚本运行时会开一个独立标签页执行并同步出现在工具栏 Script 菜单、命令面板Command Palette和深链中。脚本分两大类① 用户脚本按需运行——共 6 种类型前 5 种自带固定图标与配色类型默认图标颜色典型用途Run绿色 ▶启动开发服务器如make run-appTest黄色跑测试如make testDeploy红色构建发布Lint蓝色 ⚠️代码检查Format青色格式化代码Custom紫色可自选任意自定义命令可自定义名称与颜色类型与默认样式定义在 ScriptKind.swift单个脚本的名称、命令、图标、颜色则存储在 ScriptDefinition.swift。以 Supacode 仓库自身的配置为例它定义了 Run / Test / Lint / Format 四个脚本见 supacode.json。② 生命周期脚本自动触发——挂在 worktree 的生老病死节点上脚本触发时机示例命令Setup Scriptworktree 创建后自动跑一次pnpm installArchive Scriptworktree 归档前docker compose downDelete Scriptworktree 删除前docker compose downOpen File Script双击文件时可用$SUPACODE_FILE_PATH拿到路径nvim $SUPACODE_FILE_PATH这些字段都保存在仓库级设置 RepositorySettings.swift 中编辑界面见 RepositoryScriptsSettingsView.swift。⚙️ 最快配置方法3 步配好仓库自动化命令第 1 步打开仓库脚本设置。选中侧边栏的仓库进入设置 → Scripts 标签页Setup / Archive / Delete / Open File 四个生命周期脚本在此配置仅 git 仓库可见前两项。第 2 步点击右上角添加脚本。下拉菜单会列出你还没建过的类型Run、Test、Deploy、Lint、Format 每类最多一个Custom 可建任意多个。选 Custom 时还能自定义名称和颜色让工具栏一眼可辨。第 3 步填入命令。在命令编辑框输入 shell 命令即可例如npm start或make test。删除脚本点红色 Remove Script… 按钮。 小技巧第一个Run 类型脚本是主脚本——工具栏上的一键运行按钮默认就执行它见 ScriptDefinition.swift 中的primaryScript。把最常用的启动命令放这里最顺手。全局脚本一次配置所有仓库共享在 设置 → 全局 Scripts 页面GlobalScriptsSettingsView.swift添加的脚本会出现在每个仓库的工具栏和命令面板里适合放通用命令比如打开端口占用检查、提交前格式化。合并规则是仓库脚本优先全局脚本兜底同 ID 冲突时以仓库为准。▶️ 3 种方式运行脚本方式一工具栏 Script 菜单。每个脚本带彩色图标点击即在自己的标签页运行运行状态实时可见。方式二命令面板。按快捷键唤起 Command Palette模糊搜索脚本名直接执行全程不离键盘。方式三CLI 或深链。在任何 Supacode 终端会话里supacode命令默认可用命令清单见 supacode-cli.mdsupacode worktree script list # 列出当前 worktree 的所有脚本 supacode worktree run # 运行主 Run 脚本 supacode worktree run -c uuid # 按 UUID 运行指定脚本 supacode worktree stop -c uuid # 停止指定脚本脚本列表命令的实现位于 WorktreeScriptCommand.swift。在 Supacode 外部其他脚本、自动化平台则用深链完整路由参考 supacode-deeplinks.mdopen supacode://worktree/worktree_id/run⚠️ 注意深链触发的运行/危险操作需要确认除非在 Developer 设置中允许了 Allow dangerous actions。 Agent 运行状态实时提醒Supacode 自动检测每个终端里正在运行的编码 AgentClaude Code、Codex、Copilot、Grok、Kimi 等侧边栏和 Agent 徽章上会实时显示三种状态忙碌中busy、等待输入awaiting input、空闲idle。状态识别的接入逻辑见 AgentIntegration.swiftSupacode 会为支持的 Agent 自动安装 hooks本地和 SSH 远程仓库都有效。配合通知能力这套组合拳的体验是Agent需要你回答/确认时即时收到应用内或系统通知可选提示音侧边栏自动把等你处理的 worktree 提到顶部脚本运行结束、Agent 空闲下来时同样有提示不必守着终端多 Agent 并行干活时用 ⌃1–⌃9 快速跳转到任意 worktree。 实用工作流Setup Script 负责拉依赖Agent 在独立 worktree 里改代码Test 脚本随时一键回归等你输入时 Agent 状态徽章变黄 通知响起——整个循环不用手动盯守。 常见问题Q文件夹非 git 仓库能用脚本吗可以。文件夹拥有与仓库相同的标签页、脚本和外观能力只是 Setup / Archive 两个依赖 worktree 的脚本不可用。Q脚本输出去哪看每个脚本在独立标签页中执行输出与滚动记录都保留在会话里关闭 App 重开也不丢会话由后台守护进程持久化。Q旧配置有runScript字段新版会自动迁移为 Run 类型脚本旧客户端仍可通过派生字段读取双向兼容。结语自定义脚本 生命周期钩子 Agent 状态提醒让 Supacode 从一个终端窗口管理器升级为真正的并行开发指挥中心。花 5 分钟配好 4 个脚本之后每个 worktree 的装环境、跑测试、收通知都会自动就位。【免费下载链接】supacodeworktree coding agents command center.项目地址: https://gitcode.com/gh_mirrors/su/supacode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
