opencode-configs

# OpenConfig [OpenCode](https://opencode.ai) + [OpenRouter](https://openrouter.ai) + [oh-my-openagent (OmO)](https://omo.vibetip.help/docs) 的全局配置。 **v1.5.30** · CLI **`oc`** · 身份 `openconfig/opencode-configs` ```bash git clone https://github.com/jesseoue/opencode-configs.git cd opencode-configs oc install --quick # 或：./install.sh --yes # 新机器 curl -fsSL https://raw.githubusercontent.com/jesseoue/opencode-configs/main/install.sh | bash source ~/.zshrc && oc doctor && oc launch ``` | | | | --- | --- | | **固定版本** | OpenConfig `1.5.30` · OpenCode `1.18.4+` · OmO `oh-my-openagent@4.19.0` · `@opencode-ai/plugin` `1.18.4` | | **默认领导** | `sisyphus` (GLM Exacto) | | **配置路径** | `~/.config/opencode` → 本仓库（符号链接） | | **项目首页** | `oc new` → `~/Projects/<name>` | | **健康检查** | `oc doctor` · `oc versions` · `oc test` | > 插件名称必须保持 **`oh-my-openagent@…`** （不是旧的 `oh-my-opencode`）。 > 模式 URL 基名保持 `oh-my-opencode.schema.json` （`oh-my-openagent.schema.json` 路径 404）。 决策日志：[`AGENTS.md`](./AGENTS.md) · 立场：[`prompts/core.md`](./prompts/core.md) · 更新日志：[`CHANGELOG.md`](./CHANGELOG.md) --- ## 安装 ```bash export OPENROUTER_API_KEY=… # 必需 export OPENAI_API_KEY=… # GPT 通道（Hephaestus / Oracle / Momus / …） export EXA_API_KEY=… # OmO 网络搜索 export CONTEXT7_API_KEY=… # 库文档 oc install --quick oc signature && oc test && oc versions && oc doctor oc launch ``` 或在安装后编辑密钥： ```bash $EDITOR ~/.config/opencode/.env # chmod 600; 绝不提交 source ~/.zshrc oc doctor && oc launch ``` --- ## 命令行界面 ```bash oc install --quick # 安装 / 刷新 oc check # 验证 + 医生 -- 快速 oc heal # 探测-first 自我修复 oc launch [dir] # TUI（从不在配置文件仓库启动） oc new myapp # 在 ~/Projects 下搭建 oc run "…" # 无头运行至完成 oc admin health # 实时 OpenRouter + OpenAI 探测 oc models --providers # OpenRouter 提供者健康检查，用于路由模型 oc versions # 固定版本 vs npm + GitHub（+ 其他 opencode.json） oc versions --fix # 将 ~/.opencode @opencode-ai/plugin 与 CLI 对齐 oc locate # 仓库 / CLI / 密钥 oc signature # 身份指纹 oc test # 烟雾测试 + 幂等性 oc doctor # 完整就绪检查 oc doctor --quick --json # 机器摘要（修复/检查工具） ``` 优先使用 `oc <cmd>` 而非原始 `./foo.sh`。完整帮助：`oc help`。 --- ## 软件包固定版本 版本和 OmO 固定版本位于 [`versions.json`](./versions.json)。`opencode.json` 中的 OmO 插件字符串必须匹配。随时审计： ```bash oc versions # 本地固定版本 + npm/GitHub 最新版本 oc versions --local # 无网络 oc versions --json # 机器可读 oc versions --fix # 将 ~/.opencode @opencode-ai/plugin 设置为与 OpenCode CLI 匹配 ``` | 软件包 | 真相来源 | 当前版本 | | --- | --- | --- | | OpenConfig | `versions.json` → `opencode_configs` | `1.5.30` | | OpenCode CLI | 安装 + `versions.json` → `opencode.min` | `1.18.4+` | | OmO | `opencode.json` 插件 + `versions.json` → `oh_my_openagent.pin` | `4.19.0` | | `@opencode-ai/plugin` | `~/.opencode/package.json`（对等；不在此仓库） | 与 CLI 匹配 | `oc versions` 还列出了 `~/Projects` 和 `/Users/Shared` 下的其他 `opencode.json` 文件。这些是项目叠加层 — OmO 在此处全局固定。 --- ## 工具 | 需求 | 工具 | 备注 | | --- | --- | --- | | 本地代码 | `read` · `grep` · `glob` · codegraph · LSP | 始终优先 | | 库/框架 API | **Context7** MCP | `resolve-library-id` → `query-docs` | | GitHub 调用站点 | **grep_app** (OmO) | 公共仓库模式 | | 当前网页 | **websearch** (Exa) | 理想页面查询；然后 webfetch | | 已知 URL | **webfetch** | 清洁 Markdown | | 截图/UI | **look_at** (OmO) | 多模态观察者 | **Exa:** 描述理想页面，而不是关键词汤。可选：`category:company` · `category:people` · `category:news` · `category:research paper`。 | 界面 | 状态 | | --- | --- | | Context7 MCP | 已启用（`CONTEXT7_API_KEY`） | | Exa 网络搜索 | 已启用（`EXA_API_KEY`） | | codegraph | 已启用 · 遥测关闭 · `~/.omo/codegraph` | | LSP | TypeScript · Python · Go 仅限 | | 格式化工具 | Prettier + Ruff | | 技能 | `content-aware-recon` · `content-aware-audit` 在 `skills/` 下（围栏） | | OmO `security-*` 技能 | 已禁用（挂起无头 `oc run`）— 使用本地内容感知技能 | | 额外 MCP | 已禁用（PostHog、Sentry、Playwright MCP、…） | | 遥测 | 关闭（OpenCode 共享/OTel · OmO PostHog · codegraph · `DO_NOT_TRACK`） | 故意禁用（噪音/陷阱）：`interactive_bash`，监控工具，`session_list` / `session_search`。 编码在 `prompts/core.md`，`sisyphus` 和 `librarian` 中。 --- ## 代理 ### 主要 | 代理 | 模型 | 角色 | | --- | --- | --- | | **sisyphus** | GLM 5.2 Exacto | 默认调度器 / 领导 | | **hephaestus** | GPT-5.6 Sol（直接 OpenAI） | 实现 | | **prometheus** | GLM 5.2 Exacto | 计划者 | | **atlas** | GLM 5.2 Exacto | 计划执行器，在 `/start-work` 之后 | | **content-aware-research** | DeepSeek V4 Pro | 深度研究（编辑被拒绝） | ### 子代理（`task` / `call_omo_agent` — 不是团队成员） | 代理 | 模型 | 角色 | | --- | --- | --- | | oracle | GPT-5.6 Sol | 批评 / 裁决 | | librarian | DeepSeek Flash Nitro | 文档（优先使用 Context7） | | explore | DeepSeek Flash Nitro | 代码库地图 | | multimodal-looker | Claude Sonnet 5 | 视觉（`look_at`） | | metis | Claude Sonnet 5 | 预规划批评者 | | momus | GPT-5.6 Sol 最大 | 计划 / 审查门控 | | sisyphus-junior | DeepSeek Flash Nitro | 廉价委托工作 | 原生 OpenCode `build` 已禁用。`plan` 保持降级为超计划交接 — **不要**将其放入 `disabled_agents`。 --- ## 类别 | 类别 | 模型 | 用途 | | --- | --- | --- | | `bug-hunt` | GLM Exacto | 重现 → 根原因 → 修复 | | `refactor-safe` | GLM Exacto | 行为保留重构 | | `arch-review` | GPT-5.6 Sol | 耦合 / 爆炸半径 | | `content-aware-fast` | DeepSeek Flash Nitro | 攻击面侦察 | | `content-aware-deep` | DeepSeek Pro Exacto | 深度漏洞研究 | | `writing` | Gemini 3.6 Flash Nitro | 文档 / 散文 | | `visual-engineering` | Gemini 3.1 Pro | 发布 UI | | `artistry` | Gemini 3.1 Pro | 设计方向 | | `quick` | DeepSeek Flash Nitro | 廉价快速任务 | | `deep` / `ultrabrain` | GPT-5.6 Sol | 重度 / 最大推理 | | `unspecified-low` / `unspecified-high` | Flash / Claude Fable | 超计划批评者 | --- ## 关键词与交接 | 说 | 效果 | | --- | --- | | `ultrawork` / `ulw` | Claude Fable 最大上限 | | `team` | 团队模式扩展 | | `hyperplan` / `hpp` / `/hyperplan` | 对抗性规划（来自 **sisyphus**） | | `/goal` | **已禁用** — OmO 4.19 目标钩子破坏 `/start-work`。使用 `/start-work` → Atlas（`prompts/goal.md`） | | `/start-work` | Atlas 执行已批准的 Prometheus 计划 | --- ## 团队 领导：**sisyphus**。`teams/` 中的规格被符号链接到 `~/.omo/teams/` 通过 `oc setup`。 合格：`sisyphus`，`atlas`，`sisyphus-junior`，`hephaestus`（`teammate: allow`），或 `kind: category`。 硬拒绝作为队友：explore · librarian · oracle · metis · momus · multimodal · prometheus。 旋钮：`max_parallel_members=4` · `max_members=5` · 邮箱轮询 `1000ms` · tmux `main-vertical` / `inline`。 | 团队 | 成员（内联提示：角色 / 可交付成果 / 邮箱） | | --- | --- | | `explorers` | scout-code（`deep`）+ scout-docs（`quick`） | | `ship-feature` | forge（hephaestus）+ junior + verifier（`bug-hunt`） | | `debug-team` | reproducer（`bug-hunt`）+ root-cause（`ultrabrain`） | | `review-panel` | arch + bugs + cleanup（仅限发现/提案） | | `refactor-team` | analyzer（`arch-review`）+ executor（`refactor-safe`） | | `docs-team` | api-docs + guide（`writing`） | | `content-aware-audit` | recon（`content-aware-fast`）+ deep（`content-aware-deep`） | --- ## 模型路由 | 通道 | 模型 | 用于 | | --- | --- | --- | | 调度 | `z-ai/glm-5.2:exacto` | Sisyphus / Atlas / Prometheus / bug-hunt | | GPT（直接） | `openai/gpt-5.6-sol`（+ terra / 5.5 备用） | Hephaestus / Oracle / Momus / deep / … | | 侦察 | `deepseek/deepseek-v4-flash:nitro` | explore / librarian / junior / quick | | 深度 | `deepseek/deepseek-v4-pro:exacto` | content-aware / 硬备用 | | 视觉/写作 | Gemini 3.1 Pro · 3.6 Flash Nitro | artistry / visual / writing | | 天花板 | `anthropic/claude-fable-5` | ultrawork · unspecified-high | OpenRouter 是主要的。GPT 代理优先使用 **直接 OpenAI**。API 错误时备用 + `runtime_fallback`。流超时：**900s**。 ### 并发 优先级：`modelConcurrency` → `providerConcurrency` → `defaultConcurrency`。`oc heal` / `fix.sh` 重新应用上限如果它们漂移。 | 旋钮 | 值 | | --- | --- | | `background_task.defaultConcurrency` | **4** | | OpenRouter / OpenAI / Anthropic | **6 / 4 / 2** | | Flash / Exacto / Sol / Fable | **4 / 3 / 3 / 1** | | 团队并行 / 最大成员 | **4 / 5** | | 目标 / 过时 / TTL | **关闭 / 180s / 30m** | --- ## API 密钥 | 密钥 | 必需 | 启用 | | --- | --- | --- | | `OPENROUTER_API_KEY` | **是** | OpenRouter 模型 | | `OPENAI_API_KEY` | **是** 用于 GPT 通道 | Hephaestus / Oracle / Momus / deep / … | | `EXA_API_KEY` | 用于网络搜索 | OmO Exa | | `CONTEXT7_API_KEY` | 推荐 | Context7 | | `OPENROUTER_MGMT_KEY` | 可选 | `oc admin` | | `OC_PROJECTS_DIR` | 可选 | `oc new` 主目录（默认 `~/Projects`） | 复制 `.env.example` → `.env`（`chmod 600`）。绝不提交 `.env`。 `oc setup --sync-env` 仅导入 **允许列出的密钥** 从 Infisical/Doppler — 绝不是完整的保险库转储。 --- ## 提示 每个 OmO 代理/类别加载 `prompt_append` 从 `prompts/`。`prompts/profiles/` 下的配置文件简要介绍了 `oc new` 搭建。 | 路径 | 内容 | | --- | --- | | `prompts/core.md` | 全局立场，工具矩阵，团队资格 | | `prompts/goal.md` | 为什么 `/goal` 关闭；使用 `/start-work` → Atlas | | `prompts/agents/*.md` | 代理附加内容 | | `prompts/categories/*.md` | 类别附加内容 | | `prompts/profiles/*.md` | 配置文件简介 | | `agents/content-aware-research.md` | OpenCode 主要代理定义（与提示同步） | --- ## 配置文件和搭建 ```bash oc new myapp # ~/Projects/myapp · 配置文件 high oc new myapp --profile research oc new myapp --profile content-aware oc projects --list ``` | 配置文件 | 代理 | 调整 | | --- | --- | --- | | `high` | sisyphus | 默认 Exacto · 平衡 tool_output | | `low` | sisyphus | 成本优先 · 更小的 tool_output | | `fast` | hephaestus | 直接 GPT Sol · 跳过仪式 | | `research` | sisyphus | 大型 tool_output · 深度 / ultrabrain / 内容感知 | | `debug` | sisyphus | 大型 tool_output · bug-hunt / 调试团队 | | `writing` | sisyphus | Gemini Flash small_model · 写作类别 | | `content-aware` | content-aware-research | 编辑拒绝 · 专业 + 侦察/审计技能 | 每个项目获取 `opencode.json` + `AGENTS.md`。不要将 `OPENCODE_CONFIG` 设置为 `.opencode/profile.json`。 --- ## 安全 - 本地允许所有正常工具（受信任盒）。 - 硬拒绝 bash：`rm -rf /|~`，`mkfs`，`sudo`，`git push --force*`，`gh repo delete*`。 - 允许的提供者：仅 OpenRouter + OpenAI。 - 服务器：`127.0.0.1:4097` · 禁用共享 · 关闭多播 DNS。 --- ## 终端 - **Ghostty** ≥ 1.3.0 · **tmux** ≥ 3.3（推荐 3.7+）· zsh 片段 - OpenCode 领导 **Ctrl+X** · tmux 前缀 **Ctrl+B** · 选项卡循环代理 - 拆除从不发送 `\033[?1049l`（不会清除可见屏幕） - `opencode()` / `oc launch` 从不在配置文件仓库或裸 `~/Projects` 启动 --- ## 布局 ``` opencode-configs/ ├── oc · install.sh · setup.sh · doctor.sh · validate.sh · fix.sh ├── models.sh · versions.sh · cleanup.sh · signature.sh · locate.sh ├── opencode.json · oh-my-openagent.json · tui.json ├── versions.json · signature.json · projects.json · AGENTS.md ├── agents/content-aware-research.md ├── profiles/ · prompts/ · teams/ · skills/ ├── .env.example └── zshrc.snippet · ghostty.conf · tmux.conf ~/.config/opencode → 本仓库 ~/Projects/ → oc new 主目录 ~/.omo/teams/ → 团队规格 ~/.opencode-backups/→ 备份 + 安装/修复日志 ``` --- ## 验证 ```bash oc signature && oc test && oc validate && oc versions && oc doctor bunx oh-my-openagent@4.19.0 doctor # 上游：系统正常 ``` 幂等性：重新运行安装/设置/修复/修复健康状况在健康的盒子上不应覆盖 `.env`，重写正确的符号链接，或增加干净配置的修改时间。 --- ## 上游 | 层级 | 文档 | 来源 | | --- | --- | --- | | OpenCode | [opencode.ai/docs](https://opencode.ai/docs) | [anomalyco/opencode](https://github.com/anomalyco/opencode) | | OmO | [omo.vibetip.help/docs](https://omo.vibetip.help/docs) | [code-yeongyu/oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) | | OpenRouter | [openrouter.ai/docs](https://openrouter.ai/docs) | Exacto / Nitro 路由 | | Context7 | [context7.com](https://context7.com) | [upstash/context7](https://github.com/upstash/context7) | | Exa | [docs.exa.ai](https://docs.exa.ai) | [exa-labs](https://github.com/exa-labs) | 安装程序仅从 `https://opencode.ai/install` 拉取 OpenCode，从 npm `oh-my-openagent@4.19.0` 拉取 OmO。 --- ## 反模式 - 不要将插件名称更改为 `oh-my-openagent` - 不要添加 Cloudflare / AI Gateway / OpenAI 兼容的伪装层 - 不要将 `plan` 放入 `disabled_agents`（破坏超计划） - 不要提交 `.env`、`package.json`、`node_modules`、`/.omo`、`.sisyphus` 或此处的 `plugins/` - 不要在该仓库中搭建应用 — 使用 `oc new` - 不要将 `.opencode/profile.json` 加载为 `OPENCODE_CONFIG` - 不要重新启用遥测或 OmO `security-*` 技能 - 在 OmO 4.19 上不要重新启用 `/goal`，直到 `/start-work` 安全。