oh-my-opencode-cohub 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+# 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 个）均生效，无需额外配置
+
+## 快速开始
+
+### 安装
+
+```bash
+npm install oh-my-opencode-cohub
+```
+
+### 配置 opencode.json
+
+```json
+{
+  "plugin": ["oh-my-opencode-cohub"]
+}
+```
+
+重启 OpenCode 即可。12 个代理自动注册，中文语言要求自动注入。
+
+### 使用方式
+
+安装后，OpenCode 会自动：
+- 加载中文代理提示词
+- 注册 4 个插件代理：@rule-user、@rule-project、@rule-app、@planner
+- 注入中文语言要求
+- 所有代理（包括 @rule-user、@rule-project、@rule-app、@planner）自动继承项目级和用户级 AGENTS.md 规则
+
+## 代理一览
+
+### 代理（12 个，全中文提示词）
+
+| 代理 | 模型 | 职责 | 读取源 |
+|------|------|------|--------|
+| orchestrator | 见默认配置 | 纯调度：规划→委派→验证 | — |
+| oracle | 见默认配置 | 架构审查/代码审查（含 Superpowers skills） | — |
+| librarian | 见默认配置 | 外部文档/API 研究 | — |
+| explorer | 见默认配置 | 代码库搜索定位 | — |
+| designer | 见默认配置 | UI/UX 设计与实现 | — |
+| fixer | 见默认配置 | 代码修改执行（含 TDD skill） | — |
+| observer | 见默认配置 | 图片/PDF 分析 | — |
+| council | 见默认配置 | 多模型共识 | — |
+| rule-user | 见默认配置 | 用户级规范分析 | `~/.config/opencode/AGENTS.md` |
+| rule-project | 见默认配置 | 项目级规范分析 | 项目 `AGENTS.md` |
+| rule-app | 见默认配置 | 应用规则分析 | `.opencode/rules/*.md` |
+| planner | 见默认配置 | 方案制定 | 综合需求+信息+规则 |
+
+> 模型通过 `DEFAULT_MODELS` 常量配置，默认使用 DeepSeek，可通过 plugin config 覆盖任意代理模型。
+
+## 工作流
+
+```
+1. 理解需求
+2. 信息收集（@explorer / @librarian / @observer）
+3. 规范分析（并行 @rule-user / @rule-project / @rule-app）
+4. 制定方案 → @planner
+5. 调度执行（@fixer / @designer 等）
+6. 验证（@oracle / @designer）
+```
+
+## 依赖
+
+- OpenCode
+- `@opencode-ai/plugin`（TypeScript 编译依赖）
+- 无其他外部插件依赖
+
+## 自定义模型
+
+通过 `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 覆盖（推荐）
+
+在 `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

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

@@ -0,0 +1,21 @@
+/** 添加 CoHub 到 opencode.json 的 plugin 数组 */
+export declare function addPluginToOpenCodeConfig(): {
+    success: boolean;
+    message: string;
+};
+/** 添加 CoHub 到 tui.json 的 plugin 数组 */
+export declare function addPluginToTuiConfig(): {
+    success: boolean;
+    message: string;
+};
+/** 将 co-orchestrator 注册到 opencode.json 的 agent 字段（TAB 切换必需——插件系统无法设 primary） */
+export declare function registerCoOrchestratorToAgent(): {
+    success: boolean;
+    message: string;
+};
+/** 卸载 CoHub——精确清理，不碰其他插件数据 */
+export declare function uninstallCoHub(): {
+    success: boolean;
+    messages: string[];
+};
+//# sourceMappingURL=config-io.d.ts.map

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

