移动优先的 Web 界面,用于管理、控制和与多个 OpenCode AI 代理协作编程。支持多仓库 Git 管理、实时聊天、语音交互、MCP 服务器集成,可通过 Docker 私有化部署。
OpenCode Manager 是一个移动优先的 Web 界面,作为 OpenCode AI 的第三方管理工具,由 Chris Scott(chriswritescode-dev)维护。
核心能力#
Git 集成#
- 多仓库支持,支持 SSH 认证
- Worktrees 管理
- 统一 diff 视图,带行号
- 直接从 UI 创建 PR
文件管理#
- 目录浏览器,支持树视图
- 语法高亮
- 创建/重命名/删除文件
- ZIP 下载功能
实时聊天#
- SSE 实时流式响应
- Slash 命令支持
- @file 提及功能
- Plan/Build 模式
- Mermaid 图表渲染
音频功能#
- 文本转语音(TTS):浏览器原生 + OpenAI 兼容 API
- 语音转文字(STT):浏览器原生 + OpenAI 兼容 API
AI 配置#
- 模型选择与提供商配置
- OAuth 支持:Anthropic、GitHub Copilot
- 自定义代理与系统提示
MCP 支持#
- 本地和远程 MCP 服务器支持
- 预构建模板
Memory 插件(可选)#
- 持久化项目知识
- 语义搜索
- 规划状态管理
- 压缩感知
移动端体验#
- 响应式 UI
- PWA 可安装
- iOS 优化(键盘处理、滑动导航)
- 推送通知(VAPID)
架构设计#
项目结构#
opencode-manager/
├── backend/ # Bun + Hono 后端
├── frontend/ # React + Vite + Tailwind 前端
├── packages/memory/ # Memory 插件包
├── shared/ # 共享代码
├── docs/ # MkDocs 文档
└── scripts/ # 构建脚本
后端技术栈#
- 运行时:Bun
- Web 框架:Hono
- 认证:better-auth + @better-auth/passkey
- 推送:web-push
- 验证:Zod
- 测试:Vitest
前端技术栈#
- 框架:React 19
- 构建工具:Vite 7
- 样式:Tailwind CSS 4
- 状态管理:Zustand
- 数据获取:@tanstack/react-query
- UI 组件:Radix UI 系列
- 编辑器:Monaco Editor
- Markdown 渲染:react-markdown + remark-gfm + rehype-highlight
- 图表:Mermaid
- 拖拽:@dnd-kit
部署方式#
Docker 快速部署(推荐)#
git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager
cp .env.example .env
docker-compose up -d
# 访问 http://localhost:5003
环境变量配置#
AUTH_SECRET=your-secure-random-secret
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=your-secure-password
AUTH_TRUSTED_ORIGINS=http://localhost:5003,https://yourdomain.com
AUTH_SECURE_COOKIES=false # 使用 HTTPS 时设为 true
典型应用场景#
- 远程代码管理:通过手机或平板随时随地管理多个 Git 仓库
- AI 辅助编程:与 OpenCode AI 代理实时交互,获取代码建议和自动化操作
- 代码审查:查看 diff、管理分支、创建 PR
- 多设备协作:PWA 安装后可在任何设备上使用,支持推送通知
- 私有化部署:支持 Docker 一键部署,适合隐私敏感环境
许可证#
MIT License
版本信息#
- 当前版本:v0.9.04
- 主要语言:TypeScript (98.8%)
- 包管理器:pnpm@10.28.1
待确认信息#
- 商业支持:文档未提及商业支持或企业版
- 性能基准:无公开性能测试数据
- 安全审计:无第三方安全审计报告
- OpenCode AI 依赖版本:未明确指定兼容的 OpenCode AI 版本