@napuketto/adapter 0.0.21 → 0.1.0

package/dist/onebot11/index.d.mts

@@ -1,6 +1,6 @@
 import { i as ProtocolConfig, n as BaseProtocolAdapter, s as ActionRegistry, u as ErrorCodeMap } from "../index-CDKj-jus.mjs";
 import "../gray-tip-CcpfI1Og.mjs";
-import { BuddyEventChannel, CanonicalElement, ChatType, FriendApi, GroupApi, GroupCache, GroupEventChannel, GroupNotifyApi, MsgApi, MsgEventChannel, Peer, ProfileApi, ProfileLikeApi, RichMediaApi, TicketApi, WebApi } from "@napuketto/kernel";
+import { BuddyCacheEventChannel, BuddyEventChannel, CanonicalElement, ChatType, FriendApi, GroupApi, GroupCache, GroupEventChannel, GroupNotifyApi, MsgApi, MsgEventChannel, Peer, ProfileApi, ProfileLikeApi, RichMediaApi, TicketApi, WebApi } from "@napuketto/kernel";
 import { z } from "zod";
 import { EventBroadcaster, TransportAdapter } from "@napuketto/network";
 //#region src/onebot11/helper/message-unique.d.ts
@@ -182,6 +182,11 @@ type OB11MessageSegment = {
     file: string;
     url?: string;
   };
