@napuketto/adapter 0.0.2 → 0.0.4

package/dist/satori/index.mjs

@@ -6,6 +6,31 @@ import { join } from "node:path";
 import { HttpServer, WsServer } from "@napuketto/network";
 import { mkdir, open, writeFile } from "node:fs/promises";
 import { encodePcmToSilk } from "@napuketto/media";
+//#region src/satori/helper/config.ts
+/**
+* Satori 协议配置（zod schema，归属本包，ADR-012）
+* 协议配置 schema 在各自协议包，kernel 只提供 ConfigBase 基类。
+*/
+/** HTTP RPC 服务器默认端口（satori.chat 惯例 5500 区间，取 5500）。 */
+const DEFAULT_HTTP_PORT = 5500;
+/** WS 事件服务默认端口（satori.chat 惯例 5500 区间，取 5501）。 */
+const DEFAULT_WS_PORT = 5501;
+/** HTTP RPC 服务器实例（POST /v1/{resource}.{method}）。 */
+const httpServerSchema = createHttpServerSchema(DEFAULT_HTTP_PORT);
+/** WS 事件服务实例（/v1/events 信令，第三方 SDK 连入）。 */
+const wsServerSchema = createWsServerSchema(DEFAULT_WS_PORT);
+/** Satori 配置 schema。 */
+const satoriConfigSchema = z.object({
+	/** 鉴权 token（全局默认，实例未指定时继承）。 */
+	token: z.string().optional(),
+	/** 媒体资源（img/audio/video/file）下载缓存目录。 */
+	cacheDir: z.string().optional(),
+	/** HTTP RPC 服务器列表。 */
+	httpServers: z.array(httpServerSchema).default([]),
+	/** WS 事件服务列表。 */
+	wsServers: z.array(wsServerSchema).default([])
+});
+//#endregion
 //#region src/satori/helper/error.ts
 /** KernelErrorCode → HTTP 状态码映射表。 */
 const satoriHttpStatusMap = {
@@ -28,47 +53,65 @@ const HTTP_STATUS = {
 	notImplemented: 501,
 	serverError: 500
 };
+/** 适配器名（固定 napuketto）。 */
+const ADAPTER = "napuketto";
+/** 平台特性（API 可用性判断；群聊频道与群组重合 → guild.plain）。 */
+const FEATURES = ["guild.plain", "message.list.from"];
+/** 构造用户（uin）。 */
+function toUser(id, name, nick) {
+	const user = { id };
+	if (name !== void 0 && name !== "") user.name = name;
+	if (nick !== void 0 && nick !== "") user.nick = nick;
+	return user;
+}
+/** 构造群聊频道（id = 群号）。 */
+function toGroupChannel(groupCode, name) {
+	const channel = {
+		id: String(groupCode),
+		type: 0
+	};
+	if (name !== void 0 && name !== "") channel.name = name;
+	return channel;
+}
+/** 构造私聊频道（id = 对端 uin）。 */
+function toDirectChannel(uin, name) {
+	const channel = {
+		id: String(uin),
+		type: 1
+	};
+	if (name !== void 0 && name !== "") channel.name = name;
+	return channel;
+}
+/** 构造群组（id = 群号）。 */
+function toGuild(groupCode, name, avatar) {
+	const guild = { id: String(groupCode) };
+	if (name !== void 0 && name !== "") guild.name = name;
+	if (avatar !== void 0 && avatar !== "") guild.avatar = avatar;
+	return guild;
+}
+/** 构造登录信息（login.get / READY logins）。 */
+function toLogin(self, sn, online) {
+	return {
+		sn,
+		platform: "qq",
+		user: toUser(self.uin, self.nickname),
+		status: online ? 1 : 0,
+		adapter: ADAPTER,
+		features: [...FEATURES]
+	};
+}
+/** 构造非登录事件的最小 login（只带 sn/user/platform，规范）。 */
+function toMinimalLogin(sn, selfUin) {
+	return {
+		sn,
+		platform: "qq",
+		user: toUser(selfUin),
+		status: 1,
+		adapter: ADAPTER
+	};
+}
 //#endregion
-//#region src/satori/action/base-action.ts
-/**
-* Satori 动作基类（响应形态与 OB11 不同：直接返回资源对象，错误用 HTTP 状态码）
-*
-* - `run(payload)`：zod 校验失败 → SatoriActionError(400)；_handle 抛的
-*   KernelError → satoriHttpStatusMap 映射 HTTP 状态码（ADR-017）
-* - `SatoriActionError`：带 HTTP 状态码的动作错误（transport 层直接透传状态码）
-*/
-/** 动作错误（带 HTTP 状态码；由 transport 层透传）。 */
-var SatoriActionError = class extends Error {
-	status;
-	constructor(status, message) {
-		super(message);
-		this.status = status;
-	}
-};
-/** 校验失败默认状态码。 */
-const INVALID_PARAM_STATUS = 400;
-/** 兜底错误状态码。 */
-const UNKNOWN_STATUS = 500;
-/**
-* Satori 动作基类：校验 + 执行 + 错误映射。
-* 成功返回资源对象（或数组/分页列表），失败抛 SatoriActionError。
-*/
-var BaseSatoriAction = class {
-	/** 校验并执行（HTTP/WS 共用）。 */
-	async run(payload) {
-		const parsed = this.schema.safeParse(payload);
-		if (!parsed.success) throw new SatoriActionError(INVALID_PARAM_STATUS, "参数校验失败");
-		try {
-			return await this._handle(parsed.data);
-		} catch (err) {
-			if (err instanceof SatoriActionError) throw err;
-			if (isKernelError(err)) throw new SatoriActionError(satoriHttpStatusMap[err.code] ?? UNKNOWN_STATUS, err.message);
-			throw new SatoriActionError(UNKNOWN_STATUS, err instanceof Error ? err.message : "未知错误");
-		}
-	}
-};
-//#endregion
-//#region src/satori/helper/canonical.ts
+//#region src/satori/helper/element/canonical.ts
 /** 收集 at uid → 批量 uidToUin（失败不阻塞，at 原样 uid）。 */
 async function resolveAtUids(elements, uidToUin) {
 	const atUids = [];
@@ -163,7 +206,7 @@ async function canonicalToSatoriElements(elements, deps = {}) {
 	return out;
 }
 //#endregion
-//#region src/satori/helper/parse-tag.ts
+//#region src/satori/helper/element/parse-tag.ts
 /**
 * Satori 标签读取（元素名 / 属性解析，从 element.ts 拆分，2026-08-08 FTA 优化）
 *
@@ -294,7 +337,7 @@ function readTag(source, pos) {
 	};
 }
 //#endregion
-//#region src/satori/helper/element.ts
+//#region src/satori/helper/element/element.ts
 /**
 * Satori 消息元素解析/渲染（协议 v1，自研实现，规范参考 satori.chat/zh-CN/protocol/message.html）
 *
@@ -471,62 +514,222 @@ function renderElement(el) {
 	const inner = renderElements(children);
 	return `<${el.type}${attrs}>${inner}</${el.type}>`;
 }
-/** 适配器名（固定 napuketto）。 */
-const ADAPTER = "napuketto";
-/** 平台特性（API 可用性判断；群聊频道与群组重合 → guild.plain）。 */
-const FEATURES = ["guild.plain", "message.list.from"];
-/** 构造用户（uin）。 */
-function toUser(id, name, nick) {
-	const user = { id };
-	if (name !== void 0 && name !== "") user.name = name;
-	if (nick !== void 0 && nick !== "") user.nick = nick;
-	return user;
+//#endregion
+//#region src/satori/helper/element/asset.ts
+/**
+* Satori 发方向资源处理（从 element-convert.ts 拆分，2026-08-08 FTA 优化）
+*
+* - resolveAsset：internal: 路径 / http(s) 下载 / 本地路径原样
+* - ensureSilk：非 silk 语音（wav/pcm）转 silk（QQ 语音格式，失败原样返回）
+*/
+/** internal:{platform}/{user.id}/{path} → 本地路径（取 _tmp 之后的路径，回落 cacheDir）。 */
+function resolveInternalPath(src) {
+	const pathPart = src.slice(9);
+	const slash1 = pathPart.indexOf("/");
+	const slash2 = slash1 === -1 ? -1 : pathPart.indexOf("/", slash1 + 1);
+	if (slash2 === -1) return pathPart;
+	const rest = pathPart.slice(slash2 + 1);
+	const tmpIdx = rest.indexOf("_tmp/");
+	return tmpIdx === -1 ? rest : rest.slice(tmpIdx + 5);
 }
-/** 构造群聊频道（id = 群号）。 */
-function toGroupChannel(groupCode, name) {
-	const channel = {
-		id: String(groupCode),
-		type: 0
-	};
-	if (name !== void 0 && name !== "") channel.name = name;
-	return channel;
+/**
+* 解析资源 src：
+* - internal:{platform}/{user.id}/{path} → 本地路径（第一版仅支持 _tmp 保留路径）
+* - http(s):// → 下载到 cacheDir
+* - 其他 → 视为本地路径原样返回
+*/
+async function resolveAsset(src, cacheDir) {
+	if (src.startsWith("internal:")) return resolveInternalPath(src);
+	if (/^https?:\/\//i.test(src)) return downloadAsset(src, cacheDir);
+	return src;
 }
-/** 构造私聊频道（id = 对端 uin）。 */
-function toDirectChannel(uin, name) {
-	const channel = {
-		id: String(uin),
-		type: 1
+/** 下载 URL 资源到缓存目录（返回本地路径）。 */
+async function downloadAsset(url, cacheDir) {
+	await mkdir(cacheDir, { recursive: true });
+	const res = await fetch(url);
+	if (!res.ok) throw kernelError(`下载资源失败: ${url}`, "SEND_FAILED");
+	const buf = Buffer.from(await res.arrayBuffer());
+	const safeName = (url.split("/").pop() ?? `asset-${Date.now()}`).replace(/[^a-zA-Z0-9._-]/g, "_") || `asset-${Date.now()}`;
+	const filePath = join(cacheDir, safeName);
+	await writeFile(filePath, buf);
+	return filePath;
+}
+/** 语音转码：非 silk 输入（wav/pcm）转 silk（QQ 语音格式）。 */
+async function ensureSilk(path) {
+	try {
+		if ((await readFileHead(path)).startsWith("#!SILK")) return path;
+		return await encodePcmToSilk(path);
+	} catch {
+		return path;
+	}
+}
+/** 读文件头 8 字节（判断格式）。 */
+async function readFileHead(path) {
+	const handle = await open(path, "r");
+	try {
+		const buf = Buffer.alloc(8);
+		await handle.read(buf, 0, 8, 0);
+		return buf.toString("utf8");
+	} finally {
+		await handle.close();
+	}
+}
+//#endregion
+//#region src/satori/helper/element/media-convert.ts
+/** 解析元素媒体 src（空 → null 忽略），返回本地路径。 */
+async function resolveMediaSrc(el, deps) {
+	const src = el.attrs?.["src"] ?? "";
+	if (src === "") return null;
+	return resolveAsset(src, deps.cacheDir);
+}
+/** Satori img → canonical image。 */
+async function imgToCanonical(el, deps) {
+	const path = await resolveMediaSrc(el, deps);
+	return path === null ? [] : [{
+		type: "image",
+		path
+	}];
+}
+/** Satori audio → canonical voice（非 silk 转码）。 */
+async function audioToCanonical(el, deps) {
+	const path = await resolveMediaSrc(el, deps);
+	return path === null ? [] : [{
+		type: "voice",
+		path: await ensureSilk(path)
+	}];
+}
+/** Satori video → canonical video。 */
+async function videoToCanonical(el, deps) {
+	const path = await resolveMediaSrc(el, deps);
+	return path === null ? [] : [{
+		type: "video",
+		path
+	}];
+}
+/** Satori file → canonical file（title → name）。 */
+async function fileToCanonical(el, deps) {
+	const path = await resolveMediaSrc(el, deps);
+	if (path === null) return [];
+	const title = el.attrs?.["title"];
+	const base = {
+		type: "file",
+		path
 	};
-	if (name !== void 0 && name !== "") channel.name = name;
-	return channel;
+	if (title !== void 0 && title !== "") return [{
+		...base,
+		name: title
+	}];
+	return [base];
 }
-/** 构造群组（id = 群号）。 */
-function toGuild(groupCode, name, avatar) {
-	const guild = { id: String(groupCode) };
-	if (name !== void 0 && name !== "") guild.name = name;
-	if (avatar !== void 0 && avatar !== "") guild.avatar = avatar;
-	return guild;
+/** 媒体元素转换器子表（并入 element-convert 主表）。 */
+const MEDIA_CONVERTERS = {
+	img: imgToCanonical,
+	audio: audioToCanonical,
+	video: videoToCanonical,
+	file: fileToCanonical
+};
+//#endregion
+//#region src/satori/helper/element/element-convert.ts
+/** 发方向：Satori 元素树 → kernel canonical（at uin→uid + 资源下载/转码）。 */
+async function satoriToCanonicalElements(elements, deps) {
+	const atUins = [];
+	const collectAt = (list) => {
+		for (const el of list) {
+			const id = el.attrs?.["id"];
+			if (el.type === "at" && id !== void 0 && id !== "all") atUins.push(id);
+			if (el.children !== void 0) collectAt(el.children);
+		}
+	};
+	collectAt(elements);
+	let uinToUidMap = /* @__PURE__ */ new Map();
+	if (atUins.length > 0) try {
+		uinToUidMap = await deps.uinToUid([...new Set(atUins)]);
+	} catch {}
+	const out = [];
+	for (const el of elements) out.push(...await elementToCanonical(el, deps, uinToUidMap));
+	return out;
 }
-/** 构造登录信息（login.get / READY logins）。 */
-function toLogin(self, sn, online) {
-	return {
-		sn,
-		platform: "qq",
-		user: toUser(self.uin, self.nickname),
-		status: online ? 1 : 0,
-		adapter: ADAPTER,
-		features: [...FEATURES]
+/** Satori at → canonical at（uin → uid，name → display）。 */
+function atToCanonical(el, uinToUidMap) {
+	const id = el.attrs?.["id"] ?? "";
+	if (id === "all") return [{
+		type: "at",
+		target: "all"
+	}];
+	if (id === "") return [];
+	const target = uinToUidMap.get(id) ?? id;
+	const display = el.attrs?.["name"];
+	const base = {
+		type: "at",
+		target
 	};
+	if (display !== void 0 && display !== "") return [{
+		...base,
+		display
+	}];
+	return [base];
+}
+/** Satori message：forward 属性 → canonical forward；否则展开子元素。 */
+async function messageToCanonical(el, deps, uinToUidMap) {
+	if (el.attrs?.["forward"] !== void 0) {
+		const id = el.attrs?.["id"] ?? "";
+		return id === "" ? [] : [{
+			type: "forward",
+			messageIds: [id]
+		}];
+	}
+	return flattenChildren(el.children, deps, uinToUidMap);
+}
+/** 元素 type → 转换器（未知/修饰/排版类型走 fallback，不在此表）。 */
+const ELEMENT_CONVERTERS = {
+	text: async (el) => {
+		const text = el.text ?? "";
+		return text === "" ? [] : [{
+			type: "text",
+			text
+		}];
+	},
+	at: async (el, _deps, uinToUidMap) => atToCanonical(el, uinToUidMap),
+	emoji: async (el) => {
+		const id = el.attrs?.["id"] ?? "";
+		return id === "" ? [] : [{
+			type: "face",
+			id
+		}];
+	},
+	quote: async (el) => {
+		const id = el.attrs?.["id"] ?? "";
+		return id === "" ? [] : [{
+			type: "reply",
+			messageId: id
+		}];
+	},
+	message: async (el, deps, uinToUidMap) => messageToCanonical(el, deps, uinToUidMap),
+	br: async () => [{
+		type: "text",
+		text: "\n"
+	}],
+	author: async () => [],
+	sharp: async () => [],
+	a: async () => [],
+	button: async () => [],
+	...MEDIA_CONVERTERS
+};
+/** 单个元素 → canonical（修饰/排版元素展开子元素）。 */
+async function elementToCanonical(el, deps, uinToUidMap) {
+	const converter = ELEMENT_CONVERTERS[el.type];
+	if (converter !== void 0) return converter(el, deps, uinToUidMap);
+	return flattenChildren(el.children, deps, uinToUidMap);
 }
-/** 构造非登录事件的最小 login（只带 sn/user/platform，规范）。 */
-function toMinimalLogin(sn, selfUin) {
-	return {
-		sn,
-		platform: "qq",
-		user: toUser(selfUin),
-		status: 1,
-		adapter: ADAPTER
-	};
+/** 展开子元素为 canonical（递归）。 */
+async function flattenChildren(children, deps, uinToUidMap) {
+	const out = [];
+	for (const child of children ?? []) out.push(...await elementToCanonical(child, deps, uinToUidMap));
+	return out;
+}
+/** 解析消息 content 字符串 → canonical（message.create 用）。 */
+async function parseContentToCanonical(content, deps) {
+	return satoriToCanonicalElements(parseElements(content), deps);
 }
 //#endregion
 //#region src/satori/helper/translate.ts
@@ -569,6 +772,45 @@ function toChannelById(channelId, isGroup, name) {
 	return toDirectChannel(channelId, name);
 }
 //#endregion
+//#region src/satori/action/base-action.ts
+/**
+* Satori 动作基类（响应形态与 OB11 不同：直接返回资源对象，错误用 HTTP 状态码）
+*
+* - `run(payload)`：zod 校验失败 → SatoriActionError(400)；_handle 抛的
+*   KernelError → satoriHttpStatusMap 映射 HTTP 状态码（ADR-017）
+* - `SatoriActionError`：带 HTTP 状态码的动作错误（transport 层直接透传状态码）
+*/
+/** 动作错误（带 HTTP 状态码；由 transport 层透传）。 */
+var SatoriActionError = class extends Error {
+	status;
+	constructor(status, message) {
+		super(message);
+		this.status = status;
+	}
+};
+/** 校验失败默认状态码。 */
+const INVALID_PARAM_STATUS = 400;
+/** 兜底错误状态码。 */
+const UNKNOWN_STATUS = 500;
+/**
+* Satori 动作基类：校验 + 执行 + 错误映射。
+* 成功返回资源对象（或数组/分页列表），失败抛 SatoriActionError。
+*/
+var BaseSatoriAction = class {
+	/** 校验并执行（HTTP/WS 共用）。 */
+	async run(payload) {
+		const parsed = this.schema.safeParse(payload);
+		if (!parsed.success) throw new SatoriActionError(INVALID_PARAM_STATUS, "参数校验失败");
+		try {
+			return await this._handle(parsed.data);
+		} catch (err) {
+			if (err instanceof SatoriActionError) throw err;
+			if (isKernelError(err)) throw new SatoriActionError(satoriHttpStatusMap[err.code] ?? UNKNOWN_STATUS, err.message);
+			throw new SatoriActionError(UNKNOWN_STATUS, err instanceof Error ? err.message : "未知错误");
+		}
+	}
+};
+//#endregion
 //#region src/satori/action/channel.ts
 /**
 * Satori 频道动作：channel.get / channel.list
@@ -715,7 +957,7 @@ var GuildListAction = class extends BaseSatoriAction {
 		this.deps = deps;
 	}
 	async _handle(_payload) {
-		return { data: (await this.deps.groupApi.getGroupList(true)).map((g) => toGuild(g.groupCode, g.groupName)) };
+		return { data: (this.deps.groupCache === void 0 ? await this.deps.groupApi.getGroupList(true) : await this.deps.groupCache.listGroupsRefreshed()).map((g) => toGuild(g.groupCode, g.groupName)) };
 	}
 };
 /** guild.approve 参数（处理入群邀请）。 */
@@ -862,214 +1104,6 @@ var LoginGetAction = class extends BaseSatoriAction {
 	}
 };
 //#endregion
-//#region src/satori/helper/asset.ts
-/**
-* Satori 发方向资源处理（从 element-convert.ts 拆分，2026-08-08 FTA 优化）
-*
-* - resolveAsset：internal: 路径 / http(s) 下载 / 本地路径原样
-* - ensureSilk：非 silk 语音（wav/pcm）转 silk（QQ 语音格式，失败原样返回）
-*/
-/** internal:{platform}/{user.id}/{path} → 本地路径（取 _tmp 之后的路径，回落 cacheDir）。 */
-function resolveInternalPath(src) {
-	const pathPart = src.slice(9);
-	const slash1 = pathPart.indexOf("/");
-	const slash2 = slash1 === -1 ? -1 : pathPart.indexOf("/", slash1 + 1);
-	if (slash2 === -1) return pathPart;
-	const rest = pathPart.slice(slash2 + 1);
-	const tmpIdx = rest.indexOf("_tmp/");
-	return tmpIdx === -1 ? rest : rest.slice(tmpIdx + 5);
-}
-/**
-* 解析资源 src：
-* - internal:{platform}/{user.id}/{path} → 本地路径（第一版仅支持 _tmp 保留路径）
-* - http(s):// → 下载到 cacheDir
-* - 其他 → 视为本地路径原样返回
-*/
-async function resolveAsset(src, cacheDir) {
-	if (src.startsWith("internal:")) return resolveInternalPath(src);
-	if (/^https?:\/\//i.test(src)) return downloadAsset(src, cacheDir);
-	return src;
-}
-/** 下载 URL 资源到缓存目录（返回本地路径）。 */
-async function downloadAsset(url, cacheDir) {
-	await mkdir(cacheDir, { recursive: true });
-	const res = await fetch(url);
-	if (!res.ok) throw kernelError(`下载资源失败: ${url}`, "SEND_FAILED");
-	const buf = Buffer.from(await res.arrayBuffer());
-	const safeName = (url.split("/").pop() ?? `asset-${Date.now()}`).replace(/[^a-zA-Z0-9._-]/g, "_") || `asset-${Date.now()}`;
-	const filePath = join(cacheDir, safeName);
-	await writeFile(filePath, buf);
-	return filePath;
-}
-/** 语音转码：非 silk 输入（wav/pcm）转 silk（QQ 语音格式）。 */
-async function ensureSilk(path) {
-	try {
-		if ((await readFileHead(path)).startsWith("#!SILK")) return path;
-		return await encodePcmToSilk(path);
-	} catch {
-		return path;
-	}
-}
-/** 读文件头 8 字节（判断格式）。 */
-async function readFileHead(path) {
-	const handle = await open(path, "r");
-	try {
-		const buf = Buffer.alloc(8);
-		await handle.read(buf, 0, 8, 0);
-		return buf.toString("utf8");
-	} finally {
-		await handle.close();
-	}
-}
-//#endregion
-//#region src/satori/helper/element-convert.ts
-/** 发方向：Satori 元素树 → kernel canonical（at uin→uid + 资源下载/转码）。 */
-async function satoriToCanonicalElements(elements, deps) {
-	const atUins = [];
-	const collectAt = (list) => {
-		for (const el of list) {
-			const id = el.attrs?.["id"];
-			if (el.type === "at" && id !== void 0 && id !== "all") atUins.push(id);
-			if (el.children !== void 0) collectAt(el.children);
-		}
-	};
-	collectAt(elements);
-	let uinToUidMap = /* @__PURE__ */ new Map();
-	if (atUins.length > 0) try {
-		uinToUidMap = await deps.uinToUid([...new Set(atUins)]);
-	} catch {}
-	const out = [];
-	for (const el of elements) out.push(...await elementToCanonical(el, deps, uinToUidMap));
-	return out;
-}
-/** 解析元素媒体 src（空 → null 忽略），返回本地路径。 */
-async function resolveMediaSrc(el, deps) {
-	const src = el.attrs?.["src"] ?? "";
-	if (src === "") return null;
-	return resolveAsset(src, deps.cacheDir);
-}
-/** Satori at → canonical at（uin → uid，name → display）。 */
-function atToCanonical(el, uinToUidMap) {
-	const id = el.attrs?.["id"] ?? "";
-	if (id === "all") return [{
-		type: "at",
-		target: "all"
-	}];
-	if (id === "") return [];
-	const target = uinToUidMap.get(id) ?? id;
-	const display = el.attrs?.["name"];
-	const base = {
-		type: "at",
-		target
-	};
-	if (display !== void 0 && display !== "") return [{
-		...base,
-		display
-	}];
-	return [base];
-}
-/** Satori img → canonical image。 */
-async function imgToCanonical(el, deps) {
-	const path = await resolveMediaSrc(el, deps);
-	return path === null ? [] : [{
-		type: "image",
-		path
-	}];
-}
-/** Satori audio → canonical voice（非 silk 转码）。 */
-async function audioToCanonical(el, deps) {
-	const path = await resolveMediaSrc(el, deps);
-	return path === null ? [] : [{
-		type: "voice",
-		path: await ensureSilk(path)
-	}];
-}
-/** Satori video → canonical video。 */
-async function videoToCanonical(el, deps) {
-	const path = await resolveMediaSrc(el, deps);
-	return path === null ? [] : [{
-		type: "video",
-		path
-	}];
-}
-/** Satori file → canonical file（title → name）。 */
-async function fileToCanonical(el, deps) {
-	const path = await resolveMediaSrc(el, deps);
-	if (path === null) return [];
-	const title = el.attrs?.["title"];
-	const base = {
-		type: "file",
-		path
-	};
-	if (title !== void 0 && title !== "") return [{
-		...base,
-		name: title
-	}];
-	return [base];
-}
-/** Satori message：forward 属性 → canonical forward；否则展开子元素。 */
-async function messageToCanonical(el, deps, uinToUidMap) {
-	if (el.attrs?.["forward"] !== void 0) {
-		const id = el.attrs?.["id"] ?? "";
-		return id === "" ? [] : [{
-			type: "forward",
-			messageIds: [id]
-		}];
-	}
-	return flattenChildren(el.children, deps, uinToUidMap);
-}
-/** 单个元素 → canonical（递归；修饰/排版元素展开子元素）。 */
-async function elementToCanonical(el, deps, uinToUidMap) {
-	switch (el.type) {
-		case "text": {
-			const text = el.text ?? "";
-			return text === "" ? [] : [{
-				type: "text",
-				text
-			}];
-		}
-		case "at": return atToCanonical(el, uinToUidMap);
-		case "img": return imgToCanonical(el, deps);
-		case "audio": return audioToCanonical(el, deps);
-		case "video": return videoToCanonical(el, deps);
-		case "file": return fileToCanonical(el, deps);
-		case "emoji": {
-			const id = el.attrs?.["id"] ?? "";
-			return id === "" ? [] : [{
-				type: "face",
-				id
-			}];
-		}
-		case "quote": {
-			const id = el.attrs?.["id"] ?? "";
-			return id === "" ? [] : [{
-				type: "reply",
-				messageId: id
-			}];
-		}
-		case "message": return messageToCanonical(el, deps, uinToUidMap);
-		case "br": return [{
-			type: "text",
-			text: "\n"
-		}];
-		case "author":
-		case "sharp":
-		case "a":
-		case "button": return [];
-		default: return flattenChildren(el.children, deps, uinToUidMap);
-	}
-}
-/** 展开子元素为 canonical（递归）。 */
-async function flattenChildren(children, deps, uinToUidMap) {
-	const out = [];
-	for (const child of children ?? []) out.push(...await elementToCanonical(child, deps, uinToUidMap));
-	return out;
-}
-/** 解析消息 content 字符串 → canonical（message.create 用）。 */
-async function parseContentToCanonical(content, deps) {
-	return satoriToCanonicalElements(parseElements(content), deps);
-}
-//#endregion
 //#region src/satori/action/message.ts
 /**
 * Satori 消息动作：message.create / get / list / delete
@@ -1590,31 +1624,6 @@ function toMember(uid, nick, remark, uidToUinMap) {
 	return member;
 }
 //#endregion
-//#region src/satori/helper/config.ts
-/**
-* Satori 协议配置（zod schema，归属本包，ADR-012）
-* 协议配置 schema 在各自协议包，kernel 只提供 ConfigBase 基类。
-*/
-/** HTTP RPC 服务器默认端口（satori.chat 惯例 5500 区间，取 5500）。 */
-const DEFAULT_HTTP_PORT = 5500;
-/** WS 事件服务默认端口（satori.chat 惯例 5500 区间，取 5501）。 */
-const DEFAULT_WS_PORT = 5501;
-/** HTTP RPC 服务器实例（POST /v1/{resource}.{method}）。 */
-const httpServerSchema = createHttpServerSchema(DEFAULT_HTTP_PORT);
-/** WS 事件服务实例（/v1/events 信令，第三方 SDK 连入）。 */
-const wsServerSchema = createWsServerSchema(DEFAULT_WS_PORT);
-/** Satori 配置 schema。 */
-const satoriConfigSchema = z.object({
-	/** 鉴权 token（全局默认，实例未指定时继承）。 */
-	token: z.string().optional(),
-	/** 媒体资源（img/audio/video/file）下载缓存目录。 */
-	cacheDir: z.string().optional(),
-	/** HTTP RPC 服务器列表。 */
-	httpServers: z.array(httpServerSchema).default([]),
-	/** WS 事件服务列表。 */
-	wsServers: z.array(wsServerSchema).default([])
-});
-//#endregion
 //#region src/satori/types/event.ts
 /** 信令类型。 */
 const Opcode = {