OCSR

OCSR（OpenCode Subagents Run）把 headless opencode run 用作独立于宿主框架的子代理执行后端，适合可配置模型的批处理 worker 和 fresh-context 对抗评审；亦提供层级指挥模式（planner / orchestrator / worker 分层编排，见 层级指挥专题）。

快速开始

前置条件：Windows PowerShell、Python 3，以及已配置模型 provider 的 OpenCode CLI。

opencode models
# <qualified-id> 必须存在于 ~/.ocsr/allowed-models.json（可用 OCSR_HOME 覆盖）
opencode run "请完成一个自包含任务" -m <qualified-id>
python scripts/verify_ocsr_skill.py

运行规则、prompt 六要素、产物回收和模型分工以 SKILL.md 为准。

文档

• Agent 协作入口：AGENTS.md
• 文档导航：docs/STRUCTURE.md
• 详细参考（渐进式披露，按需加载）：refs/ — 层级指挥、派发模式、converge 对接、模型默认池、失败模式、陷阱参考、release executor
• 当前状态与交接：docs/CURRENT.md
• 设计边界：docs/overview.md
• 本地运行：docs/deployment.md
• 已知陷阱：docs/pitfalls.md

只读面板

python scripts/ocsr_board.py   # 127.0.0.1:8787，自动开浏览器

本地面板展示各派发 worker 的状态、时长、session ID，支持按工作目录分组、拖动分组、点击 chips/时间/模型/关键字筛选、组折叠/聚焦/整组隐藏、时间排序与卡片/列表视图切换、失败原因直显与扫描目录在线管理；只读既有证据文件，不参与派发机制。详见 docs/deployment.md。

验证

python scripts/verify_ocsr_skill.py
python scripts/audit.py check
node --test tests/adapter/*.test.mjs   # dsh 适配层契约回归（需本机 dsh >= 0.2 运行时）

本仓库的核心产物是 skill 文档和机械验证脚本，不提供安全沙箱、常驻服务或通用运行时 wrapper。