@harmonyos-arkts/opencode-acp 0.0.3 → 0.0.4

package/docs/mcp-extmethod-design.md

@@ -27,15 +27,15 @@ ACP Client (Editor) ← stdio/JSON-RPC → Harmony-ACP ← HTTP/SSE → OpenCode
 
 ## 暴露的 MCP 操作
 
-| extMethod 名 | 对应 SDK 调用 | 说明 |
-|---|---|---|
-| `mcp/status` | `sdk.mcp.status()` | 获取所有 MCP 服务器状态 |
-| `mcp/add` | `sdk.mcp.add()` | 添加 MCP 服务器 |
-| `mcp/connect` | `sdk.mcp.connect()` | 连接已禁用的服务器 |
-| `mcp/disconnect` | `sdk.mcp.disconnect()` | 断开服务器 |
-| `mcp/auth/start` | `sdk.mcp.auth.start()` | 启动 OAuth 认证 |
-| `mcp/auth/callback` | `sdk.mcp.auth.callback()` | 完成 OAuth 认证 |
-| `mcp/auth/remove` | `sdk.mcp.auth.remove()` | 删除 OAuth 凭据 |
+| extMethod 名        | 对应 SDK 调用             | 说明                    |
+| ------------------- | ------------------------- | ----------------------- |
+| `mcp/status`        | `sdk.mcp.status()`        | 获取所有 MCP 服务器状态 |
+| `mcp/add`           | `sdk.mcp.add()`           | 添加 MCP 服务器         |
+| `mcp/connect`       | `sdk.mcp.connect()`       | 连接已禁用的服务器      |
+| `mcp/disconnect`    | `sdk.mcp.disconnect()`    | 断开服务器              |
+| `mcp/auth/start`    | `sdk.mcp.auth.start()`    | 启动 OAuth 认证         |
+| `mcp/auth/callback` | `sdk.mcp.auth.callback()` | 完成 OAuth 认证         |
+| `mcp/auth/remove`   | `sdk.mcp.auth.remove()`   | 删除 OAuth 凭据         |
 
 ### 各操作详细签名
 
@@ -44,13 +44,15 @@ ACP Client (Editor) ← stdio/JSON-RPC → Harmony-ACP ← HTTP/SSE → OpenCode
 获取所有已配置 MCP 服务器的连接状态。
 
 **请求参数：**
+
 ```typescript
 {
-  sessionId: string  // 用于获取 cwd
+  sessionId: string; // 用于获取 cwd
 }
 ```
 
 **响应：**
