agent-bridge-abweb 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# abweb 管理插件
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+供 `mu-agent-bridge` 使用的网页管理插件。核心包已内置此插件；默认页面为 `http://127.0.0.1:26107/abweb/`。
+
+独立安装：`npm install -g agent-bridge-abweb`。

package/config.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "publicPath": {
+      "type": "string",
+      "description": "URL prefix used to serve the management UI",
+      "default": "/abweb",
+      "pattern": "^/[A-Za-z0-9._/-]*$"
+    },
+    "controlBaseUrl": {
+      "type": "string",
+      "description": "Local daemon control API base URL",
+      "default": "http://127.0.0.1:26107"
+    },
+    "token": {
+      "type": "string",
+      "description": "Bearer token for the daemon control API",
+      "writeOnly": true
+    }
+  }
+}

package/dist/src-ts/agent.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentError = void 0;
+class AgentError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AgentError";
+    }
+}
+exports.AgentError = AgentError;

package/dist/src-ts/plugins/abweb/control-client.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControlApiClient = exports.ControlApiError = void 0;
+class ControlApiError extends Error {
+    status;
+    payload;
+    constructor(message, status, payload) {
+        super(message);
+        this.name = "ControlApiError";
+        this.status = status;
+        this.payload = payload;
+    }
+}
+exports.ControlApiError = ControlApiError;
+/** Small fetch-based client used by abweb's server and browser-facing handlers. */
+class ControlApiClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    constructor(baseUrl, token, fetchImpl = fetch) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.token = token;
+        this.fetchImpl = fetchImpl;
+    }
+    listPlugins() {
+        return this.request("/api/plugins");
+    }
+    getHealth() {
+        return this.request("/api/health");
+    }
+    startPlugin(id) {
+        return this.mutate(`/api/plugins/${encodeURIComponent(id)}/start`);
+    }
+    stopPlugin(id) {
+        return this.mutate(`/api/plugins/${encodeURIComponent(id)}/stop`);
+    }
+    reloadPlugin(id) {
+        return this.mutate(`/api/plugins/${encodeURIComponent(id)}/reload`);
+    }
+    uninstallPlugin(id) {
+        return this.request(`/api/plugins/${encodeURIComponent(id)}`, { method: "DELETE" });
+    }
+    installPlugin(source) {
+        return this.mutate("/api/plugins/install", { source });
+    }
+    getConfig(id) {
+        return this.request(`/api/plugins/${encodeURIComponent(id)}/config`);
+    }
+    updateConfig(id, config) {
+        return this.request(`/api/plugins/${encodeURIComponent(id)}/config`, {
+            method: "PATCH",
+            body: JSON.stringify(config),
+        });
+    }
+    getLogs(id, limit = 100) {
+        return this.request(`/api/plugins/${encodeURIComponent(id)}/logs?limit=${Math.max(1, Math.min(500, limit))}`);
+    }
+    mutate(path, payload) {
+        return this.request(path, {
+            method: "POST",
+            body: payload === undefined ? undefined : JSON.stringify(payload),
+        });
+    }
+    async request(path, options = {}) {
+        const headers = new Headers(options.headers);
+        headers.set("accept", "application/json");
+        if (options.body !== undefined)
+            headers.set("content-type", "application/json");
+        if (this.token)
+            headers.set("authorization", `Bearer ${this.token}`);
+        const response = await this.fetchImpl(`${this.baseUrl}${path}`, { ...options, headers });
+        const text = await response.text();
+        let payload = undefined;
+        if (text) {
+            try {
+                payload = JSON.parse(text);
+            }
+            catch {
+                payload = text;
+            }
+        }
+        if (!response.ok) {
+            const message = typeof payload === "object" && payload !== null && "error" in payload
+                ? String(payload.error)
+                : `control API request failed (${response.status})`;
+            throw new ControlApiError(message, response.status, payload);
+        }
+        return payload;
+    }
+}
+exports.ControlApiClient = ControlApiClient;

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

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbwebPlugin = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const MANIFEST = {
+    id: "abweb",
+    version: "1.0.1",
+    displayName: "Agent Bridge Web",
+    entry: "dist/index.js",
+    apiVersion: "1",
+    process: "in-process",
+    capabilities: ["web", "management", "health"],
+    configSchema: "config.schema.json",
+};
+const DEFAULT_PUBLIC_PATH = "/abweb";
+const ASSET_NAMES = {
+    "": { file: "index.html", contentType: "text/html; charset=utf-8" },
+    "/": { file: "index.html", contentType: "text/html; charset=utf-8" },
+    "/index.html": { file: "index.html", contentType: "text/html; charset=utf-8" },
+    "/app.js": { file: "app.js", contentType: "text/javascript; charset=utf-8" },
+    "/app.ts": { file: "app.ts", contentType: "text/javascript; charset=utf-8" },
+    "/style.css": { file: "style.css", contentType: "text/css; charset=utf-8" },
+};
+class AbwebPlugin {
+    manifest = MANIFEST;
+    context;
+    publicPath = DEFAULT_PUBLIC_PATH;
+    unregister = [];
+    status = "stopped";
+    async activate(context) {
+        if (this.status === "ready")
+            return;
+        this.status = "starting";
+        this.context = context;
+        this.publicPath = normalizePublicPath(context.config.publicPath);
+        try {
+            const register = context.http.registerRoute ?? context.http.register;
+            if (!register)
+                throw new Error("abweb requires a plugin HTTP route registry");
+            for (const suffix of Object.keys(ASSET_NAMES)) {
+                this.addRoute(register, `${this.publicPath}${suffix}`);
+            }
+            this.status = "ready";
+            context.logger?.info?.("abweb management UI activated", { publicPath: this.publicPath });
+        }
+        catch (error) {
+            this.unregisterAll();
+            this.context = undefined;
+            this.status = "failed";
+            throw error;
+        }
+    }
+    async deactivate(reason) {
+        this.unregisterAll();
+        this.context?.logger?.info?.("abweb management UI deactivated", { reason });
+        this.context = undefined;
+        this.status = "stopped";
+    }
+    async health() {
+        return {
+            status: this.status,
+            message: this.status === "ready" ? undefined : "abweb management UI is not active",
+            details: { routeCount: this.unregister.length, publicPath: this.publicPath },
+        };
+    }
+    /** Abweb is a management plugin and intentionally does not handle model requests. */
+    async handle() {
+        throw new Error("abweb does not handle agent requests");
+    }
+    addRoute(register, path) {
+        const cleanup = register.call(this.context?.http, path, (request) => this.serve(request));
+        if (typeof cleanup === "function")
+            this.unregister.push(cleanup);
+        else
+            this.unregister.push(() => undefined);
+    }
+    unregisterAll() {
+        for (const unregister of this.unregister.splice(0)) {
+            try {
+                unregister();
+            }
+            catch { /* cleanup is best effort */ }
+        }
+    }
+    serve(request) {
+        if ((request.method ?? "GET").toUpperCase() !== "GET")
+            return response(405, "method not allowed", "text/plain; charset=utf-8");
+        const rawPath = request.path ?? this.publicPath;
+        const pathWithoutQuery = rawPath.split("?", 1)[0];
+        const suffix = pathWithoutQuery === this.publicPath ? "" : pathWithoutQuery.startsWith(`${this.publicPath}/`)
+            ? pathWithoutQuery.slice(this.publicPath.length) : "__unknown__";
+        const asset = ASSET_NAMES[suffix];
+        if (!asset)
+            return response(404, "not found", "text/plain; charset=utf-8");
+        try {
+            const body = readAsset(asset.file);
+            return response(200, body, asset.contentType);
+        }
+        catch (error) {
+            this.context?.logger?.error?.("abweb static asset unavailable", { asset: asset.file, error: String(error) });
+            return response(503, "asset unavailable", "text/plain; charset=utf-8");
+        }
+    }
+}
+exports.AbwebPlugin = AbwebPlugin;
+function normalizePublicPath(value) {
+    if (typeof value !== "string" || !value.trim())
+        return DEFAULT_PUBLIC_PATH;
+    const normalized = value.trim().replace(/\\/g, "/").replace(/\/+$/, "");
+    if (!normalized.startsWith("/") || normalized.includes("..") || /[^a-zA-Z0-9._/-]/.test(normalized))
+        return DEFAULT_PUBLIC_PATH;
+    return normalized || DEFAULT_PUBLIC_PATH;
+}
+function readAsset(file) {
+    const candidates = [
+        (0, node_path_1.join)(__dirname, "public", file),
+        (0, node_path_1.join)(process.cwd(), "src-ts", "plugins", "abweb", "public", file),
+        (0, node_path_1.join)(process.cwd(), "plugins", "abweb", "public", file),
+    ];
+    for (const candidate of candidates) {
+        try {
+            return (0, node_fs_1.readFileSync)(candidate, "utf8");
+        }
+        catch { /* try next location */ }
+    }
+    throw new Error(`asset not found: ${file}`);
+}
+function response(status, body, contentType) {
+    return { status, body, headers: { "content-type": contentType, "cache-control": "no-store" } };
+}
+exports.default = AbwebPlugin;

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

