Plandex项目本地安装指南：解决Docker Compose命令错误

问题背景

在使用Plandex项目的本地快速启动指南时，许多macOS用户可能会遇到一个常见问题：当执行./start_local.sh脚本时，系统提示"docker: unknown command: docker compose"错误。这个问题通常与Docker的安装方式有关，而非Plandex项目本身的问题。

问题分析

这个错误的核心在于Docker Compose命令的执行方式。在macOS系统中，如果用户通过Homebrew单独安装docker和docker-compose（使用brew install docker和brew install docker-compose），系统会将这些作为独立的命令行工具安装。然而，现代Docker Desktop for Mac已经将docker-compose功能集成到了主docker命令中，使用docker compose（注意中间没有连字符）的语法形式。

解决方案

正确的安装方式是使用Homebrew安装Docker Desktop for Mac的cask版本：

brew install --cask docker

这种安装方式会：

1. 安装完整的Docker Desktop应用程序
2. 自动包含docker-compose功能
3. 设置正确的命令行工具路径
4. 提供图形界面管理选项

安装完成后，用户需要：

1. 像启动普通macOS应用一样打开Docker应用
2. 完成初始设置（可选择默认选项）
3. 在提示登录时可以选择跳过

额外注意事项

对于希望从源代码构建Plandex的用户，还需要确保系统已安装Go语言环境。可以通过Homebrew轻松安装：

brew install go

技术原理

Docker在macOS上的安装方式演变反映了容器技术的发展趋势。早期版本确实需要单独安装docker-compose，但现代版本已经将其整合为docker命令的子命令。这种变化带来了更一致的命令行体验，但也可能导致一些兼容性问题。

最佳实践建议

1. 对于macOS用户，始终推荐使用Docker Desktop的官方cask安装方式
2. 安装完成后，通过运行docker --version和docker compose version验证安装
3. 定期更新Docker Desktop以获取最新功能和安全补丁
4. 对于开发者，考虑将Docker Desktop设置为开机启动以确保服务可用性

通过遵循这些指导原则，用户可以顺利地在macOS上运行Plandex的本地开发环境，享受这个强大工具带来的便利。