@downcity/agent 1.1.152 → 1.1.157

package/bin/types/plugin/PluginRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginRuntime.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginRuntime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PluginRuntime.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginRuntime.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.152",
+  "version": "1.1.157",
   "type": "module",
   "description": "Downcity Agent 运行时 — 单 Agent 执行壳与本机 RPC 能力",
   "main": "./bin/index.js",
@@ -17,8 +17,8 @@
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.48",
-    "@downcity/shell": "^0.1.30",
-    "@downcity/type": "0.1.64",
+    "@downcity/shell": "^0.1.33",
+    "@downcity/type": "0.1.67",
     "@larksuiteoapi/node-sdk": "^1.66.0",
     "ai": "^6.0.193",
     "commander": "^15.0.0",

package/scripts/image-plugin-job.test.mjs

@@ -1,16 +1,20 @@
 /**
- * @file 验证 ImagePlugin 对 Agent 保持直接生图体验。
+ * @file 验证 ImagePlugin 的两步式图片任务协议。
  *
  * 关键点（中文）
- * - Agent 只调用 `generate` action。
- * - 插件内部调用注入的 image_create / image_result 任务函数并轮询。
- * - 成功后返回 UIMessage，后续由 plugin bridge 落盘 file parts。
+ * - 插件只暴露 image_create / image_result 两个任务 action。
+ * - image_result 只读取一次当前状态，不在 plugin 层等待终态。
+ * - 成功图片仍以 UIMessage 返回，后续由 plugin bridge 落盘 file parts。
  */
 
 import test from "node:test";
 import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
 
