agent-bridge-aun 0.0.0-stage → 1.0.3

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# AUN 通道插件
 
-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.
+`agent-bridge-aun` 为 mu-agent-bridge 提供 AUN 消息通道，支持使用已有 AID 或通过管理 API 注册 AID，并将收到的文本交给指定 Agent 插件处理。
+
+安装后在 ABWeb 的插件管理中启动 AUN 通道。配置 `aid` 和可选的 `agent_plugin`；默认 Agent 插件为 `qwenwork`。AID 创建接口为 `POST /api/plugins/aun/aid`，请求内容为 `{"aid":"新AID.agentid.cn","owner_aid":"所有者AID.agentid.cn"}`。
+
+该插件依赖 `@agentunion/fastaun`，要求 Node.js 22.16 或更高版本。
+
+ABWeb 的 AUN 设置仅展示已连接 AID。列表先显示已关联 Agent 的身份，同类中本工程身份在 EvolCore 身份前面；各组按最近成功关联的时间倒序排列，时间相同或旧记录没有时间时按 AID 名称排序。关联时间保存在插件配置的 `binding_times` 中，刷新或重启后保留；旧记录不补造时间，再次关联成功后开始记录。

package/config.schema.json

@@ -0,0 +1,18 @@
+{
+  "type": "object",
+  "properties": {
+    "identities": { "type": "array", "items": { "type": "string" } },
+    "bindings": { "type": "object", "additionalProperties": { "type": "string" } },
+    "binding_times": { "type": "object", "additionalProperties": { "type": "string" } },
+    "aid": { "type": "string", "minLength": 1 },
+    "owner_aid": { "type": "string", "minLength": 1 },
+    "agent_plugin": { "type": "string", "minLength": 1, "default": "qwenwork" },
+    "aun_path": { "type": "string", "minLength": 1 },
+    "encryption_seed": { "type": "string" },
+    "verify_ssl": { "type": "boolean", "default": true },
+    "root_ca_path": { "type": "string" },
+    "allow_from": { "type": "string" },
+    "delivery_mode": { "enum": ["fanout", "queue"] }
+  },
+  "additionalProperties": false
+}

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/channel.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src-ts/local-aids.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listExistingAids = listExistingAids;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+async function listExistingAids() {
+    const root = (0, node_path_1.resolve)(process.env.EVOLCORE_HOME ?? (0, node_path_1.join)((0, node_os_1.homedir)(), ".evolcore"), "AIDs");
+    let names;
+    try {
+        names = await (0, promises_1.readdir)(root);
+    }
+    catch {
+        return [];
+    }
+    const available = await Promise.all(names.filter((name) => /^[a-zA-Z0-9.-]+$/.test(name)).map(async (name) => {
+        try {
+            await (0, promises_1.access)((0, node_path_1.join)(root, name, "private", "key.json"));
+            return name;
+        }
+        catch {
+            return undefined;
+        }
+    }));
+    return available.filter((name) => Boolean(name)).sort();
+}

package/dist/src-ts/plugins/aun/evolcore.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEc = runEc;
+exports.configureAidForPlugin = configureAidForPlugin;
+exports.listConnectedAids = listConnectedAids;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const local_aids_1 = require("../../local-aids");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+async function runEc(args) {
+    try {
+        const { stdout } = await execFileAsync("ec", args, { shell: process.platform === "win32", timeout: 15_000, maxBuffer: 1024 * 1024 });
+        return JSON.parse(stdout);
+    }
+    catch (error) {
+        const stdout = error.stdout;
+        if (stdout) {
+            try {
+                return JSON.parse(stdout);
+            }
+            catch { /* 保留原始命令错误 */ }
+        }
+        throw error;
+    }
+}
+async function configureAidForPlugin(pluginId, aid, port, run = runEc) {
+    if (!aid)
+        return;
+    if (!/^[a-z0-9_-]+$/.test(pluginId))
+        throw new Error("插件 ID 格式无效");
+    const path = pluginId === "dsh" ? "/dsh/v1" : pluginId === "qwenwork" ? "/v1" : `/api/agents/${pluginId}/v1`;
+    for (const [key, value] of [
+        ["baseagents.ecagent.baseUrl", `http://127.0.0.1:${port}${path}`],
+        ["baseagents.ecagent.apiKey", "mab-local"],
+        ["baseagents.ecagent.model", pluginId],
+        ["active_baseagent", "ecagent"],
+    ]) {
+        const result = await run(["agent", "set", aid, key, value, "--format", "json"]);
+        if (!result?.ok)
+            throw new Error(`配置 AID ${aid} 失败：${key}；${result?.code ?? ""} ${result?.error ?? "未知错误"}`);
+    }
+    const result = await run(["agent", "reload", aid, "--format", "json"]);
+    if (!result?.ok)
+        throw new Error(`重载 AID ${aid} 失败：${result?.code ?? ""} ${result?.error ?? "未知错误"}`);
+}
+async function listConnectedAids(run = runEc) {
+    const result = await run(["agent", "list", "--format", "json"]);
+    if (!result.ok || !Array.isArray(result.agents))
+        throw new Error("读取 EvolCore Agent 列表失败");
+    const candidates = result.agents.filter((agent) => agent.status === "running" && typeof agent.aid === "string" && /^[a-zA-Z0-9.-]+$/.test(agent.aid) && agent.channels?.some((channel) => channel.startsWith("aun#")));
+    const details = await Promise.all(candidates.map((agent) => run(["agent", "show", agent.aid, "--format", "json"]).catch(() => null)));
+    const local = new Set(await (0, local_aids_1.listExistingAids)());
+    return details.filter((detail) => detail?.ok && detail.status === "running" && detail.connection?.status === "connected" && local.has(detail.aid)).map((detail) => detail.aid).sort();
+}

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