+} | {
+  type: "file";
+  data: {
+    file: string;
+  };
 } | {
   type: "reply";
   data: {
@@ -650,6 +655,7 @@ declare const ob11ConfigSchema: z.ZodObject<{
     array: "array";
     string: "string";
   }>>;
+  groupUploadAsNotice: z.ZodDefault<z.ZodBoolean>;
   httpServers: z.ZodDefault<z.ZodArray<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     host: z.ZodDefault<z.ZodString>;
@@ -712,6 +718,8 @@ interface OneBot11AdapterOptions extends OneBotApiOptions {
   groupChannel?: GroupEventChannel;
   /** kernel 好友事件通道（可选：Buddy/onBuddyReqChange → OB11 request 源）。 */
   friendChannel?: BuddyEventChannel;
+  /** 好友缓存 diff 通道（可选：BuddyCache/onBuddyAdded → OB11 friend_add 源，B2）。 */
+  buddyCacheEvents?: BuddyCacheEventChannel;
   /** 校准日志（可选：未知事件形状 raw JSON；IPC 模式传 loader pino 实例）。 */
   logger?: AdapterLoggerLike;
 }
@@ -721,6 +729,7 @@ declare class NapukettoOneBot11Adapter extends BaseProtocolAdapter<OB11Config> {
   private readonly msgChannel;
   private readonly groupChannel;
   private readonly friendChannel;
+  private readonly buddyCacheEvents;
   private readonly calibLogger;
   private readonly selfUin;
   private readonly oneBotApi;
@@ -731,6 +740,8 @@ declare class NapukettoOneBot11Adapter extends BaseProtocolAdapter<OB11Config> {
   private heartbeatTimer;
   private reportSelfMessage;
   private messageFormat;
+  /** 群文件报形式（B4）：true = fileElement 群消息报 group_upload notice 替代 message。 */
+  private groupUploadAsNotice;
   /** IPC 桥模式标记（subscribeOnly 启动；reload 时跳过传输重建）。 */
   private subscribedOnly;
   constructor(opts: OneBot11AdapterOptions);

package/dist/onebot11/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/onebot11/helper/message-unique.ts","../../src/onebot11/api/one-bot-api.ts","../../src/onebot11/action/error-map.ts","../../src/onebot11/action/group/get-group-at-all-remain.ts","../../src/onebot11/types/index.ts","../../src/onebot11/event/base.ts","../../src/onebot11/event/message.ts","../../src/onebot11/event/meta.ts","../../src/onebot11/event/notice.ts","../../src/onebot11/event/request.ts","../../src/onebot11/event/index.ts","../../src/onebot11/action/index.ts","../../src/onebot11/helper/codec/cqcode.ts","../../src/onebot11/helper/codec/segment.ts","../../src/onebot11/helper/config.ts","../../src/onebot11/helper/data.ts","../../src/onebot11/adapter.ts","../../src/onebot11/transport.ts"],"mappings":";;;;;;cAkBa;;mBAEQ;;mBAEA;;mBAEA;;UAET;;mBAES;;;;;EAMjB,MAAM,eAAe,OAAO;;EAmB5B,SAAS;;EAKT,aAAa;;EAKb,QAAQ,gBAAgB;;EAKxB,QAAQ;;UAYA;;;;;UCvDK;;EAEb;;EAEA,mBAAmB;;EAEnB;;EAEA;;EAEA,aAAa;;EAEb,gBAAgB;;;UAIH;EACb,QAAQ;EACR,UAAU;EACV,gBAAgB;EAChB,WAAW;EACX,WAAW;EACX,cAAc;EACd,YAAY;EACZ,gBAAgB;EAChB,QAAQ;;EAER;IAAQ;IAAa;;;EAErB,QAAQ;;EAER,aAAa;;;;;;cAOJ;;WAEA,QAAQ;;WAER,UAAU;;WAEV,gBAAgB;;WAEhB,WAAW;;WAEX,WAAW;;WAEX,cAAc;;WAEd,YAAY;;WAEZ,gBAAgB;;WAEhB,QAAQ;;WAER,YAAY;;WAEZ,eAAe;;WAEf;IAAQ;IAAa;;;WAErB;;WAEA;;WAEA,mBAAmB;;WAEnB;;WAEA;;WAEA,aAAa;;WAEb,gBAAgB;EAEzB,YAAY,MAAM;;EAuBlB,SAAS,iBAAiB,QAAQ;;EAKlC,SAAS,iBAAiB,QAAQ;;;;;cCzHzB,kBAAkB;;;;UCMd;EACb;EACA;EACA;;;;;;;;;UCba,WAAW;EACxB;EACA;EACA,MAAM;EACN;EACA;;;KAIQ;EACJ;EAAc;IAAQ;;;EACtB;EAAY;IAAQ;IAAY;;;EAChC;EAAc;IAAQ;;;EACtB;EAAe;IAAQ;IAAc;;;EACrC;EAAgB;IAAQ;IAAc;;;EACtC;EAAe;IAAQ;IAAc;;;EACrC;EAAe;IAAQ;;;EACvB;EAAiB;IAAQ;;;EACzB;EAAc;IAAQ;;;EACtB;EAAa;IAAQ;;;EACrB;EAAgB;IAAQ;;;;KAGpB,uBAAuB;;UAGlB;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;;;UAIa;EACb;EACA;EACA;EACA;IACI;IACA;IACA;IACA;;EAEJ;EACA,SAAS;EACT;EACA;EACA;;;KAIQ;;UAGK;EACb;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA;EACA,MAAM;EACN;;EAEA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA,oBAAoB;EACpB,gBAAgB;EAChB,gBAAgB;EAChB,aAAa;EACb,oBAAoB;EACpB,cAAc;;;UAID;EACb;EACA;EACA;;EAEA;EACA;EACA;EACA,eAAe;EACf,gBAAgB;EAChB;;;;;;;;;;;;KCrJQ;;UAGK;;EAEb;;EAEA;;EAEA,WAAW;;;;;UCPE;EACb;EACA;EACA;;;UAIa,oBAAoB;EACjC;EACA;;;UAIa,8BAA8B;EAC3C;EACA;;EAEA;EACA;EACA;EACA;EACA,SAAS;EACT;EACA;EACA,QAAQ;EACR,YAAY;;;UAIC,gCAAgC;EAC7C;EACA;;EAEA;EACA;EACA;EACA,SAAS;EACT;EACA;EACA,QAAQ;;EAER;;;KAIQ,mBAAmB,wBAAwB;;;;UC9CtC;EACb;EACA;GACC;;;UAIY,+BAA+B;EAC5C;EACA;EACA;;;UAIa,+BAA+B;EAC5C;EACA;;EAEA;EACA,QAAQ;;;KAIA,gBAAgB,yBAAyB;;;;UCvBpC;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA;EACA,MAAM;;;UAIO,kCAAkC;EAC/C;EACA;EACA;EACA;EACA;;;UAIa,qCAAqC;EAClD;EACA;EACA;EACA;EACA;EACA;;;UAIa,qCAAqC;EAClD;EACA;EACA;EACA;EACA;EACA;;;UAIa,gCAAgC;EAC7C;EACA;EACA;EACA;EACA;EACA;;EAEA;;;UAIa,iCAAiC;EAC9C;EACA;EACA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;;;UAIa,iCAAiC;EAC9C;EACA;EACA;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIa,8BAA8B;EAC3C;EACA;EACA;EACA;EACA;EACA;;EAEA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA,MAAM;;;UAIO,iCAAiC;EAC9C;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;EACA;EACA,OAAO;;;UAIM,kCAAkC;EAC/C;EACA;EACA;EACA;EACA;;;KAIQ,kBACN,6BACA,4BACA,+BACA,+BACA,0BACA,2BACA,6BACA,8BACA,2BACA,8BACA,wBACA,6BACA,2BACA,8BACA;;;;UCpLW,+BAA+B;EAC5C;EACA;EACA;;EAEA;;EAEA;;;UAIa,8BAA8B;EAC3C;EACA;;EAEA;EACA;EACA;EACA;EACA;;;KAIQ,mBAAmB,yBAAyB;;;;KCiB5C,YAAY,mBAAoB,kBAAmB,mBAAoB;;;;UCyDlE;;EAEb,KAAK;;;iBAIO,yBAAyB,MAAM,iBAAiB;;;;;;;;;;;;;;UC9E/C;EACb;EACA,QAAQ;;;iBAII,aAAa;;iBAKb,cAAc;;iBAKd,eAAe;;iBASf,aACZ,cACA,QAAQ;;iBAeI,eAAe,eAAe,eAAe;;iBAkB7C,iBAAiB,OAAO,eAAe;;;;iBC4GvC,oBAAoB,UAAU;;;;cC9IjC,kBAAgB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiB3B,EAAA,KAAA;;KAGU,aAAa,EAAE,aAAa;;;;iBCzDxB,oBAAoB,UAAU,qBAAqB;;iBAYnD,oBAAoB,UAAU,uBAAuB;;iBAoIrD,oBAAoB,eAAe;;iBAkBnC,qBAAqB,UAAU;;iBAK/B,qBAAqB,eAAe;;;;UChJnC;EACb,KAAK,cAAc;EACnB,KAAK,cAAc;;;UAIN,+BAA+B;;EAE5C,QAAQ,eAAe;;EAEvB,aAAa;;EAEb,YAAY;;EAEZ,eAAe;;EAEf,gBAAgB;;EAEhB,SAAS;;;cAIA,iCAAiC,oBAAoB;WACrD;mBAEQ;mBACA;mBACA;mBACA;mBACA;mBACA;;WAER,UAAU;UACX;UACA;UACA;UACA;UACA;;UAEA;EAER,YAAY,MAAM;;;;;UAuBJ;;UAWA;;UAwCN;;UAiBM;;UAaN;;;;;;EAsEF,iBAAiB;;EASvB;;;;;;UAUc;;UA2BA;;UAiBA;;UA4BA;;UAiBN;;;;;EAWF,cAAc,cAAc,UAAU,wBAAwB;;;;;UC9TvD;;EAEb,SAAS;;EAET,YAAY;;EAEZ,aAAa;;;UAIA;;EAEb,QAAQ;;EAER,aAAa;;EAEb,gBAAgB,cAAc,UAAU;;EAExC;;;iBAiBY,uBAAuB,MAAM,gCAAgC"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/onebot11/helper/message-unique.ts","../../src/onebot11/api/one-bot-api.ts","../../src/onebot11/action/error-map.ts","../../src/onebot11/action/group/get-group-at-all-remain.ts","../../src/onebot11/types/index.ts","../../src/onebot11/event/base.ts","../../src/onebot11/event/message.ts","../../src/onebot11/event/meta.ts","../../src/onebot11/event/notice.ts","../../src/onebot11/event/request.ts","../../src/onebot11/event/index.ts","../../src/onebot11/action/index.ts","../../src/onebot11/helper/codec/cqcode.ts","../../src/onebot11/helper/codec/segment.ts","../../src/onebot11/helper/config.ts","../../src/onebot11/helper/data.ts","../../src/onebot11/adapter.ts","../../src/onebot11/transport.ts"],"mappings":";;;;;;cAkBa;;mBAEQ;;mBAEA;;mBAEA;;UAET;;mBAES;;;;;EAMjB,MAAM,eAAe,OAAO;;EAmB5B,SAAS;;EAKT,aAAa;;EAKb,QAAQ,gBAAgB;;EAKxB,QAAQ;;UAYA;;;;;UCvDK;;EAEb;;EAEA,mBAAmB;;EAEnB;;EAEA;;EAEA,aAAa;;EAEb,gBAAgB;;;UAIH;EACb,QAAQ;EACR,UAAU;EACV,gBAAgB;EAChB,WAAW;EACX,WAAW;EACX,cAAc;EACd,YAAY;EACZ,gBAAgB;EAChB,QAAQ;;EAER;IAAQ;IAAa;;;EAErB,QAAQ;;EAER,aAAa;;;;;;cAOJ;;WAEA,QAAQ;;WAER,UAAU;;WAEV,gBAAgB;;WAEhB,WAAW;;WAEX,WAAW;;WAEX,cAAc;;WAEd,YAAY;;WAEZ,gBAAgB;;WAEhB,QAAQ;;WAER,YAAY;;WAEZ,eAAe;;WAEf;IAAQ;IAAa;;;WAErB;;WAEA;;WAEA,mBAAmB;;WAEnB;;WAEA;;WAEA,aAAa;;WAEb,gBAAgB;EAEzB,YAAY,MAAM;;EAuBlB,SAAS,iBAAiB,QAAQ;;EAKlC,SAAS,iBAAiB,QAAQ;;;;;cCzHzB,kBAAkB;;;;UCMd;EACb;EACA;EACA;;;;;;;;;UCba,WAAW;EACxB;EACA;EACA,MAAM;EACN;EACA;;;KAIQ;EACJ;EAAc;IAAQ;;;EACtB;EAAY;IAAQ;IAAY;;;EAChC;EAAc;IAAQ;;;EACtB;EAAe;IAAQ;IAAc;;;EACrC;EAAgB;IAAQ;IAAc;;;EACtC;EAAe;IAAQ;IAAc;;;EACrC;EAAc;IAAQ;;;EACtB;EAAe;IAAQ;;;EACvB;EAAiB;IAAQ;;;EACzB;EAAc;IAAQ;;;EACtB;EAAa;IAAQ;;;EACrB;EAAgB;IAAQ;;;;KAGpB,uBAAuB;;UAGlB;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;;;UAIa;EACb;EACA;EACA;EACA;IACI;IACA;IACA;IACA;;EAEJ;EACA,SAAS;EACT;EACA;EACA;;;KAIQ;;UAGK;EACb;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA;EACA,MAAM;EACN;;EAEA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA,oBAAoB;EACpB,gBAAgB;EAChB,gBAAgB;EAChB,aAAa;EACb,oBAAoB;EACpB,cAAc;;;UAID;EACb;EACA;EACA;;EAEA;EACA;EACA;EACA,eAAe;EACf,gBAAgB;EAChB;;;;;;;;;;;;KCtJQ;;UAGK;;EAEb;;EAEA;;EAEA,WAAW;;;;;UCPE;EACb;EACA;EACA;;;UAIa,oBAAoB;EACjC;EACA;;;UAIa,8BAA8B;EAC3C;EACA;;EAEA;EACA;EACA;EACA;EACA,SAAS;EACT;EACA;EACA,QAAQ;EACR,YAAY;;;UAIC,gCAAgC;EAC7C;EACA;;EAEA;EACA;EACA;EACA,SAAS;EACT;EACA;EACA,QAAQ;;EAER;;;KAIQ,mBAAmB,wBAAwB;;;;UC9CtC;EACb;EACA;GACC;;;UAIY,+BAA+B;EAC5C;EACA;EACA;;;UAIa,+BAA+B;EAC5C;EACA;;EAEA;EACA,QAAQ;;;KAIA,gBAAgB,yBAAyB;;;;UCvBpC;EACb;EACA;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa;EACb;EACA;EACA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA;EACA,MAAM;;;UAIO,kCAAkC;EAC/C;EACA;EACA;EACA;EACA;;;UAIa,qCAAqC;EAClD;EACA;EACA;EACA;EACA;EACA;;;UAIa,qCAAqC;EAClD;EACA;EACA;EACA;EACA;EACA;;;UAIa,gCAAgC;EAC7C;EACA;EACA;EACA;EACA;EACA;;EAEA;;;UAIa,iCAAiC;EAC9C;EACA;EACA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;;;UAIa,iCAAiC;EAC9C;EACA;EACA;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIa,8BAA8B;EAC3C;EACA;EACA;EACA;EACA;EACA;;EAEA;;;UAIa,mCAAmC;EAChD;EACA;EACA;EACA,MAAM;;;UAIO,iCAAiC;EAC9C;EACA;EACA;EACA;;;UAIa,oCAAoC;EACjD;EACA;EACA;EACA;EACA;EACA,OAAO;;;UAIM,kCAAkC;EAC/C;EACA;EACA;EACA;EACA;;;KAIQ,kBACN,6BACA,4BACA,+BACA,+BACA,0BACA,2BACA,6BACA,8BACA,2BACA,8BACA,wBACA,6BACA,2BACA,8BACA;;;;UCpLW,+BAA+B;EAC5C;EACA;EACA;;EAEA;;EAEA;;;UAIa,8BAA8B;EAC3C;EACA;;EAEA;EACA;EACA;EACA;EACA;;;KAIQ,mBAAmB,yBAAyB;;;;KCiB5C,YAAY,mBAAoB,kBAAmB,mBAAoB;;;;UCyDlE;;EAEb,KAAK;;;iBAIO,yBAAyB,MAAM,iBAAiB;;;;;;;;;;;;;;UC9E/C;EACb;EACA,QAAQ;;;iBAII,aAAa;;iBAKb,cAAc;;iBAKd,eAAe;;iBASf,aACZ,cACA,QAAQ;;iBAeI,eAAe,eAAe,eAAe;;iBAkB7C,iBAAiB,OAAO,eAAe;;;;iBCsHvC,oBAAoB,UAAU;;;;cCxJjC,kBAAgB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuB3B,EAAA,KAAA;;KAGU,aAAa,EAAE,aAAa;;;;iBC/DxB,oBAAoB,UAAU,qBAAqB;;iBAYnD,oBAAoB,UAAU,uBAAuB;;iBAoIrD,oBAAoB,eAAe;;iBAkBnC,qBAAqB,UAAU;;iBAK/B,qBAAqB,eAAe;;;;UCvInC;EACb,KAAK,cAAc;EACnB,KAAK,cAAc;;;UAIN,+BAA+B;;EAE5C,QAAQ,eAAe;;EAEvB,aAAa;;EAEb,YAAY;;EAEZ,eAAe;;EAEf,gBAAgB;;EAEhB,mBAAmB;;EAEnB,SAAS;;;cAIA,iCAAiC,oBAAoB;WACrD;mBAEQ;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;;WAER,UAAU;UACX;UACA;UACA;UACA;UACA;;UAEA;;UAEA;EAER,YAAY,MAAM;;;;;UAwBJ;;UAYA;;UAyCN;;UAiBM;;UAaN;;;;;;EAoIF,iBAAiB;;EAUvB;;;;;;UAUc;;UA2BA;;UAiBA;;UA4BA;;UAiBN;;;;;EAWF,cAAc,cAAc,UAAU,wBAAwB;;;;;UC9YvD;;EAEb,SAAS;;EAET,YAAY;;EAEZ,aAAa;;;UAIA;;EAEb,QAAQ;;EAER,aAAa;;EAEb,gBAAgB,cAAc,UAAU;;EAExC;;;iBAiBY,uBAAuB,MAAM,gCAAgC"}

package/dist/onebot11/index.mjs

@@ -1536,6 +1536,10 @@ const CANONICAL_TO_SEGMENT = {
 		type: "video",
 		data: mediaData(el.path, el.url)
 	}),
+	file: (el) => ({
+		type: "file",
+		data: { file: el.name ?? el.path }
+	}),
 	reply: (el) => ({
 		type: "reply",
 		data: { id: el.messageId }
@@ -1626,6 +1630,10 @@ const CQ_SEGMENT_BUILDERS = {
 		type: "video",
 		data: mediaData(params["file"] ?? "", params["url"])
 	}),
+	file: (params) => ({
+		type: "file",
+		data: { file: params["file"] ?? "" }
+	}),
 	reply: (params) => ({
 		type: "reply",
 		data: { id: params["id"] ?? "" }
@@ -1721,6 +1729,12 @@ const ob11ConfigSchema = z.object({
 	reportSelfMessage: z.boolean().default(false),
 	/** 消息内容格式：array = 消息段数组（标准），string = CQ 码字符串。 */
 	messagePostFormat: z.enum(MESSAGE_FORMATS).default("array"),
+	/**
+	* 群文件报形式（B4，2026-09-08）：false（缺省）= message 事件 + file 段
+	* （go-cqhttp 兼容;此前 file 元素被静默丢弃,本版本起透出）；true = 含
+	* fileElement 的群消息改报 group_upload notice 事件（替代 message 事件）。
+	*/
+	groupUploadAsNotice: z.boolean().default(false),
 	/** HTTP 反向服务器列表。 */
 	httpServers: z.array(httpServerSchema).default([]),
 	/** HTTP 正向上报列表。 */
@@ -1855,7 +1869,7 @@ function cqMessageToCanonical(text) {
 //#endregion
 //#region src/onebot11/helper/message-info.ts
 /** 毫秒 → 秒（Unix 时间戳）。 */
-const MS_TO_SEC$4 = 1e3;
+const MS_TO_SEC$5 = 1e3;
 /** RawMessage → OB11 消息信息（message_id 经 MessageUnique 映射）。
 * ctx（可选）：接收方向 ID 转换上下文（at uid→uin、reply NT msgId→OB11 id，P2-19）。 */
 function toOb11MessageInfo(msg, unique, ctx = {}) {
@@ -1872,7 +1886,7 @@ function toOb11MessageInfo(msg, unique, ctx = {}) {
 			user_id: Number(msg.senderUin),
 			nickname: msg.sendNickName
 		},
-		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$4),
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$5),
 		message: canonicalToSegments(elements),
 		raw_message: canonicalToCqMessage(elements)
 	};
@@ -1886,27 +1900,14 @@ function toOb11MessageInfo(msg, unique, ctx = {}) {
 }
 //#endregion
 //#region src/onebot11/helper/notice.ts
-/**
-* OB11 notice 事件翻译（P2-7，2026-08-05；2026-09-08 T4 补全）
-*
-* NT QQ 中群成员变动/撤回等系统事件通过**消息的灰色提示元素（grayTip）**广播。
-* 本模块把 RawMessage 里的 grayTip 翻译为 OB11 notice 事件（纯函数，ADR-008）。
-*
-* 支持：
-*  - group_recall（群撤回，grayTip.subElementType=REVOKE + chatType=GROUP）
-*  - friend_recall（好友撤回，REVOKE + chatType=C2C，2026-09-08）
-*  - group_increase / group_decrease（群成员变动，subElementType=GROUP + TipGroupElement.type）
-*  - group_admin（管理员变更，TipGroupElement.type=BLOCK/UNBLOCK 的 role 语义）
-*  - group_ban（禁言，TipGroupElement.type=SHUT_UP）
-*  - notify.poke（戳一戳，aioOpGrayTipElement；⚠️ 待真实 poke 事件验证，2026-09-08）
-*
-* 未知/未翻译的 grayTip 子类型（JSON/BUDDY/ESSENCE/GROUP_NOTIFY 等）打 raw JSON
-* 日志（ctx.logger 可选）——为后续真实事件校准积累数据。
-*
-* user_id/operator_id 都是 uin：接收 uidToUin Map（调用方批量转换后传入，保持纯函数）。
-*/
 /** 毫秒 → 秒（Unix 时间戳）。 */
-const MS_TO_SEC$3 = 1e3;
+const MS_TO_SEC$4 = 1e3;
+/** 群文件业务类型（group_upload 的 file.busid,与 kernel 群文件系列同源语义）。 */
+const GROUP_FILE_BUS_ID = 102;
+/** 检查消息是否含文件元素（group_upload 开关分支判定）。 */
+function hasFileElement(msg) {
+	return msg.elements.some((el) => el.fileElement !== void 0);
+}
 /** 检查消息是否含可翻译的 grayTip 元素。 */
 function hasGrayTip(msg) {
 	return msg.elements.some((el) => el.grayTipElement !== void 0);
@@ -1919,7 +1920,7 @@ function toUin$1(uid, ctx) {
 /** 基础字段（time/self_id/post_type）。 */
 function base(msg, ctx) {
 	return {
-		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$4),
 		self_id: Number(ctx.selfUin),
 		post_type: "notice",
 		group_id: Number(msg.peerUid)
@@ -1930,7 +1931,7 @@ function toRecall(msg, g, ctx) {
 	if (g?.revokeElement === void 0) return null;
 	const revoke = g.revokeElement;
 	if (msg.chatType === ChatType.C2C) return {
-		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$4),
 		self_id: Number(ctx.selfUin),
 		post_type: "notice",
 		notice_type: "friend_recall",
@@ -1958,7 +1959,7 @@ function toPoke(msg, g, ctx) {
 	ctx.logger?.warn({ raw: JSON.stringify(g)?.slice(0, 2e3) }, "ob11: poke grayTip raw（待真实事件校准）");
 	const isGroup = msg.chatType === ChatType.GROUP;
 	return {
-		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$4),
 		self_id: Number(ctx.selfUin),
 		post_type: "notice",
 		notice_type: "notify",
@@ -1973,7 +1974,7 @@ function toGroupChange(msg, g, ctx) {
 	const grp = g?.groupElement;
 	if (grp === void 0 || grp.type === void 0) return null;
 	const common = {
-		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$3),
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$4),
 		selfId: Number(ctx.selfUin),
 		groupId: Number(msg.peerUid),
 		memberUid: grp.memberUid ?? "",
@@ -2045,6 +2046,45 @@ function toBan(common, grp, ctx) {
 		duration: Number(shutUp?.duration ?? 0)
 	};
 }
+/**
+* 好友添加（friend_add，B2，2026-09-08）。
+* 数据源 = kernel BuddyCache 快照 diff（Buddy/onBuddyListChange 全量快照对比，
+* 首帧 baseline 不发）——非 grayTip 路径。user_id 取 coreInfo.uin（顶层 uin 兜底）。
+*/
+function toFriendAdd(entry, selfUin) {
+	const uin = entry.coreInfo?.uin ?? entry.uin ?? "";
+	return {
+		time: Math.floor(Date.now() / MS_TO_SEC$4),
+		self_id: Number(selfUin),
+		post_type: "notice",
+		notice_type: "friend_add",
+		user_id: Number(uin)
+	};
+}
+/**
+* 群文件上传（group_upload，B4，2026-09-08）。
+* 数据源 = 含 fileElement 的群消息（开关 groupUploadAsNotice=true 时替代
+* message 事件报出）。file.id 取 fileUuid（缺省文件名）、size 取 fileSize、
+* busid 固定 102（群文件业务类型，与 kernel GROUP_FILE_BIZ_TYPE 同源语义）。
+*/
+function toGroupUpload(msg, selfUin) {
+	const file = msg.elements.find((e) => e.fileElement !== void 0)?.fileElement;
+	if (file === void 0) return null;
+	return {
+		time: Math.floor(Number(msg.msgTime) / MS_TO_SEC$4),
+		self_id: Number(selfUin),
+		post_type: "notice",
+		notice_type: "group_upload",
+		group_id: Number(msg.peerUid),
+		user_id: Number(msg.senderUin),
+		file: {
+			id: file.fileUuid ?? file.fileName ?? "",
+			name: file.fileName ?? "",
+			size: Number(file.fileSize ?? 0),
+			busid: GROUP_FILE_BUS_ID
+		}
+	};
+}
 /** 单个 grayTip 元素 → notice 事件（null = 不可翻译；未知子类型打 raw 日志）。 */
 function translateGrayTip(msg, g, ctx) {
 	const subType = g.subElementType;
@@ -2086,7 +2126,7 @@ function toOb11NoticeEvent(msg, ctx) {
 * narrowBuddyReqs 防御性收窄，未知形状返回 null 由调用方打 raw 日志积累校准数据。
 */
 /** 毫秒 → 秒（Unix 时间戳）。 */
-const MS_TO_SEC$2 = 1e3;
+const MS_TO_SEC$3 = 1e3;
 /** uid → uin（上下文映射缺省时：数字 uid 直取数值，非数字 uid 返回 0 表示未知）。 */
 function toUin(uid, ctx) {
 	if (uid === void 0 || uid === "") return 0;
@@ -2116,7 +2156,7 @@ function toOb11GroupRequestEvent(notify, ctx) {
 		default: return null;
 	}
 	return {
-		time: Math.floor(Date.now() / MS_TO_SEC$2),
+		time: Math.floor(Date.now() / MS_TO_SEC$3),
 		self_id: Number(ctx.selfUin),
 		post_type: "request",
 		request_type: "group",
@@ -2152,7 +2192,7 @@ function narrowBuddyReqs(arg) {
 function toOb11FriendRequestEvent(req, ctx) {
 	const words = req["words"];
 	return {
-		time: Math.floor(Date.now() / MS_TO_SEC$2),
+		time: Math.floor(Date.now() / MS_TO_SEC$3),
 		self_id: Number(ctx.selfUin),
 		post_type: "request",
 		request_type: "friend",
@@ -2293,16 +2333,17 @@ var GetGroupMsgHistoryAction = class extends BaseAction {
 //#endregion
 //#region src/onebot11/action/message/get-media.ts
 /**
-* get_image / get_record 动作：获取图片/语音文件（P2-14；2026-09-08 T5 接主动下载）
+* get_image / get_record 动作：获取图片/语音文件（P2-14；2026-09-08 T5 接主动下载；
+* 2026-09-08 B1 语音接原生 downloadRichMedia）
 *
 * message_id 反查 → fetchMsgsByMsgId → 找 PIC/PTT 元素：
 *  - 本地文件解析：NT 相对路径（sourcePath/filePath）按 mediaBaseDir（QQ NT
 *    global 目录）解析为绝对路径，命中磁盘即返回 file
 *  - 图片主动下载：本地未命中且有 picUrl → @napuketto/media downloadUrl 落
 *    cacheDir/media/，返回 file（绝对路径）+ url + file_size/file_name
-*  - 语音下载缺口：原生 downloadRichMedia 签名未探测（wrapper 字符串证据仅
-*    方法名），本地未命中时返回原始 filePath（NT 相对）+ 元数据，待 T10 diag
-*    实测后接入
+*  - 语音主动下载（B1）：本地未命中 → kernel MsgApi.downloadPtt（原生
+*    downloadRichMedia + 轮询元素回查）→ filePath 落盘后返回绝对路径；
+*    失败回退原始 filePath（NT 相对/绝对）+ 元数据，不抛错
 */
 const getMediaSchema = z.object({
 	/** CQ 码 file 字段或 message_id（简化：message_id 反查）。 */
@@ -2390,7 +2431,7 @@ var GetImageAction = class extends BaseAction {
 		return base;
 	}
 };
-/** 获取语音信息（本地文件解析；主动下载缺口见文件头注释）。 */
+/** 获取语音信息（本地优先；未命中走原生 downloadRichMedia，失败回退原始路径）。 */
 var GetRecordAction = class extends BaseAction {
 	name = "get_record";
 	schema = getMediaSchema;
@@ -2401,15 +2442,37 @@ var GetRecordAction = class extends BaseAction {
 		this.deps = deps;
 	}
 	async _handle(payload) {
-		return await resolveMedia(takeId(payload, "get_record"), "语音", this.deps, (el) => {
-			const ptt = el.pttElement;
-			if (ptt === void 0 || ptt.filePath === void 0) return;
-			const out = {};
-			if (ptt.fileSize !== void 0) out.file_size = ptt.fileSize;
-			if (ptt.fileName !== void 0) out.file_name = ptt.fileName;
-			out.file = resolveLocalMediaFile(ptt.filePath, this.deps) ?? ptt.filePath;
-			return out;
+		const id = takeId(payload, "get_record");
+		const { msgId, peer } = resolveMsgIdAndPeer(id, this.deps.messageUnique);
+		const [first] = await this.deps.msgApi.fetchMsgsByMsgId(peer, [msgId]);
+		if (first === void 0) throw kernelError(`消息 ${id} 不存在或已被撤回`, "NOT_FOUND");
+		const ptt = first.elements.find((e) => e.pttElement !== void 0)?.pttElement;
+		if (ptt === void 0 || ptt.filePath === void 0) throw kernelError(`消息 ${id} 不包含语音`, "NOT_FOUND");
+		const meta = () => ({
+			...ptt.fileSize !== void 0 ? { file_size: ptt.fileSize } : {},
+			...ptt.fileName !== void 0 ? { file_name: ptt.fileName } : {}
 		});
+		const local = resolveLocalMediaFile(ptt.filePath, this.deps);
+		if (local !== null) return {
+			...meta(),
+			file: local
+		};
+		try {
+			const downloaded = await this.deps.msgApi.downloadPtt(msgId, peer);
+			const rel = downloaded.filePath;
+			if (rel !== void 0 && rel !== "") {
+				const localAfter = resolveLocalMediaFile(rel, this.deps);
+				if (localAfter !== null) return {
+					...downloaded.fileSize !== void 0 ? { file_size: downloaded.fileSize } : {},
+					...downloaded.fileName !== void 0 ? { file_name: downloaded.fileName } : {},
+					file: localAfter
+				};
+			}
+		} catch {}
+		return {
+			...meta(),
+			file: ptt.filePath
+		};
 	}
 };
 //#endregion
@@ -3504,14 +3567,14 @@ var OneBotApi = class {
 //#endregion
 //#region src/onebot11/helper/message-event.ts
 /** 毫秒 → 秒（Unix 时间戳）。 */
-const MS_TO_SEC$1 = 1e3;
+const MS_TO_SEC$2 = 1e3;
 /** RawMessage → OB11 消息事件（message_id 经 MessageUnique 映射并记录 peer）。
 * messageFormat 决定 message 字段格式：array = 消息段数组（标准），string = CQ 码字符串。
 * ctx（可选）：接收方向 ID 转换上下文（at uid→uin、reply NT msgId→OB11 id，P2-19）。 */
 function toOb11MessageEvent(msg, selfUin, unique, messageFormat = "array", ctx = {}) {
 	const elements = applyReceiveContext(toCanonicalElements(msg), ctx);
 	const segments = canonicalToSegments(elements);
-	const time = Math.floor(Number(msg.msgTime) / MS_TO_SEC$1);
+	const time = Math.floor(Number(msg.msgTime) / MS_TO_SEC$2);
 	const selfId = Number(selfUin);
 	const userId = Number(msg.senderUin);
 	const base = {
@@ -3557,6 +3620,80 @@ function toOb11MessageEvent(msg, selfUin, unique, messageFormat = "array", ctx =
 	};
 }
 //#endregion
+//#region src/onebot11/helper/notice-extra.ts
+/** 毫秒 → 秒（Unix 时间戳）。 */
+const MS_TO_SEC$1 = 1e3;
+/** 候选 uin 字段（按优先级取第一个数字串；uid 串不硬转——待校准）。 */
+function pickUin(item) {
+	for (const key of [
+		"senderUin",
+		"fromUin",
+		"peerUin"
+	]) {
+		const v = item[key];
+		if (typeof v === "string" && v !== "" && Number.isFinite(Number(v))) return v;
+	}
+	return "0";
+}
+/** 候选 url 字段（fileUrl / url；未知为空串）。 */
+function pickUrl(item) {
+	for (const key of ["fileUrl", "url"]) {
+		const v = item[key];
+		if (typeof v === "string" && v !== "") return v;
+	}
+	return "";
+}
+/** 单个候选对象 → 归一化项（不可识别返回 null）。接受两类形状：
+*  ① RawMessage 型（elements[].fileElement——离线文件以消息推送到达的假设，
+*     与 onRecvOfflineFileMsg 挂在 MsgService、UpdateC2CFileMsg 字符串一致）
+*  ② 专用实体型（顶层 fileName 或 fileInfo.fileName——getNewOfflineFileList 族） */
+function narrowItem(item) {
+	if (typeof item !== "object" || item === null) return null;
+	const obj = item;
+	if (Array.isArray(obj["elements"])) {
+		const file = obj["elements"].find((e) => typeof e === "object" && e !== null && "fileElement" in e)?.fileElement;
+		if (file === void 0) return null;
+		return {
+			senderUin: pickUin(obj),
+			name: typeof file["fileName"] === "string" ? file["fileName"] : "",
+			size: Number(file["fileSize"] ?? 0),
+			url: pickUrl(file)
+		};
+	}
+	const file = obj["fileInfo"] ?? obj;
+	if (typeof file["fileName"] !== "string") return null;
+	return {
+		senderUin: pickUin(obj),
+		name: file["fileName"],
+		size: Number(file["fileSize"] ?? 0),
+		url: pickUrl(file)
+	};
+}
+/**
+* onRecvOfflineFileMsg 参数 → 归一化项列表（防御性收窄）。
+* 接受数组 / 单对象；全部不可识别返回 null（调用方打 raw 日志）。
+* 空数组同样返回 null（无文件可翻译，与未知形状同走日志路径无害）。
+*/
+function narrowOfflineFiles(arg) {
+	const narrowed = (Array.isArray(arg) ? arg : [arg]).map(narrowItem).filter((v) => v !== null);
+	return narrowed.length > 0 ? narrowed : null;
+}
+/** 归一化项 → OB11 offline_file notice（time 取当前时刻，friend_add 同款）。 */
+function toOfflineFileNotice(item, selfUin) {
+	return {
+		time: Math.floor(Date.now() / MS_TO_SEC$1),
+		self_id: Number(selfUin),
+		post_type: "notice",
+		notice_type: "offline_file",
+		user_id: Number(item.senderUin),
+		file: {
+			name: item.name,
+			size: item.size,
+			url: item.url
+		}
+	};
+}
+//#endregion
 //#region src/onebot11/transport.ts
 /**
 * OB11 传输装配（P2-5，2026-08-05）
@@ -3711,6 +3848,7 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 	msgChannel;
 	groupChannel;
 	friendChannel;
+	buddyCacheEvents;
 	calibLogger;
 	selfUin;
 	oneBotApi;
@@ -3721,6 +3859,8 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 	heartbeatTimer = null;
 	reportSelfMessage = false;
 	messageFormat = "array";
+	/** 群文件报形式（B4）：true = fileElement 群消息报 group_upload notice 替代 message。 */
+	groupUploadAsNotice = false;
 	/** IPC 桥模式标记（subscribeOnly 启动；reload 时跳过传输重建）。 */
 	subscribedOnly = false;
 	constructor(opts) {
@@ -3736,6 +3876,7 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 		this.msgChannel = opts.msgChannel;
 		this.groupChannel = opts.groupChannel;
 		this.friendChannel = opts.friendChannel;
+		this.buddyCacheEvents = opts.buddyCacheEvents;
 		this.calibLogger = opts.logger;
 		this.selfUin = opts.self.uin;
 		this.oneBotApi = new OneBotApi(opts);
@@ -3749,6 +3890,7 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 		if (this.subscribedOnly) {
 			this.reportSelfMessage = config.reportSelfMessage;
 			this.messageFormat = config.messagePostFormat;
+			this.groupUploadAsNotice = config.groupUploadAsNotice;
 			return;
 		}
 		await this.stopAll();
@@ -3759,6 +3901,7 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 		this.subscribedOnly = false;
 		this.reportSelfMessage = config.reportSelfMessage;
 		this.messageFormat = config.messagePostFormat;
+		this.groupUploadAsNotice = config.groupUploadAsNotice;
 		const broadcaster = this.getBroadcaster();
 		if (broadcaster !== void 0) {
 			this.transports = assembleOb11Transports({
@@ -3830,13 +3973,36 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 					return;
 				}
 				if (!this.reportSelfMessage && String(msg.senderUin) === this.selfUin) return;
+				if (this.groupUploadAsNotice && msg.chatType === ChatType.GROUP && hasFileElement(msg)) {
+					const notice = toGroupUpload(msg, this.selfUin);
+					if (notice !== null) {
+						this.broadcastEvent(notice);
+						return;
+					}
+				}
 				this.broadcastMessageEvent(msg);
 			});
 		}));
-		if (this.groupChannel !== void 0) this.unsubscribes.push(this.groupChannel.on("Group/onGroupNotifiesUpdated", (doubt, notifies) => {
-			if (doubt || !Array.isArray(notifies)) return;
-			this.broadcastGroupRequests(notifies);
+		this.unsubscribes.push(this.msgChannel.on("Msg/onRecvOfflineFileMsg", (arg) => {
+			const items = narrowOfflineFiles(arg);
+			if (items === null) {
+				this.calibLogger?.warn({ raw: JSON.stringify(arg)?.slice(0, 2e3) }, "ob11: onRecvOfflineFileMsg 未知参数形状");
+				return;
+			}
+			for (const item of items) this.broadcastEvent(toOfflineFileNotice(item, this.selfUin));
+		}));
+		for (const evt of ["Msg/onRecvSysMsg", "Msg/onRecvOnlineFileMsg"]) this.unsubscribes.push(this.msgChannel.on(evt, (arg) => {
+			this.calibLogger?.info({ raw: JSON.stringify(arg)?.slice(0, 2e3) }, `ob11: ${evt} raw（sys msg 校准数据）`);
 		}));
+		if (this.groupChannel !== void 0) {
+			this.unsubscribes.push(this.groupChannel.on("Group/onGroupNotifiesUpdated", (doubt, notifies) => {
+				if (doubt || !Array.isArray(notifies)) return;
+				this.broadcastGroupRequests(notifies);
+			}));
+			this.unsubscribes.push(this.groupChannel.on("Group/onGroupEssenceListChange", (arg) => {
+				this.calibLogger?.info({ raw: JSON.stringify(arg)?.slice(0, 2e3) }, "ob11: onGroupEssenceListChange raw（group_essence 校准数据）");
+			}));
+		}
 		if (this.friendChannel !== void 0) {
 			this.unsubscribes.push(this.friendChannel.on("Buddy/onBuddyReqChange", (arg) => {
 				const reqs = narrowBuddyReqs(arg);
@@ -3850,6 +4016,9 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 				this.calibLogger?.info({ raw: JSON.stringify(arg)?.slice(0, 2e3) }, `ob11: ${evt} raw（friend_add 校准数据）`);
 			}));
 		}
+		if (this.buddyCacheEvents !== void 0) this.unsubscribes.push(this.buddyCacheEvents.on("BuddyCache/onBuddyAdded", (entry) => {
+			this.broadcastEvent(toFriendAdd(entry, this.selfUin));
+		}));
 	}
 	/**
 	* 仅启动接收链路（IPC 桥模式，2026-08-27）：订阅消息通道维护 messageUnique +
@@ -3860,6 +4029,7 @@ var NapukettoOneBot11Adapter = class extends BaseProtocolAdapter {
 		const config = await this.config.load();
 		this.reportSelfMessage = config.reportSelfMessage;
 		this.messageFormat = config.messagePostFormat;
+		this.groupUploadAsNotice = config.groupUploadAsNotice;
 		this.subscribedOnly = true;
 		this.subscribe();
 	}