-import { ImagePlugin } from "../bin/index.js";
+import { ImagePlugin } from "../../plugins/bin/index.js";
+import { createAgentPluginRegistry } from "../bin/agent/local/AgentPluginFactory.js";
 
 function create_image_message() {
   return {
@@ -27,54 +31,326 @@ function create_image_message() {
   };
 }
 
-test("ImagePlugin generate creates and polls image jobs", async () => {
+function create_context(rootPath = process.cwd()) {
+  return { rootPath };
+}
+
+function create_registry(plugin, rootPath = process.cwd()) {
+  return createAgentPluginRegistry({
+    plugins: [plugin],
+    get_context: () => create_context(rootPath),
+  });
+}
+
+test("ImagePlugin exposes only job-style image actions", async () => {
+  const plugin = new ImagePlugin({
+    image_create: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+    image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+  });
+
+  assert.equal("image_create" in plugin.actions, true);
+  assert.equal("image_result" in plugin.actions, true);
+  assert.equal("models" in plugin.actions, true);
+  assert.equal("generate" in plugin.actions, false);
+});
+
+test("ImagePlugin image_create returns image job", async () => {
+  const plugin = new ImagePlugin({
+    image_create: (input) => ({
+      job_id: "img_1",
+      status: "queued",
+      poll_after_ms: 1,
+      metadata: { prompt: input.prompt },
+    }),
+    image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+  });
+
+  const result = await plugin.actions.image_create.execute({
+    context: create_context(),
+    payload: { prompt: "draw" },
+    pluginName: "image",
+    actionName: "image_create",
+  });
+
+  assert.equal(result.success, true);
+  assert.equal(result.data.job_id, "img_1");
+  assert.equal(result.data.status, "queued");
+});
+
+test("ImagePlugin models lists image-capable models", async () => {
+  const plugin = new ImagePlugin({
+    list_models: () => [
+      {
+        id: "text_1",
+        name: "Text",
+        description: "text only",
+        modalities: ["text"],
+        tags: ["general"],
+        meta: {},
+      },
+      {
+        id: "image_1",
+        name: "Image",
+        description: "image model",
+        modalities: ["image"],
+        tags: ["creative"],
+        meta: { provider: "test" },
+        default_modalities: ["image"],
+      },
+    ],
+    image_create: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+    image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+  });
+
+  const result = await plugin.actions.models.execute({
+    context: create_context(),
+    payload: {},
+    pluginName: "image",
+    actionName: "models",
+  });
+
+  assert.equal(result.success, true);
+  assert.equal(result.data.default_model_id, "image_1");
+  assert.deepEqual(result.data.items.map((item) => item.id), ["image_1"]);
+  assert.equal(result.data.items[0].meta.provider, "test");
+});
+
+test("ImagePlugin exposes action metadata through plugin registry", async () => {
+  const plugin = new ImagePlugin({
+    image_create: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+    image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+  });
+  const registry = create_registry(plugin);
+
+  const metadata = registry.read({
+    plugin: "image",
+    action: "image_create",
+  });
+
+  assert.equal(metadata.name, "image");
+  assert.equal(metadata.actions.length, 1);
+  assert.equal(metadata.actions[0].name, "image_create");
+  assert.equal(metadata.actions[0].has_input_schema, true);
+  assert.match(metadata.actions[0].description, /Create an async image job/);
+  assert.equal(metadata.actions[0].examples[0].payload.prompt.includes("rainy city"), true);
+});
+
+test("ImagePlugin image_result reads pending state once", async () => {
   const calls = [];
-  const message = create_image_message();
   const plugin = new ImagePlugin({
-    min_poll_interval_ms: 1,
-    image_create: (input) => {
-      calls.push(["create", input.prompt]);
-      return { job_id: "img_1", status: "queued", poll_after_ms: 1 };
-    },
+    image_create: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
     image_result: (input) => {
-      calls.push(["result", input.job_id]);
-      return calls.length === 2
-        ? { job_id: input.job_id, status: "running", poll_after_ms: 1 }
-        : { job_id: input.job_id, status: "succeeded", result: message, poll_after_ms: 1 };
+      calls.push(input.job_id);
+      return {
+        job_id: input.job_id,
+        status: "running",
+        message: "upstream pending",
+        poll_after_ms: 1,
+      };
     },
   });
 
-  const result = await plugin.actions.generate.execute({
-    context: {},
-    payload: { prompt: "draw" },
+  const result = await plugin.actions.image_result.execute({
+    context: create_context(),
+    payload: { job_id: "img_1" },
+    pluginName: "image",
+    actionName: "image_result",
+  });
+
+  assert.equal(result.success, true);
+  assert.equal(result.data.job_id, "img_1");
+  assert.equal(result.data.status, "running");
+  assert.equal(result.data.message, "upstream pending");
+  assert.deepEqual(calls, ["img_1"]);
+});
+
+test("ImagePlugin image_result returns final message when succeeded", async () => {
+  const message = create_image_message();
+  const plugin = new ImagePlugin({
+    image_create: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+    image_result: (input) => ({
+      job_id: input.job_id,
+      status: "succeeded",
+      result: message,
+      poll_after_ms: 1,
+    }),
+  });
+
+  const result = await plugin.actions.image_result.execute({
+    context: create_context(),
+    payload: { job_id: "img_1" },
     pluginName: "image",
-    actionName: "generate",
+    actionName: "image_result",
   });
 
   assert.equal(result.success, true);
   assert.equal(result.data.role, "assistant");
   assert.equal(result.data.parts[0].type, "file");
-  assert.deepEqual(calls, [
-    ["create", "draw"],
-    ["result", "img_1"],
-    ["result", "img_1"],
-  ]);
 });
 
-test("ImagePlugin generate reports image failure", async () => {
+test("ImagePlugin image_result reports failed terminal job", async () => {
   const plugin = new ImagePlugin({
-    min_poll_interval_ms: 1,
     image_create: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
-    image_result: () => ({ job_id: "img_1", status: "failed", error: "provider failed", poll_after_ms: 1 }),
+    image_result: (input) => ({
+      job_id: input.job_id,
+      status: "failed",
+      error: "provider failed",
+      poll_after_ms: 1,
+    }),
   });
 
-  const result = await plugin.actions.generate.execute({
-    context: {},
-    payload: { prompt: "draw" },
+  const result = await plugin.actions.image_result.execute({
+    context: create_context(),
+    payload: { job_id: "img_1" },
     pluginName: "image",
-    actionName: "generate",
+    actionName: "image_result",
   });
 
   assert.equal(result.success, false);
   assert.match(result.error, /provider failed/);
+  assert.equal(result.data.job_id, "img_1");
+});
+
+test("ImagePlugin image_result payload is schema validated by registry", async () => {
+  const plugin = new ImagePlugin({
+    image_create: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+    image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+  });
+  const registry = create_registry(plugin);
+
+  const result = await registry.runAction({
+    plugin: "image",
+    action: "image_result",
+    payload: {},
+  });
+
+  assert.equal(result.success, false);
+  assert.match(result.error, /Invalid payload/);
+});
+
+test("ImagePlugin image_create converts local content image paths", async () => {
+  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "downcity-image-plugin-content-"));
+  try {
+    await fs.writeFile(path.join(tempDir, "input.png"), Buffer.from("png"));
+    let captured_input;
+    const plugin = new ImagePlugin({
+      image_create: (input) => {
+        captured_input = input;
+        return { job_id: "img_1", status: "queued", poll_after_ms: 1 };
+      },
+      image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+    });
+
+    const result = await plugin.actions.image_create.execute({
+      context: create_context(tempDir),
+      payload: {
+        content: [
+          { type: "text", text: "change background" },
+          { type: "image", url: "./input.png" },
+        ],
+      },
+      pluginName: "image",
+      actionName: "image_create",
+    });
+
+    assert.equal(result.success, true);
+    assert.equal(captured_input.messages[0].content[0].text, "change background");
+    assert.match(captured_input.messages[0].content[1].data_url, /^data:image\/png;base64,/);
+    assert.equal(captured_input.messages[0].content[1].media_type, "image/png");
+    assert.equal("content" in captured_input, false);
+    assert.equal("prompt" in captured_input, false);
+  } finally {
+    await fs.rm(tempDir, { recursive: true, force: true });
+  }
+});
+
+test("ImagePlugin image_create uses content instead of prompt when both exist", async () => {
+  let captured_input;
+  const plugin = new ImagePlugin({
+    image_create: (input) => {
+      captured_input = input;
+      return { job_id: "img_1", status: "queued", poll_after_ms: 1 };
+    },
+    image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+  });
+
+  const result = await plugin.actions.image_create.execute({
+    context: create_context(),
+    payload: {
+      prompt: "ignore this prompt",
+      content: [{ type: "text", text: "use this content" }],
+    },
+    pluginName: "image",
+    actionName: "image_create",
+  });
+
+  assert.equal(result.success, true);
+  assert.equal(captured_input.messages[0].content[0].text, "use this content");
+  assert.equal("prompt" in captured_input, false);
+});
+
+test("ImagePlugin image_create keeps remote content image URLs", async () => {
+  let captured_input;
+  const plugin = new ImagePlugin({
+    image_create: (input) => {
+      captured_input = input;
+      return { job_id: "img_1", status: "queued", poll_after_ms: 1 };
+    },
+    image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+  });
+
+  const result = await plugin.actions.image_create.execute({
+    context: create_context(),
+    payload: {
+      content: [
+        { type: "text", text: "use this style" },
+        { type: "image", url: "https://example.com/input.webp", media_type: "image/webp" },
+      ],
+    },
+    pluginName: "image",
+    actionName: "image_create",
+  });
+
+  assert.equal(result.success, true);
+  assert.equal(captured_input.messages[0].content[1].url, "https://example.com/input.webp");
+  assert.equal(captured_input.messages[0].content[1].media_type, "image/webp");
+});
+
+test("ImagePlugin image_create rejects legacy messages and data URLs", async () => {
+  const plugin = new ImagePlugin({
+    image_create: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+    image_result: () => ({ job_id: "img_1", status: "queued", poll_after_ms: 1 }),
+  });
+
+  const messages_result = await plugin.actions.image_create.execute({
+    context: create_context(),
+    payload: {
+      messages: [
+        {
+          role: "user",
+          content: [{ type: "text", text: "legacy" }],
+        },
+      ],
+    },
+    pluginName: "image",
+    actionName: "image_create",
+  });
+
+  assert.equal(messages_result.success, false);
+  assert.match(messages_result.error, /messages is not supported/);
+
+  const data_url_result = await plugin.actions.image_create.execute({
+    context: create_context(),
+    payload: {
+      content: [
+        { type: "text", text: "edit this" },
+        { type: "image", url: "data:image/png;base64,cG5n" },
+      ],
+    },
+    pluginName: "image",
+    actionName: "image_create",
+  });
+
+  assert.equal(data_url_result.success, false);
+  assert.match(data_url_result.error, /does not accept data URLs/);
 });

package/scripts/plugin-tool-bridge.test.mjs

@@ -0,0 +1,199 @@
+/**
+ * @file 验证 plugin tool bridge 会把生成文件摘要为可打开路径。
+ *
+ * 关键点（中文）
+ * - assistant message 仍然使用 `resources://` URL，避免历史暴露本机路径。
+ * - tool result 额外返回本机绝对路径，便于模型与用户明确知道文件位置。
+ */
+
+import test from "node:test";
+import assert from "node:assert/strict";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs/promises";
+
+import {
+  invokePluginCallTool,
+  invokePluginReadTool,
+  setPluginToolRuntime,
+} from "../bin/executor/tools/plugin/PluginToolBridge.js";
+import { withSessionRunScope } from "../bin/executor/SessionRunScope.js";
+import { createAction, createPlugin } from "../bin/plugin/core/PluginActionFactory.js";
+import { createAgentPluginRegistry } from "../bin/agent/local/AgentPluginFactory.js";
+import { z } from "zod";
+
+function create_run_context(project_root) {
+  return {
+    sessionId: "session_test",
+    projectRoot: project_root,
+    injectedUserMessages: [],
+    deferredPersistedUserMessages: [],
+    pendingAssistantFileParts: [],
+  };
+}
+
+test("invokePluginCallTool returns absolute paths for materialized file parts", async () => {
+  const project_root = await fs.mkdtemp(
+    path.join(os.tmpdir(), "downcity-agent-plugin-tool-files-"),
+  );
+  const bytes = Buffer.from("png-bytes-for-plugin-tool", "utf8");
+
+  setPluginToolRuntime({
+    list: () => [],
+    read: () => ({ plugins: [] }),
+    availability: async () => ({ enabled: true, available: true, reasons: [] }),
+    runAction: async () => ({
+      success: true,
+      message: "image generated",
+      data: {
+        id: "msg_image_test",
+        role: "assistant",
+        parts: [
+          {
+            type: "file",
+            mediaType: "image/png",
+            filename: "image.png",
+            url: `data:image/png;base64,${bytes.toString("base64")}`,
+          },
+        ],
+      },
+    }),
+    pipeline: async (_, value) => value,
+    guard: async () => {},
+    effect: async () => {},
+    resolve: async () => {
+      throw new Error("not implemented");
+    },
+  });
+
+  const run_context = create_run_context(project_root);
+  const result = await withSessionRunScope({ runContext: run_context }, () =>
+    invokePluginCallTool({
+      plugin: "image",
+      action: "image_result",
+      payload: { job_id: "img_1" },
+    }),
+  );
+
+  assert.equal(result.success, true);
+  assert.equal(result.assistant_file_count, 1);
+  assert.equal(result.files?.length, 1);
+  assert.match(result.files[0].url, /^resources:\/\/\.downcity\/resources\//);
+  assert.equal(path.isAbsolute(result.files[0].path), true);
+  assert.equal(
+    path.dirname(result.files[0].path),
+    path.join(project_root, ".downcity", "resources"),
+  );
+  assert.deepEqual(await fs.readFile(result.files[0].path), bytes);
+  assert.equal("data" in result, false);
+
+  const pending_parts = run_context.pendingAssistantFileParts;
+  assert.equal(pending_parts.length, 1);
+  assert.equal(pending_parts[0].url, result.files[0].url);
+});
+
+test("invokePluginReadTool returns plugin action metadata", async () => {
+  setPluginToolRuntime({
+    list: () => [],
+    read: () => ({
+      name: "image",
+      title: "Image",
+      description: "Create images",
+      actions: [
+        {
+          name: "image_create",
+          description: "Create image job",
+          has_input_schema: true,
+          input_schema: {
+            type: "object",
+            properties: {
+              prompt: { type: "string" },
+            },
+          },
+          examples: [
+            {
+              title: "Text-only image",
+              payload: { prompt: "draw" },
+            },
+          ],
+          allow_when_disabled: false,
+          has_command: false,
+          has_api: false,
+        },
+      ],
+    }),
+    availability: async () => ({ enabled: true, available: true, reasons: [] }),
+    runAction: async () => ({ success: false, error: "not used" }),
+    pipeline: async (_, value) => value,
+    guard: async () => {},
+    effect: async () => {},
+    resolve: async () => {
+      throw new Error("not implemented");
+    },
+  });
+
+  const result = await invokePluginReadTool({
+    plugin: "image",
+    action: "image_create",
+  });
+
+  assert.equal(result.success, true);
+  assert.equal(result.data.name, "image");
+  assert.equal(result.data.actions[0].name, "image_create");
+  assert.equal(result.data.actions[0].has_input_schema, true);
+  assert.equal(result.data.actions[0].examples[0].payload.prompt, "draw");
+});
+
+test("PluginRegistry validates action payload with metadata schema", async () => {
+  const plugin = createPlugin({
+    name: "demo",
+    title: "Demo",
+    description: "Demo plugin",
+    actions: {
+      echo: createAction({
+        description: "Echo text",
+        input_schema: {
+          zod: z.object({
+            text: z.string(),
+          }),
+          json_schema: {
+            type: "object",
+            required: ["text"],
+            properties: {
+              text: { type: "string" },
+            },
+          },
+        },
+        execute: async ({ input }) => ({
+          success: true,
+          data: { text: input.text },
+          message: "echoed",
+        }),
+      }),
+    },
+  });
+  const registry = createAgentPluginRegistry({
+    plugins: [plugin],
+    get_context: () => ({ rootPath: process.cwd() }),
+  });
+
+  const metadata = registry.read({ plugin: "demo", action: "echo" });
+  assert.equal(metadata.actions[0].description, "Echo text");
+  assert.equal(metadata.actions[0].has_input_schema, true);
+
+  const invalid = await registry.runAction({
+    plugin: "demo",
+    action: "echo",
+    payload: {},
+  });
+  assert.equal(invalid.success, false);
+  assert.match(invalid.error, /Invalid payload/);
+
+  const valid = await registry.runAction({
+    plugin: "demo",
+    action: "echo",
+    payload: { text: "hello" },
+  });
+  assert.equal(valid.success, true);
+  assert.equal(valid.data.text, "hello");
+});

package/src/agent/local/services/AgentAssemblyService.ts

@@ -184,6 +184,7 @@ export class AgentAssemblyService {
     });
     const plugins = plugin_registry;
     if (this.should_register_plugin_call_tool(plugin_instances)) {
+      tools.plugin_read = tools.plugin_read || plugin_tools.plugin_read;
       tools.plugin_call = tools.plugin_call || plugin_tools.plugin_call;
     }
     const resolve_session_model = this.resolve_session_model;

package/src/executor/composer/system/default/assets/plugin.prompt.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/executor/composer/system/default/assets/plugin.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "# Plugin State\n\n你正在一个基于 plugin 的执行环境中工作。\n\n## Plugin 调用规则\n\n- 当你需要使用 plugin 能力时，优先通过可用的 tool 调用 plugin action。\n- 若当前工具集中存在 `plugin_call`，使用 `plugin_call({ plugin, action, payload })` 触发对应 plugin action。\n- `plugin_call.plugin` 是 plugin 名称，例如 `skill`、`task`、`memory`、`contact`。\n- `plugin_call.action` 是 action 名称，例如 `list`、`lookup`、`create`、`run`。\n- `plugin_call.payload` 是结构化 JSON payload；没有参数时传 `{}`。\n- ActionSchedule 是 Agent 内部用于延迟执行 plugin action 的能力，不是独立 plugin。\n\n## 可用 plugin 概览\n\n- 当前内建托管 plugin：`shell` / `chat` / `task` / `memory` / `contact`。\n- 当前内建本地 plugin：`auth` / `skill`。\n\n具体 plugin 能力以该 plugin 的 action 和 system 提示为准。\n";
+const TEXT_MODULE_CONTENT = "# Plugin State\n\n你正在一个基于 plugin 的执行环境中工作。\n\n## Plugin 调用规则\n\n- 当你需要使用 plugin 能力时，优先通过可用的 tool 调用 plugin action。\n- 若当前工具集中存在 `plugin_read`，在不确定 plugin action、参数 schema 或示例时，先使用 `plugin_read({ plugin, action? })` 读取 metadata。\n- 若当前工具集中存在 `plugin_call`，使用 `plugin_call({ plugin, action, payload })` 触发对应 plugin action。\n- `plugin_call.plugin` 是 plugin 名称，例如 `skill`、`task`、`memory`、`contact`。\n- `plugin_call.action` 是 action 名称，例如 `list`、`lookup`、`create`、`run`。\n- `plugin_call.payload` 是结构化 JSON payload；没有参数时传 `{}`。如果 action metadata 声明了 input schema，payload 必须符合 schema。\n- ActionSchedule 是 Agent 内部用于延迟执行 plugin action 的能力，不是独立 plugin。\n\n## 可用 plugin 概览\n\n- 当前内建托管 plugin：`shell` / `chat` / `task` / `memory` / `contact`。\n- 当前内建本地 plugin：`auth` / `skill`。\n\n具体 plugin 能力以 `plugin_read` 返回的 action metadata 和该 plugin 的 system 提示为准。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/executor/composer/system/default/assets/plugin.prompt.ts.txt

@@ -5,10 +5,11 @@
 ## Plugin 调用规则
 
 - 当你需要使用 plugin 能力时，优先通过可用的 tool 调用 plugin action。
+- 若当前工具集中存在 `plugin_read`，在不确定 plugin action、参数 schema 或示例时，先使用 `plugin_read({ plugin, action? })` 读取 metadata。
 - 若当前工具集中存在 `plugin_call`，使用 `plugin_call({ plugin, action, payload })` 触发对应 plugin action。
 - `plugin_call.plugin` 是 plugin 名称，例如 `skill`、`task`、`memory`、`contact`。
 - `plugin_call.action` 是 action 名称，例如 `list`、`lookup`、`create`、`run`。
-- `plugin_call.payload` 是结构化 JSON payload；没有参数时传 `{}`。
+- `plugin_call.payload` 是结构化 JSON payload；没有参数时传 `{}`。如果 action metadata 声明了 input schema，payload 必须符合 schema。
 - ActionSchedule 是 Agent 内部用于延迟执行 plugin action 的能力，不是独立 plugin。
 
 ## 可用 plugin 概览
@@ -16,4 +17,4 @@
 - 当前内建托管 plugin：`shell` / `chat` / `task` / `memory` / `contact`。
 - 当前内建本地 plugin：`auth` / `skill`。
 
-具体 plugin 能力以该 plugin 的 action 和 system 提示为准。
+具体 plugin 能力以 `plugin_read` 返回的 action metadata 和该 plugin 的 system 提示为准。