oh-my-opencode-cohub 1.0.14 → 1.0.16

package/README.md

@@ -16,15 +16,35 @@ OpenCode 中文智能体编排插件 CoHub——纯调度模式、全中文提
 - 📜 **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
 ```
 
-### 配置 opencode.json
+然后在 `~/.config/opencode/opencode.json` 中添加：
 
 ```json
 {
@@ -32,15 +52,53 @@ npm install oh-my-opencode-cohub
 }
 ```
 
-重启 OpenCode 即可。12 个代理自动注册，中文语言要求自动注入。
+重启 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
+```
 
-安装后，OpenCode 会自动：
-- 加载中文代理提示词
-- 注册 4 个插件代理：@rule-user、@rule-project、@rule-app、@planner
-- 注入中文语言要求
-- 所有代理（包括 @rule-user、@rule-project、@rule-app、@planner）自动继承项目级和用户级 AGENTS.md 规则
+> **构建依赖**：`npm run build` 使用 `bun build` 和 `tsc`。系统需安装 [Bun](https://bun.sh)（构建工具）和 Node.js（类型声明生成）。所有 `@opencode-ai/*`、`@opentui/*`、`zod` 均为 external，不打包进 `dist/`。
 
 ## 代理一览
 

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,MAqNlB,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;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,MAiSlB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -443,11 +443,12 @@ class TaskTracker {
     const label = typeof args.description === "string" ? args.description : alias;
     this.jobs.set(alias, {
       alias,
-      sessionId: "",
+      sessionId: args.task_id ?? "",
       parentSessionId,
       agent,
       label,
       status: "running",
+      background: args.background ?? false,
       terminalReconciled: false,
       createdAt: Date.now()
     });
@@ -462,11 +463,24 @@ class TaskTracker {
       }
     }
     if (latest) {
+      if (latest.background) {
+        if (sessionId)
+          latest.sessionId = sessionId;
+        return;
+      }
       latest.status = status;
       if (sessionId)
         latest.sessionId = sessionId;
     }
   }
+  updateByChildSessionId(sessionId, status) {
+    for (const job of this.jobs.values()) {
+      if (job.sessionId === sessionId && job.background && job.status === "running") {
+        job.status = status;
+        return;
+      }
+    }
+  }
   getBoardText(parentSessionId) {
     const pid = parentSessionId || this._currentParentSessionId;
     const activeJobs = [];
@@ -513,6 +527,14 @@ class TaskTracker {
       job.terminalReconciled = true;
     }
   }
