什么是occ
OCC（OpenCode Controller）是一个命令行工具，用于控制 OpenCode 执行开发任务。它通过 CLI 接口与 OpenCode 进行交互，实现对代码生成、编辑和调试等开发流程的自动化管理。该工具特别适合需要从外部系统或脚本中调用 OpenCode 能力的场景，例如集成到 CI/CD 流水线或构建自定义开发工作流。OCC 的核心设计目标是简化 OpenCode 的使用门槛，让用户能够以编程方式触发和管理开发会话，从而提升团队协作效率与开发体验。 使用 OCC 时，用户首先需确保 OpenCode CLI 已安装并配置在系统 PATH 中。随后，可在任意项目目录下运行命令，OCC 会自动检测当前环境是否存在可用的 OpenCode Server。若未找到，则自动启动一个新的服务器实例。这一机制使得开发者无需手动管理服务端进程，极大降低了上手难度。OCC 支持两种主要操作模式：创建新会话或继续已有会话，分别对应不同的开发任务阶段，如需求分析、功能实现或问题修复。 整个工作流程强调自动化与无缝衔接。OCC 通过端口扫描（4096–4200）定位现有服务，避免冲突；同时利用 OpenCode 的会话 API 完成任务的委派与追踪。这种架构不仅保证了灵活性，也确保了资源的高效利用。无论是独立开发者还是大型团队，都能借助 OCC 将 AI 辅助编码能力嵌入日常开发实践中，实现从想法到代码的快速转化。
核心功能特点
- 通过命令行界面控制 OpenCode 执行各类开发任务
- 自动检测并启动 OpenCode Server，无需手动配置服务
- 支持创建新会话或继续已有会话，适应不同开发阶段需求
- 内置端口扫描机制，智能管理服务器实例避免冲突
- 可与外部系统集成，实现开发流程自动化
适用场景
OCC 最适用于需要将 AI 驱动编码能力融入自动化工作流的场景。例如，在持续集成/持续部署（CI/CD）系统中，可通过 OCC 自动触发代码生成或测试用例编写，减少人工干预。当团队采用敏捷开发模式时，项目经理可借助 OCC 快速分配任务给 OpenCode，加速原型验证和功能迭代。此外，对于远程协作环境，OCC 允许从中央控制系统发起多个并行开发会话，统一监控进度并汇总结果，显著提升跨地域团队的协同效率。 另一个典型应用场景是本地开发者的个人效率提升。开发者可以在终端中直接调用 OCC 创建专注的编码会话，专注于特定模块的实现，而无需频繁切换上下文或记忆复杂指令。比如，在处理遗留系统重构时，OCC 可帮助自动生成适配层代码或迁移脚本，大幅缩短技术债务清理周期。同时，由于 OCC 完全基于 CLI 操作，它也天然适合与编辑器插件、脚本工具或 DevOps 平台对接，形成端到端的智能化开发闭环。 在企业级应用中，OCC 还可作为标准化开发接口的一部分，确保所有团队成员使用一致的方式调用 OpenCode 能力，避免因个体差异导致的质量波动。结合权限控制与审计日志，企业能更好地管理 AI 辅助开发的合规性与可追溯性。总体而言，任何希望将 OpenCode 深度整合进现有开发体系——无论是个人项目、小型团队还是大型企业——都能从 OCC 提供的轻量化、可编程的控制能力中获益。