Skip to content

快速安装与全景控制台

开箱即用的 OpenCode 生产级工程化配置:一支专家智能体团队、三种编排模式、分层 MCP 代码智能与数据库网关、一键模型预设、工作流斜杠命令、可选的项目级护栏 —— 一条命令安装到 ~/.config/opencode


⚡ 10 秒一键安装

无需手动克隆仓库,复制并在终端中运行单行命令即可直接安装到 ~/.config/opencode

macOS / Linux / WSL

bash
rm -f /tmp/ocp.tar.gz && rm -rf /tmp/opencode-prime-* && curl -fsSL https://github.com/kenlin8827/opencode-prime/releases/latest/download/opencode-prime-latest.tar.gz -o /tmp/ocp.tar.gz && tar xzf /tmp/ocp.tar.gz -C /tmp && bash /tmp/opencode-prime-*/install/install.sh; rm -f /tmp/ocp.tar.gz; rm -rf /tmp/opencode-prime-*

Windows (PowerShell)

powershell
$url = "https://github.com/kenlin8827/opencode-prime/releases/latest/download/opencode-prime-latest.zip"; Remove-Item -Path "$env:TEMP\ocp.zip","$env:TEMP\ocp" -Recurse -Force -ErrorAction SilentlyContinue; Invoke-WebRequest -Uri $url -OutFile "$env:TEMP\ocp.zip"; Expand-Archive -Path "$env:TEMP\ocp.zip" -DestinationPath "$env:TEMP\ocp" -Force; & (Get-ChildItem "$env:TEMP\ocp\opencode-prime-*\install\install.ps1").FullName; Remove-Item -Path "$env:TEMP\ocp.zip","$env:TEMP\ocp" -Recurse -Force -ErrorAction SilentlyContinue

💡 零风险平滑升级:已安装的用户重复执行上述命令可直接升级到最新版本,你的 API 密钥、自定义模型和模型梯队选择均会完整保留,不会丢失。


单屏 TUI 全景控制台

执行安装命令后(或后续随时在终端运行全局命令 ocp / opencode-prime),终端将直接唤出 单屏 TUI 全景控制台

OpenCode TUI 全景控制台

核心功能与交互说明

  • 实时微调:按空格键秒级切换启用的 MCP 服务、外部插件、RTK 令牌压缩器,或按空格键循环调整各 Agent 所属模型梯队(flash / standard / pro / max / vision);
  • 快捷键指南
    • / j / k:上下移动光标选择配置项
    • Space(空格键):切换 MCP/插件开关,或循环切换 Agent 梯队
    • Enter(回车键):执行当前选中的操作(如“保存配置并执行安装”)
    • L 键:即时切换控制台显示语言(中/英)
    • Q 键:退出控制台

全局快捷命令 (ocp / opencode-prime)

安装完成后,系统已自动注册全局快捷命令。你可以在任意终端路径下直接输入以下任一命令:

bash
ocp              # 极简 3 字母直达(推荐)
opencode-prime   # 完整品牌命令
opencode-config  # 兼容命令

后续无需记住复杂的安装路径,即可随时秒级唤出全景控制台进行配置微调或一键平滑升级!


核心特性矩阵

特性对你的意义
专家智能体团队21 位专家(@java-dev@security@dba@frontend-dev@fast-coder 等),提示词按领域调优,自动路由
三种工作模式@code(直接开发,默认)、@build(编排执行)、@plan(只读分析)—— 可在 install/options.jsonc 中切换
代码智能与数据库(MCP)预配置 MCP 服务(Serena LSP、CodeGraph 图谱、GitNexus、DBHub 数据库网关),开箱按需自动装 CLI
配置预设(Profiles)/profile 一次性把 5 个模型层级映射到某服务商的模型 —— 无需逐智能体 set model
工作流斜杠命令/quick-dev · /fast-dev · /deep-dev · /ultra-dev 开发闭环、/review-fix-loop/grill-improve-loop/goal/handoff/grill-me、advisor 模式等
可选护栏按项目启用的 ADR 强制(/adr-guard)、密钥文件门控(env-guard)、E2E 门控(/e2e-guard)、提交纪律(/project)—— 全部默认关闭
一键安装器PowerShell + Bash 双平台,基于清单升级;凭证和模型选择在每次重装后完好保留
Token 节省安装时自动配置 rtk 输出压缩(60–90%)
第二意见顾问@advisor 为阻塞性决策提供独立意见,设计审查时可切换对抗式 red-team 立场

