SuperAPI AI 工具集

cmux-dev-workflow

编程与开发

查看项目

更新于 10-16 00:05

技能介绍

用途:面向 cmux 仓库贡献者的原生开发工作流,覆盖原生构建输入、带标签的开发构建、Xcode 工程规范化与侧边栏扩展。

主要能力与用法:仓库命令只能在可信检出中运行,连 python3 scripts/verify-local.py --help 和 --list 也会加载仓库代码。准备原生构建前先按变更类型选择验证:快速反馈从 python3 scripts/verify-local.py 开始;可移植工具链与文档变更使用各自的限定检查,不必构建无关应用。原生应用或构建输入变更需带标签构建。./scripts/setup.sh 初始化子模块、构建 GhosttyKit 并安装工程规范化钩子,但不是可移植静态检查的前置条件。

带标签的本地开发:在获授权本地原生执行时使用 ./scripts/reload.sh --tag <short-tag> 与 CMUX_TAG=<short-tag> scripts/cmux-debug-cli.sh list-workspaces。reload 只构建不启动,需要实时验证时加 --launch。不要使用裸 xcodebuild,也不要打开未加标签的 cmux DEV.app;标签用于隔离 bundle ID、socket 与构建输出。不要使用 /tmp/cmux-cli,它跟随最近一次 reload 的应用。不要退出、杀死、重启或对用户正在运行的 cmux(com.cmuxterm.app)执行 xctrace --launch,其中保存着实时智能体会话。应用构建不等于测试目标编译或执行,相关结论需遵循测试指南。

工具链与工程文件:.xcode-version 决定 Xcode 主版本;cmux.xcodeproj/project.pbxproj 当前使用 objectVersion 60。Intel/macOS 14 回退使用 Xcode 16.2/Swift 6.0,应用链接代码需保持 Swift 6.0 兼容。已安装的 pre-commit 钩子会规范化暂存的工程文件,并在 tests/test-execution.toml 注册新的 Python 测试;需保留该钩子,工程编辑后运行 python3 scripts/verify-local.py --only project。工具链版本固定属于团队决策。

侧边栏扩展标签:每个标签的扩展点 ID、bundle-ID 后缀与显示名后缀需保持区分。通过 scripts/reload-extension.sh --tag <tag> 与匹配宿主构建扩展;不要通过重新签名修复不匹配的标签。具体设置、辅助参数与验证清单见侧边栏扩展标签文档。

限制:资料未提供收费、价格、平台支持范围与效果数据。