[{"data":1,"prerenderedAt":3404},["ShallowReactive",2],{"navigation_docs":3,"-guide-bot-events":500,"-guide-bot-events-surround":3399},[4,41,56,102],{"title":5,"icon":6,"path":7,"stem":8,"children":9},"内容发布","i-lucide-file-pen-line","\u002Fpublishing","0.publishing",[10,13,17,21,25,29,33,37],{"title":11,"path":7,"stem":12},"内容发布与审核","0.publishing\u002Findex",{"title":14,"path":15,"stem":16},"资源定义与收录范围","\u002Fpublishing\u002Fresource-definition","0.publishing\u002F0.resource-definition",{"title":18,"path":19,"stem":20},"帖子发布规范","\u002Fpublishing\u002Fposts","0.publishing\u002F1.posts",{"title":22,"path":23,"stem":24},"资源发布规范","\u002Fpublishing\u002Fresources","0.publishing\u002F2.resources",{"title":26,"path":27,"stem":28},"命名、署名与转载","\u002Fpublishing\u002Fnaming-and-attribution","0.publishing\u002F3.naming-and-attribution",{"title":30,"path":31,"stem":32},"资源审核要求","\u002Fpublishing\u002Fresource-review-requirements","0.publishing\u002F4.resource-review-requirements",{"title":34,"path":35,"stem":36},"审核与处置规范","\u002Fpublishing\u002Fmoderation","0.publishing\u002F5.moderation",{"title":38,"path":39,"stem":40},"举报、版权投诉与复核","\u002Fpublishing\u002Freports-and-appeals","0.publishing\u002F6.reports-and-appeals",{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":55},"参与贡献","i-lucide-hand-helping","\u002Fcontributing","1.contributing",[47,51],{"title":48,"path":49,"stem":50},"为 NexusMC 做贡献","\u002Fcontributing\u002Fgetting-started","1.contributing\u002F1.getting-started",{"title":52,"path":53,"stem":54},"NexusMC 开源项目","\u002Fcontributing\u002Fopen-source","1.contributing\u002F2.open-source",false,{"title":57,"icon":58,"path":59,"stem":60,"children":61,"page":55},"接入指南","i-lucide-book-open","\u002Fguide","1.guide",[62,66,70,74,78,82,86,90,94,98],{"title":63,"path":64,"stem":65},"开始接入","\u002Fguide\u002Fgetting-started","1.guide\u002F1.getting-started",{"title":67,"path":68,"stem":69},"个人令牌","\u002Fguide\u002Fpersonal-access-tokens","1.guide\u002F2.personal-access-tokens",{"title":71,"path":72,"stem":73},"开放平台 OAuth","\u002Fguide\u002Foauth","1.guide\u002F3.oauth",{"title":75,"path":76,"stem":77},"分页与错误","\u002Fguide\u002Fpagination-and-errors","1.guide\u002F4.pagination-and-errors",{"title":79,"path":80,"stem":81},"发布记录与联合筛选","\u002Fguide\u002Freleases-and-filters","1.guide\u002F5.releases-and-filters",{"title":83,"path":84,"stem":85},"资源更新与 Webhook","\u002Fguide\u002Fresource-updates-and-webhooks","1.guide\u002F6.resource-updates-and-webhooks",{"title":87,"path":88,"stem":89},"公共 API v1","\u002Fguide\u002Fpublic-api-v1","1.guide\u002F7.public-api-v1",{"title":91,"path":92,"stem":93},"机器人账号接入","\u002Fguide\u002Fbot-accounts","1.guide\u002F8.bot-accounts",{"title":95,"path":96,"stem":97},"机器人事件与回复","\u002Fguide\u002Fbot-events","1.guide\u002F9.bot-events",{"title":99,"path":100,"stem":101},"内容订阅","\u002Fguide\u002Fcontent-subscriptions","1.guide\u002F9.content-subscriptions",{"title":103,"icon":104,"path":105,"stem":106,"children":107},"API 参考","i-lucide-braces","\u002Fapi","2.api",[108,110,225,356,388,426,483],{"title":103,"path":105,"stem":109},"2.api\u002Findex",{"title":111,"icon":112,"path":113,"stem":114,"children":115},"公开内容","i-lucide-globe","\u002Fapi\u002Fpublic","2.api\u002F1.public\u002Findex",[116,118,125,130,135,140,145,150,155,160,165,170,175,180,185,190,195,200,205,210,215,220],{"title":117,"path":113,"stem":114},"概览",{"title":119,"path":120,"stem":121,"badge":122},"随机浏览公开资源","\u002Fapi\u002Fpublic\u002Fbrowse-resources","2.api\u002F1.public\u002Fbrowse-resources",{"label":123,"color":124},"GET","success",{"title":126,"path":127,"stem":128,"badge":129},"检查多资源构建兼容性","\u002Fapi\u002Fpublic\u002Fcheck-compatibility","2.api\u002F1.public\u002Fcheck-compatibility",{"label":123,"color":124},{"title":131,"path":132,"stem":133,"badge":134},"查找资源名称","\u002Fapi\u002Fpublic\u002Ffind-resource-names","2.api\u002F1.public\u002Ffind-resource-names",{"label":123,"color":124},{"title":136,"path":137,"stem":138,"badge":139},"获取首页内容","\u002Fapi\u002Fpublic\u002Fget-home","2.api\u002F1.public\u002Fget-home",{"label":123,"color":124},{"title":141,"path":142,"stem":143,"badge":144},"读取公开组织详情","\u002Fapi\u002Fpublic\u002Fget-organization","2.api\u002F1.public\u002Fget-organization",{"label":123,"color":124},{"title":146,"path":147,"stem":148,"badge":149},"获取帖子及递归回复","\u002Fapi\u002Fpublic\u002Fget-post","2.api\u002F1.public\u002Fget-post",{"label":123,"color":124},{"title":151,"path":152,"stem":153,"badge":154},"获取资源详情及匹配发布","\u002Fapi\u002Fpublic\u002Fget-resource","2.api\u002F1.public\u002Fget-resource",{"label":123,"color":124},{"title":156,"path":157,"stem":158,"badge":159},"获取提到资源的帖子","\u002Fapi\u002Fpublic\u002Fget-resource-mentions","2.api\u002F1.public\u002Fget-resource-mentions",{"label":123,"color":124},{"title":161,"path":162,"stem":163,"badge":164},"获取标签聚合页","\u002Fapi\u002Fpublic\u002Fget-tag","2.api\u002F1.public\u002Fget-tag",{"label":123,"color":124},{"title":166,"path":167,"stem":168,"badge":169},"列出内容区块","\u002Fapi\u002Fpublic\u002Flist-blocks","2.api\u002F1.public\u002Flist-blocks",{"label":123,"color":124},{"title":171,"path":172,"stem":173,"badge":174},"列出能力定义","\u002Fapi\u002Fpublic\u002Flist-capabilities","2.api\u002F1.public\u002Flist-capabilities",{"label":123,"color":124},{"title":176,"path":177,"stem":178,"badge":179},"列出资源缺口","\u002Fapi\u002Fpublic\u002Flist-gaps","2.api\u002F1.public\u002Flist-gaps",{"label":123,"color":124},{"title":181,"path":182,"stem":183,"badge":184},"列出公开组织","\u002Fapi\u002Fpublic\u002Flist-organizations","2.api\u002F1.public\u002Flist-organizations",{"label":123,"color":124},{"title":186,"path":187,"stem":188,"badge":189},"筛选公开帖子","\u002Fapi\u002Fpublic\u002Flist-posts","2.api\u002F1.public\u002Flist-posts",{"label":123,"color":124},{"title":191,"path":192,"stem":193,"badge":194},"筛选公开资源","\u002Fapi\u002Fpublic\u002Flist-resources","2.api\u002F1.public\u002Flist-resources",{"label":123,"color":124},{"title":196,"path":197,"stem":198,"badge":199},"查找开放标签","\u002Fapi\u002Fpublic\u002Flist-tags","2.api\u002F1.public\u002Flist-tags",{"label":123,"color":124},{"title":201,"path":202,"stem":203,"badge":204},"继续读取帖子的直接回复","\u002Fapi\u002Fpublic\u002Fpost-replies","2.api\u002F1.public\u002Fpost-replies",{"label":123,"color":124},{"title":206,"path":207,"stem":208,"badge":209},"继续读取资源发布","\u002Fapi\u002Fpublic\u002Fresource-releases","2.api\u002F1.public\u002Fresource-releases",{"label":123,"color":124},{"title":211,"path":212,"stem":213,"badge":214},"查询当前兼容更新构建","\u002Fapi\u002Fpublic\u002Fresource-updates","2.api\u002F1.public\u002Fresource-updates",{"label":123,"color":124},{"title":216,"path":217,"stem":218,"badge":219},"搜索公开内容","\u002Fapi\u002Fpublic\u002Fsearch-content","2.api\u002F1.public\u002Fsearch-content",{"label":123,"color":124},{"title":221,"path":222,"stem":223,"badge":224},"获取公开内容建议","\u002Fapi\u002Fpublic\u002Fsuggest-content","2.api\u002F1.public\u002Fsuggest-content",{"label":123,"color":124},{"title":226,"icon":227,"path":228,"stem":229,"children":230},"个人 API","i-lucide-key-round","\u002Fapi\u002Fpersonal","2.api\u002F2.personal\u002Findex",[231,232,239,246,251,256,261,268,273,278,283,288,292,297,301,305,310,314,318,322,326,330,335,340,346,351],{"title":117,"path":228,"stem":229},{"title":233,"path":234,"stem":235,"badge":236},"修改 Issue 状态","\u002Fapi\u002Fpersonal\u002Fchange-post-state","2.api\u002F2.personal\u002Fchange-post-state",{"label":237,"color":238},"PUT","warning",{"title":240,"path":241,"stem":242,"badge":243},"创建组织","\u002Fapi\u002Fpersonal\u002Fcreate-organization","2.api\u002F2.personal\u002Fcreate-organization",{"label":244,"color":245},"POST","info",{"title":247,"path":248,"stem":249,"badge":250},"创建帖子","\u002Fapi\u002Fpersonal\u002Fcreate-post","2.api\u002F2.personal\u002Fcreate-post",{"label":244,"color":245},{"title":252,"path":253,"stem":254,"badge":255},"创建联合兼容发布记录","\u002Fapi\u002Fpersonal\u002Fcreate-release","2.api\u002F2.personal\u002Fcreate-release",{"label":244,"color":245},{"title":257,"path":258,"stem":259,"badge":260},"创建资源","\u002Fapi\u002Fpersonal\u002Fcreate-resource","2.api\u002F2.personal\u002Fcreate-resource",{"label":244,"color":245},{"title":262,"path":263,"stem":264,"badge":265},"删除本人帖子","\u002Fapi\u002Fpersonal\u002Fdelete-post","2.api\u002F2.personal\u002Fdelete-post",{"label":266,"color":267},"DELETE","error",{"title":269,"path":270,"stem":271,"badge":272},"删除本人维护的资源","\u002Fapi\u002Fpersonal\u002Fdelete-resource","2.api\u002F2.personal\u002Fdelete-resource",{"label":266,"color":267},{"title":274,"path":275,"stem":276,"badge":277},"读取本人展示资料","\u002Fapi\u002Fpersonal\u002Fget-me","2.api\u002F2.personal\u002Fget-me",{"label":123,"color":124},{"title":279,"path":280,"stem":281,"badge":282},"读取本人的帖子","\u002Fapi\u002Fpersonal\u002Flist-own-posts","2.api\u002F2.personal\u002Flist-own-posts",{"label":123,"color":124},{"title":284,"path":285,"stem":286,"badge":287},"读取本人的资源","\u002Fapi\u002Fpersonal\u002Flist-own-resources","2.api\u002F2.personal\u002Flist-own-resources",{"label":123,"color":124},{"title":131,"path":289,"stem":290,"badge":291},"\u002Fapi\u002Fpersonal\u002Fpersonal-find-resource-names","2.api\u002F2.personal\u002Fpersonal-find-resource-names",{"label":123,"color":124},{"title":293,"path":294,"stem":295,"badge":296},"读取本人可见的组织","\u002Fapi\u002Fpersonal\u002Fpersonal-get-organization","2.api\u002F2.personal\u002Fpersonal-get-organization",{"label":123,"color":124},{"title":146,"path":298,"stem":299,"badge":300},"\u002Fapi\u002Fpersonal\u002Fpersonal-get-post","2.api\u002F2.personal\u002Fpersonal-get-post",{"label":123,"color":124},{"title":151,"path":302,"stem":303,"badge":304},"\u002Fapi\u002Fpersonal\u002Fpersonal-get-resource","2.api\u002F2.personal\u002Fpersonal-get-resource",{"label":123,"color":124},{"title":306,"path":307,"stem":308,"badge":309},"列出本人组织","\u002Fapi\u002Fpersonal\u002Fpersonal-list-organizations","2.api\u002F2.personal\u002Fpersonal-list-organizations",{"label":123,"color":124},{"title":186,"path":311,"stem":312,"badge":313},"\u002Fapi\u002Fpersonal\u002Fpersonal-list-posts","2.api\u002F2.personal\u002Fpersonal-list-posts",{"label":123,"color":124},{"title":191,"path":315,"stem":316,"badge":317},"\u002Fapi\u002Fpersonal\u002Fpersonal-list-resources","2.api\u002F2.personal\u002Fpersonal-list-resources",{"label":123,"color":124},{"title":201,"path":319,"stem":320,"badge":321},"\u002Fapi\u002Fpersonal\u002Fpersonal-post-replies","2.api\u002F2.personal\u002Fpersonal-post-replies",{"label":123,"color":124},{"title":206,"path":323,"stem":324,"badge":325},"\u002Fapi\u002Fpersonal\u002Fpersonal-resource-releases","2.api\u002F2.personal\u002Fpersonal-resource-releases",{"label":123,"color":124},{"title":211,"path":327,"stem":328,"badge":329},"\u002Fapi\u002Fpersonal\u002Fpersonal-resource-updates","2.api\u002F2.personal\u002Fpersonal-resource-updates",{"label":123,"color":124},{"title":331,"path":332,"stem":333,"badge":334},"回复帖子","\u002Fapi\u002Fpersonal\u002Freply-post","2.api\u002F2.personal\u002Freply-post",{"label":244,"color":245},{"title":336,"path":337,"stem":338,"badge":339},"编辑组织资料","\u002Fapi\u002Fpersonal\u002Fupdate-organization","2.api\u002F2.personal\u002Fupdate-organization",{"label":237,"color":238},{"title":341,"path":342,"stem":343,"badge":344},"修改本人帖子","\u002Fapi\u002Fpersonal\u002Fupdate-post","2.api\u002F2.personal\u002Fupdate-post",{"label":345,"color":238},"PATCH",{"title":347,"path":348,"stem":349,"badge":350},"修改本人维护的发布记录","\u002Fapi\u002Fpersonal\u002Fupdate-release","2.api\u002F2.personal\u002Fupdate-release",{"label":345,"color":238},{"title":352,"path":353,"stem":354,"badge":355},"修改本人维护的资源","\u002Fapi\u002Fpersonal\u002Fupdate-resource","2.api\u002F2.personal\u002Fupdate-resource",{"label":345,"color":238},{"title":357,"icon":358,"path":359,"stem":360,"children":361},"开放平台","i-lucide-shield-check","\u002Fapi\u002Foauth","2.api\u002F3.oauth\u002Findex",[362,363,368,373,378,383],{"title":117,"path":359,"stem":360},{"title":364,"path":365,"stem":366,"badge":367},"发起授权码流程","\u002Fapi\u002Foauth\u002Fauthorize-oauth","2.api\u002F3.oauth\u002Fauthorize-oauth",{"label":123,"color":124},{"title":369,"path":370,"stem":371,"badge":372},"交换、刷新令牌或签发机器人令牌","\u002Fapi\u002Foauth\u002Fexchange-oauth-token","2.api\u002F3.oauth\u002Fexchange-oauth-token",{"label":244,"color":245},{"title":374,"path":375,"stem":376,"badge":377},"读取授权用户信息","\u002Fapi\u002Foauth\u002Fget-oauth-userinfo","2.api\u002F3.oauth\u002Fget-oauth-userinfo",{"label":123,"color":124},{"title":379,"path":380,"stem":381,"badge":382},"列出可申请的 OAuth scope","\u002Fapi\u002Foauth\u002Flist-oauth-scopes","2.api\u002F3.oauth\u002Flist-oauth-scopes",{"label":123,"color":124},{"title":384,"path":385,"stem":386,"badge":387},"撤销访问或刷新令牌","\u002Fapi\u002Foauth\u002Frevoke-oauth-token","2.api\u002F3.oauth\u002Frevoke-oauth-token",{"label":244,"color":245},{"title":389,"path":390,"stem":391,"children":392,"icon":425},"精简资源查询","\u002Fapi\u002Fpublic-v1","2.api\u002F4.public-v1\u002Findex",[393,394,399,406,411,416,420],{"title":117,"path":390,"stem":391},{"title":395,"path":396,"stem":397,"badge":398},"读取公开资源详情","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-get-resource","2.api\u002F4.public-v1\u002Fpublic-v1-get-resource",{"label":123,"color":124},{"title":400,"path":401,"stem":402,"badge":403},"读取公开资源详情（HEAD）","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-head-get-resource","2.api\u002F4.public-v1\u002Fpublic-v1-head-get-resource",{"label":404,"color":405},"HEAD","neutral",{"title":407,"path":408,"stem":409,"badge":410},"筛选公开资源（HEAD）","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-head-list-resources","2.api\u002F4.public-v1\u002Fpublic-v1-head-list-resources",{"label":404,"color":405},{"title":412,"path":413,"stem":414,"badge":415},"读取当前兼容更新构建（HEAD）","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-head-resource-updates","2.api\u002F4.public-v1\u002Fpublic-v1-head-resource-updates",{"label":404,"color":405},{"title":191,"path":417,"stem":418,"badge":419},"\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-list-resources","2.api\u002F4.public-v1\u002Fpublic-v1-list-resources",{"label":123,"color":124},{"title":421,"path":422,"stem":423,"badge":424},"读取当前兼容更新构建","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-resource-updates","2.api\u002F4.public-v1\u002Fpublic-v1-resource-updates",{"label":123,"color":124},"i-lucide-network",{"title":427,"icon":428,"path":429,"stem":430,"children":431},"Webhook","i-lucide-webhook","\u002Fapi\u002Fwebhooks","2.api\u002F5.webhooks\u002Findex",[432,433,438,443,448,453,458,463,468,473,478],{"title":117,"path":429,"stem":430},{"title":434,"path":435,"stem":436,"badge":437},"申请创建 Webhook 端点","\u002Fapi\u002Fwebhooks\u002Fcreate-webhook-endpoint","2.api\u002F5.webhooks\u002Fcreate-webhook-endpoint",{"label":244,"color":245},{"title":439,"path":440,"stem":441,"badge":442},"订阅资源发布或知识库更新","\u002Fapi\u002Fwebhooks\u002Fcreate-webhook-subscription","2.api\u002F5.webhooks\u002Fcreate-webhook-subscription",{"label":244,"color":245},{"title":444,"path":445,"stem":446,"badge":447},"删除 Webhook 端点","\u002Fapi\u002Fwebhooks\u002Fdelete-webhook-endpoint","2.api\u002F5.webhooks\u002Fdelete-webhook-endpoint",{"label":266,"color":267},{"title":449,"path":450,"stem":451,"badge":452},"删除资源订阅","\u002Fapi\u002Fwebhooks\u002Fdelete-webhook-subscription","2.api\u002F5.webhooks\u002Fdelete-webhook-subscription",{"label":266,"color":267},{"title":454,"path":455,"stem":456,"badge":457},"查看投递记录","\u002Fapi\u002Fwebhooks\u002Flist-webhook-deliveries","2.api\u002F5.webhooks\u002Flist-webhook-deliveries",{"label":123,"color":124},{"title":459,"path":460,"stem":461,"badge":462},"列出我的 Webhook 端点","\u002Fapi\u002Fwebhooks\u002Flist-webhook-endpoints","2.api\u002F5.webhooks\u002Flist-webhook-endpoints",{"label":123,"color":124},{"title":464,"path":465,"stem":466,"badge":467},"列出端点订阅","\u002Fapi\u002Fwebhooks\u002Flist-webhook-subscriptions","2.api\u002F5.webhooks\u002Flist-webhook-subscriptions",{"label":123,"color":124},{"title":469,"path":470,"stem":471,"badge":472},"重试当前版本的失败投递","\u002Fapi\u002Fwebhooks\u002Fretry-webhook-delivery","2.api\u002F5.webhooks\u002Fretry-webhook-delivery",{"label":244,"color":245},{"title":474,"path":475,"stem":476,"badge":477},"轮换 Webhook 签名密钥","\u002Fapi\u002Fwebhooks\u002Frotate-webhook-secret","2.api\u002F5.webhooks\u002Frotate-webhook-secret",{"label":244,"color":245},{"title":479,"path":480,"stem":481,"badge":482},"修改 Webhook 端点","\u002Fapi\u002Fwebhooks\u002Fupdate-webhook-endpoint","2.api\u002F5.webhooks\u002Fupdate-webhook-endpoint",{"label":345,"color":238},{"title":484,"path":485,"stem":486,"children":487,"icon":499},"机器人事件","\u002Fapi\u002Fbots","2.api\u002F6.bots\u002Findex",[488,489,494],{"title":117,"path":485,"stem":486},{"title":490,"path":491,"stem":492,"badge":493},"读取机器人事件","\u002Fapi\u002Fbots\u002Flist-bot-events","2.api\u002F6.bots\u002Flist-bot-events",{"label":123,"color":124},{"title":495,"path":496,"stem":497,"badge":498},"回复机器人事件","\u002Fapi\u002Fbots\u002Freply-bot-event","2.api\u002F6.bots\u002Freply-bot-event",{"label":244,"color":245},"i-lucide-bot",{"id":501,"title":95,"body":502,"description":3393,"extension":3394,"links":3395,"meta":3396,"navigation":1951,"path":96,"seo":3397,"stem":97,"__hash__":3398},"docs\u002F1.guide\u002F9.bot-events.md",{"type":503,"value":504,"toc":3383},"minimark",[505,513,525,529,615,618,625,628,675,693,696,1469,1606,1610,1616,1635,1638,1641,1702,1716,1740,1751,1755,1766,2663,2681,3227,3230,3234,3252,3255,3282,3285,3291,3294,3369,3372,3379],[506,507,508,509,512],"p",{},"完成",[510,511,91],"a",{"href":92},"后，可使用机器人自身 PAT 接收人工用户发来的私信和房间指令，再回复原来的会话。HTTP 接口提供事件正文；WebSocket 提示有新变化，帮助客户端及时补取。",[506,514,515,516,519,520,524],{},"接口地址、参数与响应见",[510,517,518],{"href":485},"机器人事件 API","。以下 ",[521,522,523],"code",{},"http:\u002F\u002F127.0.0.1:4520"," 是本地 API 地址，部署时替换为自己的 API origin。",[526,527,528],"h2",{"id":528},"哪些消息会产生事件",[530,531,532,548],"table",{},[533,534,535],"thead",{},[536,537,538,542,545],"tr",{},[539,540,541],"th",{},"事件类型",[539,543,544],{},"触发方式",[539,546,547],{},"必要权限与条件",[549,550,551,572,594],"tbody",{},[536,552,553,559,562],{},[554,555,556],"td",{},[521,557,558],{},"dm",[554,560,561],{},"人工用户向机器人发送私信",[554,563,564,567,568,571],{},[521,565,566],{},"bot:events:read","、",[521,569,570],{},"bot:dm:read","；机器人、所有者和授权仍有效",[536,573,574,579,586],{},[554,575,576],{},[521,577,578],{},"mention",[554,580,581,582,585],{},"房间消息以 ",[521,583,584],{},"@handle 命令 参数"," 开头，或消息携带有效的开头结构化机器人提及",[554,587,588,567,590,593],{},[521,589,566],{},[521,591,592],{},"bot:room:mention","；机器人在房间内，安装的提及开关开启，且该指令已在房间选用",[536,595,596,601,607],{},[554,597,598],{},[521,599,600],{},"slash",[554,602,581,603,606],{},[521,604,605],{},"\u002F命令 参数"," 开头",[554,608,609,567,611,614],{},[521,610,566],{},[521,612,613],{},"bot:room:slash","；平台逐条核准该指令，房间管理者也逐条启用",[506,616,617],{},"平台批准斜杠指令后，房间仍须自行启用。普通房间聊天、句中提及、未知或无法唯一定位机器人的命令不会产生事件；机器人发送的消息也不会触发另一轮机器人事件。",[506,619,620,621,624],{},"指令登记时会去除首尾空白并转为小写，名称为 1–32 个 ASCII 小写字母、数字、下划线、常用中文或连字符，首字符不能是连字符；触发时精确匹配登记名。参数按空白拆分，不支持 shell 引号语法。超过 10 项时不识别为指令，也不生成事件；对于已识别的指令，参数数量不符合该指令配置时，人工用户的原消息仍会保存，发送响应包含 ",[521,622,623],{},"command_error","，机器人不会收到该事件。",[526,626,627],{"id":627},"读取事件",[629,630,635],"pre",{"className":631,"code":632,"language":633,"meta":634,"style":634},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Fevents?after=0&limit=50' \\\n  -H 'Authorization: Bearer \u003Cbot-pat>'\n","bash","",[521,636,637,661],{"__ignoreMap":634},[638,639,642,646,650,654,657],"span",{"class":640,"line":641},"line",1,[638,643,645],{"class":644},"sBMFI","curl",[638,647,649],{"class":648},"sMK4o"," '",[638,651,653],{"class":652},"sfazB","http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Fevents?after=0&limit=50",[638,655,656],{"class":648},"'",[638,658,660],{"class":659},"sTEyZ"," \\\n",[638,662,664,667,669,672],{"class":640,"line":663},2,[638,665,666],{"class":652},"  -H",[638,668,649],{"class":648},[638,670,671],{"class":652},"Authorization: Bearer \u003Cbot-pat>",[638,673,674],{"class":648},"'\n",[506,676,677,680,681,684,685,688,689,692],{},[521,678,679],{},"after"," 是十进制字符串，首次读取使用 ",[521,682,683],{},"\"0\"","，最大为 ",[521,686,687],{},"\"9223372036854775807\"","。",[521,690,691],{},"limit"," 默认为 50，可设为 1–50。必须使用机器人的 PAT；所有者自己的 PAT、OAuth access token 和 Cookie 均不能代替它。",[506,694,695],{},"下面把三类事件放在同一个响应中，展示各字段的差异。ID、时间与内容均为示例。",[629,697,701],{"className":698,"code":699,"language":700,"meta":634,"style":634},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"events\": [\n    {\n      \"event_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\n      \"seq\": \"1\",\n      \"message_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAW\",\n      \"room_id\": null,\n      \"conversation_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAX\",\n      \"trigger_kind\": \"dm\",\n      \"command_id\": null,\n      \"command_revision\": null,\n      \"args\": [],\n      \"content\": \"你好，可以查一下服务器状态吗？\",\n      \"author_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAY\",\n      \"created_at\": \"2026-11-08T00:00:00.000Z\"\n    },\n    {\n      \"event_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAZ\",\n      \"seq\": \"2\",\n      \"message_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FB0\",\n      \"room_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FB1\",\n      \"conversation_id\": null,\n      \"trigger_kind\": \"mention\",\n      \"command_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FB2\",\n      \"command_revision\": 1,\n      \"args\": [\"play.example.com\"],\n      \"content\": \"@status-bot 查服 play.example.com\",\n      \"author_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAY\",\n      \"created_at\": \"2026-11-08T00:00:01.000Z\"\n    },\n    {\n      \"event_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FB3\",\n      \"seq\": \"3\",\n      \"message_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FB4\",\n      \"room_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FB1\",\n      \"conversation_id\": null,\n      \"trigger_kind\": \"slash\",\n      \"command_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FB2\",\n      \"command_revision\": 1,\n      \"args\": [\"play.example.com\"],\n      \"content\": \"\u002F查服 play.example.com\",\n      \"author_id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAY\",\n      \"created_at\": \"2026-11-08T00:00:02.000Z\"\n    }\n  ],\n  \"next_after\": \"3\"\n}\n","json",[521,702,703,708,726,732,756,777,798,813,834,854,868,882,897,918,939,959,965,970,990,1010,1030,1050,1063,1082,1102,1119,1143,1163,1182,1200,1205,1210,1230,1250,1270,1289,1302,1321,1340,1355,1376,1396,1415,1433,1439,1445,1463],{"__ignoreMap":634},[638,704,705],{"class":640,"line":641},[638,706,707],{"class":648},"{\n",[638,709,710,713,717,720,723],{"class":640,"line":663},[638,711,712],{"class":648},"  \"",[638,714,716],{"class":715},"spNyl","events",[638,718,719],{"class":648},"\"",[638,721,722],{"class":648},":",[638,724,725],{"class":648}," [\n",[638,727,729],{"class":640,"line":728},3,[638,730,731],{"class":648},"    {\n",[638,733,735,738,741,743,745,748,751,753],{"class":640,"line":734},4,[638,736,737],{"class":648},"      \"",[638,739,740],{"class":644},"event_id",[638,742,719],{"class":648},[638,744,722],{"class":648},[638,746,747],{"class":648}," \"",[638,749,750],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FAV",[638,752,719],{"class":648},[638,754,755],{"class":648},",\n",[638,757,759,761,764,766,768,770,773,775],{"class":640,"line":758},5,[638,760,737],{"class":648},[638,762,763],{"class":644},"seq",[638,765,719],{"class":648},[638,767,722],{"class":648},[638,769,747],{"class":648},[638,771,772],{"class":652},"1",[638,774,719],{"class":648},[638,776,755],{"class":648},[638,778,780,782,785,787,789,791,794,796],{"class":640,"line":779},6,[638,781,737],{"class":648},[638,783,784],{"class":644},"message_id",[638,786,719],{"class":648},[638,788,722],{"class":648},[638,790,747],{"class":648},[638,792,793],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FAW",[638,795,719],{"class":648},[638,797,755],{"class":648},[638,799,801,803,806,808,810],{"class":640,"line":800},7,[638,802,737],{"class":648},[638,804,805],{"class":644},"room_id",[638,807,719],{"class":648},[638,809,722],{"class":648},[638,811,812],{"class":648}," null,\n",[638,814,816,818,821,823,825,827,830,832],{"class":640,"line":815},8,[638,817,737],{"class":648},[638,819,820],{"class":644},"conversation_id",[638,822,719],{"class":648},[638,824,722],{"class":648},[638,826,747],{"class":648},[638,828,829],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FAX",[638,831,719],{"class":648},[638,833,755],{"class":648},[638,835,837,839,842,844,846,848,850,852],{"class":640,"line":836},9,[638,838,737],{"class":648},[638,840,841],{"class":644},"trigger_kind",[638,843,719],{"class":648},[638,845,722],{"class":648},[638,847,747],{"class":648},[638,849,558],{"class":652},[638,851,719],{"class":648},[638,853,755],{"class":648},[638,855,857,859,862,864,866],{"class":640,"line":856},10,[638,858,737],{"class":648},[638,860,861],{"class":644},"command_id",[638,863,719],{"class":648},[638,865,722],{"class":648},[638,867,812],{"class":648},[638,869,871,873,876,878,880],{"class":640,"line":870},11,[638,872,737],{"class":648},[638,874,875],{"class":644},"command_revision",[638,877,719],{"class":648},[638,879,722],{"class":648},[638,881,812],{"class":648},[638,883,885,887,890,892,894],{"class":640,"line":884},12,[638,886,737],{"class":648},[638,888,889],{"class":644},"args",[638,891,719],{"class":648},[638,893,722],{"class":648},[638,895,896],{"class":648}," [],\n",[638,898,900,902,905,907,909,911,914,916],{"class":640,"line":899},13,[638,901,737],{"class":648},[638,903,904],{"class":644},"content",[638,906,719],{"class":648},[638,908,722],{"class":648},[638,910,747],{"class":648},[638,912,913],{"class":652},"你好，可以查一下服务器状态吗？",[638,915,719],{"class":648},[638,917,755],{"class":648},[638,919,921,923,926,928,930,932,935,937],{"class":640,"line":920},14,[638,922,737],{"class":648},[638,924,925],{"class":644},"author_id",[638,927,719],{"class":648},[638,929,722],{"class":648},[638,931,747],{"class":648},[638,933,934],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FAY",[638,936,719],{"class":648},[638,938,755],{"class":648},[638,940,942,944,947,949,951,953,956],{"class":640,"line":941},15,[638,943,737],{"class":648},[638,945,946],{"class":644},"created_at",[638,948,719],{"class":648},[638,950,722],{"class":648},[638,952,747],{"class":648},[638,954,955],{"class":652},"2026-11-08T00:00:00.000Z",[638,957,958],{"class":648},"\"\n",[638,960,962],{"class":640,"line":961},16,[638,963,964],{"class":648},"    },\n",[638,966,968],{"class":640,"line":967},17,[638,969,731],{"class":648},[638,971,973,975,977,979,981,983,986,988],{"class":640,"line":972},18,[638,974,737],{"class":648},[638,976,740],{"class":644},[638,978,719],{"class":648},[638,980,722],{"class":648},[638,982,747],{"class":648},[638,984,985],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FAZ",[638,987,719],{"class":648},[638,989,755],{"class":648},[638,991,993,995,997,999,1001,1003,1006,1008],{"class":640,"line":992},19,[638,994,737],{"class":648},[638,996,763],{"class":644},[638,998,719],{"class":648},[638,1000,722],{"class":648},[638,1002,747],{"class":648},[638,1004,1005],{"class":652},"2",[638,1007,719],{"class":648},[638,1009,755],{"class":648},[638,1011,1013,1015,1017,1019,1021,1023,1026,1028],{"class":640,"line":1012},20,[638,1014,737],{"class":648},[638,1016,784],{"class":644},[638,1018,719],{"class":648},[638,1020,722],{"class":648},[638,1022,747],{"class":648},[638,1024,1025],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FB0",[638,1027,719],{"class":648},[638,1029,755],{"class":648},[638,1031,1033,1035,1037,1039,1041,1043,1046,1048],{"class":640,"line":1032},21,[638,1034,737],{"class":648},[638,1036,805],{"class":644},[638,1038,719],{"class":648},[638,1040,722],{"class":648},[638,1042,747],{"class":648},[638,1044,1045],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FB1",[638,1047,719],{"class":648},[638,1049,755],{"class":648},[638,1051,1053,1055,1057,1059,1061],{"class":640,"line":1052},22,[638,1054,737],{"class":648},[638,1056,820],{"class":644},[638,1058,719],{"class":648},[638,1060,722],{"class":648},[638,1062,812],{"class":648},[638,1064,1066,1068,1070,1072,1074,1076,1078,1080],{"class":640,"line":1065},23,[638,1067,737],{"class":648},[638,1069,841],{"class":644},[638,1071,719],{"class":648},[638,1073,722],{"class":648},[638,1075,747],{"class":648},[638,1077,578],{"class":652},[638,1079,719],{"class":648},[638,1081,755],{"class":648},[638,1083,1085,1087,1089,1091,1093,1095,1098,1100],{"class":640,"line":1084},24,[638,1086,737],{"class":648},[638,1088,861],{"class":644},[638,1090,719],{"class":648},[638,1092,722],{"class":648},[638,1094,747],{"class":648},[638,1096,1097],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FB2",[638,1099,719],{"class":648},[638,1101,755],{"class":648},[638,1103,1105,1107,1109,1111,1113,1117],{"class":640,"line":1104},25,[638,1106,737],{"class":648},[638,1108,875],{"class":644},[638,1110,719],{"class":648},[638,1112,722],{"class":648},[638,1114,1116],{"class":1115},"sbssI"," 1",[638,1118,755],{"class":648},[638,1120,1122,1124,1126,1128,1130,1133,1135,1138,1140],{"class":640,"line":1121},26,[638,1123,737],{"class":648},[638,1125,889],{"class":644},[638,1127,719],{"class":648},[638,1129,722],{"class":648},[638,1131,1132],{"class":648}," [",[638,1134,719],{"class":648},[638,1136,1137],{"class":652},"play.example.com",[638,1139,719],{"class":648},[638,1141,1142],{"class":648},"],\n",[638,1144,1146,1148,1150,1152,1154,1156,1159,1161],{"class":640,"line":1145},27,[638,1147,737],{"class":648},[638,1149,904],{"class":644},[638,1151,719],{"class":648},[638,1153,722],{"class":648},[638,1155,747],{"class":648},[638,1157,1158],{"class":652},"@status-bot 查服 play.example.com",[638,1160,719],{"class":648},[638,1162,755],{"class":648},[638,1164,1166,1168,1170,1172,1174,1176,1178,1180],{"class":640,"line":1165},28,[638,1167,737],{"class":648},[638,1169,925],{"class":644},[638,1171,719],{"class":648},[638,1173,722],{"class":648},[638,1175,747],{"class":648},[638,1177,934],{"class":652},[638,1179,719],{"class":648},[638,1181,755],{"class":648},[638,1183,1185,1187,1189,1191,1193,1195,1198],{"class":640,"line":1184},29,[638,1186,737],{"class":648},[638,1188,946],{"class":644},[638,1190,719],{"class":648},[638,1192,722],{"class":648},[638,1194,747],{"class":648},[638,1196,1197],{"class":652},"2026-11-08T00:00:01.000Z",[638,1199,958],{"class":648},[638,1201,1203],{"class":640,"line":1202},30,[638,1204,964],{"class":648},[638,1206,1208],{"class":640,"line":1207},31,[638,1209,731],{"class":648},[638,1211,1213,1215,1217,1219,1221,1223,1226,1228],{"class":640,"line":1212},32,[638,1214,737],{"class":648},[638,1216,740],{"class":644},[638,1218,719],{"class":648},[638,1220,722],{"class":648},[638,1222,747],{"class":648},[638,1224,1225],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FB3",[638,1227,719],{"class":648},[638,1229,755],{"class":648},[638,1231,1233,1235,1237,1239,1241,1243,1246,1248],{"class":640,"line":1232},33,[638,1234,737],{"class":648},[638,1236,763],{"class":644},[638,1238,719],{"class":648},[638,1240,722],{"class":648},[638,1242,747],{"class":648},[638,1244,1245],{"class":652},"3",[638,1247,719],{"class":648},[638,1249,755],{"class":648},[638,1251,1253,1255,1257,1259,1261,1263,1266,1268],{"class":640,"line":1252},34,[638,1254,737],{"class":648},[638,1256,784],{"class":644},[638,1258,719],{"class":648},[638,1260,722],{"class":648},[638,1262,747],{"class":648},[638,1264,1265],{"class":652},"01ARZ3NDEKTSV4RRFFQ69G5FB4",[638,1267,719],{"class":648},[638,1269,755],{"class":648},[638,1271,1273,1275,1277,1279,1281,1283,1285,1287],{"class":640,"line":1272},35,[638,1274,737],{"class":648},[638,1276,805],{"class":644},[638,1278,719],{"class":648},[638,1280,722],{"class":648},[638,1282,747],{"class":648},[638,1284,1045],{"class":652},[638,1286,719],{"class":648},[638,1288,755],{"class":648},[638,1290,1292,1294,1296,1298,1300],{"class":640,"line":1291},36,[638,1293,737],{"class":648},[638,1295,820],{"class":644},[638,1297,719],{"class":648},[638,1299,722],{"class":648},[638,1301,812],{"class":648},[638,1303,1305,1307,1309,1311,1313,1315,1317,1319],{"class":640,"line":1304},37,[638,1306,737],{"class":648},[638,1308,841],{"class":644},[638,1310,719],{"class":648},[638,1312,722],{"class":648},[638,1314,747],{"class":648},[638,1316,600],{"class":652},[638,1318,719],{"class":648},[638,1320,755],{"class":648},[638,1322,1324,1326,1328,1330,1332,1334,1336,1338],{"class":640,"line":1323},38,[638,1325,737],{"class":648},[638,1327,861],{"class":644},[638,1329,719],{"class":648},[638,1331,722],{"class":648},[638,1333,747],{"class":648},[638,1335,1097],{"class":652},[638,1337,719],{"class":648},[638,1339,755],{"class":648},[638,1341,1343,1345,1347,1349,1351,1353],{"class":640,"line":1342},39,[638,1344,737],{"class":648},[638,1346,875],{"class":644},[638,1348,719],{"class":648},[638,1350,722],{"class":648},[638,1352,1116],{"class":1115},[638,1354,755],{"class":648},[638,1356,1358,1360,1362,1364,1366,1368,1370,1372,1374],{"class":640,"line":1357},40,[638,1359,737],{"class":648},[638,1361,889],{"class":644},[638,1363,719],{"class":648},[638,1365,722],{"class":648},[638,1367,1132],{"class":648},[638,1369,719],{"class":648},[638,1371,1137],{"class":652},[638,1373,719],{"class":648},[638,1375,1142],{"class":648},[638,1377,1379,1381,1383,1385,1387,1389,1392,1394],{"class":640,"line":1378},41,[638,1380,737],{"class":648},[638,1382,904],{"class":644},[638,1384,719],{"class":648},[638,1386,722],{"class":648},[638,1388,747],{"class":648},[638,1390,1391],{"class":652},"\u002F查服 play.example.com",[638,1393,719],{"class":648},[638,1395,755],{"class":648},[638,1397,1399,1401,1403,1405,1407,1409,1411,1413],{"class":640,"line":1398},42,[638,1400,737],{"class":648},[638,1402,925],{"class":644},[638,1404,719],{"class":648},[638,1406,722],{"class":648},[638,1408,747],{"class":648},[638,1410,934],{"class":652},[638,1412,719],{"class":648},[638,1414,755],{"class":648},[638,1416,1418,1420,1422,1424,1426,1428,1431],{"class":640,"line":1417},43,[638,1419,737],{"class":648},[638,1421,946],{"class":644},[638,1423,719],{"class":648},[638,1425,722],{"class":648},[638,1427,747],{"class":648},[638,1429,1430],{"class":652},"2026-11-08T00:00:02.000Z",[638,1432,958],{"class":648},[638,1434,1436],{"class":640,"line":1435},44,[638,1437,1438],{"class":648},"    }\n",[638,1440,1442],{"class":640,"line":1441},45,[638,1443,1444],{"class":648},"  ],\n",[638,1446,1448,1450,1453,1455,1457,1459,1461],{"class":640,"line":1447},46,[638,1449,712],{"class":648},[638,1451,1452],{"class":715},"next_after",[638,1454,719],{"class":648},[638,1456,722],{"class":648},[638,1458,747],{"class":648},[638,1460,1245],{"class":652},[638,1462,958],{"class":648},[638,1464,1466],{"class":640,"line":1465},47,[638,1467,1468],{"class":648},"}\n",[530,1470,1471,1481],{},[533,1472,1473],{},[536,1474,1475,1478],{},[539,1476,1477],{},"字段",[539,1479,1480],{},"含义",[549,1482,1483,1492,1501,1510,1522,1533,1548,1559,1570,1579,1588,1597],{},[536,1484,1485,1489],{},[554,1486,1487],{},[521,1488,740],{},[554,1490,1491],{},"事件 ID，回复时原样传入",[536,1493,1494,1498],{},[554,1495,1496],{},[521,1497,763],{},[554,1499,1500],{},"当前机器人的事件序号，十进制字符串",[536,1502,1503,1507],{},[554,1504,1505],{},[521,1506,784],{},[554,1508,1509],{},"触发事件的人工消息 ID",[536,1511,1512,1516],{},[554,1513,1514],{},[521,1515,805],{},[554,1517,1518,1519],{},"房间 ID；私信为 ",[521,1520,1521],{},"null",[536,1523,1524,1528],{},[554,1525,1526],{},[521,1527,820],{},[554,1529,1530,1531],{},"私信会话 ID；房间事件为 ",[521,1532,1521],{},[536,1534,1535,1539],{},[554,1536,1537],{},[521,1538,841],{},[554,1540,1541,567,1543,1545,1546],{},[521,1542,558],{},[521,1544,578],{}," 或 ",[521,1547,600],{},[536,1549,1550,1554],{},[554,1551,1552],{},[521,1553,861],{},[554,1555,1556,1557],{},"触发的房间指令 ID；私信为 ",[521,1558,1521],{},[536,1560,1561,1565],{},[554,1562,1563],{},[521,1564,875],{},[554,1566,1567,1568],{},"触发时的指令修订号；私信为 ",[521,1569,1521],{},[536,1571,1572,1576],{},[554,1573,1574],{},[521,1575,889],{},[554,1577,1578],{},"已拆分的指令参数；私信为空数组",[536,1580,1581,1585],{},[554,1582,1583],{},[521,1584,904],{},[554,1586,1587],{},"人工用户发送的完整消息文本",[536,1589,1590,1594],{},[554,1591,1592],{},[521,1593,925],{},[554,1595,1596],{},"发送消息的人工用户 ID",[536,1598,1599,1603],{},[554,1600,1601],{},[521,1602,946],{},[554,1604,1605],{},"事件创建时间，ISO 时间字符串",[1607,1608,1609],"h3",{"id":1609},"正确保存游标",[506,1611,1612,1613,1615],{},"事件按 ",[521,1614,763],{}," 升序返回，但只包含当前仍有权限查看的消息。消息删除、权限变化或过期清理都可能造成序号间隔。",[506,1617,1618,1619,1621,1622,1624,1625,1627,1628,1630,1631,1634],{},"处理完一页后，保存响应中的 ",[521,1620,1452],{},"，下次原样作为 ",[521,1623,679],{}," 传入。空页也可能推进 ",[521,1626,1452],{},"；不要自行取最大序号、加一或猜测连续性。不要把 ",[521,1629,763],{}," 或游标转为 JavaScript ",[521,1632,1633],{},"Number","，大整数会丢失精度；也不要把本地未收到的较大数字当成游标。",[506,1636,1637],{},"同一机器人、相同 scope 集合、同一消费任务的多个实例应协调使用同一份持久化游标，避免相互覆盖进度。不同 scope 或独立业务消费者分别保存游标，防止一方推进后跳过另一方尚未处理的事件。首次启动、建立 WebSocket、重连以及正常运行期间，都应主动调用 HTTP 补取。",[526,1639,1640],{"id":1640},"回复与重复请求",[629,1642,1644],{"className":631,"code":1643,"language":633,"meta":634,"style":634},"curl -X POST 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Freplies' \\\n  -H 'Authorization: Bearer \u003Cbot-pat>' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  --data '{\"event_id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"action_key\":\"status-v1\",\"content\":\"服务器在线。\"}'\n",[521,1645,1646,1665,1677,1690],{"__ignoreMap":634},[638,1647,1648,1650,1653,1656,1658,1661,1663],{"class":640,"line":641},[638,1649,645],{"class":644},[638,1651,1652],{"class":652}," -X",[638,1654,1655],{"class":652}," POST",[638,1657,649],{"class":648},[638,1659,1660],{"class":652},"http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Freplies",[638,1662,656],{"class":648},[638,1664,660],{"class":659},[638,1666,1667,1669,1671,1673,1675],{"class":640,"line":663},[638,1668,666],{"class":652},[638,1670,649],{"class":648},[638,1672,671],{"class":652},[638,1674,656],{"class":648},[638,1676,660],{"class":659},[638,1678,1679,1681,1683,1686,1688],{"class":640,"line":728},[638,1680,666],{"class":652},[638,1682,649],{"class":648},[638,1684,1685],{"class":652},"Content-Type: application\u002Fjson",[638,1687,656],{"class":648},[638,1689,660],{"class":659},[638,1691,1692,1695,1697,1700],{"class":640,"line":734},[638,1693,1694],{"class":652},"  --data",[638,1696,649],{"class":648},[638,1698,1699],{"class":652},"{\"event_id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"action_key\":\"status-v1\",\"content\":\"服务器在线。\"}",[638,1701,674],{"class":648},[506,1703,1704,1705,1708,1709,1712,1713,1715],{},"成功返回 ",[521,1706,1707],{},"{\"message_id\":\"…\",\"duplicate\":false}","。回复发送到原事件对应的私信会话或房间，无需再指定目标。",[521,1710,1711],{},"action_key"," 为 1–64 个 ASCII 英文字母、数字、下划线、连字符、冒号或点；相同业务动作应稳定使用同一个键。",[521,1714,904],{}," 去除首尾空白后不能为空，最长 10000 字符。",[506,1717,1718,1719,1721,1722,1724,1725,1727,1728,1731,1732,1734,1735,1739],{},"同一机器人、",[521,1720,740],{}," 和 ",[521,1723,1711],{}," 的重复请求返回首次发送的 ",[521,1726,784],{},"，并设置 ",[521,1729,1730],{},"duplicate: true","；改变 ",[521,1733,904],{}," 不会覆盖首次回复。每个事件最多接受 ",[1736,1737,1738],"strong",{},"5 个新的回复键","，重试已有键不占新额度。不要在每次重试时随机生成键。",[506,1741,1742,1743,1746,1747,1750],{},"回复前会重新检查当前资格，包括 PAT、授权、源消息、房间安装与成员、指令修订和开关；私信还检查双方拉黑及对方消息隐私设置。私信回复需要 ",[521,1744,1745],{},"bot:dm:reply","，房间回复需要 ",[521,1748,1749],{},"bot:room:reply","，并保留触发该事件所需的读取权限。读取到事件并不保证稍后一定还能回复，幂等重试也不能绕过资格复核。",[526,1752,1754],{"id":1753},"typescript-消费示例","TypeScript 消费示例",[506,1756,1757,1758,1761,1762,1765],{},"将下面代码保存为 ",[521,1759,1760],{},"bot-consumer.ts","。它处理一页事件，每个事件发送一次确认；你可以将确认文本替换为自己的业务结果。",[521,1763,1764],{},"ack-v1"," 在每次重试时保持一致。",[629,1767,1771],{"className":1768,"code":1769,"language":1770,"meta":634,"style":634},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","type BotEvent = { event_id: string; seq: string }\ntype EventPage = { events: BotEvent[]; next_after: string }\ntype ConsumerOptions = {\n  baseUrl: string\n  token: string\n  loadCursor: () => Promise\u003Cstring>\n  saveCursor: (cursor: string) => Promise\u003Cvoid>\n  fetcher?: typeof fetch\n}\n\nexport async function consumePage({\n  baseUrl, token, loadCursor, saveCursor, fetcher = fetch,\n}: ConsumerOptions): Promise\u003Cnumber> {\n  const headers = { Authorization: `Bearer ${token}` }\n  const url = new URL('\u002Fv1\u002Fbots\u002Fme\u002Fevents', baseUrl)\n  url.search = new URLSearchParams({ after: await loadCursor(), limit: '50' }).toString()\n  const response = await fetcher(url, { headers, credentials: 'omit', redirect: 'error' })\n  if (!response.ok) throw new Error(`读取失败：${response.status} ${await response.text()}`)\n  const page = await response.json() as EventPage\n\n  for (const event of page.events) {\n    const reply = await fetcher(new URL('\u002Fv1\u002Fbots\u002Fme\u002Freplies', baseUrl), {\n      method: 'POST',\n      headers: { ...headers, 'Content-Type': 'application\u002Fjson' },\n      credentials: 'omit',\n      redirect: 'error',\n      body: JSON.stringify({\n        event_id: event.event_id,\n        action_key: 'ack-v1',\n        content: '已收到你的消息。',\n      }),\n    })\n    if (!reply.ok) throw new Error(`回复失败：${reply.status} ${await reply.text()}`)\n    await reply.json() \u002F\u002F 消费响应体；响应中断时保留游标，重试仍使用原回复键。\n  }\n\n  \u002F\u002F 所有回复成功后才提交整页进度；空页也保存服务端返回的游标。\n  await saveCursor(page.next_after)\n  return page.events.length\n}\n","ts",[521,1772,1773,1809,1841,1853,1863,1872,1897,1929,1943,1947,1953,1972,2004,2026,2060,2093,2156,2211,2279,2305,2309,2335,2375,2390,2426,2441,2456,2475,2490,2505,2521,2530,2537,2594,2611,2616,2620,2625,2643,2659],{"__ignoreMap":634},[638,1774,1775,1778,1781,1784,1787,1791,1793,1796,1799,1802,1804,1806],{"class":640,"line":641},[638,1776,1777],{"class":715},"type",[638,1779,1780],{"class":644}," BotEvent",[638,1782,1783],{"class":648}," =",[638,1785,1786],{"class":648}," {",[638,1788,1790],{"class":1789},"swJcz"," event_id",[638,1792,722],{"class":648},[638,1794,1795],{"class":644}," string",[638,1797,1798],{"class":648},";",[638,1800,1801],{"class":1789}," seq",[638,1803,722],{"class":648},[638,1805,1795],{"class":644},[638,1807,1808],{"class":648}," }\n",[638,1810,1811,1813,1816,1818,1820,1823,1825,1827,1830,1832,1835,1837,1839],{"class":640,"line":663},[638,1812,1777],{"class":715},[638,1814,1815],{"class":644}," EventPage",[638,1817,1783],{"class":648},[638,1819,1786],{"class":648},[638,1821,1822],{"class":1789}," events",[638,1824,722],{"class":648},[638,1826,1780],{"class":644},[638,1828,1829],{"class":659},"[]",[638,1831,1798],{"class":648},[638,1833,1834],{"class":1789}," next_after",[638,1836,722],{"class":648},[638,1838,1795],{"class":644},[638,1840,1808],{"class":648},[638,1842,1843,1845,1848,1850],{"class":640,"line":728},[638,1844,1777],{"class":715},[638,1846,1847],{"class":644}," ConsumerOptions",[638,1849,1783],{"class":648},[638,1851,1852],{"class":648}," {\n",[638,1854,1855,1858,1860],{"class":640,"line":734},[638,1856,1857],{"class":1789},"  baseUrl",[638,1859,722],{"class":648},[638,1861,1862],{"class":644}," string\n",[638,1864,1865,1868,1870],{"class":640,"line":758},[638,1866,1867],{"class":1789},"  token",[638,1869,722],{"class":648},[638,1871,1862],{"class":644},[638,1873,1874,1877,1879,1882,1885,1888,1891,1894],{"class":640,"line":779},[638,1875,1876],{"class":1789},"  loadCursor",[638,1878,722],{"class":648},[638,1880,1881],{"class":648}," ()",[638,1883,1884],{"class":715}," =>",[638,1886,1887],{"class":644}," Promise",[638,1889,1890],{"class":648},"\u003C",[638,1892,1893],{"class":644},"string",[638,1895,1896],{"class":648},">\n",[638,1898,1899,1902,1904,1907,1911,1913,1915,1918,1920,1922,1924,1927],{"class":640,"line":800},[638,1900,1901],{"class":1789},"  saveCursor",[638,1903,722],{"class":648},[638,1905,1906],{"class":648}," (",[638,1908,1910],{"class":1909},"sHdIc","cursor",[638,1912,722],{"class":648},[638,1914,1795],{"class":644},[638,1916,1917],{"class":648},")",[638,1919,1884],{"class":715},[638,1921,1887],{"class":644},[638,1923,1890],{"class":648},[638,1925,1926],{"class":644},"void",[638,1928,1896],{"class":648},[638,1930,1931,1934,1937,1940],{"class":640,"line":815},[638,1932,1933],{"class":1789},"  fetcher",[638,1935,1936],{"class":648},"?:",[638,1938,1939],{"class":648}," typeof",[638,1941,1942],{"class":659}," fetch\n",[638,1944,1945],{"class":640,"line":836},[638,1946,1468],{"class":648},[638,1948,1949],{"class":640,"line":856},[638,1950,1952],{"emptyLinePlaceholder":1951},true,"\n",[638,1954,1955,1959,1962,1965,1969],{"class":640,"line":870},[638,1956,1958],{"class":1957},"s7zQu","export",[638,1960,1961],{"class":715}," async",[638,1963,1964],{"class":715}," function",[638,1966,1968],{"class":1967},"s2Zo4"," consumePage",[638,1970,1971],{"class":648},"({\n",[638,1973,1974,1976,1979,1982,1984,1987,1989,1992,1994,1997,1999,2002],{"class":640,"line":884},[638,1975,1857],{"class":1909},[638,1977,1978],{"class":648},",",[638,1980,1981],{"class":1909}," token",[638,1983,1978],{"class":648},[638,1985,1986],{"class":1909}," loadCursor",[638,1988,1978],{"class":648},[638,1990,1991],{"class":1909}," saveCursor",[638,1993,1978],{"class":648},[638,1995,1996],{"class":1909}," fetcher",[638,1998,1783],{"class":648},[638,2000,2001],{"class":659}," fetch",[638,2003,755],{"class":648},[638,2005,2006,2009,2011,2014,2016,2018,2021,2024],{"class":640,"line":899},[638,2007,2008],{"class":648},"}:",[638,2010,1847],{"class":644},[638,2012,2013],{"class":648},"):",[638,2015,1887],{"class":644},[638,2017,1890],{"class":648},[638,2019,2020],{"class":644},"number",[638,2022,2023],{"class":648},">",[638,2025,1852],{"class":648},[638,2027,2028,2031,2034,2036,2038,2041,2043,2046,2049,2052,2055,2058],{"class":640,"line":920},[638,2029,2030],{"class":715},"  const",[638,2032,2033],{"class":659}," headers",[638,2035,1783],{"class":648},[638,2037,1786],{"class":648},[638,2039,2040],{"class":1789}," Authorization",[638,2042,722],{"class":648},[638,2044,2045],{"class":648}," `",[638,2047,2048],{"class":652},"Bearer ",[638,2050,2051],{"class":648},"${",[638,2053,2054],{"class":659},"token",[638,2056,2057],{"class":648},"}`",[638,2059,1808],{"class":648},[638,2061,2062,2064,2067,2069,2072,2075,2078,2080,2083,2085,2087,2090],{"class":640,"line":941},[638,2063,2030],{"class":715},[638,2065,2066],{"class":659}," url",[638,2068,1783],{"class":648},[638,2070,2071],{"class":648}," new",[638,2073,2074],{"class":1967}," URL",[638,2076,2077],{"class":1789},"(",[638,2079,656],{"class":648},[638,2081,2082],{"class":652},"\u002Fv1\u002Fbots\u002Fme\u002Fevents",[638,2084,656],{"class":648},[638,2086,1978],{"class":648},[638,2088,2089],{"class":659}," baseUrl",[638,2091,2092],{"class":1789},")\n",[638,2094,2095,2098,2101,2104,2106,2108,2111,2113,2116,2119,2121,2124,2126,2129,2131,2134,2136,2138,2141,2143,2146,2148,2150,2153],{"class":640,"line":961},[638,2096,2097],{"class":659},"  url",[638,2099,2100],{"class":648},".",[638,2102,2103],{"class":659},"search",[638,2105,1783],{"class":648},[638,2107,2071],{"class":648},[638,2109,2110],{"class":1967}," URLSearchParams",[638,2112,2077],{"class":1789},[638,2114,2115],{"class":648},"{",[638,2117,2118],{"class":1789}," after",[638,2120,722],{"class":648},[638,2122,2123],{"class":1957}," await",[638,2125,1986],{"class":1967},[638,2127,2128],{"class":1789},"()",[638,2130,1978],{"class":648},[638,2132,2133],{"class":1789}," limit",[638,2135,722],{"class":648},[638,2137,649],{"class":648},[638,2139,2140],{"class":652},"50",[638,2142,656],{"class":648},[638,2144,2145],{"class":648}," }",[638,2147,1917],{"class":1789},[638,2149,2100],{"class":648},[638,2151,2152],{"class":1967},"toString",[638,2154,2155],{"class":1789},"()\n",[638,2157,2158,2160,2163,2165,2167,2169,2171,2174,2176,2178,2180,2182,2185,2187,2189,2192,2194,2196,2199,2201,2203,2205,2207,2209],{"class":640,"line":967},[638,2159,2030],{"class":715},[638,2161,2162],{"class":659}," response",[638,2164,1783],{"class":648},[638,2166,2123],{"class":1957},[638,2168,1996],{"class":1967},[638,2170,2077],{"class":1789},[638,2172,2173],{"class":659},"url",[638,2175,1978],{"class":648},[638,2177,1786],{"class":648},[638,2179,2033],{"class":659},[638,2181,1978],{"class":648},[638,2183,2184],{"class":1789}," credentials",[638,2186,722],{"class":648},[638,2188,649],{"class":648},[638,2190,2191],{"class":652},"omit",[638,2193,656],{"class":648},[638,2195,1978],{"class":648},[638,2197,2198],{"class":1789}," redirect",[638,2200,722],{"class":648},[638,2202,649],{"class":648},[638,2204,267],{"class":652},[638,2206,656],{"class":648},[638,2208,2145],{"class":648},[638,2210,2092],{"class":1789},[638,2212,2213,2216,2218,2221,2224,2226,2229,2232,2235,2237,2240,2242,2245,2248,2250,2252,2254,2257,2260,2263,2266,2268,2270,2273,2275,2277],{"class":640,"line":972},[638,2214,2215],{"class":1957},"  if",[638,2217,1906],{"class":1789},[638,2219,2220],{"class":648},"!",[638,2222,2223],{"class":659},"response",[638,2225,2100],{"class":648},[638,2227,2228],{"class":659},"ok",[638,2230,2231],{"class":1789},") ",[638,2233,2234],{"class":1957},"throw",[638,2236,2071],{"class":648},[638,2238,2239],{"class":1967}," Error",[638,2241,2077],{"class":1789},[638,2243,2244],{"class":648},"`",[638,2246,2247],{"class":652},"读取失败：",[638,2249,2051],{"class":648},[638,2251,2223],{"class":659},[638,2253,2100],{"class":648},[638,2255,2256],{"class":659},"status",[638,2258,2259],{"class":648},"}",[638,2261,2262],{"class":648}," ${",[638,2264,2265],{"class":1957},"await",[638,2267,2162],{"class":659},[638,2269,2100],{"class":648},[638,2271,2272],{"class":1967},"text",[638,2274,2128],{"class":659},[638,2276,2057],{"class":648},[638,2278,2092],{"class":1789},[638,2280,2281,2283,2286,2288,2290,2292,2294,2296,2299,2302],{"class":640,"line":992},[638,2282,2030],{"class":715},[638,2284,2285],{"class":659}," page",[638,2287,1783],{"class":648},[638,2289,2123],{"class":1957},[638,2291,2162],{"class":659},[638,2293,2100],{"class":648},[638,2295,700],{"class":1967},[638,2297,2298],{"class":1789},"() ",[638,2300,2301],{"class":1957},"as",[638,2303,2304],{"class":644}," EventPage\n",[638,2306,2307],{"class":640,"line":1012},[638,2308,1952],{"emptyLinePlaceholder":1951},[638,2310,2311,2314,2316,2319,2322,2325,2327,2329,2331,2333],{"class":640,"line":1032},[638,2312,2313],{"class":1957},"  for",[638,2315,1906],{"class":1789},[638,2317,2318],{"class":715},"const",[638,2320,2321],{"class":659}," event",[638,2323,2324],{"class":648}," of",[638,2326,2285],{"class":659},[638,2328,2100],{"class":648},[638,2330,716],{"class":659},[638,2332,2231],{"class":1789},[638,2334,707],{"class":648},[638,2336,2337,2340,2343,2345,2347,2349,2351,2354,2356,2358,2360,2363,2365,2367,2369,2371,2373],{"class":640,"line":1052},[638,2338,2339],{"class":715},"    const",[638,2341,2342],{"class":659}," reply",[638,2344,1783],{"class":648},[638,2346,2123],{"class":1957},[638,2348,1996],{"class":1967},[638,2350,2077],{"class":1789},[638,2352,2353],{"class":648},"new",[638,2355,2074],{"class":1967},[638,2357,2077],{"class":1789},[638,2359,656],{"class":648},[638,2361,2362],{"class":652},"\u002Fv1\u002Fbots\u002Fme\u002Freplies",[638,2364,656],{"class":648},[638,2366,1978],{"class":648},[638,2368,2089],{"class":659},[638,2370,1917],{"class":1789},[638,2372,1978],{"class":648},[638,2374,1852],{"class":648},[638,2376,2377,2380,2382,2384,2386,2388],{"class":640,"line":1065},[638,2378,2379],{"class":1789},"      method",[638,2381,722],{"class":648},[638,2383,649],{"class":648},[638,2385,244],{"class":652},[638,2387,656],{"class":648},[638,2389,755],{"class":648},[638,2391,2392,2395,2397,2399,2402,2405,2407,2409,2412,2414,2416,2418,2421,2423],{"class":640,"line":1084},[638,2393,2394],{"class":1789},"      headers",[638,2396,722],{"class":648},[638,2398,1786],{"class":648},[638,2400,2401],{"class":648}," ...",[638,2403,2404],{"class":659},"headers",[638,2406,1978],{"class":648},[638,2408,649],{"class":648},[638,2410,2411],{"class":1789},"Content-Type",[638,2413,656],{"class":648},[638,2415,722],{"class":648},[638,2417,649],{"class":648},[638,2419,2420],{"class":652},"application\u002Fjson",[638,2422,656],{"class":648},[638,2424,2425],{"class":648}," },\n",[638,2427,2428,2431,2433,2435,2437,2439],{"class":640,"line":1104},[638,2429,2430],{"class":1789},"      credentials",[638,2432,722],{"class":648},[638,2434,649],{"class":648},[638,2436,2191],{"class":652},[638,2438,656],{"class":648},[638,2440,755],{"class":648},[638,2442,2443,2446,2448,2450,2452,2454],{"class":640,"line":1121},[638,2444,2445],{"class":1789},"      redirect",[638,2447,722],{"class":648},[638,2449,649],{"class":648},[638,2451,267],{"class":652},[638,2453,656],{"class":648},[638,2455,755],{"class":648},[638,2457,2458,2461,2463,2466,2468,2471,2473],{"class":640,"line":1145},[638,2459,2460],{"class":1789},"      body",[638,2462,722],{"class":648},[638,2464,2465],{"class":659}," JSON",[638,2467,2100],{"class":648},[638,2469,2470],{"class":1967},"stringify",[638,2472,2077],{"class":1789},[638,2474,707],{"class":648},[638,2476,2477,2480,2482,2484,2486,2488],{"class":640,"line":1165},[638,2478,2479],{"class":1789},"        event_id",[638,2481,722],{"class":648},[638,2483,2321],{"class":659},[638,2485,2100],{"class":648},[638,2487,740],{"class":659},[638,2489,755],{"class":648},[638,2491,2492,2495,2497,2499,2501,2503],{"class":640,"line":1184},[638,2493,2494],{"class":1789},"        action_key",[638,2496,722],{"class":648},[638,2498,649],{"class":648},[638,2500,1764],{"class":652},[638,2502,656],{"class":648},[638,2504,755],{"class":648},[638,2506,2507,2510,2512,2514,2517,2519],{"class":640,"line":1202},[638,2508,2509],{"class":1789},"        content",[638,2511,722],{"class":648},[638,2513,649],{"class":648},[638,2515,2516],{"class":652},"已收到你的消息。",[638,2518,656],{"class":648},[638,2520,755],{"class":648},[638,2522,2523,2526,2528],{"class":640,"line":1207},[638,2524,2525],{"class":648},"      }",[638,2527,1917],{"class":1789},[638,2529,755],{"class":648},[638,2531,2532,2535],{"class":640,"line":1212},[638,2533,2534],{"class":648},"    }",[638,2536,2092],{"class":1789},[638,2538,2539,2542,2544,2546,2549,2551,2553,2555,2557,2559,2561,2563,2565,2568,2570,2572,2574,2576,2578,2580,2582,2584,2586,2588,2590,2592],{"class":640,"line":1232},[638,2540,2541],{"class":1957},"    if",[638,2543,1906],{"class":1789},[638,2545,2220],{"class":648},[638,2547,2548],{"class":659},"reply",[638,2550,2100],{"class":648},[638,2552,2228],{"class":659},[638,2554,2231],{"class":1789},[638,2556,2234],{"class":1957},[638,2558,2071],{"class":648},[638,2560,2239],{"class":1967},[638,2562,2077],{"class":1789},[638,2564,2244],{"class":648},[638,2566,2567],{"class":652},"回复失败：",[638,2569,2051],{"class":648},[638,2571,2548],{"class":659},[638,2573,2100],{"class":648},[638,2575,2256],{"class":659},[638,2577,2259],{"class":648},[638,2579,2262],{"class":648},[638,2581,2265],{"class":1957},[638,2583,2342],{"class":659},[638,2585,2100],{"class":648},[638,2587,2272],{"class":1967},[638,2589,2128],{"class":659},[638,2591,2057],{"class":648},[638,2593,2092],{"class":1789},[638,2595,2596,2599,2601,2603,2605,2607],{"class":640,"line":1252},[638,2597,2598],{"class":1957},"    await",[638,2600,2342],{"class":659},[638,2602,2100],{"class":648},[638,2604,700],{"class":1967},[638,2606,2298],{"class":1789},[638,2608,2610],{"class":2609},"sHwdD","\u002F\u002F 消费响应体；响应中断时保留游标，重试仍使用原回复键。\n",[638,2612,2613],{"class":640,"line":1272},[638,2614,2615],{"class":648},"  }\n",[638,2617,2618],{"class":640,"line":1291},[638,2619,1952],{"emptyLinePlaceholder":1951},[638,2621,2622],{"class":640,"line":1304},[638,2623,2624],{"class":2609},"  \u002F\u002F 所有回复成功后才提交整页进度；空页也保存服务端返回的游标。\n",[638,2626,2627,2630,2632,2634,2637,2639,2641],{"class":640,"line":1323},[638,2628,2629],{"class":1957},"  await",[638,2631,1991],{"class":1967},[638,2633,2077],{"class":1789},[638,2635,2636],{"class":659},"page",[638,2638,2100],{"class":648},[638,2640,1452],{"class":659},[638,2642,2092],{"class":1789},[638,2644,2645,2648,2650,2652,2654,2656],{"class":640,"line":1342},[638,2646,2647],{"class":1957},"  return",[638,2649,2285],{"class":659},[638,2651,2100],{"class":648},[638,2653,716],{"class":659},[638,2655,2100],{"class":648},[638,2657,2658],{"class":659},"length\n",[638,2660,2661],{"class":640,"line":1357},[638,2662,1468],{"class":648},[506,2664,2665,2666,2669,2670,567,2673,2676,2677,2680],{},"例如在 Node.js 中用本地文件保存游标。将以下内容保存为同目录的 ",[521,2667,2668],{},"run-bot.ts","，配置环境变量 ",[521,2671,2672],{},"BOT_TOKEN",[521,2674,2675],{},"BOT_API_ORIGIN","，使用支持 TypeScript 的 Node.js 运行 ",[521,2678,2679],{},"node run-bot.ts","：",[629,2682,2684],{"className":1768,"code":2683,"language":1770,"meta":634,"style":634},"import { readFile, writeFile, rename } from 'node:fs\u002Fpromises'\nimport { setTimeout as delay } from 'node:timers\u002Fpromises'\nimport { consumePage } from '.\u002Fbot-consumer.ts'\n\nconst token = process.env.BOT_TOKEN\nconst baseUrl = process.env.BOT_API_ORIGIN\nif (!token || !baseUrl) throw new Error('请配置 BOT_TOKEN 与 BOT_API_ORIGIN')\nconst cursorFile = new URL('.\u002Fbot-cursor.txt', import.meta.url)\nconst temporaryFile = new URL('.\u002Fbot-cursor.tmp', import.meta.url)\n\nasync function loadCursor(): Promise\u003Cstring> {\n  try { return (await readFile(cursorFile, 'utf8')).trim() }\n  catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return '0'\n    throw error\n  }\n}\n\nasync function saveCursor(cursor: string): Promise\u003Cvoid> {\n  await writeFile(temporaryFile, cursor, 'utf8')\n  await rename(temporaryFile, cursorFile)\n}\n\nwhile (true) {\n  const count = await consumePage({ baseUrl, token, loadCursor, saveCursor })\n  if (count === 0) await delay(5000)\n}\n",[521,2685,2686,2718,2744,2763,2767,2790,2810,2848,2885,2919,2923,2945,2987,3000,3047,3055,3059,3063,3067,3095,3121,3138,3142,3146,3161,3196,3223],{"__ignoreMap":634},[638,2687,2688,2691,2693,2696,2698,2701,2703,2706,2708,2711,2713,2716],{"class":640,"line":641},[638,2689,2690],{"class":1957},"import",[638,2692,1786],{"class":648},[638,2694,2695],{"class":659}," readFile",[638,2697,1978],{"class":648},[638,2699,2700],{"class":659}," writeFile",[638,2702,1978],{"class":648},[638,2704,2705],{"class":659}," rename",[638,2707,2145],{"class":648},[638,2709,2710],{"class":1957}," from",[638,2712,649],{"class":648},[638,2714,2715],{"class":652},"node:fs\u002Fpromises",[638,2717,674],{"class":648},[638,2719,2720,2722,2724,2727,2730,2733,2735,2737,2739,2742],{"class":640,"line":663},[638,2721,2690],{"class":1957},[638,2723,1786],{"class":648},[638,2725,2726],{"class":659}," setTimeout",[638,2728,2729],{"class":1957}," as",[638,2731,2732],{"class":659}," delay",[638,2734,2145],{"class":648},[638,2736,2710],{"class":1957},[638,2738,649],{"class":648},[638,2740,2741],{"class":652},"node:timers\u002Fpromises",[638,2743,674],{"class":648},[638,2745,2746,2748,2750,2752,2754,2756,2758,2761],{"class":640,"line":728},[638,2747,2690],{"class":1957},[638,2749,1786],{"class":648},[638,2751,1968],{"class":659},[638,2753,2145],{"class":648},[638,2755,2710],{"class":1957},[638,2757,649],{"class":648},[638,2759,2760],{"class":652},".\u002Fbot-consumer.ts",[638,2762,674],{"class":648},[638,2764,2765],{"class":640,"line":734},[638,2766,1952],{"emptyLinePlaceholder":1951},[638,2768,2769,2771,2774,2777,2780,2782,2785,2787],{"class":640,"line":758},[638,2770,2318],{"class":715},[638,2772,2773],{"class":659}," token ",[638,2775,2776],{"class":648},"=",[638,2778,2779],{"class":659}," process",[638,2781,2100],{"class":648},[638,2783,2784],{"class":659},"env",[638,2786,2100],{"class":648},[638,2788,2789],{"class":659},"BOT_TOKEN\n",[638,2791,2792,2794,2797,2799,2801,2803,2805,2807],{"class":640,"line":779},[638,2793,2318],{"class":715},[638,2795,2796],{"class":659}," baseUrl ",[638,2798,2776],{"class":648},[638,2800,2779],{"class":659},[638,2802,2100],{"class":648},[638,2804,2784],{"class":659},[638,2806,2100],{"class":648},[638,2808,2809],{"class":659},"BOT_API_ORIGIN\n",[638,2811,2812,2815,2817,2819,2822,2825,2828,2831,2833,2835,2837,2839,2841,2844,2846],{"class":640,"line":800},[638,2813,2814],{"class":1957},"if",[638,2816,1906],{"class":659},[638,2818,2220],{"class":648},[638,2820,2821],{"class":659},"token ",[638,2823,2824],{"class":648},"||",[638,2826,2827],{"class":648}," !",[638,2829,2830],{"class":659},"baseUrl) ",[638,2832,2234],{"class":1957},[638,2834,2071],{"class":648},[638,2836,2239],{"class":1967},[638,2838,2077],{"class":659},[638,2840,656],{"class":648},[638,2842,2843],{"class":652},"请配置 BOT_TOKEN 与 BOT_API_ORIGIN",[638,2845,656],{"class":648},[638,2847,2092],{"class":659},[638,2849,2850,2852,2855,2857,2859,2861,2863,2865,2868,2870,2872,2875,2877,2880,2882],{"class":640,"line":815},[638,2851,2318],{"class":715},[638,2853,2854],{"class":659}," cursorFile ",[638,2856,2776],{"class":648},[638,2858,2071],{"class":648},[638,2860,2074],{"class":1967},[638,2862,2077],{"class":659},[638,2864,656],{"class":648},[638,2866,2867],{"class":652},".\u002Fbot-cursor.txt",[638,2869,656],{"class":648},[638,2871,1978],{"class":648},[638,2873,2874],{"class":1957}," import",[638,2876,2100],{"class":648},[638,2878,2879],{"class":659},"meta",[638,2881,2100],{"class":648},[638,2883,2884],{"class":659},"url)\n",[638,2886,2887,2889,2892,2894,2896,2898,2900,2902,2905,2907,2909,2911,2913,2915,2917],{"class":640,"line":836},[638,2888,2318],{"class":715},[638,2890,2891],{"class":659}," temporaryFile ",[638,2893,2776],{"class":648},[638,2895,2071],{"class":648},[638,2897,2074],{"class":1967},[638,2899,2077],{"class":659},[638,2901,656],{"class":648},[638,2903,2904],{"class":652},".\u002Fbot-cursor.tmp",[638,2906,656],{"class":648},[638,2908,1978],{"class":648},[638,2910,2874],{"class":1957},[638,2912,2100],{"class":648},[638,2914,2879],{"class":659},[638,2916,2100],{"class":648},[638,2918,2884],{"class":659},[638,2920,2921],{"class":640,"line":856},[638,2922,1952],{"emptyLinePlaceholder":1951},[638,2924,2925,2928,2930,2932,2935,2937,2939,2941,2943],{"class":640,"line":870},[638,2926,2927],{"class":715},"async",[638,2929,1964],{"class":715},[638,2931,1986],{"class":1967},[638,2933,2934],{"class":648},"():",[638,2936,1887],{"class":644},[638,2938,1890],{"class":648},[638,2940,1893],{"class":644},[638,2942,2023],{"class":648},[638,2944,1852],{"class":648},[638,2946,2947,2950,2952,2955,2957,2959,2961,2963,2966,2968,2970,2973,2975,2978,2980,2983,2985],{"class":640,"line":884},[638,2948,2949],{"class":1957},"  try",[638,2951,1786],{"class":648},[638,2953,2954],{"class":1957}," return",[638,2956,1906],{"class":1789},[638,2958,2265],{"class":1957},[638,2960,2695],{"class":1967},[638,2962,2077],{"class":1789},[638,2964,2965],{"class":659},"cursorFile",[638,2967,1978],{"class":648},[638,2969,649],{"class":648},[638,2971,2972],{"class":652},"utf8",[638,2974,656],{"class":648},[638,2976,2977],{"class":1789},"))",[638,2979,2100],{"class":648},[638,2981,2982],{"class":1967},"trim",[638,2984,2298],{"class":1789},[638,2986,1468],{"class":648},[638,2988,2989,2992,2994,2996,2998],{"class":640,"line":899},[638,2990,2991],{"class":1957},"  catch",[638,2993,1906],{"class":1789},[638,2995,267],{"class":659},[638,2997,2231],{"class":1789},[638,2999,707],{"class":648},[638,3001,3002,3004,3007,3009,3011,3014,3016,3019,3021,3023,3025,3028,3030,3033,3035,3037,3040,3042,3045],{"class":640,"line":920},[638,3003,2541],{"class":1957},[638,3005,3006],{"class":1789}," ((",[638,3008,267],{"class":659},[638,3010,2729],{"class":1957},[638,3012,3013],{"class":644}," NodeJS",[638,3015,2100],{"class":648},[638,3017,3018],{"class":644},"ErrnoException",[638,3020,1917],{"class":1789},[638,3022,2100],{"class":648},[638,3024,521],{"class":659},[638,3026,3027],{"class":648}," ===",[638,3029,649],{"class":648},[638,3031,3032],{"class":652},"ENOENT",[638,3034,656],{"class":648},[638,3036,2231],{"class":1789},[638,3038,3039],{"class":1957},"return",[638,3041,649],{"class":648},[638,3043,3044],{"class":652},"0",[638,3046,674],{"class":648},[638,3048,3049,3052],{"class":640,"line":941},[638,3050,3051],{"class":1957},"    throw",[638,3053,3054],{"class":659}," error\n",[638,3056,3057],{"class":640,"line":961},[638,3058,2615],{"class":648},[638,3060,3061],{"class":640,"line":967},[638,3062,1468],{"class":648},[638,3064,3065],{"class":640,"line":972},[638,3066,1952],{"emptyLinePlaceholder":1951},[638,3068,3069,3071,3073,3075,3077,3079,3081,3083,3085,3087,3089,3091,3093],{"class":640,"line":992},[638,3070,2927],{"class":715},[638,3072,1964],{"class":715},[638,3074,1991],{"class":1967},[638,3076,2077],{"class":648},[638,3078,1910],{"class":1909},[638,3080,722],{"class":648},[638,3082,1795],{"class":644},[638,3084,2013],{"class":648},[638,3086,1887],{"class":644},[638,3088,1890],{"class":648},[638,3090,1926],{"class":644},[638,3092,2023],{"class":648},[638,3094,1852],{"class":648},[638,3096,3097,3099,3101,3103,3106,3108,3111,3113,3115,3117,3119],{"class":640,"line":1012},[638,3098,2629],{"class":1957},[638,3100,2700],{"class":1967},[638,3102,2077],{"class":1789},[638,3104,3105],{"class":659},"temporaryFile",[638,3107,1978],{"class":648},[638,3109,3110],{"class":659}," cursor",[638,3112,1978],{"class":648},[638,3114,649],{"class":648},[638,3116,2972],{"class":652},[638,3118,656],{"class":648},[638,3120,2092],{"class":1789},[638,3122,3123,3125,3127,3129,3131,3133,3136],{"class":640,"line":1032},[638,3124,2629],{"class":1957},[638,3126,2705],{"class":1967},[638,3128,2077],{"class":1789},[638,3130,3105],{"class":659},[638,3132,1978],{"class":648},[638,3134,3135],{"class":659}," cursorFile",[638,3137,2092],{"class":1789},[638,3139,3140],{"class":640,"line":1052},[638,3141,1468],{"class":648},[638,3143,3144],{"class":640,"line":1065},[638,3145,1952],{"emptyLinePlaceholder":1951},[638,3147,3148,3151,3153,3157,3159],{"class":640,"line":1084},[638,3149,3150],{"class":1957},"while",[638,3152,1906],{"class":659},[638,3154,3156],{"class":3155},"sfNiH","true",[638,3158,2231],{"class":659},[638,3160,707],{"class":648},[638,3162,3163,3165,3168,3170,3172,3174,3176,3178,3180,3182,3184,3186,3188,3190,3192,3194],{"class":640,"line":1104},[638,3164,2030],{"class":715},[638,3166,3167],{"class":659}," count",[638,3169,1783],{"class":648},[638,3171,2123],{"class":1957},[638,3173,1968],{"class":1967},[638,3175,2077],{"class":1789},[638,3177,2115],{"class":648},[638,3179,2089],{"class":659},[638,3181,1978],{"class":648},[638,3183,1981],{"class":659},[638,3185,1978],{"class":648},[638,3187,1986],{"class":659},[638,3189,1978],{"class":648},[638,3191,1991],{"class":659},[638,3193,2145],{"class":648},[638,3195,2092],{"class":1789},[638,3197,3198,3200,3202,3205,3207,3210,3212,3214,3216,3218,3221],{"class":640,"line":1121},[638,3199,2215],{"class":1957},[638,3201,1906],{"class":1789},[638,3203,3204],{"class":659},"count",[638,3206,3027],{"class":648},[638,3208,3209],{"class":1115}," 0",[638,3211,2231],{"class":1789},[638,3213,2265],{"class":1957},[638,3215,2732],{"class":1967},[638,3217,2077],{"class":1789},[638,3219,3220],{"class":1115},"5000",[638,3222,2092],{"class":1789},[638,3224,3225],{"class":640,"line":1145},[638,3226,1468],{"class":648},[506,3228,3229],{},"此示例使用单进程，每页完成后替换游标文件。发生读取、回复或保存错误时会停止，排查后可使用原游标重启；上一页已成功的确认会通过相同回复键去重。若还要写数据库、调用第三方服务等，应为这些副作用另外保存处理状态和幂等键，事件回复接口不会替你的业务事务去重。",[526,3231,3233],{"id":3232},"websocket-变化提示","WebSocket 变化提示",[506,3235,3236,3237,3240,3241,3243,3244,3247,3248,3251],{},"连接 ",[521,3238,3239],{},"wss:\u002F\u002F\u003CAPI 域名>\u002Fv1\u002Fbots\u002Fme\u002Fevents\u002Fstream","，握手时使用 ",[521,3242,671],{},"。接口拒绝 Cookie、URL 查询参数、请求正文和 ",[521,3245,3246],{},"Sec-WebSocket-Protocol","；令牌不要放进 URL。网页原生 ",[521,3249,3250],{},"WebSocket"," 不能设置这个请求头，应使用支持自定义握手头的服务端客户端。",[506,3253,3254],{},"唯一的应用层通知如下：",[629,3256,3258],{"className":698,"code":3257,"language":700,"meta":634,"style":634},"{\"event\":\"bot_events_changed\"}\n",[521,3259,3260],{"__ignoreMap":634},[638,3261,3262,3264,3266,3269,3271,3273,3275,3278,3280],{"class":640,"line":641},[638,3263,2115],{"class":648},[638,3265,719],{"class":648},[638,3267,3268],{"class":715},"event",[638,3270,719],{"class":648},[638,3272,722],{"class":648},[638,3274,719],{"class":648},[638,3276,3277],{"class":652},"bot_events_changed",[638,3279,719],{"class":648},[638,3281,1468],{"class":648},[506,3283,3284],{},"收到通知后调用读取接口。通知没有事件序号、正文或确认机制，可以合并、重复或丢失；新连接不会为已有待处理事件发送初始提示，所以建连后应立即补取，并保留周期性 HTTP 轮询。",[506,3286,3287,3288,3290],{},"客户端不发送订阅或确认消息，任何客户端应用数据帧（包括空帧）都会使连接结束；标准 ping\u002Fpong 控制帧由客户端库正常处理。每条连接最长 30 分钟，每个 token 最多 2 条、每个网关实例最多 64 条连接。断流后适当退避重连，继续从持久化 ",[521,3289,1452],{}," 获取正文；不要因为断流把游标重置为零。",[526,3292,3293],{"id":3293},"错误与事件保留",[530,3295,3296,3306],{},[533,3297,3298],{},[536,3299,3300,3303],{},[539,3301,3302],{},"HTTP 状态",[539,3304,3305],{},"处理方式",[549,3307,3308,3318,3328,3338,3348,3358],{},[536,3309,3310,3315],{},[554,3311,3312],{},[521,3313,3314],{},"400",[554,3316,3317],{},"检查参数格式、游标上限和正文；修正后再请求",[536,3319,3320,3325],{},[554,3321,3322],{},[521,3323,3324],{},"401",[554,3326,3327],{},"检查机器人 PAT 是否失效或过期，更新凭据",[536,3329,3330,3335],{},[554,3331,3332],{},[521,3333,3334],{},"403",[554,3336,3337],{},"检查 scope、当前授权、账号状态及会话或房间资格；不要靠重复请求绕过",[536,3339,3340,3345],{},[554,3341,3342],{},[521,3343,3344],{},"404",[554,3346,3347],{},"源事件或消息不存在，可能已删除或被清理；记录处置后再决定是否跳过",[536,3349,3350,3355],{},[554,3351,3352],{},[521,3353,3354],{},"429",[554,3356,3357],{},"读取响应中的限流信息并退避；若已达到每事件五个回复上限，不再创建新回复键",[536,3359,3360,3366],{},[554,3361,3362,3365],{},[521,3363,3364],{},"5xx"," 或网络中断",[554,3367,3368],{},"保留游标，退避后重试同一动作；发送结果未知时也沿用原回复键",[506,3370,3371],{},"事件与关联回复幂等记录按事件创建时间保留 90 天，后台分批清理；不以最后回复时间延长。清理不删除聊天消息，也不重置事件序号，但旧事件将不能继续回复。长期离线可能丢失未处理事件，不应依赖从零重放完整聊天历史。",[506,3373,3374,3375,3378],{},"机器人事件与",[510,3376,3377],{"href":84},"资源 Webhook","是不同通道：前者用于机器人消息和指令，后者投递资源发布变化；Webhook 的网站 Cookie 管理接口不接受机器人 PAT。",[3380,3381,3382],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}",{"title":634,"searchDepth":663,"depth":663,"links":3384},[3385,3386,3389,3390,3391,3392],{"id":528,"depth":663,"text":528},{"id":627,"depth":663,"text":627,"children":3387},[3388],{"id":1609,"depth":728,"text":1609},{"id":1640,"depth":663,"text":1640},{"id":1753,"depth":663,"text":1754},{"id":3232,"depth":663,"text":3233},{"id":3293,"depth":663,"text":3293},"了解私信和房间指令事件，按游标读取消息、可靠回复，并在断线后继续处理。","md",null,{},{"title":95,"description":3393},"VFzZJ03us6UKeNUij_GoqLqnOjTyWM-l0Juxo9ibMss",[3400,3402],{"title":91,"path":92,"stem":93,"description":3401,"children":-1},"创建个人机器人、申请权限，并通过个人 API 和事件接口处理消息。",{"title":99,"path":100,"stem":101,"description":3403,"children":-1},"使用 Atom 阅读器关注教程与资源的公开更新。",1795179031935]