[{"data":1,"prerenderedAt":784},["ShallowReactive",2],{"navigation_docs":3,"-guide-bot-accounts":500,"-guide-bot-accounts-surround":779},[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":91,"body":502,"description":772,"extension":773,"links":774,"meta":775,"navigation":776,"path":92,"seo":777,"stem":93,"__hash__":778},"docs\u002F1.guide\u002F8.bot-accounts.md",{"type":503,"value":504,"toc":767},"minimark",[505,509,513,526,529,536,539,551,554,561,564,570,593,640,670,679,742,760,763],[506,507,508],"p",{},"机器人使用独立账号发布内容和发送回复。资源、帖子与消息显示机器人的身份，公开主页标明其所有者。个人用户可在网站设置的开放中心创建和管理自己的机器人；官方通知账号另行管理。",[510,511,512],"h2",{"id":512},"创建与授权",[514,515,516,520,523],"ol",{},[517,518,519],"li",{},"在开放中心创建机器人并编辑展示资料、头像与简介。",[517,521,522],{},"申请所需的权限和全站指令。每次申请提交完整的权限与指令清单；审核期间，已有的生效授权继续有效。",[517,524,525],{},"授权生效后，为机器人创建 PAT，勾选该令牌实际需要的 scope。令牌明文只显示一次。",[506,527,528],{},"资源、帖子、本人资料和组织的 14 项普通个人 API 权限默认都需要审核，包括读取权限。私信与房间事件权限各有策略；平台可将权限设置为自动批准、需要审核或禁用。生效授权、令牌 scope、内容所有权及操作时的账号状态会共同决定一次调用能否成功。策略禁用或账号停用会阻断已有授权。",[506,530,531,532,535],{},"机器人 PAT 只能代表该机器人，不能创建网站会话，也不能访问后台或媒体控制。使用普通个人 API 时，请参照",[533,534,226],"a",{"href":228},"中每项操作的 scope 与参数；机器人调用同一路径，资源、帖子和组织的归属由机器人身份决定。人工账号的 PAT 或 OAuth access token 不能代替机器人 PAT 调用机器人事件接口。",[510,537,538],{"id":538},"房间指令",[506,540,541,542,546,547,550],{},"机器人的指令清单在全站统一登记，房间管理者决定在自己的房间启用哪些指令。",[543,544,545],"code",{},"@handle 查服 参数"," 或有效的开头结构化提及需要机器人提及权限；无需提及的 ",[543,548,549],{},"\u002F查服 参数"," 需要另外申请房间指令权限，默认进入审核。指令名称精确匹配，且可配置最少和最多参数数量。私聊由用户先发起，机器人只能对收到的事件回复，不能主动私信尚未与其互动的用户。",[506,552,553],{},"无 @ 触发权限随完整指令清单申请，管理员可逐条核准哪些指令能无需 @ 触发；未核准的指令仍可按提及权限使用。房间管理者仍需逐条选择本房间启用的指令。",[506,555,556,557,560],{},"公开机器人目录支持按名称或账号标识搜索，每次返回最多 20 个机器人；继续查询时传入上次响应的 ",[543,558,559],{},"next_cursor","，搜索词必须保持一致。目录接口单独限制每分钟最多 20 次请求。房间管理者仍须在房间内明确启用机器人及可用指令。",[510,562,563],{"id":563},"接收事件和回复",[506,565,566,567,569],{},"完整字段、三类事件示例、TypeScript 消费代码与断线恢复见",[533,568,95],{"href":96},"。",[506,571,572,575,576,579,580,583,584,587,588,592],{},[533,573,574],{"href":485},"机器人事件参考","提供 ",[543,577,578],{},"GET \u002Fv1\u002Fbots\u002Fme\u002Fevents"," 和 ",[543,581,582],{},"POST \u002Fv1\u002Fbots\u002Fme\u002Freplies","。两者使用机器人 PAT 的 ",[543,585,586],{},"bot:events:read","；回复时还会再次检查该事件对应的私信或房间回复权限。下面的地址仅为本地示例，实际地址以 ",[533,589,591],{"href":590},"\u002Fopenapi\u002Fbots.json","bots.json"," 中的服务地址为准。",[594,595,600],"pre",{"className":596,"code":597,"language":598,"meta":599,"style":599},"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","",[543,601,602,626],{"__ignoreMap":599},[603,604,607,611,615,619,622],"span",{"class":605,"line":606},"line",1,[603,608,610],{"class":609},"sBMFI","curl",[603,612,614],{"class":613},"sMK4o"," '",[603,616,618],{"class":617},"sfazB","http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Fevents?after=0&limit=50",[603,620,621],{"class":613},"'",[603,623,625],{"class":624},"sTEyZ"," \\\n",[603,627,629,632,634,637],{"class":605,"line":628},2,[603,630,631],{"class":617},"  -H",[603,633,614],{"class":613},[603,635,636],{"class":617},"Authorization: Bearer \u003Cbot-pat>",[603,638,639],{"class":613},"'\n",[506,641,642,643,646,647,650,651,654,655,657,658,661,662,665,666,669],{},"按返回的 ",[543,644,645],{},"next_after"," 保存消费位置，重启后继续补取。事件中的 ",[543,648,649],{},"event_id"," 可用于回复；",[543,652,653],{},"action_key"," 由机器人为本次动作稳定生成。同一机器人、事件和 ",[543,656,653],{}," 只以首次提交为准：即使后续提交的 ",[543,659,660],{},"content"," 不同，也会返回首次发送的 ",[543,663,664],{},"message_id","（",[543,667,668],{},"duplicate: true","），不会修改或再次发送消息。幂等重试仍须通过当前资格复核；每个事件最多接受 5 个新的回复键，不同业务动作使用不同键。",[506,671,672,673,675,676,678],{},"机器人事件及其回复幂等记录的保留期为 90 天，后台会分批清理到期记录。清理后不能再用旧 ",[543,674,649],{}," 回复；聊天消息不受影响，事件序号也不会重置。因此客户端应持续保存 ",[543,677,645],{},"，不要依赖从零开始重新获取全部历史事件。",[594,680,682],{"className":596,"code":681,"language":598,"meta":599,"style":599},"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\":\"\u003Cevent-id>\",\"action_key\":\"lookup-1\",\"content\":\"服务器在线\"}'\n",[543,683,684,703,715,729],{"__ignoreMap":599},[603,685,686,688,691,694,696,699,701],{"class":605,"line":606},[603,687,610],{"class":609},[603,689,690],{"class":617}," -X",[603,692,693],{"class":617}," POST",[603,695,614],{"class":613},[603,697,698],{"class":617},"http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Freplies",[603,700,621],{"class":613},[603,702,625],{"class":624},[603,704,705,707,709,711,713],{"class":605,"line":628},[603,706,631],{"class":617},[603,708,614],{"class":613},[603,710,636],{"class":617},[603,712,621],{"class":613},[603,714,625],{"class":624},[603,716,718,720,722,725,727],{"class":605,"line":717},3,[603,719,631],{"class":617},[603,721,614],{"class":613},[603,723,724],{"class":617},"Content-Type: application\u002Fjson",[603,726,621],{"class":613},[603,728,625],{"class":624},[603,730,732,735,737,740],{"class":605,"line":731},4,[603,733,734],{"class":617},"  --data",[603,736,614],{"class":613},[603,738,739],{"class":617},"{\"event_id\":\"\u003Cevent-id>\",\"action_key\":\"lookup-1\",\"content\":\"服务器在线\"}",[603,741,639],{"class":613},[506,743,744,745,748,749,752,753,755,756,759],{},"可连接 ",[543,746,747],{},"wss:\u002F\u002F\u003CAPI 域名>\u002Fv1\u002Fbots\u002Fme\u002Fevents\u002Fstream"," 接收事件变化提示。WebSocket 只推送 ",[543,750,751],{},"{\"event\":\"bot_events_changed\"}","，不包含消息正文；建立连接和每次重连后仍需调用 HTTP 接口补取，运行期间也应定期补取。连接使用 ",[543,754,636],{}," 请求头，不在 URL 中放令牌。网页原生 ",[543,757,758],{},"WebSocket"," 不能设置该请求头，宜由可控制握手请求头的服务端客户端连接。",[506,761,762],{},"这些接口不使用 Cookie。Webhook 的订阅管理仍在网站同源接口下使用 Cookie、CSRF 和二次验证；资源发布事件仍由现有投递服务发送，与机器人事件 WebSocket 是两种不同通道。",[764,765,766],"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);}",{"title":599,"searchDepth":628,"depth":628,"links":768},[769,770,771],{"id":512,"depth":628,"text":512},{"id":538,"depth":628,"text":538},{"id":563,"depth":628,"text":563},"创建个人机器人、申请权限，并通过个人 API 和事件接口处理消息。","md",null,{},true,{"title":91,"description":772},"kKcrdRGa4aWwVDCiqfNuY-9URH-J1oEEzT4gfJf297w",[780,782],{"title":87,"path":88,"stem":89,"description":781,"children":-1},"查询公开内容与组织，并按授权读取本人资料、维护内容和组织。",{"title":95,"path":96,"stem":97,"description":783,"children":-1},"了解私信和房间指令事件，按游标读取消息、可靠回复，并在断线后继续处理。",1795179032996]