@@ -0,0 +1,420 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AunPlugin = void 0;
+const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const messages_1 = require("./messages");
+const evolcore_1 = require("./evolcore");
+const local_aids_1 = require("../../local-aids");
+const manifest = {
+    id: "aun", version: "1.0.3", type: "channel", displayName: "AUN 通道",
+    entry: "dist/src-ts/plugins/aun/index.js", apiVersion: "1", process: "in-process",
+    capabilities: ["channel", "channel.identity.create", "channel.receive", "channel.send", "health"],
+    configSchema: "config.schema.json",
+    managementPage: "/abweb/channels/aun",
+};
+async function loadSdk() {
+    const resolver = (0, node_module_1.createRequire)(__filename);
+    const dynamicImport = new Function("url", "return import(url)");
+    for (const modules of resolver.resolve.paths("@agentunion/fastaun") ?? []) {
+        const packageRoot = (0, node_path_1.join)(modules, "@agentunion", "fastaun");
+        try {
+            const metadata = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(packageRoot, "package.json"), "utf8"));
+            const entry = typeof metadata.exports?.["."] === "object" ? metadata.exports["."]?.import : metadata.exports?.["."];
+            return await dynamicImport((0, node_url_1.pathToFileURL)((0, node_path_1.join)(packageRoot, entry ?? metadata.main ?? "index.js")).href);
+        }
+        catch { /* 继续查找上一级 node_modules */ }
+    }
+    throw new Error("未找到 @agentunion/fastaun，请确认 AUN 插件依赖已安装");
+}
+const aidPattern = /^[a-z0-9][a-z0-9_-]{2,63}\.[a-z0-9-]+(?:\.[a-z0-9-]+)+$/;
+class AunPlugin {
+    options;
+    manifest = manifest;
+    context;
+    sdk;
+    store;
+    clients = new Map();
+    identities = new Set();
+    legacyCreatedAids = new Set();
+    bindings = {};
+    bindingTimes = {};
+    creating = false;
+    unregister = [];
+    ingress;
+    aid = "";
+    config = {};
+    status = "degraded";
+    healthMessage = "尚未配置 AID";
+    seen = new messages_1.DuplicateTracker();
+    constructor(options = {}) {
+        this.options = options;
+        this.sdk = options.sdk;
+        this.ingress = options.ingress;
+    }
+    identity = {
+        list: async () => {
+            const connected = await (this.options.connectedAids ?? evolcore_1.listConnectedAids)().catch((error) => {
+                this.context?.logger.warn("查询 EvolCore 已连接身份失败", { error: safeError(error) });
+                return [];
+            });
+            return {
+                evolcore: connected.filter((aid) => !this.identities.has(aid) && !this.legacyCreatedAids.has(aid)),
+                muAgentBridge: [...new Set([...this.clients.keys(), ...connected.filter((aid) => this.legacyCreatedAids.has(aid))])].sort(),
+                localMuAgentBridge: [...this.identities].filter((aid) => !this.clients.has(aid)).sort(),
+            };
+        },
+        create: async (aid, owner) => {
+            if (!aidPattern.test(aid) || !aidPattern.test(owner))
+                throw new Error("需要有效的 AID 和 Owner AID");
+            if (this.creating)
+                throw new Error("正在创建身份，请稍后再试");
+            this.creating = true;
+            try {
+                if (!this.identities.has(aid)) {
+                    const result = await this.store.register({ aid, type: "agent", owner });
+                    if (!result.ok)
+                        throw new Error(redact(result.error?.message ?? result.error?.code ?? "AID 注册失败"));
+                    const ownership = result.data?.ownership_status ?? result.data?.state ?? result.data?.operation_state;
+                    if (ownership && ownership !== "active")
+                        return { aid, status: "等待 Owner 确认", operation_id: result.data?.operation_id };
+                    const loaded = this.store.load(aid);
+                    if (!loaded.ok || !loaded.data)
+                        throw new Error(loaded.error?.message ?? "注册后未能加载本地身份");
+                    this.identities.add(aid);
+                    this.config.aid = this.aid = aid;
+                    this.config.owner_aid = owner;
+                    this.config.aun_path = this.path();
+                    await this.persist();
+                    this.context?.logger.info("AUN 身份已创建", { aid, owner });
+                }
+                if (!this.clients.has(aid))
+                    await this.connectAid(aid);
+                return { aid, status: "已创建", connection: this.clients.has(aid) ? "ready" : "degraded" };
+            }
+            finally {
+                this.creating = false;
+            }
+        },
+        bind: async (pluginId, aid, port) => {
+            if (pluginId === "aun" || pluginId === "abweb")
+                throw new Error("只能关联 Agent 插件");
+            const previous = this.bindings;
+            const previousTimes = this.bindingTimes;
+            this.bindings = { ...previous };
+            this.bindingTimes = { ...previousTimes };
+            try {
+                if (aid) {
+                    if (!aidPattern.test(aid))
+                        throw new Error("AID 格式无效");
+                    if (this.context?.pluginStatus(pluginId) !== "ready")
+                        throw new Error("目标 Agent 插件未启动");
+                    if (this.identities.has(aid)) {
+                        if (!this.clients.has(aid))
+                            await this.connectAid(aid);
+                        if (!this.clients.has(aid))
+                            throw new Error("AID 当前未连接");
+                        for (const [identity, target] of Object.entries(this.bindings))
+                            if (target === pluginId) {
+                                delete this.bindings[identity];
+                                delete this.bindingTimes[identity];
+                            }
+                        this.bindings[aid] = pluginId;
+                    }
+                    else {
+                        if (!(await (0, evolcore_1.listConnectedAids)()).includes(aid))
+                            throw new Error("AID 当前未连接");
+                        await (0, evolcore_1.configureAidForPlugin)(pluginId, aid, port);
+                        for (const [identity, target] of Object.entries(this.bindings))
+                            if (target === pluginId) {
+                                delete this.bindings[identity];
+                                delete this.bindingTimes[identity];
+                            }
+                    }
+                }
+                else {
+                    for (const [identity, target] of Object.entries(this.bindings))
+                        if (target === pluginId) {
+                            delete this.bindings[identity];
+                            delete this.bindingTimes[identity];
+                        }
+                }
+                if (aid)
+                    this.bindingTimes[aid] = new Date().toISOString();
+                await this.persist();
+            }
+            catch (error) {
+                this.bindings = previous;
+                this.bindingTimes = previousTimes;
+                this.config.bindings = previous;
+                this.config.binding_times = previousTimes;
+                this.context?.logger.error("AUN 身份关联失败", { aid, pluginId, error: safeError(error) });
+                throw error;
+            }
+            this.context?.logger.info("AUN 身份关联已更新", { aid, pluginId });
+        },
+    };
+    async persist() {
+        this.config.identities = [...this.identities].sort();
+        this.config.bindings = this.bindings;
+        this.config.binding_times = this.bindingTimes;
+        await (0, promises_1.writeFile)((0, node_path_1.join)(this.context.dataDir, "config.json"), `${JSON.stringify(this.config, null, 2)}\n`, { mode: 0o600 });
+    }
+    async activate(context) {
+        this.context = context;
+        this.config = { ...context.config };
+        this.legacyCreatedAids.clear();
+        try {
+            const created = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(context.dataDir, "..", "created-aids.json"), "utf8"));
+            if (Array.isArray(created))
+                for (const aid of created)
+                    if (typeof aid === "string" && aidPattern.test(aid))
+                        this.legacyCreatedAids.add(aid);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                context.logger.warn("读取旧版身份创建记录失败", { error: safeError(error) });
+        }
+        for (const key of ["aid", "owner_aid", "aun_path", "encryption_seed", "root_ca_path", "allow_from", "agent_plugin"]) {
+            if (this.config[key] !== undefined && typeof this.config[key] !== "string")
+                throw new Error(`${key} 必须是字符串`);
+        }
+        if (this.config.verify_ssl !== undefined && typeof this.config.verify_ssl !== "boolean")
+            throw new Error("verify_ssl 必须是布尔值");
+        if (this.config.delivery_mode !== undefined && !["fanout", "queue"].includes(String(this.config.delivery_mode)))
+            throw new Error("delivery_mode 只能是 fanout 或 queue");
+        if (this.config.aid && !aidPattern.test(String(this.config.aid)))
+            throw new Error("AID 格式无效");
+        if (this.config.owner_aid && !aidPattern.test(String(this.config.owner_aid)))
+            throw new Error("Owner AID 格式无效");
+        this.ingress ??= context.ingress;
+        if (!this.ingress)
+            throw new Error("运行时未提供通道消息入口");
+        this.sdk ??= await loadSdk();
+        await (0, promises_1.mkdir)(this.path(), { recursive: true });
+        this.store = this.newStore();
+        for (const [method, path, handler] of [
+            ["POST", "/api/plugins/aun/aid", this.createAid],
+            ["GET", "/api/plugins/aun/identities", this.listIdentities],
+            ["POST", "/api/plugins/aun/bind", this.bindAgent],
+            ["POST", "/api/plugins/aun/settings", this.saveSettings],
+            ...(["", "/app.js", "/style.css"].map((suffix) => ["GET", `/abweb/channels/aun${suffix}`, this.servePage])),
+        ]) {
+            const dispose = context.http.register({ method, path, handler });
+            if (typeof dispose === "function")
+                this.unregister.push(dispose);
+        }
+        this.aid = typeof this.config.aid === "string" ? this.config.aid.trim() : "";
+        this.bindings = this.config.bindings && typeof this.config.bindings === "object" && !Array.isArray(this.config.bindings) ? { ...this.config.bindings } : {};
+        this.bindingTimes = this.config.binding_times && typeof this.config.binding_times === "object" && !Array.isArray(this.config.binding_times) ? { ...this.config.binding_times } : {};
+        for (const aid of Array.isArray(this.config.identities) ? this.config.identities : []) {
+            if (typeof aid === "string" && aidPattern.test(aid))
+                this.identities.add(aid);
+        }
+        if (this.aid)
+            this.identities.add(this.aid);
+        for (const aid of this.identities)
+            await this.connectAid(aid);
+    }
+    async connectAid(aid) {
+        try {
+            const loaded = this.store.load(aid);
+            if (!loaded.ok || !loaded.data)
+                throw new Error(loaded.error?.message ?? "本地密钥库中不存在该 AID");
+            const client = new this.sdk.AUNClient(loaded.data.aid);
+            const subscription = client.on("message.received", (payload) => this.onMessage(payload, aid));
+            try {
+                await client.connect();
+            }
+            catch (error) {
+                subscription.unsubscribe();
+                await client.close();
+                throw error;
+            }
+            this.clients.set(aid, { client, subscription });
+            this.status = "ready";
+            this.healthMessage = "已连接";
+        }
+        catch (error) {
+            this.status = "degraded";
+            this.healthMessage = safeError(error);
+            this.context?.logger.warn("AUN 通道连接失败", { error: this.healthMessage });
+        }
+    }
+    async deactivate(_reason) {
+        this.status = "degraded";
+        for (const { client, subscription } of this.clients.values()) {
+            subscription.unsubscribe();
+            await client.close();
+        }
+        this.clients.clear();
+        await this.store?.close();
+        this.store = undefined;
+        for (const dispose of this.unregister.splice(0))
+            dispose();
+        this.context?.http.unregister("aun");
+        this.context = undefined;
+    }
+    async health() {
+        return { status: this.clients.size ? "ready" : this.status, message: this.healthMessage, details: { aid: this.aid || undefined, connected: this.clients.size > 0, aids: [...this.clients.keys()], identities: [...this.identities], bindings: this.bindings } };
+    }
+    async handle(_request) { throw new Error("AUN 是入站通道插件"); }
+    path() {
+        const configured = this.config.aun_path;
+        return typeof configured === "string" && configured.trim() ? configured : (0, node_path_1.join)(this.context.dataDir, "aun");
+    }
+    newStore() {
+        return new this.sdk.AIDStore({ aunPath: this.path(), encryptionSeed: typeof this.config.encryption_seed === "string" ? this.config.encryption_seed : "", verifySsl: typeof this.config.verify_ssl === "boolean" ? this.config.verify_ssl : true, rootCaPath: this.config.root_ca_path });
+    }
+    createAid = async (request, response) => {
+        let input;
+        try {
+            let body = "";
+            for await (const chunk of request) {
+                body += Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
+                if (body.length > 65536)
+                    throw new Error("请求内容过大");
+            }
+            input = JSON.parse(body);
+        }
+        catch (error) {
+            return this.json(response, 400, { error: error instanceof Error && error.message === "请求内容过大" ? error.message : "JSON 请求格式无效" });
+        }
+        const aid = input && typeof input === "object" && typeof input.aid === "string" ? input.aid.trim() : "";
+        if (!aidPattern.test(aid))
+            return this.json(response, 400, { error: "AID 格式无效" });
+        try {
+            const body = input;
+            const requestedOwner = body.owner_aid ?? body.ownerAid;
+            const owner = typeof requestedOwner === "string" && requestedOwner.trim()
+                ? requestedOwner.trim()
+                : typeof this.config.owner_aid === "string" ? this.config.owner_aid.trim() : "";
+            if (!owner)
+                return this.json(response, 400, { error: "创建 AID 时必须提供 Owner AID" });
+            if (!aidPattern.test(owner))
+                return this.json(response, 400, { error: "Owner AID 格式无效" });
+            const result = await this.identity.create(aid, owner);
+            return this.json(response, result.status === "等待 Owner 确认" ? 202 : 201, result);
+        }
+        catch (error) {
+            this.context?.logger.warn("AUN AID 注册失败", { error: safeError(error) });
+            return this.json(response, 502, { error: safeError(error) });
+        }
+    };
+    listIdentities = async (_request, response) => {
+        const groups = await this.identity.list();
+        const connected = new Set([...groups.evolcore, ...groups.muAgentBridge]);
+        const localAids = (await (0, local_aids_1.listExistingAids)()).filter((aid) => !connected.has(aid));
+        this.json(response, 200, { groups, localAids, bindings: this.bindings, bindingTimes: this.bindingTimes });
+    };
+    saveSettings = async (request, response) => {
+        try {
+            let raw = "";
+            for await (const chunk of request) {
+                raw += chunk;
+                if (raw.length > 65536)
+                    throw new Error("请求内容过大");
+            }
+            const body = JSON.parse(raw || "{}");
+            for (const key of ["agent_plugin", "allow_from", "aun_path"])
+                if (typeof body[key] !== "string")
+                    return this.json(response, 400, { error: `${key} 必须是字符串` });
+            if (body.encryption_seed !== undefined && typeof body.encryption_seed !== "string")
+                return this.json(response, 400, { error: "encryption_seed 必须是字符串" });
+            this.config = { ...this.config, agent_plugin: body.agent_plugin, allow_from: body.allow_from, aun_path: body.aun_path, ...(body.encryption_seed ? { encryption_seed: body.encryption_seed } : {}) };
+            await this.persist();
+            this.context?.logger.info("AUN 通道配置已保存");
+            this.json(response, 200, { ok: true });
+        }
+        catch (error) {
+            this.context?.logger.warn("AUN 通道配置失败", { error: safeError(error) });
+            this.json(response, 400, { error: safeError(error) });
+        }
+    };
+    bindAgent = async (request, response) => {
+        try {
+            let raw = "";
+            for await (const chunk of request) {
+                raw += chunk;
+                if (raw.length > 65536)
+                    throw new Error("请求内容过大");
+            }
+            const body = JSON.parse(raw || "{}");
+            const aid = typeof body.aid === "string" ? body.aid.trim() : "";
+            const pluginId = typeof body.pluginId === "string" ? body.pluginId.trim() : "";
+            const port = Number(body.port);
+            if (!aidPattern.test(aid) || !/^[a-z][a-z0-9-]{1,63}$/.test(pluginId) || !Number.isInteger(port) || port < 1 || port > 65535)
+                return this.json(response, 400, { error: "关联参数无效" });
+            await this.identity.bind(pluginId, aid, port);
+            this.json(response, 200, { ok: true });
+        }
+        catch (error) {
+            this.json(response, 400, { error: safeError(error) });
+        }
+    };
+    servePage = async (request, response) => {
+        const path = new URL(request.url ?? "/", "http://localhost").pathname;
+        const file = path.endsWith("/app.js") ? "app.js" : path.endsWith("/style.css") ? "style.css" : "index.html";
+        try {
+            const content = await (0, promises_1.readFile)((0, node_path_1.join)(__dirname, "public", file));
+            response.statusCode = 200;
+            response.setHeader("content-type", file.endsWith(".js") ? "text/javascript; charset=utf-8" : file.endsWith(".css") ? "text/css; charset=utf-8" : "text/html; charset=utf-8");
+            response.setHeader("cache-control", "no-store");
+            response.end(content);
+        }
+        catch {
+            this.json(response, 503, { error: "AUN 设置页面资源不可用" });
+        }
+    };
+    async onMessage(payload, aid) {
+        const message = (0, messages_1.normalizeAunMessage)(payload, aid, typeof this.config.allow_from === "string" ? this.config.allow_from : undefined);
+        if (!message || !this.seen.add(message.messageId ? `${aid}:${message.messageId}` : ""))
+            return;
+        const channelMessage = {
+            channel: "aun", peerId: message.peerId, messageId: message.messageId, text: message.text, threadId: message.threadId,
+            agentPlugin: this.bindings[aid] || (typeof this.config.agent_plugin === "string" && this.config.agent_plugin.trim() ? this.config.agent_plugin.trim() : "qwenwork"),
+            reply: async (text) => {
+                if (!text.trim())
+                    return;
+                const payload = { type: "text", text };
+                if (message.threadId)
+                    payload.thread_id = message.threadId;
+                const params = { to: message.peerId, payload, encrypt: true };
+                try {
+                    await this.clients.get(aid).client.call("message.send", params);
+                }
+                catch (error) {
+                    if (!this.isE2eeError(error))
+                        throw error;
+                    await this.clients.get(aid).client.call("message.send", { ...params, encrypt: false });
+                }
+            },
+        };
+        try {
+            await this.ingress.publish(channelMessage);
+        }
+        catch (error) {
+            this.context?.logger.warn("AUN 消息处理失败", { error: safeError(error) });
+        }
+    }
+    isE2eeError(error) {
+        const sdk = this.sdk;
+        return [sdk.E2EEError, sdk.E2EEDecryptFailedError, sdk.E2EEDegradedError].some((type) => !!type && error instanceof type)
+            || (error instanceof Error && /^(E2EE|E2EE[A-Za-z]+Error)/.test(error.name));
+    }
+    json(response, status, value) {
+        response.statusCode = status;
+        response.setHeader("content-type", "application/json; charset=utf-8");
+        response.end(JSON.stringify(value));
+    }
+}
+exports.AunPlugin = AunPlugin;
+exports.default = AunPlugin;
+function safeError(error) {
+    return redact(error instanceof Error ? error.message : String(error)).slice(0, 240);
+}
+function redact(message) {
+    return message.replace(/(private[_ -]?key|seed|token|certificate)\s*[:=]\s*[^\s,;]+/gi, "$1=[已隐藏]");
+}