@@ -0,0 +1,244 @@
+(() => {
+    const node = (selector) => document.querySelector(selector);
+    const pluginsNode = node("#plugins");
+    const messagesNode = node("#messages");
+    const messagesEmpty = node("#messages-empty");
+    const errorNode = node("#error");
+    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");
+    const versionsNode = node("#versions");
+    tokenNode.value = sessionStorage.getItem("mab-token") ?? "";
+    let aids = [];
+    let plugins = [];
+    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" } : {}),
+                ...(tokenNode.value ? { authorization: `Bearer ${tokenNode.value}` } : {}),
+            }, ...(body ? { body: JSON.stringify(body) } : {}) });
+        const data = await response.json();
+        if (!response.ok)
+            throw new Error(data.error ?? `请求失败：${response.status}`);
+        return data;
+    }
+    function button(label, title, run) {
+        const item = document.createElement("button");
+        item.type = "button";
+        item.textContent = label;
+        item.title = title;
+        item.onclick = () => { void run().catch((cause) => error(String(cause))); };
+        return item;
+    }
+    async function load() {
+        try {
+            error("");
+            const [health, plugins, identities, messages, versions] = await Promise.all([
+                request("/api/health"), request("/api/plugins"), request("/api/aids"), request("/api/messages"), request("/api/versions"),
+            ]);
+            renderVersions(versions);
+            pluginVersions = Object.fromEntries((versions.plugins ?? []).map((plugin) => [plugin.id, plugin.versionStatus]));
+            node("#health").textContent = `服务运行中 · ${health.plugins} 个插件`;
+            node("#access-panel").hidden = true;
+            aids = identities.aids ?? [];
+            const installed = plugins.plugins ?? [];
+            pluginConfigs = Object.fromEntries(await Promise.all(installed.map(async (plugin) => [plugin.id, await request(`/api/plugins/${encodeURIComponent(plugin.id)}/config`)])));
+            renderPlugins(installed);
+            const groups = identities.groups ?? { evolcore: aids, muAgentBridge: [] };
+            aidList.replaceChildren(...[["EvolCore", groups.evolcore], ["mu-agent-bridge", groups.muAgentBridge]].flatMap(([label, values]) => {
+                const title = document.createElement("strong");
+                title.textContent = String(label);
+                const items = values.map((aid) => {
+                    const item = document.createElement("div");
+                    item.className = "aid-row";
+                    const name = document.createElement("span");
+                    name.textContent = aid;
+                    const linked = installed.filter((plugin) => pluginConfigs[plugin.id]?.aid === aid).map((plugin) => plugin.displayName || plugin.id);
+                    const current = document.createElement("small");
+                    current.className = "muted";
+                    current.textContent = linked.length ? `已关联：${linked.join("、")}` : "未关联插件";
+                    const select = document.createElement("select");
+                    select.setAttribute("aria-label", `${aid} 关联插件`);
+                    select.append(new Option("关联插件", ""), ...installed.filter((plugin) => plugin.id !== "abweb").map((plugin) => new Option(plugin.displayName || plugin.id, plugin.id)));
+                    select.onchange = () => { if (select.value)
+                        void request(`/api/plugins/${encodeURIComponent(select.value)}/aid`, "PATCH", { aid }).then(() => load()).catch((cause) => error(String(cause))); };
+                    item.append(name, current, select);
+                    return item;
+                });
+                return [title, ...items];
+            }));
+            if (!aids.length)
+                aidList.textContent = "当前没有已连接的 AID";
+            node("#aid-count").textContent = `${aids.length} 个`;
+            renderMessages(messages.messages ?? []);
+        }
+        catch (cause) {
+            node("#access-panel").hidden = false;
+            error(cause instanceof Error ? cause.message : String(cause));
+        }
+    }
+    function renderVersions(data) {
+        const entries = [data.core, ...(data.plugins ?? []).map((plugin) => plugin.versionStatus)].filter(Boolean);
+        versionsNode.replaceChildren(...entries.map((entry) => {
+            const row = document.createElement("div");
+            row.className = "version-row";
+            row.textContent = `${entry.packageName} · 当前 ${entry.currentVersion} · ${entry.latestVersion ? `最新 ${entry.latestVersion}` : "最新版本未知"} · ${entry.state}${entry.error ? ` · ${entry.error}` : ""}`;
+            return row;
+        }));
+        if (!entries.length)
+            versionsNode.textContent = "尚未检查版本";
+    }
+    function renderPlugins(items) {
+        plugins = items;
+        const selected = picker.value || items[0]?.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)) {
+            const item = document.createElement("article");
+            item.className = "plugin-row";
+            const main = document.createElement("div");
+            main.className = "plugin-main";
+            const name = document.createElement("strong");
+            name.textContent = plugin.displayName || plugin.id;
+            const meta = document.createElement("span");
+            meta.className = "muted";
+            meta.textContent = `${plugin.id} · 当前版本 v${plugin.version}`;
+            const status = document.createElement("span");
+            status.className = `status status-${plugin.status}`;
+            status.textContent = plugin.status;
+            main.append(name, meta, status);
+            if (plugin.error) {
+                const detail = document.createElement("small");
+                detail.className = "error-text";
+                detail.textContent = plugin.error;
+                main.append(detail);
+            }
+            const controls = document.createElement("div");
+            controls.className = "controls";
+            if (pluginVersions[plugin.id]?.state === "update-available" && plugin.path.includes("node_modules"))
+                controlsUpgrade(plugin.id);
+            const select = document.createElement("select");
+            select.setAttribute("aria-label", `${plugin.id} 的 AID`);
+            select.append(new Option("不绑定 AID", ""), ...aids.map((aid) => new Option(aid, aid)));
+            select.value = pluginConfigs[plugin.id]?.aid ?? "";
+            if (plugin.id !== "abweb")
+                controls.append(select, button("关联 AID", "保存此插件使用的 AID", async () => {
+                    await request(`/api/plugins/${encodeURIComponent(plugin.id)}/aid`, "PATCH", { aid: select.value });
+                    await load();
+                }));
+            for (const [label, action] of [["启动", "start"], ["停止", "stop"], ["重载", "reload"]]) {
+                controls.append(button(label, `${label} ${plugin.id}`, async () => { await request(`/api/plugins/${encodeURIComponent(plugin.id)}/${action}`, "POST"); await load(); }));
+            }
+            if (plugin.path.includes(".agent-bridge") && plugin.path.includes("node_modules"))
+                controls.append(button("卸载", `卸载 ${plugin.id}`, async () => {
+                    if (confirm(`卸载 ${plugin.displayName}？`)) {
+                        await request(`/api/plugins/${encodeURIComponent(plugin.id)}`, "DELETE");
+                        await load();
+                    }
+                }));
+            item.append(main, controls);
+            pluginsNode.append(item);
+            function controlsUpgrade(id) { controls.append(button("升级", `升级 ${id}`, async () => { await request(`/api/plugins/${encodeURIComponent(id)}/update`, "POST", {}); await load(); })); }
+        }
+        if (!items.length)
+            pluginsNode.textContent = "暂无插件";
+    }
+    function renderMessages(messages) {
+        messagesNode.replaceChildren();
+        messagesEmpty.hidden = messages.length > 0;
+        for (const message of messages) {
+            const row = document.createElement("tr");
+            if (message.direction === "error")
+                row.className = "message-error";
+            for (const value of [new Date(message.time).toLocaleString(), message.pluginId, message.agentAid || "未提供", message.peer || "未提供", { request: "请求", reply: "回复", error: "错误" }[message.direction], message.direction === "error" ? "—" : message.text, message.direction === "error" ? message.text : "—"]) {
+                const cell = document.createElement("td");
+                cell.textContent = value;
+                row.append(cell);
+            }
+            messagesNode.append(row);
+        }
+    }
+    for (const [tabId, panelId] of [["settings-tab", "settings-panel"], ["messages-tab", "messages-panel"]]) {
+        node(`#${tabId}`).onclick = () => {
+            for (const [otherTab, otherPanel] of [["settings-tab", "settings-panel"], ["messages-tab", "messages-panel"]]) {
+                const selected = otherTab === tabId;
+                node(`#${otherTab}`).setAttribute("aria-selected", String(selected));
+                node(`#${otherPanel}`).hidden = !selected;
+            }
+        };
+    }
+    node("#refresh").onclick = () => void load();
+    node("#check-versions").onclick = () => void request("/api/versions/check", "POST", {}).then(load).catch((cause) => error(String(cause)));
+    picker.onchange = () => renderPlugins(plugins);
+    node("#save-token").onclick = () => { sessionStorage.setItem("mab-token", tokenNode.value); void load(); };
+    node("#pair-button").onclick = () => {
+        const code = pairCodeNode.value.trim();
+        if (!/^\d{6}$/.test(code))
+            return error("请输入 6 位配置码");
+        void request("/api/pair", "POST", { code }).then((result) => {
+            tokenNode.value = result.token;
+            sessionStorage.setItem("mab-token", result.token);
+            pairCodeNode.value = "";
+            return load();
+        }).catch((cause) => error(String(cause)));
+    };
+    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() })
+            .then(() => { pluginPathNode.value = ""; return load(); }).catch((cause) => error(String(cause)));
+    };
+    node("#create-aid-form").onsubmit = (event) => {
+        event.preventDefault();
+        const aid = node("#new-aid").value.trim();
+        const ownerAid = node("#owner-aid").value.trim();
+        const result = node("#aid-result");
+        result.textContent = "正在创建 AID…";
+        void request("/api/aids", "POST", { aid, ownerAid }).then(() => {
+            result.textContent = `${aid} 已创建；连接到 AUN 后会出现在上方列表。`;
+            return load();
+        }).catch((cause) => { result.textContent = ""; error(String(cause)); });
+    };
+    void load();
+    void loadCatalog().catch((cause) => error(String(cause)));
+})();

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

