开箱即用的 AI 开发环境,整合三大核心组件:OpenCode + Impetus + oh-my-openagent。
2.3K
开箱即用的 AI 编程开发环境:OpenCode + Impetus + oh-my-openagent 一体化,一条命令启动,直接开写。
# 1. 直接在当前路径开始
docker run --rm -it -v $(pwd):/workspace \
micrograils/opencode-ultra
# 2. 或者使用自有 ANTHROPIC_API_KEY
docker run -it --rm -v $(pwd):/workspace \
-e ANTHROPIC_API_KEY=你的API密钥 \
micrograils/opencode-ultra
# 3. 容器内开始用
opencode # 启动 AI 编程助手
没有 API Key 也能先进容器熟悉环境,模型配置见下方「环境变量」。
镜像里自带一个给宿主机用的小脚本 opencode-here:以后在任何项目目录敲一下,容器自动开好(容器名取自目录名,同一目录可复用、可重建)。
# 一次性取出到宿主机(任意位置执行,建议放到 ~/bin 下)
docker create --name ocu-tmp micrograils/opencode-ultra
docker cp ocu-tmp:/usr/local/bin/opencode-here ~/bin/opencode-here
docker rm ocu-tmp
# 以后进入某个项目目录:
cd ~/my-project
opencode-here # 后台启动;再次运行可复用/重建该容器
opencode-here --rm # 前台启动,退出即自动删除
docker exec -it opencode-my-project bash # 随时再进容器
services:
opencode-ultra:
image: micrograils/opencode-ultra:latest
container_name: opencode-ultra
stdin_open: true
tty: true
environment:
- ANTHROPIC_API_KEY=your-api-key
volumes:
- ./project:/workspace
docker compose up -d
docker attach opencode-ultra
| 变量 | 说明 |
|---|---|
ANTHROPIC_API_KEY | Anthropic (Claude) API 密钥 |
OPENAI_API_KEY | OpenAI (GPT) API 密钥 |
GEMINI_API_KEY | Google (Gemini) API 密钥 |
GITHUB_TOKEN | GitHub Copilot Token |
OPENCODE_ULTRA_UID / OPENCODE_ULTRA_GID | 固定容器内运行时 uid/gid(默认自动跟随 /workspace 属主) |
下面是有空再看的细节。
-v $(pwd):/workspace 把宿主目录挂进容器,两侧改动即时同步。/workspace 的属主运行:root 宿主即以 root 跑、uid 1000 宿主即以 node 跑,其余 uid 自动适配。因此容器内写出的文件在宿主机上属主一致,无需手动 chown。docker run --user 1000:1000 ...,或用上面的 OPENCODE_ULTRA_UID/GID 环境变量。/workspace 不可写(例如用了 --user 绕过自动适配),在宿主机执行:cd <项目目录> && sudo chown -R $(id -u):$(id -g) .| 组件 | 说明 |
|---|---|
| OpenCode | 开源 AI 编程助手,支持 Claude/GPT/Gemini 等 75+ 模型 |
| Impetus | OpenSpec + Superpowers 工作流,结构化开发流程(brainstorming → design → build → verify → archive) |
| oh-my-openagent | 多 agent 编排插件,11 个专业 agent、Team Mode、MCP 工具链、54+ 生命周期钩子 |
| 命令 | 说明 |
|---|---|
/impetus "想法" | 启动完整工作流 |
/impetus-open | 阶段 1:开启 |
/impetus-design | 阶段 2:深度设计 |
/impetus-build | 阶段 3:计划与构建 |
/impetus-verify | 阶段 4:验证与收尾 |
/impetus-archive | 阶段 5:归档 |
/impetus-hotfix | 快速 Bug 修复 |
/impetus-tweak | 小改动 |
| 命令 | 说明 |
|---|---|
ultrawork / ulw | 一键激活所有 agent,全自动执行 |
/init-deep | 生成层级 AGENTS.md |
/start-work | Prometheus 规划模式 |
/ulw-loop | 持久化多目标循环 |
oh-my-openagent 内置 11 个专业 Agent,自动分工协作:
| Agent | 职责 |
|---|---|
| Sisyphus | 主编排者,计划与委派 |
| Hephaestus | 深度执行者,端到端实现 |
| Oracle | 代码审查与质量把关 |
| Librarian | 文档与知识检索 |
| Prometheus | 战略规划,面试式需求分析 |
| Explore | 代码库探索与理解 |
/workspace维护者文档(构建 / 版本管理 / 升级 / 维护)见 MAINTENANCE.md。
Content type
Image
Digest
sha256:d92b87d7c…
Size
718.3 MB
Last updated
about 22 hours ago
docker pull micrograils/opencode-ultra