package/dist/src-ts/plugins/aun/messages.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DuplicateTracker = void 0;
+exports.normalizeAunMessage = normalizeAunMessage;
+function normalizeAunMessage(payload, selfAid, allowFrom) {
+    if (!payload || typeof payload !== "object")
+        return undefined;
+    const data = payload;
+    const peerId = typeof data.from === "string" ? data.from.trim() : "";
+    const rules = (allowFrom ?? "").split(",").map((value) => value.trim()).filter(Boolean);
+    if (!peerId || peerId === selfAid || (rules.length > 0 && !rules.includes(peerId)))
+        return undefined;
+    const body = data.payload && typeof data.payload === "object" ? data.payload : {};
+    const text = typeof data.payload === "string" ? data.payload : typeof body.text === "string" ? body.text : "";
+    if (!text.trim())
+        return undefined;
+    return {
+        peerId,
+        ...(typeof data.message_id === "string" ? { messageId: data.message_id } : {}),
+        text,
+        ...(typeof body.thread_id === "string" ? { threadId: body.thread_id } : {}),
+    };
+}
+class DuplicateTracker {
+    limit;
+    ttlMs;
+    ids = new Map();
+    constructor(limit = 10000, ttlMs = 5 * 60 * 1000) {
+        this.limit = limit;
+        this.ttlMs = ttlMs;
+    }
+    add(id, now = Date.now()) {
+        if (!id)
+            return true;
+        const seen = this.ids.get(id);
+        if (seen !== undefined && now - seen < this.ttlMs)
+            return false;
+        this.ids.delete(id);
+        this.ids.set(id, now);
+        while (this.ids.size > this.limit)
+            this.ids.delete(this.ids.keys().next().value);
+        return true;
+    }
+}
+exports.DuplicateTracker = DuplicateTracker;

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

