mu-agent-bridge 1.0.0 → 1.0.1

package/README.md

@@ -56,6 +56,11 @@ abweb 的“配置码”栏；配对码 10 分钟有效，只能使用一次，
 `package.json` 中声明 `agentBridge.plugin`，平台复用统一的 `activate`、`deactivate`、`health`、
 `handle` 生命周期。已加载插件可以通过管理 API 重载；新增 npm 包后重启 daemon 最可靠。
 
+abweb 插件目录从 npm 搜索带 `mu-agent-bridge-plugin` 关键词的包，按包元数据中的
+`agentBridge.type` 展示 Agent、Channel 和管理插件；安装后以 `plugin.json` 的类型和能力
+再次校验，不根据包名推断类型。搜索结果有收录延迟，可在页面直接输入 `agent-bridge-*`
+包名安装。已安装插件按清单能力兼容旧版分类；AUN Channel 仍需单独实现并发布后才会出现。
+
 插件仍在 daemon 的同一个 Node.js 进程内运行。修改插件入口依赖后应重启 daemon，避免模块缓存
 影响新代码。
 

package/dist/src-ts/control-server.js

@@ -126,6 +126,8 @@ class ControlServer {
             }
             if (method === "GET" && url.pathname === "/api/plugins")
                 return this.json(res, 200, { ok: true, plugins: this.options.manager.list() });
