API ขาเข้าของช่องทาง

Channel ingress เป็นขอบเขตการควบคุมการเข้าถึงแบบทดลองสำหรับเหตุการณ์ขาเข้าของ ช่องทาง Plugins เป็นเจ้าของข้อเท็จจริงของแพลตฟอร์มและผลข้างเคียง ส่วน core เป็นเจ้าของ นโยบายทั่วไป ได้แก่ รายการอนุญาตของ DM/กลุ่ม, รายการ DM ใน pairing store, เกตเส้นทาง, เกตคำสั่ง, การอนุญาตเหตุการณ์, การเปิดใช้งานด้วยการกล่าวถึง, การวินิจฉัยที่ปกปิดข้อมูล และ การรับเข้า

ใช้ openclaw/plugin-sdk/channel-ingress-runtime สำหรับเส้นทางการรับ

ตัวแก้ไข Runtime

   defineStableChannelIngressIdentity,  resolveChannelMessageIngress,} from "openclaw/plugin-sdk/channel-ingress-runtime"; const identity = defineStableChannelIngressIdentity({  key: "platform-user-id",  normalize: normalizePlatformUserId,  sensitivity: "pii",}); const result = await resolveChannelMessageIngress({  channelId: "my-channel",  accountId,  identity,  subject: { stableId: platformUserId },  conversation: { kind: isGroup ? "group" : "direct", id: conversationId },  event: { kind: "message", authMode: "inbound", mayPair: !isGroup },  policy: {    dmPolicy: config.dmPolicy,    groupPolicy: config.groupPolicy,    groupAllowFromFallbackToAllowFrom: true,  },  allowFrom: config.allowFrom,  groupAllowFrom: config.groupAllowFrom,  accessGroups: cfg.accessGroups,  route,  readStoreAllowFrom,  command: hasControlCommand ? { allowTextCommands: true, hasControlCommand } : undefined,});

อย่าคำนวณรายการอนุญาตที่มีผล เจ้าของคำสั่ง หรือกลุ่มคำสั่งไว้ล่วงหน้า ตัวแก้ไขจะหาอนุพันธ์ของค่าเหล่านี้จากรายการอนุญาตดิบ, callback ของ store, ตัวอธิบายเส้นทาง, กลุ่มการเข้าถึง, นโยบาย และชนิดการสนทนา

ผลลัพธ์

Plugins ที่รวมมากับระบบควรใช้ projection สมัยใหม่โดยตรง:

การอนุญาตเหตุการณ์ยังคงมีอยู่ใน ingress.graph ตามลำดับและ ingress.reasonCode ที่เป็นข้อยุติ โดยไม่มีการส่งออก projection ของเหตุการณ์แยกต่างหาก

ตัวช่วย SDK ของบุคคลที่สามที่เลิกใช้แล้วอาจสร้างโครงสร้างรุ่นเก่าขึ้นใหม่ภายใน เส้นทางการรับใหม่ ที่รวมมากับระบบไม่ควรแปลงผลลัพธ์สมัยใหม่กลับเป็น DTO ภายในเครื่อง

กลุ่มการเข้าถึง

รายการ accessGroup:<name> ยังคงถูกปกปิดข้อมูลไว้ Core จะแก้ไขกลุ่ม message.senders แบบคงที่ด้วยตัวเอง และเรียก resolveAccessGroupMembership เฉพาะ สำหรับกลุ่มแบบไดนามิกที่ต้องค้นหาจากแพลตฟอร์มเท่านั้น กลุ่มที่ไม่มีอยู่ ไม่รองรับ หรือ ล้มเหลวจะปฏิเสธโดยปริยาย

โหมดเหตุการณ์

ใช้ mayPair: false สำหรับรีแอ็กชัน, ปุ่ม, callback และคำสั่งแบบเนทีฟ

เส้นทางและการเปิดใช้งาน

ใช้ตัวอธิบายเส้นทางสำหรับนโยบายห้อง, หัวข้อ, guild, เธรด หรือเส้นทางที่ซ้อนกัน:

route: {  id: "room",  allowed: roomAllowed,  enabled: roomEnabled,  senderPolicy: "replace",  senderAllowFrom: roomAllowFrom,  blockReason: "room_sender_not_allowlisted",}

ใช้ channelIngressRoutes(...) เมื่อ Plugin มีตัวอธิบายเส้นทางแบบเลือกใช้ได้ หลายรายการ โดยจะกรองแขนงที่ปิดใช้งานออก พร้อมคงข้อเท็จจริงของเส้นทางให้เป็นข้อมูลทั่วไป และเรียงลำดับตาม precedence ของตัวอธิบายแต่ละรายการ

เกตการกล่าวถึงเป็นเกตการเปิดใช้งาน การไม่พบการกล่าวถึงจะคืนค่า admission: "skip" เพื่อไม่ให้เคอร์เนลของเทิร์นประมวลผลเทิร์นที่มีไว้สังเกตการณ์เท่านั้น ช่องทางส่วนใหญ่ควรวางการเปิดใช้งานไว้หลังเกตผู้ส่งและเกตคำสั่ง พื้นที่แชตสาธารณะ ที่ต้องระงับทราฟฟิกซึ่งไม่ได้กล่าวถึงก่อนเกิดสัญญาณรบกวนจากรายการอนุญาตผู้ส่ง สามารถเลือกใช้ activation.order: "before-sender" เมื่อปิดใช้งานการข้าม ด้วยคำสั่งข้อความ ช่องทางที่มีการเปิดใช้งานโดยปริยาย เช่น การตอบกลับใน เธรดของบอต จะแก้ไข channels.defaults.implicitMentions ร่วมกับค่าที่เขียนทับของช่องทางและบัญชี ด้วย resolveChannelImplicitMentions(...) แล้วส่งผลลัพธ์เป็น activation.implicitMentions ส่วน activationAccess.shouldBypassMention ที่ฉายออกมาจะรายงานเมื่อคำสั่งหรือการเปิดใช้งาน โดยปริยายข้ามข้อกำหนดการกล่าวถึงอย่างชัดแจ้ง

การปกปิดข้อมูล

ค่าผู้ส่งดิบและรายการในรายการอนุญาตดิบเป็นเพียงอินพุตของตัวแก้ไขเท่านั้น ค่าเหล่านี้ ต้องไม่ปรากฏในสถานะที่แก้ไขแล้ว, การตัดสินใจ, การวินิจฉัย, snapshot หรือ ข้อเท็จจริงด้านความเข้ากันได้ ให้ใช้ subject id, entry id, route id และ diagnostic id ที่ไม่เปิดเผยข้อมูล

การตรวจสอบ

pnpm test src/channels/message-access/message-access.test.ts src/plugin-sdk/channel-ingress-runtime.test.tspnpm plugin-sdk:api:check