@@ -0,0 +1,66 @@
+(() => {
+  const find = (selector) => document.querySelector(selector);
+  const status = find("#status");
+  const list = find("#identities");
+  const createForm = find("#create-form");
+  const configForm = find("#config-form");
+  let agents = [];
+  let loading = false;
+
+  async function request(path, method = "GET", body) {
+    const token = localStorage.getItem("mab-login-token");
+    const response = await fetch(path, { method, headers: { ...(token ? { authorization: `Bearer ${token}` } : {}), ...(body ? { "content-type": "application/json" } : {}) }, ...(body ? { body: JSON.stringify(body) } : {}) });
+    const result = await response.json();
+    if (!response.ok) throw new Error(result.error || `请求失败：${response.status}`);
+    return result;
+  }
+  function show(message, failed = false) { status.textContent = message; status.className = failed ? "error" : ""; }
+  async function load(refreshForm = true) {
+    if (loading) return;
+    loading = true;
+    try {
+      const [identities, plugins, config] = await Promise.all([request("/api/plugins/aun/identities"), request("/api/plugins"), request("/api/plugins/aun/config")]);
+      agents = (plugins.plugins || []).filter((plugin) => plugin.type === "agent");
+      if (refreshForm) createForm.elements.ownerAid.value = config.owner_aid || "";
+      await Promise.all(agents.map(async (agent) => { agent.configAid = (await request(`/api/plugins/${encodeURIComponent(agent.id)}/config`)).aid || ""; }));
+      const target = configForm.elements.agent_plugin;
+      if (refreshForm) {
+        target.replaceChildren(new Option("默认 Agent", ""), ...agents.map((agent) => new Option(agent.displayName || agent.id, agent.id)));
+        target.value = config.agent_plugin || "";
+        for (const key of ["allow_from", "aun_path"]) configForm.elements[key].value = config[key] || "";
+        configForm.elements.encryption_seed.value = "";
+      }
+      list.replaceChildren();
+      const entries = [["本工程 · 已连接", identities.groups.muAgentBridge || []], ["EvolCore · 已连接", identities.groups.evolcore || []]]
+        .flatMap(([label, values], group) => values.map((aid) => ({ aid, label, group, bound: identities.bindings?.[aid] || agents.find((agent) => agent.id && agent.configAid === aid)?.id || "", time: Date.parse(identities.bindingTimes?.[aid] || "") || 0 })));
+      entries.sort((a, b) => Number(Boolean(b.bound)) - Number(Boolean(a.bound)) || a.group - b.group || b.time - a.time || a.aid.localeCompare(b.aid));
+      for (const { aid, label, bound } of entries) {
+          const row = document.createElement("tr");
+          for (const value of [aid, label, bound || "未关联"]) { const cell = document.createElement("td"); cell.textContent = value; row.append(cell); }
+          const cell = document.createElement("td"); const select = document.createElement("select"); select.setAttribute("aria-label", `${aid} 关联 Agent`);
+          select.append(new Option("选择 Agent", ""), ...agents.map((agent) => new Option(agent.displayName || agent.id, agent.id)));
+          select.value = bound; select.onchange = () => { if (select.value) void bind(aid, select.value); };
+          cell.append(select); row.append(cell); list.append(row);
+      }
+      if (!list.children.length) { const row = document.createElement("tr"); const cell = document.createElement("td"); cell.colSpan = 4; cell.textContent = "暂无已连接 AID"; row.append(cell); list.append(row); }
+      show(`${(identities.groups.evolcore || []).length + (identities.groups.muAgentBridge || []).length} 个已连接 AID`);
+    } catch (error) { show(String(error), true); }
+    finally { loading = false; }
+  }
+  async function bind(aid, pluginId) {
+    try {
+      await request(`/api/plugins/${encodeURIComponent(pluginId)}/aid`, "PATCH", { aid });
+      await load(); show(`${aid} 已关联 ${pluginId}`);
+    } catch (error) { show(`关联失败：${String(error)}`, true); }
+  }
+  createForm.onsubmit = (event) => { event.preventDefault(); const aid = createForm.elements.aid.value.trim(); const owner = createForm.elements.ownerAid.value.trim();
+    void request("/api/plugins/aun/aid", "POST", { aid, ownerAid: owner }).then((result) => load().then(() => show(result.status === "等待 Owner 确认" ? `${aid} 等待 Owner 确认` : `${aid} 已创建`))).catch((error) => show(String(error), true));
+  };
+  configForm.onsubmit = (event) => { event.preventDefault(); const changes = { agent_plugin: configForm.elements.agent_plugin.value, allow_from: configForm.elements.allow_from.value, aun_path: configForm.elements.aun_path.value };
+    if (configForm.elements.encryption_seed.value) changes.encryption_seed = configForm.elements.encryption_seed.value;
+    void request("/api/plugins/aun/settings", "POST", changes).then(() => request("/api/plugins/aun/reload", "POST")).then(() => load()).then(() => show("配置已保存")).catch((error) => show(String(error), true));
+  };
+  find("#refresh").onclick = () => void load();
+  void load();
+  setInterval(() => { if (!document.hidden) void load(false); }, 10_000);
+})();

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

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><link rel="stylesheet" href="/abweb/channels/aun/style.css"><title>AUN 设置</title></head>
+<body>
+  <main>
+    <header><h1>AUN 身份</h1><button id="refresh" type="button">刷新</button></header>
+    <p id="status" role="status"></p>
+    <div class="table-scroll"><table><thead><tr><th>AID</th><th>来源</th><th>已关联 Agent</th><th>操作</th></tr></thead><tbody id="identities"></tbody></table></div>
+    <form id="create-form"><h2>创建 AID</h2><div class="fields"><label>新 AID<input name="aid" required placeholder="new.agentid.cn"></label><label>Owner AID<input name="ownerAid" required></label></div><button type="submit">创建</button></form>
+    <form id="config-form"><h2>通道配置</h2><div class="fields"><label>默认 Agent<select name="agent_plugin"></select></label><label>允许的来源<input name="allow_from"></label><label>AUN 存储路径<input name="aun_path"></label><label>加密种子<input name="encryption_seed" type="password" autocomplete="new-password" placeholder="留空则不修改"></label></div><button type="submit">保存配置</button></form>
+  </main>
+  <script src="/abweb/channels/aun/app.js"></script>
+</body>
+</html>

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