+            if (method === "GET" && url.pathname === "/api/plugins/catalog")
+                return this.json(res, 200, { ok: true, plugins: await this.options.manager.searchPackages(url.searchParams.get("q") ?? "") });
             if (method === "GET" && url.pathname === "/api/routes")
                 return this.json(res, 200, []);
             if (parts[0] === "api" && parts[1] === "plugins" && parts[2]) {

package/dist/src-ts/plugin-catalog.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchPluginCatalog = searchPluginCatalog;
+const registry = "https://registry.npmjs.org";
+const pluginName = /^agent-bridge-[a-z0-9-]+$/;
+async function getJson(url) {
+    const response = await fetch(url, { signal: AbortSignal.timeout(10_000) });
+    if (!response.ok)
+        throw new Error(`npm 查询失败：HTTP ${response.status}`);
+    return response.json();
+}
+async function searchPluginCatalog(query = "", get = getJson) {
+    if (query.length > 80)
+        throw new Error("搜索词过长");
+    const params = new URLSearchParams({ text: `keywords:mu-agent-bridge-plugin ${query.trim()}`.trim(), size: "30" });
+    const result = await get(`${registry}/-/v1/search?${params}`);
+    const candidates = Array.isArray(result?.objects) ? result.objects.slice(0, 30) : [];
+    const items = await Promise.all(candidates.map(async (entry) => {
+        const name = entry?.package?.name;
+        if (typeof name !== "string" || !pluginName.test(name))
+            return;
+        try {
+            const metadata = await get(`${registry}/${encodeURIComponent(name)}`);
+            const version = metadata?.["dist-tags"]?.latest;
+            const pkg = metadata?.versions?.[version];
+            const type = pkg?.agentBridge?.type;
+            if (!pkg?.agentBridge?.plugin || !["agent", "channel", "management"].includes(type))
+                return;
+            return { name, version, description: typeof entry.package.description === "string" ? entry.package.description : "", type };
+        }
+        catch {
+            return;
+        }
+    }));
+    return items.filter((item) => Boolean(item));
+}

package/dist/src-ts/plugin-manager.js

@@ -10,6 +10,7 @@ const node_path_1 = require("node:path");
 const agent_1 = require("./agent");
 const plugin_manifest_1 = require("./plugin-manifest");
 const version_manager_1 = require("./version-manager");
+const plugin_catalog_1 = require("./plugin-catalog");
 const logger = { info() { }, warn() { }, error() { } };
 const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 class PluginManager {
@@ -135,21 +136,36 @@ class PluginManager {
         if (this.plugins.has(name.replace(/^agent-bridge-/, "")))
             throw new agent_1.AgentError("插件已经存在");
         const prefix = (0, node_path_1.join)(this.options.stateDir, "npm", name);
+        if (await this.existsDir(prefix))
+            throw new agent_1.AgentError("插件包已经安装");
         await (0, promises_1.mkdir)(prefix, { recursive: true });
-        if (process.platform === "win32")
-            await execFileAsync(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", `npm install --prefix "${prefix}" --no-save --ignore-scripts ${packageName}`]);
-        else
-            await execFileAsync("npm", ["install", "--prefix", prefix, "--no-save", "--ignore-scripts", packageName]);
-        const directory = (0, node_path_1.join)(prefix, "node_modules", name);
-        const meta = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(directory, "package.json"), "utf8"));
-        if (!meta.agentBridge?.plugin)
-            throw new agent_1.AgentError("npm 包未声明 agentBridge.plugin");
-        await this.discoverDirectory(directory, name, (0, node_path_1.resolve)(directory, meta.agentBridge.plugin));
-        const record = this.plugins.get(JSON.parse(await (0, promises_1.readFile)((0, node_path_1.resolve)(directory, meta.agentBridge.plugin), "utf8")).id)?.record;
-        if (!record)
-            throw new agent_1.AgentError("插件发现失败");
-        return record;
+        try {
+            if (process.platform === "win32")
+                await execFileAsync(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", `npm install --prefix "${prefix}" --no-save --ignore-scripts ${packageName}`]);
+            else
+                await execFileAsync("npm", ["install", "--prefix", prefix, "--no-save", "--ignore-scripts", packageName]);
+            const directory = (0, node_path_1.join)(prefix, "node_modules", name);
+            const meta = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(directory, "package.json"), "utf8"));
+            if (meta.name !== name || !meta.version || !meta.agentBridge?.plugin)
+                throw new agent_1.AgentError("npm 包名称或插件声明无效");
+            const manifestFile = (0, node_path_1.resolve)(directory, meta.agentBridge.plugin);
+            if (!manifestFile.startsWith(`${(0, node_path_1.resolve)(directory)}${node_path_1.sep}`))
+                throw new agent_1.AgentError("插件清单路径越界");
+            const manifest = (0, plugin_manifest_1.validateManifest)(JSON.parse(await (0, promises_1.readFile)(manifestFile, "utf8")), directory);
+            if (manifest.id !== name.slice("agent-bridge-".length) || manifest.version !== meta.version || (meta.agentBridge.type && meta.agentBridge.type !== manifest.type))
+                throw new agent_1.AgentError("npm 包与插件清单不匹配");
+            await this.discoverDirectory(directory, name, manifestFile);
+            const record = this.plugins.get(manifest.id)?.record;
+            if (!record)
+                throw new agent_1.AgentError("插件发现失败");
+            return record;
+        }
+        catch (error) {
+            await (0, promises_1.rm)(prefix, { recursive: true, force: true });
+            throw error;
+        }
     }
+    async searchPackages(query = "") { return (0, plugin_catalog_1.searchPluginCatalog)(query); }
     async install(source) {
         const manifest = (0, plugin_manifest_1.validateManifest)(JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(source, "plugin.json"), "utf8")), source);
         const target = (0, node_path_1.join)(this.root, manifest.id, manifest.version);
