【免费下载链接】dolphin-code项目地址https://gitcode.com/gh_mirrors/do/dolphin-code点击查看免费下载想在本地跑通 dolphin-codeOrcaMatrix / aPaaS AI Workspace的环境并不复杂——只需 3 条命令你就能启动 Phase 1 本地 demo完整体验 AI Agent 沙箱运行时的闭环流程。本教程面向新手带你从零配置好 dolphin-code 本地环境并附赠一键端到端验证脚本无需真实模型凭证也能顺利验收。 先认识dolphin-code 本地环境的核心模块dolphin-code 是一个多模块聚合仓库包含产品设计、控制面后端、Web 控制台等模块。而本地环境的入门入口是 agent-runtime/——它是 Agent Runtime 与 Sandbox Worker 工程负责沙箱Sandbox运行时镜像与容器内 Web 服务工作区workspace克隆、seed 初始化与 Git 提交/推送Codex app-server 监管与模型 provider 注入Phase 1 本地 demo 启动脚本与 compose 资产平台整体的 Agent 工作台设计可以参考下图帮助你建立对本地环境将承载的界面的整体印象✅ 前置条件跑通 Phase 1 demo 只需 3 样工具工具用途检查命令Docker含 compose构建并启动沙箱运行时容器docker infoGit初始化本地 demo 用的 Git origin 与工作区git --versioncurl探测运行时健康检查接口curl --version 好消息默认的 mock 模式下不需要任何真实模型 API KeyOPENAI_API_KEY会用占位符填充适合第一次纯验证环境是否跑通。 三步搭建一键启动 dolphin-code 本地环境第 1 步克隆仓库git clone https://gitcode.com/gh_mirrors/do/dolphin-code cd dolphin-code/agent-runtime注意demo 脚本在agent-runtime 模块目录内运行见 agent-runtime/README.md 的 Phase 1 Demo 章节。第 2 步执行 demo 启动脚本bash scripts/phase1-demo.shscripts/phase1-demo.sh 会自动完成四件事在.local/phase1/下初始化本地 bare Git origin 和 demo 工作区用 docker/Dockerfile 构建运行时镜像orcamatrix-agent-runtime:phase1通过 docker/compose.phase1.yml 启动容器把配置以只读方式挂载进沙箱轮询http://127.0.0.1:18080/api/status直到运行时就绪最长等待 45 秒第 3 步验证环境就绪看到demo runtime is running at http://127.0.0.1:18080后手动确认一下curl http://127.0.0.1:18080/api/status能返回 JSON 状态包含tenantId、workspaceId等字段即表示 dolphin-code 本地环境已经跑通 ✅ 跑通之后Phase 1 演示了什么Phase 1 验证的是沙箱运行时的happy-path 完整闭环runtime context secrets 挂载 → 沙箱运行时启动 → 工作区克隆并完成 seed 初始化 → Builder chat 经 Codex app-server 执行 → 工作区文件被修改 → Git commit / push → CI provider 被显式触发 → 状态与 resume 元数据对外暴露四个挂载进容器的示例配置文件都预先放在 agent-runtime/examples/phase1/ 下可直接对照修改runtime-context.json租户、应用、工作区等运行上下文model-provider.json模型供应商与默认模型git-auth.example.jsonGit 认证demo 默认指向本地 originci-provider.example.jsonCI 触发配置demo 默认为 mock 模式seed 工程 seeds/minimal/ 是 Phase 1 的依赖无关最小工作区模板seeds/minimal/README.md 说明了其中 Builder 资产的结构。 一键端到端验证e2e 脚本默认 mock免凭证环境跑通后推荐再执行一次端到端冒烟测试它会自动走一遍初始化 → 对话 → 提交 → CI → 重启恢复全链路bash tests/e2e/phase1.shtests/e2e/phase1.sh 会依次调用/api/workspace/init、/api/codex/models、/api/agent/sessions、/api/git/commit、/api/ci/trigger、/api/status等接口并断言关键响应最后还会重启容器验证resume 能力Resumed:true。输出中若看到phase1 happy path passed说明你的 dolphin-code 本地环境已完全健康。 进阶接入真实模型跑 Builder chat想体验真实的 AI 对话只需两步修改 examples/phase1/model-provider.json把apiBaseUrl、defaultModel和models[].id改为你自己的 provider在 shell 中提供真实密钥后重启 demoexport OPENAI_API_KEYyour-key bash scripts/phase1-demo.she2e 脚本同理OPENAI_API_KEYyour-key APAAS_E2E_MOCK_CODEX0 bash tests/e2e/phase1.sh⚠️ 注意真实模式下密钥只会写入.local/下被 Git 忽略的本地 compose state不会污染仓库。若未单独提供真实 GitLab CI 配置CI 环节仍保持 mock/local 模式。 关键路径速查表内容相对路径模块总览与阶段说明agent-runtime/README.mdPhase 1 demo 启动脚本agent-runtime/scripts/phase1-demo.shPhase 1 端到端验证agent-runtime/tests/e2e/phase1.sh运行时镜像定义agent-runtime/docker/Dockerfile容器编排配置agent-runtime/docker/compose.phase1.yml演示配置样例agent-runtime/examples/phase1/本地状态目录自动生成.local/phase1/Codex home 工作区上下文 总结3 条命令即可跑通 dolphin-code 本地环境clone →cd agent-runtime→bash scripts/phase1-demo.sh用curl http://127.0.0.1:18080/api/status确认就绪bash tests/e2e/phase1.sh一键完成免凭证的端到端验收需要真实模型时改model-provider.json并设置OPENAI_API_KEY即可升级跑通 Phase 1 之后你还可以继续 agent-runtime/README.md 中记录的 Phase 2 Builder E2Ebash tests/e2e/phase2.sh体验完整的 Builder 对话、spec 确认与 crash/resume 流程。祝搭建顺利赞分享【免费下载链接】dolphin-code项目地址https://gitcode.com/gh_mirrors/do/dolphin-code点击查看免费下载相关推荐MCP for Blender3步让AI替你搭好3D场景零基础教程MCP for Blender3步让AI替你搭好3D场景零基础教程 MCP for Blender 是一个把任意大语言模型接入 Blender 的开源桥梁如何快速上手Qwen2.5-0.5B-Instruct10分钟跑通本地LLM推理完整教程如何快速上手Qwen2.5 0.5B Instruct10分钟跑通本地LLM推理完整教程 Qwen2.5 0.5B Instruct 是阿里通义千问团队发布的大模型基础模型Qwen如何快速上手HoVLE-HD从环境配置到跑通第一张图像对话的完整教程如何快速上手HoVLE HD从环境配置到跑通第一张图像对话的完整教程 HoVLE HD 是 OpenGVLab 开源的一个 2.6B 参数的单体式视觉语言模型上一篇彻底解决Prefect GCP密钥管理的GRPC警告下一篇解决Pinia与Apollo集成时的obj.hasOwnProperty错误从根源到解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考