@@ -0,0 +1,21 @@
+:root { font-family: "Segoe UI", "Microsoft YaHei", sans-serif; color: #182027; background: #fff; }
+* { box-sizing: border-box; }
+body { margin: 0; }
+main { padding: 8px 2px 20px; }
+header { display: flex; align-items: center; justify-content: space-between; }
+h1 { font-size: 17px; margin: 0; }
+h2 { font-size: 15px; margin: 0 0 12px; }
+p { min-height: 20px; color: #54665d; font-size: 13px; }
+form { padding: 18px 0; border-top: 1px solid #d9dfdc; }
+.fields { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; margin-bottom: 12px; }
+label { display: grid; gap: 5px; font-size: 13px; }
+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; }
+button:hover { background: #e5f2ea; }
+.table-scroll { overflow-x: auto; margin: 10px 0 20px; }
+table { width: 100%; min-width: 650px; border-collapse: collapse; font-size: 13px; }
+th, td { padding: 9px 8px; text-align: left; border-bottom: 1px solid #dce3df; }
+th { background: #edf1ef; color: #566761; }
+td select { max-width: 190px; }
+.error { color: #a83427; }
+@media (max-width: 620px) { .fields { grid-template-columns: 1fr; } }

package/package.json

@@ -1,6 +1,13 @@
 {
   "name": "agent-bridge-aun",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.3",
+  "description": "mu-agent-bridge 的 AUN 通道插件。",
+  "keywords": ["mu-agent-bridge-plugin", "mu-agent-bridge-channel"],
+  "repository": { "type": "git", "url": "https://codeup.aliyun.com/6808da56fb3da14b899afd54/agent_bridge.git", "directory": "packages/aun" },
+  "main": "dist/src-ts/plugins/aun/index.js",
+  "files": ["dist/", "plugin.json", "config.schema.json", "README.md"],
+  "agentBridge": { "plugin": "./plugin.json", "type": "channel" },
+  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" },
+  "engines": { "node": ">=22.16.0" },
+  "dependencies": { "@agentunion/fastaun": "0.5.18" }
+}

package/plugin.json

@@ -0,0 +1,12 @@
+{
+  "id": "aun",
+  "version": "1.0.3",
+  "type": "channel",
+  "displayName": "AUN 通道",
+  "entry": "dist/src-ts/plugins/aun/index.js",
+  "apiVersion": "1",
+  "process": "in-process",
+  "capabilities": ["channel", "channel.identity.create", "channel.receive", "channel.send", "health"],
+  "configSchema": "config.schema.json",
+  "managementPage": "/abweb/channels/aun"
+}