@napuketto/kernel 0.0.6 → 0.0.7

package/dist/index.d.mts

@@ -55,6 +55,20 @@ interface PttElement {
   duration?: number;
   /** 语音转文字结果（translatePtt2Text 异步写回）。 */
   text?: string;
+  md5HexStr?: string;
+  fileSize?: string;
+  formatType?: number;
+  voiceType?: number;
+  voiceChangeType?: number;
+  canConvert2Text?: boolean;
+  waveAmplitudes?: number[];
+  fileSubId?: string;
+  playState?: number;
+  autoConvertText?: number;
+  storeID?: number;
+  otherBusinessInfo?: {
+    aiVoiceType: number;
+  };
 }
 /** 表情元素。 */
 interface FaceElement {
@@ -1436,14 +1450,34 @@ declare class MsgApi {
     msgId: string;
   }>;
   /**
-   * canonical 元素 → 发送元素，PIC 做 NapCat 式预处理。
+   * canonical 元素 → 发送元素，富媒体（PIC/PTT）做 NapCat 式预处理。
    * 2026-08-11 修复（实测）：图片发送必须 elementType=2（PIC）+ 完整 picElement
    * （md5HexStr/fileSize/fileName/sourcePath），且文件须经 getRichMediaFilePathForGuild
    * 计算目标路径 + util.copyFile 放置——缺任一环节 sendMsg 返回 rich media transfer failed。
+   * 2026-08-12（语音）：PTT 同理——只给 filePath 触发 wrapper 内部
+   * "Cannot convert undefined or null to object"（缺字段转换失败）。
    */
   private prepareSendElements;
   /** PIC 元素 NapCat 式预处理：md5 → 目标路径 → copyFile → 完整 picElement。 */
   private prepareImageElement;
+  /**
+   * PTT 元素 NapCat 式预处理：md5 → 目标路径 → copyFile → 完整 pttElement。
+   *
+   * 2026-08-12（实测依据）：只给 filePath 时 wrapper 内部抛
+   * "Cannot convert undefined or null to object"（缺 md5HexStr/fileSize 等字段），
+   * 且发送后进程崩溃重启（supervisor 自动拉起）。完整字段（NapCat 同款，
+   * formatType/voiceType/canConvert2Text/waveAmplitudes 等）消除该错误。
+   *
+   * ⚠️ silk 格式：QQ 语音协议为 silk v3。传入非 silk（ogg/mp3 等）时发送器
+   * 可能拒绝上传（待实测）。转换点预留：此处直接放置原文件，后续接入
+   * ogg → PCM → silk 编码器（外部 ffmpeg + silk-wasm，见 docs/design.md）。
+   */
+  private preparePttElement;
+  /**
+   * 富媒体文件放置（PIC/PTT 共用）：md5 + 文件名 → QQ 内部目标路径
+   * （getRichMediaFilePathForGuild）→ util.copyFile 放置 → 返回相对数据根路径。
+   */
+  private placeMediaFile;
   /** 注册 onMsgInfoListUpdate 确认监听（返回 Promise，resolve 时发送成功）。 */
   private confirmSend;
   /** 撤回消息（群聊管理员 / 私聊 2 分钟内）。 */

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/entities.ts","../src/types/services/msg-service.ts","../src/types/services/group-service.ts","../src/types/listeners/group.ts","../src/types/listeners/msg.ts","../src/types/message-element.ts","../src/types/services/buddy-service.ts","../src/types/services/profile-like-service.ts","../src/types/services/profile-service.ts","../src/types/services/richmedia-service.ts","../src/types/services/ticket-service.ts","../src/types/wrapper.ts","../src/apis/friend.ts","../src/apis/group.ts","../src/apis/group-notify.ts","../src/event-channel.ts","../src/bridge/msg-bridge.ts","../src/apis/msg.ts","../src/apis/stranger-info.ts","../src/apis/profile.ts","../src/apis/profile-like.ts","../src/apis/richmedia.ts","../src/apis/ticket.ts","../src/apis/webapi.ts","../src/bridge/group-bridge.ts","../src/cache/group-cache.ts","../src/infra/config.ts","../src/infra/errors.ts","../src/infra/logger.ts","../src/infra/paths.ts","../src/wrapper/wrapper-loader.ts","../src/login/login-connect.ts","../src/login/lifecycle.ts","../src/login/login.ts","../src/context.ts","../src/core.ts","../src/wrapper/probe/probe.ts","../src/wrapper/qq-data-path.ts","../src/wrapper/session-resolver.ts","../src/wrapper/wrapper-adapters.ts","../src/wrapper/wrapper-config.ts","../src/wrapper/wrapper-version.ts"],"mappings":";;;;;;;;;cAQa;WACT;WACA;WACA;WACA;WACA;;KAEQ,mBAAmB,uBAAuB;;UAGrC;EACb,UAAU;EACV;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;EAEA;;;UAIa;EACb;EACA;;;UAIa;EACb;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;;cAIS;WACT;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;KAEQ,yBAAyB,6BAA6B;;cAGrD;WACT;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;KAEQ,8BAA8B,kCAAkC;;UAG3D;EACb;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb,OAAO;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;IACI;IACA;IACA;MAAU;MAAc;MAAe;MAAe;;IACtD;MAAW;MAAc;MAAe;MAAe;;;;;UAK9C;EACb,iBAAiB;EACjB,gBAAgB;EAChB,eAAe;EACf,sBAAsB;EACtB;IAAe;IAAiB;IAAkB;;EAClD;IAAuB;IAAiB;;;;UAI3B;EACb;EACA;EACA,cAAc;EACd,aAAa;EACb,aAAa;EACb,cAAc;EACd,eAAe;EACf,eAAe;EACf,cAAc;EACd,iBAAiB;;EAEjB;IACI;IACA;IACA;;;;UAKS;EACb;EACA;EACA;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA,UAAU;EACV,UAAU;EACV;GACC;;;;;UC5LY;EACb;EACA;;;cAIS;WACT;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;KAEQ,sBAAsB,0BAA0B;;UAG3C;EACb,aAAa;EACb;EACA,cAAc;EACd,cAAc;EACd,eAAe;EACf,aAAa;E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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/entities.ts","../src/types/services/msg-service.ts","../src/types/services/group-service.ts","../src/types/listeners/group.ts","../src/types/listeners/msg.ts","../src/types/message-element.ts","../src/types/services/buddy-service.ts","../src/types/services/profile-like-service.ts","../src/types/services/profile-service.ts","../src/types/services/richmedia-service.ts","../src/types/services/ticket-service.ts","../src/types/wrapper.ts","../src/apis/friend.ts","../src/apis/group.ts","../src/apis/group-notify.ts","../src/event-channel.ts","../src/bridge/msg-bridge.ts","../src/apis/msg.ts","../src/apis/stranger-info.ts","../src/apis/profile.ts","../src/apis/profile-like.ts","../src/apis/richmedia.ts","../src/apis/ticket.ts","../src/apis/webapi.ts","../src/bridge/group-bridge.ts","../src/cache/group-cache.ts","../src/infra/config.ts","../src/infra/errors.ts","../src/infra/logger.ts","../src/infra/paths.ts","../src/wrapper/wrapper-loader.ts","../src/login/login-connect.ts","../src/login/lifecycle.ts","../src/login/login.ts","../src/context.ts","../src/core.ts","../src/wrapper/probe/probe.ts","../src/wrapper/qq-data-path.ts","../src/wrapper/session-resolver.ts","../src/wrapper/wrapper-adapters.ts","../src/wrapper/wrapper-config.ts","../src/wrapper/wrapper-version.ts"],"mappings":";;;;;;;;;cAQa;WACT;WACA;WACA;WACA;WACA;;KAEQ,mBAAmB,uBAAuB;;UAGrC;EACb,UAAU;EACV;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;EAEA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;IAAsB;;;;UAIT;EACb;EACA;;;UAIa;EACb;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;;cAIS;WACT;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;KAEQ,yBAAyB,6BAA6B;;cAGrD;WACT;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;KAEQ,8BAA8B,kCAAkC;;UAG3D;EACb;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb,OAAO;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;IACI;IACA;IACA;MAAU;MAAc;MAAe;MAAe;;IACtD;MAAW;MAAc;MAAe;MAAe;;;;;UAK9C;EACb,iBAAiB;EACjB,gBAAgB;EAChB,eAAe;EACf,sBAAsB;EACtB;IAAe;IAAiB;IAAkB;;EAClD;IAAuB;IAAiB;;;;UAI3B;EACb;EACA;EACA,cAAc;EACd,aAAa;EACb,aAAa;EACb,cAAc;EACd,eAAe;EACf,eAAe;EACf,cAAc;EACd,iBAAiB;;EAEjB;IACI;IACA;IACA;;;;UAKS;EACb;EACA;EACA;EACA;EACA;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA,UAAU;EACV,UAAU;EACV;GACC;;;;;UC1MY;EACb;EACA;;;cAIS;WACT;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;KAEQ,sBAAsB,0BA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"}

package/dist/index.mjs

@@ -1261,51 +1261,38 @@ var MsgApi = class {
 		return { msgId };
 	}
 	/**
-	* canonical 元素 → 发送元素，PIC 做 NapCat 式预处理。
+	* canonical 元素 → 发送元素，富媒体（PIC/PTT）做 NapCat 式预处理。
 	* 2026-08-11 修复（实测）：图片发送必须 elementType=2（PIC）+ 完整 picElement
 	* （md5HexStr/fileSize/fileName/sourcePath），且文件须经 getRichMediaFilePathForGuild
 	* 计算目标路径 + util.copyFile 放置——缺任一环节 sendMsg 返回 rich media transfer failed。
+	* 2026-08-12（语音）：PTT 同理——只给 filePath 触发 wrapper 内部
+	* "Cannot convert undefined or null to object"（缺字段转换失败）。
 	*/
 	async prepareSendElements(elements) {
 		const out = [];
-		for (const el of elements) {
-			if (el.type !== "image") {
-				out.push(...toSendElements([el]));
-				continue;
-			}
-			out.push(await this.prepareImageElement(el.path));
+		for (const el of elements) switch (el.type) {
+			case "image":
+				out.push(await this.prepareImageElement(el.path));
+				break;
+			case "voice":
+				out.push(await this.preparePttElement(el.path));
+				break;
+			default: out.push(...toSendElements([el]));
 		}
 		return out;
 	}
 	/** PIC 元素 NapCat 式预处理：md5 → 目标路径 → copyFile → 完整 picElement。 */
 	async prepareImageElement(path) {
-		const service = this.service;
-		const util = this.util;
-		const stat = await statFile(path);
+		const file = await statFile(path);
 		const md5 = await hashFile(path);
-		const fileSize = stat.size;
 		const fileName = basename(path);
-		const relPath = service.getRichMediaFilePathForGuild({
-			md5HexStr: md5,
-			fileName,
-			elementType: ElementType.PIC,
-			elementSubType: 0,
-			thumbSize: 0,
-			needCreate: true,
-			downloadType: 1,
-			file_uuid: ""
-		});
-		if (util !== null) {
-			const instance = typeof util.get === "function" ? util.get() : util;
-			const copy = instance["copyFile"];
-			if (typeof copy === "function") await copy.call(instance, path, relPath);
-		}
+		const relPath = await this.placeMediaFile(path, ElementType.PIC, md5, fileName);
 		return {
 			elementType: ElementType.PIC,
 			elementId: "",
 			picElement: {
 				md5HexStr: md5,
-				fileSize: String(fileSize),
+				fileSize: String(file.size),
 				picWidth: 0,
 				picHeight: 0,
 				fileName,
@@ -1320,6 +1307,86 @@ var MsgApi = class {
 			}
 		};
 	}
+	/**
+	* PTT 元素 NapCat 式预处理：md5 → 目标路径 → copyFile → 完整 pttElement。
+	*
+	* 2026-08-12（实测依据）：只给 filePath 时 wrapper 内部抛
+	* "Cannot convert undefined or null to object"（缺 md5HexStr/fileSize 等字段），
+	* 且发送后进程崩溃重启（supervisor 自动拉起）。完整字段（NapCat 同款，
+	* formatType/voiceType/canConvert2Text/waveAmplitudes 等）消除该错误。
+	*
+	* ⚠️ silk 格式：QQ 语音协议为 silk v3。传入非 silk（ogg/mp3 等）时发送器
+	* 可能拒绝上传（待实测）。转换点预留：此处直接放置原文件，后续接入
+	* ogg → PCM → silk 编码器（外部 ffmpeg + silk-wasm，见 docs/design.md）。
+	*/
+	async preparePttElement(path) {
+		const file = await statFile(path);
+		const md5 = await hashFile(path);
+		const fileName = basename(path);
+		const relPath = await this.placeMediaFile(path, ElementType.PTT, md5, fileName);
+		const duration = Math.max(1, Math.floor(file.size / 1024 / 3));
+		return {
+			elementType: ElementType.PTT,
+			elementId: "",
+			pttElement: {
+				fileName,
+				filePath: relPath,
+				md5HexStr: md5,
+				fileSize: String(file.size),
+				duration,
+				formatType: 1,
+				voiceType: 1,
+				voiceChangeType: 0,
+				canConvert2Text: true,
+				waveAmplitudes: [
+					0,
+					18,
+					9,
+					23,
+					16,
+					17,
+					16,
+					15,
+					44,
+					17,
+					24,
+					20,
+					14,
+					15,
+					17
+				],
+				fileSubId: "",
+				playState: 1,
+				autoConvertText: 0,
+				storeID: 0,
+				otherBusinessInfo: { aiVoiceType: 0 }
+			}
+		};
+	}
+	/**
+	* 富媒体文件放置（PIC/PTT 共用）：md5 + 文件名 → QQ 内部目标路径
+	* （getRichMediaFilePathForGuild）→ util.copyFile 放置 → 返回相对数据根路径。
+	*/
+	async placeMediaFile(path, elementType, md5, fileName) {
+		const service = this.service;
+		const util = this.util;
+		const relPath = service.getRichMediaFilePathForGuild({
+			md5HexStr: md5,
+			fileName,
+			elementType,
+			elementSubType: 0,
+			thumbSize: 0,
+			needCreate: true,
+			downloadType: 1,
+			file_uuid: ""
+		});
+		if (util !== null) {
+			const instance = typeof util.get === "function" ? util.get() : util;
+			const copy = instance["copyFile"];
+			if (typeof copy === "function") await copy.call(instance, path, relPath);
+		}
+		return relPath;
+	}
 	/** 注册 onMsgInfoListUpdate 确认监听（返回 Promise，resolve 时发送成功）。 */
 	confirmSend(msgId, target) {
 		const channel = this.channel;