+
 ```typescript
 {
   [serverName: string]: {
@@ -65,6 +67,7 @@ ACP Client (Editor) ← stdio/JSON-RPC → Harmony-ACP ← HTTP/SSE → OpenCode
 动态添加 MCP 服务器。
 
 **请求参数：**
+
 ```typescript
 {
   sessionId: string
@@ -89,6 +92,7 @@ ACP Client (Editor) ← stdio/JSON-RPC → Harmony-ACP ← HTTP/SSE → OpenCode
 ```
 
 **响应：**
+
 ```typescript
 {
   [serverName: string]: McpStatus  // 添加后所有服务器状态
@@ -100,17 +104,19 @@ ACP Client (Editor) ← stdio/JSON-RPC → Harmony-ACP ← HTTP/SSE → OpenCode
 连接一个已禁用/断开的 MCP 服务器。
 
 **请求参数：**
+
 ```typescript
 {
-  sessionId: string
-  name: string
+  sessionId: string;
+  name: string;
 }
 ```
 
 **响应：**
+
 ```typescript
 {
-  success: true
+  success: true;
 }
 ```
 
@@ -119,17 +125,19 @@ ACP Client (Editor) ← stdio/JSON-RPC → Harmony-ACP ← HTTP/SSE → OpenCode
 断开一个 MCP 服务器。
 
 **请求参数：**
+
 ```typescript
 {
-  sessionId: string
-  name: string
+  sessionId: string;
+  name: string;
 }
 ```
 
 **响应：**
+
 ```typescript
 {
-  success: true
+  success: true;
 }
 ```
 
@@ -138,18 +146,20 @@ ACP Client (Editor) ← stdio/JSON-RPC → Harmony-ACP ← HTTP/SSE → OpenCode
 启动 OAuth 认证流程，返回授权 URL。
 
 **请求参数：**
+
 ```typescript
 {
-  sessionId: string
-  name: string
+  sessionId: string;
+  name: string;
 }
 ```
 
 **响应：**
+
 ```typescript
 {
-  authorizationUrl: string
-  oauthState: string
+  authorizationUrl: string;
+  oauthState: string;
 }
 ```
 
@@ -160,17 +170,19 @@ ACP Client (Editor) ← stdio/JSON-RPC → Harmony-ACP ← HTTP/SSE → OpenCode
 用授权码完成 OAuth 认证。
 
 **请求参数：**
+
 ```typescript
 {
-  sessionId: string
-  name: string
-  code: string  // OAuth 授权码
+  sessionId: string;
+  name: string;
+  code: string; // OAuth 授权码
 }
 ```
 
 **响应：**
+
 ```typescript
-McpStatus  // 认证后的服务器状态
+McpStatus; // 认证后的服务器状态
 ```
 
 #### `mcp/auth/remove`
@@ -178,17 +190,19 @@ McpStatus  // 认证后的服务器状态
 删除 MCP 服务器的 OAuth 凭据。
 
 **请求参数：**
+
 ```typescript
 {
-  sessionId: string
-  name: string
+  sessionId: string;
+  name: string;
 }
 ```
 
 **响应：**
+
 ```typescript
 {
-  success: true
+  success: true;
 }
 ```
 
@@ -202,52 +216,52 @@ McpStatus  // 认证后的服务器状态
 
 ```typescript
 // src/mcp-manager.ts
-import type { OpencodeClient } from "@opencode-ai/sdk/v2"
-import { ocCall } from "./logger.js"
+import type { OpencodeClient } from "@opencode-ai/sdk/v2";
+import { ocCall } from "./logger.js";
 
 export class McpManager {
   constructor(private sdk: OpencodeClient) {}
 
   async status(directory: string) {
-    ocCall("mcp.status", { directory })
-    const result = await this.sdk.mcp.status({ directory })
-    return result.data ?? {}
+    ocCall("mcp.status", { directory });
+    const result = await this.sdk.mcp.status({ directory });
+    return result.data ?? {};
   }
 
   async add(directory: string, name: string, config: any) {
-    ocCall("mcp.add", { directory, name })
-    const result = await this.sdk.mcp.add({ directory, name, config })
-    return result.data ?? {}
+    ocCall("mcp.add", { directory, name });
+    const result = await this.sdk.mcp.add({ directory, name, config });
+    return result.data ?? {};
   }
 
   async connect(directory: string, name: string) {
-    ocCall("mcp.connect", { directory, name })
-    await this.sdk.mcp.connect({ directory, name })
-    return { success: true }
+    ocCall("mcp.connect", { directory, name });
+    await this.sdk.mcp.connect({ directory, name });
+    return { success: true };
   }
 
   async disconnect(directory: string, name: string) {
-    ocCall("mcp.disconnect", { directory, name })
-    await this.sdk.mcp.disconnect({ directory, name })
-    return { success: true }
+    ocCall("mcp.disconnect", { directory, name });
+    await this.sdk.mcp.disconnect({ directory, name });
+    return { success: true };
   }
 
   async startAuth(directory: string, name: string) {
-    ocCall("mcp.auth.start", { directory, name })
-    const result = await this.sdk.mcp.auth.start({ directory, name })
-    return result.data
+    ocCall("mcp.auth.start", { directory, name });
+    const result = await this.sdk.mcp.auth.start({ directory, name });
+    return result.data;
   }
 
   async callbackAuth(directory: string, name: string, code: string) {
-    ocCall("mcp.auth.callback", { directory, name })
-    const result = await this.sdk.mcp.auth.callback({ directory, name, code })
-    return result.data
+    ocCall("mcp.auth.callback", { directory, name });
+    const result = await this.sdk.mcp.auth.callback({ directory, name, code });
+    return result.data;
   }
 
   async removeAuth(directory: string, name: string) {
-    ocCall("mcp.auth.remove", { directory, name })
-    await this.sdk.mcp.auth.remove({ directory, name })
-    return { success: true }
+    ocCall("mcp.auth.remove", { directory, name });
+    await this.sdk.mcp.auth.remove({ directory, name });
+    return { success: true };
   }
 }
 ```
@@ -259,45 +273,47 @@ export class McpManager {
 ```typescript
 // agent.ts 中添加
 
-import { McpManager } from "./mcp-manager.js"
+import { McpManager } from "./mcp-manager.js";
 
 export class Agent implements ACPAgent {
-  private mcpManager: McpManager
+  private mcpManager: McpManager;
 
   constructor(config: ACPConfig) {
     // ...
-    this.mcpManager = new McpManager(config.sdk)
+    this.mcpManager = new McpManager(config.sdk);
   }
 
   async extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>> {
     if (method.startsWith("mcp/")) {
-      return this.handleMcpMethod(method, params)
+      return this.handleMcpMethod(method, params);
     }
-    throw new Error(`Unknown extMethod: ${method}`)
+    throw new Error(`Unknown extMethod: ${method}`);
   }
 
   private async handleMcpMethod(method: string, params: Record<string, unknown>) {
-    const sessionId = params.sessionId as string
-    const session = this.sessionManager.get(sessionId)
-    const directory = session.cwd
+    const sessionId = params.sessionId as string;
+    const session = this.sessionManager.get(sessionId);
+    const directory = session.cwd;
 
     switch (method) {
       case "mcp/status":
-        return this.mcpManager.status(directory) as Promise<Record<string, unknown>>
+        return this.mcpManager.status(directory) as Promise<Record<string, unknown>>;
       case "mcp/add":
-        return this.mcpManager.add(directory, params.name as string, params.config) as Promise<Record<string, unknown>>
+        return this.mcpManager.add(directory, params.name as string, params.config) as Promise<Record<string, unknown>>;
       case "mcp/connect":
-        return this.mcpManager.connect(directory, params.name as string)
+        return this.mcpManager.connect(directory, params.name as string);
       case "mcp/disconnect":
-        return this.mcpManager.disconnect(directory, params.name as string)
+        return this.mcpManager.disconnect(directory, params.name as string);
       case "mcp/auth/start":
-        return this.mcpManager.startAuth(directory, params.name as string) as Promise<Record<string, unknown>>
+        return this.mcpManager.startAuth(directory, params.name as string) as Promise<Record<string, unknown>>;
       case "mcp/auth/callback":
-        return this.mcpManager.callbackAuth(directory, params.name as string, params.code as string) as Promise<Record<string, unknown>>
+        return this.mcpManager.callbackAuth(directory, params.name as string, params.code as string) as Promise<
+          Record<string, unknown>
+        >;
       case "mcp/auth/remove":
-        return this.mcpManager.removeAuth(directory, params.name as string)
+        return this.mcpManager.removeAuth(directory, params.name as string);
       default:
-        throw new Error(`Unknown MCP method: ${method}`)
+        throw new Error(`Unknown MCP method: ${method}`);
     }
   }
 }
@@ -342,16 +358,16 @@ mcp: {
 
 ## 关键文件清单
 
-| 文件 | 操作 | 说明 |
-|---|---|---|
-| `src/mcp-manager.ts` | **新建** | MCP 操作封装，代理 SDK 调用 |
-| `src/agent.ts` | **修改** | 添加 extMethod 路由、集成 McpManager、迁移 MCP 注册逻辑 |
-| `src/types.ts` | **修改** | 添加 MCP 相关类型（可选） |
-| `src/__tests__/mcp-manager.test.ts` | **新建** | McpManager 单元测试 |
-| `src/__tests__/agent.test.ts` | **修改** | 添加 extMethod 测试 |
-| `src/__tests__/helpers/mock-sdk.ts` | **修改** | 补全 MCP mock 方法 |
-| `README.md` | **修改** | 文档更新 |
-| `CHANGELOG.md` | **修改** | 记录变更 |
+| 文件                                | 操作     | 说明                                                    |
+| ----------------------------------- | -------- | ------------------------------------------------------- |
+| `src/mcp-manager.ts`                | **新建** | MCP 操作封装，代理 SDK 调用                             |
+| `src/agent.ts`                      | **修改** | 添加 extMethod 路由、集成 McpManager、迁移 MCP 注册逻辑 |
+| `src/types.ts`                      | **修改** | 添加 MCP 相关类型（可选）                               |
+| `src/__tests__/mcp-manager.test.ts` | **新建** | McpManager 单元测试                                     |
+| `src/__tests__/agent.test.ts`       | **修改** | 添加 extMethod 测试                                     |
+| `src/__tests__/helpers/mock-sdk.ts` | **修改** | 补全 MCP mock 方法                                      |
+| `README.md`                         | **修改** | 文档更新                                                |
+| `CHANGELOG.md`                      | **修改** | 记录变更                                                |
 
 ## 复用
 

package/docs/provider-config-flow.md

@@ -4,20 +4,20 @@
 
 OpenCode 有两个层面的 provider 数据：
 
-| 数据源 | 接口 | 内容 | 用途 |
-|--------|------|------|------|
-| **数据库全量** | `GET /provider` | models.dev 中的所有 provider（70+） | 发现哪些 provider 可配置 |
-| **运行时可用** | `GET /config/providers` | 有凭证或 autoload 的 provider + 模型列表 | 模型选择下拉框 |
+| 数据源         | 接口                    | 内容                                     | 用途                     |
+| -------------- | ----------------------- | ---------------------------------------- | ------------------------ |
+| **数据库全量** | `GET /provider`         | models.dev 中的所有 provider（70+）      | 发现哪些 provider 可配置 |
+| **运行时可用** | `GET /config/providers` | 有凭证或 autoload 的 provider + 模型列表 | 模型选择下拉框           |
 
 **关键**：`GET /config/providers` 返回的不是"有 API Key 的 provider"，而是 `s.providers` 这个内部状态。进入 `s.providers` 的条件（`provider/provider.ts:1076-1285`）：
 
-| 条件 | 代码位置 | 说明 |
-|------|---------|------|
-| 配置文件声明了 provider | 1124 行 | `opencode.json` 中 `provider.<id>` 有配置 |
-| 环境变量有 key | 1211 行 | 如 `ANTHROPIC_API_KEY=xxx` |
-| auth.json 有 key | 1224 行 | 通过 `PUT /auth/:providerID` 存入的 |
-| Plugin auth loader | 1237 行 | Plugin 提供的认证加载器 |
-| **Custom loader autoload** | 1258 行 | **`opencode` provider 始终 autoload** |
+| 条件                       | 代码位置 | 说明                                      |
+| -------------------------- | -------- | ----------------------------------------- |
+| 配置文件声明了 provider    | 1124 行  | `opencode.json` 中 `provider.<id>` 有配置 |
+| 环境变量有 key             | 1211 行  | 如 `ANTHROPIC_API_KEY=xxx`                |
+| auth.json 有 key           | 1224 行  | 通过 `PUT /auth/:providerID` 存入的       |
+| Plugin auth loader         | 1237 行  | Plugin 提供的认证加载器                   |
+| **Custom loader autoload** | 1258 行  | **`opencode` provider 始终 autoload**     |
 
 ### `opencode` Provider 的特殊性
 
@@ -28,14 +28,14 @@ OpenCode 有两个层面的 provider 数据：
 if (!ok) {
   // 删除付费模型，保留免费模型（cost.input === 0）
   for (const [key, value] of Object.entries(input.models)) {
-    if (value.cost.input === 0) continue
-    delete input.models[key]
+    if (value.cost.input === 0) continue;
+    delete input.models[key];
   }
 }
 return {
-  autoload: Object.keys(input.models).length > 0,  // 有免费模型就 autoload
-  options: ok ? {} : { apiKey: "public" },          // 无 key 用 "public"
-}
+  autoload: Object.keys(input.models).length > 0, // 有免费模型就 autoload
+  options: ok ? {} : { apiKey: "public" }, // 无 key 用 "public"
+};
 ```
 
 **这意味着**：即使零配置，`GET /config/providers` 也会返回 `opencode` provider，包含所有免费模型（如 `glm-4.6`、`big-pickle` 等）。TUI 的 `/models` 能看到 GLM 模型就是这个原因。
@@ -258,36 +258,36 @@ VSCode                    harmony-acp                    OpenCode Server
 
 ### 控制面路由（`routes/control/index.ts`）
 
-| 方法 | 路径 | 用途 |
-|------|------|------|
-| `PUT` | `/auth/:providerID` | 设置 API Key，写入 `~/.opencode/data/auth.json` |
-| `DELETE` | `/auth/:providerID` | 移除凭证 |
+| 方法     | 路径                | 用途                                            |
+| -------- | ------------------- | ----------------------------------------------- |
+| `PUT`    | `/auth/:providerID` | 设置 API Key，写入 `~/.opencode/data/auth.json` |
+| `DELETE` | `/auth/:providerID` | 移除凭证                                        |
 
 ### 实例面路由（`routes/instance/provider.ts`）
 
-| 方法 | 路径 | 用途 |
-|------|------|------|
-| `GET` | `/provider` | 返回全量 provider 列表 + connected 状态 |
-| `GET` | `/provider/auth` | 返回每个 provider 的认证方式（API Key / OAuth） |
+| 方法   | 路径                           | 用途                                                  |
+| ------ | ------------------------------ | ----------------------------------------------------- |
+| `GET`  | `/provider`                    | 返回全量 provider 列表 + connected 状态               |
+| `GET`  | `/provider/auth`               | 返回每个 provider 的认证方式（API Key / OAuth）       |
 | `POST` | `/:providerID/oauth/authorize` | OAuth 授权（仅 Plugin 注册了 OAuth hook 的 provider） |
-| `POST` | `/:providerID/oauth/callback` | OAuth 回调 |
+| `POST` | `/:providerID/oauth/callback`  | OAuth 回调                                            |
 
 ### 实例面路由（`routes/instance/config.ts`）
 
-| 方法 | 路径 | 用途 |
-|------|------|------|
+| 方法  | 路径                | 用途                                                           |
+| ----- | ------------------- | -------------------------------------------------------------- |
 | `GET` | `/config/providers` | 返回 `s.providers`（有凭证或 autoload 的 provider + 模型列表） |
 
 ## 两个 Provider 接口的区别
 
-| | `GET /provider` | `GET /config/providers` |
-|---|---|---|
-| 数据源 | models.dev 全量数据库 + connected 状态 | `s.providers` 内部状态（有凭证/autoload） |
-| 返回范围 | **所有** provider（70+） | 仅"可用"的 provider |
-| 用途 | 发现可配置的 provider、展示配置入口 | 模型选择下拉框的数据源 |
-| 返回格式 | `{ all, default, connected }` | `{ providers, default }` |
-| ACP extMethod | `provider/list` | 无（harmony-acp 内部调用） |
-| TUI 使用 | `store.provider_next` | `store.provider`（`/models` 下拉框） |
+|               | `GET /provider`                        | `GET /config/providers`                   |
+| ------------- | -------------------------------------- | ----------------------------------------- |
+| 数据源        | models.dev 全量数据库 + connected 状态 | `s.providers` 内部状态（有凭证/autoload） |
+| 返回范围      | **所有** provider（70+）               | 仅"可用"的 provider                       |
+| 用途          | 发现可配置的 provider、展示配置入口    | 模型选择下拉框的数据源                    |
+| 返回格式      | `{ all, default, connected }`          | `{ providers, default }`                  |
+| ACP extMethod | `provider/list`                        | 无（harmony-acp 内部调用）                |
+| TUI 使用      | `store.provider_next`                  | `store.provider`（`/models` 下拉框）      |
 
 ## API Key 有效性判定
 

package/docs/session-stats-to-vscode-design.md

@@ -24,6 +24,7 @@ OpenCode session 表已持久化 `summary_additions`/`summary_deletions`/`summar
 5. **文件级 diff 已有通道** — edit tool 的 tool_call_update 已返回 diff，无需重复传输
 
 **数据格式：**
+
 ```typescript
 usage_update._meta.codeChange = {
   additions: number
@@ -84,9 +85,9 @@ usage_update._meta.codeChange = {
 
 ```typescript
 export interface CodeChangeStats {
-  additions: number
-  deletions: number
-  files: number
+  additions: number;
+  deletions: number;
+  files: number;
 }
 ```
 
@@ -113,6 +114,7 @@ case "session.diff": {
 ```
 
 新增实例变量和方法：
+
 - `diffStats: Map<string, CodeChangeStats>` — 存储 session 级 diff 聚合
 - `getDiffStats(sessionId)` — 供 agent.ts 读取
 - `setDiffStats(sessionId, stats)` — 供 agent.ts 回填历史数据
@@ -166,13 +168,13 @@ _meta: {
 从返回数据中提取 summary，存入 EventHandler 的 `diffStats` map：
 
 ```typescript
-const session = await this.sdk.session.get({ sessionID, directory })
+const session = await this.sdk.session.get({ sessionID, directory });
 if (session.data?.summary) {
   this.eventHandler.setDiffStats(sessionID, {
     additions: session.data.summary.additions,
     deletions: session.data.summary.deletions,
     files: session.data.summary.files,
-  })
+  });
 }
 ```
 
@@ -188,22 +190,22 @@ if (session.data?.summary) {
 
 ## 涉及文件
 
-| 文件 | 修改内容 |
-|------|---------|
-| `src/types.ts` | 新增 `CodeChangeStats` 接口 |
-| `src/event-handler.ts` | 新增 `session.diff` 事件处理 + `diffStats` map + get/set/clear 方法 |
-| `src/agent.ts` | `sendUsageUpdate()` 附加 `_meta.codeChange`；`loadSession()`/`resumeSession()` 读取 `session.summary` |
+| 文件                   | 修改内容                                                                                              |
+| ---------------------- | ----------------------------------------------------------------------------------------------------- |
+| `src/types.ts`         | 新增 `CodeChangeStats` 接口                                                                           |
+| `src/event-handler.ts` | 新增 `session.diff` 事件处理 + `diffStats` map + get/set/clear 方法                                   |
+| `src/agent.ts`         | `sendUsageUpdate()` 附加 `_meta.codeChange`；`loadSession()`/`resumeSession()` 读取 `session.summary` |
 
 ---
 
 ## 依赖的 OpenCode 现有能力
 
-| 能力 | 来源 | 说明 |
-|------|------|------|
-| `session.diff` SSE 事件 | OpenCode SDK `EventSessionDiff` | session 代码变更时实时推送 `SnapshotFileDiff[]` |
-| `Session.summary` 字段 | OpenCode SDK `Session` 类型 | 含 `additions`/`deletions`/`files`/`diffs` |
-| `UsageUpdate._meta` | ACP 协议 | `{ [key: string]: unknown }` 扩展字段 |
-| 已有 `_meta` 扩展模式 | harmony-acp `sendUsageUpdate()` | 已传递 `parentCost`/`childCost`/`childSessionCount` |
+| 能力                    | 来源                            | 说明                                                |
+| ----------------------- | ------------------------------- | --------------------------------------------------- |
+| `session.diff` SSE 事件 | OpenCode SDK `EventSessionDiff` | session 代码变更时实时推送 `SnapshotFileDiff[]`     |
+| `Session.summary` 字段  | OpenCode SDK `Session` 类型     | 含 `additions`/`deletions`/`files`/`diffs`          |
+| `UsageUpdate._meta`     | ACP 协议                        | `{ [key: string]: unknown }` 扩展字段               |
+| 已有 `_meta` 扩展模式   | harmony-acp `sendUsageUpdate()` | 已传递 `parentCost`/`childCost`/`childSessionCount` |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harmonyos-arkts/opencode-acp",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Enhanced ACP (Agent Client Protocol) server for OpenCode with subagent visibility",
   "type": "module",
   "main": "dist/index.cjs",
@@ -23,6 +23,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:integration": "node scripts/test-integration.mjs",
+    "test:mcp": "node scripts/test-mcp-extmethod.mjs",
     "logs": "node scripts/view-log.mjs",
     "logs:filter": "node scripts/view-log.mjs --filter"
   },