@@ -416,7 +432,7 @@ class PluginManager {
             const manifest = (0, plugin_manifest_1.validateManifest)(JSON.parse(await (0, promises_1.readFile)(manifestFile, "utf8")), directory);
             if (this.plugins.has(manifest.id))
                 return;
-            this.plugins.set(manifest.id, { record: { id: manifest.id, version: manifest.version, displayName: manifest.displayName ?? manifest.id, status: "discovered", capabilities: manifest.capabilities, manifest, path: directory } });
+            this.plugins.set(manifest.id, { record: { id: manifest.id, version: manifest.version, type: manifest.type ?? "other", displayName: manifest.displayName ?? manifest.id, status: "discovered", capabilities: manifest.capabilities, manifest, path: directory } });
         }
         catch (error) {
             throw new agent_1.AgentError(`invalid plugin ${label}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });

package/dist/src-ts/plugin-manifest.js

@@ -18,6 +18,11 @@ function validateManifest(value, baseDir) {
         throw new agent_1.AgentError("unsupported plugin apiVersion");
     if (!Array.isArray(m.capabilities) || m.capabilities.some((c) => typeof c !== "string" || !c.trim()))
         throw new agent_1.AgentError("invalid plugin capabilities");
+    if (m.type && !["agent", "channel", "management", "other"].includes(m.type))
+        throw new agent_1.AgentError("invalid plugin type");
+    const inferredType = m.capabilities.includes("channel") ? "channel" : m.capabilities.includes("chat") ? "agent" : m.capabilities.includes("management") ? "management" : "other";
+    if (m.type && inferredType !== "other" && m.type !== inferredType)
+        throw new agent_1.AgentError("插件类型与能力不匹配");
     if (m.process && m.process !== "in-process" && m.process !== "isolated")
         throw new agent_1.AgentError("invalid plugin process");
     if (baseDir) {
@@ -27,5 +32,5 @@ function validateManifest(value, baseDir) {
         if ((0, node_path_1.isAbsolute)(m.entry) || rel.startsWith(`..${node_path_1.sep}`) || rel === "..")
             throw new agent_1.AgentError("plugin entry path escapes plugin directory");
     }
-    return { id: m.id, version: m.version, displayName: m.displayName ?? m.id, entry: m.entry, apiVersion: m.apiVersion, process: m.process ?? "in-process", capabilities: [...m.capabilities], configSchema: m.configSchema, routes: m.routes };
+    return { id: m.id, version: m.version, displayName: m.displayName ?? m.id, type: m.type ?? inferredType, entry: m.entry, apiVersion: m.apiVersion, process: m.process ?? "in-process", capabilities: [...m.capabilities], configSchema: m.configSchema, routes: m.routes };
 }

package/dist/src-ts/plugins/abweb/index.js

@@ -5,7 +5,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const MANIFEST = {
     id: "abweb",
-    version: "1.0.0",
+    version: "1.0.1",
     displayName: "Agent Bridge Web",
     entry: "dist/index.js",
     apiVersion: "1",

package/dist/src-ts/plugins/abweb/public/app.js

@@ -7,6 +7,8 @@
     const tokenNode = node("#token");
     const pairCodeNode = node("#pair-code");
     const packageNode = node("#package-name");
+    const packageSearchNode = node("#package-search");
+    const catalogNode = node("#catalog");
     const pluginPathNode = node("#plugin-path");
     const picker = node("#plugin-picker");
     const aidList = node("#aids");
@@ -17,6 +19,19 @@
     let pluginConfigs = {};
     let pluginVersions = {};
     function error(message) { errorNode.textContent = message; errorNode.hidden = !message; }
+    async function loadCatalog() {
+        const result = await request(`/api/plugins/catalog?q=${encodeURIComponent(packageSearchNode.value.trim())}`);
+        const items = result.plugins ?? [];
+        packageNode.replaceChildren(...[["Agent", "agent"], ["Channel", "channel"], ["管理", "management"]].flatMap(([label, type]) => {
+            const group = document.createElement("optgroup");
+            group.label = label;
+            group.append(...items.filter((item) => item.type === type).map((item) => new Option(`${item.name} · v${item.version}`, item.name)));
+            return group.children.length ? [group] : [];
+        }));
+        catalogNode.replaceChildren(...items.map((plugin) => { const item = document.createElement("div"); item.className = "catalog-row"; item.textContent = `${plugin.type} · ${plugin.name} · ${plugin.description || "无描述"}`; return item; }));
+        if (!(result.plugins ?? []).length)
+            catalogNode.textContent = "未找到已声明类型的 npm 插件";
+    }
     async function request(path, method = "GET", body) {
         const response = await fetch(path, { method, headers: {
                 accept: "application/json", ...(body ? { "content-type": "application/json" } : {}),
@@ -96,7 +111,13 @@
     function renderPlugins(items) {
         plugins = items;
         const selected = picker.value || items[0]?.id;
-        picker.replaceChildren(...items.map((plugin) => new Option(`${plugin.displayName || plugin.id} · v${plugin.version} · ${plugin.status}`, plugin.id)));
+        const groups = [["Agent", items.filter((plugin) => plugin.type === "agent" || (!plugin.type && plugin.capabilities?.includes("chat")))], ["Channel", items.filter((plugin) => plugin.type === "channel" || plugin.capabilities?.includes("channel"))], ["管理", items.filter((plugin) => plugin.type === "management" || (!plugin.type && plugin.capabilities?.includes("management")))]];
+        picker.replaceChildren(...groups.flatMap(([label, group]) => {
+            const options = document.createElement("optgroup");
+            options.label = label;
+            options.append(...group.map((plugin) => new Option(`${plugin.displayName || plugin.id} · v${plugin.version} · ${plugin.status}`, plugin.id)));
+            return group.length ? [options] : [];
+        }));
         picker.value = items.some((plugin) => plugin.id === selected) ? selected : items[0]?.id ?? "";
         pluginsNode.replaceChildren();
         for (const plugin of items.filter((item) => item.id === picker.value)) {
@@ -188,11 +209,20 @@
             return load();
         }).catch((cause) => error(String(cause)));
     };
-    node("#install-form").onsubmit = (event) => {
-        event.preventDefault();
+    node("#install-package").onclick = () => {
+        if (!packageNode.value)
+            return error("请先选择插件");
         void request("/api/plugins/install", "POST", { packageName: packageNode.value })
             .then(() => load()).catch((cause) => error(String(cause)));
     };
+    node("#install-name-form").onsubmit = (event) => {
+        event.preventDefault();
+        const packageName = node("#manual-package-name").value.trim();
+        void request("/api/plugins/install", "POST", { packageName }).then(() => load()).catch((cause) => error(String(cause)));
+    };
+    node("#search-packages").onclick = () => void loadCatalog().catch((cause) => error(String(cause)));
+    packageSearchNode.onkeydown = (event) => { if (event.key === "Enter")
+        void loadCatalog().catch((cause) => error(String(cause))); };
     node("#install-local-form").onsubmit = (event) => {
         event.preventDefault();
         void request("/api/plugins/install", "POST", { source: pluginPathNode.value.trim() })
@@ -210,4 +240,5 @@
         }).catch((cause) => { result.textContent = ""; error(String(cause)); });
     };
     void load();
+    void loadCatalog().catch((cause) => error(String(cause)));
 })();

package/dist/src-ts/plugins/abweb/public/index.html

@@ -13,7 +13,7 @@
     <nav class="tabs" role="tablist" aria-label="管理视图"><button id="settings-tab" type="button" role="tab" aria-selected="true" aria-controls="settings-panel">插件设置</button><button id="messages-tab" type="button" role="tab" aria-selected="false" aria-controls="messages-panel">通信记录</button></nav>
     <div id="settings-panel" role="tabpanel" aria-labelledby="settings-tab">
     <section><div class="section-heading"><h2>版本管理</h2><button id="check-versions" type="button">检查更新</button></div><div id="versions" class="muted"></div></section>
-    <section><div class="section-heading"><h2>插件</h2><select id="plugin-picker" aria-label="选择插件"></select></div><div id="plugins" class="plugins"></div><form id="install-form"><select id="package-name" aria-label="选择 npm 插件"><option value="agent-bridge-qwenwork">千问办公</option><option value="agent-bridge-abweb">管理页面</option><option value="agent-bridge-dsh">DeepSeek Harness</option><option value="agent-bridge-doubao">豆包</option></select><button type="submit">安装 npm 插件</button></form><form id="install-local-form"><input id="plugin-path" required placeholder="Windows 上的插件目录路径" aria-label="本地插件目录"><button type="submit">安装本地插件</button></form></section>
+    <section><div class="section-heading"><h2>插件</h2><select id="plugin-picker" aria-label="选择插件"></select></div><div id="plugins" class="plugins"></div><div class="plugin-catalog"><div class="section-heading"><h3>npm 插件目录</h3><button id="search-packages" type="button">刷新目录</button></div><input id="package-search" placeholder="搜索插件名称或功能" aria-label="搜索 npm 插件"><select id="package-name" aria-label="选择 npm 插件"></select><button id="install-package" type="button">安装选中插件</button><form id="install-name-form"><input id="manual-package-name" required pattern="agent-bridge-[a-z0-9-]+" placeholder="输入 npm 包名，例如 agent-bridge-workbuddy" aria-label="直接输入 npm 包名"><button type="submit">按包名安装</button></form><div id="catalog" class="catalog"></div></div><form id="install-local-form"><input id="plugin-path" required placeholder="Windows 上的插件目录路径" aria-label="本地插件目录"><button type="submit">安装本地插件</button></form></section>
     <section><div class="section-heading"><h2>已连接 AID</h2><span id="aid-count" class="muted"></span></div><div id="aids" class="aid-list"></div><form id="create-aid-form"><input id="new-aid" required placeholder="新 AID，例如 new.agentid.cn" aria-label="新 AID"><input id="owner-aid" required placeholder="owner AID" aria-label="owner AID"><button type="submit">创建 AID</button></form><p id="aid-result" class="muted" role="status"></p><p class="muted">在插件列表中选择插件，再用“关联 AID”下拉框保存对应身份。</p></section>
     </div>
     <div id="messages-panel" role="tabpanel" aria-labelledby="messages-tab" hidden><section><div class="section-heading"><h2>最近通信</h2></div><div class="table-scroll"><table><thead><tr><th scope="col">时间</th><th scope="col">插件</th><th scope="col">接收 AID</th><th scope="col">来源 Peer</th><th scope="col">方向</th><th scope="col">消息</th><th scope="col">错误</th></tr></thead><tbody id="messages"></tbody></table></div><p id="messages-empty" class="muted" hidden>暂无通信记录</p></section></div>

package/dist/src-ts/plugins/abweb/public/style.css

@@ -29,6 +29,12 @@ form { margin-top: 14px; flex-wrap: wrap; }
 .plugin-main { flex-wrap: wrap; }
 .controls { flex-wrap: wrap; }
 .controls select { max-width: 210px; }
+.plugin-catalog { border-top: 1px solid #e0e5e2; margin-top: 18px; padding-top: 14px; }
+.plugin-catalog h3 { font-size: 14px; margin: 0; }
+.plugin-catalog input { width: min(100%, 420px); margin: 10px 0; }
+.catalog { margin-top: 10px; }
+.catalog-row { padding: 7px 0; color: #566761; font-size: 13px; border-bottom: 1px solid #edf1ef; }
+.plugin-catalog form { margin-top: 8px; }
 .muted { color: #65736e; font-size: 13px; }
 .status { font-size: 12px; padding: 3px 7px; background: #e7ebea; border-radius: 4px; }
 .status-ready { color: #136a44; background: #def3e5; }

package/dist/src-ts/plugins/doubao/index.js

@@ -4,7 +4,7 @@ exports.DoubaoPlugin = exports.doubaoManifest = void 0;
 const cdp_client_1 = require("./cdp-client");
 exports.doubaoManifest = {
     id: "doubao",
-    version: "1.0.0",
+    version: "1.0.1",
     displayName: "豆包",
     entry: "dist/index.js",
     apiVersion: "1",

package/dist/src-ts/plugins/dsh/index.js

@@ -6,7 +6,7 @@ const dsh_agent_1 = require("../../dsh-agent");
 const openai_adapter_1 = require("../qwenwork/openai-adapter");
 exports.dshManifest = {
     id: "dsh",
-    version: "1.0.0",
+    version: "1.0.1",
     displayName: "DeepSeek Harness",
     entry: "dist/index.js",
     apiVersion: "1",

package/dist/src-ts/plugins/qwenwork/index.js

@@ -6,7 +6,7 @@ const openai_adapter_1 = require("./openai-adapter");
 const cdp_client_1 = require("./cdp-client");
 exports.qwenworkManifest = {
     id: "qwenwork",
-    version: "1.0.0",
+    version: "1.0.1",
     displayName: "千问办公",
     entry: "dist/index.js",
     apiVersion: "1",

package/dist/tests-ts/plugin-catalog.test.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importDefault(require("node:test"));
+const plugin_catalog_1 = require("../src-ts/plugin-catalog");
+const plugin_manifest_1 = require("../src-ts/plugin-manifest");
+(0, node_test_1.default)("远程目录只返回声明平台类型的插件包", async () => {
+    const get = async (url) => {
+        if (url.includes("/-/v1/search"))
+            return { objects: [
+                    { package: { name: "agent-bridge-workbuddy", version: "1.2.0", description: "办公 Agent" } },
+                    { package: { name: "agent-bridge-aun", version: "1.0.0", description: "AUN 通道" } },
+                    { package: { name: "agent-bridge-fake", version: "1.0.0" } },
+                ] };
+        const name = decodeURIComponent(url.split("/").pop());
+        return { "dist-tags": { latest: name === "agent-bridge-workbuddy" ? "1.2.0" : "1.0.0" }, versions: { [name === "agent-bridge-workbuddy" ? "1.2.0" : "1.0.0"]: { agentBridge: name === "agent-bridge-fake" ? undefined : { plugin: "./plugin.json", type: name === "agent-bridge-aun" ? "channel" : "agent" } } } };
+    };
+    strict_1.default.deepEqual((await (0, plugin_catalog_1.searchPluginCatalog)("", get)).map(({ name, type }) => [name, type]), [
+        ["agent-bridge-workbuddy", "agent"], ["agent-bridge-aun", "channel"],
+    ]);
+});
+(0, node_test_1.default)("插件清单类型从能力兼容识别，冲突类型拒绝", () => {
+    const base = { id: "sample", version: "1.0.0", entry: "index.js", apiVersion: "1", capabilities: ["chat"] };
+    strict_1.default.equal((0, plugin_manifest_1.validateManifest)(base).type, "agent");
+    strict_1.default.equal((0, plugin_manifest_1.validateManifest)({ ...base, capabilities: ["channel", "channel.receive", "channel.send"], type: "channel" }).type, "channel");
+    strict_1.default.throws(() => (0, plugin_manifest_1.validateManifest)({ ...base, type: "channel" }), /类型|type/);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mu-agent-bridge",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "将 AUN Agent 连接到本地桌面 AI 客户端的插件平台。",
   "main": "dist/src-ts/cli.js",
   "bin": { "mab": "dist/src-ts/cli.js", "agent-bridge": "dist/src-ts/cli.js" },

package/plugins/abweb/plugin.json

@@ -1,6 +1,7 @@
 {
   "id": "abweb",
-  "version": "1.0.0",
+  "version": "1.0.1",
+  "type": "management",
   "displayName": "Agent Bridge Web",
   "entry": "dist/index.js",
   "apiVersion": "1",
@@ -8,4 +9,3 @@
   "capabilities": ["web", "management", "health"],
   "configSchema": "config.schema.json"
 }
-

package/plugins/qwenwork/plugin.json

@@ -1,6 +1,7 @@
 {
   "id": "qwenwork",
-  "version": "1.0.0",
+  "version": "1.0.1",
+  "type": "agent",
   "displayName": "千问办公",
   "entry": "dist/index.js",
   "apiVersion": "1",