OpenCode Pro

快速开始

前端

npm install
npm run dev # 开发服务器 http://localhost:5173
npm run build # 生产构建

后端

cd backend
pip install -r requirements.txt
python main.py # API 服务 http://localhost:3001

系统架构

目录结构

src/ # React + Vite 前端
├── components/ # ChatArea, Sidebar, AgentPanel, Terminal, Tetris
├── store/ # chatStore, modelStore, ragStore (Zustand)
└── styles/ # CSS (暗色主题)
backend/ # FastAPI 后端
├── main.py # Uvicorn 入口
├── __init__.py # FastAPI app 创建 + 事件总线初始化
│
├── routes/
│ └── proxy.py # SSE 流式 Agent 端点 + 事件总线SSE端点
│
├── agent/
│ ├── agent_def.py # Agent 注册、权限检查
│ ├── prompts.py # 提示词加载器 (从 .txt 文件加载)
│ └── prompts/ # Agent 提示词 .txt 文件 (5个)
│ ├── generate.txt, explore.txt
│ ├── compaction.txt, title.txt
│ └── summary.txt
│
├── session/
│ ├── session_manager.py
│ └── prompts/ # 模型专属系统提示词 .txt 文件 (7个)
│ ├── anthropic.txt, beast.txt, codex.txt
│ ├── gemini.txt, qwen.txt, plan.txt
│ └── build-switch.txt, max-steps.txt
│
├── command/
│ └── templates/ # 斜杠命令模板 .txt 文件
│ ├── initialize.txt, review.txt
│
├── tools/
│ ├── chain_tools.py # 所有工具 (LangChain @tool)
│ ├── edit_replacer.py # 8种替换策略
│ ├── ripgrep_util.py # ripgrep 搜索引擎
│ ├── lsp_diagnostics.py
│ ├── file_time.py # 读前编辑校验
│ └── prompts/ # 工具描述 .txt 文件 (17个)
│
├── provider/
│ └── provider_manager.py # 12个提供商, 53个模型, LLM缓存, 重试
│
├── bus/
│ └── event_bus.py # 事件总线 (发布/订阅 + SSE推送)
│
├── snapshot/
│ └── snapshot_manager.py # 文件快照 (diff/回退)
│
├── skill/
│ └── skill_def.py # 7个内置技能
│
├── patch/
│ └── patch_manager.py # 补丁追踪/回退
│
├── permission/
│ └── permission_manager.py # 危险命令检测
│
├── project/
│ └── project_manager.py
│
├── storage/
│ └── storage_manager.py # SQLite + 内存双写
│
├── vcs/
│ └── git_client.py
│
├── mcp/
│ ├── mcp_client.py # MCP 协议客户端
│ └── mcp_full.py
│
├── auth/
│ └── auth_manager.py # 认证系统
│
├── budget/
│ └── token_manager.py # Token 预算/计费
│
├── share/
│ └── share_manager.py # 会话分享
│
├── acp/
│ └── acp_client.py # Agent Client Protocol
│
├── lsp/
│ └── lsp_client.py # LSP 语言服务器客户端
│
├── config/
│ └── config_manager.py
└── retry/
 └── retry_manager.py

请求执行流程

Browser → POST /api/agent/run (SSE)
 ↓
routes/proxy.py → ContextEngine.build_system_prompt()
 ↓
 EventBus.publish(AGENT_START)
 ↓
 create_llm() → LLM 实例 (有缓存)
 ↓
 ReAct 循环 (最多30轮):
 LLM.invoke() → 有 tool_calls?
 ├─ 是 → 执行工具 → ToolMessage → 继续
 │ └─ task_delegate? → 启动子Agent → 合并结果
 └─ 否 → 输出 text-delta → final-answer
 ↓
 EventBus.publish(AGENT_COMPLETE)
 ↓
 StorageManager.save() → SQLite

提示词系统

Agent 提示词 (backend/agent/prompts/)

模型专属提示词 (backend/session/prompts/)

工具描述提示词 (backend/tools/prompts/)

提供商系统

工具系统

事件总线系统

SSE 事件流

连接建立 → agent.start
 ↓
thought (Processing request...)
 ↓
工具调用循环:
 tool-start (tool, args)
 tool-end (result, status)
 tool-loop-complete (iteration)
 ↓
 (可选) task_delegate → 子Agent执行 → tool-end
 ↓
text-delta (实时文本)
 ↓
final-answer (完整回复)
 ↓
agent.complete
 ↓
complete (session_id)

事件类型

Agent 系统

权限模式

快照系统

API 端点

技能系统

技术栈

前端

后端

环境变量

# 本地模型
OLLAMA_BASE_URL=http://localhost:11434
# 云端 API
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
OPENROUTER_API_KEY=sk-or-...
GROQ_API_KEY=gsk_...
GOOGLE_API_KEY=AIza...
DEEPSEEK_API_KEY=sk-...
TOGETHER_API_KEY=...
PERPLEXITY_API_KEY=...
XAI_API_KEY=...
DEEPINFRA_API_KEY=...
MISTRAL_API_KEY=...

Windows 注意事项