用途：通过 dev docker CLI 管理 Polar 本地开发环境，用于启动、停止、调试或理解本地服务栈。
架构：分为共享基础设施与每实例应用栈。共享基础设施每台机器一份，Docker 项目为 polar-shared，包含 postgres、redis、minio、tinybird 及可选的 prometheus/grafana；postgres 与 redis 不发布主机端口，MinIO 暴露 9000/9001。每实例应用栈每个 worktree 一份，项目为 polar-app-<N>，包含 api、worker、web，仅 api 与 web 发布主机端口。
实例自动检测：dev docker 会自动检测当前 worktree 的实例，优先级为 dev/docker/.env.docker 中的 POLAR_DOCKER_INSTANCE、跨 worktree 注册表，否则取最低空闲编号。可用 dev docker ports 查看解析后的实例与 URL，用 dev docker launch-json 写入 Claude Code 预览配置。
常用命令：dev docker up -d 后台启动；dev docker up -d --wait 等待健康；dev docker up --no-detach 前台运行；dev docker up -b --pull -d 重建；dev docker ports 查看端口；dev docker down 停止应用栈；dev docker down --all 停止全部；dev docker logs -f [service] 跟踪日志；dev docker ps 查看状态；dev docker restart <service> 重启；dev docker shell <service> 进入 shell；dev docker exec <service> <cmd> 执行命令；dev docker cleanup -f 重置实例；dev docker cleanup --all -f 清除全部共享数据；dev docker list 列出实例；dev docker up --monitoring -d 启用监控。
端口：实例 0 使用 api 8000、web 3000；实例 1–99 使用 api 8100+N、web 3100+N。数据库、redis、存储桶按实例隔离，需通过 dev docker exec 访问。
限制：资料未提供安装步骤、系统要求、收费与价格信息。