@@ -0,0 +1,190 @@
+(() => {
+  type Plugin = { id: string; displayName: string; version: string; status: string; type?: string; capabilities?: string[]; error?: string; path: string };
+  const node = <T extends HTMLElement>(selector: string): T => document.querySelector<T>(selector)!;
+  const pluginsNode = node<HTMLDivElement>("#plugins");
+  const messagesNode = node<HTMLTableSectionElement>("#messages");
+  const messagesEmpty = node<HTMLParagraphElement>("#messages-empty");
+  const errorNode = node<HTMLParagraphElement>("#error");
+  const tokenNode = node<HTMLInputElement>("#token");
+  const pairCodeNode = node<HTMLInputElement>("#pair-code");
+  const packageNode = node<HTMLSelectElement>("#package-name");
+  const packageSearchNode = node<HTMLInputElement>("#package-search");
+  const catalogNode = node<HTMLDivElement>("#catalog");
+  const pluginPathNode = node<HTMLInputElement>("#plugin-path");
+  const picker = node<HTMLSelectElement>("#plugin-picker");
+  const aidList = node<HTMLDivElement>("#aids");
+  const versionsNode = node<HTMLDivElement>("#versions");
+  tokenNode.value = sessionStorage.getItem("mab-token") ?? "";
+  let aids: string[] = [];
+  let plugins: Plugin[] = [];
+  let pluginConfigs: Record<string, { aid?: string }> = {};
+  let pluginVersions: Record<string, any> = {};
+
+  function error(message: string): void { errorNode.textContent = message; errorNode.hidden = !message; }
+  async function loadCatalog(): Promise<void> {
+    const result = await request(`/api/plugins/catalog?q=${encodeURIComponent(packageSearchNode.value.trim())}`);
+    const items: Array<{ name: string; version: string; description: string; type: string }> = 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: string, method = "GET", body?: unknown): Promise<any> {
+    const response = await fetch(path, { method, headers: {
+      accept: "application/json", ...(body ? { "content-type": "application/json" } : {}),
+      ...(tokenNode.value ? { authorization: `Bearer ${tokenNode.value}` } : {}),
+    }, ...(body ? { body: JSON.stringify(body) } : {}) });
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error ?? `请求失败：${response.status}`);
+    return data;
+  }
+  function button(label: string, title: string, run: () => Promise<void>): HTMLButtonElement {
+    const item = document.createElement("button"); item.type = "button"; item.textContent = label; item.title = title;
+    item.onclick = () => { void run().catch((cause) => error(String(cause))); }; return item;
+  }
+  async function load(): Promise<void> {
+    try {
+      error("");
+      const [health, plugins, identities, messages, versions] = await Promise.all([
+        request("/api/health"), request("/api/plugins"), request("/api/aids"), request("/api/messages"), request("/api/versions"),
+      ]);
+      renderVersions(versions);
+      pluginVersions = Object.fromEntries((versions.plugins ?? []).map((plugin: any) => [plugin.id, plugin.versionStatus]));
+      node<HTMLElement>("#health").textContent = `服务运行中 · ${health.plugins} 个插件`;
+      node<HTMLElement>("#access-panel").hidden = true;
+      aids = identities.aids ?? [];
+      const installed: Plugin[] = plugins.plugins ?? [];
+      pluginConfigs = Object.fromEntries(await Promise.all(installed.map(async (plugin) => [plugin.id, await request(`/api/plugins/${encodeURIComponent(plugin.id)}/config`)] as const)));
+      renderPlugins(installed);
+      const groups = identities.groups ?? { evolcore: aids, muAgentBridge: [] };
+      aidList.replaceChildren(...[ ["EvolCore", groups.evolcore], ["mu-agent-bridge", groups.muAgentBridge] ].flatMap(([label, values]) => {
+        const title = document.createElement("strong"); title.textContent = String(label);
+        const items = (values as string[]).map((aid) => {
+          const item = document.createElement("div"); item.className = "aid-row";
+          const name = document.createElement("span"); name.textContent = aid;
+          const linked = installed.filter((plugin) => pluginConfigs[plugin.id]?.aid === aid).map((plugin) => plugin.displayName || plugin.id);
+          const current = document.createElement("small"); current.className = "muted"; current.textContent = linked.length ? `已关联：${linked.join("、")}` : "未关联插件";
+          const select = document.createElement("select"); select.setAttribute("aria-label", `${aid} 关联插件`);
+          select.append(new Option("关联插件", ""), ...installed.filter((plugin) => plugin.id !== "abweb").map((plugin) => new Option(plugin.displayName || plugin.id, plugin.id)));
+          select.onchange = () => { if (select.value) void request(`/api/plugins/${encodeURIComponent(select.value)}/aid`, "PATCH", { aid }).then(() => load()).catch((cause) => error(String(cause))); };
+          item.append(name, current, select); return item;
+        });
+        return [title, ...items];
+      }));
+      if (!aids.length) aidList.textContent = "当前没有已连接的 AID";
+      node<HTMLElement>("#aid-count").textContent = `${aids.length} 个`;
+      renderMessages(messages.messages ?? []);
+    } catch (cause) { node<HTMLElement>("#access-panel").hidden = false; error(cause instanceof Error ? cause.message : String(cause)); }
+  }
+  function renderVersions(data: any): void {
+    const entries = [data.core, ...(data.plugins ?? []).map((plugin: any) => plugin.versionStatus)].filter(Boolean);
+    versionsNode.replaceChildren(...entries.map((entry: any) => {
+      const row = document.createElement("div"); row.className = "version-row";
+      row.textContent = `${entry.packageName} · 当前 ${entry.currentVersion} · ${entry.latestVersion ? `最新 ${entry.latestVersion}` : "最新版本未知"} · ${entry.state}${entry.error ? ` · ${entry.error}` : ""}`;
+      return row;
+    }));
+    if (!entries.length) versionsNode.textContent = "尚未检查版本";
+  }
+  function renderPlugins(items: Plugin[]): void {
+    plugins = items;
+    const selected = picker.value || items[0]?.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")))]] as const;
+    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)) {
+      const item = document.createElement("article"); item.className = "plugin-row";
+      const main = document.createElement("div"); main.className = "plugin-main";
+      const name = document.createElement("strong"); name.textContent = plugin.displayName || plugin.id;
+      const meta = document.createElement("span"); meta.className = "muted"; meta.textContent = `${plugin.id} · 当前版本 v${plugin.version}`;
+      const status = document.createElement("span"); status.className = `status status-${plugin.status}`; status.textContent = plugin.status;
+      main.append(name, meta, status);
+      if (plugin.error) { const detail = document.createElement("small"); detail.className = "error-text"; detail.textContent = plugin.error; main.append(detail); }
+      const controls = document.createElement("div"); controls.className = "controls";
+      if (pluginVersions[plugin.id]?.state === "update-available" && plugin.path.includes("node_modules")) controlsUpgrade(plugin.id);
+      const select = document.createElement("select"); select.setAttribute("aria-label", `${plugin.id} 的 AID`);
+      select.append(new Option("不绑定 AID", ""), ...aids.map((aid) => new Option(aid, aid)));
+      select.value = pluginConfigs[plugin.id]?.aid ?? "";
+      if (plugin.id !== "abweb") controls.append(select, button("关联 AID", "保存此插件使用的 AID", async () => {
+        await request(`/api/plugins/${encodeURIComponent(plugin.id)}/aid`, "PATCH", { aid: select.value }); await load();
+      }));
+      for (const [label, action] of [["启动", "start"], ["停止", "stop"], ["重载", "reload"]]) {
+        controls.append(button(label, `${label} ${plugin.id}`, async () => { await request(`/api/plugins/${encodeURIComponent(plugin.id)}/${action}`, "POST"); await load(); }));
+      }
+      if (plugin.path.includes(".agent-bridge") && plugin.path.includes("node_modules")) controls.append(button("卸载", `卸载 ${plugin.id}`, async () => {
+        if (confirm(`卸载 ${plugin.displayName}？`)) { await request(`/api/plugins/${encodeURIComponent(plugin.id)}`, "DELETE"); await load(); }
+      }));
+      item.append(main, controls); pluginsNode.append(item);
+      function controlsUpgrade(id: string): void { controls.append(button("升级", `升级 ${id}`, async () => { await request(`/api/plugins/${encodeURIComponent(id)}/update`, "POST", {}); await load(); })); }
+    }
+    if (!items.length) pluginsNode.textContent = "暂无插件";
+  }
+  function renderMessages(messages: Array<{ time: string; pluginId: string; direction: "request" | "reply" | "error"; text: string; peer?: string; agentAid?: string }>): void {
+    messagesNode.replaceChildren();
+    messagesEmpty.hidden = messages.length > 0;
+    for (const message of messages) {
+      const row = document.createElement("tr");
+      if (message.direction === "error") row.className = "message-error";
+      for (const value of [new Date(message.time).toLocaleString(), message.pluginId, message.agentAid || "未提供", message.peer || "未提供", { request: "请求", reply: "回复", error: "错误" }[message.direction], message.direction === "error" ? "—" : message.text, message.direction === "error" ? message.text : "—"]) {
+        const cell = document.createElement("td"); cell.textContent = value; row.append(cell);
+      }
+      messagesNode.append(row);
+    }
+  }
+  for (const [tabId, panelId] of [["settings-tab", "settings-panel"], ["messages-tab", "messages-panel"]]) {
+    node<HTMLButtonElement>(`#${tabId}`).onclick = () => {
+      for (const [otherTab, otherPanel] of [["settings-tab", "settings-panel"], ["messages-tab", "messages-panel"]]) {
+        const selected = otherTab === tabId;
+        node<HTMLButtonElement>(`#${otherTab}`).setAttribute("aria-selected", String(selected));
+        node<HTMLDivElement>(`#${otherPanel}`).hidden = !selected;
+      }
+    };
+  }
+  node<HTMLButtonElement>("#refresh").onclick = () => void load();
+  node<HTMLButtonElement>("#check-versions").onclick = () => void request("/api/versions/check", "POST", {}).then(load).catch((cause) => error(String(cause)));
+  picker.onchange = () => renderPlugins(plugins);
+  node<HTMLButtonElement>("#save-token").onclick = () => { sessionStorage.setItem("mab-token", tokenNode.value); void load(); };
+  node<HTMLButtonElement>("#pair-button").onclick = () => {
+    const code = pairCodeNode.value.trim();
+    if (!/^\d{6}$/.test(code)) return error("请输入 6 位配置码");
+    void request("/api/pair", "POST", { code }).then((result) => {
+      tokenNode.value = result.token; sessionStorage.setItem("mab-token", result.token); pairCodeNode.value = ""; return load();
+    }).catch((cause) => error(String(cause)));
+  };
+  node<HTMLButtonElement>("#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<HTMLFormElement>("#install-name-form").onsubmit = (event) => {
+    event.preventDefault();
+    const packageName = node<HTMLInputElement>("#manual-package-name").value.trim();
+    void request("/api/plugins/install", "POST", { packageName }).then(() => load()).catch((cause) => error(String(cause)));
+  };
+  node<HTMLButtonElement>("#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<HTMLFormElement>("#install-local-form").onsubmit = (event) => {
+    event.preventDefault();
+    void request("/api/plugins/install", "POST", { source: pluginPathNode.value.trim() })
+      .then(() => { pluginPathNode.value = ""; return load(); }).catch((cause) => error(String(cause)));
+  };
+  node<HTMLFormElement>("#create-aid-form").onsubmit = (event) => {
+    event.preventDefault();
+    const aid = node<HTMLInputElement>("#new-aid").value.trim();
+    const ownerAid = node<HTMLInputElement>("#owner-aid").value.trim();
+    const result = node<HTMLElement>("#aid-result");
+    result.textContent = "正在创建 AID…";
+    void request("/api/aids", "POST", { aid, ownerAid }).then(() => {
+      result.textContent = `${aid} 已创建；连接到 AUN 后会出现在上方列表。`;
+      return load();
+    }).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

@@ -0,0 +1,24 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>mab 管理</title>
+  <link rel="stylesheet" href="/abweb/style.css">
+</head>
+<body>
+  <main class="shell">
+    <header><div><h1>mab 管理</h1><p id="health" class="muted">连接中</p></div><button id="refresh" type="button">刷新</button></header>
+    <section id="access-panel" class="access" hidden><label for="pair-code">配置码</label><input id="pair-code" inputmode="numeric" maxlength="6" pattern="[0-9]{6}" autocomplete="one-time-code" placeholder="运行 mab pair 获取"><button id="pair-button" type="button">配对</button><label for="token">访问令牌</label><input id="token" type="password" autocomplete="off" placeholder="已有令牌时可直接填写"><button id="save-token" type="button">连接</button></section>
+    <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><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>
+    <p id="error" class="error" role="alert" hidden></p>
+  </main>
+  <script src="/abweb/app.js"></script>
+</body>
+</html>

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

@@ -0,0 +1,49 @@
+:root { font-family: "Segoe UI", "Microsoft YaHei", sans-serif; color: #182027; background: #f4f6f5; }
+* { box-sizing: border-box; }
+body { margin: 0; }
+.shell { max-width: 1100px; margin: 0 auto; padding: 24px; }
+header, .section-heading, .access, .plugin-row, .plugin-main, .controls { display: flex; align-items: center; gap: 12px; }
+header, .section-heading { justify-content: space-between; }
+.tabs { display: flex; gap: 20px; border-bottom: 1px solid #cbd5d0; margin-top: 22px; }
+.tabs button { border: 0; border-bottom: 2px solid transparent; border-radius: 0; background: transparent; padding: 8px 2px; }
+.tabs button[aria-selected="true"] { color: #136a44; border-bottom-color: #136a44; font-weight: 600; }
+[hidden] { display: none !important; }
+h1 { font-size: 25px; margin: 0; }
+h2 { font-size: 17px; margin: 0; }
+p { margin: 5px 0; }
+section { border-top: 1px solid #d9dfdc; padding: 18px 0; }
+.access { flex-wrap: wrap; }
+.access input { min-width: 220px; }
+input, select, button { min-height: 34px; padding: 6px 9px; border: 1px solid #bfc9c5; border-radius: 5px; background: white; color: inherit; font: inherit; }
+button { cursor: pointer; white-space: nowrap; }
+button:hover { background: #e5f2ea; }
+form { display: flex; gap: 8px; }
+form { margin-top: 14px; flex-wrap: wrap; }
+.aid-list { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 12px; }
+.aid-list span { padding: 5px 8px; border: 1px solid #d9dfdc; border-radius: 4px; background: #fff; font-size: 13px; }
+.aid-list strong { flex-basis: 100%; font-size: 13px; margin-top: 8px; }
+.aid-row { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; flex-basis: 100%; }
+.aid-row span { min-width: 210px; }
+.plugins, .messages { margin-top: 13px; }
+.plugin-row { justify-content: space-between; border-bottom: 1px solid #e0e5e2; padding: 12px 0; 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; }
+.status-failed { color: #a83427; background: #fce9e5; }
+.error, .error-text { color: #a83427; }
+.table-scroll { overflow-x: auto; margin-top: 13px; }
+table { width: 100%; border-collapse: collapse; table-layout: fixed; min-width: 900px; font-size: 13px; }
+th, td { padding: 10px 9px; text-align: left; vertical-align: top; border-bottom: 1px solid #dce3df; overflow-wrap: anywhere; white-space: pre-wrap; }
+th { color: #566761; font-weight: 600; background: #edf1ef; }
+th:nth-child(1) { width: 145px; } th:nth-child(2) { width: 100px; } th:nth-child(3), th:nth-child(4) { width: 145px; } th:nth-child(5) { width: 62px; } th:nth-child(7) { width: 140px; }
+.message-error td:last-child { color: #a83427; }
+@media (max-width: 620px) { .shell { padding: 16px; } .section-heading { align-items: flex-start; flex-direction: column; } form, form input { width: 100%; } .controls select { max-width: 100%; } }

package/package.json

@@ -1,6 +1,25 @@
 {
   "name": "agent-bridge-abweb",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "agent-bridge 的网页管理插件。",
+  "keywords": ["mu-agent-bridge-plugin", "mu-agent-bridge-management"],
+  "repository": { "type": "git", "url": "https://codeup.aliyun.com/6808da56fb3da14b899afd54/agent_bridge.git", "directory": "packages/abweb" },
+  "main": "dist/src-ts/plugins/abweb/index.js",
+  "files": [
+    "dist/",
+    "plugin.json",
+    "config.schema.json",
+    "README.md"
+  ],
+  "agentBridge": {
+    "plugin": "./plugin.json",
+    "type": "management"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "abweb",
+  "version": "1.0.1",
+  "type": "management",
+  "displayName": "Agent Bridge Web",
+  "entry": "dist/src-ts/plugins/abweb/index.js",
+  "apiVersion": "1",
+  "process": "in-process",
+  "capabilities": ["web", "management", "health"],
+  "configSchema": "config.schema.json"
+}