oh-my-opencode-cohub 1.0.17 → 1.0.19

package/README.md

@@ -1,246 +1,306 @@
-# oh-my-opencode-cohub
-
-OpenCode 中文智能体编排插件 CoHub——纯调度模式、全中文提示词、规范分析代理、方案制定代理。
-
-## 特性
-
-- 🚀 **独立运行**：纯 OpenCode Plugin，依赖 `@opencode-ai/plugin` SDK，零外部插件依赖
-- 🤖 **12 个内置代理**：8 个通用代理（orchestrator/oracle/librarian/explorer/designer/fixer/observer/council）+ 4 个规范/方案代理（rule-user/rule-project/rule-app/planner）
-- 🪝 **自动注入**：通过 `system.transform` 钩子在每次 LLM 调用时注入中文语言要求
-- 🧠 **纯调度 Orchestrator**：不碰任何文件工具，只负责规划、委派、验证
-- 🇨🇳 **全中文提示词**：8 个内置代理 + 4 个插件代理全中文
-- 📋 **规范分析代理**：rule-user（用户AGENTS.md）、rule-project（项目AGENTS.md）、rule-app（.opencode/rules/）
-- 🎯 **方案制定代理**：planner 综合所有输入输出结构化任务分解
-- 🔗 **OpenSpec + Superpowers 死板路由**：收到需求即触发，不判断"大小"
-- ⚡ **六步工作流**：理解→收集→规范分析→制定方案→调度→验证
-- 📜 **AGENTS.md 全覆盖**：项目级和用户级 AGENTS.md 对**本插件所有代理**（内置 8 个 + 插件 4 个）均生效，无需额外配置
-- 📖 **架构借鉴**：插件架构和代理编排理念借鉴了 oh-my-opencode-slim，但完全独立实现、无运行时依赖
-
-## 安装
-
-### 前置条件
-
-- [OpenCode](https://opencode.ai) 已安装
-- 推荐安装 [Bun](https://bun.sh)（CLI 一键安装需要）
-
-### 方式一：CLI 一键安装（推荐）
-
-```bash
-bunx oh-my-opencode-cohub install
-```
-
-CLI 会自动完成以下操作：
-
-1. 将 `oh-my-opencode-cohub` 注册到 `~/.config/opencode/opencode.json` 的 `plugin` 数组
-2. 将插件注册到 TUI 配置 `~/.config/opencode/tui.json`
-3. 在 `opencode.json` 的 `agent` 字段中注册全部 12 个 `co-*` 代理
-4. 写入默认配置文件 `~/.config/opencode/oh-my-opencode-cohub.json`
-
-重启 OpenCode 即可生效。
-
-### 方式二：npm 安装 + 手动配置
-
-```bash
-npm install oh-my-opencode-cohub
-```
-
-然后在 `~/.config/opencode/opencode.json` 中添加：
-
-```json
-{
-  "plugin": ["oh-my-opencode-cohub"]
-}
-```
-
-重启 OpenCode 即可。
-
-### 卸载
-
-```bash
-bunx oh-my-opencode-cohub uninstall
-```
-
-CLI 会精确清理所有 `co-*` 代理和相关配置，不影响其他插件的配置数据。
-
-如果使用 npm 手动安装，则需手动从 `opencode.json` 的 `plugin` 数组中移除 `"oh-my-opencode-cohub"`，然后 `npm uninstall oh-my-opencode-cohub`。
-
-### 验证安装
-
-安装并重启 OpenCode 后，确认以下效果：
-
-- 对话中自动出现 **中文语言要求**（如 "你必须始终使用中文进行思考、推理和回复"）
-- 可用代理列表中出现 12 个 `co-*` 前缀代理（`co-orchestrator`、`co-oracle`、`co-librarian`、`co-explorer`、`co-designer`、`co-fixer`、`co-observer`、`co-council`、`co-rule-user`、`co-rule-project`、`co-rule-app`、`co-planner`）
-- Orchestrator 自动进入纯调度模式（只做规划、委派、验证，不直接操作文件）
-
-### 从源码安装（本地开发）
-
-如果需要修改源码或使用开发版本：
-
-```bash
-# 1. 克隆项目
-git clone <repo-url> && cd oh-my-opencode-cohub
-
-# 2. 安装依赖
-npm install
-
-# 3. 构建（需要系统已安装 Bun）
-npm run build
-
-# 4. 方式 A：npm link 全局链接（推荐）
-npm link
-bunx oh-my-opencode-cohub install
-# 重启 OpenCode 即可。之后修改源码只需重新 npm run build
-
-# 4. 方式 B：手动配置绝对路径
-# 编辑 ~/.config/opencode/opencode.json，在 plugin 数组中写入项目绝对路径：
-# { "plugin": ["/absolute/path/to/oh-my-opencode-cohub"] }
-# 然后手动运行 CLI 注册代理：
-# node dist/cli/index.js install
-```
-
-> **构建依赖**：`npm run build` 使用 `bun build` 和 `tsc`。系统需安装 [Bun](https://bun.sh)（构建工具）和 Node.js（类型声明生成）。所有 `@opencode-ai/*`、`@opentui/*`、`zod` 均为 external，不打包进 `dist/`。
-
-## 代理一览
-
-### 代理（12 个，全中文提示词）
-
-| 代理 | 默认模型 | 职责 | 读取源 |
-|------|----------|------|--------|
-| co-orchestrator | `deepseek/deepseek-v4-pro` | 纯调度：规划→委派→验证 | — |
-| co-oracle | `deepseek/deepseek-v4-pro` | 架构审查/代码审查（含 Superpowers skills） | — |
-| co-librarian | `deepseek/deepseek-v4-flash` | 外部文档/API 研究 | — |
-| co-explorer | `deepseek/deepseek-v4-flash` | 代码库搜索定位 | — |
-| co-designer | `minimax/MiniMax-M3` | UI/UX 设计与实现 | — |
-| co-fixer | `deepseek/deepseek-v4-flash` | 代码修改执行（含 TDD skill） | — |
-| co-observer | `codermxtest/gpt-5.5` | 图片/PDF 分析 | — |
-| co-council | `deepseek/deepseek-v4-pro` | 多模型共识 | — |
-| co-rule-user | `deepseek/deepseek-v4-flash` | 用户级规范分析 | `~/.config/opencode/AGENTS.md` |
-| co-rule-project | `deepseek/deepseek-v4-flash` | 项目级规范分析 | 项目 `AGENTS.md` |
-| co-rule-app | `deepseek/deepseek-v4-flash` | 应用规则分析 | `.opencode/rules/*.md` |
-| co-planner | `deepseek/deepseek-v4-pro` | 方案制定 | 综合需求+信息+规则 |
-
-> 模型可通过下文「配置文件」或「自定义模型」章节覆盖。
-
-## 配置文件
-
-CLI 安装后自动创建 `~/.config/opencode/oh-my-opencode-cohub.json`，这是 CoHub 的专用配置文件，结构如下：
-
-```json
-{
-  "$schema": "https://unpkg.com/oh-my-opencode-cohub@latest/oh-my-opencode-cohub.schema.json",
-  "agents": {
-    "co-orchestrator": { "model": "deepseek/deepseek-v4-pro", "variant": "max" },
-    "co-oracle":      { "model": "deepseek/deepseek-v4-pro", "variant": "max" },
-    "co-librarian":   { "model": "deepseek/deepseek-v4-flash", "variant": "low" },
-    "co-explorer":    { "model": "deepseek/deepseek-v4-flash", "variant": "low" },
-    "co-designer":    { "model": "minimax/MiniMax-M3", "variant": "medium" },
-    "co-fixer":       { "model": "deepseek/deepseek-v4-flash", "variant": "high" },
-    "co-observer":    { "model": "codermxtest/gpt-5.5", "variant": "low" },
-    "co-council":     { "model": "deepseek/deepseek-v4-pro", "variant": "high" },
-    "co-rule-user":   { "model": "deepseek/deepseek-v4-flash", "variant": "medium" },
-    "co-rule-project":{ "model": "deepseek/deepseek-v4-flash", "variant": "medium" },
-    "co-rule-app":    { "model": "deepseek/deepseek-v4-flash", "variant": "medium" },
-    "co-planner":     { "model": "deepseek/deepseek-v4-pro", "variant": "high" }
-  }
-}
-```
-
-直接编辑此文件即可修改任意代理的模型和变体。`$schema` 提供 IDE 自动补全支持。
-
-> **注意**：同一目录 `~/.config/opencode/oh-my-opencode-cohub/` 下也可放置 `{agent}.md` 提示词覆盖文件（见「自定义提示词」章节），与 JSON 配置文件共存。
-
-## 工作流
-
-```
-1. 理解需求
-2. 信息收集（@co-explorer / @co-librarian / @co-observer）
-3. 规范分析（并行 @co-rule-user / @co-rule-project / @co-rule-app）
-4. 制定方案 → @co-planner
-5. 调度执行（@co-fixer / @co-designer 等）
-6. 验证（@co-oracle / @co-designer）
-```
-
-## 依赖
-
-- [OpenCode](https://opencode.ai) ≥ 1.17
-- `@opencode-ai/plugin@^1.17`（运行时依赖）
-- `@opencode-ai/sdk@^1.3`（运行时依赖）
-- 无其他外部插件依赖
-
-## 自定义模型
-
-**推荐**：直接编辑 `~/.config/opencode/oh-my-opencode-cohub.json`（见「配置文件」章节），修改对应代理的 `model` 和 `variant` 即可。
-
-**备选**：通过 `opencode.json` 的 plugin config 覆盖：
-
-```json
-{
-  "plugin": [
-    {
-      "name": "oh-my-opencode-cohub",
-      "config": {
-        "models": {
-          "orchestrator": "openai/gpt-5.5",
-          "fixer": "openai/gpt-5.4-mini"
-        }
-      }
-    }
-  ]
-}
-```
-
-> 注意：plugin config 中的 key 使用无 `co-` 前缀的短名（如 `orchestrator`）；JSON 配置文件使用完整的 `co-` 前缀名（如 `co-orchestrator`）。
-
-## 自定义提示词
-
-### 方式一：通过 plugin config 覆盖（推荐）
-
-在 `opencode.json` 的 plugin config 中传入自定义 prompt：
-
-```json
-{
-  "plugin": [
-    {
-      "name": "oh-my-opencode-cohub",
-      "config": {
-        "overrides": {
-          "oracle": "你是我的自定义 Oracle 代理——负责代码审查和安全审计……",
-          "fixer": "你是我的自定义 Fixer 代理——只做 Python 代码修改……"
-        }
-      }
-    }
-  ]
-}
-```
-
-支持覆盖的代理名称：`orchestrator`、`oracle`、`librarian`、`explorer`、`designer`、`fixer`、`observer`、`council`、`rule-user`、`rule-project`、`rule-app`、`planner`
-
-### 方式二：文件覆盖（类 oh-my-opencode-slim 机制）
-
-在项目 `.opencode/oh-my-opencode-cohub/` 或 `~/.config/opencode/oh-my-opencode-cohub/` 目录下创建 `{agent}.md` 文件：
-
-```
-oh-my-opencode-cohub/
-├── oracle.md          ← 完全替换 oracle 提示词
-├── fixer_append.md    ← 追加到 fixer 提示词末尾
-└── planner.md         ← 完全替换 planner 提示词
-```
-
-文件名规则：
-- `{agent}.md` —— 完全替换该代理的内置提示词
-- `{agent}_append.md` —— 追加内容到内置提示词末尾
-
-查找优先级：项目 `.opencode/` > `~/.config/opencode/`
-
-### 方式三：Fork 并修改源码
-
-```bash
-# 修改 src/prompts/oracle.ts 并重新编译
-npm run build
-```
-
-适合深度定制，但需维护自己的分支。
-
-## 许可证
-
-MIT
+# oh-my-opencode-cohub
+
+OpenCode 中文智能体编排插件 CoHub——纯调度模式、全中文提示词、规范分析代理、方案制定代理。
+
+[![GitHub](https://img.shields.io/badge/GitHub-Mr--cjf%2Foh--my--opencode--cohub-blue?logo=github)](https://github.com/Mr-cjf/oh-my-opencode-cohub)
+
+## 特性
+
+- 🚀 **独立运行**：纯 OpenCode Plugin，依赖 `@opencode-ai/plugin` SDK，零外部插件依赖
+- 🤖 **12 个内置代理**：8 个通用代理（orchestrator/oracle/librarian/explorer/designer/fixer/observer/council）+ 4 个规范/方案代理（rule-user/rule-project/rule-app/planner）
+- 🪝 **自动注入**：通过 `system.transform` 钩子在每次 LLM 调用时注入中文语言要求
+- 🧠 **纯调度 Orchestrator**：不碰任何文件工具，只负责规划、委派、验证
+- 🇨🇳 **全中文提示词**：12 个代理全部使用中文提示词
+- 📋 **规范分析代理**：rule-user（用户AGENTS.md）、rule-project（项目AGENTS.md）、rule-app（.opencode/rules/）
+- 🎯 **方案制定代理**：planner 综合所有输入输出结构化任务分解
+- 🔗 **OpenSpec + Superpowers 死板路由**：收到需求即触发，不判断"大小"
+- ⚡ **六步工作流**：理解→收集→规范分析→制定方案→调度→验证
+- 📜 **AGENTS.md 全覆盖**：项目级和用户级 AGENTS.md 对**本插件所有代理**（内置 8 个 + 插件 4 个）均生效，无需额外配置
+- 📖 **架构借鉴**：插件架构和代理编排理念借鉴了 oh-my-opencode-slim，但完全独立实现、无运行时依赖
+
+## 安装
+
+### 前置条件
+
+- [OpenCode](https://opencode.ai) 已安装
+- 推荐安装 [Bun](https://bun.sh)（CLI 一键安装需要）
+
+### 方式一：CLI 一键安装（推荐）
+
+```bash
+bunx oh-my-opencode-cohub install
+```
+
+CLI 会自动完成以下操作：
+
+1. 将 `oh-my-opencode-cohub` 注册到 `~/.config/opencode/opencode.json` 的 `plugin` 数组
+2. 将插件注册到 TUI 配置 `~/.config/opencode/tui.json`
+3. 在 `opencode.json` 的 `agent` 字段中注册全部 12 个 `co-*` 代理
+4. 写入默认配置文件 `~/.config/opencode/oh-my-opencode-cohub.json`
+
+重启 OpenCode 即可生效。
+
+### 方式二：npm 安装 + 手动配置
+
+```bash
+npm install oh-my-opencode-cohub
+```
+
+然后在 `~/.config/opencode/opencode.json` 中添加：
+
+```json
+{
+  "plugin": ["oh-my-opencode-cohub"]
+}
+```
+
+重启 OpenCode 即可。
+
+### 卸载
+
+```bash
+bunx oh-my-opencode-cohub uninstall
+```
+
+CLI 会精确清理所有 `co-*` 代理和相关配置，不影响其他插件的配置数据。
+
+如果使用 npm 手动安装，则需手动从 `opencode.json` 的 `plugin` 数组中移除 `"oh-my-opencode-cohub"`，然后 `npm uninstall oh-my-opencode-cohub`。
+
+### 验证安装
+
+安装并重启 OpenCode 后，确认以下效果：
+
+- 对话中自动出现 **中文语言要求**（如 "你必须始终使用中文进行思考、推理和回复"）
+- 可用代理列表中出现 12 个 `co-*` 前缀代理（`co-orchestrator`、`co-oracle`、`co-librarian`、`co-explorer`、`co-designer`、`co-fixer`、`co-observer`、`co-council`、`co-rule-user`、`co-rule-project`、`co-rule-app`、`co-planner`）
+- Orchestrator 自动进入纯调度模式（只做规划、委派、验证，不直接操作文件）
+
+### 从源码安装（本地开发）
+
+如果需要修改源码或使用开发版本：
+
+```bash
+# 1. 克隆项目
+git clone https://github.com/Mr-cjf/oh-my-opencode-cohub.git && cd oh-my-opencode-cohub
+
+# 2. 安装依赖
+npm install
+
+# 3. 构建（需要系统已安装 Bun）
+npm run build
+
+# 4. 方式 A：npm link 全局链接（推荐）
+npm link
+bunx oh-my-opencode-cohub install
+# 重启 OpenCode 即可。之后修改源码只需重新 npm run build
+
+# 4. 方式 B：手动配置绝对路径
+# 编辑 ~/.config/opencode/opencode.json，在 plugin 数组中写入项目绝对路径：
+# { "plugin": ["/absolute/path/to/oh-my-opencode-cohub"] }
+# 然后手动运行 CLI 注册代理：
+# node dist/cli/index.js install
+```
+
+> **构建依赖**：`npm run build` 使用 `bun build` 和 `tsc`。系统需安装 [Bun](https://bun.sh)（构建工具）和 Node.js（类型声明生成）。所有 `@opencode-ai/*`、`@opentui/*`、`zod` 均为 external，不打包进 `dist/`。
+
+## 代理一览
+
+### 代理（12 个，全中文提示词）
+
+| 代理 | 默认模型 | 职责 | 读取源 |
+|------|----------|------|--------|
+| co-orchestrator | `deepseek/deepseek-v4-pro` | 纯调度：规划→委派→验证 | — |
+| co-oracle | `deepseek/deepseek-v4-pro` | 架构审查/代码审查（含 Superpowers skills） | — |
+| co-librarian | `deepseek/deepseek-v4-flash` | 外部文档/API 研究 | — |
+| co-explorer | `deepseek/deepseek-v4-flash` | 代码库搜索定位 | — |
+| co-designer | `minimax/MiniMax-M3` | UI/UX 设计与实现 | — |
+| co-fixer | `deepseek/deepseek-v4-flash` | 代码修改执行（含 TDD skill） | — |
+| co-observer | `codermxtest/gpt-5.5` | 图片/PDF 分析 | — |
+| co-council | `deepseek/deepseek-v4-pro` | 多模型共识 | — |
+| co-rule-user | `deepseek/deepseek-v4-flash` | 用户级规范分析 | `~/.config/opencode/AGENTS.md` |
+| co-rule-project | `deepseek/deepseek-v4-flash` | 项目级规范分析 | 项目 `AGENTS.md` |
+| co-rule-app | `deepseek/deepseek-v4-flash` | 应用规则分析 | `.opencode/rules/*.md` |
+| co-planner | `deepseek/deepseek-v4-pro` | 方案制定 | 综合需求+信息+规则 |
+
+> 模型可通过下文「配置文件」或「自定义模型」章节覆盖。
+
+## 配置文件
+
+CLI 安装后自动创建 `~/.config/opencode/oh-my-opencode-cohub.json`，这是 CoHub 的专用配置文件，结构如下：
+
+```json
+{
+  "$schema": "https://unpkg.com/oh-my-opencode-cohub@latest/oh-my-opencode-cohub.schema.json",
+  "agents": {
+    "co-orchestrator": { "model": "deepseek/deepseek-v4-pro", "variant": "max" },
+    "co-oracle":      { "model": "deepseek/deepseek-v4-pro", "variant": "max" },
+    "co-librarian":   { "model": "deepseek/deepseek-v4-flash", "variant": "low" },
+    "co-explorer":    { "model": "deepseek/deepseek-v4-flash", "variant": "low" },
+    "co-designer":    { "model": "minimax/MiniMax-M3", "variant": "medium" },
+    "co-fixer":       { "model": "deepseek/deepseek-v4-flash", "variant": "high" },
+    "co-observer":    { "model": "codermxtest/gpt-5.5", "variant": "low" },
+    "co-council":     { "model": "deepseek/deepseek-v4-pro", "variant": "high" },
+    "co-rule-user":   { "model": "deepseek/deepseek-v4-flash", "variant": "medium" },
+    "co-rule-project":{ "model": "deepseek/deepseek-v4-flash", "variant": "medium" },
+    "co-rule-app":    { "model": "deepseek/deepseek-v4-flash", "variant": "medium" },
+    "co-planner":     { "model": "deepseek/deepseek-v4-pro", "variant": "high" }
+  }
+}
+```
+
+直接编辑此文件即可修改任意代理的模型和变体。`$schema` 提供 IDE 自动补全支持。
+
+> **注意**：同一目录 `~/.config/opencode/oh-my-opencode-cohub/` 下也可放置 `{agent}.md` 提示词覆盖文件（见「自定义提示词」章节），与 JSON 配置文件共存。
+
+### Council 多模型共识配置
+
+`co-council` 代理通过 `council_session` 工具并行调用多个模型（councillors），综合各方观点形成共识。councillors 的数量、模型、推理强度完全可配置：
+
+```json
+{
+  "council": {
+    "default_preset": "default",
+    "timeout": 180000,
+    "councillor_execution_mode": "parallel",
+    "councillor_retries": 3,
+    "presets": {
+      "default": {
+        "alpha": { "model": "deepseek/deepseek-v4-pro", "variant": "max" },
+        "beta":  { "model": "deepseek/deepseek-v4-flash", "variant": "high" },
+        "gamma": { "model": "minimax/MiniMax-M3", "variant": "medium" }
+      },
+      "quick": {
+        "alpha": { "model": "deepseek/deepseek-v4-flash", "variant": "high" },
+        "beta":  { "model": "deepseek/deepseek-v4-flash", "variant": "low" }
+      },
+      "deep": {
+        "alpha": { "model": "deepseek/deepseek-v4-pro", "variant": "max" },
+        "beta":  { "model": "deepseek/deepseek-v4-pro", "variant": "max" },
+        "gamma": { "model": "minimax/MiniMax-M3", "variant": "medium" },
+        "delta": { "model": "codermxtest/gpt-5.5", "variant": "high" }
+      }
+    }
+  }
+}
+```
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `presets` | object | (必填) | 预设字典，每个预设是一组 councillor |
+| `default_preset` | string | `"default"` | 调用时不指定 preset 时使用的预设 |
+| `timeout` | number | `180000` | 单个 councillor 超时（毫秒），默认 3 分钟 |
+| `councillor_execution_mode` | `"parallel"` \| `"serial"` | `"parallel"` | 并行/串行执⾏ |
+| `councillor_retries` | number | `3` | 空响应重试次数 |
+
+- 每个 councillor 的 key（如 `alpha`、`beta`）可任意命名，会出现在输出中
+- `model` 格式为 `"provider/model"`，`variant` 可选 `"max"` / `"high"` / `"medium"` / `"low"`
+- councillor 数量无上限，但建议 2-5 个以平衡成本和质量
+- 调用时可通过 `council_session` 工具的 `preset` 参数切换预设，如 `"quick"` 或 `"deep"`
+
+## 工作流
+
+```
+1. 理解需求
+2. 信息收集（@co-explorer / @co-librarian / @co-observer）
+3. 规范分析（并行 @co-rule-user / @co-rule-project / @co-rule-app）
+4. 制定方案 → @co-planner
+5. 调度执行（@co-fixer / @co-designer 等）
+6. 验证（@co-oracle / @co-designer）
+```
+
+## 依赖
+
+- [OpenCode](https://opencode.ai) ≥ 1.17
+- `@opencode-ai/plugin@^1.17`（运行时依赖）
+- `@opencode-ai/sdk@^1.3`（运行时依赖）
+- 无其他外部插件依赖
+
+## 自定义模型
+
+**推荐**：直接编辑 `~/.config/opencode/oh-my-opencode-cohub.json`（见「配置文件」章节），修改对应代理的 `model` 和 `variant` 即可。
+
+**备选**：通过 `opencode.json` 的 plugin config 覆盖：
+
+```json
+{
+  "plugin": [
+    {
+      "name": "oh-my-opencode-cohub",
+      "config": {
+        "models": {
+          "orchestrator": "openai/gpt-5.5",
+          "fixer": "openai/gpt-5.4-mini"
+        }
+      }
+    }
+  ]
+}
+```
+
+> 注意：plugin config 中的 key 使用无 `co-` 前缀的短名（如 `orchestrator`）；JSON 配置文件使用完整的 `co-` 前缀名（如 `co-orchestrator`）。
+
+## 自定义提示词
+
+### 方式一：通过 plugin config 覆盖（推荐）
+
+在 `opencode.json` 的 plugin config 中传入自定义 prompt：
+
+```json
+{
+  "plugin": [
+    {
+      "name": "oh-my-opencode-cohub",
+      "config": {
+        "overrides": {
+          "oracle": "你是我的自定义 Oracle 代理——负责代码审查和安全审计……",
+          "fixer": "你是我的自定义 Fixer 代理——只做 Python 代码修改……"
+        }
+      }
+    }
+  ]
+}
+```
+
+支持覆盖的代理名称：`orchestrator`、`oracle`、`librarian`、`explorer`、`designer`、`fixer`、`observer`、`council`、`rule-user`、`rule-project`、`rule-app`、`planner`
+
+### 方式二：文件覆盖（类 oh-my-opencode-slim 机制）
+
+在项目 `.opencode/oh-my-opencode-cohub/` 或 `~/.config/opencode/oh-my-opencode-cohub/` 目录下创建 `{agent}.md` 文件：
+
+```
+oh-my-opencode-cohub/
+├── oracle.md          ← 完全替换 oracle 提示词
+├── fixer_append.md    ← 追加到 fixer 提示词末尾
+└── planner.md         ← 完全替换 planner 提示词
+```
+
+文件名规则：
+- `{agent}.md` —— 完全替换该代理的内置提示词
+- `{agent}_append.md` —— 追加内容到内置提示词末尾
+
+查找优先级：项目 `.opencode/` > `~/.config/opencode/`
+
+### 方式三：Fork 并修改源码
+
+```bash
+# 修改 src/prompts/oracle.ts 并重新编译
+npm run build
+```
+
+适合深度定制，但需维护自己的分支。
+
+## 版本历史
+
+完整变更记录见 [CHANGELOG.md](./CHANGELOG.md)。
+
+| 版本 | 日期 | 主要变更 |
+|------|------|---------|
+| [1.0.18](https://github.com/Mr-cjf/oh-my-opencode-cohub/releases/tag/v1.0.18) | 2026-07-15 | `council_session` 多模型并行共识工具 |
+| [1.0.17](https://github.com/Mr-cjf/oh-my-opencode-cohub/releases/tag/v1.0.17) | 2026-07-15 | @council vs @oracle 选择指南 + DEBUG 日志移除 |
+| [1.0.16](https://github.com/Mr-cjf/oh-my-opencode-cohub/releases/tag/v1.0.16) | 2026-07-15 | 背景任务事件驱动跟踪 + agent 双重注册 |
+| [1.0.15](https://github.com/Mr-cjf/oh-my-opencode-cohub/releases/tag/v1.0.15) | 2026-07-14 | co-orchestrator 完整中文提示词 |
+| [1.0.14](https://github.com/Mr-cjf/oh-my-opencode-cohub/releases/tag/v1.0.14) | 2026-07-14 | HTTP 服务器模式兼容修复 |
+| [1.0.13](https://github.com/Mr-cjf/oh-my-opencode-cohub/releases/tag/v1.0.13) | 初始发布 | 12 个 co-* 代理 + 纯调度模式 |
+
+## 许可证
+
+MIT

package/dist/cli/config-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-io.d.ts","sourceRoot":"","sources":["../../src/cli/config-io.ts"],"names":[],"mappings":"AA4BA,2CAA2C;AAC3C,wBAAgB,yBAAyB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAajF;AAED,sCAAsC;AACtC,wBAAgB,oBAAoB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAa5E;AAOD,mDAAmD;AACnD,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmC3E;AAID,uBAAuB;AACvB,wBAAgB,kBAAkB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6B1E;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA6GzE"}
+{"version":3,"file":"config-io.d.ts","sourceRoot":"","sources":["../../src/cli/config-io.ts"],"names":[],"mappings":"AA4BA,2CAA2C;AAC3C,wBAAgB,yBAAyB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAajF;AAED,sCAAsC;AACtC,wBAAgB,oBAAoB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAa5E;AAOD,mDAAmD;AACnD,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmC3E;AAID,uBAAuB;AACvB,wBAAgB,kBAAkB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0C1E;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA6GzE"}

package/dist/cli/index.js

@@ -426,7 +426,7 @@ function registerCoHubAgents() {
 ## Council 总结
 总结 councillor 在哪些方面共识、哪些方面分歧，为什么选择最终答案，以及剩余的不确定性。包含共识信心评级：一致、多数或分歧。
 
-**语言要求**: 始终使用中文进行思考、综合和回复。Council 响应、总结等自然语言部分必须用中文。Code examples 可用英文。`, model: "deepseek/deepseek-v4-pro", variant: "high" },
+**语言要求**: 始终使用中文进行思考、综合和回复。Council 响应、总结等自然语言部分必须用中文。Code examples 可用英文。`, model: "deepseek/deepseek-v4-pro", variant: "high", permission: { council_session: "allow" } },
     "co-rule-user": { description: "用户规范分析", mode: "subagent", prompt: `你是规则分析代理——负责用户级规范。
 
 **职责**：读取 \`~/.config/opencode/AGENTS.md\`（用户级全局规则），结合 Orchestrator 提供的当前方案，分析是否有遗漏或冲突。返回具体的调整建议（不要笼统）。
@@ -486,6 +486,19 @@ function writeDefaultConfig() {
       "co-rule-project": { model: "deepseek/deepseek-v4-flash", variant: "medium" },
       "co-rule-app": { model: "deepseek/deepseek-v4-flash", variant: "medium" },
       "co-planner": { model: "deepseek/deepseek-v4-pro", variant: "high" }
+    },
+    council: {
+      default_preset: "default",
+      timeout: 180000,
+      councillor_execution_mode: "parallel",
+      councillor_retries: 3,
+      presets: {
+        default: {
+          alpha: { model: "deepseek/deepseek-v4-pro", variant: "max" },
+          beta: { model: "deepseek/deepseek-v4-flash", variant: "high" },
+          gamma: { model: "minimax/MiniMax-M3", variant: "medium" }
+        }
+      }
     }
   };
   try {

package/dist/config/loader.d.ts

@@ -1,3 +1,19 @@
+/** 单个 councillor 配置 */
+export interface CouncillorConfig {
+    model: string;
+    variant?: string;
+    prompt?: string;
+}
+export interface CouncilPreset {
+    [councillorName: string]: CouncillorConfig;
+}
+export interface CouncilConfig {
+    presets: Record<string, CouncilPreset>;
+    timeout?: number;
+    default_preset?: string;
+    councillor_execution_mode?: 'parallel' | 'serial';
+    councillor_retries?: number;
+}
 /** 用户配置中单个代理的覆盖项 */
 export interface AgentOverride {
     model?: string;
@@ -6,6 +22,7 @@ export interface AgentOverride {
 }
 export interface CoHubConfig {
     agents?: Record<string, AgentOverride>;
+    council?: CouncilConfig;
 }
 /** 加载用户配置 */
 export declare function loadCoHubConfig(): CoHubConfig;

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAIA,oBAAoB;AACpB,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACxC;AAKD,aAAa;AACb,wBAAgB,eAAe,IAAI,WAAW,CAQ7C;AAED,aAAa;AACb,eAAO,MAAM,cAAc,EAAE,WAe5B,CAAC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAIA,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yBAAyB,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAClD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,oBAAoB;AACpB,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAKD,aAAa;AACb,wBAAgB,eAAe,IAAI,WAAW,CAQ7C;AAED,aAAa;AACb,eAAO,MAAM,cAAc,EAAE,WAe5B,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAqClD,wBAAwB;AACxB,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAalD,CAAC;AAwEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,wrBAA+B,CAAC;AAEhE,QAAA,MAAM,WAAW,EAAE,MAkRlB,CAAC;AAEF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAsClD,wBAAwB;AACxB,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAalD,CAAC;AAwEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,wrBAA+B,CAAC;AAEhE,QAAA,MAAM,WAAW,EAAE,MA6SlB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -616,6 +616,347 @@ function loadCoHubConfig() {
   }
 }
 
+// src/tools/council.ts
+import { tool } from "@opencode-ai/plugin";
+var z = tool.schema;
+
+class OperationTimeoutError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "OperationTimeoutError";
+  }
+}
+function isTextPart(part) {
+  return (part.type === "text" || part.type === "reasoning") && typeof part.text === "string";
+}
+function shortModelLabel(model) {
+  return model.split("/").pop() ?? model;
+}
+function parseModelReference(model) {
+  const slashIndex = model.indexOf("/");
+  if (slashIndex <= 0 || slashIndex >= model.length - 1)
+    return null;
+  return {
+    providerID: model.slice(0, slashIndex),
+    modelID: model.slice(slashIndex + 1)
+  };
+}
+async function abortSession(client, sessionId) {
+  try {
+    await client.session.abort({ path: { id: sessionId } });
+  } catch {}
+}
+async function promptWithTimeout(client, path2, body, timeoutMs, directory) {
+  const sessionId = path2.id;
+  let timer;
+  try {
+    const promptPromise = client.session.prompt({
+      path: path2,
+      body,
+      query: directory ? { directory } : undefined
+    });
+    promptPromise.catch(() => {});
+    const racers = [promptPromise];
+    if (timeoutMs > 0) {
+      racers.push(new Promise((_, reject) => {
+        timer = setTimeout(() => {
+          reject(new OperationTimeoutError(`Prompt timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+      }));
+    }
+    await Promise.race(racers);
+  } catch (error) {
+    if (error instanceof OperationTimeoutError) {
+      await abortSession(client, sessionId);
+    }
+    throw error;
+  } finally {
+    if (timer !== undefined)
+      clearTimeout(timer);
+  }
+}
+async function extractSessionResult(client, sessionId, options) {
+  const includeReasoning = options?.includeReasoning ?? true;
+  const messagesResult = await client.session.messages({
+    path: { id: sessionId }
+  });
+  const messages = messagesResult.data ?? [];
+  const assistantMessages = messages.filter((m) => m.info?.role === "assistant");
+  const extractedContent = [];
+  for (const message of assistantMessages) {
+    for (const part of message.parts ?? []) {
+      if (!isTextPart(part))
+        continue;
+      const allowed = includeReasoning || part.type === "text";
+      if (allowed && part.text) {
+        extractedContent.push(part.text);
+      }
+    }
+  }
+  const text = extractedContent.filter((t) => t.length > 0).join(`
+
+`);
+  return { text, empty: text.length === 0 };
+}
+function formatCouncillorPrompt(userPrompt, councillorPrompt) {
+  if (!councillorPrompt)
+    return userPrompt;
+  return `${councillorPrompt}
+
+---
+
+${userPrompt}`;
+}
+function formatCouncillorResults(originalPrompt, councillorResults) {
+  const completedWithResults = councillorResults.filter((cr) => cr.status === "completed" && cr.result);
+  const councillorSection = completedWithResults.map((cr) => {
+    const shortModel = shortModelLabel(cr.model);
+    return `**${cr.name}** (${shortModel}):
+${cr.result}`;
+  }).join(`
+
+`);
+  const failedEntries = councillorResults.filter((cr) => cr.status !== "completed");
+  const failedSection = failedEntries.map((cr) => `**${cr.name}**: ${cr.status} — ${cr.error ?? "Unknown"}`).join(`
+`);
+  if (completedWithResults.length === 0) {
+    const errorDetails = councillorResults.map((cr) => `**${cr.name}** (${shortModelLabel(cr.model)}): ${cr.status} — ${cr.error ?? "Unknown"}`).join(`
+`);
+    return [
+      "---",
+      "",
+      "**Original Prompt**:",
+      originalPrompt,
+      "",
+      "---",
+      "",
+      "**Councillor Responses**:",
+      "All councillors failed to produce output:",
+      errorDetails,
+      "",
+      "Please generate a response based on the original prompt alone."
+    ].join(`
+`);
+  }
+  const parts = [
+    "---",
+    "",
+    "**Original Prompt**:",
+    originalPrompt,
+    "",
+    "---",
+    "",
+    "**Councillor Responses**:",
+    councillorSection
+  ];
+  if (failedSection) {
+    parts.push("", "---", "", "**Failed/Timed-out Councillors**:", failedSection);
+  }
+  parts.push("", "---", "", "You MUST follow the Synthesis Process steps before producing output: " + "review each councillor response individually, then produce the required output " + "with a synthesized Council Response, per-councillor details using their exact names, " + "and a Council Summary with consensus confidence rating (unanimous, majority, or split).");
+  return parts.join(`
+`);
+}
+function formatModelComposition(councillorResults) {
+  return councillorResults.map((cr) => `${cr.name}: ${shortModelLabel(cr.model)}`).join(", ");
+}
+
+class CouncilManager {
+  client;
+  directory;
+  config;
+  constructor(client, directory, config) {
+    this.client = client;
+    this.directory = directory;
+    this.config = config;
+  }
+  async runCouncil(prompt, presetName, parentSessionId) {
+    const resolvedPreset = presetName ?? this.config.default_preset ?? "default";
+    const preset = this.config.presets[resolvedPreset];
+    if (!preset) {
+      const available = Object.keys(this.config.presets).join(", ");
+      return {
+        success: false,
+        error: `Preset "${resolvedPreset}" does not exist. Available presets: ${available}`,
+        councillorResults: []
+      };
+    }
+    if (Object.keys(preset).length === 0) {
+      return {
+        success: false,
+        error: `Preset "${resolvedPreset}" has no councillors configured.`,
+        councillorResults: []
+      };
+    }
+    const timeout = this.config.timeout ?? 180000;
+    const executionMode = this.config.councillor_execution_mode ?? "parallel";
+    const maxRetries = this.config.councillor_retries ?? 3;
+    const councillorResults = await this.runCouncillors(prompt, preset, parentSessionId, timeout, executionMode, maxRetries);
+    const completedCount = councillorResults.filter((r) => r.status === "completed").length;
+    if (completedCount === 0) {
+      return {
+        success: false,
+        error: "All councillors failed or timed out",
+        councillorResults
+      };
+    }
+    const formatted = formatCouncillorResults(prompt, councillorResults);
+    return {
+      success: true,
+      result: formatted,
+      councillorResults
+    };
+  }
+  async runCouncillors(prompt, councillors, parentSessionId, timeout, executionMode, maxRetries) {
+    const entries = Object.entries(councillors);
+    const results = [];
+    if (executionMode === "serial") {
+      for (const [name, config] of entries) {
+        const r = await this.runCouncillorWithRetry(name, config, prompt, parentSessionId, timeout, maxRetries);
+        results.push(r);
+      }
+    } else {
+      const promises = entries.map(([name, config]) => this.runCouncillorWithRetry(name, config, prompt, parentSessionId, timeout, maxRetries));
+      const settled = await Promise.allSettled(promises);
+      for (let i = 0;i < settled.length; i++) {
+        const s = settled[i];
+        const [name, cfg] = entries[i];
+        if (s.status === "fulfilled") {
+          results.push(s.value);
+        } else {
+          results.push({
+            name,
+            model: cfg.model,
+            status: "failed",
+            error: s.reason instanceof Error ? s.reason.message : String(s.reason)
+          });
+        }
+      }
+    }
+    return results;
+  }
+  async runCouncillorWithRetry(name, config, prompt, parentSessionId, timeout, maxRetries) {
+    const totalAttempts = 1 + maxRetries;
+    for (let attempt = 1;attempt <= totalAttempts; attempt++) {
+      try {
+        const result = await this.runAgentSession({
+          parentSessionId,
+          title: `Council ${name} (${shortModelLabel(config.model)})`,
+          model: config.model,
+          promptText: formatCouncillorPrompt(prompt, config.prompt),
+          variant: config.variant,
+          timeout
+        });
+        return { name, model: config.model, status: "completed", result };
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        const isEmptyResponse = msg.includes("Empty response from provider");
+        const canRetry = attempt < totalAttempts && isEmptyResponse;
+        if (!canRetry) {
+          return {
+            name,
+            model: config.model,
+            status: msg.includes("timed out") ? "timed_out" : "failed",
+            error: `Councillor "${name}": ${msg}`
+          };
+        }
+      }
+    }
+    return {
+      name,
+      model: config.model,
+      status: "failed",
+      error: `Councillor "${name}": max retries exhausted`
+    };
+  }
+  async runAgentSession(options) {
+    const modelRef = parseModelReference(options.model);
+    if (!modelRef) {
+      throw new Error(`Invalid model format: ${options.model}`);
+    }
+    let sessionId;
+    try {
+      const session = await this.client.session.create({
+        body: {
+          parentID: options.parentSessionId,
+          title: options.title
+        },
+        query: { directory: this.directory }
+      });
+      if (!session.data?.id) {
+        throw new Error("Failed to create session");
+      }
+      sessionId = session.data.id;
+      const promptBody = {
+        model: modelRef,
+        tools: {
+          task: false,
+          question: false,
+          edit: false,
+          write: false,
+          apply_patch: false,
+          ast_grep_replace: false,
+          bash: false
+        },
+        parts: [{ type: "text", text: options.promptText }]
+      };
+      if (options.variant) {
+        promptBody.variant = options.variant;
+      }
+      await promptWithTimeout(this.client, { id: sessionId }, promptBody, options.timeout, this.directory);
+      const extraction = await extractSessionResult(this.client, sessionId);
+      if (extraction.empty) {
+        throw new Error("Empty response from provider");
+      }
+      return extraction.text;
+    } finally {
+      if (sessionId) {
+        abortSession(this.client, sessionId).catch(() => {});
+      }
+    }
+  }
+}
+function createCouncilTool(ctx, councilManager) {
+  const council_session = tool({
+    description: [
+      "Launch a multi-LLM council session for consensus-based analysis.",
+      "",
+      "Sends the prompt to multiple models (councillors) in parallel and returns",
+      "their formatted responses for you to synthesize.",
+      "",
+      "Returns the councillor responses with a summary footer."
+    ].join(`
+`),
+    args: {
+      prompt: z.string().describe("The prompt to send to all councillors"),
+      preset: z.string().optional().describe('Council preset to use (default: "default"). Must match a preset in the council config.')
+    },
+    async execute(args, toolContext) {
+      const allowedAgents = ["co-council"];
+      const callingAgent = toolContext.agent;
+      if (callingAgent && !allowedAgents.includes(callingAgent)) {
+        throw new Error(`Council sessions can only be invoked by the co-council agent. Current agent: ${callingAgent}`);
+      }
+      const prompt = String(args.prompt);
+      const preset = typeof args.preset === "string" ? args.preset : undefined;
+      const parentSessionId = toolContext.sessionID;
+      const result = await councilManager.runCouncil(prompt, preset, parentSessionId);
+      if (!result.success) {
+        return `Council session failed: ${result.error}`;
+      }
+      let output = result.result ?? "(No output)";
+      const completed = result.councillorResults.filter((cr) => cr.status === "completed").length;
+      const total = result.councillorResults.length;
+      const composition = formatModelComposition(result.councillorResults);
+      output += `
+
+---
+*Council: ${completed}/${total} councillors responded (${composition})*`;
+      return output;
+    }
+  });
+  return { council_session };
+}
+
 // src/index.ts
 import * as fs2 from "node:fs";
 import * as path2 from "node:path";
@@ -757,7 +1098,13 @@ var CoHubPlugin = async (input, options) => {
     {
       name: "co-council",
       description: "多模型共识——并行 LLM 综合",
-      config: { mode: "subagent", model: "deepseek/deepseek-v4-pro", variant: "high", prompt: "你是多模型共识协调者。用中文回复。" }
+      config: {
+        mode: "subagent",
+        model: "deepseek/deepseek-v4-pro",
+        variant: "high",
+        prompt: COUNCIL_PROMPT,
+        permission: { council_session: "allow" }
+      }
     },
     {
       name: "co-rule-user",
@@ -794,6 +1141,22 @@ var CoHubPlugin = async (input, options) => {
       }
     }
   }
+  const DEFAULT_COUNCIL_CONFIG = {
+    default_preset: "default",
+    timeout: 180000,
+    councillor_execution_mode: "parallel",
+    councillor_retries: 3,
+    presets: {
+      default: {
+        alpha: { model: "deepseek/deepseek-v4-pro", variant: "max" },
+        beta: { model: "deepseek/deepseek-v4-flash", variant: "high" },
+        gamma: { model: "minimax/MiniMax-M3", variant: "medium" }
+      }
+    }
+  };
+  const councilConfig = userConfig.council ?? DEFAULT_COUNCIL_CONFIG;
+  const councilManager = new CouncilManager(input.client, input.directory, councilConfig);
+  const councilTools = createCouncilTool(input, councilManager);
   syncAgentConfig();
   function extractChildSessionId(output) {
     if (!output || typeof output !== "object")
@@ -846,6 +1209,7 @@ var CoHubPlugin = async (input, options) => {
   return {
     name: "oh-my-opencode-cohub",
     agent: agentConfigs,
+    tool: councilTools,
     config: async (cfg) => {
       const c = cfg;
       c.agent ??= {};

package/dist/tools/council.d.ts

@@ -0,0 +1,65 @@
+import { tool } from '@opencode-ai/plugin';
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { createOpencodeClient } from '@opencode-ai/sdk';
+export interface CouncillorConfig {
+    /** "provider/model" */
+    model: string;
+    /** "max" | "high" | "medium" | "low" */
+    variant?: string;
+    /** Optional per-councillor prompt prefix */
+    prompt?: string;
+}
+export interface CouncilPreset {
+    [councillorName: string]: CouncillorConfig;
+}
+export interface CouncilConfig {
+    /** Preset map (e.g. { default: { expert1: {...}, expert2: {...} } }) */
+    presets: Record<string, CouncilPreset>;
+    /** Per-councillor timeout in ms (default: 180000) */
+    timeout?: number;
+    /** Default preset name (default: "default") */
+    default_preset?: string;
+    /** Execution mode (default: "parallel") */
+    councillor_execution_mode?: 'parallel' | 'serial';
+    /** Retries on empty response (default: 3) */
+    councillor_retries?: number;
+}
+/** Internal councillor result shape */
+interface CouncillorResult {
+    name: string;
+    model: string;
+    status: string;
+    result?: string;
+    error?: string;
+}
+export declare class CouncilManager {
+    private client;
+    private directory;
+    private config;
+    constructor(client: ReturnType<typeof createOpencodeClient>, directory: string, config: CouncilConfig);
+    /**
+     * Run a full council session.
+     * Resolves a preset, runs all councillors, and returns formatted results.
+     */
+    runCouncil(prompt: string, presetName?: string, parentSessionId?: string): Promise<{
+        success: boolean;
+        result?: string;
+        error?: string;
+        councillorResults: CouncillorResult[];
+    }>;
+    private runCouncillors;
+    private runCouncillorWithRetry;
+    private runAgentSession;
+}
+/**
+ * Create the `council_session` tool definition.
+ *
+ * The tool launches a multi-LLM council: multiple councillors run in parallel
+ * against their assigned models, and their responses are assembled into a
+ * structured block for the calling (co-council) agent to synthesize.
+ *
+ * Only the `co-council` agent is allowed to invoke this tool.
+ */
+export declare function createCouncilTool(ctx: PluginInput, councilManager: CouncilManager): Record<string, ReturnType<typeof tool>>;
+export {};
+//# sourceMappingURL=council.d.ts.map

package/dist/tools/council.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"council.d.ts","sourceRoot":"","sources":["../../src/tools/council.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAU7D,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,yBAAyB,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAClD,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,uCAAuC;AACvC,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+OD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAgB;gBAG5B,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,EAC/C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa;IAOvB;;;OAGG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;KACvC,CAAC;YA2DY,cAAc;YA8Cd,sBAAsB;YAkDtB,eAAe;CA6E9B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,cAAc,GAC7B,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAyDzC"}

package/package.json

@@ -1,53 +1,53 @@
-{
-  "name": "oh-my-opencode-cohub",
-  "version": "1.0.17",
-  "description": "OpenCode 中文智能体编排插件 CoHub - 纯调度模式 / 全中文提示词 / 规范分析代理 / 方案制定代理 / 独立运行",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "oh-my-opencode-cohub": "./dist/cli/index.js"
-  },
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./tui": {
-      "import": "./dist/tui.js",
-      "types": "./dist/tui.d.ts"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "bun build src/index.ts src/tui.ts --outdir dist --target node --format esm --external @opencode-ai/plugin --external @opencode-ai/plugin/* --external @opencode-ai/sdk --external @opencode-ai/sdk/* --external @opentui/core --external @opentui/solid --external zod && bun build src/cli/index.ts --outdir dist/cli --target node --format esm && tsc --emitDeclarationOnly",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "opencode",
-    "plugin",
-    "chinese",
-    "agent",
-    "orchestra",
-    "orchestrator"
-  ],
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "@opencode-ai/plugin": "^1.17.0",
-    "@opencode-ai/sdk": "^1.3.17"
-  },
-  "optionalDependencies": {
-    "@opentui/solid": "^0.4.3",
-    "@opentui/core": "^0.4.3"
-  },
-  "devDependencies": {
-    "@types/node": "^26.1.1",
-    "typescript": "^5.4.0"
-  },
-  "opencode": {
-    "plugin": true
-  }
-}
+{
+  "name": "oh-my-opencode-cohub",
+  "version": "1.0.19",
+  "description": "OpenCode 中文智能体编排插件 CoHub - 纯调度模式 / 全中文提示词 / 规范分析代理 / 方案制定代理 / 独立运行",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "oh-my-opencode-cohub": "./dist/cli/index.js"
+  },
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./tui": {
+      "import": "./dist/tui.js",
+      "types": "./dist/tui.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts src/tui.ts --outdir dist --target node --format esm --external @opencode-ai/plugin --external @opencode-ai/plugin/* --external @opencode-ai/sdk --external @opencode-ai/sdk/* --external @opentui/core --external @opentui/solid --external zod && bun build src/cli/index.ts --outdir dist/cli --target node --format esm && tsc --emitDeclarationOnly",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "chinese",
+    "agent",
+    "orchestra",
+    "orchestrator"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.17.0",
+    "@opencode-ai/sdk": "^1.3.17"
+  },
+  "optionalDependencies": {
+    "@opentui/solid": "^0.4.3",
+    "@opentui/core": "^0.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "typescript": "^5.4.0"
+  },
+  "opencode": {
+    "plugin": true
+  }
+}