@@ -0,0 +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,gFAAgF;AAChF,wBAAgB,6BAA6B,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAuBrF;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAuGzE"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+
+// src/cli/config-io.ts
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+var PACKAGE_NAME = "oh-my-opencode-cohub";
+function getOpencodeConfigPath() {
+  return path.join(os.homedir(), ".config", "opencode", "opencode.json");
+}
+function getTuiConfigPath() {
+  return path.join(os.homedir(), ".config", "opencode", "tui.json");
+}
+function readJSON(filePath) {
+  try {
+    if (!fs.existsSync(filePath))
+      return null;
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function writeJSON(filePath, data) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir))
+    fs.mkdirSync(dir, { recursive: true });
+  const content = JSON.stringify(data, null, 2) + `
+`;
+  fs.writeFileSync(filePath, content, "utf-8");
+}
+function addPluginToOpenCodeConfig() {
+  const configPath = getOpencodeConfigPath();
+  let config = readJSON(configPath) ?? {};
+  const plugins = Array.isArray(config.plugin) ? [...config.plugin] : [];
+  if (plugins.some((p) => p.includes(PACKAGE_NAME))) {
+    return { success: true, message: "CoHub 已在 opencode.json 的 plugin 数组中，跳过" };
+  }
+  plugins.unshift(PACKAGE_NAME);
+  config.plugin = plugins;
+  writeJSON(configPath, config);
+  return { success: true, message: `✓ 已添加 "${PACKAGE_NAME}" 到 opencode.json 的 plugin 数组` };
+}
+function addPluginToTuiConfig() {
+  const configPath = getTuiConfigPath();
+  let config = readJSON(configPath) ?? {};
+  const plugins = Array.isArray(config.plugin) ? [...config.plugin] : [];
+  if (plugins.some((p) => p.includes(PACKAGE_NAME))) {
+    return { success: true, message: "CoHub 已在 tui.json 的 plugin 数组中，跳过" };
+  }
+  plugins.unshift(PACKAGE_NAME);
+  config.plugin = plugins;
+  writeJSON(configPath, config);
+  return { success: true, message: `✓ 已添加 "${PACKAGE_NAME}" 到 tui.json 的 plugin 数组` };
+}
+function getOhMyConfigPath() {
+  return path.join(os.homedir(), ".config", "opencode", "oh-my-opencode-slim.json");
+}
+function registerCoOrchestratorToAgent() {
+  const configPath = getOpencodeConfigPath();
+  let config = readJSON(configPath);
+  if (!config) {
+    config = {};
+  }
+  config.agent = config.agent ?? {};
+  const agents = config.agent;
+  if (agents["co-orchestrator"]) {
+    return { success: true, message: "co-orchestrator 已存在于 opencode.json 的 agent 字段，跳过" };
+  }
+  agents["co-orchestrator"] = {
+    description: "纯调度者——理解需求→委派→方案→执行→验证",
+    mode: "primary",
+    prompt: "你是 CoHub 纯调度者（Orchestrator）。唯一职责：理解需求 → 委派信息收集 → 制定方案 → 调度子代理执行 → 委派验证。用中文思考和回复。",
+    model: "deepseek/deepseek-v4-pro"
+  };
+  writeJSON(configPath, config);
+  return { success: true, message: "✓ 已将 co-orchestrator (primary) 注册到 opencode.json 的 agent 字段" };
+}
+function uninstallCoHub() {
+  const messages = [];
+  const configPath = getOpencodeConfigPath();
+  let config = readJSON(configPath);
+  if (config) {
+    const plugins = Array.isArray(config.plugin) ? [...config.plugin] : [];
+    const before = plugins.length;
+    const filtered = plugins.filter((p) => {
+      if (typeof p === "string") {
+        return !p.includes("oh-my-opencode-cohub") && !p.includes("Desktop.*cohub");
+      }
+      return true;
+    });
+    if (filtered.length < before) {
+      config.plugin = filtered;
+      messages.push("✓ 已从 opencode.json 的 plugin 数组移除 CoHub");
+    }
+    if (config.agent && typeof config.agent === "object") {
+      const agents = config.agent;
+      if (agents["co-orchestrator"]) {
+        delete agents["co-orchestrator"];
+        messages.push("✓ 已从 opencode.json 的 agent 字段移除 co-orchestrator");
+      }
+      if (Object.keys(agents).length === 0) {
+        delete config.agent;
+      }
+    }
+    writeJSON(configPath, config);
+  } else {
+    messages.push("⚠ opencode.json 不存在，跳过");
+  }
+  const tuiPath = getTuiConfigPath();
+  if (fs.existsSync(tuiPath)) {
+    const tuiConfig = readJSON(tuiPath);
+    if (tuiConfig) {
+      const tuiPlugins = Array.isArray(tuiConfig.plugin) ? [...tuiConfig.plugin] : [];
+      const before = tuiPlugins.length;
+      const filtered = tuiPlugins.filter((p) => {
+        if (typeof p === "string") {
+          return !p.includes("oh-my-opencode-cohub") && !p.includes("Desktop.*cohub");
+        }
+        return true;
+      });
+      if (filtered.length < before) {
+        tuiConfig.plugin = filtered;
+        writeJSON(tuiPath, tuiConfig);
+        messages.push("✓ 已从 tui.json 的 plugin 数组移除 CoHub");
+      }
+    }
+  }
+  const tuiStatePath = path.join(os.homedir(), ".local", "share", "opencode", "storage", "oh-my-opencode-slim", "tui-state.json");
+  if (fs.existsSync(tuiStatePath)) {
+    let tuiState = readJSON(tuiStatePath);
+    if (tuiState) {
+      let cleaned = false;
+      if (tuiState.agentModels && typeof tuiState.agentModels === "object") {
+        const models = tuiState.agentModels;
+        for (const key of Object.keys(models)) {
+          if (key.startsWith("co-")) {
+            delete models[key];
+            cleaned = true;
+          }
+        }
+      }
+      if (tuiState.agentVariants && typeof tuiState.agentVariants === "object") {
+        const variants = tuiState.agentVariants;
+        for (const key of Object.keys(variants)) {
+          if (key.startsWith("co-")) {
+            delete variants[key];
+            cleaned = true;
+          }
+        }
+      }
+      if (cleaned) {
+        writeJSON(tuiStatePath, tuiState);
+        messages.push("✓ 已清理 tui-state.json 中的 co-* 残留（未影响其他插件数据）");
+      }
+    }
+  }
+  const ohMyPath = getOhMyConfigPath();
+  if (fs.existsSync(ohMyPath)) {
+    let ohMyConfig = readJSON(ohMyPath);
+    if (ohMyConfig && ohMyConfig.agents && typeof ohMyConfig.agents === "object") {
+      let cleanedOhMy = false;
+      const agents = ohMyConfig.agents;
+      for (const key of Object.keys(agents)) {
+        if (key.startsWith("co-")) {
+          delete agents[key];
+          cleanedOhMy = true;
+        }
+      }
+      if (cleanedOhMy) {
+        writeJSON(ohMyPath, ohMyConfig);
+        messages.push("✓ 已清理 oh-my-opencode-slim.json agents 字段中的 co-* 代理");
+      }
+    }
+  }
+  messages.push("✅ CoHub 卸载完成。完全关闭 OpenCode 后重新打开即可。");
+  return { success: true, messages };
+}
+
+// src/cli/index.ts
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  if (command === "install") {
+    console.log(`\uD83D\uDE80 CoHub v1.0 安装中...
+`);
+    const r1 = addPluginToOpenCodeConfig();
+    console.log(r1.message);
+    const r2 = addPluginToTuiConfig();
+    console.log(r2.message);
+    const r3 = registerCoOrchestratorToAgent();
+    console.log(r3.message);
+    console.log(`
+✅ CoHub 安装完成！`);
+    console.log('   重启 OpenCode 后，TAB 选择 "co-orchestrator" 开始纯调度模式。');
+    console.log("   右侧面板可查看 12 个代理的运行状态。");
+  } else if (command === "uninstall") {
+    console.log(`\uD83E\uDDF9 CoHub 卸载中...
+`);
+    const result = uninstallCoHub();
+    for (const msg of result.messages) {
+      console.log(msg);
+    }
+  } else {
+    console.log("CoHub - OpenCode 中文智能体编排插件");
+    console.log("");
+    console.log("用法:");
+    console.log("  bunx oh-my-opencode-cohub install      安装 CoHub");
+    console.log("  bunx oh-my-opencode-cohub uninstall    卸载 CoHub");
+  }
+}
+main().catch(console.error);

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from '@opencode-ai/plugin';
+/** 中文提示词映射表 —— 供外部使用 */
+export declare const CHINESE_PROMPTS: Record<string, string>;
+/**
+ * 中文语言指令 —— 可注入到 AGENTS.md 或 instructions
+ */
+export declare const CHINESE_INSTRUCTION = "# \u4E2D\u6587\u8BED\u8A00\u8981\u6C42\n\n\u4F60\u5FC5\u987B\u59CB\u7EC8\u4F7F\u7528\u4E2D\u6587\u8FDB\u884C\u601D\u8003\u3001\u63A8\u7406\u548C\u56DE\u590D\u3002\n\n- \u6240\u6709\u81EA\u7136\u8BED\u8A00\u90E8\u5206\uFF08\u5206\u6790\u3001\u89C4\u5212\u3001\u89E3\u91CA\u3001\u8BA8\u8BBA\uFF09\u5FC5\u987B\u4F7F\u7528\u4E2D\u6587\n- \u4EE3\u7801\u3001\u6280\u672F\u672F\u8BED\u3001\u6587\u4EF6\u540D\u3001\u547D\u4EE4\u53EF\u4EE5\u4FDD\u7559\u539F\u6837\n- \u6B64\u89C4\u5219\u5BF9\u6240\u6709\u4EE3\u7406\uFF08Orchestrator \u548C\u6240\u6709\u5B50\u4EE3\u7406\uFF09\u751F\u6548\n- \u8DE8\u6240\u6709\u9879\u76EE\u751F\u6548\uFF0C\u4F18\u5148\u7EA7\u9AD8\u4E8E\u9879\u76EE\u7EA7\u89C4\u5219";
+declare const CoHubPlugin: Plugin;
+export default CoHubPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAoClD,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,MAkKlB,CAAC;AAEF,eAAe,WAAW,CAAC"}