⚖️ 定位对比:omp 与 OpenCode Prime

两种电池,装在两种车上。omp 自建并交付一个原生运行时;OCP 则把工程纪律的电池装进你正在使用的 OpenCode。

维度omp (omp.sh)OpenCode Prime (OCP)
与运行时的关系独立智能体外壳——替换你的 Agent 运行时零迁移的纪律层——保留 OpenCode 运行时、插件与全部配置
开箱能力侧重🔧 原生工具火力:~8 万行 Rust 核心、hashline 编辑、内置 LSP/DAP、记忆、浏览器、协作🧰 工程纪律火力:21 位专家智能体、MCP 代码智能、/profile 预设、护栏、工作流命令
交付分档魔法关键词(ultrathink / orchestrate),单轨自主推进🏆 /quick-dev · /fast-dev · /deep-dev · /ultra-dev 显式人选档位,可写入团队 SOP
调度与编排🟢 task 子智能体扇出至隔离工作树,类型化结果,实时监督面板🏆 @build 编排器 + 预定义角色流水线(执行计划先公示再执行)+ 分级模型调度(Flash 写码、旗舰审查)+ 动态领域人格注入 + 失败自动重试并原任务续跑
审查门控/review 事后判级 P0–P3,单一审查者🏆 /deep-dev 旗舰双审 + @advisor 安全仲裁,修复在闭环内收敛
规范驱动生命周期无内置(需外接工具)🏆 /prd/plan(自动链接 PRD 与 ADR)→ /impl/sdd handoff 完整 SDD 生命周期
工作流命令套件ultrathink / orchestrate / workflowz 关键词🏆 /grill-me 苏格拉底式方案拷问 + /review-fix-loop 自动修复至零 P0/P1 + /grill-improve-loop 评分驱动改进闭环 + /goal 机械可校验的停止条件 + /handoff git-safe 会话交接包
Token 与成本治理hashline 编辑省 token + 进程内高效工具🏆 五级智能体—模型路由(tiers.json)+ RTK 代理层输出压缩 60–90%,安装时自动配置
工程护栏流式规则实时纠偏模型行为🏆 可审计的策略级门控:ADR/MADR 强制 + 密钥文件拦截 + E2E 门控 + 提交纪律
代码情报🟢 内置 LSP/DAP/AST(14 LSP + 28 DAP 操作)Serena LSP + CodeGraph 调用图 + GitNexus + DBHub 数据库网关
服务商治理60+ 服务商,角色制路由🏆 /profile 一键五级映射——36 个预设全覆盖 OpenCode 内置官方模型族(opencode-go)及 Anthropic / OpenAI / Google / DeepSeek 等一线服务商、路由器方案,国内 Coding Plan 一等公民;TUI 仪表盘
升级安全性二进制重装🏆 基于清单的零风险升级——每次重装后 Key 与模型选择完整保留
文档英文🏆 完整双语文档树(English + 中文)
生态与扩展性🟢 TS 扩展模块、插件热重载,兼容继承 8 种已有配置格式🏆 骑在 OpenCode 生态上——整个 npm 插件库、MCP 生态与社区资产直接复用;OCP 自身亦由 30+ 可插拔插件组合而成
客户端 / UI 面终端 TUI + Zed(ACP)+ 协作观看页🏆 TUI + 浏览器 Web UI + OpenChamber 桌面 GUI(并列差异对比、多模型对比)——同一套配置全端共享,零重复配置

🎯 怎么选?

  • 选择 omp.sh:想要一个电池全装的原生外壳,并且愿意整体替换运行时——它的 Rust 工具链、hashline 编辑和 DAP 调试确实出色。
  • 选择 OpenCode Prime:在 OpenCode 上做真实商业软件,想要显式交付分档、多模型审查门控、可审计的策略护栏和国内服务商治理——不离开你已投入的生态。
  • 两者可以共存:omp 作为独立火力工具,OCP 作为 OpenCode 技术栈内的团队纪律。

下一步:项目初始化

安装好全局配置后,进入任意代码仓库后的黄金第一步就是运行 /project init,自动构建本地代码知识图谱与工程护栏:

👉 前往查看:项目初始化与工程护栏

基于 MIT 协议发布。