+  cleanupStaleJobs(timeoutMs) {
+    const now = Date.now();
+    for (const job of this.jobs.values()) {
+      if (job.background && job.status === "running" && now - job.createdAt > timeoutMs) {
+        job.status = "errored";
+      }
+    }
+  }
   isReusable(alias) {
     const job = this.jobs.get(alias);
     return job?.status === "completed" && job.terminalReconciled;
@@ -660,7 +682,9 @@ var CoHubPlugin = async (input, options) => {
   const agents = [
     {
       name: "co-orchestrator",
-      config: { mode: "primary", model: "deepseek/deepseek-v4-pro", variant: "max", prompt: "你是 CoHub 纯调度者。用中文回复。" }
+      config: { mode: "primary", model: "deepseek/deepseek-v4-pro", variant: "max", prompt: ORCHESTRATOR_PROMPT + `
+
+` + CHINESE_LANGUAGE_INSTRUCTION }
     },
     {
       name: "co-oracle",
@@ -730,6 +754,46 @@ var CoHubPlugin = async (input, options) => {
     }
   }
   syncAgentConfig();
+  function extractChildSessionId(output) {
+    if (!output || typeof output !== "object")
+      return;
+    const o = output;
+    const meta = o.metadata;
+    if (meta) {
+      if (typeof meta.sessionId === "string")
+        return meta.sessionId;
+      if (typeof meta.taskId === "string")
+        return meta.taskId;
+      if (typeof meta.task_id === "string")
+        return meta.task_id;
+      if (typeof meta.id === "string")
+        return meta.id;
+    }
+    const text = typeof o.output === "string" ? o.output : "";
+    const m = text.match(/\b(session|task)[_\s]?(?:id|ID)[:\s]+(\S+)/i);
+    if (m)
+      return m[2];
+    return;
+  }
+  function extractSessionIdFromEvent(props) {
+    if (!props || typeof props !== "object")
+      return;
+    const p = props;
+    const info = p.info;
+    if (info?.id)
+      return info.id;
+    if (typeof p.sessionID === "string")
+      return p.sessionID;
+    if (typeof p.sessionId === "string")
+      return p.sessionId;
+    return;
+  }
+  const STALE_TIMEOUT_MS = 30 * 60 * 1000;
+  const cleanupTimer = setInterval(() => {
+    try {
+      tracker.cleanupStaleJobs(STALE_TIMEOUT_MS);
+    } catch {}
+  }, 30000);
   const agentConfigs = {};
   for (const agent of agents) {
     agentConfigs[agent.name] = {
@@ -765,14 +829,41 @@ var CoHubPlugin = async (input, options) => {
         }
       } catch {}
     },
-    "tool.execute.after": async (input2, _output) => {
+    "tool.execute.after": async (input2, output) => {
       try {
         if (input2.tool === "task") {
-          tracker.updateAfterTask(input2.sessionID, "completed");
+          try {
+            const debugDir = path2.join(os2.homedir(), ".local", "share", "opencode", "storage", "oh-my-opencode-cohub");
+            if (!fs2.existsSync(debugDir))
+              fs2.mkdirSync(debugDir, { recursive: true });
+            fs2.writeFileSync(path2.join(debugDir, "task-output-debug.json"), JSON.stringify({
+              time: new Date().toISOString(),
+              callID: input2.callID,
+              output_keys: Object.keys(output || {}),
+              output: JSON.parse(JSON.stringify(output))
+            }, null, 2), "utf-8");
+          } catch {}
+          const childSessionId = extractChildSessionId(output);
+          tracker.updateAfterTask(input2.sessionID, "completed", childSessionId);
           syncTrackerState(input2.sessionID ?? "");
         }
       } catch {}
     },
+    event: async (input2) => {
+      try {
+        const e = input2.event;
+        const sessionId = extractSessionIdFromEvent(e.properties);
+        if (!sessionId)
+          return;
+        if (e.type === "session.idle") {
+          tracker.updateByChildSessionId(sessionId, "completed");
+          syncTrackerState(tracker.currentParentSessionId);
+        } else if (e.type === "session.deleted" || e.type === "session.error") {
+          tracker.updateByChildSessionId(sessionId, "errored");
+          syncTrackerState(tracker.currentParentSessionId);
+        }
+      } catch {}
+    },
     "experimental.chat.messages.transform": async (_input, output) => {
       try {
         const board = tracker.getBoardText();
@@ -797,6 +888,9 @@ var CoHubPlugin = async (input, options) => {
     },
     "experimental.chat.system.transform": async (_input, output) => {
       output.system.push(CHINESE_LANGUAGE_INSTRUCTION);
+    },
+    dispose: async () => {
+      clearInterval(cleanupTimer);
     }
   };
 };

package/dist/task-manager/tracker.d.ts

@@ -13,9 +13,14 @@ export declare class TaskTracker {
     registerBeforeTask(parentSessionId: string, args: TaskArgs): string;
     /**
      * 在 tool.execute.after 中调用，更新任务完成状态
-     * 匹配 parentSessionId 下最近创建且仍为 running 的任务
+     * 非背景任务：立即标 completed；背景任务：不更新（等 session.idle 事件）
      */
     updateAfterTask(parentSessionId: string, status: TaskStatus, sessionId?: string): void;
+    /**
+     * 根据子 session ID 更新任务状态（供 event hook 使用）
+     * 当背景任务的 session 变为 idle 时调用
+     */
+    updateByChildSessionId(sessionId: string, status: TaskStatus): void;
     /**
      * 生成 Background Job Board 文本
      */
@@ -24,6 +29,10 @@ export declare class TaskTracker {
      * 标记任务已调和（不再显示在 Unreconciled 中）
      */
     reconcileJob(alias: string): void;
+    /**
+     * 清理超时的背景任务（超过 timeoutMs 仍 running 的标为 errored）
+     */
+    cleanupStaleJobs(timeoutMs: number): void;
     /**
      * 检查任务是否可复用
      */

package/dist/task-manager/tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/task-manager/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,yCAAyC;IACzC,OAAO,CAAC,uBAAuB,CAAM;IAErC,IAAI,sBAAsB,IAAI,MAAM,CAEnC;IAED,mDAAmD;IACnD,OAAO,CAAC,KAAK;IAOb;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM;IAoBnE;;;OAGG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBtF;;OAEG;IACH,YAAY,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA4CrD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKlC,2BAA2B;IAC3B,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE;IAUnD,uBAAuB;IACvB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;CASjD"}
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/task-manager/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,yCAAyC;IACzC,OAAO,CAAC,uBAAuB,CAAM;IAErC,IAAI,sBAAsB,IAAI,MAAM,CAEnC;IAED,mDAAmD;IACnD,OAAO,CAAC,KAAK;IAOb;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM;IAqBnE;;;OAGG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBtF;;;OAGG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IASnE;;OAEG;IACH,YAAY,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA4CrD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASzC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKlC,2BAA2B;IAC3B,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE;IAUnD,uBAAuB;IACvB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;CASjD"}

package/dist/task-manager/types.d.ts

@@ -6,6 +6,7 @@ export interface JobRecord {
     agent: string;
     label: string;
     status: TaskStatus;
+    background: boolean;
     terminalReconciled: boolean;
     createdAt: number;
 }

package/dist/task-manager/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/task-manager/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/task-manager/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode-cohub",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "OpenCode 中文智能体编排插件 CoHub - 纯调度模式 / 全中文提示词 / 规范分析代理 / 方案制定代理 / 独立运行",
   "type": "module",
   "main": "dist/index.js",