[{"data":1,"prerenderedAt":2295},["ShallowReactive",2],{"navigation_docs":3,"site-search":500,"help-library":1997,"article-publish-resource":2200},[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",{"documents":501,"sections":1043},[502,515,528,540,552,564,576,587,599,611,623,634,645,657,663,667,671,675,679,683,687,691,695,699,703,707,711,715,719,723,727,731,735,739,743,747,751,755,759,763,767,771,775,779,783,787,791,795,799,803,807,811,815,819,823,827,831,835,839,843,847,851,855,859,863,867,871,875,879,883,887,891,895,899,903,907,911,915,919,923,927,931,935,939,943,947,951,955,959,963,967,971,975,979,983,987,991,995,999,1003,1007,1011,1015,1019,1023,1027,1031,1035,1039],{"path":503,"title":504,"description":505,"keywords":506,"order":512,"source":513,"content":514},"\u002Farticles\u002Fask-for-help","发布讨论或提出清楚的求助","写明环境和复现步骤，让其他人更容易理解并回答问题。",[507,508,509,510,511],"发帖","求助","讨论","日志","复现步骤",10,"help","写明环境和复现步骤，让其他人更容易理解并回答问题。 登录并验证邮箱后，打开发帖页面。需要帮助时勾选“我需要帮助”，并写清运行环境、问题现象和复现步骤。\n发布一条帖子\n填写具体标题和正文。当前发帖页要求标题为 2–80 个字符，正文至少 10 个字符。求助时勾选“我需要帮助”；普通交流可不勾选。讨论已有资源时，在“关联资源”中搜索并选择它，也可从资源详情的求助入口进入。检查日志、链接及身份信息，点击“保存草稿并提交审核”。需要继续完善时，先点击“保存草稿”。在发布审核记录查看反馈，通过并公开后再打开帖子核对展示。\n求助至少写清这些内容\n实际使用的游戏版本、加载器、资源版本及必要前置。怎样触发问题，原本期望什么，实际发生了什么。已尝试的处理方法，以及能否在独立测试环境复现。去除隐私和秘密后的日志、截图或其他依据。 不要只写“不能用”。日志较长时提供可访问的文本链接，并摘出关键报错；分享前删除令牌、登录信息和无关个人资料。\n草稿和正文图片\n发帖页会在当前浏览器保存本地草稿，重要长文仍请另存备份。需要上传正文图片时，先点击“保存草稿”，保存后进入草稿编辑页上传、插入图片并保存，检查完成后再提交审核。单独保存私有草稿不会自动送审。 编辑草稿、送审时冻结的版本和公开版分别保存。首次发布和实质修改均需审核；审核期间保存修改不会改变送审内容，需明确重新提交并确认替换。旧公开版在新版本通过前保持不变。只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。 更多标题示例与求助模板见帖子发布规范。需要提供可下载的作品时，应发布资源，再用帖子交流使用问题。 需要按章节持续整理知识时，可撰写独立教程；围绕教程提问或讨论时，从教程阅读页发起关联讨论。",{"path":516,"title":517,"description":518,"keywords":519,"order":526,"source":513,"content":527},"\u002Farticles\u002Fdownload-builds","下载适合自己环境的构建","在下载窗口中同时确认游戏版本、加载器和文件信息。",[520,521,522,523,524,525],"下载","构建","兼容","加载器","正式版","预览版",5,"在下载窗口中同时确认游戏版本、加载器和文件信息。 在资源详情页点击“下载”，选择自己的游戏版本和加载器，确认出现匹配文件后再下载。资源支持多个环境时，请以这两个条件共同匹配的结果为准。\n选择并下载\n从资源库打开目标资源，阅读介绍与安装要求。点击页面顶部“下载”，也可以从发布记录的下载按钮打开窗口。选择实际使用的“游戏版本”和“加载器”。核对窗口显示的版本号、文件名及预览版标记，点击“下载”。 下载窗口可能已经预选一个组合，仍请确认它符合你的环境。顶部下载入口优先选择正式版；如果资源只有预览版，按钮会标明“下载预览版”。\n提示没有匹配构建\n“没有同时支持……”表示当前组合没有可用构建。即使游戏版本和加载器分别都能在选项中找到，也不代表它们可以任意组合。 例如某资源一条记录支持 Quilt 与 26.2，另一条支持 Fabric 与 1.19.4，那么选择 Quilt 与 1.19.4 仍然没有匹配。可以检查自己的选择，或查阅其他发布记录；不要仅凭资源名称判断兼容。筛选规则见发布记录与联合筛选。\n下载后仍要阅读安装说明\n核对文件对应的加载器、游戏版本、运行环境和必需前置，再按作者说明安装。不同作品的安装方式可能不同；修改存档或配置前，先做好备份。 如果资源页只有介绍而没有下载入口，请查看作者提供的获取说明。遇到错误文件、失效链接或无法运行的问题，可按求助指南附上具体版本和复现步骤。",{"path":529,"title":530,"description":531,"keywords":532,"order":538,"source":513,"content":539},"\u002Farticles\u002Fedit-resource","维护资源资料、构建与关联","编辑资源资料和单条构建，管理本站依赖及独立教程的关联。",[533,534,535,536,537],"编辑资源","我的创作","共同作者","前置依赖","关联教程",9,"编辑资源资料和单条构建，管理本站依赖及独立教程的关联。 从我的创作选择“编辑资源”，可以维护介绍、标签、封面、发布记录和关联内容。资源详情中的“编辑资源”也是同一入口。已接受邀请的本站共同作者可以编辑和发布；只有资源所有者可以管理共同作者和删除整个资源。邀请尚未被接受时，不会产生维护权限。\n邀请共同维护\n资源所有者在编辑页的“共同作者”区域搜索本站用户，选定账号后发送邀请。对方在我的创作的“待接受邀请”中接受后，资源会标记为“共同维护”，并出现编辑入口。邀请未接受时不授予维护权限。 共同作者可以维护资源资料和发布记录；只有所有者可以邀请、取消邀请、移除成员或删除整个资源。共同作者可自行退出，退出或被移除后不能继续编辑。成员变更不会删除独立讨论，也不会将其他作者的教程变成共同所有。 资源受平台处置或已删除时，收件箱会保留失效邀请并禁止接受，仍可拒绝。处置期间所有者仍可管理成员；资源恢复后，尚未关闭的邀请可继续接受。 这里的共同作者表示本站账号获得维护权限，不是原作品作者身份或转载授权的证明。原作者、来源和授权依据仍应在介绍中写清。\n修改资源资料\n确认登录的是有维护权限的账号。打开编辑页，修改资料、正文、标签或页面能力。上传正文图片后，将地址插入正文，再保存修改。在发布状态区域检查草稿和审核版本，再提交审核。通过后打开资源详情，检查排版、图片、链接与实际显示。 保存的是私有编辑草稿；审核使用提交时冻结的版本；读者继续看到旧公开版，直到新版本通过。首次发布和实质修改都需审核。只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。审核中继续保存不会改变送审内容，需要明确重新提交并确认替换。 通用介绍供所有构建共用。仅涉及某一构建的变化，请在对应发布记录的更新说明或安装说明中写清适用范围。\n修正或删除单条构建\n编辑页的发布记录列表按物理构建列出，每条都有自己的 ID。在“维护发布记录”中展开需要修改的记录，核对 ID、版本号、加载器与游戏版本配对及文件，再保存这一条的技术参数、兼容范围或文件，并为该记录提交审核。即使两条构建使用同一个版本号和文件，也应分别核对。删除确认只删除指定记录，同版本或同批次的其他记录会保留。 可以修改所选构建的版本号、渠道、运行环境、支持范围、文件、说明和可见状态。文件或兼容声明填错时，直接修正该构建；需要撤回时，将它调整为合适的非公开状态，或确认后删除该条构建。删除只作用于选中的物理 ID，同批次的其他构建不会一起删除。也可以从资源页发布新构建。 不要只修改资源正文，却继续保留错误的文件或兼容声明。一次支持组中的每个加载器与每个游戏版本组合都必须成立；不成立的组合要拆成不同组。 如果提示内容已在其他位置修改，当前草稿会保留；核对后再决定是否放弃草稿并重载。若公开基线已经变化，先查看页面列出的差异，再按提示确认并重新送审。换账号时，编辑页会清空上一账号的私有内容和未提交表单。\n教程独立维护\n编辑页的“创建独立教程”和“管理我的教程”分别进入教程创建和我的教程。教程正文与章节在自己的编辑页维护，邀请资源共同作者不会授予教程编辑权。\n管理本站依赖和教程关联\n整个资源都需要的本站项目，放在通用依赖；只有某条构建需要的项目，放在该物理构建的依赖。核对该构建的物理 ID、加载器和游戏版本后，再按实际情况标记“必需”或“可选”，并填写说明。同版本号、同文件或同批次的其他构建不会自动继承这条额外依赖。本站选择器只绑定当前已公开的资源；目标以后失效时，公开页会显示不可跳转的失效提示，不会把关联自动改指向另一个项目。 资源可关联本站已独立发布的教程。先在创建教程完成教程的编写和发布，再绑定到资源；已有教程在我的教程单独管理。通用依赖、指定构建的依赖、教程关联分别保存，修改一个范围不会改动另两个范围。解绑只移除资源与教程之间的引用，不会删除教程或其章节。资源内旧版“说明文档”区域仍是历史内嵌内容，不能用它创建独立教程。 旧版站外引用和异常关联保留原始 ID，不会自动合并或删除。若页面提示“需要整理”，先加载并核对该范围的全部记录，按引用 ID 逐条解除错误的本站依赖，再保存该范围的新清单；不要把站外地址当作本站资源。历史记录超过一个页面时，不要仅凭当前页替换全部关联。\n保存冲突与平台处置\n多人同时维护时，另一个人先保存可能使当前修订过期。页面会提示重新读取；请先核对未提交内容，再选择如何继续。切换登录账号后，旧账号的编辑草稿不会交给新账号提交。 资源受到平台下架或移除处置时，编辑页只允许修正规定的资料和发布说明，不能借状态、文件、兼容、封面或关联操作恢复公开。保存修改不会自动解除处置；需要复核时，请按页面提示提供修改位置与依据。 删除整个资源不会同时删除独立帖子或教程；引用处会保留失效提示。处理前请核对影响范围。",{"path":541,"title":542,"description":543,"keywords":544,"order":550,"source":513,"content":551},"\u002Farticles\u002Ffind-resources","按游戏版本和加载器查找资源","组合筛选条件，找到与你的 Minecraft 环境相符的资源。",[545,546,547,523,548,549],"查找资源","筛选","游戏版本","Fabric","Paper",4,"组合筛选条件，找到与你的 Minecraft 环境相符的资源。 打开资源库，选择你的游戏版本和加载器，再按用途添加其他条件。筛选结果会随条件变化，打开详情后仍需核对具体下载文件。\n选择适用条件\n先确认自己实际使用的 Minecraft 版本，以及 Fabric、Forge、Paper 等加载器。在资源库中选择对应条件。手机上先点击“筛选”展开面板。根据需要选择类型或内容标签，也可切换“最近更新”等排序。点击感兴趣的资源，阅读介绍、支持范围与安装说明。 不必先选类型才能选加载器。多个条件可以一起使用；想重新开始时，点击“清空”移除已选条件。\n多选条件怎样匹配\n同一组中多选表示满足其中任意一项；不同组之间则需要同时满足。例如选择两个游戏版本，再选择 Fabric，表示查找有 Fabric 构建支持其中任意一个版本的资源。 加载器和游戏版本必须在同一条发布记录上同时成立。一个资源分别有 Quilt 构建和 1.19.4 构建，并不代表它提供 Quilt 1.19.4 构建。更多说明见发布记录与联合筛选。\n分享筛选结果\n筛选条件保存在浏览器地址中。选好后复制地址，即可分享当前组合，或保存为书签。例如可以直接打开Fabric 1.20.1 资源。 结果为空时，检查版本与加载器是否选择正确，再逐项减少其他条件；不要把其他环境的文件当作兼容替代。",{"path":553,"title":554,"description":555,"keywords":556,"order":562,"source":513,"content":563},"\u002Farticles\u002Fpublish-release","为已有资源发布新版本","复用资源介绍，为每个新构建准确填写支持范围和文件。",[557,558,559,560,561],"发布新版","发布记录","支持组","外链","SHA512",8,"复用资源介绍，为每个新构建准确填写支持范围和文件。 打开自己的资源详情，点击“发新版本”。通用介绍继续沿用，只需填写这次发布的版本、文件、支持范围和说明。\n填写这次发布\n在资源页面进入“发新版本”，确认当前账号具有维护权限。填写版本号、正式版或预览版渠道、运行环境、更新说明，以及需要补充的安装说明。为实际支持的环境添加支持组，选择加载器和游戏版本。添加所需文件，逐个上传或填写外部下载信息，指定主文件，检查完成后提交审核。 提交时冻结本次内容，编辑草稿与当前公开版分别保留。同批次包含多条发布记录时，需全部通过后才公开；只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。继续修改草稿不会改写冻结版本，需要明确重新提交并确认替换。已有公开记录在新版本通过前保持原样，可在发布审核记录查看进度与反馈。\n支持组里的组合都要成立\n一组中选择的每个加载器，都应支持这一组选择的每个游戏版本。若同一个文件只支持 Fabric 1.20.1 和 Forge 1.19.2，请填成两组，不能把两个加载器与两个版本放进同一组。 同一次提交的支持组共用本次文件。不同环境需要不同文件时，分别提交相应构建，版本号可以相同。完整说明见资源发布规范。\n选择上传或外链\n选择“上传到本站”时，等待传输、处理和校验全部完成再提交；进度达到 100% 不代表发布记录已经保存。 选择“外部下载地址”时，填写对应文件的地址、文件名、格式、字节大小和完整 SHA512。若下载需要登录或提取码，应在说明中写清。 审核通过并公开后打开详情，核对新记录、文件和兼容范围。实验性构建应选择 Alpha 或 Beta，不要按正式版提交。只对这条物理构建生效的本站前置依赖，可随后在资源编辑页为该构建单独关联。",{"path":565,"title":566,"description":567,"keywords":568,"order":574,"source":513,"content":575},"\u002Farticles\u002Fpublish-resource","创建资源并保存第一份草稿","从名称和介绍开始，补齐图片、文件与兼容信息后再公开。",[569,570,571,572,573],"发布资源","草稿","封面","介绍","标签",7,"从名称和介绍开始，补齐图片、文件与兼容信息后再公开。 打开发布资源，填写基本介绍并先保存草稿，再上传图片和文件。资料与发布记录准备好后，点击“发布”提交审核，通过并公开后再检查实际页面。\n发布前先检查\n先在资源库搜索作品名称和原始地址。已有自己的资源时，更新原条目或发布新版本，不要为每个加载器、每次更新重复创建。 转载、翻译或分支作品还应写清原作者、来源、许可与自己的维护范围。具体要求见命名、署名与转载要求。\n保存并补齐草稿\n填写名称、简介和介绍。名称为 2–60 个字符，简介为 10–200 个字符，介绍至少 10 个字符。选择“页面上要放什么”，填写所选项目需要的数据。点击“保存草稿”，再上传封面、正文图片或发布文件。有下载文件时，填写版本号与准确的支持组合，等待上传处理完成。检查内容后点击“发布”提交审核，在发布审核记录查看进度与反馈。首次发布的资源及同批次发布记录全部通过后才会公开，再打开详情核对文件、图片和链接。 标签可以多选或留空。加载器和游戏版本应填写在支持范围中，不用开放标签代替。\n草稿与审核版本\n保存草稿不会公开内容。提交时会冻结当前版本，之后仍可继续编辑草稿；保存修改不会改变已送审内容，需要明确重新提交并确认替换审核版本。只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。\n中途离开或提交失败\n可从我的创作找回已保存的草稿。先核对已有内容和发布记录，再继续提交，避免重复创建。 介绍应说明用途、基本用法、依赖和已知限制；不要把尚未完成的计划当作已提供功能。完整填写要求见资源发布规范。",{"path":577,"title":578,"description":579,"keywords":580,"order":585,"source":513,"content":586},"\u002Farticles\u002Fpublish-tutorial","按章节撰写并发布教程","保存独立教程草稿，按章节写作、预览，并关联讨论。",[581,582,583,570,584],"教程","章节","发布","预览",13,"保存独立教程草稿，按章节写作、预览，并关联讨论。 从写教程开始，填写标题和简介并创建草稿，再按章节组织正文。已经保存的教程可以从我的教程继续编辑。\n按章节写作\n在目录中选择要编辑的章节，使用正文编辑器书写说明；需要时添加代码或图片。章节和段落可以重排，已保存的定位链接会继续保留。新章节需要先保存，之后才能把它设为其他章节的父章节。 图片通过页面的上传入口添加，不要把站外图片地址粘贴成正文图片。代码中的标签示例可以正常书写；教程正文仍不接受原始 HTML。添加图片后应保存教程，先确认它已经出现在草稿预览中；审核通过并公开后，再检查读者页面。\n草稿、预览与发布\n未公开时使用“保存草稿”，检查完整预览后点击“发布教程”提交审核。已经公开的教程可以保存更新，再从发布状态区域提交审核，或撤回为草稿；平台处置中的内容按页面提供的纠正入口处理，不能自行恢复公开。 编辑草稿、提交时冻结的审核版本和当前公开版分别保存。首次发布及实质修改都需要审核，保存修改不会直接更新读者页面，也不会改变已送审内容；明确重新提交并确认替换后，才会使用新的草稿审核。旧公开版在新版本通过前保持不变。只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。进度与反馈见发布审核记录。 未保存的文字会尝试保留在当前浏览器，恢复时会核对账号、教程和服务器版本。其他浏览器或清理站点数据后无法依靠这份本地副本找回内容，因此重要修改仍应及时保存到服务器。服务器版本已经变化时，应先查看旧草稿并核对差异，不直接覆盖新的版本。未保存图片离开页面后可能被清理，恢复文字草稿时可能需要重新上传。\n讨论与订阅\n公开阅读页可以查看关联讨论或发起新讨论。讨论发布后可通过引用卡返回教程；删除或撤回教程不会删除已经发布的帖子。 点击“订阅更新”可将这篇教程添加到 Atom 阅读器。教程列表也提供按标签和游戏版本筛选的订阅，地址和限制见内容订阅。",{"path":588,"title":589,"description":590,"keywords":591,"order":597,"source":513,"content":598},"\u002Farticles\u002Fregister-and-login","创建账号并登录 NexusMC","使用邮箱注册，了解密码、邮箱链接和通行密钥登录。",[592,593,594,595,596],"注册","登录","邮箱","用户名","通行密钥",1,"使用邮箱注册，了解密码、邮箱链接和通行密钥登录。 在注册页面填写邮箱，打开收到的注册链接，再设置用户名和密码，即可完成注册。\n创建账号\n输入自己能够访问的邮箱，点击“发送注册链接”。打开邮件中的链接，确认页面显示的注册邮箱。设置用户名：3–32 位小写字母、数字、下划线或连字符，首位须为字母或数字。设置至少 10 位的密码，点击“完成注册”。 用户名已被使用时，请按页面提示更换。发送成功提示不代表邮件已经到达收件箱；未看到邮件时，也可以检查垃圾邮件与邮箱过滤规则。\n选择登录方式\n打开登录页面，输入邮箱或用户名，再输入密码。也可以点击“发送邮箱登录链接”，然后打开对应邮件。 已经为账号添加通行密钥时，可输入邮箱或用户名后点击“使用通行密钥”，按照设备提示验证。页面出现第三方登录按钮时，也可使用对应入口；可用服务以页面实际显示为准。 启用了两步验证的账号，按后续页面要求输入认证器验证码或备用码。若提示邮箱尚未验证，可前往验证邮箱重新发送验证邮件。\n无法登录时\n忘记密码可按重置密码的步骤操作。验证码或链接报错时，先阅读页面提示，再返回登录页重试；不要向他人提供密码、验证码或邮件中的完整链接。",{"path":600,"title":601,"description":602,"keywords":603,"order":609,"source":513,"content":610},"\u002Farticles\u002Freply-and-resolve","回复讨论并更新问题结果","回复具体内容，在找到方案后标记已解决并留下适用步骤。",[604,605,606,607,608],"回复","评论","已解决","关闭问题","编辑帖子",11,"回复具体内容，在找到方案后标记已解决并留下适用步骤。 打开帖子并登录后，可以在下方回复；发帖人可进入“编辑帖子”，将待解决问题标记为“已解决”或“已关闭”。请先确认结果，因为终态不能重新打开。\n回复原帖或具体楼层\n从讨论列表或资源详情进入帖子。直接在下方输入框回复原帖；要回应某条回复时，点击它旁边的“回复”。检查正在回复的对象和内容，再点击“发送回复”提交审核。页面会显示提交结果；可通过草稿编辑入口继续完善，并在发布审核记录查看反馈。通过后，回复才会出现在公开讨论中。 只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。 回复应增加信息，例如补充复现结果、解释原因或提供可核对的步骤。展示层数较深的回复不再提供继续回复按钮时，可回到上层，说明所回应的内容。\n找到方案后更新结果\n先回复说明有效步骤、适用版本和剩余限制，方便后来者参考。然后从帖子详情的“编辑帖子”，或我的创作进入维护页面。 在“问题状态”区域选择“标记已解决”，阅读提示后确认。问题尚未解决但不再继续处理时，可以说明原因并选择“关闭问题”；关闭不等于修复。 普通讨论没有问题状态。只有建立了待解决状态的帖子，才会显示对应维护操作。\n修正自己发出的内容\n作者可在编辑页修改帖子标题、正文并保存私有草稿，再提交审核。实质修改通过后才会替换公开内容；审核使用提交时冻结的版本，保存新草稿不会改写它，需要明确重新提交并确认替换。旧公开版在新版本通过前保持不变。删除帖子后，已有回复和引用仍按页面规则保留，不会随原帖一起消失。更多说明见帖子发布规范。",{"path":612,"title":613,"description":614,"keywords":615,"order":621,"source":513,"content":622},"\u002Farticles\u002Freport-content","举报内容并准备可核实的说明","反馈错误文件、侵权或其他内容问题，准备具体事实和证据。",[616,617,618,619,620],"举报","版权","侵权","复核","内容处置",12,"反馈错误文件、侵权或其他内容问题，准备具体事实和证据。 发现虚假兼容、错误文件、冒充作者、侵权转载或隐私泄露时，可在资源、帖子或回复旁点击“举报”，提交具体事实和证据。一般使用问题可先按求助指南交流。\n提交举报\n打开涉及的资源或帖子，找到对应内容的“举报”入口。尚未登录时，先登录账号。填写最多 1000 个字符的问题说明，检查后点击“提交举报”。以页面显示的提交结果为准；失败时按提示重试。 同一账号重复举报同一内容时，会保留已有待处理记录。提交不代表平台已经认可举报结论，也不会自动下架内容。\n怎样写清问题\n说明具体对象、涉及版本、发生了什么，以及可以核对的依据。版权问题应写清原始来源、相关权利或授权情况，以及涉嫌侵权的位置。 材料较多时，先提供关键事实和必要的证据链接。不要公开密码、令牌、私人聊天或其他无关个人信息，也不要用重复举报代替证据。\n内容无法访问或已被处置\n内容已经无法访问时，先保留完整地址、涉及版本、发生时间和已有证据，便于准确说明问题。当前没有独立申诉页面或自动复核队列；本指南不承诺固定处理时间或收到回复。 自己的资源受到处置时，可根据页面提示修正允许修改的说明，并记录修改位置与依据。保存修改不会自动解除处置，公开状态以页面实际显示为准。",{"path":624,"title":625,"description":626,"keywords":627,"order":632,"source":513,"content":633},"\u002Farticles\u002Freset-password","忘记密码时如何重置","通过注册邮箱设置新密码，并在重置后重新登录。",[628,629,630,631],"忘记密码","重置密码","找回账号","邮件",2,"通过注册邮箱设置新密码，并在重置后重新登录。 在重置密码页面填写账号邮箱，打开邮件中的重置链接，再设置新密码。整个过程需要你能够访问该邮箱。\n发送重置邮件\n打开重置密码页面，输入注册时使用的邮箱。点击“发送重置邮件”，等待页面返回结果。前往邮箱，打开这次请求对应的密码重置邮件。 如果没有看到邮件，请先核对邮箱拼写，再检查垃圾邮件、拦截规则及邮箱空间。页面显示发送提示，不代表邮件已经进入收件箱，也没有固定送达时间。\n设置新密码\n打开邮件链接后，页面会显示新密码输入框。输入至少 10 位的新密码，再输入一次确认；两次内容必须一致。点击“重置密码”，看到成功提示后返回登录页面，使用新密码登录。 请为账号使用独立密码，不要把邮件链接或新密码转发给别人。重置登录密码也不意味着可以跳过账号已有的后续登录验证。\n链接无法使用\n直接打开重置密码页面时，先填写邮箱发送邮件；设置新密码需要通过邮件中的完整链接进入。若链接报错或已无法使用，返回发送页面重新申请，并按页面提示操作。 如果你记得密码且已经登录，可以到账号安全按页面要求修改密码。无法访问原邮箱时，本页的邮件流程不能代替邮箱验证。",{"path":635,"title":636,"description":637,"keywords":638,"order":643,"source":513,"content":644},"\u002Farticles\u002Fsave-favorites","收藏内容并再次找到它","将感兴趣的资源和讨论加入收藏，在个人主页中查看。",[639,640,641,642],"收藏","我的主页","浏览历史","保存",6,"将感兴趣的资源和讨论加入收藏，在个人主页中查看。 登录后，在资源或帖子页面点击“收藏”，之后可以从我的收藏重新打开内容。收藏适合保存以后还想查看的介绍、下载页和讨论。\n添加或取消收藏\n打开需要保存的资源或帖子，找到内容旁的“收藏”。点击按钮；未登录时先按提示登录账号。等待操作完成，确认按钮显示的状态。 再次点击已选中的收藏按钮可以取消收藏。网络异常或页面显示失败时，请先确认当前状态，再重试。\n查看已收藏的内容\n打开“我的收藏”后，网站会进入个人中心的“收藏”页面。点击列表中的标题，可以返回对应内容；条目较多时，可继续加载后面的记录。\n没有收藏过也想找回\n可以查看浏览历史，寻找曾经打开过的内容；也可以回到资源库，用记得的游戏版本、加载器和标签重新筛选。 收藏记录不是资源文件的备份，不能让已经不可用的内容继续下载。找到需要的资源后，仍请阅读详情页当前显示的状态、兼容范围和获取说明。",{"path":646,"title":647,"description":648,"keywords":649,"order":655,"source":513,"content":656},"\u002Farticles\u002Ftwo-factor-authentication","开启两步验证并保存备用码","用认证器保护登录，并妥善保存一次性备用码。",[650,651,652,653,654],"两步验证","2FA","认证器","验证码","备用码",3,"用认证器保护登录，并妥善保存一次性备用码。 打开账号安全，在认证器中添加页面提供的密钥，再用验证码确认开启。看到密钥并不代表设置已经完成。\n绑定认证器\n登录账号，进入“账号安全”。按“安全操作验证”的提示填写当前登录密码；已有安全因子时，按提示提供相应验证。在“两步验证”区域点击“开启两步验证”。在可信任的认证器应用中选择手动输入密钥，填入页面显示的密钥；也可以使用页面提供的 URI 导入。输入认证器里的 6 位验证码，点击“确认并开启”。 没有登录密码时，请按页面提示，在邮箱或第三方登录后的 5 分钟内完成首次设置。超过时间可重新登录后继续。\n保存备用码\n开启后立即把备用码保存到安全的地方，再勾选“我已经把备用码抄到安全的地方了”，点击“完成”并重新登录。 备用码只在生成时显示，每个码只能使用一次。需要时，可在登录验证页面使用一枚尚未使用的备用码。不要把备用码和认证器密钥发给他人。\n验证失败或备用码不足\n验证码错误时，检查设备时间，并尝试下一轮验证码。备用码不足时，在账号安全页输入当前认证器验证码，选择“重新生成备用码”，保存新的一组；旧备用码随之作废。 关闭两步验证也需要按页面要求完成验证。修改安全凭据后，按提示重新登录。",{"path":15,"title":14,"description":658,"keywords":659,"order":660,"source":661,"content":662},"判断什么应当发布为资源，以及作品、发布记录和维护身份的边界。",[],0,"docs","判断什么应当发布为资源，以及作品、发布记录和维护身份的边界。 NexusMC 的资源围绕 Minecraft 的使用、内容创作与运行维护。资源是可以实际使用的作品，或可以接入的持续服务；它应当有可识别的名称、明确用途，以及能够获取或使用的对象。资源不以是否提供下载文件为限；可以连接的服务器、有明确使用入口的相关在线工具，也可以作为资源。 本页帮助你决定是否新建资源。实际填写和发布步骤见资源发布规范，内容核查标准见资源审核要求。\n先判断读者要使用什么\n你准备分享的内容适合的发布方式示例一个可以安装、导入、运行、连接或接入的作品或服务资源插件、整合包、皮肤、地图、服务器、在线工具有目录、章节和持续维护需求的系统知识教程从环境准备到部署维护的完整服务器搭建教程围绕一个主题展开的交流、问题或经历帖子安装报错、方案讨论、使用体验、开发进展 教程的网页发布入口尚未开放。不要为了获得目录或发布长文而把教程包装成资源；普通经验交流可以先发布为帖子。作品的安装说明可以写在资源介绍中，独立的系统教程仍应按教程组织。 仅有开发设想、招募口号、群号或“敬请期待”，尚不足以说明一个可用资源。可以先用帖子讨论计划；已有可实际使用的早期版本时，可以发布资源，并清楚标明完成范围与实验性限制。\n按使用方式说明作品\n以下是帮助读者判断用途的例子，不是发布时必须单选的分类。同一个作品可以有多种使用方式。 使用方式可以说明的对象发布时需要让读者知道运行或集成独立程序、代码库、脚本、插件、模组、启动器程序做什么，如何运行或集成，需要什么环境导入一套配置或内容整合包、服务端方案、配置包包含什么，如何导入，依赖与分发范围是什么使用或展示视觉作品皮肤、材质、光影、地图、模型实际效果、文件格式、适用环境与导入方式连接或接入服务Minecraft 服务器、在线工具、持续提供的服务使用入口、支持环境、服务规则与获取条件 代码仓库应有可用内容和清楚的使用入口；单纯收集链接、复制一段介绍或为其他站点导流，不能代替作品本身。体量小、功能单一、尚未流行，都不是排除资源的理由。\n一个作品维护一份资源\n资源页面描述作品的长期身份、用途和通用说明；发布记录描述某次交付的文件、兼容范围、依赖和变化。作品更新时，一般在原资源中维护，不为每次更新重新建立页面。 发生的变化应当怎样处理修正介绍、译名、截图、来源或通用说明修改已有资源发布新版本，增加加载器适配或提供另一构建在原资源追加对应发布记录同一文件增加下载镜像，或补充另一种语言的介绍维护原有资源的说明和获取信息，不重复创建独立维护、具有实质变化的分支或移植可以新建资源，明确原作、修改范围及维护关系与原作品身份、用途和维护过程均独立的新作品新建资源，并按实际情况引用相关作品 只改名称、翻译介绍、重新压缩、替换下载地址，不能单独证明它已经成为新作品。判断分支时，要能说明实际差异、由谁继续维护，以及用户为什么需要分别获取；“非官方版”几个字不能代替这些信息。 发现同一作品已经存在时，先核对已有条目的身份与来源。不要因为不是自己创建的页面就另建副本，也不要假定平台会自动合并条目或转移维护权。有重复或维护关系争议时，按举报与申诉提供具体材料。\n本站维护者与原作者分别说明\n本站维护者负责维护本页面及其发布记录；原作者负责创作原作品。上传文件、整理资料、翻译介绍、维护镜像或取得页面维护权限，都不会自动改变原作者身份。 请写清原作者、原始来源、本站维护范围和对应版本的许可或授权依据。原创部分与第三方部分分别说明；分支、移植和二次打包应让读者一眼看出与原作的关系，不冒充官方发布。具体写法见命名、署名与转载。\n页面功能与标签可以组合\n“页面上要放什么”决定资源需要哪些功能区，例如文件下载、效果展示、整合内容或外部使用入口。按作品实际需要组合填写；视觉展示和下载可以同时存在，服务器也可以同时提供客户端文件。不要为每一种页面功能分别创建同一作品。 玩法功能、视觉风格和画质特征等开放标签可以多选，也可以留空。它们用于描述实际特征，不要求作品归入唯一分类，也不要求先选上级标签。 加载器与 Minecraft 版本应填写在发布记录的兼容信息中，不用开放标签代替。作品可能同时提供插件和模组构建，不需要为整个资源选一个唯一类型；页面中的展示分组也不能代替实际兼容声明。\n兼容条件必须同时成立\n用户要找的是一个能够使用的构建。加载器、游戏版本等条件必须由同一条发布记录同时满足，不能从不同记录各取一个条件拼成兼容结果。 例如，一个作品有两条发布记录： 发布记录加载器游戏版本AFabric1.20.1BForge1.19.2 这不能证明存在适用于 Fabric 1.19.2 的构建。需要精确配对时，分别填写真实支持的组合；一组内选择多个加载器和版本时，所有交叉组合都必须成立。不同构建使用不同文件时，分别提交对应文件与支持范围，不能让用户自行猜测。 兼容填写、依赖和文件信息的具体要求见资源发布规范。未经确认的兼容性应说明验证范围，不扩大成已支持条件。\n关联内容保持独立\n围绕资源的讨论、求助和问题反馈可以关联资源，无须为每个版本另建讨论资源。独立教程也可以被引用，不会因此变成资源的一部分。 资源删除后，已经发布的独立帖子仍然保留，引用处显示资源失效提示及必要的封面、简介等墓碑信息。不要把删除资源当作撤回讨论或消除反馈的方法。内容修正和管理员处置的区别见内容处置说明。",{"path":19,"title":18,"description":664,"keywords":665,"order":660,"source":661,"content":666},"写清讨论主题、求助环境和复现步骤，让交流能够继续。",[],"写清讨论主题、求助环境和复现步骤，让交流能够继续。 帖子适合讨论、经验交流、问题反馈和求助。需要用户下载的作品应发布为资源，再用帖子交流使用问题。\n在当前网页发布\n登录并验证邮箱，打开主站 \u002Fposts\u002Fnew。填写标题和正文。当前网页要求标题为 2–80 个字符，正文至少 10 个字符；字数达到要求仍需有实际信息。需要别人帮助解决问题时，勾选“我需要帮助”。普通交流可以不勾选。若讨论已有资源，在“关联资源”中搜索并选中它；也可以不关联。需要继续编辑或补图时，点击“保存草稿”，保存后进入草稿编辑页继续完善。内容准备好后，点击“保存草稿并提交审核”或编辑页的“提交审核”。在主站 \u002Fmember\u002Fpublications 查看审核记录与反馈；通过审核并公开后，再打开帖子核对实际显示效果。 发帖页会在当前浏览器保存本地草稿。重要长文请另存一份；本地草稿不能代替账号中的正式内容。 需要上传正文图片时，先保存私有草稿，再打开草稿编辑页，选择 PNG、JPEG、WebP 或 GIF 图片，上传后将本站图片地址插入正文并保存。检查完成后再提交审核。静态图片原图最多 20 MiB；GIF 和动态 WebP 原图最多 8 MiB。上传前可旋转，本站受管图片会转换为 WebP，动画会保留。保存草稿不会自动提交审核或公开帖子。 编辑草稿、审核中的冻结版本和读者看到的公开版分别保存。发帖、回复及实质修改均需经过发布审核；保存修改不会改写已经提交的冻结版本。需要让审核人员看到新内容时，明确重新提交并确认替换旧的审核版本。已有公开内容在新版本通过前保持不变。只有符合已启用低风险自动批准条件的完整审核结果才可自动通过，其他情况进入人工处理。\n标题写具体问题\n标题应包含对象和主要现象，让有经验的人能判断是否能够回答。游戏版本、加载器或资源版本与问题直接有关时，可以写进标题。 不够清楚可以直接使用的写法求大佬救命！！！Fabric 1.20.1 安装示例模组后，进入世界时崩溃这个插件太差了示例插件 2.1 在 Paper 1.21.1 上重载后权限未生效来看看分享小型生存服的备份方案与一次恢复记录 避免在标题中堆叠表情、重复标点、夸张结论或与内容无关的热词。不要冒用“官方”“管理员”等身份。\n求助与问题反馈\n“我需要帮助”会给帖子建立待解决状态；它不是必须选择的内容分类。请先给出完整环境，再描述现象，不要只发一张报错截图或一句“不能用”。 可以复制以下模板，删除不适用的项目： ## 问题现象\n安装示例模组 2.0 后，进入新世界时退出到启动器。\n\n## 运行环境\n- Minecraft：1.20.1\n- 加载器及版本：Fabric Loader 0.15.11\n- 资源及版本：示例模组 2.0\n- Java \u002F 系统：Java 17，Windows 11\n- 必需前置：Fabric API，填写实际版本\n- 是否整合包 \u002F 服务端：填写名称和版本，或写“独立客户端”\n\n## 复现步骤\n1. 新建独立的测试实例，安装上述加载器。\n2. 只安装示例模组和必需前置。\n3. 新建世界，进入时发生崩溃。\n\n## 期望结果与实际结果\n- 期望：正常进入世界。\n- 实际：加载到约 80% 后退出。\n\n## 已尝试的方法\n移除其他模组后仍可复现；尚未测试其他 Java 版本。\n\n## 日志与补充材料\n填写已去除个人信息的完整日志链接、发生时间，以及关键报错。 模板中的版本仅展示写法，不代表该组合已测试。请填写自己的实际环境。复现会修改存档、配置或数据时，先在备份或独立测试环境操作。 日志较短时使用代码块，保留换行；日志较长时提供稳定、可访问的文本链接，并在正文摘出关键报错。分享前删除访问令牌、登录信息、私人聊天、真实地址和无关个人路径。不要只裁下错误的最后一行。 若问题尚未确认，写“在这些条件下出现”“怀疑与某项配置有关”，并保留验证过程。性能问题请同时注明硬件、测试场景、设置与测量方法，不把单次结果说成所有人的表现。\n普通讨论与回复\n普通讨论说明背景、自己的观察和想讨论的问题。使用体验请标注实际使用版本；比较多个作品时，给出相同测试条件，尊重不同用途和偏好。 回复应增加信息：补充复现结果、解释原因、给出可以核对的步骤，或说明方案的限制。不要反复顶帖、复制相同回复、用大图淹没正文，或仅发布“抢楼”等没有交流信息的内容。 讨论同一个问题时，优先在原帖补充结果。问题不同、环境差异足以改变判断时，可以另发帖子，并链接原来的讨论。\n解决、关闭与更新日志\n找到方案后，建议回复说明有效步骤、适用版本和剩余限制，让后来者也能复用。问题未解决但不再继续处理时，应说明原因，避免把“关闭”等同于“修好了”。 发帖人可以从账号菜单的“我的创作”或帖子详情的“编辑帖子”进入维护页面，修改正文、删除帖子，并将待解决问题标记为“已解决”或“已关闭”。终态不能重新打开。符合权限的资源维护者也可以通过修改帖子状态接口操作。普通讨论没有问题状态；回复也不能建立独立的求助状态。 资源维护者可以发布版本更新说明。系统中的更新日志身份由维护者身份和对具体发布记录的引用判定，标题写上“更新日志”不会自动获得该身份。当前发帖网页在关联资源后提供“关联发布记录”选择器，应核对具体构建；也可使用创建帖子 API提供相同引用。 关联资源失效后，已发布的帖子仍然保留。引用卡片会显示失效状态；不要以为删除资源会同时撤掉讨论中的说明。\n提交前检查\n标题包含对象与主题，正文不是空话或重复内容。 求助写明环境、资源版本、复现步骤和已尝试的方法。 事实、推测和个人评价已区分，日志和截图足以核对。 关联了正确资源；没有把关联当作原作者身份的证明。 已清理个人信息、秘密和无关内容，引用材料有来源。 送审前已检查草稿；公开后再次核对排版、图片和链接。",{"path":23,"title":22,"description":668,"keywords":669,"order":660,"source":661,"content":670},"介绍写一次，每次发布准确声明文件、兼容范围和依赖。",[],"介绍写一次，每次发布准确声明文件、兼容范围和依赖。 资源用于提供可被使用的作品或服务，例如模组、插件、皮肤、整合包、启动器和服务器。请让读者看完介绍后知道用途、获取方式、适用环境和已知限制。 不确定应发布资源、教程还是帖子时，先看资源定义与收录范围。本页说明怎样填写；资源审核要求说明发布者与管理人员共同核对的标准。\n创建资源前\n先搜索名称、原始发布地址及常见译名，确认没有重复条目。自己的作品已经存在时，更新介绍或追加发布记录；不要为每个版本、每个加载器重复创建资源。 发布转载、翻译、分支或镜像前，先核对命名、署名与转载要求。账号是本站维护者，不会自动成为原作作者。 当前网页在主站 \u002Fresources\u002Fnew 发布资源，使用登录账号的身份。名称要求 2–60 个字符，简介 10–200 个字符，介绍至少 10 个字符。网页还要求至少选择一个“页面上要放什么”，并填完所选项目需要的数据。 需要上传封面、正文图片或发布文件时，先保存资源草稿，再选择本地文件。草稿可从“我的创作”找回；文件及发布记录保存完成后，再将资源发布。\n一份介绍服务所有版本\n名称使用作品本来的名称。版本号放在发布记录中，不在资源名称里堆叠游戏版本、加载器、下载口号或“最新版”。没有公认中文译名时可以保留原名，在正文注明临时译名。 简介用一句话说明主要用途和适用对象。介绍应至少回答： 做什么： 主要功能、使用场景及不提供的功能。怎么用： 基本安装或接入步骤，客户端和服务端各需要做什么。要准备什么： 通用依赖、运行条件和重要配置。需要知道什么： 已知问题、实验性功能、数据迁移或其他限制。从哪里核实： 原始来源、作者、源码或文档，以及许可和转载说明。 可按以下结构填写，再根据作品删减： ## 功能与适用场景\n用于在小型生存服务器中显示玩家状态，支持自定义展示内容。\n\n## 基本用法\n先备份配置，在测试环境中按对应加载器的方式安装。\n首次启动后修改配置文件，再按项目文档中的方式使配置生效。\n\n## 运行条件与限制\n不同构建的加载器、游戏版本和前置要求见对应发布记录。\n尚未验证代理端环境；暂不提供跨服数据同步。\n\n## 作者、来源与许可\n原作者：填写实际作者或团队。\n原始发布页：填写可访问链接。\n本人维护的内容：填写原创、翻译、打包或镜像维护范围。\n许可或授权：填写对应版本的许可名称、链接及必要说明。\n\n## 反馈方式\n说明如何提交问题；在本站求助时附上版本和复现步骤。 截图应来自所介绍的实际内容；概念图、渲染图、使用额外光影的画面应注明。性能数据需要附带硬件、场景、设置和测量条件，不承诺所有用户都能达到同样帧率。 可以说明开发计划，但尚未完成的部分必须明确标记。提供下载时，文件应与介绍相符，并能按声明的条件获取和运行；不要用空文件、无效链接或未实现的功能充当已发布版本。\n标签填写内容特征\n标签可多选，也可以留空。按资源实际具有的玩法功能、视觉风格或画质特征填写，例如“科技”“优化”“写实”；多个特征可以同时成立，无须选出唯一的“主分类”。 当前网页使用逗号分隔标签文字，并在提交时匹配或创建标签。新词可能先处于未归类状态，尚未进入常规筛选项；不必反复创建近义标签。不要把 Fabric、Paper、Minecraft 1.20.1 等受控兼容值塞进开放标签中代替发布记录。\n一次发布对应准确的兼容组合\n有文件时，在创建资源时填写第一版；之后从该资源页面进入“发新版本”，沿用名称、介绍、截图和标签。 每一组“支持”都表示：这一组所选的每个加载器，都支持这一组所选的每个游戏版本。 只要存在某个组合不成立，就拆成不同组。 例如，作品 2.0 使用同一个文件，实际只支持以下两个组合： 支持组加载器游戏版本第一组Fabric1.20.1第二组Forge1.19.2 请填写两组，不要在一组中同时选择 Fabric、Forge 与 1.20.1、1.19.2，否则会声称 Fabric 支持 1.19.2、Forge 支持 1.20.1。 同一组中可以多选，但必须确认全部组合都成立。不要因为某加载器“通常兼容”就自动扩大范围；未经验证时，说明测试范围，不冒充已验证。 API 中对应的兼容部分如下；其他必填项见创建发布记录： {\n  \"versionNumber\": \"2.0\",\n  \"compat\": [\n    { \"loaders\": [\"fabric\"], \"mcVersions\": [\"1.20.1\"] },\n    { \"loaders\": [\"forge\"], \"mcVersions\": [\"1.19.2\"] }\n  ]\n} 一次提交中的各支持组共用这次填写的文件。不同加载器使用不同文件时，应分别提交对应构建，版本号可以相同，不要把两个文件一起声明为所有组合通用。加载器族由系统展示分组，不需要作者选择“资源唯一类型”。\n上传文件或填写外链\n发布记录可包含多个文件；“发新版本”页面可添加文件并指定其中一个为主文件。每个文件选择“上传到本站”或“外部下载地址”，提交前逐项核对。 选择本站上传后，等待文件传输、服务器处理与校验全部完成，再提交发布记录。网页最多选择 512 MiB 的文件，实际站点可能设置更低上限；大文件自动分块。上传中可取消，失败后可重试。仅选择文件或传输进度达到 100%，都不代表发布记录已保存。 选择外链时，需填写下载地址、文件名、格式、大小（字节）和完整 SHA512（128 位十六进制）。本地计算校验值只读取文件信息，不会把外链文件上传；下载地址仍需与该文件一致。 优先使用能长期访问的版本文件地址。若下载需要登录、提取码、额外费用或特定启动器，提前写明；不要使用会指向不同版本文件的地址，却沿用旧的大小和校验值。SHA512 用于核对文件一致性，不能代替授权或安全说明。 文件内不应夹带账号资料、访问令牌、私人聊天、无关备份、日志和缓存。整合包应采用便于导入的导出格式或清楚说明目录结构，不把一份未整理的私人游戏目录直接作为成品。\n封面与正文图片\n保存草稿后，或打开已有资源的编辑页，可以上传封面和正文图片。支持 PNG、JPEG、WebP 和 GIF；静态图片原图最多 20 MiB，GIF 和动态 WebP 原图最多 8 MiB。上传前可以旋转图片；本站受管图片会转换为 WebP，动画会保留。 正文图片上传成功后插入编辑器，仍需保存正文。请使用插入的本站图片地址，不复制下载跳转后的临时地址。头像可在账号设置中上传，按中心裁成正方形。\n前置、可选联动与整合包含内容\n你要说明的事实应当怎样写不装另一个项目就无法正常使用写入“前置依赖”，注明适用范围及必要版本装上另一个项目才出现额外功能标记为“可选”依赖，并在说明中写明启用条件和作用某版整合包已经包含这些项目记录该次发布的“包含内容”，并核对再分发条件与某项目组合使用存在已知冲突标明涉及的版本、复现情况及已知处理方式 站内已有项目时优先引用它；站外项目填写可识别的名称和原始地址，不用含糊的“某前置”代替。新增的本站依赖选择器只绑定当前已公开的本站资源，不会根据外链地址暗中转换目标。项目之间的依赖或包含记录不代表转移作者身份或获取再分发授权。 创建页的本站“前置依赖”为整个资源共用，并按必需依赖提交。本站关联允许将通用或单条物理构建的依赖分别标记为必需、可选，并补充说明；只对部分构建生效的前置应绑定对应物理 ID，不能放进通用清单。版本号、文件相同的两条构建仍有各自的依赖；公开页面按实际加载器与游戏版本组合显示。通用依赖、单构建依赖和教程关联分别保存；旧引用有重复、未知角色或超过清单上限时，应先按原始 ID 逐条核对与整理，不要以当前分页覆盖完整清单。包含内容绑定创建时的发布记录；当前“发新版本”网页尚无包含清单编辑控件，后续每版清单需使用发布 API 维护，不能假定自动沿用。 整合包没有固定的模组数量或下载量门槛。请说明核心玩法、主要内容、安装方式、内存参考值和测试条件；逐项检查是否允许把第三方文件放入分发包。没有确认允许再分发时，提供项目来源和获取说明，不直接附上其文件。不要把 Minecraft 本体、第三方启动器、Java 或其他软件默认视为可随包分发的素材。\n关联教程与旧版说明\n资源可以引用本站已经独立发布的教程。教程先从主站 \u002Ftutorials\u002Fnew 创建，在 \u002Fmember\u002Ftutorials 单独管理，再到资源编辑页关联；解绑资源不会删除教程、章节或段落。资源文档在此只承担关联作用，不在资源编辑页创建或发布教程。旧版资源内 knowledge\u002Fprose 说明保留原值，不能自动视为独立教程。\n更新、修正与撤回\n更新时说明新增功能、修复问题、兼容变化、配置或存档迁移风险。资源通用介绍不必每版重写。针对某一版本的重要变化，保留版本号和日期，避免覆盖旧说明后让旧版用户无从判断。 从账号菜单进入“我的创作”，选择“编辑资源”，可以修改资源资料、标签和发布意图，并维护已有物理发布记录的说明、渠道、运行环境、兼容范围、文件、可见状态与发布时间。“发新版本”表单也可以选择正式版、Beta 或 Alpha 及运行环境；实验性构建不应被当作稳定版发布。 文件或兼容集合填错时，应在编辑页修正选中的物理记录，或撤回错误记录后发布正确构建；不要只修改正文，却继续保留错误的兼容声明。删除操作只删除选中的构建，同一批次其他构建仍在。资源被管理员处置期间，网页只开放发布记录的说明修正，不提供状态、文件和兼容调整；需要撤下或替换的错误记录应在复核材料中列明，公开状态由管理员恢复。 创建草稿、保存第一条发布记录和公开资源分步完成。中途失败时，先在当前页面重试，或从“我的创作”找回草稿，核对已有发布记录后继续，避免重复创建资源或发布记录。 资源删除后，独立帖子不会跟着消失，引用处会保留失效提示和必要的墓碑信息。本站无法替你删除站外托管的原文件；镜像维护者仍应处理自己控制的下载地址。 因缺失信息、文件争议或其他问题被处置时，请对照审核与处置规范修正具体问题。保存修改不会自动解除处置；需要复核时，按复核材料要求提供修改位置及依据。\n提交前检查\n资源未重复创建；名称、简介和介绍能说明真实用途。 原作者、本人维护范围、来源及许可条件写清楚。 每一支持组的所有加载器和版本组合都成立。 下载文件与名称、大小、格式、SHA512 完全对应。 通用前置、版本差异、可选联动和包含内容没有混写。 整合包清单与本次发布一致，第三方素材的分发条件已核对。 已说明安装方法、运行环境、已知问题及重要数据风险。 发布后打开详情，检查文件、支持范围、图片、链接和实际展示。",{"path":27,"title":26,"description":672,"keywords":673,"order":660,"source":661,"content":674},"让读者识别作品、原作者、维护范围和具体使用条件。",[],"让读者识别作品、原作者、维护范围和具体使用条件。 名称帮助用户找到同一个作品；署名和来源帮助用户判断内容由谁制作、哪里发生了修改，以及到哪里核实。\n名称与译名\n优先使用原作者采用的名称。已有官方中文名称或广泛使用的译名时，可采用中文名称，并在介绍中保留原名。没有确定译名时，保留原名；自行翻译的名称写明“暂译”，不要宣称是官方名称。缩写应能追溯到原名；不为了搜索流量堆叠无关作品名、加载器、版本号或“最强”等宣传词。分支、非官方移植、汉化补丁和二次打包应说明与原作的关系，不让读者误以为由原作者发布或支持。 本站资源使用一个名称字段，没有百科式“主要名称 \u002F 次要名称”表单。原名、译名、缩写和名称由来可以放在介绍中，不需要为了另一种语言重复创建资源。\n署名至少说清四件事\n项目应填写的信息原作者作品或被引用材料的作者、团队；多人贡献时说明角色原始来源官方发布页、源码仓库、原文或素材页面，尽量定位到所用版本你的工作原创、翻译、修改、打包、移植、资料整理或镜像维护的具体范围使用条件对应版本的许可名称及文本链接，或明确覆盖本次使用方式的授权说明 例如： 原作：Example Project，作者 Example Team。\n原始来源：填写原始发布页和所用版本链接。\n本文由本人整理，截图来自本人在所述版本中的测试。\n本人修改范围：补充中文说明，未修改原始程序。\n许可或授权：填写适用许可文本或授权依据，说明是否包含文件再分发。 只有确实由自己制作的部分才称为原创。“整理”“汉化”“适配”和“转载”不能抹去原作者；取得维护权也不等于取得所有素材的所有权。 资源所有者可以通过本站账号邀请共同作者，对方接受后共同维护资源资料与发布记录。公开页面展示的本站共同作者只说明当前维护关系，不证明其为原作品作者，也不替代转载、镜像或素材使用授权。邀请、移除或退出不会修改资源介绍中的原作者和来源说明。\n发布文件、镜像和整合包前\n先核对所用版本的许可文本或授权说明，确认是否覆盖准备进行的复制、修改、翻译、再分发或收费方式，并遵守其中适用的署名、保留声明、源码提供等条件。不要仅凭“可以免费下载”“仓库可见”或“别人也在转发”推断许可范围。 当前网页没有独立的许可证选择器，也不会自动核验授权。请在资源介绍中写清依据并保留必要记录。授权材料涉及真实姓名、邮箱、订单或私人聊天时，只公开核实所必需的信息，并先处理敏感内容。 镜像和整合包还应注意： 镜像明确写出原始地址、上游版本、同步日期及是否修改，不冒充官方发布。修改版区分上游变化与自己的变化，记录新增文件、配置、补丁和素材的来源。整合包逐项检查所包含的项目和素材；整合包自己的许可说明不能自动替代其中各项内容的使用条件。第三方程序、游戏文件、启动器、运行环境和美术素材分别核对，不因它们能在本地运行就默认允许随包分发。无法确认文件再分发条件时，先提供原始获取页与安装说明，不上传或镜像该文件。\n引用文字、图片和资料\n引用要服务于自己的说明，清楚标出来自哪里、引用的是哪一部分，以及自己补充了什么。不要把整篇文章或整套图片复制过来，仅在末尾补一个来源地址。 截图、译文、图标、封面和演示视频同样需要检查来源及适用条件。用作者的图不等于获得作者认可；作者允许引用一句说明，也不自动表示允许重新分发程序文件。 指向站内资源时使用其现有地址。需要通过 API 引用具体发布记录、教程章节或段落时，使用平台提供的稳定标识，不以当前排列的“第几个”作为长期定位依据。教程有独立创建、阅读和编辑入口，资源共同维护不改变教程作者或编辑权限。\n出现争议时\n核对具体材料：内容地址、涉及版本、原始来源、许可文本或授权范围，以及争议部分。请按这些事实更正署名、移除争议材料或停止提供相关文件，不通过辱骂、公开私人信息或发动围攻处理分歧。 需要向管理员说明时，按举报、版权投诉与复核提供具体地址、涉及版本、权利依据和可联系的方式；材料中有敏感信息时使用管理渠道，不公开完整私人记录。 本页是发布内容的整理要求，不替具体许可、授权约定或争议情形作统一结论。没有另行填写许可，不表示作品自动获得某一种默认许可证；在本站公开也不表示他人可以任意修改、镜像或收费再分发。",{"path":31,"title":30,"description":676,"keywords":677,"order":660,"source":661,"content":678},"发布者自查与内容核查共用的资源真实性、兼容性、来源和风险说明标准。",[],"发布者自查与内容核查共用的资源真实性、兼容性、来源和风险说明标准。 本页是资源的内容核查标准，供发布者自查，也供核查人员说明具体问题。资源是否适合收录，先看资源定义与收录范围；表单操作见资源发布规范。 资源首次发布和实质修改需要提交发布审核，通过后才更新公开内容。可编辑草稿、送审时冻结的版本和当前公开版分别保存；审核期间可以继续修改草稿，明确重新提交后才会替换正在审核的版本，旧公开版在新版本通过前保持不变。 只有符合已启用低风险自动批准条件、且结果完整的审核才可自动通过；其他情况由有权限的审核人员处理。通过审核、能够公开访问或曾被核查，都不代表获得官方安全认证，也不代表平台已经逐一验证全部文件、环境与授权材料。 核查应针对具体事实和下列条款。下载量、篇幅、项目规模和是否开源不能代替判断；闭源不等于侵权，开源也不等于可以任意分发。收费或商业使用还需核对许可与适用服务规则，本页不授予收费许可，也不表示本站提供交易功能。\nR1：对象真实、身份可识别且未重复建档\n发布者须说明： 作品或服务的名称、用途、实际可用内容及获取或使用入口。已有同一作品时，在原资源维护；独立分支写明实质差异与维护关系。核查依据与问题例： 对照页面、原始来源和已有条目，确认它们是否指向同一个作品。只有群号、没有可识别对象，或为同一作品的译名、版本、加载器、镜像重复建档，应指出缺失信息或重复依据；不能仅因名称相近就认定重复。\nR2：介绍足以帮助用户开始使用\n发布者须说明： 核心功能、适用场景、基本安装或接入步骤、必要环境、已实现范围和主要限制。外部文档可以补充细节，但资源页面自身要能说明基本用途和使用条件。核查依据与问题例： 检查读者能否判断“它做什么、我能否使用、从哪里开始”。只有宣传图片、空泛口号或“加群后再说”，不能替代这些信息；不按固定篇幅要求作者扩写无关内容。\nR3：署名、来源与使用依据清楚\n发布者须说明： 原作者、原始发布地址、自己的维护或修改范围，以及对应版本允许本次使用方式的许可或授权依据。整合包、镜像及美术素材应分别核对第三方内容。核查依据与问题例： 对照所用版本的许可文本、来源页面或必要的授权材料，确认复制、修改、翻译、再分发和收费等实际行为是否有依据。“开源”“免费下载”“仓库可见”都不等于可以无条件转载；闭源也不等于没有授权。存疑时指出具体材料和行为，不凭空作统一结论。署名写法见命名、署名与转载。\nR4：兼容声明与依赖对应实际构建\n发布者须说明： 每条发布记录适用的加载器、游戏版本、运行环境及必要依赖，区分通用前置、版本差异、可选联动和已知冲突。未验证的环境明确注明。核查依据与问题例： 将文件、项目文档和测试说明与对应记录核对。用户指定的加载器和版本必须由同一条发布记录同时满足，不能把记录 A 的加载器与记录 B 的版本拼接。一个支持组内的所有加载器与版本组合都应成立；不同文件分别声明，不能笼统标成全环境通用。\nR5：文件、外链与校验信息准确对应\n发布者须说明： 实际交付文件、文件名、格式、大小、版本及要求填写的校验值；外链对应哪个文件、是否修改过上游内容。使用稳定的版本地址，文件变化后同步更新说明与记录。核查依据与问题例： 核对链接目标和页面声明是否一致，是否存在失效地址、空文件、伪装扩展名、替换成另一版本却保留旧校验值等情况。SHA512 只能用于核对文件一致性，不能证明来源合法或文件安全。核查不以执行未知文件为前提。\nR6：获取与使用条件提前披露\n发布者须说明： 登录、提取码、特定启动器、地区或账号限制，以及付费项目、收费范围和免费部分的限制。服务器或在线服务说明实际接入条件与必要规则。核查依据与问题例： 对照页面介绍与实际获取路径，检查关键条件是否在用户下载、注册或付款前可见。声称免费却在获取最后一步强制付费、隐藏必须加群的步骤、将演示内容写成全部交付内容，均应指出。披露收费条件不能替代对许可与适用服务规则的核对。\nR7：安全相关行为有明确说明\n发布者须说明： 资源是否联网、收集或发送遥测、自动下载或更新代码、要求较高系统权限，以及这些行为的用途、涉及范围和可配置方式。需要改动文件、账户、世界存档或服务器数据时，说明重要影响与备份要求。核查依据与问题例： 对照公开文档、配置说明、可核实报告和作者提供的材料，确认行为是否与介绍一致。隐瞒信息窃取、后门、破坏性行为或不必要的权限要求，不能用“自行承担风险”代替说明。本标准不承诺平台自动扫描或自动识别全部危险行为。\nR8：图片、效果与性能结论有依据\n发布者须说明： 截图对应的版本与环境；概念图、渲染图、额外光影或后期处理应标明。性能或兼容结论提供测试场景、硬件、设置、方法和适用范围。核查依据与问题例： 检查展示是否来自所述作品，是否把其他项目的画面、尚未实现的设计或特定条件下的结果当作普遍效果。不能仅凭一张帧率截图宣称所有设备提升相同比例；也不要求每个小作品提供与其功能无关的性能测试。\nR9：版本风险与维护状态如实保留\n发布者须说明： 版本变化、实验性状态、已知故障、配置或存档迁移风险，以及影响使用的停止维护、服务中止或上游变化。旧版本仍有用户时，保留可判断其风险的说明。核查依据与问题例： 对照更新说明、发布日期、上游公告及可核实的问题反馈，确认没有把未完成版本写成稳定成品，或在发现重要风险后继续沿用相反承诺。暂停维护不自动等于违规，但不能继续承诺实际上已不提供的服务或支持。\n按交付方式补充必要信息\n下表根据实际交付内容补充要求，可以同时适用多行，不要求发布者选择一个唯一分类。 交付方式需要补充的信息程序、代码库、模组、插件或启动器安装或构建入口，客户端与服务端要求，运行环境和前置，必要配置，联网、更新与权限行为，重要数据改动整合包、配置包或服务端方案本次发布的包含内容，导入方式、目录结构、核心用途、内存参考值与测试条件，第三方文件的分发依据；移除账号、令牌、个人存档和无关缓存皮肤、材质、光影、地图或模型实际预览，格式与分辨率等必要参数，适用版本或工具，导入方式，依赖和第三方素材来源；地图涉及存档替换时提示备份服务器或在线服务可使用的入口、接入步骤、适用客户端或协议环境、必要规则，注册和付费条件，涉及的数据收集及服务限制；不把群人数或宣传截图当作可接入证明 不设置最低下载量、流量、内容数量或项目规模门槛，也不要求所有资源开源。需要多少说明取决于使用者能否作出准确判断。\n三个判断示例\n情形信息不足或错误的写法可以核查的写法兼容范围“Fabric、Forge，支持 1.20.1、1.19.2”，实际只有两个特定组合分别声明 Fabric 1.20.1 和 Forge 1.19.2 的对应构建，写明各自文件与依赖；不声称存在 Fabric 1.19.2 构建服务器介绍“长期稳定，进群了解”，只有一个群号写明服务名称、玩法、接入地址或入口、支持环境、必要规则和费用条件，群聊仅作为补充联系方式文件转载“网上开源的，侵删”，未列来源或许可标明原作者、原始版本与地址，列出适用许可或授权依据，并按其条件保留声明；无法确认再分发条件时只提供原始获取页\n发现问题后的核查边界\n一般信息问题应说明对应条款、涉及版本、可核实事实和需要补充或更正的内容。核查人员不要求作者执行与问题无关的任务，也不将个人偏好写成统一准入条件。 发现疑似窃取凭据、后门、破坏数据等高风险线索时，应先停止相关文件的继续分发，并交由管理员处理。发布者应保留涉及版本、来源与必要材料；核查人员不得为验证而直接执行未知文件，也不要在公开讨论中传播可用于攻击的细节、敏感数据或危险载荷。 内容的下架、移除、修正与恢复按内容处置说明处理；提交线索或对处置有异议时，按举报与申诉提供材料。发布审核进度与反馈可在主站 \u002Fmember\u002Fpublications 查看。本页不承诺固定处理时限或自动恢复安排。\n发布与核查清单\n对象真实可识别，没有为同一作品的译名、版本、加载器或镜像重复建档。 介绍说明用途、使用步骤、必要环境与已实现范围。 原作者、来源、维护关系及对应使用方式的许可或授权依据清楚。 每条发布记录的兼容组合、文件、依赖和冲突说明相互对应。 下载外链、文件信息与校验值准确，获取和收费条件提前披露。 联网、遥测、自更新、权限及重要数据风险已说明。 图片、效果与性能结论有对应版本、环境或材料可核查。 已知问题、实验性状态和维护变化已如实更新；高风险线索已交管理员处理。",{"path":35,"title":34,"description":680,"keywords":681,"order":660,"source":661,"content":682},"按证据核查资源，说明问题与整改方式，区分内容处置、举报结论和恢复。",[],"按证据核查资源，说明问题与整改方式，区分内容处置、举报结论和恢复。 本页供参与内容核查的管理人员使用，也让发布者了解处理依据。核查可以来自日常检查、用户举报或整改后的复核，统一采用资源审核要求。 内容首次发布和实质修改需要发布审核。本页同时说明送审前后的核查原则，以及已经公开内容的下架、整改和恢复；通过审核不表示获得安全认证，也不表示每个文件均经平台测试。\n发布审核与三个版本\n作者保存的是可继续编辑的草稿；提交审核时，系统冻结当次送审内容；读者看到的是已经通过审核的公开版。审核期间保存新草稿不会修改冻结版本，也不会替换旧公开版。作者需要明确重新提交并确认替换，才会让新草稿进入新一轮审核。首次资源发布涉及同一批次的资源与发布记录时，需整批通过后才公开。 只有已启用的低风险自动批准条件全部满足、审核结果完整时，才可自动通过。其余情况进入人工审核，包括结果不足、执行失败或不符合自动批准条件的情况。人工审核人员先领取任务，核对冻结内容和证据，再作出批准、要求修改或拒绝的决定；不能审核自己的内容。 要求修改或拒绝后，作者可以依据反馈修改草稿并重新提交。公开基线已经变化时，应先比较差异，按页面要求确认后继续，不能把过期审核结果直接覆盖到新的公开内容。作者可在主站 \u002Fmember\u002Fpublications 查看自己的记录与反馈。\n核查应遵循的原则\n同一事实适用同一要求。 不以作品规模、下载量、作者知名度、是否开源或个人审美代替判断。闭源、预览版本和小型作品也可以提供充分的使用信息。结论对应证据。 区分能够复现的问题、上游明确说明、发布者声明与尚未证实的推测。缺乏证据不等于已经证明违规。明确影响范围。 问题在某条发布记录、某个文件或某段介绍时，应指出具体位置，不把一个版本的问题写成所有版本均有问题。选择与风险相称的操作。 能通过补充说明解决的问题，先说明缺什么；涉及凭据窃取、恶意执行、隐私暴露等风险时，优先限制继续传播，再核实完整事实。保留更正与复核的机会。 说明整改方式，核对发布者的补充材料；处置错误时应纠正，不以维护原结论为目的寻找理由。回避利益冲突。 核查涉及自己的作品、团队或直接争议时，应交由其他管理员复核，不利用管理权限处理竞争关系。 发布审核由具备相应权限并完成二次验证的管理员或版务人员处理；其他后台处置仍按各自权限控制。协助测试或提供证据，不等于获得处置权限。\n核查顺序\n\n1. 确定对象与版本\n记录资源地址、涉及的发布记录、版本号、文件名、必要的校验值及核查时间。外链可能变化，应分清“提交时的文件”和“目前下载到的文件”。相似名称不是重复作品的充分证据，先比对原始来源、作者与维护关系。 资源定义有疑问时，先对照资源定义与收录范围。介绍不完整、字段格式错误和内容本身不适合公开，是不同问题，不能只用“质量不合格”概括。\n2. 对照要求核实\n按审核要求中的条目核对身份与来源、介绍、许可、兼容、文件、行为与风险说明。兼容性必须在同一条发布记录内成立，不能从不同记录拼出支持结论。 程序测试应在隔离环境进行。不要在个人日常设备或生产服务器直接运行未知文件，也不要把来源不明的文件交给其他用户“试试看”。扫描结果、开源地址和文件校验值都可以作为线索，不能单独证明安全或授权。 怀疑文件窃取凭据或包含其他高风险行为时，保留必要证据并交管理员处理。不要在公开说明中复述可用令牌、私人资料或可直接利用的危险细节。\n3. 给出可以执行的说明\n处置说明至少包含：对应条目、具体事实、涉及范围和修正方式。证据不能公开时，描述核查结论及可提交的反证，不公开敏感原件。 不合适的说明：“资源不规范，自己看规则。” 可采用的说明： 对照 R4“兼容与依赖”：2.0 版的同一支持组声明 Fabric、Forge 均支持 1.20.1，但所附文件及上游说明只覆盖 Fabric。请撤下错误记录，分别提供真实构建与兼容范围；如认为声明正确，请补充对应版本的测试依据。当前处置范围为该资源，复核时会逐项核对受影响记录。 无法确认时，应说明尚缺哪项材料，不以猜测、重复举报数量或当事人的态度代替证据。\n处理方式与实际含义\n情形处理方式需要注意已有信息满足要求，或举报依据不足保留内容；对举报记录填写核查结论“未发现问题”只覆盖本次核查范围，不是对作品的全面认证来源、安装步骤或限制说明缺漏，可通过修正解决向发布者说明需补充的具体信息；必要时按风险下架公开后整改按处置记录说明要求；发布审核中的“要求修改”则对应该轮审核结果继续公开会误导下载或传播争议、危险材料下架或移除，并填写原因两者都是可恢复的内容处置；不等同于删除实体问题已解决，或原处置有误复核后由管理员恢复恢复原先的草稿或发布意图，不一律变为公开确需删除内容实体使用删除操作，说明理由与范围删除不可按普通恢复处理，不能拿来代替临时下架 当前后台的资源处置作用于整份资源。核查说明仍须指出出问题的具体版本。资源未受平台处置时，维护者可以通过编辑页调整单条发布记录的说明与可见状态；处置期间，网页的发布记录编辑只开放说明修正，不能调整记录状态和发布时间。处置期间文件与兼容集合也不能直接修改，应在复核材料中列明错误记录及所需更正。站内处置不能替代撤下由发布者控制的站外文件。 内容处置与举报结论分别保存。 把举报标为已处理不会自动下架内容；驳回举报不会自动恢复内容。需要采取操作时，先完成对应内容处置，再说明举报处理结果。\n整改后的复核与恢复\n发布者可以修正介绍、补充来源与授权依据，并按举报、版权投诉与复核说明已完成的修改。仍需撤下或替换的错误发布记录，应一并列明，供管理员复核处置范围和后续更正方式。 管理员应逐项核对原处置原因是否消除，核实新材料是否对应同一作品和版本。不要仅因正文多了一句“已修复”就恢复，也不要要求与原问题无关的材料。 被处置内容的公开状态由管理员恢复。作者保存修改、再次设置发布意图或另发一条版本，不会自动解除处置；不得引导作者通过换账号或重建资源绕过处理。 处置和恢复都应填写具体理由，保留操作记录。举报终态保留首次处理人、时间和说明，不能通过覆盖旧结论来抹去先前处理过程。当前没有独立申诉队列，也不承诺固定复核时限。\n删除与独立讨论\n下架、移除只改变内容的公开状态，不据此宣称文件已经物理销毁。实体删除后的文件处理遵循引用和回收规则；涉及站外文件时，还需要处理实际托管地址。 删除资源不会连带删除独立帖子。曾公开的可信引用可保留资源名称、简介、封面及失效提示，不能再跳转下载；不能借墓碑公开原本私有的草稿或授权材料。教程的章节与段落定位也不能因处置而重新编号。 独立讨论中的辱骂、隐私泄露或危险附件需要分别核查。资源存在争议，不代表所有相关讨论都应删除；资源恢复，也不会自动撤销对其他内容作出的处置。",{"path":39,"title":38,"description":684,"keywords":685,"order":660,"source":661,"content":686},"提供可核实的问题与权利依据，了解举报入口、补充材料和处置复核方式。",[],"提供可核实的问题与权利依据，了解举报入口、补充材料和处置复核方式。 发现虚假兼容、错误文件、冒充作者、侵权转载、恶意行为或隐私泄露时，请提供具体位置和可核实的依据。对作品的难度、风格或功能取舍不满意，可以正常评价；仅有个人偏好差异不构成违规证据。\n从哪里提交\n主站的帖子、回复和资源页面提供“举报”入口。登录后填写问题说明，尽量一次写清位置、版本、事实及证据链接。说明最多 1000 个字符；材料较多时，先提交关键事实和必要链接，不要拆成多条重复举报。 同一账号重复举报同一内容时，会保留已有待处理记录。提交不等于平台认可举报结论，也不会自动下架内容。不要反复提交或组织他人集中举报来代替补充证据。 内容已经无法访问、材料不适合公开，或需要申请处置复核时，可以使用 NexusMC 现有政策公布的联系渠道： 用途联系渠道公布来源内容举报、版权投诉report@nexusmc.cn旧站版权处理说明对处置提出异议、一般咨询contact@nexusmc.cn旧站社区规范 以上为旧站现有政策公布的渠道，不是新站的申诉工单入口。当前没有独立申诉页面或自动复核队列；本指南也不承诺固定处理或邮件回复时限。\n一份有用的举报应包含什么\n具体对象： 完整站内地址；涉及某次发布时，补充版本号、发布日期或记录标识。出现的问题： 哪段说明、哪个文件或哪个行为与事实不符，可对照资源审核要求中的条目。核实依据： 原始发布页、许可文本、可复现步骤、必要截图或日志；注明核查日期和环境。影响范围： 哪些版本、加载器或用户场景受到影响，哪些尚未验证。希望更正的内容： 例如补全署名、修正兼容说明、停止提供争议文件；不要求公开他人个人资料。 例如：“资源 2.0 的支持组标为 Paper \u002F 1.20.1，实际下载文件内只有 Fabric 元数据。原始发布页列出的同名版本也只支持 Fabric，链接及核查日期如下。”比“这个作者在骗人”更便于处理。 日志、截图和授权记录应去除密码、访问令牌、私人聊天及无关个人信息。怀疑文件有窃取凭据或破坏行为时，不要在公开帖子附上危险文件或传播可直接利用的细节，应通过管理渠道说明。\n版权投诉需要补充的材料\n权利人或其授权代理人提出投诉时，请说明： 原作品及其可核对的来源，涉及的版本、文件或具体文字、图片。自己与作品的权利关系；代理投诉时说明代理范围并提供必要依据。被投诉内容的准确地址，以及涉嫌超出许可或授权范围的具体使用方式。对应版本的许可文本、授权约定或其他权利依据，并指出与实际使用的差异。希望采取的措施及可回复的联系方式，确认材料按自己所知真实、准确。 不要仅以“这是我的”“没有找我单独授权”代替具体依据；已有公开许可时，需要一起核对其适用版本和条件。来源、署名和再分发是不同问题，补一个原链接不一定能解决文件分发争议。 提交核实所必需的材料即可，不要求在公开页面上传身份证件、完整私人对话或无关订单。发布者也可以提交许可、授权记录、独立创作或事实更正材料供复核。具体争议按适用规则和材料处理，不套用另一站点的固定处罚次数或期限。\n提交后如何处理\n管理员按审核与处置规范核对对象和证据，必要时要求补充说明，或先限制有风险内容继续公开。举报结论与内容处置是两个操作：举报被处理不等于内容已删除；举报被驳回，也不等于平台对资源作了全面安全认证。 不确定、无法复现或善意误报，应与伪造证据、恶意骚扰区分。存在争议时继续围绕材料说明，不公开私人身份、不围攻当事人，也不要以删除批评作为解决资源问题的条件。\n对处置有异议时\n请由相关发布者或有权代表其说明情况的人提出复核，附上： 被处置内容地址、已知的处置时间和原因。对哪些事实或规则适用有异议，以及相应证据。已完成的修改，具体到段落、发布记录或文件。希望复核的结论及可联系的方式。 先修正能够确认的问题，再解释存在分歧的部分。不要通过另建同名资源、换账号或重复发布绕过处置。 管理员复核后，确需纠正的内容通过现有恢复等操作处理，并保留说明。恢复保持原来的草稿或发布意图；已经墓碑删除的实体不能按普通下架恢复。当前没有自动重提、申诉进度查询或必然恢复的承诺。\n与其他政策的关系\n本栏目说明新站的内容发布和核查要求。旧站的服务条款、内容发布协议、社区规范与版权处理说明仍可查阅原文，其中涉及的旧站账号、交易和处罚流程应按对应服务辨别。 旧站的隐私政策与Cookie 政策描述其对应服务，不能用来推断新站实际使用的统计工具、数据存储或保留期限。资源发布与核查指南也不代替服务条款、隐私政策或作品自己的许可条件。",{"path":7,"title":11,"description":688,"keywords":689,"order":660,"source":661,"content":690},"了解资源的定义、发布要求、审核依据，以及举报和整改复核方式。",[],"了解资源的定义、发布要求、审核依据，以及举报和整改复核方式。 发布前，先确定读者需要做什么：参与交流，阅读一份完整知识，还是下载或使用一个作品。 你准备分享的内容发布方式继续阅读讨论、使用体验、问题反馈、求助帖子帖子发布规范模组、插件、整合包、皮肤、服务器等作品或服务资源；有文件时附加发布记录资源发布规范有目录、章节和长期维护需求的系统知识教程当前网页尚未提供教程发布入口；不要为获得目录而把教程包装成下载资源 资源简介回答“它能做什么”；发布记录回答“这一版在什么环境下可以用”。与资源有关的交流可以关联现有资源，不必为提一个问题再创建资源。\n按你要做的事情阅读\n你想了解什么阅读页面什么算资源，何时新建资源、何时更新版本资源定义与收录范围如何填写介绍、兼容范围、文件和依赖资源发布规范发布前需要满足哪些要求，会核查哪些材料资源审核要求如何命名，怎样说明原创、转载、分支和授权命名、署名与转载管理人员如何核实问题、说明原因和恢复内容审核与处置规范如何举报、提交版权材料或对处置提出异议举报、版权投诉与复核如何交流、求助和提供复现材料帖子发布规范 第一次发布资源，建议依次阅读“资源定义 → 资源发布规范 → 资源审核要求”。核查内容时，使用同一份审核要求，并按处置规范记录事实与理由。\n发布前的共同要求\n登录并验证邮箱，确认页面显示的发布身份。账号受到发布限制时，应先处理账号提示。搜索已有内容。相同问题优先补充已有帖子；自己的作品更新时追加发布记录。把事实、体验和计划分别写清楚。未测试的兼容性、尚未实现的功能、未经确认的问题原因都要注明。给出足够的使用信息，并标明原作者、原始来源和适用的使用条件。检查链接、图片、文件信息和正文排版；删除密码、令牌、个人信息及无关的本地路径。\n内容应当让读者能够判断\n可以提出批评、比较方案，也可以发布规模较小的作品。请描述具体行为、适用条件和证据，不以辱骂、冒充身份、泄露隐私或没有依据的指控代替说明。 不得通过刷屏、重复发布、无关推广、恶意占屏等方式妨碍阅读；不得提供恶意程序、窃取信息的代码，或隐瞒已知后门和危险行为。分享转载文件、截图和文字前，请先按命名、署名与转载核对来源及许可条件。 与资源使用有关的官网、源码、问题反馈或社区链接可以提供；不要让读者必须先加群、付款或交出无关个人信息才能知道资源的基本用途、适用版本及获取条件。若获取或使用有额外条件，应在介绍中提前说明。\n发布之后\n当前帖子和资源沿用现有发布方式，没有统一的“先送审再公开”步骤。指南说明内容要求，不代表平台已经逐一验证文件安全、兼容性或授权材料。 发现信息有误后，应及时更正说明；重复发布新内容不能替代修正原有错误。管理员可以根据具体情况处置已发布内容。被处置的内容应按具体原因修正，不要换账号、换链接或重复发布来绕过处置。 帖子、回复和资源页面提供“举报”入口。登录后填写具体问题和能够核实的依据，不要公开当事人的敏感信息。同一账号重复举报同一内容时，会保留已有待处理记录。材料准备与复核渠道见举报、版权投诉与复核；本指南不承诺固定的处理时限、处罚次数或自动恢复。\n当前入口范围\n主站已有发帖页 \u002Fposts\u002Fnew、资源发布页 \u002Fresources\u002Fnew，以及资源下的“发新版本”页。账号菜单中的“我的创作”提供本人帖子和所维护资源的入口，包括资源草稿；可进入编辑页修正介绍、维护发布记录或处理自己的问题状态。下文中的这些路径指主站，不是文档站。 网页暂未覆盖全部编辑和管理操作。需要通过 API 管理自己的内容时，可阅读个人令牌指南和个人 API；API 同样校验账号状态、发布权限和资源维护者身份。",{"path":49,"title":48,"description":692,"keywords":693,"order":660,"source":661,"content":694},"从反馈、文档、测试到代码，了解如何为 NexusMC 选择合适的贡献入口。",[],"从反馈、文档、测试到代码，了解如何为 NexusMC 选择合适的贡献入口。 NexusMC 的公开项目可能接受社区贡献，是否接受外部改动、如何评审以及何时合并，以对应仓库的维护者和项目设置为准。你不需要先成为某个项目的维护者，也不需要只提交代码：清楚的复现步骤、文档修正、翻译、测试反馈和对设计的具体意见，同样能帮助项目继续前进。\n先选择贡献方式\n你想做什么建议入口报告一个可以复现的问题到对应 GitHub 仓库的 Issues 搜索已有问题，再新建 Issue建议新功能或较大的改动先在仓库的 Issue 说明目标和使用场景；仓库开放 Discussion 时也可使用它修正文档、示例或翻译找到对应仓库，阅读 README 和贡献说明后提交小范围 PR改进 npm 包从包对应的 GitHub 仓库开始，先确认 API、兼容范围和测试命令参与服务端软件先了解本地依赖、数据存储、配置和部署方式，再从独立问题开始不确定应该找哪里查看 NexusMC GitHub 组织，或在相关仓库中询问维护者 项目的技术栈、分支命名、测试命令和发布节奏可能不同。组织页是项目入口，具体仓库已有的 README、LICENSE、CONTRIBUTING 和 Issue 模板才是该项目的直接约定；这些文件并非每个仓库都提供。\n开始之前\n先搜索 Issue、Discussion 和近期变更，确认问题没有被解决，也避免重复实现。对新功能、架构调整和明显影响用户界面的改动，先开一个 Issue；仓库开放 Discussion 时，也可以先在那里说明要解决的问题、受影响的使用场景和可接受的方案。先把工作范围缩小到一个可审查的结果。修复一个问题、补充一组测试或完善一页文档，通常比一次重写整个模块更容易合并。阅读目标仓库的安装、开发和测试说明。不要根据另一个 NexusMC 项目的命令猜测当前项目的流程。检查仓库是否提供 LICENSE，以及第三方依赖的许可条件。没有明确许可证时，不要把公开可见误认为可以自由复制、修改或再分发；提交代码、图片、字体、示例数据或转载内容时，要有权将它们放入对应仓库。\n提交一个好的 Issue\nIssue 应该让维护者能够判断问题是否真实、影响什么，以及如何开始验证。至少提供： 使用的项目、版本、操作系统和运行环境；触发问题的最小步骤，以及实际结果和预期结果；相关日志、请求或配置的必要片段；是否能稳定复现，以及临时绕过方法；不要公开令牌、密码、邮箱地址、私有 URL 或其他敏感信息。 安全问题和可能暴露用户数据的问题，不要把利用步骤直接贴在公开 Issue 中。先查看对应仓库是否提供安全说明；没有私密入口时，联系仓库列出的维护者或 NexusMC 公开联系邮箱，并只提供最小的复现材料。\n提交一个好的 Pull Request\n提交 PR 前，先确认目标仓库允许外部贡献，并在自己的分支中保持改动集中。PR 描述应说明： 改动解决了什么问题；采用了什么行为和边界；如何验证，包括运行过的测试、构建或手工检查；是否有兼容性、迁移、文档或发布说明需要同步；如果关联已有 Issue，请附上链接。 代码、文档和配置都要遵循目标仓库现有的格式与命名。评审意见通常针对实现和证据，不代表对贡献者本人的评价；根据反馈补充说明或拆分改动，往往比继续扩大 PR 更有效。\n代码之外的贡献\n你还可以帮助维护者确认真实使用场景、复核文档示例、测试不同系统和浏览器、改进中文表达、整理复现案例，或指出 API 与实际行为不一致的地方。反馈越具体，越容易转化为 Issue、测试用例或可合并的修复。\n从这里继续\n查看 NexusMC 开源项目，选择 GitHub 仓库或已发布的 npm 包。查看 NexusMC GitHub 组织 的公开仓库、Issue 和项目说明。查看 NexusMC npm 组织 的已发布包和版本信息。如果想参与文档类项目，可先了解公开的独立 docs 仓库，再按该仓库说明提交贡献。 本页只说明通用入口，不替代某个仓库自己的贡献规则。仓库说明、许可证和维护者在具体项目中的最新决定优先。",{"path":53,"title":52,"description":696,"keywords":697,"order":660,"source":661,"content":698},"浏览 NexusMC 在 GitHub 和 npm 公开的库、服务端软件与基础设施项目。",[],"浏览 NexusMC 在 GitHub 和 npm 公开的库、服务端软件与基础设施项目。 NexusMC 的公开代码主要分布在 GitHub 组织；可以直接安装的 TypeScript 包则发布在 npm 组织。下面的目录按 2026 年 10 月 18 日的公开信息整理，项目是否继续维护、当前版本和贡献入口以对应仓库或 npm 页面为准。\nGitHub 仓库\n\nWeb 与 TypeScript 工具\n项目用途入口axnexus基于 Fetch 的类型化 HTTP 封装库GitHubnexusdownMarkdown 渲染器与 CodeMirror 6 编辑器框架GitHubnexusimage浏览器与 Node.js 的图片加载、处理和编码工具GitHubnexuspulse浏览器通知运行时与 Node.js 通知服务GitHubnexus-progress页面与异步任务进度指示器GitHub\n服务端与基础设施\n项目用途入口edgecacheGo 共享缓存与任务队列旁车GitHubnexusindex基于 PostgreSQL 的可重建搜索与数据分析索引GitHubmcstatusMinecraft 服务器检测节点GitHub\n文档与本地化\n项目用途入口docsNexusMC 文档中心的公开仓库（独立项目）GitHubi18nNexusMC 的多语言配置GitHub 仓库使用的语言和许可证以仓库页面及其中的 LICENSE 文件为准；没有 LICENSE 的仓库，不要按开源许可使用其代码。这里的 docs 是独立的公开仓库，不等同于本站正在阅读的文档页面。GitHub 组织页还可能出现尚未在本页分类的公开仓库，新增项目不需要等待本页更新才能参与。\nnpm 包\n以下包可以在 npm 的 @nexusmc-cn 组织下找到。包版本会独立于 GitHub 仓库更新，安装前请查看包页的兼容范围、变更记录和许可证。 包用途入口@nexusmc-cn\u002Faxnexus基于 Fetch 的类型化 HTTP 客户端与 Axios 风格实例npm · 源码@nexusmc-cn\u002FnexusdownMarkdown 渲染与 Vue 3 编辑器组件npm · 源码@nexusmc-cn\u002Fnexusimage浏览器端图片加载、调整、变换、EXIF 与编码npm · 源码@nexusmc-cn\u002Fnexusimage-node基于 Sharp 的 Node.js 图片处理与可选 Fastify 适配器npm · 源码@nexusmc-cn\u002Fnexuspulse浏览器 Push、Notifications、Service Worker、WebSocket 与 Badging 运行时npm · 源码@nexusmc-cn\u002Fnexuspulse-serverNode.js Web Push 与 WebSocket 通知服务及可选 Fastify 适配器npm · 源码 包页面显示的名称、版本和依赖可能随发布改变；不要把 GitHub 上的工作区名称自动当成可安装包名，也不要把尚未发布的内部包写进安装示例。 本页只列出 @nexusmc-cn 组织中已能从 npm registry 查到的公开包。NexusMC 其他服务端源码、工作区内部包和 vendor SDK 不属于这个 npm 安装目录；是否可安装、如何构建和如何部署，都要以对应仓库的说明为准。\n如何选择第一个贡献\n想熟悉 TypeScript，可以从 axnexus、nexusdown、nexusimage 或 nexuspulse 的文档、类型和测试开始。想了解 Go 服务，可以先阅读 edgecache、nexusindex 或 mcstatus 的 README、配置和本地启动说明。想改善站点文字或示例，可以从 docs 或 i18n 的具体页面和已有 Issue 开始。想贡献 npm 包时，先在对应 GitHub 仓库确认源码目录、构建命令和发布边界；npm 页面是消费入口，不一定包含完整开发环境。 无论选择哪个项目，都请先阅读贡献入门，再查看对应仓库的 README、LICENSE、Issue 模板和贡献说明。",{"path":64,"title":63,"description":700,"keywords":701,"order":660,"source":661,"content":702},"选择公开查询、个人令牌、开放平台或机器人事件，完成第一次请求。",[],"选择公开查询、个人令牌、开放平台或机器人事件，完成第一次请求。 NexusMC 提供公开内容、个人 API 与开放平台映射，并提供机器人事件、精简资源 v1 和 Webhook 管理参考。先按使用场景选择，再查看每个操作的参数和响应。 你要做什么从哪里开始读取公开资源和帖子公开内容 API，无需令牌为自己的脚本读写内容个人令牌指南与个人 API接收机器人私信和房间指令机器人账号接入与事件消费指南让其他用户授权你的应用开放平台指南与OAuth API 本地独立 API 的默认地址是 http:\u002F\u002F127.0.0.1:4520。部署时以接口参考中的服务器地址为准。示例请求从公开内容开始： curl --get 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fsite\u002Fsearch' \\\n  --data-urlencode 'q=性能' \\\n  --data-urlencode 'entity=resource' \\\n  --data-urlencode 'loader=fabric' \\\n  --data-urlencode 'mc=1.20.1' \\\n  --data-urlencode 'limit=10' 同一个查询在 TypeScript 中使用内置 fetch，不需要安装 SDK： type SearchResult = {\n  hits: { entityType: string; entityId: string; title: string; slug: string }[]\n  nextCursor: string | null\n  hasMore: boolean\n  scanBudgetExhausted: boolean\n}\n\nconst url = new URL('\u002Fv1\u002Fsite\u002Fsearch', 'http:\u002F\u002F127.0.0.1:4520')\nurl.search = new URLSearchParams({\n  q: '性能', entity: 'resource', loader: 'fabric', mc: '1.20.1', limit: '10',\n}).toString()\nconst response = await fetch(url)\nif (!response.ok) throw new Error(`查询失败：${response.status} ${await response.text()}`)\nconst result = await response.json() as SearchResult\nconsole.log(result.hits)\n\u002F\u002F 有 nextCursor 时，将它作为 cursor 参数继续请求；保持其他条件一致。 打开具体接口后，可在请求示例中选择语言与 HTTP 客户端。默认 Fetch 示例可用于 TypeScript；切换到 Shell\u002FCurl 可复制命令行请求。点击“测试请求”可打开调试工具，填写参数后手动发送。这些示例直接使用标准 HTTP API，无需安装客户端库。 搜索服务暂不可用时会返回 503；示例数据与 ID 只说明响应结构，不代表你的部署已经有这些内容。 公开查询只代表这份参考中列出的匿名接口。其他站点路由不会因为公开查询可用，就自动接受机器 Bearer 凭据。 下一步可读分页与错误，或直接打开资源筛选说明。",{"path":68,"title":67,"description":704,"keywords":705,"order":660,"source":661,"content":706},"为自己的工具使用有限的个人 API 权限。",[],"为自己的工具使用有限的个人 API 权限。 个人访问令牌（PAT）适合你自己控制的脚本和工具。登录 NexusMC 后在账号的 API 令牌管理页创建令牌，勾选实际需要的权限。令牌秘密只在创建或轮换时返回一次；请立即保存到服务端的安全配置中。 调用个人 API时，通过 Authorization: Bearer \u003Ctoken> 发送令牌： curl -H \"Authorization: Bearer $NEXUSMC_PAT\" \\\n  'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fpersonal\u002Fresources?limit=10' 此示例要求 resource:read:feed。PAT 可选择资源、帖子、本人资料和组织相关的 14 个 scope；每个操作要求的 scope 写在个人 API 参考中。令牌不会创建网站登录会话，也不能用于账号安全设置、后台、私信或媒体控制。需要代表其他用户访问时，请使用开放平台授权。 不要把令牌放进浏览器代码、URL、文档站配置或公开仓库。轮换会立即使旧秘密失效；调用失败时检查令牌是否过期、是否已撤销，以及 scope 是否覆盖该操作。 创建帖子需要 post:create。以下代码在服务端 Node.js\u002FTypeScript 运行，从环境变量取得秘密： const token = process.env.NEXUSMC_PAT\nif (!token) throw new Error('请先设置 NEXUSMC_PAT')\nconst response = await fetch('http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fpersonal\u002Fposts', {\n  method: 'POST',\n  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application\u002Fjson' },\n  body: JSON.stringify({ title: 'Fabric 性能配置交流', body: '分享配置与测试结果。' }),\n})\nif (!response.ok) throw new Error(`发帖失败：${response.status} ${await response.text()}`)\nconst result = await response.json() as { ok: true; id: string }\nconsole.log(result.id) 等价的 shell 请求（先在本地安全地设置 NEXUSMC_PAT）： curl --fail-with-body 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fpersonal\u002Fposts' \\\n  --header \"Authorization: Bearer $NEXUSMC_PAT\" \\\n  --header 'Content-Type: application\u002Fjson' \\\n  --data '{\"title\":\"Fabric 性能配置交流\",\"body\":\"分享配置与测试结果。\"}' 请求成功会返回 { \"ok\": true, \"id\": \"新帖子的稳定 ID\" }。这会实际创建内容，请使用自己的测试环境。",{"path":72,"title":71,"description":708,"keywords":709,"order":660,"source":661,"content":710},"使用 confidential client 和 S256 PKCE 获得用户授权。",[],"使用 confidential client 和 S256 PKCE 获得用户授权。 开放平台适合需要用户授权的服务端应用。先由站点账号创建应用，登记精确的回调地址与允许申请的 scope。client_secret 只在创建或轮换时返回；它必须保存在你的服务端。 授权流程按以下顺序完成： 为每次授权生成随机 code_verifier，计算 SHA-256 后做 base64url 编码，得到 code_challenge。将用户浏览器引导至 \u002Fv1\u002Foauth2\u002Fauthorize，传入 response_type=code、client_id、登记的 redirect_uri、申请的 scope、code_challenge_method=S256 与 code_challenge。建议附上随机 state 并在回调时核对。用户同意后，接入方服务端从回调取得一次性 code，用 code_verifier、同一个 redirect_uri 和 client authentication 调用 \u002Fv1\u002Foauth2\u002Ftoken。服务端保存返回的 access\u002Frefresh 凭据，仅把 access token 用于已获准的接口。刷新时替换旧 token 对；用户撤销授权后停止使用。 授权码有效期为 60 秒且只能兑换一次。access token 最长一小时，refresh family 有绝对 30 天期限；刷新不会延长这个上限。scope 可以缩小，不能扩大。\u002Fv1\u002Foauth2\u002Ftoken 与 \u002Fv1\u002Foauth2\u002Frevoke 使用专用 client authentication，不使用网站 Cookie\u002FCSRF；应用管理和 consent 则仍走网站会话。 只有带 profile:read 和\u002F或 email:read 的 OAuth access token 可以调用 userinfo。PAT 不提供这两个 scope。authorize、token 和 revoke 的协议错误返回 OAuth 的 { \"error\": \"...\" }，不要按普通内容 API 的错误信封解析。scopes 和 userinfo 的错误使用普通映射 API 的 {error:{code,message}}。参数和响应见 OAuth API 参考。 服务端交换授权码的 TypeScript 示例。OAUTH_CODE 来自已核对 state 的回调，OAUTH_CODE_VERIFIER 是发起本次授权时保存的随机值；回调地址必须与登记及授权请求一致： function required(name: string): string {\n  const value = process.env[name]\n  if (!value) throw new Error(`缺少 ${name}`)\n  return value\n}\nconst response = await fetch('http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Foauth2\u002Ftoken', {\n  method: 'POST',\n  headers: { 'Content-Type': 'application\u002Fx-www-form-urlencoded' },\n  body: new URLSearchParams({\n    grant_type: 'authorization_code',\n    client_id: required('OAUTH_CLIENT_ID'),\n    client_secret: required('OAUTH_CLIENT_SECRET'),\n    code: required('OAUTH_CODE'),\n    code_verifier: required('OAUTH_CODE_VERIFIER'),\n    redirect_uri: 'https:\u002F\u002Fexample.com\u002Foauth\u002Fcallback',\n  }),\n})\nif (!response.ok) throw new Error(`兑换失败：${response.status} ${await response.text()}`)\nconst tokens = await response.json() as {\n  access_token: string; token_type: 'Bearer'; expires_in: number\n  refresh_token: string; scope: string\n}\n\u002F\u002F 将 tokens 保存到服务端的安全存储；不要写入日志或交给浏览器。 同一请求的 curl 示例： curl --fail-with-body 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Foauth2\u002Ftoken' \\\n  --data-urlencode 'grant_type=authorization_code' \\\n  --data-urlencode \"client_id=$OAUTH_CLIENT_ID\" \\\n  --data-urlencode \"client_secret=$OAUTH_CLIENT_SECRET\" \\\n  --data-urlencode \"code=$OAUTH_CODE\" \\\n  --data-urlencode \"code_verifier=$OAUTH_CODE_VERIFIER\" \\\n  --data-urlencode 'redirect_uri=https:\u002F\u002Fexample.com\u002Foauth\u002Fcallback' example.com 是占位回调，必须替换。参考中的 REPLACE_WITH_* 字符串也只是占位秘密，不能直接完成兑换；必须先执行真实的授权与 S256 PKCE 流程。选择 HTTP Basic 时应删除 body 中的 client_id\u002Fclient_secret，不能同时使用两种 client authentication。 OAuth 接入使用 \u002Fv1\u002Foauth2；申请权限前请以当前 scope 列表为准。令牌交换、刷新、撤销和内容写入不会自动重试；超时可能已经提交。刷新请求结果未知时不要盲目重放旧 refresh token，否则会触发整族撤销。",{"path":76,"title":75,"description":712,"keywords":713,"order":660,"source":661,"content":714},"正确处理列表游标、普通 API 与 OAuth 的错误格式。",[],"正确处理列表游标、普通 API 与 OAuth 的错误格式。 先查看具体操作的参数与响应。不同列表可能使用 page\u002Flimit 或 cursor\u002Flimit；不要假设所有接口采用同一种分页方式。 对使用游标的操作，把响应的 nextCursor 原样放到下一次请求的 cursor 参数，并保持排序和其他筛选条件不变。nextCursor 为 null 时停止；游标是不透明值，不应自己解析或长期缓存。例如资源列表在支持的排序模式下才提供游标，搜索游标还绑定查询与索引状态并有有效期。 资源详情每个展示分组首屏最多返回 20 个完整发布单元；allReleases=true 也不会解除上限。继续加载时请求 \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002Freleases，传入该分组的 displayGroup 与 nextCursor，并保留 loader、mc、type 等上下文。displayGroup 只选择详情页展示分组，不能代替资源筛选器的加载器条件。 帖子详情返回有界的直接回复及子回复预览。继续加载 \u002Fv1\u002Fsite\u002Fposts\u002F{id}\u002Freplies 时，parent 使用需要展开节点的稳定 ID；首层用帖子的 repliesNextCursor，子层用该回复的 childrenNextCursor。保留返回的祖先上下文与墓碑，不要用数组下标重新编号。内容更新后旧游标可能返回 CURSOR_STALE，此时刷新对应首屏，不继续拼接不同 revision 的数据。 普通查询成功时直接返回操作定义的结果，例如资源列表含 items、total 等字段，没有统一的 ok\u002Fdata 包装。失败也要按操作和状态码处理：映射 API 统一返回 {\"error\":{\"code\":\"INVALID_INPUT\",\"message\":\"请求参数不合法\"}}。网站 Cookie 管理沿用各操作的原错误结构。401\u002F403 时检查令牌与 scope，400 时检查参数，不要把重试当作权限修复。 OAuth 授权、令牌与撤销协议有自己的错误格式，如 {\"error\":\"invalid_grant\"}，并设置不缓存响应。invalid_client 会返回 401；invalid_grant 常需要重新开始授权。两类错误的具体响应以接口参考中的操作为准。",{"path":80,"title":79,"description":716,"keywords":717,"order":660,"source":661,"content":718},"根据同一条发布记录同时匹配加载器与游戏版本。",[],"根据同一条发布记录同时匹配加载器与游戏版本。 筛选资源时，loader 与 mc 必须在同一条发布记录上同时满足。例如记录 A 支持 Quilt 与 MC 26.2，记录 B 支持 MC 1.19.4 但不支持 Quilt，那么 loader=quilt&mc=1.19.4 没有可用构建。把两条记录分别命中后合并，会给用户错误的下载结果。 curl 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fsite\u002Fresources?loader=fabric&mc=1.20.1' 同一筛选维度多选是“或”，跨维度是“且”；加载器、版本与由加载器推导的类型必须在同一条发布记录上判断。开放标签属于资源本身。详情页查询也可带上筛选条件，显示匹配的发布；匹配数为零时，应明确告诉用户当前组合没有可用构建。 筛选值及其 URL 参数以接口返回的分面 queryKey 为准。加载器族仅用于详情展示分组，不参与筛选。更多参数见公开内容 API。",{"path":84,"title":83,"description":720,"keywords":721,"order":660,"source":661,"content":722},"查询当前兼容构建，或接收公开资源的新发布、修改与撤回通知。",[],"查询当前兼容构建，或接收公开资源的新发布、修改与撤回通知。 服务器和启动器可以轮询更新接口；有公网 HTTPS 接收地址的机器人和托管服务也可以使用 Webhook。安装文件前应重新查询当前兼容构建。\n用阅读器订阅版本更新\n在资源详情页点击“订阅更新”，复制链接到支持 Atom 的阅读器。订阅地址使用主站域名： \u002Fresources\u002Fexample-performance\u002Freleases.atom\n\u002Fresources\u002Fexample-performance\u002Freleases.atom?loader=fabric&mc=1.20.1 详情页的订阅链接保留当前加载器、游戏版本和类型筛选。每条订阅内容对应一条原始发布记录，包含版本、兼容信息、发布时间、修订时间和更新说明；同版本号的不同构建可能分别出现。更新说明以纯文本保留 Markdown，超过 32768 个字符时明确标注截断。 默认订阅稳定版、最近 20 条；可使用 releaseType=release,beta,alpha 包含预发布版本，用 limit=50 调整条数（最大 50）。loader、mc、type 的联合匹配规则与下方更新查询一致。无匹配构建时返回有效的空订阅。 此订阅匿名读取，不需要账户或令牌。支持 ETag\u002F304，每次读取都会复核当前公开状态；资源不再公开时返回 404。订阅提供当前快照，不能用于完整历史追赶，阅读器已保存的旧条目也不会被远程删除。全站内容订阅仍使用 \u002Fatom.xml。\n查询当前构建\ncurl -i 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fsite\u002Fresources\u002Fexample-performance\u002Fupdates?loader=fabric&mc=1.20.1&releaseType=release&limit=20' loader、mc、type 在同一条原始发布记录匹配。同维度多选为 OR，跨维度为 AND；例如 loader=fabric&loader=quilt。releaseType 可选 release、beta、alpha，默认只有 release。多选可重复参数或用英文逗号连接。limit 默认 20、最大 50。 items 按发布时间倒序，保留原始发布 ID、加载器、游戏版本和文件信息。同版本号可能有多条精确兼容记录，不能把不同记录的加载器和版本自由组合。hasMore 表示还有更旧构建；本接口是当前快照，没有历史追赶游标。映射 API 的文件 url 使用明确的网站 origin 转为绝对地址；不持久保存下载跳转得到的短期签名地址。 保存响应 ETag，后续请求带 If-None-Match，未变化返回无正文的 304。404 表示资源当前不可公开读取，应停止使用旧快照；旧 ETag 不能使它返回 304。网络\u002F服务错误不等于资源删除，不应覆盖最后成功快照。轮询使用合理间隔和失败退避，429 时降低频率。 该接口可匿名访问，PAT\u002FOAuth access token 需要 resource:read:feed，不需要 profile\u002Femail scope。当前 OAuth 客户端为 confidential client，不要把 client secret 放入启动器或浏览器。完整参数、文件字段与响应见匿名更新查询和带令牌更新查询。\n创建订阅\n登录网站，进入「账号设置 → Webhook」，按正常安全验证创建接收地址，再输入资源标识添加订阅。可选加载器、游戏版本、发布渠道和事件。每个账户最多 10 个地址，每个地址最多 100 个订阅。 订阅任意公开资源不要求维护者授权，从创建之后开始，不补发历史。私有、草稿和未到期发布不会推送。可以暂停地址、取消订阅、轮换签名密钥、查看投递状态，并重试仍符合当前授权和端点版本的失败投递。 管理接口仅接受网站 Cookie，会话敏感写入同时要求 api-token 强验证和 CSRF。PAT、OAuth access token、OAuth client secret 不能管理 Webhook。签名密钥独立于 OAuth secret，只在创建\u002F轮换时显示一次；保存到接收端私密配置，不放入 URL、前端或日志。 接收地址必须是公网域名的 HTTPS\u002F443，不能带用户名、密码或片段，不接受 IP literal、内网或 HTTP 重定向。URL 最长 2048 个字符；每次发送重新验证全部 A\u002FAAAA 记录，任何非公网地址都会导致拒绝发送，并固定实际连接目标。服务需在 10 秒内完成响应，响应正文最多 64 KiB，建议成功时直接返回无正文的 204。\n管理接口参考\n每个管理操作的参数与响应可在 Webhook API 参考中单独查看；完整事件 schema 见 webhooks.json 的 webhooks.resourceRelease。下面是账户设置使用的 Cookie 管理接口。调用方必须拥有当前网站会话；GET 不要求二次验证，所有写操作都要求匹配 csrf_token Cookie 的 x-csrf-token 请求头，以及当前会话下用途为 api-token 的二次验证。二次验证由网站安全流程完成，有效期为 300 秒，服务器保存验证结果，无须另传 proof token。 如果自行实现同源管理界面，可通过 POST \u002Fapi\u002Fauth\u002Fstrong-action\u002Fverify-2fa 提交 { \"scope\": \"api-token\", \"code\": \"当前验证码\" }，或通过 POST \u002Fapi\u002Fauth\u002Fstrong-action\u002Fverify-double-password 提交 { \"scope\": \"api-token\", \"password\": \"双层密码\" }。两者同样要求 Cookie\u002FCSRF，成功返回 { \"verified\": true, \"scope\": \"api-token\", \"expiresIn\": 300 }。应使用账户已经绑定的认证方式；此流程不颁发 PAT，也不要求接收服务器持有网站 Cookie。 管理路径中的 id 是端点 ID。成功统一为 HTTP 200，直接返回下表结构，没有额外的 data 包装。创建、轮换与重试的请求正文必须是 JSON 对象；无参数时发送 {}。请求正文中的未知字段会被拒绝。 方法与路径请求正文 \u002F 查询成功响应GET \u002Fapi\u002Fwebhooks\u002Fendpoints无{ items: Endpoint[], quota: 10 }POST \u002Fapi\u002Fwebhooks\u002Fendpoints{ name, url, clientId? }{ endpoint: Endpoint, signingSecret }PATCH \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id{ name?, url?, enabled? }，至少一个字段{ endpoint: Endpoint }DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id无{ success: true }POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Frotate-secret{}{ endpoint: Endpoint, signingSecret }GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fsubscriptions无{ items: Subscription[], quota: 100 }POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fsubscriptions{ resourceSlug, events?, loaders?, mcVersions?, releaseTypes? }{ subscription: Subscription }DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fsubscriptions\u002F:subscriptionId无{ success: true }GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fdeliverieslimit：1–50，默认 20；cursor：上页的 nextCursor{ items: Delivery[], hasMore, nextCursor }POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fdeliveries\u002F:deliveryId\u002Fretry{}{ success: true } name 去首尾空格后须为 1–100 个字符。clientId 可省略；提供时必须是本人当前启用的 OAuth 应用 ID，只用于关联应用状态，不提供 OAuth client secret。创建后不能修改这项关联。 订阅参数为数组，单个数组最多 100 项，单项为 1–100 个字符的字符串，重复值会去重。events 默认三种事件，且不能为空；releaseTypes 默认 [\"release\"]，可选 release、beta、alpha，且不能为空。loaders、mcVersions 默认 []，表示该维度不限；非空时必须使用平台已有的字典值，同维度 OR、跨维度 AND，并在同一条发布记录上同时满足。不接受 type 或加载器族筛选。 同一端点对同一资源只能有一个有效订阅。修改筛选条件须删除旧订阅后重新创建，新订阅仍从创建时开始。新增订阅要求端点已启用且资源当前公开。资源之后不再公开时，列表中的 resourceSlug 为 null，resourceId 仍保留。 返回对象的字段如下；所有 ID 都按不透明字符串保存，时间为 ISO 日期时间，version 为十进制字符串： type EventType = 'release.published' | 'release.updated' | 'release.withdrawn'\ntype ReleaseType = 'release' | 'beta' | 'alpha'\n\ntype Endpoint = {\n  id: string\n  name: string\n  url: string\n  clientId: string | null\n  enabled: boolean\n  version: string\n  createdAt: string\n  updatedAt: string\n}\n\ntype Subscription = {\n  id: string\n  resourceId: string\n  resourceSlug: string | null\n  events: EventType[]\n  loaders: string[]\n  mcVersions: string[]\n  releaseTypes: ReleaseType[]\n  createdAt: string\n}\n\ntype Delivery = {\n  id: string\n  eventId: string\n  eventType: EventType\n  releaseId: string\n  resourceId: string\n  status: 'pending' | 'sending' | 'succeeded' | 'failed' | 'cancelled'\n  attempts: number\n  httpStatus: number | null\n  lastError: string | null\n  createdAt: string\n  availableAt: string\n  finishedAt: string | null\n} 端点与订阅列表不分页，分别受 10 和 100 的配额限制。投递列表按创建时间倒序分页，nextCursor 为字符串或 null；原样传回，不能自己生成游标。httpStatus 在未收到有效 HTTP 响应时可为 null；lastError 是脱敏分类，例如 http_error、dns_error、timeout、network_error、non_public_address 或 revoked，不含对端响应正文。 下面的 Fetch 示例适用于已登录网站的同源页面。先在网站完成 api-token 二次验证，再调用；不要复制会话 Cookie 到机器人或启动器中： async function manageWebhook(path, { method = 'GET', body } = {}) {\n  const headers = {}\n  if (method !== 'GET') {\n    const csrf = document.cookie.split('; ')\n      .find(value => value.startsWith('csrf_token='))?.slice('csrf_token='.length)\n    if (!csrf) throw new Error('请刷新网站后重试')\n    headers['x-csrf-token'] = decodeURIComponent(csrf)\n  }\n  if (body !== undefined) headers['content-type'] = 'application\u002Fjson'\n  const response = await fetch(`\u002Fapi\u002Fwebhooks\u002Fendpoints${path}`, {\n    method, credentials: 'same-origin', headers,\n    ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n  })\n  const result = await response.json()\n  if (!response.ok) {\n    throw new Error(result.data?.message ?? result.error ?? `HTTP ${response.status}`)\n  }\n  return result\n}\n\nconst created = await manageWebhook('', {\n  method: 'POST', body: { name: '构建通知', url: 'https:\u002F\u002Freceiver.example.com\u002Fwebhooks\u002Fnexusmc' },\n})\n\u002F\u002F created.signingSecret 仅本次响应可读，安全交付给接收端的私密配置，不写入日志。\nawait manageWebhook(`\u002F${encodeURIComponent(created.endpoint.id)}\u002Fsubscriptions`, {\n  method: 'POST',\n  body: {\n    resourceSlug: 'example-performance',\n    events: ['release.published', 'release.updated', 'release.withdrawn'],\n    loaders: ['fabric'], mcVersions: ['1.20.1'], releaseTypes: ['release'],\n  },\n}) 管理接口失败时先看 HTTP 状态，再读取响应中的 data.code 或 error： 状态常见原因与处理400{ ok: false, error: \"…\" }：参数、URL、配额、重复订阅、端点停用或重试条件不满足。混用 Cookie\u002FBearer 会返回 MIXED_CREDENTIALS。修正输入，不自动重试创建或轮换。401UNAUTHENTICATED：网站会话失效，先重新登录。403CSRF_INVALID：刷新并使用当前 CSRF；STRONG_ACTION_VERIFICATION_REQUIRED：完成用途为 api-token 的二次验证；FORBIDDEN：来源或账户不允许；机器令牌可能为 TOKEN_SCOPE_REQUIRED。404端点、订阅或投递不存在，或不属于当前账户；创建订阅时也可能是资源当前不可公开读取。409CONFLICT：并发操作触发唯一约束，重新读取当前列表。429 \u002F 5xx降低频率或稍后读取状态。写请求的结果未知时，先检查列表，不盲目重复创建或轮换。 一般错误结构为 { statusCode, statusMessage, data: { code, message, ... } }，与特定 400 的结构不同。请求还受网站 Origin\u002FFetch Metadata 校验；跨站调用不能通过加 CSRF 请求头绕过。所有管理响应均禁止缓存。\n事件与顺序\n事件为 release.published、release.updated、release.withdrawn。首次公开包括定时到期和资源从草稿公开；撤回包括资源或发布不再公开。普通事件结构如下，ID 示例仅说明字段，应用应将 ID 视为不透明字符串： {\n  \"schemaVersion\": 1,\n  \"id\": \"resource-id.1\",\n  \"type\": \"release.published\",\n  \"sequence\": \"1\",\n  \"occurredAt\": \"2026-10-15T00:00:00.000Z\",\n  \"resource\": { \"id\": \"resource-id\", \"slug\": \"example-performance\", \"title\": \"示例资源\" },\n  \"release\": {\n    \"id\": \"release-id\", \"batchId\": \"batch-id\", \"versionNumber\": \"1.0.0\",\n    \"name\": null, \"releaseType\": \"release\", \"publishedAt\": \"2026-10-15T00:00:00.000Z\",\n    \"loaders\": [\"fabric\"], \"mcVersions\": [\"1.20.1\"]\n  }\n} schemaVersion 是载荷协议版本；id 对应请求头的 webhook-id，同一事件重试时保持不变；occurredAt 是事件发生时间，不是本次尝试的签名时间。sequence 是资源内十进制序号，比较时使用 BigInt 或十进制整数比较，不能假设跨资源全局排序。一次发布的多个兼容配对保留各自 release ID，可按 batchId 合并通知。筛选和订阅范围会造成序号空隙，不能把空隙直接解释为丢失。 撤回只保留外层字段、resource: { id } 和 release: { id }，没有旧标题、正文、文件或签名下载链接。安装事实始终以当前查询为准。端点停用\u002F删除、订阅删除、关联应用停用，或地址\u002F密钥变更，会取消相关旧代未完成投递；重新启用后接收新事件，使用当前快照补齐状态。已经发出的请求无法召回，仍应在接收端校验签名与当前安装事实。修改端点名称不改变版本；轮换密钥会立即推进版本，没有双密钥重叠期。\n验证签名与防重放\n平台向接收地址发送 POST，Content-Type: application\u002Fjson，正文最多 256 KiB。请求头为 webhook-id、webhook-timestamp、webhook-signature。签名格式 v1,\u003Cbase64>，HMAC-SHA256 输入为事件 ID、Unix 秒时间戳、原始正文，以两个英文句点连接：eventId.timestamp.rawBody。密钥就是创建\u002F轮换返回的 signingSecret 字符串，按 UTF-8 使用，不做 Base64 解码。必须先保留原始正文再解析 JSON，不能重新序列化对象来验签；代理和中间件也不能改写正文。 以下完整示例使用 Node.js 内置模块，无第三方依赖。保存为 webhook-receiver.mjs。它只做本地联调：接收并保存到最多 100 条的内存 inbox，进程重启即丢失；满时返回 503，不淘汰旧事件伪装成持久去重。生产中的持久保存方法见下一节。 import { createHmac, timingSafeEqual } from 'node:crypto'\nimport { createServer } from 'node:http'\n\nconst secret = process.env.WEBHOOK_SIGNING_SECRET\nif (!secret) throw new Error('请设置 WEBHOOK_SIGNING_SECRET')\nconst MAX_BYTES = 256 * 1024\nconst inbox = new Map() \u002F\u002F 仅演示；生产替换为持久事务和队列。\nconst eventTypes = new Set(['release.published', 'release.updated', 'release.withdrawn'])\n\nclass HttpError extends Error {\n  constructor(status) { super(`HTTP ${status}`); this.status = status }\n}\n\nfunction verifyWebhook(headers, rawBody, secret) {\n  const id = headers['webhook-id']\n  const timestamp = headers['webhook-timestamp']\n  const signature = headers['webhook-signature']\n  if (typeof id !== 'string' || !\u002F^[a-zA-Z0-9._-]{1,128}$\u002F.test(id) ||\n      typeof timestamp !== 'string' || !\u002F^\\d{1,16}$\u002F.test(timestamp) ||\n      typeof signature !== 'string' ||\n      !\u002F^v1,[A-Za-z0-9+\u002F]{43}=$\u002F.test(signature)) return false\n  const seconds = Number(timestamp)\n  if (!Number.isSafeInteger(seconds) ||\n      Math.abs(Math.floor(Date.now() \u002F 1000) - seconds) > 300) return false\n  const expected = createHmac('sha256', secret)\n    .update(`${id}.${timestamp}.`).update(rawBody).digest()\n  const received = Buffer.from(signature.slice(3), 'base64')\n  return received.length === expected.length && timingSafeEqual(received, expected)\n}\n\nfunction readRawBody(request) {\n  return new Promise((resolve, reject) => {\n    let size = 0\n    const chunks = []\n    const timer = setTimeout(() => reject(new HttpError(408)), 5000)\n    const finish = (error, body) => {\n      clearTimeout(timer)\n      if (error) reject(error)\n      else resolve(body)\n    }\n    request.on('data', chunk => {\n      size += chunk.length\n      if (size > MAX_BYTES) {\n        chunks.length = 0\n        finish(new HttpError(413))\n        return\n      }\n      chunks.push(chunk)\n    })\n    request.once('end', () => finish(null, Buffer.concat(chunks)))\n    request.once('error', () => finish(new HttpError(400)))\n    request.once('aborted', () => finish(new HttpError(400)))\n  })\n}\n\nconst server = createServer({\n  maxHeaderSize: 16 * 1024, headersTimeout: 5000, requestTimeout: 8000,\n}, async (request, response) => {\n  const reply = status => {\n    response.writeHead(status, { Connection: 'close' })\n    response.end()\n    request.resume()\n  }\n  try {\n    if (request.url !== '\u002Fwebhooks\u002Fnexusmc') throw new HttpError(404)\n    if (request.method !== 'POST') throw new HttpError(405)\n    const contentType = request.headers['content-type']?.split(';', 1)[0].trim().toLowerCase()\n    if (contentType !== 'application\u002Fjson' || request.headers['content-encoding']) {\n      throw new HttpError(415)\n    }\n    const contentLength = request.headers['content-length']\n    if (contentLength !== undefined && Number(contentLength) > MAX_BYTES) throw new HttpError(413)\n    const rawBody = await readRawBody(request) \u002F\u002F 先限制原始字节，再验签、解析。\n    if (!verifyWebhook(request.headers, rawBody, secret)) throw new HttpError(401)\n    let event\n    try { event = JSON.parse(rawBody.toString('utf8')) }\n    catch { throw new HttpError(400) }\n    if (!event || typeof event !== 'object' || Array.isArray(event) ||\n        event.id !== request.headers['webhook-id']) throw new HttpError(400)\n    if (event.schemaVersion !== 1 || !eventTypes.has(event.type)) throw new HttpError(422)\n    if (typeof event.sequence !== 'string' || !\u002F^\\d+$\u002F.test(event.sequence) ||\n        typeof event.resource?.id !== 'string' || typeof event.release?.id !== 'string') {\n      throw new HttpError(400)\n    }\n    if (inbox.has(event.id)) return reply(204) \u002F\u002F 已保存的重复事件同样确认。\n    if (inbox.size >= 100) throw new HttpError(503)\n    inbox.set(event.id, event) \u002F\u002F 生产必须等持久事务提交成功后才能返回 2xx。\n    reply(204)\n  } catch (error) {\n    reply(error instanceof HttpError ? error.status : 503)\n  }\n})\nserver.maxConnections = 100\nserver.listen(8080, '127.0.0.1', () => console.log('Webhook 联调接收器已启动')) 在 shell 中通过环境变量注入真实签名密钥后启动： WEBHOOK_SIGNING_SECRET='创建或轮换时显示的 signingSecret' node webhook-receiver.mjs PowerShell 使用 $env:WEBHOOK_SIGNING_SECRET = '创建或轮换时显示的 signingSecret'，然后运行 node .\u002Fwebhook-receiver.mjs。本地监听地址是 http:\u002F\u002F127.0.0.1:8080\u002Fwebhooks\u002Fnexusmc，不能直接登记为平台端点；实际接入时由公网域名的 HTTPS\u002F443 反向代理转发，并保留原始正文与三个签名头。接收器中的 300 秒时间窗是接入方选择的防重放策略，需要保持系统时间准确；每次投递尝试会使用新的签名时间戳。 示例返回 404（路径不匹配）、405（非 POST）、415（非 JSON 或压缩正文）、413（超出 256 KiB）、408（读取正文超时）、401（签名或时间窗不合法）、400（JSON\u002F字段\u002F头部 ID 不一致）、422（不支持的协议版本或事件）、503（inbox 满或处理异常）。204 只表示这个演示进程已保存到内存。示例不打印密钥、签名、事件载荷或资源 ID。\n持久去重与处理\n生产接收端应把验签后的事件写入持久 inbox，并在同一个数据库事务内完成以下两步，再返回 2xx： 按 (接入来源, event.id) 唯一约束插入 inbox；重复且已成功提交的事件直接确认。为新事件写入自己的持久任务来源，或在同一事务中完成本地业务变更。事务失败返回 5xx，让平台重试。 唯一约束的来源应是同一平台环境，不能只用某一次接收进程的内存或可轮换密钥。若多个端点触发独立业务动作，可把本地逻辑消费者加入唯一键。先标记“已处理”再异步调用外部机器人会留下丢消息窗口；先调用再标记则可能重复，外部副作用还需使用其幂等键或可恢复任务。持久 inbox 本身不承诺外部副作用 exactly-once。 按事件 ID 去重与按序号保护状态是两件事。事件可能重复、乱序，时间窗不能代替去重；同一发布记录的旧 sequence 不得覆盖该发布记录的新状态。不同发布记录的通知不能仅因某个资源已见到更大序号就全部丢弃。较简单的做法是把通知作为“当前快照可能已变化”的信号，合并后重新查询更新接口，而不是用通知正文直接安装文件。 需要自动安装时重新读取当前兼容构建与文件，处理撤回后使旧缓存失效；查询 404 时停止使用旧资源快照。订阅不会补发历史、停用期间的变化也不会补发，因此首次订阅、接收端恢复、轮换后应主动同步当前快照。长期去重记录的保留应覆盖自身的恢复与人工重试窗口，不能只保留五分钟。\n投递重试与排查\n平台将 2xx 视为已接收；网络\u002FDNS 错误、超时及 HTTP 408、429、5xx 最多尝试 8 次（包含首次），采用指数退避和抖动。第 1–7 次失败后的等待分别约为 1、2、4、8、16、32、64 秒，另加不足一秒随机抖动；实际投递时间可能延后，不保证固定时刻，也不按 Retry-After 另行排程。其它 HTTP 状态（包括重定向）或不可重试的传输校验错误进入失败终态。 接收端可靠保存事件后及时返回成功。返回 200 但响应正文过大或迟迟不结束，仍可能被平台视为失败；用无正文 204 最简单。网络结果未知时可能重复发送，不承诺 exactly-once。 在账户设置或投递列表检查 status、attempts、httpStatus 与 lastError。修复接收端后，只能人工重试当前端点版本的 failed 投递，且订阅仍存在、端点与关联应用仍有效、普通事件对应的发布仍处在相同公开代次；重试成功仅表示已重置为待发送，响应不是对端已接收的证明。轮换、URL\u002F启停变更后旧版本失败投递不能重试，cancelled 也不能重试，应同步当前快照。 已结束投递在结束 30 天后可被清理；事件在创建 30 天后、完成分发且已无关联投递时可被清理，未完成来源会保留。投递列表不是永久审计日志。完整离线变化日志和 changes API 不在本版范围内。",{"path":88,"title":87,"description":724,"keywords":725,"order":660,"source":661,"content":726},"查询公开内容与组织，并按授权读取本人资料、维护内容和组织。",[],"查询公开内容与组织，并按授权读取本人资料、维护内容和组织。 公共 API v1 包括公开查询、个人 API、OAuth、机器人事件和精简资源查询。每个接口页都有参数、响应和权限说明；对应的机器可读规范可从接口页下载。本页中的 http:\u002F\u002F127.0.0.1:4520 是示例地址，实际请求地址以对应接口规范的服务地址为准。机器人账号的申请、令牌与事件消费见机器人账号接入。\n精简资源查询\n精简资源接口只提供列表、详情和当前兼容构建。完整接口见精简资源参考，机器可读契约见 public-v1.json。 操作接口参考筛选资源GET \u002Fv1\u002Fresources读取详情GET \u002Fv1\u002Fresources\u002F{slug}查找当前构建GET \u002Fv1\u002Fresources\u002F{slug}\u002Fupdates 三条路径均支持 HEAD，执行与 GET 相同的校验并返回状态和响应头，不发送正文。已知路径的其它方法返回 405 和 Allow: GET, HEAD；未知版本或路径返回 404。\n发起查询\ncurl --get 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fresources' \\\n  --data-urlencode 'loader=fabric' \\\n  --data-urlencode 'mc=1.20.1' \\\n  --data-urlencode 'limit=10' 无需令牌也可读取公开资源。若主动提供 PAT 或 OAuth access token，它必须具备 resource:read:feed；无效、过期、撤销或错误 scope 的凭据返回 401\u002F403，不会退回匿名读取。任何 Cookie 请求头均返回 400；请求不会创建网站会话，也不签发媒体权限。浏览器调用须使用 credentials: 'omit'，且只有运营方显式开放 CORS 后才可跨域访问。 const url = new URL('\u002Fv1\u002Fresources', 'http:\u002F\u002F127.0.0.1:4520')\nurl.searchParams.append('loader', 'fabric')\nurl.searchParams.append('loader', 'quilt')\nurl.searchParams.set('mc', '1.20.1')\nconst response = await fetch(url, { credentials: 'omit' })\nif (!response.ok) throw new Error(`请求失败：${response.status}`)\nconst result = await response.json()\nconsole.log(result.items)\n\u002F\u002F total 是十进制字符串，需要整数运算时用 BigInt(result.total)。 loader、mc、type、tag、capability 支持重复同名参数或逗号分隔，同维度 OR、跨维度 AND。加载器、游戏版本和类型必须由同一原始发布记录同时满足。例如 quilt 和 1.19.4 分别出现在两条记录上时，两者组合不会命中可用构建。加载器族不参与筛选。 q、sort、page、limit、cursor 是单值参数，重复键返回 400。未知参数、非法编码、空多选值及 GET\u002FHEAD 正文也会被拒绝。每维最多 64 个值，每值最多 128 字符；关键字最多 200 个 UTF-16 单元，请求 URI 最多 16 KiB、查询参数最多 256 个。 查询键和值中的 C0（U+0000–U+001F）及 DEL（U+007F）在 trim 去除首尾空白前拒绝，不能用编码后的制表符或换行绕过校验；正常 Unicode 查询与正文文本保留，不使用整段文本过滤。\n分页和稳定字段\n列表默认为 sort=updated&page=1&limit=20，最多 50 条，页码最多 1000；另可按 downloads 排序。nextCursor 仅用于 updated，继续请求时带上 cursor、保持 page=1 和其它筛选一致。游标不透明，不能解码后自行构造。格式、签名、版本或范围错误返回 400\u002FINVALID_INPUT；列表快照过期时返回 409\u002FCURSOR_STALE，此时从第一页重取。 成功直接返回该接口的对象；错误为 {\"error\":{\"code\":\"…\",\"message\":\"…\"}}。声明的字段稳定存在，coverUrl、body、nextCursor、更新的 name 和文件 sha512 在无值时为 null，数组为空时为 []。列表 total 和文件 size 均为十进制字符串，避免大整数精度损失。ID、revision 和游标按不透明字符串处理；发布时间保留源字符串中的微秒精度。 详情中的 releaseCount 和 matchedReleaseCount 统计展示合并单元；更新接口返回原始发布记录。详情不包含发布历史，不能从详情的加载器与版本数组任意组合出下载构建。正文是原始文本，应在客户端对应输出上下文转义或安全呈现。\n当前更新与条件请求\nupdates 只接受 loader、mc、type、releaseType 和 limit。渠道默认 release，也可多选 beta\u002Falpha；默认 20、最大 50 条。它是当前公开快照，hasMore 表示还有更旧构建，不提供历史 cursor。 收到 ETag 后可将其原值放入下一次请求的 If-None-Match。条件请求仍会核对令牌有效性和资源可见性；资源撤回或删除不会被旧标签掩盖。304 无正文，200 需要用新快照替换旧结果。安装前应再次复核构建。 公开 ETag 与响应中的绝对地址绑定。地址变化后，旧标签会被视为不匹配并返回 200；应使用新响应中的 ETag，不要用旧标签推断内容未变。未知标签也按不匹配处理；* 保留正常的存在性语义，并仍需通过相同的可见性校验。 响应使用 Cache-Control: private, no-store。429 表示请求超过频率额度，503 表示服务暂不可用；有 Retry-After 时按建议秒数等待。504 表示请求期限已到。单次响应上限为 2 MiB。 文件 url 是绝对地址。请直接使用返回的链接，不要将它重写成公共 API 域名，也不要将 SHA512 当作访问授权。\n公开组织与本人资料\n组织与本人资料使用同一套 v1 路径。公开组织列表仅包含已批准、公开且未解散的组织；列表可使用 q、page 和 pageSize，每页最多 50 条。详情可返回公开组织资料，或已解散公开组织的最小墓碑。私有组织和成员关系不会进入公开响应。 操作接口所需权限列出公开组织GET \u002Fv1\u002Fsite\u002Forganizations匿名读取公开组织GET \u002Fv1\u002Fsite\u002Forganizations\u002F{slug}匿名读取本人展示资料GET \u002Fv1\u002Fpersonal\u002Fmeuser:read:self列出本人组织GET \u002Fv1\u002Fpersonal\u002Forganizationsorganization:read:self读取本人组织GET \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}organization:read:self创建组织POST \u002Fv1\u002Fpersonal\u002Forganizationsorganization:create编辑组织资料PUT \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}organization:update:self curl --get 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fsite\u002Forganizations' \\\n  --data-urlencode 'q=创作' \\\n  --data-urlencode 'page=1' \\\n  --data-urlencode 'pageSize=20' \u002Fv1\u002Fpersonal 接受具有接口所列 scope 的 PAT 或 OAuth access token，不使用网站 Cookie。user:read:self 只读取本人的展示资料，与 OAuth userinfo 的 profile:read、email:read 分开；个人展示资料只提供读取接口。本人组织列表和详情仅覆盖本人拥有或作为活跃成员加入的组织，已解散组织只返回最小墓碑。浏览器跨域调用还取决于 API 的 CORS 配置，请使用 credentials: 'omit'。 curl 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fpersonal\u002Fme' \\\n  -H 'Authorization: Bearer \u003Caccess-token>' 创建组织要求账号可用、邮箱已验证且未被限制发布；创建者成为组织所有者。编辑只允许活跃所有者修改已批准且未解散的组织，必须提交当前正整数 version 和至少一个待修改字段。版本变化时返回 409；请先读取最新资料，再决定是否重试修改。 curl -X PUT 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fpersonal\u002Forganizations\u002Fexample-team' \\\n  -H 'Authorization: Bearer \u003Caccess-token>' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  --data '{\"version\":1,\"name\":\"更新后的组织名称\"}' 上述 scope 不授予网站后台或媒体管理权限。文档站不预填或保存令牌，也不代理凭据。",{"path":92,"title":91,"description":728,"keywords":729,"order":660,"source":661,"content":730},"创建个人机器人、申请权限，并通过个人 API 和事件接口处理消息。",[],"创建个人机器人、申请权限，并通过个人 API 和事件接口处理消息。 机器人使用独立账号发布内容和发送回复。资源、帖子与消息显示机器人的身份，公开主页标明其所有者。个人用户可在网站设置的开放中心创建和管理自己的机器人；官方通知账号另行管理。\n创建与授权\n在开放中心创建机器人并编辑展示资料、头像与简介。申请所需的权限和全站指令。每次申请提交完整的权限与指令清单；审核期间，已有的生效授权继续有效。授权生效后，为机器人创建 PAT，勾选该令牌实际需要的 scope。令牌明文只显示一次。 资源、帖子、本人资料和组织的 14 项普通个人 API 权限默认都需要审核，包括读取权限。私信与房间事件权限各有策略；平台可将权限设置为自动批准、需要审核或禁用。生效授权、令牌 scope、内容所有权及操作时的账号状态会共同决定一次调用能否成功。策略禁用或账号停用会阻断已有授权。 机器人 PAT 只能代表该机器人，不能创建网站会话，也不能访问后台或媒体控制。使用普通个人 API 时，请参照个人 API中每项操作的 scope 与参数；机器人调用同一路径，资源、帖子和组织的归属由机器人身份决定。人工账号的 PAT 或 OAuth access token 不能代替机器人 PAT 调用机器人事件接口。\n房间指令\n机器人的指令清单在全站统一登记，房间管理者决定在自己的房间启用哪些指令。@handle 查服 参数 或有效的开头结构化提及需要机器人提及权限；无需提及的 \u002F查服 参数 需要另外申请房间指令权限，默认进入审核。指令名称精确匹配，且可配置最少和最多参数数量。私聊由用户先发起，机器人只能对收到的事件回复，不能主动私信尚未与其互动的用户。 无 @ 触发权限随完整指令清单申请，管理员可逐条核准哪些指令能无需 @ 触发；未核准的指令仍可按提及权限使用。房间管理者仍需逐条选择本房间启用的指令。 公开机器人目录支持按名称或账号标识搜索，每次返回最多 20 个机器人；继续查询时传入上次响应的 next_cursor，搜索词必须保持一致。目录接口单独限制每分钟最多 20 次请求。房间管理者仍须在房间内明确启用机器人及可用指令。\n接收事件和回复\n完整字段、三类事件示例、TypeScript 消费代码与断线恢复见机器人事件与回复。 机器人事件参考提供 GET \u002Fv1\u002Fbots\u002Fme\u002Fevents 和 POST \u002Fv1\u002Fbots\u002Fme\u002Freplies。两者使用机器人 PAT 的 bot:events:read；回复时还会再次检查该事件对应的私信或房间回复权限。下面的地址仅为本地示例，实际地址以 bots.json 中的服务地址为准。 curl 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Fevents?after=0&limit=50' \\\n  -H 'Authorization: Bearer \u003Cbot-pat>' 按返回的 next_after 保存消费位置，重启后继续补取。事件中的 event_id 可用于回复；action_key 由机器人为本次动作稳定生成。同一机器人、事件和 action_key 只以首次提交为准：即使后续提交的 content 不同，也会返回首次发送的 message_id（duplicate: true），不会修改或再次发送消息。幂等重试仍须通过当前资格复核；每个事件最多接受 5 个新的回复键，不同业务动作使用不同键。 机器人事件及其回复幂等记录的保留期为 90 天，后台会分批清理到期记录。清理后不能再用旧 event_id 回复；聊天消息不受影响，事件序号也不会重置。因此客户端应持续保存 next_after，不要依赖从零开始重新获取全部历史事件。 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\":\"服务器在线\"}' 可连接 wss:\u002F\u002F\u003CAPI 域名>\u002Fv1\u002Fbots\u002Fme\u002Fevents\u002Fstream 接收事件变化提示。WebSocket 只推送 {\"event\":\"bot_events_changed\"}，不包含消息正文；建立连接和每次重连后仍需调用 HTTP 接口补取，运行期间也应定期补取。连接使用 Authorization: Bearer \u003Cbot-pat> 请求头，不在 URL 中放令牌。网页原生 WebSocket 不能设置该请求头，宜由可控制握手请求头的服务端客户端连接。 这些接口不使用 Cookie。Webhook 的订阅管理仍在网站同源接口下使用 Cookie、CSRF 和二次验证；资源发布事件仍由现有投递服务发送，与机器人事件 WebSocket 是两种不同通道。",{"path":96,"title":95,"description":732,"keywords":733,"order":660,"source":661,"content":734},"了解私信和房间指令事件，按游标读取消息、可靠回复，并在断线后继续处理。",[],"了解私信和房间指令事件，按游标读取消息、可靠回复，并在断线后继续处理。 完成机器人账号接入后，可使用机器人自身 PAT 接收人工用户发来的私信和房间指令，再回复原来的会话。HTTP 接口提供事件正文；WebSocket 提示有新变化，帮助客户端及时补取。 接口地址、参数与响应见机器人事件 API。以下 http:\u002F\u002F127.0.0.1:4520 是本地 API 地址，部署时替换为自己的 API origin。\n哪些消息会产生事件\n事件类型触发方式必要权限与条件dm人工用户向机器人发送私信bot:events:read、bot:dm:read；机器人、所有者和授权仍有效mention房间消息以 @handle 命令 参数 开头，或消息携带有效的开头结构化机器人提及bot:events:read、bot:room:mention；机器人在房间内，安装的提及开关开启，且该指令已在房间选用slash房间消息以 \u002F命令 参数 开头bot:events:read、bot:room:slash；平台逐条核准该指令，房间管理者也逐条启用 平台批准斜杠指令后，房间仍须自行启用。普通房间聊天、句中提及、未知或无法唯一定位机器人的命令不会产生事件；机器人发送的消息也不会触发另一轮机器人事件。 指令登记时会去除首尾空白并转为小写，名称为 1–32 个 ASCII 小写字母、数字、下划线、常用中文或连字符，首字符不能是连字符；触发时精确匹配登记名。参数按空白拆分，不支持 shell 引号语法。超过 10 项时不识别为指令，也不生成事件；对于已识别的指令，参数数量不符合该指令配置时，人工用户的原消息仍会保存，发送响应包含 command_error，机器人不会收到该事件。\n读取事件\ncurl 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Fevents?after=0&limit=50' \\\n  -H 'Authorization: Bearer \u003Cbot-pat>' after 是十进制字符串，首次读取使用 \"0\"，最大为 \"9223372036854775807\"。limit 默认为 50，可设为 1–50。必须使用机器人的 PAT；所有者自己的 PAT、OAuth access token 和 Cookie 均不能代替它。 下面把三类事件放在同一个响应中，展示各字段的差异。ID、时间与内容均为示例。 {\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} 字段含义event_id事件 ID，回复时原样传入seq当前机器人的事件序号，十进制字符串message_id触发事件的人工消息 IDroom_id房间 ID；私信为 nullconversation_id私信会话 ID；房间事件为 nulltrigger_kinddm、mention 或 slashcommand_id触发的房间指令 ID；私信为 nullcommand_revision触发时的指令修订号；私信为 nullargs已拆分的指令参数；私信为空数组content人工用户发送的完整消息文本author_id发送消息的人工用户 IDcreated_at事件创建时间，ISO 时间字符串\n正确保存游标\n事件按 seq 升序返回，但只包含当前仍有权限查看的消息。消息删除、权限变化或过期清理都可能造成序号间隔。 处理完一页后，保存响应中的 next_after，下次原样作为 after 传入。空页也可能推进 next_after；不要自行取最大序号、加一或猜测连续性。不要把 seq 或游标转为 JavaScript Number，大整数会丢失精度；也不要把本地未收到的较大数字当成游标。 同一机器人、相同 scope 集合、同一消费任务的多个实例应协调使用同一份持久化游标，避免相互覆盖进度。不同 scope 或独立业务消费者分别保存游标，防止一方推进后跳过另一方尚未处理的事件。首次启动、建立 WebSocket、重连以及正常运行期间，都应主动调用 HTTP 补取。\n回复与重复请求\ncurl -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\":\"服务器在线。\"}' 成功返回 {\"message_id\":\"…\",\"duplicate\":false}。回复发送到原事件对应的私信会话或房间，无需再指定目标。action_key 为 1–64 个 ASCII 英文字母、数字、下划线、连字符、冒号或点；相同业务动作应稳定使用同一个键。content 去除首尾空白后不能为空，最长 10000 字符。 同一机器人、event_id 和 action_key 的重复请求返回首次发送的 message_id，并设置 duplicate: true；改变 content 不会覆盖首次回复。每个事件最多接受 5 个新的回复键，重试已有键不占新额度。不要在每次重试时随机生成键。 回复前会重新检查当前资格，包括 PAT、授权、源消息、房间安装与成员、指令修订和开关；私信还检查双方拉黑及对方消息隐私设置。私信回复需要 bot:dm:reply，房间回复需要 bot:room:reply，并保留触发该事件所需的读取权限。读取到事件并不保证稍后一定还能回复，幂等重试也不能绕过资格复核。\nTypeScript 消费示例\n将下面代码保存为 bot-consumer.ts。它处理一页事件，每个事件发送一次确认；你可以将确认文本替换为自己的业务结果。ack-v1 在每次重试时保持一致。 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} 例如在 Node.js 中用本地文件保存游标。将以下内容保存为同目录的 run-bot.ts，配置环境变量 BOT_TOKEN、BOT_API_ORIGIN，使用支持 TypeScript 的 Node.js 运行 node run-bot.ts： 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} 此示例使用单进程，每页完成后替换游标文件。发生读取、回复或保存错误时会停止，排查后可使用原游标重启；上一页已成功的确认会通过相同回复键去重。若还要写数据库、调用第三方服务等，应为这些副作用另外保存处理状态和幂等键，事件回复接口不会替你的业务事务去重。\nWebSocket 变化提示\n连接 wss:\u002F\u002F\u003CAPI 域名>\u002Fv1\u002Fbots\u002Fme\u002Fevents\u002Fstream，握手时使用 Authorization: Bearer \u003Cbot-pat>。接口拒绝 Cookie、URL 查询参数、请求正文和 Sec-WebSocket-Protocol；令牌不要放进 URL。网页原生 WebSocket 不能设置这个请求头，应使用支持自定义握手头的服务端客户端。 唯一的应用层通知如下： {\"event\":\"bot_events_changed\"} 收到通知后调用读取接口。通知没有事件序号、正文或确认机制，可以合并、重复或丢失；新连接不会为已有待处理事件发送初始提示，所以建连后应立即补取，并保留周期性 HTTP 轮询。 客户端不发送订阅或确认消息，任何客户端应用数据帧（包括空帧）都会使连接结束；标准 ping\u002Fpong 控制帧由客户端库正常处理。每条连接最长 30 分钟，每个 token 最多 2 条、每个网关实例最多 64 条连接。断流后适当退避重连，继续从持久化 next_after 获取正文；不要因为断流把游标重置为零。\n错误与事件保留\nHTTP 状态处理方式400检查参数格式、游标上限和正文；修正后再请求401检查机器人 PAT 是否失效或过期，更新凭据403检查 scope、当前授权、账号状态及会话或房间资格；不要靠重复请求绕过404源事件或消息不存在，可能已删除或被清理；记录处置后再决定是否跳过429读取响应中的限流信息并退避；若已达到每事件五个回复上限，不再创建新回复键5xx 或网络中断保留游标，退避后重试同一动作；发送结果未知时也沿用原回复键 事件与关联回复幂等记录按事件创建时间保留 90 天，后台分批清理；不以最后回复时间延长。清理不删除聊天消息，也不重置事件序号，但旧事件将不能继续回复。长期离线可能丢失未处理事件，不应依赖从零重放完整聊天历史。 机器人事件与资源 Webhook是不同通道：前者用于机器人消息和指令，后者投递资源发布变化；Webhook 的网站 Cookie 管理接口不接受机器人 PAT。",{"path":100,"title":99,"description":736,"keywords":737,"order":660,"source":661,"content":738},"使用 Atom 阅读器关注教程与资源的公开更新。",[],"使用 Atom 阅读器关注教程与资源的公开更新。\n订阅教程\n在教程列表点击“订阅更新”，将链接添加到支持 Atom 的阅读器： \u002Ftutorials.atom\n\u002Ftutorials.atom?tag=utility&mc=1.20.1 列表订阅沿用现有公开教程列表，按整篇更新时间倒序返回。入口会保留当前标签和游戏版本筛选，不复制页码。默认最近 20 篇，可通过 limit=50 增加条数，最大 50；tag、mc 支持重复参数或英文逗号分隔，匹配语义沿用教程列表。 在单篇教程点击“订阅更新”，可以只关注该教程： \u002Ftutorials\u002Fexample-guide\u002Fupdates.atom 单篇订阅使用教程的稳定 ID，同一教程修改后更新原条目的更新时间、标题和摘要，并提供阅读链接。它提示整篇教程有更新，不提供逐章节更新记录、完整正文或修改对比。章节变更的后端设计不属于本次订阅范围。 两种订阅都匿名读取，只输出当前公开的教程。每次读取复核当前状态后再处理 ETag\u002F304；教程变为不可公开读取时，单篇订阅返回 404。网络故障不表示教程删除，阅读器应保留最后成功结果并退避重试。订阅是有界当前快照，不保证历史追赶或清除阅读器已保存的旧内容。 这些地址使用主站域名，站点应沿用全站 Feed 配置的 NUXT_SITE_URL，以生成正确的绝对链接；缺少该配置时教程 Atom 返回 503。它们属于 Web 站点输出，不增加公共 API 网关操作或机器 scope。\n其它订阅\n全站资源、教程与帖子混合订阅：\u002Fatom.xml；另有 \u002Frss.xml 和 \u002Ffeed.json。单个资源版本更新：\u002Fresources\u002F:slug\u002Freleases.atom，用法见资源更新与 Webhook。",{"path":120,"title":119,"description":740,"keywords":741,"order":660,"source":661,"content":742},"GET \u002Fv1\u002Fsite\u002Fbrowse",[],"GET \u002Fv1\u002Fsite\u002Fbrowse 接口信息接口： GET \u002Fv1\u002Fsite\u002FbrowseoperationId： browseResources参数：query limit",{"path":127,"title":126,"description":744,"keywords":745,"order":660,"source":661,"content":746},"GET \u002Fv1\u002Fsite\u002Fcheck",[],"GET \u002Fv1\u002Fsite\u002Fcheck 接口信息接口： GET \u002Fv1\u002Fsite\u002FcheckoperationId： checkCompatibility每个组合在同一条发布记录内同时满足加载器和游戏版本。参数：query r（必填）",{"path":132,"title":131,"description":748,"keywords":749,"order":660,"source":661,"content":750},"GET \u002Fv1\u002Fsite\u002Fresources\u002Fnames",[],"GET \u002Fv1\u002Fsite\u002Fresources\u002Fnames 接口信息接口： GET \u002Fv1\u002Fsite\u002Fresources\u002FnamesoperationId： findResourceNames使用令牌时所需权限： resource:read:feed参数：query qquery limit",{"path":137,"title":136,"description":752,"keywords":753,"order":660,"source":661,"content":754},"GET \u002Fv1\u002Fsite\u002Fhome",[],"GET \u002Fv1\u002Fsite\u002Fhome 接口信息接口： GET \u002Fv1\u002Fsite\u002FhomeoperationId： getHome参数：query intent：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",{"path":142,"title":141,"description":756,"keywords":757,"order":660,"source":661,"content":758},"GET \u002Fv1\u002Fsite\u002Forganizations\u002F{slug}",[],"GET \u002Fv1\u002Fsite\u002Forganizations\u002F{slug} 接口信息接口： GET \u002Fv1\u002Fsite\u002Forganizations\u002F{slug}operationId： getOrganization返回公开组织资料；已归档组织以 archived 标识只读状态，已解散的公开组织只返回最小墓碑。私有或未公开组织不可通过此接口读取。匿名调用，不接受 Cookie。参数：path slug（必填）：组织的稳定标识。",{"path":147,"title":146,"description":760,"keywords":761,"order":660,"source":661,"content":762},"GET \u002Fv1\u002Fsite\u002Fposts\u002F{id}",[],"GET \u002Fv1\u002Fsite\u002Fposts\u002F{id} 接口信息接口： GET \u002Fv1\u002Fsite\u002Fposts\u002F{id}operationId： getPost使用令牌时所需权限： post:read:feed返回 20 条直接回复，每个节点最多预览 2 个直接子回复；继续阅读通过回复分页接口。replyCount 是全部可见回复数。参数：path id（必填）",{"path":152,"title":151,"description":764,"keywords":765,"order":660,"source":661,"content":766},"GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}",[],"GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug} 接口信息接口： GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}operationId： getResource使用令牌时所需权限： resource:read:feed每个展示族返回最近 20 个完整合并发布单元。allReleases 仅兼容旧参数；继续加载使用发布分页接口。参数：path slug（必填）query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query type：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query tag：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query capability：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query qquery sortquery pagequery limitquery cursorquery recipequery allReleasesquery release",{"path":157,"title":156,"description":768,"keywords":769,"order":660,"source":661,"content":770},"GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002Fmentions",[],"GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002Fmentions 接口信息接口： GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002FmentionsoperationId： getResourceMentions参数：path slug（必填）",{"path":162,"title":161,"description":772,"keywords":773,"order":660,"source":661,"content":774},"GET \u002Fv1\u002Fsite\u002Ftags\u002F{slug}",[],"GET \u002Fv1\u002Fsite\u002Ftags\u002F{slug} 接口信息接口： GET \u002Fv1\u002Fsite\u002Ftags\u002F{slug}operationId： getTag参数：path slug（必填）",{"path":113,"title":111,"description":776,"keywords":777,"order":660,"source":661,"content":778},"无需登录的公开内容与组织查询。",[],"无需登录的公开内容与组织查询。 选择接口查看参数、响应、代码示例并手动发送请求。也可以通过站点搜索查找接口名称、路径或参数。 方法接口路径GET搜索公开内容\u002Fv1\u002Fsite\u002FsearchGET获取公开内容建议\u002Fv1\u002Fsite\u002Fsearch\u002FsuggestGET随机浏览公开资源\u002Fv1\u002Fsite\u002FbrowseGET获取首页内容\u002Fv1\u002Fsite\u002FhomeGET列出能力定义\u002Fv1\u002Fsite\u002FcapabilitiesGET列出内容区块\u002Fv1\u002Fsite\u002FblocksGET列出资源缺口\u002Fv1\u002Fsite\u002FgapsGET检查多资源构建兼容性\u002Fv1\u002Fsite\u002FcheckGET筛选公开资源\u002Fv1\u002Fsite\u002FresourcesGET查找资源名称\u002Fv1\u002Fsite\u002Fresources\u002FnamesGET获取资源详情及匹配发布\u002Fv1\u002Fsite\u002Fresources\u002F{slug}GET继续读取资源发布\u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002FreleasesGET查询当前兼容更新构建\u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002FupdatesGET获取提到资源的帖子\u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002FmentionsGET筛选公开帖子\u002Fv1\u002Fsite\u002FpostsGET获取帖子及递归回复\u002Fv1\u002Fsite\u002Fposts\u002F{id}GET继续读取帖子的直接回复\u002Fv1\u002Fsite\u002Fposts\u002F{id}\u002FrepliesGET查找开放标签\u002Fv1\u002Fsite\u002FtagsGET获取标签聚合页\u002Fv1\u002Fsite\u002Ftags\u002F{slug}GET列出公开组织\u002Fv1\u002Fsite\u002ForganizationsGET读取公开组织详情\u002Fv1\u002Fsite\u002Forganizations\u002F{slug} 完整契约：public.json。",{"path":167,"title":166,"description":780,"keywords":781,"order":660,"source":661,"content":782},"GET \u002Fv1\u002Fsite\u002Fblocks",[],"GET \u002Fv1\u002Fsite\u002Fblocks 接口信息接口： GET \u002Fv1\u002Fsite\u002FblocksoperationId： listBlocks",{"path":172,"title":171,"description":784,"keywords":785,"order":660,"source":661,"content":786},"GET \u002Fv1\u002Fsite\u002Fcapabilities",[],"GET \u002Fv1\u002Fsite\u002Fcapabilities 接口信息接口： GET \u002Fv1\u002Fsite\u002FcapabilitiesoperationId： listCapabilities",{"path":177,"title":176,"description":788,"keywords":789,"order":660,"source":661,"content":790},"GET \u002Fv1\u002Fsite\u002Fgaps",[],"GET \u002Fv1\u002Fsite\u002Fgaps 接口信息接口： GET \u002Fv1\u002Fsite\u002FgapsoperationId： listGaps参数：query limit",{"path":182,"title":181,"description":792,"keywords":793,"order":660,"source":661,"content":794},"GET \u002Fv1\u002Fsite\u002Forganizations",[],"GET \u002Fv1\u002Fsite\u002Forganizations 接口信息接口： GET \u002Fv1\u002Fsite\u002ForganizationsoperationId： listOrganizations只返回已批准、公开且未解散的组织；已归档组织仍可读取，以 archived 标识只读状态。分页与搜索不会返回私有组织或成员关系。匿名调用，不接受 Cookie。参数：query q：按组织名称、标语或 slug 搜索，最多 500 字符。query page：从 1 开始的页码。query pageSize：每页条数，最多 50。",{"path":187,"title":186,"description":796,"keywords":797,"order":660,"source":661,"content":798},"GET \u002Fv1\u002Fsite\u002Fposts",[],"GET \u002Fv1\u002Fsite\u002Fposts 接口信息接口： GET \u002Fv1\u002Fsite\u002FpostsoperationId： listPosts使用令牌时所需权限： post:read:feed参数：query pagequery limitquery sortquery filterquery kind：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query state：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query refquery authorquery unansweredquery qquery tag：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",{"path":192,"title":191,"description":800,"keywords":801,"order":660,"source":661,"content":802},"GET \u002Fv1\u002Fsite\u002Fresources",[],"GET \u002Fv1\u002Fsite\u002Fresources 接口信息接口： GET \u002Fv1\u002Fsite\u002FresourcesoperationId： listResources使用令牌时所需权限： resource:read:feed加载器、游戏版本和类型必须在同一条发布记录同时匹配。同一维度为 OR，跨维度为 AND。参数：query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query type：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query tag：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query capability：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query qquery sortquery pagequery limitquery cursorquery recipe",{"path":197,"title":196,"description":804,"keywords":805,"order":660,"source":661,"content":806},"GET \u002Fv1\u002Fsite\u002Ftags",[],"GET \u002Fv1\u002Fsite\u002Ftags 接口信息接口： GET \u002Fv1\u002Fsite\u002FtagsoperationId： listTags参数：query q",{"path":202,"title":201,"description":808,"keywords":809,"order":660,"source":661,"content":810},"GET \u002Fv1\u002Fsite\u002Fposts\u002F{id}\u002Freplies",[],"GET \u002Fv1\u002Fsite\u002Fposts\u002F{id}\u002Freplies 接口信息接口： GET \u002Fv1\u002Fsite\u002Fposts\u002F{id}\u002FrepliesoperationId： postReplies使用令牌时所需权限： post:read:feedparent 为稳定帖子 ID，默认当前帖子；必须位于当前帖子后代范围。中间节点删除后以空正文墓碑承接公开后代。游标绑定线程版本，内容变化后请刷新。参数：path id（必填）query parentquery limitquery cursor",{"path":207,"title":206,"description":812,"keywords":813,"order":660,"source":661,"content":814},"GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002Freleases",[],"GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002Freleases 接口信息接口： GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002FreleasesoperationId： resourceReleases使用令牌时所需权限： resource:read:feeddisplayGroup 只选择展示组，不参与检索筛选。loader、mc、type 仍在同一条原始发布记录中匹配。游标绑定资源、组、筛选和版本；内容变化后应刷新详情。参数：path slug（必填）query displayGroup（必填）query limitquery cursorquery loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query type：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",{"path":212,"title":211,"description":816,"keywords":817,"order":660,"source":661,"content":818},"GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002Fupdates",[],"GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002Fupdates 接口信息接口： GET \u002Fv1\u002Fsite\u002Fresources\u002F{slug}\u002FupdatesoperationId： resourceUpdates使用令牌时所需权限： resource:read:feed返回当前公开的原始发布记录，按发布时间倒序；loader、mc、type 必须在同一条发布记录同时满足。releaseType 默认 release；多选同维度 OR、跨维度 AND。默认 20、最大 50，hasMore 表示还有更旧构建；这是当前快照，不是历史变化游标。安装前重新复核，撤回和删除先检查可见性再判断 304。参数：path slug（必填）query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query type：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query releaseType：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query limitheader if-none-match",{"path":217,"title":216,"description":820,"keywords":821,"order":660,"source":661,"content":822},"GET \u002Fv1\u002Fsite\u002Fsearch",[],"GET \u002Fv1\u002Fsite\u002Fsearch 接口信息接口： GET \u002Fv1\u002Fsite\u002FsearchoperationId： searchContent加载器、游戏版本和类型必须由同一条发布记录同时满足。参数：query q（必填）query modequery sortquery limitquery cursorquery entity：多值请重复传入同名参数，不支持使用逗号分隔。query tag：多值请重复传入同名参数，不支持使用逗号分隔。query loader：多值请重复传入同名参数，不支持使用逗号分隔。query mc：多值请重复传入同名参数，不支持使用逗号分隔。query type：多值请重复传入同名参数，不支持使用逗号分隔。query capability：多值请重复传入同名参数，不支持使用逗号分隔。",{"path":222,"title":221,"description":824,"keywords":825,"order":660,"source":661,"content":826},"GET \u002Fv1\u002Fsite\u002Fsearch\u002Fsuggest",[],"GET \u002Fv1\u002Fsite\u002Fsearch\u002Fsuggest 接口信息接口： GET \u002Fv1\u002Fsite\u002Fsearch\u002FsuggestoperationId： suggestContent参数：query prefix（必填）query entity：多值请重复传入同名参数，不支持使用逗号分隔。query limit",{"path":234,"title":233,"description":828,"keywords":829,"order":660,"source":661,"content":830},"PUT \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002Fstate",[],"PUT \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002Fstate 接口信息接口： PUT \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002FstateoperationId： changePostState所需权限： post:update:self参数：path id（必填）body state",{"path":241,"title":240,"description":832,"keywords":833,"order":660,"source":661,"content":834},"POST \u002Fv1\u002Fpersonal\u002Forganizations",[],"POST \u002Fv1\u002Fpersonal\u002Forganizations 接口信息接口： POST \u002Fv1\u002Fpersonal\u002ForganizationsoperationId： createOrganization所需权限： organization:create账号须具备发布资格。创建后组织为 approved，创建者成为活跃所有者；slug 留空时由名称生成。需要 organization:create。参数：body namebody slugbody summarybody taglinebody descriptionbody categorybody joinPolicybody visibilitybody avatarbody banner请求体：name 为必填；其他组织资料字段可选。",{"path":248,"title":247,"description":836,"keywords":837,"order":660,"source":661,"content":838},"POST \u002Fv1\u002Fpersonal\u002Fposts",[],"POST \u002Fv1\u002Fpersonal\u002Fposts 接口信息接口： POST \u002Fv1\u002Fpersonal\u002FpostsoperationId： createPost所需权限： post:create参数：body bodybody refbody primaryRefbody tags：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。body referencesbody titlebody needsHelpbody statebody bounty",{"path":253,"title":252,"description":840,"keywords":841,"order":660,"source":661,"content":842},"POST \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Frelease",[],"POST \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Frelease 接口信息接口： POST \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002FreleaseoperationId： createRelease所需权限： resource:update:self一条发布记录的加载器与游戏版本为联合约束；需要精确配对时提交多个 compat 项。参数：path slug（必填）body versionNumberbody releaseTypebody environmentbody statusbody publishedAtbody namebody changelogbody installNotebody referencesbody compatbody filesbody filebody loadersbody mcVersions",{"path":258,"title":257,"description":844,"keywords":845,"order":660,"source":661,"content":846},"POST \u002Fv1\u002Fpersonal\u002Fresources",[],"POST \u002Fv1\u002Fpersonal\u002Fresources 接口信息接口： POST \u002Fv1\u002Fpersonal\u002FresourcesoperationId： createResource所需权限： resource:create参数：body titlebody summarybody bodybody slugbody coverUrlbody capabilitiesbody tags：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。body referencesbody status",{"path":263,"title":262,"description":848,"keywords":849,"order":660,"source":661,"content":850},"DELETE \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}",[],"DELETE \u002Fv1\u002Fpersonal\u002Fposts\u002F{id} 接口信息接口： DELETE \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}operationId： deletePost所需权限： post:delete:self参数：path id（必填）",{"path":270,"title":269,"description":852,"keywords":853,"order":660,"source":661,"content":854},"DELETE \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}",[],"DELETE \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug} 接口信息接口： DELETE \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}operationId： deleteResource所需权限： resource:delete:self参数：path slug（必填）",{"path":275,"title":274,"description":856,"keywords":857,"order":660,"source":661,"content":858},"GET \u002Fv1\u002Fpersonal\u002Fme",[],"GET \u002Fv1\u002Fpersonal\u002Fme 接口信息接口： GET \u002Fv1\u002Fpersonal\u002FmeoperationId： getMe所需权限： user:read:self仅返回本人展示资料，不包含邮箱、手机或安全设置。需要 user:read:self。",{"path":228,"title":226,"description":860,"keywords":861,"order":660,"source":661,"content":862},"使用个人令牌或具有相同 scope 的 OAuth access token 访问本人资料、内容与组织。",[],"使用个人令牌或具有相同 scope 的 OAuth access token 访问本人资料、内容与组织。 选择接口查看参数、响应、代码示例并手动发送请求。也可以通过站点搜索查找接口名称、路径或参数。 方法接口路径GET筛选公开资源\u002Fv1\u002Fpersonal\u002FresourcesPOST创建资源\u002Fv1\u002Fpersonal\u002FresourcesGET查找资源名称\u002Fv1\u002Fpersonal\u002Fresources\u002FnamesGET获取资源详情及匹配发布\u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}PATCH修改本人维护的资源\u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}DELETE删除本人维护的资源\u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}GET继续读取资源发布\u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002FreleasesGET查询当前兼容更新构建\u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002FupdatesGET筛选公开帖子\u002Fv1\u002Fpersonal\u002FpostsPOST创建帖子\u002Fv1\u002Fpersonal\u002FpostsGET获取帖子及递归回复\u002Fv1\u002Fpersonal\u002Fposts\u002F{id}PATCH修改本人帖子\u002Fv1\u002Fpersonal\u002Fposts\u002F{id}DELETE删除本人帖子\u002Fv1\u002Fpersonal\u002Fposts\u002F{id}GET继续读取帖子的直接回复\u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002FrepliesGET读取本人的资源\u002Fv1\u002Fpersonal\u002Fusers\u002F{id}\u002FresourcesPOST创建联合兼容发布记录\u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002FreleasePATCH修改本人维护的发布记录\u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Freleases\u002F{id}GET读取本人的帖子\u002Fv1\u002Fpersonal\u002Fusers\u002F{id}\u002FpostsPOST回复帖子\u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002FreplyPUT修改 Issue 状态\u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002FstateGET读取本人展示资料\u002Fv1\u002Fpersonal\u002FmeGET列出本人组织\u002Fv1\u002Fpersonal\u002ForganizationsPOST创建组织\u002Fv1\u002Fpersonal\u002ForganizationsGET读取本人可见的组织\u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}PUT编辑组织资料\u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug} 完整契约：personal.json。",{"path":280,"title":279,"description":864,"keywords":865,"order":660,"source":661,"content":866},"GET \u002Fv1\u002Fpersonal\u002Fusers\u002F{id}\u002Fposts",[],"GET \u002Fv1\u002Fpersonal\u002Fusers\u002F{id}\u002Fposts 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Fusers\u002F{id}\u002FpostsoperationId： listOwnPosts所需权限： post:read:self路径 id 仅允许本人用户 ID 或 handle。参数：path id（必填）query pagequery limit",{"path":285,"title":284,"description":868,"keywords":869,"order":660,"source":661,"content":870},"GET \u002Fv1\u002Fpersonal\u002Fusers\u002F{id}\u002Fresources",[],"GET \u002Fv1\u002Fpersonal\u002Fusers\u002F{id}\u002Fresources 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Fusers\u002F{id}\u002FresourcesoperationId： listOwnResources所需权限： resource:read:self路径 id 仅允许本人用户 ID 或 handle。参数：path id（必填）query pagequery limit",{"path":289,"title":131,"description":872,"keywords":873,"order":660,"source":661,"content":874},"GET \u002Fv1\u002Fpersonal\u002Fresources\u002Fnames",[],"GET \u002Fv1\u002Fpersonal\u002Fresources\u002Fnames 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Fresources\u002FnamesoperationId： personalFindResourceNames所需权限： resource:read:feed参数：query qquery limit",{"path":294,"title":293,"description":876,"keywords":877,"order":660,"source":661,"content":878},"GET \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}",[],"GET \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug} 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}operationId： personalGetOrganization所需权限： organization:read:self只读取本人拥有或作为活跃成员加入的组织。已归档组织以 archived 标识只读状态；已解散组织仅返回最小墓碑。需要 organization:read:self。参数：path slug（必填）：组织的稳定标识。",{"path":298,"title":146,"description":880,"keywords":881,"order":660,"source":661,"content":882},"GET \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}",[],"GET \u002Fv1\u002Fpersonal\u002Fposts\u002F{id} 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}operationId： personalGetPost所需权限： post:read:feed返回 20 条直接回复，每个节点最多预览 2 个直接子回复；继续阅读通过回复分页接口。replyCount 是全部可见回复数。参数：path id（必填）",{"path":302,"title":151,"description":884,"keywords":885,"order":660,"source":661,"content":886},"GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}",[],"GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug} 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}operationId： personalGetResource所需权限： resource:read:feed每个展示族返回最近 20 个完整合并发布单元。allReleases 仅兼容旧参数；继续加载使用发布分页接口。参数：path slug（必填）query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query type：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query tag：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query capability：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query qquery sortquery pagequery limitquery cursorquery recipequery allReleasesquery release",{"path":307,"title":306,"description":888,"keywords":889,"order":660,"source":661,"content":890},"GET \u002Fv1\u002Fpersonal\u002Forganizations",[],"GET \u002Fv1\u002Fpersonal\u002Forganizations 接口信息接口： GET \u002Fv1\u002Fpersonal\u002ForganizationsoperationId： personalListOrganizations所需权限： organization:read:self分页返回本人拥有或作为活跃成员加入的组织。已归档组织以 archived 标识只读状态；已解散组织仅返回最小墓碑。需要 organization:read:self。参数：query page：从 1 开始的页码。query pageSize：每页条数，最多 50。",{"path":311,"title":186,"description":892,"keywords":893,"order":660,"source":661,"content":894},"GET \u002Fv1\u002Fpersonal\u002Fposts",[],"GET \u002Fv1\u002Fpersonal\u002Fposts 接口信息接口： GET \u002Fv1\u002Fpersonal\u002FpostsoperationId： personalListPosts所需权限： post:read:feed参数：query pagequery limitquery sortquery filterquery kind：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query state：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query refquery authorquery unansweredquery qquery tag：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",{"path":315,"title":191,"description":896,"keywords":897,"order":660,"source":661,"content":898},"GET \u002Fv1\u002Fpersonal\u002Fresources",[],"GET \u002Fv1\u002Fpersonal\u002Fresources 接口信息接口： GET \u002Fv1\u002Fpersonal\u002FresourcesoperationId： personalListResources所需权限： resource:read:feed加载器、游戏版本和类型必须在同一条发布记录同时匹配。同一维度为 OR，跨维度为 AND。参数：query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query type：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query tag：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query capability：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query qquery sortquery pagequery limitquery cursorquery recipe",{"path":319,"title":201,"description":900,"keywords":901,"order":660,"source":661,"content":902},"GET \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002Freplies",[],"GET \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002Freplies 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002FrepliesoperationId： personalPostReplies所需权限： post:read:feedparent 为稳定帖子 ID，默认当前帖子；必须位于当前帖子后代范围。中间节点删除后以空正文墓碑承接公开后代。游标绑定线程版本，内容变化后请刷新。参数：path id（必填）query parentquery limitquery cursor",{"path":323,"title":206,"description":904,"keywords":905,"order":660,"source":661,"content":906},"GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Freleases",[],"GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Freleases 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002FreleasesoperationId： personalResourceReleases所需权限： resource:read:feeddisplayGroup 只选择展示组，不参与检索筛选。loader、mc、type 仍在同一条原始发布记录中匹配。游标绑定资源、组、筛选和版本；内容变化后应刷新详情。参数：path slug（必填）query displayGroup（必填）query limitquery cursorquery loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query type：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",{"path":327,"title":211,"description":908,"keywords":909,"order":660,"source":661,"content":910},"GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Fupdates",[],"GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Fupdates 接口信息接口： GET \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002FupdatesoperationId： personalResourceUpdates所需权限： resource:read:feed返回当前公开的原始发布记录，按发布时间倒序；loader、mc、type 必须在同一条发布记录同时满足。releaseType 默认 release；多选同维度 OR、跨维度 AND。默认 20、最大 50，hasMore 表示还有更旧构建；这是当前快照，不是历史变化游标。安装前重新复核，撤回和删除先检查可见性再判断 304。参数：path slug（必填）query loader：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query mc：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query type：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query releaseType：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。query limitheader if-none-match",{"path":332,"title":331,"description":912,"keywords":913,"order":660,"source":661,"content":914},"POST \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002Freply",[],"POST \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002Freply 接口信息接口： POST \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}\u002FreplyoperationId： replyPost所需权限： post:create回复不能建立独立 Issue 或悬赏。参数：path id（必填）body bodybody tags：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。body referencesbody title",{"path":337,"title":336,"description":916,"keywords":917,"order":660,"source":661,"content":918},"PUT \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}",[],"PUT \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug} 接口信息接口： PUT \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}operationId： updateOrganization所需权限： organization:update:self仅活跃所有者可编辑未归档、未解散的 approved 组织；archived 组织只读，不能通过此接口编辑或恢复。提交当前正整数 version；资料变化后版本递增，旧版本返回 409。需要 organization:update:self。参数：path slug（必填）：组织的稳定标识。body versionbody namebody summarybody taglinebody descriptionbody categorybody joinPolicybody visibilitybody avatarbody banner请求体：version 为必填的当前组织版本；其余字段至少提供一项。",{"path":342,"title":341,"description":920,"keywords":921,"order":660,"source":661,"content":922},"PATCH \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}",[],"PATCH \u002Fv1\u002Fpersonal\u002Fposts\u002F{id} 接口信息接口： PATCH \u002Fv1\u002Fpersonal\u002Fposts\u002F{id}operationId： updatePost所需权限： post:update:self参数：path id（必填）body titlebody body",{"path":348,"title":347,"description":924,"keywords":925,"order":660,"source":661,"content":926},"PATCH \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Freleases\u002F{id}",[],"PATCH \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Freleases\u002F{id} 接口信息接口： PATCH \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}\u002Freleases\u002F{id}operationId： updateRelease所需权限： resource:update:self参数：path slug（必填）path id（必填）body namebody changelogbody installNotebody statusbody publishedAt",{"path":353,"title":352,"description":928,"keywords":929,"order":660,"source":661,"content":930},"PATCH \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}",[],"PATCH \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug} 接口信息接口： PATCH \u002Fv1\u002Fpersonal\u002Fresources\u002F{slug}operationId： updateResource所需权限： resource:update:self参数：path slug（必填）body titlebody summarybody bodybody capabilitiesbody tags：多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。body referencesbody status",{"path":365,"title":364,"description":932,"keywords":933,"order":660,"source":661,"content":934},"GET \u002Fv1\u002Foauth2\u002Fauthorize",[],"GET \u002Fv1\u002Foauth2\u002Fauthorize 接口信息接口： GET \u002Fv1\u002Foauth2\u002FauthorizeoperationId： authorizeOAuthConfidential client；仅接受 response_type=code 和 S256 PKCE。成功时 302 重定向至本站授权页，失败返回 OAuth {error}。参数：query response_type（必填）query client_id（必填）query redirect_uri（必填）query scope（必填）query statequery code_challenge（必填）query code_challenge_method（必填）",{"path":370,"title":369,"description":936,"keywords":937,"order":660,"source":661,"content":938},"POST \u002Fv1\u002Foauth2\u002Ftoken",[],"POST \u002Fv1\u002Foauth2\u002Ftoken 接口信息接口： POST \u002Fv1\u002Foauth2\u002FtokenoperationId： exchangeOAuthTokenConfidential client 使用 HTTP Basic 或请求体 client_id\u002Fclient_secret，二者不可同时使用；不接受 Cookie。body 支持 form-urlencoded 或全字符串 JSON，最大 16KiB，重复字段拒绝。授权码交换必须提交 S256 code_verifier；刷新令牌轮换，重放撤销整族。 绑定机器人的审核应用可使用 client_credentials 申请短期机器人 access token；该 grant 不签发 refresh token。参数：body client_idbody client_secretbody grant_typebody codebody redirect_uribody code_verifierbody refresh_tokenbody scope",{"path":375,"title":374,"description":940,"keywords":941,"order":660,"source":661,"content":942},"GET \u002Fv1\u002Foauth2\u002Fuserinfo",[],"GET \u002Fv1\u002Foauth2\u002Fuserinfo 接口信息接口： GET \u002Fv1\u002Foauth2\u002FuserinfooperationId： getOAuthUserinfo仅接受 OAuth access token；sub 始终返回，profile:read 与 email:read 各控制对应字段。",{"path":359,"title":357,"description":944,"keywords":945,"order":660,"source":661,"content":946},"接入 OAuth 授权、令牌交换、撤销和用户信息。",[],"接入 OAuth 授权、令牌交换、撤销和用户信息。 选择接口查看参数、响应、代码示例并手动发送请求。也可以通过站点搜索查找接口名称、路径或参数。 方法接口路径GET列出可申请的 OAuth scope\u002Fv1\u002Foauth2\u002FscopesGET发起授权码流程\u002Fv1\u002Foauth2\u002FauthorizePOST交换、刷新令牌或签发机器人令牌\u002Fv1\u002Foauth2\u002FtokenPOST撤销访问或刷新令牌\u002Fv1\u002Foauth2\u002FrevokeGET读取授权用户信息\u002Fv1\u002Foauth2\u002Fuserinfo 完整契约：oauth.json。",{"path":380,"title":379,"description":948,"keywords":949,"order":660,"source":661,"content":950},"GET \u002Fv1\u002Foauth2\u002Fscopes",[],"GET \u002Fv1\u002Foauth2\u002Fscopes 接口信息接口： GET \u002Fv1\u002Foauth2\u002FscopesoperationId： listOAuthScopes",{"path":385,"title":384,"description":952,"keywords":953,"order":660,"source":661,"content":954},"POST \u002Fv1\u002Foauth2\u002Frevoke",[],"POST \u002Fv1\u002Foauth2\u002Frevoke 接口信息接口： POST \u002Fv1\u002Foauth2\u002FrevokeoperationId： revokeOAuthTokenConfidential client 使用 Basic 或 body 凭据；未知令牌也返回空对象。参数：body client_idbody client_secretbody tokenbody token_type_hint",{"path":390,"title":389,"description":956,"keywords":957,"order":660,"source":661,"content":958},"查询资源列表、详情和当前构建；匿名或可选 Bearer，不接受 Cookie。",[],"查询资源列表、详情和当前构建；匿名或可选 Bearer，不接受 Cookie。 选择接口查看参数、响应、代码示例并手动发送请求。也可以通过站点搜索查找接口名称、路径或参数。 方法接口路径GET筛选公开资源\u002Fv1\u002FresourcesHEAD筛选公开资源（HEAD）\u002Fv1\u002FresourcesGET读取公开资源详情\u002Fv1\u002Fresources\u002F{slug}HEAD读取公开资源详情（HEAD）\u002Fv1\u002Fresources\u002F{slug}GET读取当前兼容更新构建\u002Fv1\u002Fresources\u002F{slug}\u002FupdatesHEAD读取当前兼容更新构建（HEAD）\u002Fv1\u002Fresources\u002F{slug}\u002Fupdates 完整契约：public-v1.json。",{"path":396,"title":395,"description":960,"keywords":961,"order":660,"source":661,"content":962},"GET \u002Fv1\u002Fresources\u002F{slug}",[],"GET \u002Fv1\u002Fresources\u002F{slug} 接口信息接口： GET \u002Fv1\u002Fresources\u002F{slug}operationId： publicV1GetResource使用令牌时所需权限： resource:read:feed返回稳定资源投影，不嵌入发布历史。构建选择请使用 updates；其兼容性仍在同一原始发布记录上判断。参数：path slug（必填）：小写 ASCII 字母数字及单连字符，长度 1–100。query loader：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query mc：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query type：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。",{"path":401,"title":400,"description":964,"keywords":965,"order":660,"source":661,"content":966},"HEAD \u002Fv1\u002Fresources\u002F{slug}",[],"HEAD \u002Fv1\u002Fresources\u002F{slug} 接口信息接口： HEAD \u002Fv1\u002Fresources\u002F{slug}operationId： publicV1HeadGetResource使用令牌时所需权限： resource:read:feed返回稳定资源投影，不嵌入发布历史。构建选择请使用 updates；其兼容性仍在同一原始发布记录上判断。 HEAD 执行相同参数、认证与可见性检查，只返回状态和响应头。参数：path slug（必填）：小写 ASCII 字母数字及单连字符，长度 1–100。query loader：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query mc：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query type：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。",{"path":408,"title":407,"description":968,"keywords":969,"order":660,"source":661,"content":970},"HEAD \u002Fv1\u002Fresources",[],"HEAD \u002Fv1\u002Fresources 接口信息接口： HEAD \u002Fv1\u002FresourcesoperationId： publicV1HeadListResources使用令牌时所需权限： resource:read:feed列表、计数与筛选读取同一快照。loader、mc、type 必须在同一原始发布记录上同时满足；同维度 OR、跨维度 AND。 HEAD 执行相同参数、认证与可见性检查，只返回状态和响应头。参数：query loader：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query mc：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query type：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query tag：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query capability：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query q：关键字最多 200 个 UTF-16 单元（补充平面字符占两个单元）。 单值参数，重复同名键返回 400。query sort：排序方式。 单值参数，重复同名键返回 400。query page：页码；使用 cursor 时只能为 1。 单值参数，重复同名键返回 400。query limit：每次读取的最大条数。 单值参数，重复同名键返回 400。query cursor：不透明签名游标，仅允许 sort=updated 且 page=1；继续分页时保持其它筛选一致。格式、签名、版本或范围错误返回 400\u002FINVALID_INPUT；列表快照过期返回 409\u002FCURSOR_STALE。 单值参数，重复同名键返回 400。",{"path":413,"title":412,"description":972,"keywords":973,"order":660,"source":661,"content":974},"HEAD \u002Fv1\u002Fresources\u002F{slug}\u002Fupdates",[],"HEAD \u002Fv1\u002Fresources\u002F{slug}\u002Fupdates 接口信息接口： HEAD \u002Fv1\u002Fresources\u002F{slug}\u002FupdatesoperationId： publicV1HeadResourceUpdates使用令牌时所需权限： resource:read:feed当前公开原始发布快照，默认稳定渠道，按发布时间倒序。相同文件和版本号也不合并兼容配对。无历史游标，hasMore 表示还有更旧构建；安装前再次复核。 HEAD 执行相同参数、认证与可见性检查，只返回状态和响应头。参数：path slug（必填）：小写 ASCII 字母数字及单连字符，长度 1–100。query loader：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query mc：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query type：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query releaseType：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query limit：每次读取的最大条数。 单值参数，重复同名键返回 400。header If-None-Match：支持单个或逗号分隔的 ETag、弱标签以及 。公开 ETag 绑定 PUBLIC_API_SITE_ORIGIN；网关只将当前 origin 的有效公开标签解包后传给 Node，Node 每次仍执行用户认证与资源可见性门禁。未知标签或旧 origin 标签作为不匹配处理，返回 200； 保留正常存在性语义，也须经过同样门禁。不能在网关仅凭旧缓存返回 304。",{"path":417,"title":191,"description":976,"keywords":977,"order":660,"source":661,"content":978},"GET \u002Fv1\u002Fresources",[],"GET \u002Fv1\u002Fresources 接口信息接口： GET \u002Fv1\u002FresourcesoperationId： publicV1ListResources使用令牌时所需权限： resource:read:feed列表、计数与筛选读取同一快照。loader、mc、type 必须在同一原始发布记录上同时满足；同维度 OR、跨维度 AND。参数：query loader：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query mc：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query type：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query tag：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query capability：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query q：关键字最多 200 个 UTF-16 单元（补充平面字符占两个单元）。 单值参数，重复同名键返回 400。query sort：排序方式。 单值参数，重复同名键返回 400。query page：页码；使用 cursor 时只能为 1。 单值参数，重复同名键返回 400。query limit：每次读取的最大条数。 单值参数，重复同名键返回 400。query cursor：不透明签名游标，仅允许 sort=updated 且 page=1；继续分页时保持其它筛选一致。格式、签名、版本或范围错误返回 400\u002FINVALID_INPUT；列表快照过期返回 409\u002FCURSOR_STALE。 单值参数，重复同名键返回 400。",{"path":422,"title":421,"description":980,"keywords":981,"order":660,"source":661,"content":982},"GET \u002Fv1\u002Fresources\u002F{slug}\u002Fupdates",[],"GET \u002Fv1\u002Fresources\u002F{slug}\u002Fupdates 接口信息接口： GET \u002Fv1\u002Fresources\u002F{slug}\u002FupdatesoperationId： publicV1ResourceUpdates使用令牌时所需权限： resource:read:feed当前公开原始发布快照，默认稳定渠道，按发布时间倒序。相同文件和版本号也不合并兼容配对。无历史游标，hasMore 表示还有更旧构建；安装前再次复核。参数：path slug（必填）：小写 ASCII 字母数字及单连字符，长度 1–100。query loader：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query mc：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query type：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query releaseType：可重复同名参数，也可用逗号分隔；同维度为 OR，跨维度为 AND。每维最多 64 个非空值，每值最多 128 个字符；在 trim 去除首尾空白前拒绝 C0\u002FDEL 控制字符。query limit：每次读取的最大条数。 单值参数，重复同名键返回 400。header If-None-Match：支持单个或逗号分隔的 ETag、弱标签以及 。公开 ETag 绑定 PUBLIC_API_SITE_ORIGIN；网关只将当前 origin 的有效公开标签解包后传给 Node，Node 每次仍执行用户认证与资源可见性门禁。未知标签或旧 origin 标签作为不匹配处理，返回 200； 保留正常存在性语义，也须经过同样门禁。不能在网关仅凭旧缓存返回 304。",{"path":435,"title":434,"description":984,"keywords":985,"order":660,"source":661,"content":986},"POST \u002Fapi\u002Fwebhooks\u002Fendpoints",[],"POST \u002Fapi\u002Fwebhooks\u002Fendpoints 接口信息接口： POST \u002Fapi\u002Fwebhooks\u002FendpointsoperationId： createWebhookEndpoint必须绑定本人已经审核通过且启用的 OAuth 或机器人应用。创建后端点处于 pending 且禁用，平台审核通过后才启用。出站事件仍由独立 signingSecret 进行 HMAC-SHA256 签名；不发送 OAuth client secret。参数：body name：去首尾空格后校验长度。body url：公网域名 HTTPS\u002F443；禁止凭据、片段、IP literal、非公网 DNS 和重定向。每次投递重新验证 DNS 并固定实际连接目标。body clientId：必填；本人已经审核通过且启用的 OAuth 或机器人应用 ID。Webhook 创建后进入待审并保持禁用，审核仅在创建时进行。",{"path":440,"title":439,"description":988,"keywords":989,"order":660,"source":661,"content":990},"POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fsubscriptions",[],"POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fsubscriptions 接口信息接口： POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002FsubscriptionsoperationId： createWebhookSubscription要求 Cookie、CSRF、owner 与 api-token 强验证。已审核端点必须启用，目标当前公开；资源与知识库合计最多 100 个订阅。省略 targetKind 保留资源协议：维度内 OR、跨维度 AND，加载器和版本匹配同一物理发布。知识库独立流不接受发布筛选。新订阅从锁定的当前序号之后开始；改地址、轮换密钥、停用\u002F启用及应用撤权均取消旧任务并推进两种订阅边界。参数：path id（必填）body targetKindbody resourceSlugbody eventsbody loadersbody mcVersionsbody releaseTypesbody knowledgeBaseSlug",{"path":445,"title":444,"description":992,"keywords":993,"order":660,"source":661,"content":994},"DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}",[],"DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id} 接口信息接口： DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}operationId： deleteWebhookEndpoint只接受当前网站 Cookie 会话；须为 owner，并持有匹配 Cookie 的 x-csrf-token 及当前会话用途 api-token 的二次验证（300 秒）。Origin\u002FFetch Metadata 和锁后期限复核仍生效。PAT\u002FOAuth access 不可调用。参数：path id（必填）",{"path":450,"title":449,"description":996,"keywords":997,"order":660,"source":661,"content":998},"DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fsubscriptions\u002F{subscriptionId}",[],"DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fsubscriptions\u002F{subscriptionId} 接口信息接口： DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fsubscriptions\u002F{subscriptionId}operationId： deleteWebhookSubscription只接受当前网站 Cookie 会话；须为 owner，并持有匹配 Cookie 的 x-csrf-token 及当前会话用途 api-token 的二次验证（300 秒）。Origin\u002FFetch Metadata 和锁后期限复核仍生效。PAT\u002FOAuth access 不可调用。参数：path id（必填）path subscriptionId（必填）",{"path":429,"title":427,"description":1000,"keywords":1001,"order":660,"source":661,"content":1002},"网站 Cookie 管理接口与资源发布事件；写操作还需要 CSRF 和二次验证。",[],"网站 Cookie 管理接口与资源发布事件；写操作还需要 CSRF 和二次验证。 选择接口查看参数、响应、代码示例并手动发送请求。也可以通过站点搜索查找接口名称、路径或参数。 方法接口路径GET列出我的 Webhook 端点\u002Fapi\u002Fwebhooks\u002FendpointsPOST申请创建 Webhook 端点\u002Fapi\u002Fwebhooks\u002FendpointsPATCH修改 Webhook 端点\u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}DELETE删除 Webhook 端点\u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}POST轮换 Webhook 签名密钥\u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Frotate-secretGET列出端点订阅\u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002FsubscriptionsPOST订阅资源发布或知识库更新\u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002FsubscriptionsDELETE删除资源订阅\u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fsubscriptions\u002F{subscriptionId}GET查看投递记录\u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002FdeliveriesPOST重试当前版本的失败投递\u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fdeliveries\u002F{deliveryId}\u002Fretry 完整契约：webhooks.json。",{"path":455,"title":454,"description":1004,"keywords":1005,"order":660,"source":661,"content":1006},"GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fdeliveries",[],"GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fdeliveries 接口信息接口： GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002FdeliveriesoperationId： listWebhookDeliveries只接受当前网站 Cookie 会话并检查 owner。PAT\u002FOAuth access 不可调用。参数：path id（必填）query limitquery cursor：原样传回上页 nextCursor，不解析或构造。",{"path":460,"title":459,"description":1008,"keywords":1009,"order":660,"source":661,"content":1010},"GET \u002Fapi\u002Fwebhooks\u002Fendpoints",[],"GET \u002Fapi\u002Fwebhooks\u002Fendpoints 接口信息接口： GET \u002Fapi\u002Fwebhooks\u002FendpointsoperationId： listWebhookEndpoints只接受当前网站 Cookie 会话并检查 owner。PAT\u002FOAuth access 不可调用。",{"path":465,"title":464,"description":1012,"keywords":1013,"order":660,"source":661,"content":1014},"GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fsubscriptions",[],"GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fsubscriptions 接口信息接口： GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002FsubscriptionsoperationId： listWebhookSubscriptions只接受当前网站 Cookie 会话并检查 owner。PAT\u002FOAuth access 不可调用。参数：path id（必填）",{"path":470,"title":469,"description":1016,"keywords":1017,"order":660,"source":661,"content":1018},"POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fdeliveries\u002F{deliveryId}\u002Fretry",[],"POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fdeliveries\u002F{deliveryId}\u002Fretry 接口信息接口： POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Fdeliveries\u002F{deliveryId}\u002FretryoperationId： retryWebhookDelivery要求 Cookie、CSRF、owner 与 api-token 强验证。仅当前端点版本的 failed 可重置为 pending；端点\u002F应用\u002F订阅及普通事件的当前公开代次均须有效。成功表示重置待发送，不表示接收端已接收。参数：path id（必填）path deliveryId（必填）",{"path":475,"title":474,"description":1020,"keywords":1021,"order":660,"source":661,"content":1022},"POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Frotate-secret",[],"POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Frotate-secret 接口信息接口： POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}\u002Frotate-secretoperationId： rotateWebhookSecret要求 Cookie、CSRF、owner 与 api-token 强验证。轮换立即推进版本并取消旧代未完成投递，没有双密钥重叠期；新 signingSecret 只显示一次。参数：path id（必填）",{"path":480,"title":479,"description":1024,"keywords":1025,"order":660,"source":661,"content":1026},"PATCH \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}",[],"PATCH \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id} 接口信息接口： PATCH \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F{id}operationId： updateWebhookEndpoint只接受当前网站 Cookie 会话；须为 owner，并持有匹配 Cookie 的 x-csrf-token 及当前会话用途 api-token 的二次验证（300 秒）。Origin\u002FFetch Metadata 和锁后期限复核仍生效。PAT\u002FOAuth access 不可调用。参数：path id（必填）body name：去首尾空格后校验长度。body url：公网域名 HTTPS\u002F443；禁止凭据、片段、IP literal、非公网 DNS 和重定向。每次投递重新验证 DNS 并固定实际连接目标。body enabled",{"path":485,"title":484,"description":1028,"keywords":1029,"order":660,"source":661,"content":1030},"机器人令牌读取事件并幂等回复；实时变更提示通过独立 WebSocket 连接。",[],"机器人令牌读取事件并幂等回复；实时变更提示通过独立 WebSocket 连接。 首次接入请阅读机器人事件接入指南，查看事件字段、消费与回复示例和断线恢复方式。 选择接口查看参数、响应、代码示例并手动发送请求。也可以通过站点搜索查找接口名称、路径或参数。 方法接口路径GET读取机器人事件\u002Fv1\u002Fbots\u002Fme\u002FeventsPOST回复机器人事件\u002Fv1\u002Fbots\u002Fme\u002Freplies\nWebSocket 事件变更提示\n握手路径： GET \u002Fv1\u002Fbots\u002Fme\u002Fevents\u002Fstream 握手认证： Bot PAT or OAuth access token in Authorization Bearer header only; OAuth tokens must come from a reviewed bot application with an active bot permission grant and are always bound to the bot user; no Cookie or query token 连接只发送事件变化提示，不包含事件正文。连接后、重连后及运行期间，仍应通过 HTTP 事件接口按已保存的游标补取。 服务端通知示例： {\n  \"event\": \"bot_events_changed\"\n} 连接限制当前值每个令牌最多连接数2单实例最多连接数64单条连接最长持续时间1800 秒 完整契约：bots.json。",{"path":491,"title":490,"description":1032,"keywords":1033,"order":660,"source":661,"content":1034},"GET \u002Fv1\u002Fbots\u002Fme\u002Fevents",[],"GET \u002Fv1\u002Fbots\u002Fme\u002Fevents 接口信息接口： GET \u002Fv1\u002Fbots\u002Fme\u002FeventsoperationId： listBotEvents所需权限： bot:events:read使用机器人自身 Bot PAT 或经审核机器人 OAuth 应用签发的 OAuth access token，按十进制游标读取当前仍有权限查看的私信和房间指令事件，每页最多 50 条；断线后可用 next_after 补取。OAuth 应用审核和 bot 权限 grant 均必须有效；令牌主体始终是绑定的 bot user。事件保留 90 天，清理不重置序号；无新事件时 next_after 不小于请求的 after。参数：query afterquery limit",{"path":496,"title":495,"description":1036,"keywords":1037,"order":660,"source":661,"content":1038},"POST \u002Fv1\u002Fbots\u002Fme\u002Freplies",[],"POST \u002Fv1\u002Fbots\u002Fme\u002Freplies 接口信息接口： POST \u002Fv1\u002Fbots\u002Fme\u002FrepliesoperationId： replyBotEvent所需权限： bot:events:read使用机器人自身 Bot PAT 或经审核机器人 OAuth 应用签发的 OAuth access token 回复当前可见且获准响应的事件；OAuth 应用审核和 bot 权限 grant 均必须有效，令牌主体始终是绑定的 bot user。同一机器人、event_id 与 action_key 以首次提交为准，即使重试的 content 不同也返回原 message_id（duplicate=true），不修改或重复发送。发送新内容须使用新的 action_key。参数：body event_idbody action_keybody content",{"path":105,"title":103,"description":1040,"keywords":1041,"order":660,"source":661,"content":1042},"浏览公开内容、个人接口、机器人事件、OAuth、资源查询与 Webhook 接口。",[],"浏览公开内容、个人接口、机器人事件、OAuth、资源查询与 Webhook 接口。 每个接口都有独立页面，可直接复制地址分享。接口与指南共用左侧目录和站点搜索；搜索接口名称、路径或参数即可定位。 接口组适用场景契约文件公开内容无需登录的内容与组织查询public.json个人 API使用 PAT 或获授权的 OAuth access 访问自己的内容、资料与组织personal.json开放平台授权、token、撤销与 userinfooauth.jsonWebhook网站会话管理和资源发布事件webhooks.json机器人事件机器人令牌读取触发事件并幂等回复bots.json精简资源查询资源列表、详情与更新构建public-v1.json 接口页面提供参数、响应与 Fetch\u002Fcurl 示例。需要验证请求时，在页面中手动打开请求工具并填写自己的凭据；文档站不保存凭据，也不代理请求。 Webhook 管理页提供网站同源 Fetch 和 curl Cookie 示例；由于管理会话只属于网站，该组不在跨域文档站直接发送请求。写操作先在网站完成二次验证，并提供匹配的 CSRF。 v1 的公开查询、个人 API、OAuth 和机器人事件接口分别使用 \u002Fv1\u002Fsite、\u002Fv1\u002Fpersonal、\u002Fv1\u002Foauth2、\u002Fv1\u002Fbots；另有三条精简资源只读路径 \u002Fv1\u002Fresources。公开组织查询匿名可用；个人资料和组织操作逐接口要求相应 scope。个人 API 不使用网站 Cookie；机器人事件只接受机器人 PAT。OAuth 授权端点的可选会话行为以其接口页为准。接入步骤见公共 API v1 指南与机器人接入指南。 Webhook 管理继续使用网站同源 \u002Fapi\u002Fwebhooks，写操作需要 Cookie、CSRF 和二次验证；跨域文档站不读取 HttpOnly Cookie。",[1044,1047,1052,1057,1062,1065,1070,1075,1080,1083,1088,1093,1098,1103,1108,1113,1116,1121,1126,1131,1134,1139,1144,1149,1152,1157,1162,1167,1172,1175,1180,1185,1190,1193,1198,1203,1208,1211,1216,1221,1226,1229,1234,1239,1244,1247,1252,1257,1262,1265,1270,1275,1280,1283,1288,1293,1298,1301,1306,1311,1316,1321,1326,1331,1336,1339,1344,1349,1354,1359,1364,1369,1372,1377,1382,1387,1392,1397,1402,1407,1412,1417,1421,1424,1429,1434,1439,1444,1449,1452,1457,1462,1467,1472,1477,1482,1487,1492,1497,1502,1507,1512,1517,1520,1525,1530,1535,1540,1545,1550,1555,1560,1565,1568,1573,1578,1583,1588,1593,1598,1601,1606,1611,1616,1621,1626,1629,1634,1639,1644,1649,1654,1659,1662,1666,1671,1676,1681,1686,1691,1693,1695,1697,1699,1701,1704,1709,1714,1719,1724,1729,1734,1739,1744,1747,1751,1756,1761,1766,1771,1774,1779,1784,1789,1792,1797,1802,1807,1812,1817,1822,1827,1829,1834,1839,1841,1843,1845,1847,1849,1851,1853,1855,1857,1859,1861,1863,1865,1867,1869,1871,1873,1875,1877,1879,1881,1883,1885,1887,1889,1891,1893,1895,1897,1899,1901,1903,1905,1907,1909,1911,1913,1915,1917,1919,1921,1923,1925,1927,1929,1931,1933,1935,1937,1939,1941,1943,1945,1947,1949,1951,1953,1955,1957,1959,1961,1963,1965,1967,1969,1971,1973,1975,1977,1979,1981,1983,1986,1991,1993,1995],{"id":503,"title":504,"titles":1045,"content":1046,"level":597},[],"写明环境和复现步骤，让其他人更容易理解并回答问题。 登录并验证邮箱后，打开发帖页面。需要帮助时勾选“我需要帮助”，并写清运行环境、问题现象和复现步骤。",{"id":1048,"title":1049,"titles":1050,"content":1051,"level":632},"\u002Farticles\u002Fask-for-help#发布一条帖子","发布一条帖子",[504],"填写具体标题和正文。当前发帖页要求标题为 2–80 个字符，正文至少 10 个字符。求助时勾选“我需要帮助”；普通交流可不勾选。讨论已有资源时，在“关联资源”中搜索并选择它，也可从资源详情的求助入口进入。检查日志、链接及身份信息，点击“保存草稿并提交审核”。需要继续完善时，先点击“保存草稿”。在发布审核记录查看反馈，通过并公开后再打开帖子核对展示。",{"id":1053,"title":1054,"titles":1055,"content":1056,"level":632},"\u002Farticles\u002Fask-for-help#求助至少写清这些内容","求助至少写清这些内容",[504],"实际使用的游戏版本、加载器、资源版本及必要前置。怎样触发问题，原本期望什么，实际发生了什么。已尝试的处理方法，以及能否在独立测试环境复现。去除隐私和秘密后的日志、截图或其他依据。 不要只写“不能用”。日志较长时提供可访问的文本链接，并摘出关键报错；分享前删除令牌、登录信息和无关个人资料。",{"id":1058,"title":1059,"titles":1060,"content":1061,"level":632},"\u002Farticles\u002Fask-for-help#草稿和正文图片","草稿和正文图片",[504],"发帖页会在当前浏览器保存本地草稿，重要长文仍请另存备份。需要上传正文图片时，先点击“保存草稿”，保存后进入草稿编辑页上传、插入图片并保存，检查完成后再提交审核。单独保存私有草稿不会自动送审。 编辑草稿、送审时冻结的版本和公开版分别保存。首次发布和实质修改均需审核；审核期间保存修改不会改变送审内容，需明确重新提交并确认替换。旧公开版在新版本通过前保持不变。只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。 更多标题示例与求助模板见帖子发布规范。需要提供可下载的作品时，应发布资源，再用帖子交流使用问题。 需要按章节持续整理知识时，可撰写独立教程；围绕教程提问或讨论时，从教程阅读页发起关联讨论。",{"id":516,"title":517,"titles":1063,"content":1064,"level":597},[],"在下载窗口中同时确认游戏版本、加载器和文件信息。 在资源详情页点击“下载”，选择自己的游戏版本和加载器，确认出现匹配文件后再下载。资源支持多个环境时，请以这两个条件共同匹配的结果为准。",{"id":1066,"title":1067,"titles":1068,"content":1069,"level":632},"\u002Farticles\u002Fdownload-builds#选择并下载","选择并下载",[517],"从资源库打开目标资源，阅读介绍与安装要求。点击页面顶部“下载”，也可以从发布记录的下载按钮打开窗口。选择实际使用的“游戏版本”和“加载器”。核对窗口显示的版本号、文件名及预览版标记，点击“下载”。 下载窗口可能已经预选一个组合，仍请确认它符合你的环境。顶部下载入口优先选择正式版；如果资源只有预览版，按钮会标明“下载预览版”。",{"id":1071,"title":1072,"titles":1073,"content":1074,"level":632},"\u002Farticles\u002Fdownload-builds#提示没有匹配构建","提示没有匹配构建",[517],"“没有同时支持……”表示当前组合没有可用构建。即使游戏版本和加载器分别都能在选项中找到，也不代表它们可以任意组合。 例如某资源一条记录支持 Quilt 与 26.2，另一条支持 Fabric 与 1.19.4，那么选择 Quilt 与 1.19.4 仍然没有匹配。可以检查自己的选择，或查阅其他发布记录；不要仅凭资源名称判断兼容。筛选规则见发布记录与联合筛选。",{"id":1076,"title":1077,"titles":1078,"content":1079,"level":632},"\u002Farticles\u002Fdownload-builds#下载后仍要阅读安装说明","下载后仍要阅读安装说明",[517],"核对文件对应的加载器、游戏版本、运行环境和必需前置，再按作者说明安装。不同作品的安装方式可能不同；修改存档或配置前，先做好备份。 如果资源页只有介绍而没有下载入口，请查看作者提供的获取说明。遇到错误文件、失效链接或无法运行的问题，可按求助指南附上具体版本和复现步骤。",{"id":529,"title":530,"titles":1081,"content":1082,"level":597},[],"编辑资源资料和单条构建，管理本站依赖及独立教程的关联。 从我的创作选择“编辑资源”，可以维护介绍、标签、封面、发布记录和关联内容。资源详情中的“编辑资源”也是同一入口。已接受邀请的本站共同作者可以编辑和发布；只有资源所有者可以管理共同作者和删除整个资源。邀请尚未被接受时，不会产生维护权限。",{"id":1084,"title":1085,"titles":1086,"content":1087,"level":632},"\u002Farticles\u002Fedit-resource#邀请共同维护","邀请共同维护",[530],"资源所有者在编辑页的“共同作者”区域搜索本站用户，选定账号后发送邀请。对方在我的创作的“待接受邀请”中接受后，资源会标记为“共同维护”，并出现编辑入口。邀请未接受时不授予维护权限。 共同作者可以维护资源资料和发布记录；只有所有者可以邀请、取消邀请、移除成员或删除整个资源。共同作者可自行退出，退出或被移除后不能继续编辑。成员变更不会删除独立讨论，也不会将其他作者的教程变成共同所有。 资源受平台处置或已删除时，收件箱会保留失效邀请并禁止接受，仍可拒绝。处置期间所有者仍可管理成员；资源恢复后，尚未关闭的邀请可继续接受。 这里的共同作者表示本站账号获得维护权限，不是原作品作者身份或转载授权的证明。原作者、来源和授权依据仍应在介绍中写清。",{"id":1089,"title":1090,"titles":1091,"content":1092,"level":632},"\u002Farticles\u002Fedit-resource#修改资源资料","修改资源资料",[530],"确认登录的是有维护权限的账号。打开编辑页，修改资料、正文、标签或页面能力。上传正文图片后，将地址插入正文，再保存修改。在发布状态区域检查草稿和审核版本，再提交审核。通过后打开资源详情，检查排版、图片、链接与实际显示。 保存的是私有编辑草稿；审核使用提交时冻结的版本；读者继续看到旧公开版，直到新版本通过。首次发布和实质修改都需审核。只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。审核中继续保存不会改变送审内容，需要明确重新提交并确认替换。 通用介绍供所有构建共用。仅涉及某一构建的变化，请在对应发布记录的更新说明或安装说明中写清适用范围。",{"id":1094,"title":1095,"titles":1096,"content":1097,"level":632},"\u002Farticles\u002Fedit-resource#修正或删除单条构建","修正或删除单条构建",[530],"编辑页的发布记录列表按物理构建列出，每条都有自己的 ID。在“维护发布记录”中展开需要修改的记录，核对 ID、版本号、加载器与游戏版本配对及文件，再保存这一条的技术参数、兼容范围或文件，并为该记录提交审核。即使两条构建使用同一个版本号和文件，也应分别核对。删除确认只删除指定记录，同版本或同批次的其他记录会保留。 可以修改所选构建的版本号、渠道、运行环境、支持范围、文件、说明和可见状态。文件或兼容声明填错时，直接修正该构建；需要撤回时，将它调整为合适的非公开状态，或确认后删除该条构建。删除只作用于选中的物理 ID，同批次的其他构建不会一起删除。也可以从资源页发布新构建。 不要只修改资源正文，却继续保留错误的文件或兼容声明。一次支持组中的每个加载器与每个游戏版本组合都必须成立；不成立的组合要拆成不同组。 如果提示内容已在其他位置修改，当前草稿会保留；核对后再决定是否放弃草稿并重载。若公开基线已经变化，先查看页面列出的差异，再按提示确认并重新送审。换账号时，编辑页会清空上一账号的私有内容和未提交表单。",{"id":1099,"title":1100,"titles":1101,"content":1102,"level":632},"\u002Farticles\u002Fedit-resource#教程独立维护","教程独立维护",[530],"编辑页的“创建独立教程”和“管理我的教程”分别进入教程创建和我的教程。教程正文与章节在自己的编辑页维护，邀请资源共同作者不会授予教程编辑权。",{"id":1104,"title":1105,"titles":1106,"content":1107,"level":632},"\u002Farticles\u002Fedit-resource#管理本站依赖和教程关联","管理本站依赖和教程关联",[530],"整个资源都需要的本站项目，放在通用依赖；只有某条构建需要的项目，放在该物理构建的依赖。核对该构建的物理 ID、加载器和游戏版本后，再按实际情况标记“必需”或“可选”，并填写说明。同版本号、同文件或同批次的其他构建不会自动继承这条额外依赖。本站选择器只绑定当前已公开的资源；目标以后失效时，公开页会显示不可跳转的失效提示，不会把关联自动改指向另一个项目。 资源可关联本站已独立发布的教程。先在创建教程完成教程的编写和发布，再绑定到资源；已有教程在我的教程单独管理。通用依赖、指定构建的依赖、教程关联分别保存，修改一个范围不会改动另两个范围。解绑只移除资源与教程之间的引用，不会删除教程或其章节。资源内旧版“说明文档”区域仍是历史内嵌内容，不能用它创建独立教程。 旧版站外引用和异常关联保留原始 ID，不会自动合并或删除。若页面提示“需要整理”，先加载并核对该范围的全部记录，按引用 ID 逐条解除错误的本站依赖，再保存该范围的新清单；不要把站外地址当作本站资源。历史记录超过一个页面时，不要仅凭当前页替换全部关联。",{"id":1109,"title":1110,"titles":1111,"content":1112,"level":632},"\u002Farticles\u002Fedit-resource#保存冲突与平台处置","保存冲突与平台处置",[530],"多人同时维护时，另一个人先保存可能使当前修订过期。页面会提示重新读取；请先核对未提交内容，再选择如何继续。切换登录账号后，旧账号的编辑草稿不会交给新账号提交。 资源受到平台下架或移除处置时，编辑页只允许修正规定的资料和发布说明，不能借状态、文件、兼容、封面或关联操作恢复公开。保存修改不会自动解除处置；需要复核时，请按页面提示提供修改位置与依据。 删除整个资源不会同时删除独立帖子或教程；引用处会保留失效提示。处理前请核对影响范围。",{"id":541,"title":542,"titles":1114,"content":1115,"level":597},[],"组合筛选条件，找到与你的 Minecraft 环境相符的资源。 打开资源库，选择你的游戏版本和加载器，再按用途添加其他条件。筛选结果会随条件变化，打开详情后仍需核对具体下载文件。",{"id":1117,"title":1118,"titles":1119,"content":1120,"level":632},"\u002Farticles\u002Ffind-resources#选择适用条件","选择适用条件",[542],"先确认自己实际使用的 Minecraft 版本，以及 Fabric、Forge、Paper 等加载器。在资源库中选择对应条件。手机上先点击“筛选”展开面板。根据需要选择类型或内容标签，也可切换“最近更新”等排序。点击感兴趣的资源，阅读介绍、支持范围与安装说明。 不必先选类型才能选加载器。多个条件可以一起使用；想重新开始时，点击“清空”移除已选条件。",{"id":1122,"title":1123,"titles":1124,"content":1125,"level":632},"\u002Farticles\u002Ffind-resources#多选条件怎样匹配","多选条件怎样匹配",[542],"同一组中多选表示满足其中任意一项；不同组之间则需要同时满足。例如选择两个游戏版本，再选择 Fabric，表示查找有 Fabric 构建支持其中任意一个版本的资源。 加载器和游戏版本必须在同一条发布记录上同时成立。一个资源分别有 Quilt 构建和 1.19.4 构建，并不代表它提供 Quilt 1.19.4 构建。更多说明见发布记录与联合筛选。",{"id":1127,"title":1128,"titles":1129,"content":1130,"level":632},"\u002Farticles\u002Ffind-resources#分享筛选结果","分享筛选结果",[542],"筛选条件保存在浏览器地址中。选好后复制地址，即可分享当前组合，或保存为书签。例如可以直接打开Fabric 1.20.1 资源。 结果为空时，检查版本与加载器是否选择正确，再逐项减少其他条件；不要把其他环境的文件当作兼容替代。",{"id":553,"title":554,"titles":1132,"content":1133,"level":597},[],"复用资源介绍，为每个新构建准确填写支持范围和文件。 打开自己的资源详情，点击“发新版本”。通用介绍继续沿用，只需填写这次发布的版本、文件、支持范围和说明。",{"id":1135,"title":1136,"titles":1137,"content":1138,"level":632},"\u002Farticles\u002Fpublish-release#填写这次发布","填写这次发布",[554],"在资源页面进入“发新版本”，确认当前账号具有维护权限。填写版本号、正式版或预览版渠道、运行环境、更新说明，以及需要补充的安装说明。为实际支持的环境添加支持组，选择加载器和游戏版本。添加所需文件，逐个上传或填写外部下载信息，指定主文件，检查完成后提交审核。 提交时冻结本次内容，编辑草稿与当前公开版分别保留。同批次包含多条发布记录时，需全部通过后才公开；只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。继续修改草稿不会改写冻结版本，需要明确重新提交并确认替换。已有公开记录在新版本通过前保持原样，可在发布审核记录查看进度与反馈。",{"id":1140,"title":1141,"titles":1142,"content":1143,"level":632},"\u002Farticles\u002Fpublish-release#支持组里的组合都要成立","支持组里的组合都要成立",[554],"一组中选择的每个加载器，都应支持这一组选择的每个游戏版本。若同一个文件只支持 Fabric 1.20.1 和 Forge 1.19.2，请填成两组，不能把两个加载器与两个版本放进同一组。 同一次提交的支持组共用本次文件。不同环境需要不同文件时，分别提交相应构建，版本号可以相同。完整说明见资源发布规范。",{"id":1145,"title":1146,"titles":1147,"content":1148,"level":632},"\u002Farticles\u002Fpublish-release#选择上传或外链","选择上传或外链",[554],"选择“上传到本站”时，等待传输、处理和校验全部完成再提交；进度达到 100% 不代表发布记录已经保存。 选择“外部下载地址”时，填写对应文件的地址、文件名、格式、字节大小和完整 SHA512。若下载需要登录或提取码，应在说明中写清。 审核通过并公开后打开详情，核对新记录、文件和兼容范围。实验性构建应选择 Alpha 或 Beta，不要按正式版提交。只对这条物理构建生效的本站前置依赖，可随后在资源编辑页为该构建单独关联。",{"id":565,"title":566,"titles":1150,"content":1151,"level":597},[],"从名称和介绍开始，补齐图片、文件与兼容信息后再公开。 打开发布资源，填写基本介绍并先保存草稿，再上传图片和文件。资料与发布记录准备好后，点击“发布”提交审核，通过并公开后再检查实际页面。",{"id":1153,"title":1154,"titles":1155,"content":1156,"level":632},"\u002Farticles\u002Fpublish-resource#发布前先检查","发布前先检查",[566],"先在资源库搜索作品名称和原始地址。已有自己的资源时，更新原条目或发布新版本，不要为每个加载器、每次更新重复创建。 转载、翻译或分支作品还应写清原作者、来源、许可与自己的维护范围。具体要求见命名、署名与转载要求。",{"id":1158,"title":1159,"titles":1160,"content":1161,"level":632},"\u002Farticles\u002Fpublish-resource#保存并补齐草稿","保存并补齐草稿",[566],"填写名称、简介和介绍。名称为 2–60 个字符，简介为 10–200 个字符，介绍至少 10 个字符。选择“页面上要放什么”，填写所选项目需要的数据。点击“保存草稿”，再上传封面、正文图片或发布文件。有下载文件时，填写版本号与准确的支持组合，等待上传处理完成。检查内容后点击“发布”提交审核，在发布审核记录查看进度与反馈。首次发布的资源及同批次发布记录全部通过后才会公开，再打开详情核对文件、图片和链接。 标签可以多选或留空。加载器和游戏版本应填写在支持范围中，不用开放标签代替。",{"id":1163,"title":1164,"titles":1165,"content":1166,"level":632},"\u002Farticles\u002Fpublish-resource#草稿与审核版本","草稿与审核版本",[566],"保存草稿不会公开内容。提交时会冻结当前版本，之后仍可继续编辑草稿；保存修改不会改变已送审内容，需要明确重新提交并确认替换审核版本。只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。",{"id":1168,"title":1169,"titles":1170,"content":1171,"level":632},"\u002Farticles\u002Fpublish-resource#中途离开或提交失败","中途离开或提交失败",[566],"可从我的创作找回已保存的草稿。先核对已有内容和发布记录，再继续提交，避免重复创建。 介绍应说明用途、基本用法、依赖和已知限制；不要把尚未完成的计划当作已提供功能。完整填写要求见资源发布规范。",{"id":577,"title":578,"titles":1173,"content":1174,"level":597},[],"保存独立教程草稿，按章节写作、预览，并关联讨论。 从写教程开始，填写标题和简介并创建草稿，再按章节组织正文。已经保存的教程可以从我的教程继续编辑。",{"id":1176,"title":1177,"titles":1178,"content":1179,"level":632},"\u002Farticles\u002Fpublish-tutorial#按章节写作","按章节写作",[578],"在目录中选择要编辑的章节，使用正文编辑器书写说明；需要时添加代码或图片。章节和段落可以重排，已保存的定位链接会继续保留。新章节需要先保存，之后才能把它设为其他章节的父章节。 图片通过页面的上传入口添加，不要把站外图片地址粘贴成正文图片。代码中的标签示例可以正常书写；教程正文仍不接受原始 HTML。添加图片后应保存教程，先确认它已经出现在草稿预览中；审核通过并公开后，再检查读者页面。",{"id":1181,"title":1182,"titles":1183,"content":1184,"level":632},"\u002Farticles\u002Fpublish-tutorial#草稿预览与发布","草稿、预览与发布",[578],"未公开时使用“保存草稿”，检查完整预览后点击“发布教程”提交审核。已经公开的教程可以保存更新，再从发布状态区域提交审核，或撤回为草稿；平台处置中的内容按页面提供的纠正入口处理，不能自行恢复公开。 编辑草稿、提交时冻结的审核版本和当前公开版分别保存。首次发布及实质修改都需要审核，保存修改不会直接更新读者页面，也不会改变已送审内容；明确重新提交并确认替换后，才会使用新的草稿审核。旧公开版在新版本通过前保持不变。只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。进度与反馈见发布审核记录。 未保存的文字会尝试保留在当前浏览器，恢复时会核对账号、教程和服务器版本。其他浏览器或清理站点数据后无法依靠这份本地副本找回内容，因此重要修改仍应及时保存到服务器。服务器版本已经变化时，应先查看旧草稿并核对差异，不直接覆盖新的版本。未保存图片离开页面后可能被清理，恢复文字草稿时可能需要重新上传。",{"id":1186,"title":1187,"titles":1188,"content":1189,"level":632},"\u002Farticles\u002Fpublish-tutorial#讨论与订阅","讨论与订阅",[578],"公开阅读页可以查看关联讨论或发起新讨论。讨论发布后可通过引用卡返回教程；删除或撤回教程不会删除已经发布的帖子。 点击“订阅更新”可将这篇教程添加到 Atom 阅读器。教程列表也提供按标签和游戏版本筛选的订阅，地址和限制见内容订阅。",{"id":588,"title":589,"titles":1191,"content":1192,"level":597},[],"使用邮箱注册，了解密码、邮箱链接和通行密钥登录。 在注册页面填写邮箱，打开收到的注册链接，再设置用户名和密码，即可完成注册。",{"id":1194,"title":1195,"titles":1196,"content":1197,"level":632},"\u002Farticles\u002Fregister-and-login#创建账号","创建账号",[589],"输入自己能够访问的邮箱，点击“发送注册链接”。打开邮件中的链接，确认页面显示的注册邮箱。设置用户名：3–32 位小写字母、数字、下划线或连字符，首位须为字母或数字。设置至少 10 位的密码，点击“完成注册”。 用户名已被使用时，请按页面提示更换。发送成功提示不代表邮件已经到达收件箱；未看到邮件时，也可以检查垃圾邮件与邮箱过滤规则。",{"id":1199,"title":1200,"titles":1201,"content":1202,"level":632},"\u002Farticles\u002Fregister-and-login#选择登录方式","选择登录方式",[589],"打开登录页面，输入邮箱或用户名，再输入密码。也可以点击“发送邮箱登录链接”，然后打开对应邮件。 已经为账号添加通行密钥时，可输入邮箱或用户名后点击“使用通行密钥”，按照设备提示验证。页面出现第三方登录按钮时，也可使用对应入口；可用服务以页面实际显示为准。 启用了两步验证的账号，按后续页面要求输入认证器验证码或备用码。若提示邮箱尚未验证，可前往验证邮箱重新发送验证邮件。",{"id":1204,"title":1205,"titles":1206,"content":1207,"level":632},"\u002Farticles\u002Fregister-and-login#无法登录时","无法登录时",[589],"忘记密码可按重置密码的步骤操作。验证码或链接报错时，先阅读页面提示，再返回登录页重试；不要向他人提供密码、验证码或邮件中的完整链接。",{"id":600,"title":601,"titles":1209,"content":1210,"level":597},[],"回复具体内容，在找到方案后标记已解决并留下适用步骤。 打开帖子并登录后，可以在下方回复；发帖人可进入“编辑帖子”，将待解决问题标记为“已解决”或“已关闭”。请先确认结果，因为终态不能重新打开。",{"id":1212,"title":1213,"titles":1214,"content":1215,"level":632},"\u002Farticles\u002Freply-and-resolve#回复原帖或具体楼层","回复原帖或具体楼层",[601],"从讨论列表或资源详情进入帖子。直接在下方输入框回复原帖；要回应某条回复时，点击它旁边的“回复”。检查正在回复的对象和内容，再点击“发送回复”提交审核。页面会显示提交结果；可通过草稿编辑入口继续完善，并在发布审核记录查看反馈。通过后，回复才会出现在公开讨论中。 只有符合已启用低风险自动批准条件的完整结果才可自动通过，其他情况进入人工处理。 回复应增加信息，例如补充复现结果、解释原因或提供可核对的步骤。展示层数较深的回复不再提供继续回复按钮时，可回到上层，说明所回应的内容。",{"id":1217,"title":1218,"titles":1219,"content":1220,"level":632},"\u002Farticles\u002Freply-and-resolve#找到方案后更新结果","找到方案后更新结果",[601],"先回复说明有效步骤、适用版本和剩余限制，方便后来者参考。然后从帖子详情的“编辑帖子”，或我的创作进入维护页面。 在“问题状态”区域选择“标记已解决”，阅读提示后确认。问题尚未解决但不再继续处理时，可以说明原因并选择“关闭问题”；关闭不等于修复。 普通讨论没有问题状态。只有建立了待解决状态的帖子，才会显示对应维护操作。",{"id":1222,"title":1223,"titles":1224,"content":1225,"level":632},"\u002Farticles\u002Freply-and-resolve#修正自己发出的内容","修正自己发出的内容",[601],"作者可在编辑页修改帖子标题、正文并保存私有草稿，再提交审核。实质修改通过后才会替换公开内容；审核使用提交时冻结的版本，保存新草稿不会改写它，需要明确重新提交并确认替换。旧公开版在新版本通过前保持不变。删除帖子后，已有回复和引用仍按页面规则保留，不会随原帖一起消失。更多说明见帖子发布规范。",{"id":612,"title":613,"titles":1227,"content":1228,"level":597},[],"反馈错误文件、侵权或其他内容问题，准备具体事实和证据。 发现虚假兼容、错误文件、冒充作者、侵权转载或隐私泄露时，可在资源、帖子或回复旁点击“举报”，提交具体事实和证据。一般使用问题可先按求助指南交流。",{"id":1230,"title":1231,"titles":1232,"content":1233,"level":632},"\u002Farticles\u002Freport-content#提交举报","提交举报",[613],"打开涉及的资源或帖子，找到对应内容的“举报”入口。尚未登录时，先登录账号。填写最多 1000 个字符的问题说明，检查后点击“提交举报”。以页面显示的提交结果为准；失败时按提示重试。 同一账号重复举报同一内容时，会保留已有待处理记录。提交不代表平台已经认可举报结论，也不会自动下架内容。",{"id":1235,"title":1236,"titles":1237,"content":1238,"level":632},"\u002Farticles\u002Freport-content#怎样写清问题","怎样写清问题",[613],"说明具体对象、涉及版本、发生了什么，以及可以核对的依据。版权问题应写清原始来源、相关权利或授权情况，以及涉嫌侵权的位置。 材料较多时，先提供关键事实和必要的证据链接。不要公开密码、令牌、私人聊天或其他无关个人信息，也不要用重复举报代替证据。",{"id":1240,"title":1241,"titles":1242,"content":1243,"level":632},"\u002Farticles\u002Freport-content#内容无法访问或已被处置","内容无法访问或已被处置",[613],"内容已经无法访问时，先保留完整地址、涉及版本、发生时间和已有证据，便于准确说明问题。当前没有独立申诉页面或自动复核队列；本指南不承诺固定处理时间或收到回复。 自己的资源受到处置时，可根据页面提示修正允许修改的说明，并记录修改位置与依据。保存修改不会自动解除处置，公开状态以页面实际显示为准。",{"id":624,"title":625,"titles":1245,"content":1246,"level":597},[],"通过注册邮箱设置新密码，并在重置后重新登录。 在重置密码页面填写账号邮箱，打开邮件中的重置链接，再设置新密码。整个过程需要你能够访问该邮箱。",{"id":1248,"title":1249,"titles":1250,"content":1251,"level":632},"\u002Farticles\u002Freset-password#发送重置邮件","发送重置邮件",[625],"打开重置密码页面，输入注册时使用的邮箱。点击“发送重置邮件”，等待页面返回结果。前往邮箱，打开这次请求对应的密码重置邮件。 如果没有看到邮件，请先核对邮箱拼写，再检查垃圾邮件、拦截规则及邮箱空间。页面显示发送提示，不代表邮件已经进入收件箱，也没有固定送达时间。",{"id":1253,"title":1254,"titles":1255,"content":1256,"level":632},"\u002Farticles\u002Freset-password#设置新密码","设置新密码",[625],"打开邮件链接后，页面会显示新密码输入框。输入至少 10 位的新密码，再输入一次确认；两次内容必须一致。点击“重置密码”，看到成功提示后返回登录页面，使用新密码登录。 请为账号使用独立密码，不要把邮件链接或新密码转发给别人。重置登录密码也不意味着可以跳过账号已有的后续登录验证。",{"id":1258,"title":1259,"titles":1260,"content":1261,"level":632},"\u002Farticles\u002Freset-password#链接无法使用","链接无法使用",[625],"直接打开重置密码页面时，先填写邮箱发送邮件；设置新密码需要通过邮件中的完整链接进入。若链接报错或已无法使用，返回发送页面重新申请，并按页面提示操作。 如果你记得密码且已经登录，可以到账号安全按页面要求修改密码。无法访问原邮箱时，本页的邮件流程不能代替邮箱验证。",{"id":635,"title":636,"titles":1263,"content":1264,"level":597},[],"将感兴趣的资源和讨论加入收藏，在个人主页中查看。 登录后，在资源或帖子页面点击“收藏”，之后可以从我的收藏重新打开内容。收藏适合保存以后还想查看的介绍、下载页和讨论。",{"id":1266,"title":1267,"titles":1268,"content":1269,"level":632},"\u002Farticles\u002Fsave-favorites#添加或取消收藏","添加或取消收藏",[636],"打开需要保存的资源或帖子，找到内容旁的“收藏”。点击按钮；未登录时先按提示登录账号。等待操作完成，确认按钮显示的状态。 再次点击已选中的收藏按钮可以取消收藏。网络异常或页面显示失败时，请先确认当前状态，再重试。",{"id":1271,"title":1272,"titles":1273,"content":1274,"level":632},"\u002Farticles\u002Fsave-favorites#查看已收藏的内容","查看已收藏的内容",[636],"打开“我的收藏”后，网站会进入个人中心的“收藏”页面。点击列表中的标题，可以返回对应内容；条目较多时，可继续加载后面的记录。",{"id":1276,"title":1277,"titles":1278,"content":1279,"level":632},"\u002Farticles\u002Fsave-favorites#没有收藏过也想找回","没有收藏过也想找回",[636],"可以查看浏览历史，寻找曾经打开过的内容；也可以回到资源库，用记得的游戏版本、加载器和标签重新筛选。 收藏记录不是资源文件的备份，不能让已经不可用的内容继续下载。找到需要的资源后，仍请阅读详情页当前显示的状态、兼容范围和获取说明。",{"id":646,"title":647,"titles":1281,"content":1282,"level":597},[],"用认证器保护登录，并妥善保存一次性备用码。 打开账号安全，在认证器中添加页面提供的密钥，再用验证码确认开启。看到密钥并不代表设置已经完成。",{"id":1284,"title":1285,"titles":1286,"content":1287,"level":632},"\u002Farticles\u002Ftwo-factor-authentication#绑定认证器","绑定认证器",[647],"登录账号，进入“账号安全”。按“安全操作验证”的提示填写当前登录密码；已有安全因子时，按提示提供相应验证。在“两步验证”区域点击“开启两步验证”。在可信任的认证器应用中选择手动输入密钥，填入页面显示的密钥；也可以使用页面提供的 URI 导入。输入认证器里的 6 位验证码，点击“确认并开启”。 没有登录密码时，请按页面提示，在邮箱或第三方登录后的 5 分钟内完成首次设置。超过时间可重新登录后继续。",{"id":1289,"title":1290,"titles":1291,"content":1292,"level":632},"\u002Farticles\u002Ftwo-factor-authentication#保存备用码","保存备用码",[647],"开启后立即把备用码保存到安全的地方，再勾选“我已经把备用码抄到安全的地方了”，点击“完成”并重新登录。 备用码只在生成时显示，每个码只能使用一次。需要时，可在登录验证页面使用一枚尚未使用的备用码。不要把备用码和认证器密钥发给他人。",{"id":1294,"title":1295,"titles":1296,"content":1297,"level":632},"\u002Farticles\u002Ftwo-factor-authentication#验证失败或备用码不足","验证失败或备用码不足",[647],"验证码错误时，检查设备时间，并尝试下一轮验证码。备用码不足时，在账号安全页输入当前认证器验证码，选择“重新生成备用码”，保存新的一组；旧备用码随之作废。 关闭两步验证也需要按页面要求完成验证。修改安全凭据后，按提示重新登录。",{"id":15,"title":14,"titles":1299,"content":1300,"level":597},[],"判断什么应当发布为资源，以及作品、发布记录和维护身份的边界。 NexusMC 的资源围绕 Minecraft 的使用、内容创作与运行维护。资源是可以实际使用的作品，或可以接入的持续服务；它应当有可识别的名称、明确用途，以及能够获取或使用的对象。资源不以是否提供下载文件为限；可以连接的服务器、有明确使用入口的相关在线工具，也可以作为资源。 本页帮助你决定是否新建资源。实际填写和发布步骤见资源发布规范，内容核查标准见资源审核要求。",{"id":1302,"title":1303,"titles":1304,"content":1305,"level":632},"\u002Fpublishing\u002Fresource-definition#先判断读者要使用什么","先判断读者要使用什么",[14],"你准备分享的内容适合的发布方式示例一个可以安装、导入、运行、连接或接入的作品或服务资源插件、整合包、皮肤、地图、服务器、在线工具有目录、章节和持续维护需求的系统知识教程从环境准备到部署维护的完整服务器搭建教程围绕一个主题展开的交流、问题或经历帖子安装报错、方案讨论、使用体验、开发进展 教程的网页发布入口尚未开放。不要为了获得目录或发布长文而把教程包装成资源；普通经验交流可以先发布为帖子。作品的安装说明可以写在资源介绍中，独立的系统教程仍应按教程组织。 仅有开发设想、招募口号、群号或“敬请期待”，尚不足以说明一个可用资源。可以先用帖子讨论计划；已有可实际使用的早期版本时，可以发布资源，并清楚标明完成范围与实验性限制。",{"id":1307,"title":1308,"titles":1309,"content":1310,"level":632},"\u002Fpublishing\u002Fresource-definition#按使用方式说明作品","按使用方式说明作品",[14],"以下是帮助读者判断用途的例子，不是发布时必须单选的分类。同一个作品可以有多种使用方式。 使用方式可以说明的对象发布时需要让读者知道运行或集成独立程序、代码库、脚本、插件、模组、启动器程序做什么，如何运行或集成，需要什么环境导入一套配置或内容整合包、服务端方案、配置包包含什么，如何导入，依赖与分发范围是什么使用或展示视觉作品皮肤、材质、光影、地图、模型实际效果、文件格式、适用环境与导入方式连接或接入服务Minecraft 服务器、在线工具、持续提供的服务使用入口、支持环境、服务规则与获取条件 代码仓库应有可用内容和清楚的使用入口；单纯收集链接、复制一段介绍或为其他站点导流，不能代替作品本身。体量小、功能单一、尚未流行，都不是排除资源的理由。",{"id":1312,"title":1313,"titles":1314,"content":1315,"level":632},"\u002Fpublishing\u002Fresource-definition#一个作品维护一份资源","一个作品维护一份资源",[14],"资源页面描述作品的长期身份、用途和通用说明；发布记录描述某次交付的文件、兼容范围、依赖和变化。作品更新时，一般在原资源中维护，不为每次更新重新建立页面。 发生的变化应当怎样处理修正介绍、译名、截图、来源或通用说明修改已有资源发布新版本，增加加载器适配或提供另一构建在原资源追加对应发布记录同一文件增加下载镜像，或补充另一种语言的介绍维护原有资源的说明和获取信息，不重复创建独立维护、具有实质变化的分支或移植可以新建资源，明确原作、修改范围及维护关系与原作品身份、用途和维护过程均独立的新作品新建资源，并按实际情况引用相关作品 只改名称、翻译介绍、重新压缩、替换下载地址，不能单独证明它已经成为新作品。判断分支时，要能说明实际差异、由谁继续维护，以及用户为什么需要分别获取；“非官方版”几个字不能代替这些信息。 发现同一作品已经存在时，先核对已有条目的身份与来源。不要因为不是自己创建的页面就另建副本，也不要假定平台会自动合并条目或转移维护权。有重复或维护关系争议时，按举报与申诉提供具体材料。",{"id":1317,"title":1318,"titles":1319,"content":1320,"level":632},"\u002Fpublishing\u002Fresource-definition#本站维护者与原作者分别说明","本站维护者与原作者分别说明",[14],"本站维护者负责维护本页面及其发布记录；原作者负责创作原作品。上传文件、整理资料、翻译介绍、维护镜像或取得页面维护权限，都不会自动改变原作者身份。 请写清原作者、原始来源、本站维护范围和对应版本的许可或授权依据。原创部分与第三方部分分别说明；分支、移植和二次打包应让读者一眼看出与原作的关系，不冒充官方发布。具体写法见命名、署名与转载。",{"id":1322,"title":1323,"titles":1324,"content":1325,"level":632},"\u002Fpublishing\u002Fresource-definition#页面功能与标签可以组合","页面功能与标签可以组合",[14],"“页面上要放什么”决定资源需要哪些功能区，例如文件下载、效果展示、整合内容或外部使用入口。按作品实际需要组合填写；视觉展示和下载可以同时存在，服务器也可以同时提供客户端文件。不要为每一种页面功能分别创建同一作品。 玩法功能、视觉风格和画质特征等开放标签可以多选，也可以留空。它们用于描述实际特征，不要求作品归入唯一分类，也不要求先选上级标签。 加载器与 Minecraft 版本应填写在发布记录的兼容信息中，不用开放标签代替。作品可能同时提供插件和模组构建，不需要为整个资源选一个唯一类型；页面中的展示分组也不能代替实际兼容声明。",{"id":1327,"title":1328,"titles":1329,"content":1330,"level":632},"\u002Fpublishing\u002Fresource-definition#兼容条件必须同时成立","兼容条件必须同时成立",[14],"用户要找的是一个能够使用的构建。加载器、游戏版本等条件必须由同一条发布记录同时满足，不能从不同记录各取一个条件拼成兼容结果。 例如，一个作品有两条发布记录： 发布记录加载器游戏版本AFabric1.20.1BForge1.19.2 这不能证明存在适用于 Fabric 1.19.2 的构建。需要精确配对时，分别填写真实支持的组合；一组内选择多个加载器和版本时，所有交叉组合都必须成立。不同构建使用不同文件时，分别提交对应文件与支持范围，不能让用户自行猜测。 兼容填写、依赖和文件信息的具体要求见资源发布规范。未经确认的兼容性应说明验证范围，不扩大成已支持条件。",{"id":1332,"title":1333,"titles":1334,"content":1335,"level":632},"\u002Fpublishing\u002Fresource-definition#关联内容保持独立","关联内容保持独立",[14],"围绕资源的讨论、求助和问题反馈可以关联资源，无须为每个版本另建讨论资源。独立教程也可以被引用，不会因此变成资源的一部分。 资源删除后，已经发布的独立帖子仍然保留，引用处显示资源失效提示及必要的封面、简介等墓碑信息。不要把删除资源当作撤回讨论或消除反馈的方法。内容修正和管理员处置的区别见内容处置说明。",{"id":19,"title":18,"titles":1337,"content":1338,"level":597},[],"写清讨论主题、求助环境和复现步骤，让交流能够继续。 帖子适合讨论、经验交流、问题反馈和求助。需要用户下载的作品应发布为资源，再用帖子交流使用问题。",{"id":1340,"title":1341,"titles":1342,"content":1343,"level":632},"\u002Fpublishing\u002Fposts#在当前网页发布","在当前网页发布",[18],"登录并验证邮箱，打开主站 \u002Fposts\u002Fnew。填写标题和正文。当前网页要求标题为 2–80 个字符，正文至少 10 个字符；字数达到要求仍需有实际信息。需要别人帮助解决问题时，勾选“我需要帮助”。普通交流可以不勾选。若讨论已有资源，在“关联资源”中搜索并选中它；也可以不关联。需要继续编辑或补图时，点击“保存草稿”，保存后进入草稿编辑页继续完善。内容准备好后，点击“保存草稿并提交审核”或编辑页的“提交审核”。在主站 \u002Fmember\u002Fpublications 查看审核记录与反馈；通过审核并公开后，再打开帖子核对实际显示效果。 发帖页会在当前浏览器保存本地草稿。重要长文请另存一份；本地草稿不能代替账号中的正式内容。 需要上传正文图片时，先保存私有草稿，再打开草稿编辑页，选择 PNG、JPEG、WebP 或 GIF 图片，上传后将本站图片地址插入正文并保存。检查完成后再提交审核。静态图片原图最多 20 MiB；GIF 和动态 WebP 原图最多 8 MiB。上传前可旋转，本站受管图片会转换为 WebP，动画会保留。保存草稿不会自动提交审核或公开帖子。 编辑草稿、审核中的冻结版本和读者看到的公开版分别保存。发帖、回复及实质修改均需经过发布审核；保存修改不会改写已经提交的冻结版本。需要让审核人员看到新内容时，明确重新提交并确认替换旧的审核版本。已有公开内容在新版本通过前保持不变。只有符合已启用低风险自动批准条件的完整审核结果才可自动通过，其他情况进入人工处理。",{"id":1345,"title":1346,"titles":1347,"content":1348,"level":632},"\u002Fpublishing\u002Fposts#标题写具体问题","标题写具体问题",[18],"标题应包含对象和主要现象，让有经验的人能判断是否能够回答。游戏版本、加载器或资源版本与问题直接有关时，可以写进标题。 不够清楚可以直接使用的写法求大佬救命！！！Fabric 1.20.1 安装示例模组后，进入世界时崩溃这个插件太差了示例插件 2.1 在 Paper 1.21.1 上重载后权限未生效来看看分享小型生存服的备份方案与一次恢复记录 避免在标题中堆叠表情、重复标点、夸张结论或与内容无关的热词。不要冒用“官方”“管理员”等身份。",{"id":1350,"title":1351,"titles":1352,"content":1353,"level":632},"\u002Fpublishing\u002Fposts#求助与问题反馈","求助与问题反馈",[18],"“我需要帮助”会给帖子建立待解决状态；它不是必须选择的内容分类。请先给出完整环境，再描述现象，不要只发一张报错截图或一句“不能用”。 可以复制以下模板，删除不适用的项目： ## 问题现象\n安装示例模组 2.0 后，进入新世界时退出到启动器。\n\n## 运行环境\n- Minecraft：1.20.1\n- 加载器及版本：Fabric Loader 0.15.11\n- 资源及版本：示例模组 2.0\n- Java \u002F 系统：Java 17，Windows 11\n- 必需前置：Fabric API，填写实际版本\n- 是否整合包 \u002F 服务端：填写名称和版本，或写“独立客户端”\n\n## 复现步骤\n1. 新建独立的测试实例，安装上述加载器。\n2. 只安装示例模组和必需前置。\n3. 新建世界，进入时发生崩溃。\n\n## 期望结果与实际结果\n- 期望：正常进入世界。\n- 实际：加载到约 80% 后退出。\n\n## 已尝试的方法\n移除其他模组后仍可复现；尚未测试其他 Java 版本。\n\n## 日志与补充材料\n填写已去除个人信息的完整日志链接、发生时间，以及关键报错。 模板中的版本仅展示写法，不代表该组合已测试。请填写自己的实际环境。复现会修改存档、配置或数据时，先在备份或独立测试环境操作。 日志较短时使用代码块，保留换行；日志较长时提供稳定、可访问的文本链接，并在正文摘出关键报错。分享前删除访问令牌、登录信息、私人聊天、真实地址和无关个人路径。不要只裁下错误的最后一行。 若问题尚未确认，写“在这些条件下出现”“怀疑与某项配置有关”，并保留验证过程。性能问题请同时注明硬件、测试场景、设置与测量方法，不把单次结果说成所有人的表现。",{"id":1355,"title":1356,"titles":1357,"content":1358,"level":632},"\u002Fpublishing\u002Fposts#普通讨论与回复","普通讨论与回复",[18],"普通讨论说明背景、自己的观察和想讨论的问题。使用体验请标注实际使用版本；比较多个作品时，给出相同测试条件，尊重不同用途和偏好。 回复应增加信息：补充复现结果、解释原因、给出可以核对的步骤，或说明方案的限制。不要反复顶帖、复制相同回复、用大图淹没正文，或仅发布“抢楼”等没有交流信息的内容。 讨论同一个问题时，优先在原帖补充结果。问题不同、环境差异足以改变判断时，可以另发帖子，并链接原来的讨论。",{"id":1360,"title":1361,"titles":1362,"content":1363,"level":632},"\u002Fpublishing\u002Fposts#解决关闭与更新日志","解决、关闭与更新日志",[18],"找到方案后，建议回复说明有效步骤、适用版本和剩余限制，让后来者也能复用。问题未解决但不再继续处理时，应说明原因，避免把“关闭”等同于“修好了”。 发帖人可以从账号菜单的“我的创作”或帖子详情的“编辑帖子”进入维护页面，修改正文、删除帖子，并将待解决问题标记为“已解决”或“已关闭”。终态不能重新打开。符合权限的资源维护者也可以通过修改帖子状态接口操作。普通讨论没有问题状态；回复也不能建立独立的求助状态。 资源维护者可以发布版本更新说明。系统中的更新日志身份由维护者身份和对具体发布记录的引用判定，标题写上“更新日志”不会自动获得该身份。当前发帖网页在关联资源后提供“关联发布记录”选择器，应核对具体构建；也可使用创建帖子 API提供相同引用。 关联资源失效后，已发布的帖子仍然保留。引用卡片会显示失效状态；不要以为删除资源会同时撤掉讨论中的说明。",{"id":1365,"title":1366,"titles":1367,"content":1368,"level":632},"\u002Fpublishing\u002Fposts#提交前检查","提交前检查",[18],"标题包含对象与主题，正文不是空话或重复内容。 求助写明环境、资源版本、复现步骤和已尝试的方法。 事实、推测和个人评价已区分，日志和截图足以核对。 关联了正确资源；没有把关联当作原作者身份的证明。 已清理个人信息、秘密和无关内容，引用材料有来源。 送审前已检查草稿；公开后再次核对排版、图片和链接。",{"id":23,"title":22,"titles":1370,"content":1371,"level":597},[],"介绍写一次，每次发布准确声明文件、兼容范围和依赖。 资源用于提供可被使用的作品或服务，例如模组、插件、皮肤、整合包、启动器和服务器。请让读者看完介绍后知道用途、获取方式、适用环境和已知限制。 不确定应发布资源、教程还是帖子时，先看资源定义与收录范围。本页说明怎样填写；资源审核要求说明发布者与管理人员共同核对的标准。",{"id":1373,"title":1374,"titles":1375,"content":1376,"level":632},"\u002Fpublishing\u002Fresources#创建资源前","创建资源前",[22],"先搜索名称、原始发布地址及常见译名，确认没有重复条目。自己的作品已经存在时，更新介绍或追加发布记录；不要为每个版本、每个加载器重复创建资源。 发布转载、翻译、分支或镜像前，先核对命名、署名与转载要求。账号是本站维护者，不会自动成为原作作者。 当前网页在主站 \u002Fresources\u002Fnew 发布资源，使用登录账号的身份。名称要求 2–60 个字符，简介 10–200 个字符，介绍至少 10 个字符。网页还要求至少选择一个“页面上要放什么”，并填完所选项目需要的数据。 需要上传封面、正文图片或发布文件时，先保存资源草稿，再选择本地文件。草稿可从“我的创作”找回；文件及发布记录保存完成后，再将资源发布。",{"id":1378,"title":1379,"titles":1380,"content":1381,"level":632},"\u002Fpublishing\u002Fresources#一份介绍服务所有版本","一份介绍服务所有版本",[22],"名称使用作品本来的名称。版本号放在发布记录中，不在资源名称里堆叠游戏版本、加载器、下载口号或“最新版”。没有公认中文译名时可以保留原名，在正文注明临时译名。 简介用一句话说明主要用途和适用对象。介绍应至少回答： 做什么： 主要功能、使用场景及不提供的功能。怎么用： 基本安装或接入步骤，客户端和服务端各需要做什么。要准备什么： 通用依赖、运行条件和重要配置。需要知道什么： 已知问题、实验性功能、数据迁移或其他限制。从哪里核实： 原始来源、作者、源码或文档，以及许可和转载说明。 可按以下结构填写，再根据作品删减： ## 功能与适用场景\n用于在小型生存服务器中显示玩家状态，支持自定义展示内容。\n\n## 基本用法\n先备份配置，在测试环境中按对应加载器的方式安装。\n首次启动后修改配置文件，再按项目文档中的方式使配置生效。\n\n## 运行条件与限制\n不同构建的加载器、游戏版本和前置要求见对应发布记录。\n尚未验证代理端环境；暂不提供跨服数据同步。\n\n## 作者、来源与许可\n原作者：填写实际作者或团队。\n原始发布页：填写可访问链接。\n本人维护的内容：填写原创、翻译、打包或镜像维护范围。\n许可或授权：填写对应版本的许可名称、链接及必要说明。\n\n## 反馈方式\n说明如何提交问题；在本站求助时附上版本和复现步骤。 截图应来自所介绍的实际内容；概念图、渲染图、使用额外光影的画面应注明。性能数据需要附带硬件、场景、设置和测量条件，不承诺所有用户都能达到同样帧率。 可以说明开发计划，但尚未完成的部分必须明确标记。提供下载时，文件应与介绍相符，并能按声明的条件获取和运行；不要用空文件、无效链接或未实现的功能充当已发布版本。",{"id":1383,"title":1384,"titles":1385,"content":1386,"level":632},"\u002Fpublishing\u002Fresources#标签填写内容特征","标签填写内容特征",[22],"标签可多选，也可以留空。按资源实际具有的玩法功能、视觉风格或画质特征填写，例如“科技”“优化”“写实”；多个特征可以同时成立，无须选出唯一的“主分类”。 当前网页使用逗号分隔标签文字，并在提交时匹配或创建标签。新词可能先处于未归类状态，尚未进入常规筛选项；不必反复创建近义标签。不要把 Fabric、Paper、Minecraft 1.20.1 等受控兼容值塞进开放标签中代替发布记录。",{"id":1388,"title":1389,"titles":1390,"content":1391,"level":632},"\u002Fpublishing\u002Fresources#一次发布对应准确的兼容组合","一次发布对应准确的兼容组合",[22],"有文件时，在创建资源时填写第一版；之后从该资源页面进入“发新版本”，沿用名称、介绍、截图和标签。 每一组“支持”都表示：这一组所选的每个加载器，都支持这一组所选的每个游戏版本。 只要存在某个组合不成立，就拆成不同组。 例如，作品 2.0 使用同一个文件，实际只支持以下两个组合： 支持组加载器游戏版本第一组Fabric1.20.1第二组Forge1.19.2 请填写两组，不要在一组中同时选择 Fabric、Forge 与 1.20.1、1.19.2，否则会声称 Fabric 支持 1.19.2、Forge 支持 1.20.1。 同一组中可以多选，但必须确认全部组合都成立。不要因为某加载器“通常兼容”就自动扩大范围；未经验证时，说明测试范围，不冒充已验证。 API 中对应的兼容部分如下；其他必填项见创建发布记录： {\n  \"versionNumber\": \"2.0\",\n  \"compat\": [\n    { \"loaders\": [\"fabric\"], \"mcVersions\": [\"1.20.1\"] },\n    { \"loaders\": [\"forge\"], \"mcVersions\": [\"1.19.2\"] }\n  ]\n} 一次提交中的各支持组共用这次填写的文件。不同加载器使用不同文件时，应分别提交对应构建，版本号可以相同，不要把两个文件一起声明为所有组合通用。加载器族由系统展示分组，不需要作者选择“资源唯一类型”。",{"id":1393,"title":1394,"titles":1395,"content":1396,"level":632},"\u002Fpublishing\u002Fresources#上传文件或填写外链","上传文件或填写外链",[22],"发布记录可包含多个文件；“发新版本”页面可添加文件并指定其中一个为主文件。每个文件选择“上传到本站”或“外部下载地址”，提交前逐项核对。 选择本站上传后，等待文件传输、服务器处理与校验全部完成，再提交发布记录。网页最多选择 512 MiB 的文件，实际站点可能设置更低上限；大文件自动分块。上传中可取消，失败后可重试。仅选择文件或传输进度达到 100%，都不代表发布记录已保存。 选择外链时，需填写下载地址、文件名、格式、大小（字节）和完整 SHA512（128 位十六进制）。本地计算校验值只读取文件信息，不会把外链文件上传；下载地址仍需与该文件一致。 优先使用能长期访问的版本文件地址。若下载需要登录、提取码、额外费用或特定启动器，提前写明；不要使用会指向不同版本文件的地址，却沿用旧的大小和校验值。SHA512 用于核对文件一致性，不能代替授权或安全说明。 文件内不应夹带账号资料、访问令牌、私人聊天、无关备份、日志和缓存。整合包应采用便于导入的导出格式或清楚说明目录结构，不把一份未整理的私人游戏目录直接作为成品。",{"id":1398,"title":1399,"titles":1400,"content":1401,"level":632},"\u002Fpublishing\u002Fresources#封面与正文图片","封面与正文图片",[22],"保存草稿后，或打开已有资源的编辑页，可以上传封面和正文图片。支持 PNG、JPEG、WebP 和 GIF；静态图片原图最多 20 MiB，GIF 和动态 WebP 原图最多 8 MiB。上传前可以旋转图片；本站受管图片会转换为 WebP，动画会保留。 正文图片上传成功后插入编辑器，仍需保存正文。请使用插入的本站图片地址，不复制下载跳转后的临时地址。头像可在账号设置中上传，按中心裁成正方形。",{"id":1403,"title":1404,"titles":1405,"content":1406,"level":632},"\u002Fpublishing\u002Fresources#前置可选联动与整合包含内容","前置、可选联动与整合包含内容",[22],"你要说明的事实应当怎样写不装另一个项目就无法正常使用写入“前置依赖”，注明适用范围及必要版本装上另一个项目才出现额外功能标记为“可选”依赖，并在说明中写明启用条件和作用某版整合包已经包含这些项目记录该次发布的“包含内容”，并核对再分发条件与某项目组合使用存在已知冲突标明涉及的版本、复现情况及已知处理方式 站内已有项目时优先引用它；站外项目填写可识别的名称和原始地址，不用含糊的“某前置”代替。新增的本站依赖选择器只绑定当前已公开的本站资源，不会根据外链地址暗中转换目标。项目之间的依赖或包含记录不代表转移作者身份或获取再分发授权。 创建页的本站“前置依赖”为整个资源共用，并按必需依赖提交。本站关联允许将通用或单条物理构建的依赖分别标记为必需、可选，并补充说明；只对部分构建生效的前置应绑定对应物理 ID，不能放进通用清单。版本号、文件相同的两条构建仍有各自的依赖；公开页面按实际加载器与游戏版本组合显示。通用依赖、单构建依赖和教程关联分别保存；旧引用有重复、未知角色或超过清单上限时，应先按原始 ID 逐条核对与整理，不要以当前分页覆盖完整清单。包含内容绑定创建时的发布记录；当前“发新版本”网页尚无包含清单编辑控件，后续每版清单需使用发布 API 维护，不能假定自动沿用。 整合包没有固定的模组数量或下载量门槛。请说明核心玩法、主要内容、安装方式、内存参考值和测试条件；逐项检查是否允许把第三方文件放入分发包。没有确认允许再分发时，提供项目来源和获取说明，不直接附上其文件。不要把 Minecraft 本体、第三方启动器、Java 或其他软件默认视为可随包分发的素材。",{"id":1408,"title":1409,"titles":1410,"content":1411,"level":632},"\u002Fpublishing\u002Fresources#关联教程与旧版说明","关联教程与旧版说明",[22],"资源可以引用本站已经独立发布的教程。教程先从主站 \u002Ftutorials\u002Fnew 创建，在 \u002Fmember\u002Ftutorials 单独管理，再到资源编辑页关联；解绑资源不会删除教程、章节或段落。资源文档在此只承担关联作用，不在资源编辑页创建或发布教程。旧版资源内 knowledge\u002Fprose 说明保留原值，不能自动视为独立教程。",{"id":1413,"title":1414,"titles":1415,"content":1416,"level":632},"\u002Fpublishing\u002Fresources#更新修正与撤回","更新、修正与撤回",[22],"更新时说明新增功能、修复问题、兼容变化、配置或存档迁移风险。资源通用介绍不必每版重写。针对某一版本的重要变化，保留版本号和日期，避免覆盖旧说明后让旧版用户无从判断。 从账号菜单进入“我的创作”，选择“编辑资源”，可以修改资源资料、标签和发布意图，并维护已有物理发布记录的说明、渠道、运行环境、兼容范围、文件、可见状态与发布时间。“发新版本”表单也可以选择正式版、Beta 或 Alpha 及运行环境；实验性构建不应被当作稳定版发布。 文件或兼容集合填错时，应在编辑页修正选中的物理记录，或撤回错误记录后发布正确构建；不要只修改正文，却继续保留错误的兼容声明。删除操作只删除选中的构建，同一批次其他构建仍在。资源被管理员处置期间，网页只开放发布记录的说明修正，不提供状态、文件和兼容调整；需要撤下或替换的错误记录应在复核材料中列明，公开状态由管理员恢复。 创建草稿、保存第一条发布记录和公开资源分步完成。中途失败时，先在当前页面重试，或从“我的创作”找回草稿，核对已有发布记录后继续，避免重复创建资源或发布记录。 资源删除后，独立帖子不会跟着消失，引用处会保留失效提示和必要的墓碑信息。本站无法替你删除站外托管的原文件；镜像维护者仍应处理自己控制的下载地址。 因缺失信息、文件争议或其他问题被处置时，请对照审核与处置规范修正具体问题。保存修改不会自动解除处置；需要复核时，按复核材料要求提供修改位置及依据。",{"id":1418,"title":1366,"titles":1419,"content":1420,"level":632},"\u002Fpublishing\u002Fresources#提交前检查",[22],"资源未重复创建；名称、简介和介绍能说明真实用途。 原作者、本人维护范围、来源及许可条件写清楚。 每一支持组的所有加载器和版本组合都成立。 下载文件与名称、大小、格式、SHA512 完全对应。 通用前置、版本差异、可选联动和包含内容没有混写。 整合包清单与本次发布一致，第三方素材的分发条件已核对。 已说明安装方法、运行环境、已知问题及重要数据风险。 发布后打开详情，检查文件、支持范围、图片、链接和实际展示。",{"id":27,"title":26,"titles":1422,"content":1423,"level":597},[],"让读者识别作品、原作者、维护范围和具体使用条件。 名称帮助用户找到同一个作品；署名和来源帮助用户判断内容由谁制作、哪里发生了修改，以及到哪里核实。",{"id":1425,"title":1426,"titles":1427,"content":1428,"level":632},"\u002Fpublishing\u002Fnaming-and-attribution#名称与译名","名称与译名",[26],"优先使用原作者采用的名称。已有官方中文名称或广泛使用的译名时，可采用中文名称，并在介绍中保留原名。没有确定译名时，保留原名；自行翻译的名称写明“暂译”，不要宣称是官方名称。缩写应能追溯到原名；不为了搜索流量堆叠无关作品名、加载器、版本号或“最强”等宣传词。分支、非官方移植、汉化补丁和二次打包应说明与原作的关系，不让读者误以为由原作者发布或支持。 本站资源使用一个名称字段，没有百科式“主要名称 \u002F 次要名称”表单。原名、译名、缩写和名称由来可以放在介绍中，不需要为了另一种语言重复创建资源。",{"id":1430,"title":1431,"titles":1432,"content":1433,"level":632},"\u002Fpublishing\u002Fnaming-and-attribution#署名至少说清四件事","署名至少说清四件事",[26],"项目应填写的信息原作者作品或被引用材料的作者、团队；多人贡献时说明角色原始来源官方发布页、源码仓库、原文或素材页面，尽量定位到所用版本你的工作原创、翻译、修改、打包、移植、资料整理或镜像维护的具体范围使用条件对应版本的许可名称及文本链接，或明确覆盖本次使用方式的授权说明 例如： 原作：Example Project，作者 Example Team。\n原始来源：填写原始发布页和所用版本链接。\n本文由本人整理，截图来自本人在所述版本中的测试。\n本人修改范围：补充中文说明，未修改原始程序。\n许可或授权：填写适用许可文本或授权依据，说明是否包含文件再分发。 只有确实由自己制作的部分才称为原创。“整理”“汉化”“适配”和“转载”不能抹去原作者；取得维护权也不等于取得所有素材的所有权。 资源所有者可以通过本站账号邀请共同作者，对方接受后共同维护资源资料与发布记录。公开页面展示的本站共同作者只说明当前维护关系，不证明其为原作品作者，也不替代转载、镜像或素材使用授权。邀请、移除或退出不会修改资源介绍中的原作者和来源说明。",{"id":1435,"title":1436,"titles":1437,"content":1438,"level":632},"\u002Fpublishing\u002Fnaming-and-attribution#发布文件镜像和整合包前","发布文件、镜像和整合包前",[26],"先核对所用版本的许可文本或授权说明，确认是否覆盖准备进行的复制、修改、翻译、再分发或收费方式，并遵守其中适用的署名、保留声明、源码提供等条件。不要仅凭“可以免费下载”“仓库可见”或“别人也在转发”推断许可范围。 当前网页没有独立的许可证选择器，也不会自动核验授权。请在资源介绍中写清依据并保留必要记录。授权材料涉及真实姓名、邮箱、订单或私人聊天时，只公开核实所必需的信息，并先处理敏感内容。 镜像和整合包还应注意： 镜像明确写出原始地址、上游版本、同步日期及是否修改，不冒充官方发布。修改版区分上游变化与自己的变化，记录新增文件、配置、补丁和素材的来源。整合包逐项检查所包含的项目和素材；整合包自己的许可说明不能自动替代其中各项内容的使用条件。第三方程序、游戏文件、启动器、运行环境和美术素材分别核对，不因它们能在本地运行就默认允许随包分发。无法确认文件再分发条件时，先提供原始获取页与安装说明，不上传或镜像该文件。",{"id":1440,"title":1441,"titles":1442,"content":1443,"level":632},"\u002Fpublishing\u002Fnaming-and-attribution#引用文字图片和资料","引用文字、图片和资料",[26],"引用要服务于自己的说明，清楚标出来自哪里、引用的是哪一部分，以及自己补充了什么。不要把整篇文章或整套图片复制过来，仅在末尾补一个来源地址。 截图、译文、图标、封面和演示视频同样需要检查来源及适用条件。用作者的图不等于获得作者认可；作者允许引用一句说明，也不自动表示允许重新分发程序文件。 指向站内资源时使用其现有地址。需要通过 API 引用具体发布记录、教程章节或段落时，使用平台提供的稳定标识，不以当前排列的“第几个”作为长期定位依据。教程有独立创建、阅读和编辑入口，资源共同维护不改变教程作者或编辑权限。",{"id":1445,"title":1446,"titles":1447,"content":1448,"level":632},"\u002Fpublishing\u002Fnaming-and-attribution#出现争议时","出现争议时",[26],"核对具体材料：内容地址、涉及版本、原始来源、许可文本或授权范围，以及争议部分。请按这些事实更正署名、移除争议材料或停止提供相关文件，不通过辱骂、公开私人信息或发动围攻处理分歧。 需要向管理员说明时，按举报、版权投诉与复核提供具体地址、涉及版本、权利依据和可联系的方式；材料中有敏感信息时使用管理渠道，不公开完整私人记录。 本页是发布内容的整理要求，不替具体许可、授权约定或争议情形作统一结论。没有另行填写许可，不表示作品自动获得某一种默认许可证；在本站公开也不表示他人可以任意修改、镜像或收费再分发。",{"id":31,"title":30,"titles":1450,"content":1451,"level":597},[],"发布者自查与内容核查共用的资源真实性、兼容性、来源和风险说明标准。 本页是资源的内容核查标准，供发布者自查，也供核查人员说明具体问题。资源是否适合收录，先看资源定义与收录范围；表单操作见资源发布规范。 资源首次发布和实质修改需要提交发布审核，通过后才更新公开内容。可编辑草稿、送审时冻结的版本和当前公开版分别保存；审核期间可以继续修改草稿，明确重新提交后才会替换正在审核的版本，旧公开版在新版本通过前保持不变。 只有符合已启用低风险自动批准条件、且结果完整的审核才可自动通过；其他情况由有权限的审核人员处理。通过审核、能够公开访问或曾被核查，都不代表获得官方安全认证，也不代表平台已经逐一验证全部文件、环境与授权材料。 核查应针对具体事实和下列条款。下载量、篇幅、项目规模和是否开源不能代替判断；闭源不等于侵权，开源也不等于可以任意分发。收费或商业使用还需核对许可与适用服务规则，本页不授予收费许可，也不表示本站提供交易功能。",{"id":1453,"title":1454,"titles":1455,"content":1456,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r1对象真实身份可识别且未重复建档","R1：对象真实、身份可识别且未重复建档",[30],"发布者须说明： 作品或服务的名称、用途、实际可用内容及获取或使用入口。已有同一作品时，在原资源维护；独立分支写明实质差异与维护关系。核查依据与问题例： 对照页面、原始来源和已有条目，确认它们是否指向同一个作品。只有群号、没有可识别对象，或为同一作品的译名、版本、加载器、镜像重复建档，应指出缺失信息或重复依据；不能仅因名称相近就认定重复。",{"id":1458,"title":1459,"titles":1460,"content":1461,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r2介绍足以帮助用户开始使用","R2：介绍足以帮助用户开始使用",[30],"发布者须说明： 核心功能、适用场景、基本安装或接入步骤、必要环境、已实现范围和主要限制。外部文档可以补充细节，但资源页面自身要能说明基本用途和使用条件。核查依据与问题例： 检查读者能否判断“它做什么、我能否使用、从哪里开始”。只有宣传图片、空泛口号或“加群后再说”，不能替代这些信息；不按固定篇幅要求作者扩写无关内容。",{"id":1463,"title":1464,"titles":1465,"content":1466,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r3署名来源与使用依据清楚","R3：署名、来源与使用依据清楚",[30],"发布者须说明： 原作者、原始发布地址、自己的维护或修改范围，以及对应版本允许本次使用方式的许可或授权依据。整合包、镜像及美术素材应分别核对第三方内容。核查依据与问题例： 对照所用版本的许可文本、来源页面或必要的授权材料，确认复制、修改、翻译、再分发和收费等实际行为是否有依据。“开源”“免费下载”“仓库可见”都不等于可以无条件转载；闭源也不等于没有授权。存疑时指出具体材料和行为，不凭空作统一结论。署名写法见命名、署名与转载。",{"id":1468,"title":1469,"titles":1470,"content":1471,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r4兼容声明与依赖对应实际构建","R4：兼容声明与依赖对应实际构建",[30],"发布者须说明： 每条发布记录适用的加载器、游戏版本、运行环境及必要依赖，区分通用前置、版本差异、可选联动和已知冲突。未验证的环境明确注明。核查依据与问题例： 将文件、项目文档和测试说明与对应记录核对。用户指定的加载器和版本必须由同一条发布记录同时满足，不能把记录 A 的加载器与记录 B 的版本拼接。一个支持组内的所有加载器与版本组合都应成立；不同文件分别声明，不能笼统标成全环境通用。",{"id":1473,"title":1474,"titles":1475,"content":1476,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r5文件外链与校验信息准确对应","R5：文件、外链与校验信息准确对应",[30],"发布者须说明： 实际交付文件、文件名、格式、大小、版本及要求填写的校验值；外链对应哪个文件、是否修改过上游内容。使用稳定的版本地址，文件变化后同步更新说明与记录。核查依据与问题例： 核对链接目标和页面声明是否一致，是否存在失效地址、空文件、伪装扩展名、替换成另一版本却保留旧校验值等情况。SHA512 只能用于核对文件一致性，不能证明来源合法或文件安全。核查不以执行未知文件为前提。",{"id":1478,"title":1479,"titles":1480,"content":1481,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r6获取与使用条件提前披露","R6：获取与使用条件提前披露",[30],"发布者须说明： 登录、提取码、特定启动器、地区或账号限制，以及付费项目、收费范围和免费部分的限制。服务器或在线服务说明实际接入条件与必要规则。核查依据与问题例： 对照页面介绍与实际获取路径，检查关键条件是否在用户下载、注册或付款前可见。声称免费却在获取最后一步强制付费、隐藏必须加群的步骤、将演示内容写成全部交付内容，均应指出。披露收费条件不能替代对许可与适用服务规则的核对。",{"id":1483,"title":1484,"titles":1485,"content":1486,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r7安全相关行为有明确说明","R7：安全相关行为有明确说明",[30],"发布者须说明： 资源是否联网、收集或发送遥测、自动下载或更新代码、要求较高系统权限，以及这些行为的用途、涉及范围和可配置方式。需要改动文件、账户、世界存档或服务器数据时，说明重要影响与备份要求。核查依据与问题例： 对照公开文档、配置说明、可核实报告和作者提供的材料，确认行为是否与介绍一致。隐瞒信息窃取、后门、破坏性行为或不必要的权限要求，不能用“自行承担风险”代替说明。本标准不承诺平台自动扫描或自动识别全部危险行为。",{"id":1488,"title":1489,"titles":1490,"content":1491,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r8图片效果与性能结论有依据","R8：图片、效果与性能结论有依据",[30],"发布者须说明： 截图对应的版本与环境；概念图、渲染图、额外光影或后期处理应标明。性能或兼容结论提供测试场景、硬件、设置、方法和适用范围。核查依据与问题例： 检查展示是否来自所述作品，是否把其他项目的画面、尚未实现的设计或特定条件下的结果当作普遍效果。不能仅凭一张帧率截图宣称所有设备提升相同比例；也不要求每个小作品提供与其功能无关的性能测试。",{"id":1493,"title":1494,"titles":1495,"content":1496,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#r9版本风险与维护状态如实保留","R9：版本风险与维护状态如实保留",[30],"发布者须说明： 版本变化、实验性状态、已知故障、配置或存档迁移风险，以及影响使用的停止维护、服务中止或上游变化。旧版本仍有用户时，保留可判断其风险的说明。核查依据与问题例： 对照更新说明、发布日期、上游公告及可核实的问题反馈，确认没有把未完成版本写成稳定成品，或在发现重要风险后继续沿用相反承诺。暂停维护不自动等于违规，但不能继续承诺实际上已不提供的服务或支持。",{"id":1498,"title":1499,"titles":1500,"content":1501,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#按交付方式补充必要信息","按交付方式补充必要信息",[30],"下表根据实际交付内容补充要求，可以同时适用多行，不要求发布者选择一个唯一分类。 交付方式需要补充的信息程序、代码库、模组、插件或启动器安装或构建入口，客户端与服务端要求，运行环境和前置，必要配置，联网、更新与权限行为，重要数据改动整合包、配置包或服务端方案本次发布的包含内容，导入方式、目录结构、核心用途、内存参考值与测试条件，第三方文件的分发依据；移除账号、令牌、个人存档和无关缓存皮肤、材质、光影、地图或模型实际预览，格式与分辨率等必要参数，适用版本或工具，导入方式，依赖和第三方素材来源；地图涉及存档替换时提示备份服务器或在线服务可使用的入口、接入步骤、适用客户端或协议环境、必要规则，注册和付费条件，涉及的数据收集及服务限制；不把群人数或宣传截图当作可接入证明 不设置最低下载量、流量、内容数量或项目规模门槛，也不要求所有资源开源。需要多少说明取决于使用者能否作出准确判断。",{"id":1503,"title":1504,"titles":1505,"content":1506,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#三个判断示例","三个判断示例",[30],"情形信息不足或错误的写法可以核查的写法兼容范围“Fabric、Forge，支持 1.20.1、1.19.2”，实际只有两个特定组合分别声明 Fabric 1.20.1 和 Forge 1.19.2 的对应构建，写明各自文件与依赖；不声称存在 Fabric 1.19.2 构建服务器介绍“长期稳定，进群了解”，只有一个群号写明服务名称、玩法、接入地址或入口、支持环境、必要规则和费用条件，群聊仅作为补充联系方式文件转载“网上开源的，侵删”，未列来源或许可标明原作者、原始版本与地址，列出适用许可或授权依据，并按其条件保留声明；无法确认再分发条件时只提供原始获取页",{"id":1508,"title":1509,"titles":1510,"content":1511,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#发现问题后的核查边界","发现问题后的核查边界",[30],"一般信息问题应说明对应条款、涉及版本、可核实事实和需要补充或更正的内容。核查人员不要求作者执行与问题无关的任务，也不将个人偏好写成统一准入条件。 发现疑似窃取凭据、后门、破坏数据等高风险线索时，应先停止相关文件的继续分发，并交由管理员处理。发布者应保留涉及版本、来源与必要材料；核查人员不得为验证而直接执行未知文件，也不要在公开讨论中传播可用于攻击的细节、敏感数据或危险载荷。 内容的下架、移除、修正与恢复按内容处置说明处理；提交线索或对处置有异议时，按举报与申诉提供材料。发布审核进度与反馈可在主站 \u002Fmember\u002Fpublications 查看。本页不承诺固定处理时限或自动恢复安排。",{"id":1513,"title":1514,"titles":1515,"content":1516,"level":632},"\u002Fpublishing\u002Fresource-review-requirements#发布与核查清单","发布与核查清单",[30],"对象真实可识别，没有为同一作品的译名、版本、加载器或镜像重复建档。 介绍说明用途、使用步骤、必要环境与已实现范围。 原作者、来源、维护关系及对应使用方式的许可或授权依据清楚。 每条发布记录的兼容组合、文件、依赖和冲突说明相互对应。 下载外链、文件信息与校验值准确，获取和收费条件提前披露。 联网、遥测、自更新、权限及重要数据风险已说明。 图片、效果与性能结论有对应版本、环境或材料可核查。 已知问题、实验性状态和维护变化已如实更新；高风险线索已交管理员处理。",{"id":35,"title":34,"titles":1518,"content":1519,"level":597},[],"按证据核查资源，说明问题与整改方式，区分内容处置、举报结论和恢复。 本页供参与内容核查的管理人员使用，也让发布者了解处理依据。核查可以来自日常检查、用户举报或整改后的复核，统一采用资源审核要求。 内容首次发布和实质修改需要发布审核。本页同时说明送审前后的核查原则，以及已经公开内容的下架、整改和恢复；通过审核不表示获得安全认证，也不表示每个文件均经平台测试。",{"id":1521,"title":1522,"titles":1523,"content":1524,"level":632},"\u002Fpublishing\u002Fmoderation#发布审核与三个版本","发布审核与三个版本",[34],"作者保存的是可继续编辑的草稿；提交审核时，系统冻结当次送审内容；读者看到的是已经通过审核的公开版。审核期间保存新草稿不会修改冻结版本，也不会替换旧公开版。作者需要明确重新提交并确认替换，才会让新草稿进入新一轮审核。首次资源发布涉及同一批次的资源与发布记录时，需整批通过后才公开。 只有已启用的低风险自动批准条件全部满足、审核结果完整时，才可自动通过。其余情况进入人工审核，包括结果不足、执行失败或不符合自动批准条件的情况。人工审核人员先领取任务，核对冻结内容和证据，再作出批准、要求修改或拒绝的决定；不能审核自己的内容。 要求修改或拒绝后，作者可以依据反馈修改草稿并重新提交。公开基线已经变化时，应先比较差异，按页面要求确认后继续，不能把过期审核结果直接覆盖到新的公开内容。作者可在主站 \u002Fmember\u002Fpublications 查看自己的记录与反馈。",{"id":1526,"title":1527,"titles":1528,"content":1529,"level":632},"\u002Fpublishing\u002Fmoderation#核查应遵循的原则","核查应遵循的原则",[34],"同一事实适用同一要求。 不以作品规模、下载量、作者知名度、是否开源或个人审美代替判断。闭源、预览版本和小型作品也可以提供充分的使用信息。结论对应证据。 区分能够复现的问题、上游明确说明、发布者声明与尚未证实的推测。缺乏证据不等于已经证明违规。明确影响范围。 问题在某条发布记录、某个文件或某段介绍时，应指出具体位置，不把一个版本的问题写成所有版本均有问题。选择与风险相称的操作。 能通过补充说明解决的问题，先说明缺什么；涉及凭据窃取、恶意执行、隐私暴露等风险时，优先限制继续传播，再核实完整事实。保留更正与复核的机会。 说明整改方式，核对发布者的补充材料；处置错误时应纠正，不以维护原结论为目的寻找理由。回避利益冲突。 核查涉及自己的作品、团队或直接争议时，应交由其他管理员复核，不利用管理权限处理竞争关系。 发布审核由具备相应权限并完成二次验证的管理员或版务人员处理；其他后台处置仍按各自权限控制。协助测试或提供证据，不等于获得处置权限。",{"id":1531,"title":1532,"titles":1533,"content":1534,"level":632},"\u002Fpublishing\u002Fmoderation#核查顺序","核查顺序",[34],"",{"id":1536,"title":1537,"titles":1538,"content":1539,"level":655},"\u002Fpublishing\u002Fmoderation#_1-确定对象与版本","1. 确定对象与版本",[34,1532],"记录资源地址、涉及的发布记录、版本号、文件名、必要的校验值及核查时间。外链可能变化，应分清“提交时的文件”和“目前下载到的文件”。相似名称不是重复作品的充分证据，先比对原始来源、作者与维护关系。 资源定义有疑问时，先对照资源定义与收录范围。介绍不完整、字段格式错误和内容本身不适合公开，是不同问题，不能只用“质量不合格”概括。",{"id":1541,"title":1542,"titles":1543,"content":1544,"level":655},"\u002Fpublishing\u002Fmoderation#_2-对照要求核实","2. 对照要求核实",[34,1532],"按审核要求中的条目核对身份与来源、介绍、许可、兼容、文件、行为与风险说明。兼容性必须在同一条发布记录内成立，不能从不同记录拼出支持结论。 程序测试应在隔离环境进行。不要在个人日常设备或生产服务器直接运行未知文件，也不要把来源不明的文件交给其他用户“试试看”。扫描结果、开源地址和文件校验值都可以作为线索，不能单独证明安全或授权。 怀疑文件窃取凭据或包含其他高风险行为时，保留必要证据并交管理员处理。不要在公开说明中复述可用令牌、私人资料或可直接利用的危险细节。",{"id":1546,"title":1547,"titles":1548,"content":1549,"level":655},"\u002Fpublishing\u002Fmoderation#_3-给出可以执行的说明","3. 给出可以执行的说明",[34,1532],"处置说明至少包含：对应条目、具体事实、涉及范围和修正方式。证据不能公开时，描述核查结论及可提交的反证，不公开敏感原件。 不合适的说明：“资源不规范，自己看规则。” 可采用的说明： 对照 R4“兼容与依赖”：2.0 版的同一支持组声明 Fabric、Forge 均支持 1.20.1，但所附文件及上游说明只覆盖 Fabric。请撤下错误记录，分别提供真实构建与兼容范围；如认为声明正确，请补充对应版本的测试依据。当前处置范围为该资源，复核时会逐项核对受影响记录。 无法确认时，应说明尚缺哪项材料，不以猜测、重复举报数量或当事人的态度代替证据。",{"id":1551,"title":1552,"titles":1553,"content":1554,"level":632},"\u002Fpublishing\u002Fmoderation#处理方式与实际含义","处理方式与实际含义",[34],"情形处理方式需要注意已有信息满足要求，或举报依据不足保留内容；对举报记录填写核查结论“未发现问题”只覆盖本次核查范围，不是对作品的全面认证来源、安装步骤或限制说明缺漏，可通过修正解决向发布者说明需补充的具体信息；必要时按风险下架公开后整改按处置记录说明要求；发布审核中的“要求修改”则对应该轮审核结果继续公开会误导下载或传播争议、危险材料下架或移除，并填写原因两者都是可恢复的内容处置；不等同于删除实体问题已解决，或原处置有误复核后由管理员恢复恢复原先的草稿或发布意图，不一律变为公开确需删除内容实体使用删除操作，说明理由与范围删除不可按普通恢复处理，不能拿来代替临时下架 当前后台的资源处置作用于整份资源。核查说明仍须指出出问题的具体版本。资源未受平台处置时，维护者可以通过编辑页调整单条发布记录的说明与可见状态；处置期间，网页的发布记录编辑只开放说明修正，不能调整记录状态和发布时间。处置期间文件与兼容集合也不能直接修改，应在复核材料中列明错误记录及所需更正。站内处置不能替代撤下由发布者控制的站外文件。 内容处置与举报结论分别保存。 把举报标为已处理不会自动下架内容；驳回举报不会自动恢复内容。需要采取操作时，先完成对应内容处置，再说明举报处理结果。",{"id":1556,"title":1557,"titles":1558,"content":1559,"level":632},"\u002Fpublishing\u002Fmoderation#整改后的复核与恢复","整改后的复核与恢复",[34],"发布者可以修正介绍、补充来源与授权依据，并按举报、版权投诉与复核说明已完成的修改。仍需撤下或替换的错误发布记录，应一并列明，供管理员复核处置范围和后续更正方式。 管理员应逐项核对原处置原因是否消除，核实新材料是否对应同一作品和版本。不要仅因正文多了一句“已修复”就恢复，也不要要求与原问题无关的材料。 被处置内容的公开状态由管理员恢复。作者保存修改、再次设置发布意图或另发一条版本，不会自动解除处置；不得引导作者通过换账号或重建资源绕过处理。 处置和恢复都应填写具体理由，保留操作记录。举报终态保留首次处理人、时间和说明，不能通过覆盖旧结论来抹去先前处理过程。当前没有独立申诉队列，也不承诺固定复核时限。",{"id":1561,"title":1562,"titles":1563,"content":1564,"level":632},"\u002Fpublishing\u002Fmoderation#删除与独立讨论","删除与独立讨论",[34],"下架、移除只改变内容的公开状态，不据此宣称文件已经物理销毁。实体删除后的文件处理遵循引用和回收规则；涉及站外文件时，还需要处理实际托管地址。 删除资源不会连带删除独立帖子。曾公开的可信引用可保留资源名称、简介、封面及失效提示，不能再跳转下载；不能借墓碑公开原本私有的草稿或授权材料。教程的章节与段落定位也不能因处置而重新编号。 独立讨论中的辱骂、隐私泄露或危险附件需要分别核查。资源存在争议，不代表所有相关讨论都应删除；资源恢复，也不会自动撤销对其他内容作出的处置。",{"id":39,"title":38,"titles":1566,"content":1567,"level":597},[],"提供可核实的问题与权利依据，了解举报入口、补充材料和处置复核方式。 发现虚假兼容、错误文件、冒充作者、侵权转载、恶意行为或隐私泄露时，请提供具体位置和可核实的依据。对作品的难度、风格或功能取舍不满意，可以正常评价；仅有个人偏好差异不构成违规证据。",{"id":1569,"title":1570,"titles":1571,"content":1572,"level":632},"\u002Fpublishing\u002Freports-and-appeals#从哪里提交","从哪里提交",[38],"主站的帖子、回复和资源页面提供“举报”入口。登录后填写问题说明，尽量一次写清位置、版本、事实及证据链接。说明最多 1000 个字符；材料较多时，先提交关键事实和必要链接，不要拆成多条重复举报。 同一账号重复举报同一内容时，会保留已有待处理记录。提交不等于平台认可举报结论，也不会自动下架内容。不要反复提交或组织他人集中举报来代替补充证据。 内容已经无法访问、材料不适合公开，或需要申请处置复核时，可以使用 NexusMC 现有政策公布的联系渠道： 用途联系渠道公布来源内容举报、版权投诉report@nexusmc.cn旧站版权处理说明对处置提出异议、一般咨询contact@nexusmc.cn旧站社区规范 以上为旧站现有政策公布的渠道，不是新站的申诉工单入口。当前没有独立申诉页面或自动复核队列；本指南也不承诺固定处理或邮件回复时限。",{"id":1574,"title":1575,"titles":1576,"content":1577,"level":632},"\u002Fpublishing\u002Freports-and-appeals#一份有用的举报应包含什么","一份有用的举报应包含什么",[38],"具体对象： 完整站内地址；涉及某次发布时，补充版本号、发布日期或记录标识。出现的问题： 哪段说明、哪个文件或哪个行为与事实不符，可对照资源审核要求中的条目。核实依据： 原始发布页、许可文本、可复现步骤、必要截图或日志；注明核查日期和环境。影响范围： 哪些版本、加载器或用户场景受到影响，哪些尚未验证。希望更正的内容： 例如补全署名、修正兼容说明、停止提供争议文件；不要求公开他人个人资料。 例如：“资源 2.0 的支持组标为 Paper \u002F 1.20.1，实际下载文件内只有 Fabric 元数据。原始发布页列出的同名版本也只支持 Fabric，链接及核查日期如下。”比“这个作者在骗人”更便于处理。 日志、截图和授权记录应去除密码、访问令牌、私人聊天及无关个人信息。怀疑文件有窃取凭据或破坏行为时，不要在公开帖子附上危险文件或传播可直接利用的细节，应通过管理渠道说明。",{"id":1579,"title":1580,"titles":1581,"content":1582,"level":632},"\u002Fpublishing\u002Freports-and-appeals#版权投诉需要补充的材料","版权投诉需要补充的材料",[38],"权利人或其授权代理人提出投诉时，请说明： 原作品及其可核对的来源，涉及的版本、文件或具体文字、图片。自己与作品的权利关系；代理投诉时说明代理范围并提供必要依据。被投诉内容的准确地址，以及涉嫌超出许可或授权范围的具体使用方式。对应版本的许可文本、授权约定或其他权利依据，并指出与实际使用的差异。希望采取的措施及可回复的联系方式，确认材料按自己所知真实、准确。 不要仅以“这是我的”“没有找我单独授权”代替具体依据；已有公开许可时，需要一起核对其适用版本和条件。来源、署名和再分发是不同问题，补一个原链接不一定能解决文件分发争议。 提交核实所必需的材料即可，不要求在公开页面上传身份证件、完整私人对话或无关订单。发布者也可以提交许可、授权记录、独立创作或事实更正材料供复核。具体争议按适用规则和材料处理，不套用另一站点的固定处罚次数或期限。",{"id":1584,"title":1585,"titles":1586,"content":1587,"level":632},"\u002Fpublishing\u002Freports-and-appeals#提交后如何处理","提交后如何处理",[38],"管理员按审核与处置规范核对对象和证据，必要时要求补充说明，或先限制有风险内容继续公开。举报结论与内容处置是两个操作：举报被处理不等于内容已删除；举报被驳回，也不等于平台对资源作了全面安全认证。 不确定、无法复现或善意误报，应与伪造证据、恶意骚扰区分。存在争议时继续围绕材料说明，不公开私人身份、不围攻当事人，也不要以删除批评作为解决资源问题的条件。",{"id":1589,"title":1590,"titles":1591,"content":1592,"level":632},"\u002Fpublishing\u002Freports-and-appeals#对处置有异议时","对处置有异议时",[38],"请由相关发布者或有权代表其说明情况的人提出复核，附上： 被处置内容地址、已知的处置时间和原因。对哪些事实或规则适用有异议，以及相应证据。已完成的修改，具体到段落、发布记录或文件。希望复核的结论及可联系的方式。 先修正能够确认的问题，再解释存在分歧的部分。不要通过另建同名资源、换账号或重复发布绕过处置。 管理员复核后，确需纠正的内容通过现有恢复等操作处理，并保留说明。恢复保持原来的草稿或发布意图；已经墓碑删除的实体不能按普通下架恢复。当前没有自动重提、申诉进度查询或必然恢复的承诺。",{"id":1594,"title":1595,"titles":1596,"content":1597,"level":632},"\u002Fpublishing\u002Freports-and-appeals#与其他政策的关系","与其他政策的关系",[38],"本栏目说明新站的内容发布和核查要求。旧站的服务条款、内容发布协议、社区规范与版权处理说明仍可查阅原文，其中涉及的旧站账号、交易和处罚流程应按对应服务辨别。 旧站的隐私政策与Cookie 政策描述其对应服务，不能用来推断新站实际使用的统计工具、数据存储或保留期限。资源发布与核查指南也不代替服务条款、隐私政策或作品自己的许可条件。",{"id":7,"title":11,"titles":1599,"content":1600,"level":597},[],"了解资源的定义、发布要求、审核依据，以及举报和整改复核方式。 发布前，先确定读者需要做什么：参与交流，阅读一份完整知识，还是下载或使用一个作品。 你准备分享的内容发布方式继续阅读讨论、使用体验、问题反馈、求助帖子帖子发布规范模组、插件、整合包、皮肤、服务器等作品或服务资源；有文件时附加发布记录资源发布规范有目录、章节和长期维护需求的系统知识教程当前网页尚未提供教程发布入口；不要为获得目录而把教程包装成下载资源 资源简介回答“它能做什么”；发布记录回答“这一版在什么环境下可以用”。与资源有关的交流可以关联现有资源，不必为提一个问题再创建资源。",{"id":1602,"title":1603,"titles":1604,"content":1605,"level":632},"\u002Fpublishing#按你要做的事情阅读","按你要做的事情阅读",[11],"你想了解什么阅读页面什么算资源，何时新建资源、何时更新版本资源定义与收录范围如何填写介绍、兼容范围、文件和依赖资源发布规范发布前需要满足哪些要求，会核查哪些材料资源审核要求如何命名，怎样说明原创、转载、分支和授权命名、署名与转载管理人员如何核实问题、说明原因和恢复内容审核与处置规范如何举报、提交版权材料或对处置提出异议举报、版权投诉与复核如何交流、求助和提供复现材料帖子发布规范 第一次发布资源，建议依次阅读“资源定义 → 资源发布规范 → 资源审核要求”。核查内容时，使用同一份审核要求，并按处置规范记录事实与理由。",{"id":1607,"title":1608,"titles":1609,"content":1610,"level":632},"\u002Fpublishing#发布前的共同要求","发布前的共同要求",[11],"登录并验证邮箱，确认页面显示的发布身份。账号受到发布限制时，应先处理账号提示。搜索已有内容。相同问题优先补充已有帖子；自己的作品更新时追加发布记录。把事实、体验和计划分别写清楚。未测试的兼容性、尚未实现的功能、未经确认的问题原因都要注明。给出足够的使用信息，并标明原作者、原始来源和适用的使用条件。检查链接、图片、文件信息和正文排版；删除密码、令牌、个人信息及无关的本地路径。",{"id":1612,"title":1613,"titles":1614,"content":1615,"level":632},"\u002Fpublishing#内容应当让读者能够判断","内容应当让读者能够判断",[11],"可以提出批评、比较方案，也可以发布规模较小的作品。请描述具体行为、适用条件和证据，不以辱骂、冒充身份、泄露隐私或没有依据的指控代替说明。 不得通过刷屏、重复发布、无关推广、恶意占屏等方式妨碍阅读；不得提供恶意程序、窃取信息的代码，或隐瞒已知后门和危险行为。分享转载文件、截图和文字前，请先按命名、署名与转载核对来源及许可条件。 与资源使用有关的官网、源码、问题反馈或社区链接可以提供；不要让读者必须先加群、付款或交出无关个人信息才能知道资源的基本用途、适用版本及获取条件。若获取或使用有额外条件，应在介绍中提前说明。",{"id":1617,"title":1618,"titles":1619,"content":1620,"level":632},"\u002Fpublishing#发布之后","发布之后",[11],"当前帖子和资源沿用现有发布方式，没有统一的“先送审再公开”步骤。指南说明内容要求，不代表平台已经逐一验证文件安全、兼容性或授权材料。 发现信息有误后，应及时更正说明；重复发布新内容不能替代修正原有错误。管理员可以根据具体情况处置已发布内容。被处置的内容应按具体原因修正，不要换账号、换链接或重复发布来绕过处置。 帖子、回复和资源页面提供“举报”入口。登录后填写具体问题和能够核实的依据，不要公开当事人的敏感信息。同一账号重复举报同一内容时，会保留已有待处理记录。材料准备与复核渠道见举报、版权投诉与复核；本指南不承诺固定的处理时限、处罚次数或自动恢复。",{"id":1622,"title":1623,"titles":1624,"content":1625,"level":632},"\u002Fpublishing#当前入口范围","当前入口范围",[11],"主站已有发帖页 \u002Fposts\u002Fnew、资源发布页 \u002Fresources\u002Fnew，以及资源下的“发新版本”页。账号菜单中的“我的创作”提供本人帖子和所维护资源的入口，包括资源草稿；可进入编辑页修正介绍、维护发布记录或处理自己的问题状态。下文中的这些路径指主站，不是文档站。 网页暂未覆盖全部编辑和管理操作。需要通过 API 管理自己的内容时，可阅读个人令牌指南和个人 API；API 同样校验账号状态、发布权限和资源维护者身份。",{"id":49,"title":48,"titles":1627,"content":1628,"level":597},[],"从反馈、文档、测试到代码，了解如何为 NexusMC 选择合适的贡献入口。 NexusMC 的公开项目可能接受社区贡献，是否接受外部改动、如何评审以及何时合并，以对应仓库的维护者和项目设置为准。你不需要先成为某个项目的维护者，也不需要只提交代码：清楚的复现步骤、文档修正、翻译、测试反馈和对设计的具体意见，同样能帮助项目继续前进。",{"id":1630,"title":1631,"titles":1632,"content":1633,"level":632},"\u002Fcontributing\u002Fgetting-started#先选择贡献方式","先选择贡献方式",[48],"你想做什么建议入口报告一个可以复现的问题到对应 GitHub 仓库的 Issues 搜索已有问题，再新建 Issue建议新功能或较大的改动先在仓库的 Issue 说明目标和使用场景；仓库开放 Discussion 时也可使用它修正文档、示例或翻译找到对应仓库，阅读 README 和贡献说明后提交小范围 PR改进 npm 包从包对应的 GitHub 仓库开始，先确认 API、兼容范围和测试命令参与服务端软件先了解本地依赖、数据存储、配置和部署方式，再从独立问题开始不确定应该找哪里查看 NexusMC GitHub 组织，或在相关仓库中询问维护者 项目的技术栈、分支命名、测试命令和发布节奏可能不同。组织页是项目入口，具体仓库已有的 README、LICENSE、CONTRIBUTING 和 Issue 模板才是该项目的直接约定；这些文件并非每个仓库都提供。",{"id":1635,"title":1636,"titles":1637,"content":1638,"level":632},"\u002Fcontributing\u002Fgetting-started#开始之前","开始之前",[48],"先搜索 Issue、Discussion 和近期变更，确认问题没有被解决，也避免重复实现。对新功能、架构调整和明显影响用户界面的改动，先开一个 Issue；仓库开放 Discussion 时，也可以先在那里说明要解决的问题、受影响的使用场景和可接受的方案。先把工作范围缩小到一个可审查的结果。修复一个问题、补充一组测试或完善一页文档，通常比一次重写整个模块更容易合并。阅读目标仓库的安装、开发和测试说明。不要根据另一个 NexusMC 项目的命令猜测当前项目的流程。检查仓库是否提供 LICENSE，以及第三方依赖的许可条件。没有明确许可证时，不要把公开可见误认为可以自由复制、修改或再分发；提交代码、图片、字体、示例数据或转载内容时，要有权将它们放入对应仓库。",{"id":1640,"title":1641,"titles":1642,"content":1643,"level":632},"\u002Fcontributing\u002Fgetting-started#提交一个好的-issue","提交一个好的 Issue",[48],"Issue 应该让维护者能够判断问题是否真实、影响什么，以及如何开始验证。至少提供： 使用的项目、版本、操作系统和运行环境；触发问题的最小步骤，以及实际结果和预期结果；相关日志、请求或配置的必要片段；是否能稳定复现，以及临时绕过方法；不要公开令牌、密码、邮箱地址、私有 URL 或其他敏感信息。 安全问题和可能暴露用户数据的问题，不要把利用步骤直接贴在公开 Issue 中。先查看对应仓库是否提供安全说明；没有私密入口时，联系仓库列出的维护者或 NexusMC 公开联系邮箱，并只提供最小的复现材料。",{"id":1645,"title":1646,"titles":1647,"content":1648,"level":632},"\u002Fcontributing\u002Fgetting-started#提交一个好的-pull-request","提交一个好的 Pull Request",[48],"提交 PR 前，先确认目标仓库允许外部贡献，并在自己的分支中保持改动集中。PR 描述应说明： 改动解决了什么问题；采用了什么行为和边界；如何验证，包括运行过的测试、构建或手工检查；是否有兼容性、迁移、文档或发布说明需要同步；如果关联已有 Issue，请附上链接。 代码、文档和配置都要遵循目标仓库现有的格式与命名。评审意见通常针对实现和证据，不代表对贡献者本人的评价；根据反馈补充说明或拆分改动，往往比继续扩大 PR 更有效。",{"id":1650,"title":1651,"titles":1652,"content":1653,"level":632},"\u002Fcontributing\u002Fgetting-started#代码之外的贡献","代码之外的贡献",[48],"你还可以帮助维护者确认真实使用场景、复核文档示例、测试不同系统和浏览器、改进中文表达、整理复现案例，或指出 API 与实际行为不一致的地方。反馈越具体，越容易转化为 Issue、测试用例或可合并的修复。",{"id":1655,"title":1656,"titles":1657,"content":1658,"level":632},"\u002Fcontributing\u002Fgetting-started#从这里继续","从这里继续",[48],"查看 NexusMC 开源项目，选择 GitHub 仓库或已发布的 npm 包。查看 NexusMC GitHub 组织 的公开仓库、Issue 和项目说明。查看 NexusMC npm 组织 的已发布包和版本信息。如果想参与文档类项目，可先了解公开的独立 docs 仓库，再按该仓库说明提交贡献。 本页只说明通用入口，不替代某个仓库自己的贡献规则。仓库说明、许可证和维护者在具体项目中的最新决定优先。",{"id":53,"title":52,"titles":1660,"content":1661,"level":597},[],"浏览 NexusMC 在 GitHub 和 npm 公开的库、服务端软件与基础设施项目。 NexusMC 的公开代码主要分布在 GitHub 组织；可以直接安装的 TypeScript 包则发布在 npm 组织。下面的目录按 2026 年 10 月 18 日的公开信息整理，项目是否继续维护、当前版本和贡献入口以对应仓库或 npm 页面为准。",{"id":1663,"title":1664,"titles":1665,"content":1534,"level":632},"\u002Fcontributing\u002Fopen-source#github-仓库","GitHub 仓库",[52],{"id":1667,"title":1668,"titles":1669,"content":1670,"level":655},"\u002Fcontributing\u002Fopen-source#web-与-typescript-工具","Web 与 TypeScript 工具",[52,1664],"项目用途入口axnexus基于 Fetch 的类型化 HTTP 封装库GitHubnexusdownMarkdown 渲染器与 CodeMirror 6 编辑器框架GitHubnexusimage浏览器与 Node.js 的图片加载、处理和编码工具GitHubnexuspulse浏览器通知运行时与 Node.js 通知服务GitHubnexus-progress页面与异步任务进度指示器GitHub",{"id":1672,"title":1673,"titles":1674,"content":1675,"level":655},"\u002Fcontributing\u002Fopen-source#服务端与基础设施","服务端与基础设施",[52,1664],"项目用途入口edgecacheGo 共享缓存与任务队列旁车GitHubnexusindex基于 PostgreSQL 的可重建搜索与数据分析索引GitHubmcstatusMinecraft 服务器检测节点GitHub",{"id":1677,"title":1678,"titles":1679,"content":1680,"level":655},"\u002Fcontributing\u002Fopen-source#文档与本地化","文档与本地化",[52,1664],"项目用途入口docsNexusMC 文档中心的公开仓库（独立项目）GitHubi18nNexusMC 的多语言配置GitHub 仓库使用的语言和许可证以仓库页面及其中的 LICENSE 文件为准；没有 LICENSE 的仓库，不要按开源许可使用其代码。这里的 docs 是独立的公开仓库，不等同于本站正在阅读的文档页面。GitHub 组织页还可能出现尚未在本页分类的公开仓库，新增项目不需要等待本页更新才能参与。",{"id":1682,"title":1683,"titles":1684,"content":1685,"level":632},"\u002Fcontributing\u002Fopen-source#npm-包","npm 包",[52],"以下包可以在 npm 的 @nexusmc-cn 组织下找到。包版本会独立于 GitHub 仓库更新，安装前请查看包页的兼容范围、变更记录和许可证。 包用途入口@nexusmc-cn\u002Faxnexus基于 Fetch 的类型化 HTTP 客户端与 Axios 风格实例npm · 源码@nexusmc-cn\u002FnexusdownMarkdown 渲染与 Vue 3 编辑器组件npm · 源码@nexusmc-cn\u002Fnexusimage浏览器端图片加载、调整、变换、EXIF 与编码npm · 源码@nexusmc-cn\u002Fnexusimage-node基于 Sharp 的 Node.js 图片处理与可选 Fastify 适配器npm · 源码@nexusmc-cn\u002Fnexuspulse浏览器 Push、Notifications、Service Worker、WebSocket 与 Badging 运行时npm · 源码@nexusmc-cn\u002Fnexuspulse-serverNode.js Web Push 与 WebSocket 通知服务及可选 Fastify 适配器npm · 源码 包页面显示的名称、版本和依赖可能随发布改变；不要把 GitHub 上的工作区名称自动当成可安装包名，也不要把尚未发布的内部包写进安装示例。 本页只列出 @nexusmc-cn 组织中已能从 npm registry 查到的公开包。NexusMC 其他服务端源码、工作区内部包和 vendor SDK 不属于这个 npm 安装目录；是否可安装、如何构建和如何部署，都要以对应仓库的说明为准。",{"id":1687,"title":1688,"titles":1689,"content":1690,"level":632},"\u002Fcontributing\u002Fopen-source#如何选择第一个贡献","如何选择第一个贡献",[52],"想熟悉 TypeScript，可以从 axnexus、nexusdown、nexusimage 或 nexuspulse 的文档、类型和测试开始。想了解 Go 服务，可以先阅读 edgecache、nexusindex 或 mcstatus 的 README、配置和本地启动说明。想改善站点文字或示例，可以从 docs 或 i18n 的具体页面和已有 Issue 开始。想贡献 npm 包时，先在对应 GitHub 仓库确认源码目录、构建命令和发布边界；npm 页面是消费入口，不一定包含完整开发环境。 无论选择哪个项目，都请先阅读贡献入门，再查看对应仓库的 README、LICENSE、Issue 模板和贡献说明。",{"id":64,"title":63,"titles":1692,"content":702,"level":597},[],{"id":68,"title":67,"titles":1694,"content":706,"level":597},[],{"id":72,"title":71,"titles":1696,"content":710,"level":597},[],{"id":76,"title":75,"titles":1698,"content":714,"level":597},[],{"id":80,"title":79,"titles":1700,"content":718,"level":597},[],{"id":84,"title":83,"titles":1702,"content":1703,"level":597},[],"查询当前兼容构建，或接收公开资源的新发布、修改与撤回通知。 服务器和启动器可以轮询更新接口；有公网 HTTPS 接收地址的机器人和托管服务也可以使用 Webhook。安装文件前应重新查询当前兼容构建。",{"id":1705,"title":1706,"titles":1707,"content":1708,"level":632},"\u002Fguide\u002Fresource-updates-and-webhooks#用阅读器订阅版本更新","用阅读器订阅版本更新",[83],"在资源详情页点击“订阅更新”，复制链接到支持 Atom 的阅读器。订阅地址使用主站域名： \u002Fresources\u002Fexample-performance\u002Freleases.atom\n\u002Fresources\u002Fexample-performance\u002Freleases.atom?loader=fabric&mc=1.20.1 详情页的订阅链接保留当前加载器、游戏版本和类型筛选。每条订阅内容对应一条原始发布记录，包含版本、兼容信息、发布时间、修订时间和更新说明；同版本号的不同构建可能分别出现。更新说明以纯文本保留 Markdown，超过 32768 个字符时明确标注截断。 默认订阅稳定版、最近 20 条；可使用 releaseType=release,beta,alpha 包含预发布版本，用 limit=50 调整条数（最大 50）。loader、mc、type 的联合匹配规则与下方更新查询一致。无匹配构建时返回有效的空订阅。 此订阅匿名读取，不需要账户或令牌。支持 ETag\u002F304，每次读取都会复核当前公开状态；资源不再公开时返回 404。订阅提供当前快照，不能用于完整历史追赶，阅读器已保存的旧条目也不会被远程删除。全站内容订阅仍使用 \u002Fatom.xml。",{"id":1710,"title":1711,"titles":1712,"content":1713,"level":632},"\u002Fguide\u002Fresource-updates-and-webhooks#查询当前构建","查询当前构建",[83],"curl -i 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fsite\u002Fresources\u002Fexample-performance\u002Fupdates?loader=fabric&mc=1.20.1&releaseType=release&limit=20' loader、mc、type 在同一条原始发布记录匹配。同维度多选为 OR，跨维度为 AND；例如 loader=fabric&loader=quilt。releaseType 可选 release、beta、alpha，默认只有 release。多选可重复参数或用英文逗号连接。limit 默认 20、最大 50。 items 按发布时间倒序，保留原始发布 ID、加载器、游戏版本和文件信息。同版本号可能有多条精确兼容记录，不能把不同记录的加载器和版本自由组合。hasMore 表示还有更旧构建；本接口是当前快照，没有历史追赶游标。映射 API 的文件 url 使用明确的网站 origin 转为绝对地址；不持久保存下载跳转得到的短期签名地址。 保存响应 ETag，后续请求带 If-None-Match，未变化返回无正文的 304。404 表示资源当前不可公开读取，应停止使用旧快照；旧 ETag 不能使它返回 304。网络\u002F服务错误不等于资源删除，不应覆盖最后成功快照。轮询使用合理间隔和失败退避，429 时降低频率。 该接口可匿名访问，PAT\u002FOAuth access token 需要 resource:read:feed，不需要 profile\u002Femail scope。当前 OAuth 客户端为 confidential client，不要把 client secret 放入启动器或浏览器。完整参数、文件字段与响应见匿名更新查询和带令牌更新查询。",{"id":1715,"title":1716,"titles":1717,"content":1718,"level":632},"\u002Fguide\u002Fresource-updates-and-webhooks#创建订阅","创建订阅",[83],"登录网站，进入「账号设置 → Webhook」，按正常安全验证创建接收地址，再输入资源标识添加订阅。可选加载器、游戏版本、发布渠道和事件。每个账户最多 10 个地址，每个地址最多 100 个订阅。 订阅任意公开资源不要求维护者授权，从创建之后开始，不补发历史。私有、草稿和未到期发布不会推送。可以暂停地址、取消订阅、轮换签名密钥、查看投递状态，并重试仍符合当前授权和端点版本的失败投递。 管理接口仅接受网站 Cookie，会话敏感写入同时要求 api-token 强验证和 CSRF。PAT、OAuth access token、OAuth client secret 不能管理 Webhook。签名密钥独立于 OAuth secret，只在创建\u002F轮换时显示一次；保存到接收端私密配置，不放入 URL、前端或日志。 接收地址必须是公网域名的 HTTPS\u002F443，不能带用户名、密码或片段，不接受 IP literal、内网或 HTTP 重定向。URL 最长 2048 个字符；每次发送重新验证全部 A\u002FAAAA 记录，任何非公网地址都会导致拒绝发送，并固定实际连接目标。服务需在 10 秒内完成响应，响应正文最多 64 KiB，建议成功时直接返回无正文的 204。",{"id":1720,"title":1721,"titles":1722,"content":1723,"level":632},"\u002Fguide\u002Fresource-updates-and-webhooks#管理接口参考","管理接口参考",[83],"每个管理操作的参数与响应可在 Webhook API 参考中单独查看；完整事件 schema 见 webhooks.json 的 webhooks.resourceRelease。下面是账户设置使用的 Cookie 管理接口。调用方必须拥有当前网站会话；GET 不要求二次验证，所有写操作都要求匹配 csrf_token Cookie 的 x-csrf-token 请求头，以及当前会话下用途为 api-token 的二次验证。二次验证由网站安全流程完成，有效期为 300 秒，服务器保存验证结果，无须另传 proof token。 如果自行实现同源管理界面，可通过 POST \u002Fapi\u002Fauth\u002Fstrong-action\u002Fverify-2fa 提交 { \"scope\": \"api-token\", \"code\": \"当前验证码\" }，或通过 POST \u002Fapi\u002Fauth\u002Fstrong-action\u002Fverify-double-password 提交 { \"scope\": \"api-token\", \"password\": \"双层密码\" }。两者同样要求 Cookie\u002FCSRF，成功返回 { \"verified\": true, \"scope\": \"api-token\", \"expiresIn\": 300 }。应使用账户已经绑定的认证方式；此流程不颁发 PAT，也不要求接收服务器持有网站 Cookie。 管理路径中的 id 是端点 ID。成功统一为 HTTP 200，直接返回下表结构，没有额外的 data 包装。创建、轮换与重试的请求正文必须是 JSON 对象；无参数时发送 {}。请求正文中的未知字段会被拒绝。 方法与路径请求正文 \u002F 查询成功响应GET \u002Fapi\u002Fwebhooks\u002Fendpoints无{ items: Endpoint[], quota: 10 }POST \u002Fapi\u002Fwebhooks\u002Fendpoints{ name, url, clientId? }{ endpoint: Endpoint, signingSecret }PATCH \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id{ name?, url?, enabled? }，至少一个字段{ endpoint: Endpoint }DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id无{ success: true }POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Frotate-secret{}{ endpoint: Endpoint, signingSecret }GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fsubscriptions无{ items: Subscription[], quota: 100 }POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fsubscriptions{ resourceSlug, events?, loaders?, mcVersions?, releaseTypes? }{ subscription: Subscription }DELETE \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fsubscriptions\u002F:subscriptionId无{ success: true }GET \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fdeliverieslimit：1–50，默认 20；cursor：上页的 nextCursor{ items: Delivery[], hasMore, nextCursor }POST \u002Fapi\u002Fwebhooks\u002Fendpoints\u002F:id\u002Fdeliveries\u002F:deliveryId\u002Fretry{}{ success: true } name 去首尾空格后须为 1–100 个字符。clientId 可省略；提供时必须是本人当前启用的 OAuth 应用 ID，只用于关联应用状态，不提供 OAuth client secret。创建后不能修改这项关联。 订阅参数为数组，单个数组最多 100 项，单项为 1–100 个字符的字符串，重复值会去重。events 默认三种事件，且不能为空；releaseTypes 默认 [\"release\"]，可选 release、beta、alpha，且不能为空。loaders、mcVersions 默认 []，表示该维度不限；非空时必须使用平台已有的字典值，同维度 OR、跨维度 AND，并在同一条发布记录上同时满足。不接受 type 或加载器族筛选。 同一端点对同一资源只能有一个有效订阅。修改筛选条件须删除旧订阅后重新创建，新订阅仍从创建时开始。新增订阅要求端点已启用且资源当前公开。资源之后不再公开时，列表中的 resourceSlug 为 null，resourceId 仍保留。 返回对象的字段如下；所有 ID 都按不透明字符串保存，时间为 ISO 日期时间，version 为十进制字符串： type EventType = 'release.published' | 'release.updated' | 'release.withdrawn'\ntype ReleaseType = 'release' | 'beta' | 'alpha'\n\ntype Endpoint = {\n  id: string\n  name: string\n  url: string\n  clientId: string | null\n  enabled: boolean\n  version: string\n  createdAt: string\n  updatedAt: string\n}\n\ntype Subscription = {\n  id: string\n  resourceId: string\n  resourceSlug: string | null\n  events: EventType[]\n  loaders: string[]\n  mcVersions: string[]\n  releaseTypes: ReleaseType[]\n  createdAt: string\n}\n\ntype Delivery = {\n  id: string\n  eventId: string\n  eventType: EventType\n  releaseId: string\n  resourceId: string\n  status: 'pending' | 'sending' | 'succeeded' | 'failed' | 'cancelled'\n  attempts: number\n  httpStatus: number | null\n  lastError: string | null\n  createdAt: string\n  availableAt: string\n  finishedAt: string | null\n} 端点与订阅列表不分页，分别受 10 和 100 的配额限制。投递列表按创建时间倒序分页，nextCursor 为字符串或 null；原样传回，不能自己生成游标。httpStatus 在未收到有效 HTTP 响应时可为 null；lastError 是脱敏分类，例如 http_error、dns_error、timeout、network_error、non_public_address 或 revoked，不含对端响应正文。 下面的 Fetch 示例适用于已登录网站的同源页面。先在网站完成 api-token 二次验证，再调用；不要复制会话 Cookie 到机器人或启动器中： async function manageWebhook(path, { method = 'GET', body } = {}) {\n  const headers = {}\n  if (method !== 'GET') {\n    const csrf = document.cookie.split('; ')\n      .find(value => value.startsWith('csrf_token='))?.slice('csrf_token='.length)\n    if (!csrf) throw new Error('请刷新网站后重试')\n    headers['x-csrf-token'] = decodeURIComponent(csrf)\n  }\n  if (body !== undefined) headers['content-type'] = 'application\u002Fjson'\n  const response = await fetch(`\u002Fapi\u002Fwebhooks\u002Fendpoints${path}`, {\n    method, credentials: 'same-origin', headers,\n    ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n  })\n  const result = await response.json()\n  if (!response.ok) {\n    throw new Error(result.data?.message ?? result.error ?? `HTTP ${response.status}`)\n  }\n  return result\n}\n\nconst created = await manageWebhook('', {\n  method: 'POST', body: { name: '构建通知', url: 'https:\u002F\u002Freceiver.example.com\u002Fwebhooks\u002Fnexusmc' },\n})\n\u002F\u002F created.signingSecret 仅本次响应可读，安全交付给接收端的私密配置，不写入日志。\nawait manageWebhook(`\u002F${encodeURIComponent(created.endpoint.id)}\u002Fsubscriptions`, {\n  method: 'POST',\n  body: {\n    resourceSlug: 'example-performance',\n    events: ['release.published', 'release.updated', 'release.withdrawn'],\n    loaders: ['fabric'], mcVersions: ['1.20.1'], releaseTypes: ['release'],\n  },\n}) 管理接口失败时先看 HTTP 状态，再读取响应中的 data.code 或 error： 状态常见原因与处理400{ ok: false, error: \"…\" }：参数、URL、配额、重复订阅、端点停用或重试条件不满足。混用 Cookie\u002FBearer 会返回 MIXED_CREDENTIALS。修正输入，不自动重试创建或轮换。401UNAUTHENTICATED：网站会话失效，先重新登录。403CSRF_INVALID：刷新并使用当前 CSRF；STRONG_ACTION_VERIFICATION_REQUIRED：完成用途为 api-token 的二次验证；FORBIDDEN：来源或账户不允许；机器令牌可能为 TOKEN_SCOPE_REQUIRED。404端点、订阅或投递不存在，或不属于当前账户；创建订阅时也可能是资源当前不可公开读取。409CONFLICT：并发操作触发唯一约束，重新读取当前列表。429 \u002F 5xx降低频率或稍后读取状态。写请求的结果未知时，先检查列表，不盲目重复创建或轮换。 一般错误结构为 { statusCode, statusMessage, data: { code, message, ... } }，与特定 400 的结构不同。请求还受网站 Origin\u002FFetch Metadata 校验；跨站调用不能通过加 CSRF 请求头绕过。所有管理响应均禁止缓存。",{"id":1725,"title":1726,"titles":1727,"content":1728,"level":632},"\u002Fguide\u002Fresource-updates-and-webhooks#事件与顺序","事件与顺序",[83],"事件为 release.published、release.updated、release.withdrawn。首次公开包括定时到期和资源从草稿公开；撤回包括资源或发布不再公开。普通事件结构如下，ID 示例仅说明字段，应用应将 ID 视为不透明字符串： {\n  \"schemaVersion\": 1,\n  \"id\": \"resource-id.1\",\n  \"type\": \"release.published\",\n  \"sequence\": \"1\",\n  \"occurredAt\": \"2026-10-15T00:00:00.000Z\",\n  \"resource\": { \"id\": \"resource-id\", \"slug\": \"example-performance\", \"title\": \"示例资源\" },\n  \"release\": {\n    \"id\": \"release-id\", \"batchId\": \"batch-id\", \"versionNumber\": \"1.0.0\",\n    \"name\": null, \"releaseType\": \"release\", \"publishedAt\": \"2026-10-15T00:00:00.000Z\",\n    \"loaders\": [\"fabric\"], \"mcVersions\": [\"1.20.1\"]\n  }\n} schemaVersion 是载荷协议版本；id 对应请求头的 webhook-id，同一事件重试时保持不变；occurredAt 是事件发生时间，不是本次尝试的签名时间。sequence 是资源内十进制序号，比较时使用 BigInt 或十进制整数比较，不能假设跨资源全局排序。一次发布的多个兼容配对保留各自 release ID，可按 batchId 合并通知。筛选和订阅范围会造成序号空隙，不能把空隙直接解释为丢失。 撤回只保留外层字段、resource: { id } 和 release: { id }，没有旧标题、正文、文件或签名下载链接。安装事实始终以当前查询为准。端点停用\u002F删除、订阅删除、关联应用停用，或地址\u002F密钥变更，会取消相关旧代未完成投递；重新启用后接收新事件，使用当前快照补齐状态。已经发出的请求无法召回，仍应在接收端校验签名与当前安装事实。修改端点名称不改变版本；轮换密钥会立即推进版本，没有双密钥重叠期。",{"id":1730,"title":1731,"titles":1732,"content":1733,"level":632},"\u002Fguide\u002Fresource-updates-and-webhooks#验证签名与防重放","验证签名与防重放",[83],"平台向接收地址发送 POST，Content-Type: application\u002Fjson，正文最多 256 KiB。请求头为 webhook-id、webhook-timestamp、webhook-signature。签名格式 v1,\u003Cbase64>，HMAC-SHA256 输入为事件 ID、Unix 秒时间戳、原始正文，以两个英文句点连接：eventId.timestamp.rawBody。密钥就是创建\u002F轮换返回的 signingSecret 字符串，按 UTF-8 使用，不做 Base64 解码。必须先保留原始正文再解析 JSON，不能重新序列化对象来验签；代理和中间件也不能改写正文。 以下完整示例使用 Node.js 内置模块，无第三方依赖。保存为 webhook-receiver.mjs。它只做本地联调：接收并保存到最多 100 条的内存 inbox，进程重启即丢失；满时返回 503，不淘汰旧事件伪装成持久去重。生产中的持久保存方法见下一节。 import { createHmac, timingSafeEqual } from 'node:crypto'\nimport { createServer } from 'node:http'\n\nconst secret = process.env.WEBHOOK_SIGNING_SECRET\nif (!secret) throw new Error('请设置 WEBHOOK_SIGNING_SECRET')\nconst MAX_BYTES = 256 * 1024\nconst inbox = new Map() \u002F\u002F 仅演示；生产替换为持久事务和队列。\nconst eventTypes = new Set(['release.published', 'release.updated', 'release.withdrawn'])\n\nclass HttpError extends Error {\n  constructor(status) { super(`HTTP ${status}`); this.status = status }\n}\n\nfunction verifyWebhook(headers, rawBody, secret) {\n  const id = headers['webhook-id']\n  const timestamp = headers['webhook-timestamp']\n  const signature = headers['webhook-signature']\n  if (typeof id !== 'string' || !\u002F^[a-zA-Z0-9._-]{1,128}$\u002F.test(id) ||\n      typeof timestamp !== 'string' || !\u002F^\\d{1,16}$\u002F.test(timestamp) ||\n      typeof signature !== 'string' ||\n      !\u002F^v1,[A-Za-z0-9+\u002F]{43}=$\u002F.test(signature)) return false\n  const seconds = Number(timestamp)\n  if (!Number.isSafeInteger(seconds) ||\n      Math.abs(Math.floor(Date.now() \u002F 1000) - seconds) > 300) return false\n  const expected = createHmac('sha256', secret)\n    .update(`${id}.${timestamp}.`).update(rawBody).digest()\n  const received = Buffer.from(signature.slice(3), 'base64')\n  return received.length === expected.length && timingSafeEqual(received, expected)\n}\n\nfunction readRawBody(request) {\n  return new Promise((resolve, reject) => {\n    let size = 0\n    const chunks = []\n    const timer = setTimeout(() => reject(new HttpError(408)), 5000)\n    const finish = (error, body) => {\n      clearTimeout(timer)\n      if (error) reject(error)\n      else resolve(body)\n    }\n    request.on('data', chunk => {\n      size += chunk.length\n      if (size > MAX_BYTES) {\n        chunks.length = 0\n        finish(new HttpError(413))\n        return\n      }\n      chunks.push(chunk)\n    })\n    request.once('end', () => finish(null, Buffer.concat(chunks)))\n    request.once('error', () => finish(new HttpError(400)))\n    request.once('aborted', () => finish(new HttpError(400)))\n  })\n}\n\nconst server = createServer({\n  maxHeaderSize: 16 * 1024, headersTimeout: 5000, requestTimeout: 8000,\n}, async (request, response) => {\n  const reply = status => {\n    response.writeHead(status, { Connection: 'close' })\n    response.end()\n    request.resume()\n  }\n  try {\n    if (request.url !== '\u002Fwebhooks\u002Fnexusmc') throw new HttpError(404)\n    if (request.method !== 'POST') throw new HttpError(405)\n    const contentType = request.headers['content-type']?.split(';', 1)[0].trim().toLowerCase()\n    if (contentType !== 'application\u002Fjson' || request.headers['content-encoding']) {\n      throw new HttpError(415)\n    }\n    const contentLength = request.headers['content-length']\n    if (contentLength !== undefined && Number(contentLength) > MAX_BYTES) throw new HttpError(413)\n    const rawBody = await readRawBody(request) \u002F\u002F 先限制原始字节，再验签、解析。\n    if (!verifyWebhook(request.headers, rawBody, secret)) throw new HttpError(401)\n    let event\n    try { event = JSON.parse(rawBody.toString('utf8')) }\n    catch { throw new HttpError(400) }\n    if (!event || typeof event !== 'object' || Array.isArray(event) ||\n        event.id !== request.headers['webhook-id']) throw new HttpError(400)\n    if (event.schemaVersion !== 1 || !eventTypes.has(event.type)) throw new HttpError(422)\n    if (typeof event.sequence !== 'string' || !\u002F^\\d+$\u002F.test(event.sequence) ||\n        typeof event.resource?.id !== 'string' || typeof event.release?.id !== 'string') {\n      throw new HttpError(400)\n    }\n    if (inbox.has(event.id)) return reply(204) \u002F\u002F 已保存的重复事件同样确认。\n    if (inbox.size >= 100) throw new HttpError(503)\n    inbox.set(event.id, event) \u002F\u002F 生产必须等持久事务提交成功后才能返回 2xx。\n    reply(204)\n  } catch (error) {\n    reply(error instanceof HttpError ? error.status : 503)\n  }\n})\nserver.maxConnections = 100\nserver.listen(8080, '127.0.0.1', () => console.log('Webhook 联调接收器已启动')) 在 shell 中通过环境变量注入真实签名密钥后启动： WEBHOOK_SIGNING_SECRET='创建或轮换时显示的 signingSecret' node webhook-receiver.mjs PowerShell 使用 $env:WEBHOOK_SIGNING_SECRET = '创建或轮换时显示的 signingSecret'，然后运行 node .\u002Fwebhook-receiver.mjs。本地监听地址是 http:\u002F\u002F127.0.0.1:8080\u002Fwebhooks\u002Fnexusmc，不能直接登记为平台端点；实际接入时由公网域名的 HTTPS\u002F443 反向代理转发，并保留原始正文与三个签名头。接收器中的 300 秒时间窗是接入方选择的防重放策略，需要保持系统时间准确；每次投递尝试会使用新的签名时间戳。 示例返回 404（路径不匹配）、405（非 POST）、415（非 JSON 或压缩正文）、413（超出 256 KiB）、408（读取正文超时）、401（签名或时间窗不合法）、400（JSON\u002F字段\u002F头部 ID 不一致）、422（不支持的协议版本或事件）、503（inbox 满或处理异常）。204 只表示这个演示进程已保存到内存。示例不打印密钥、签名、事件载荷或资源 ID。",{"id":1735,"title":1736,"titles":1737,"content":1738,"level":632},"\u002Fguide\u002Fresource-updates-and-webhooks#持久去重与处理","持久去重与处理",[83],"生产接收端应把验签后的事件写入持久 inbox，并在同一个数据库事务内完成以下两步，再返回 2xx： 按 (接入来源, event.id) 唯一约束插入 inbox；重复且已成功提交的事件直接确认。为新事件写入自己的持久任务来源，或在同一事务中完成本地业务变更。事务失败返回 5xx，让平台重试。 唯一约束的来源应是同一平台环境，不能只用某一次接收进程的内存或可轮换密钥。若多个端点触发独立业务动作，可把本地逻辑消费者加入唯一键。先标记“已处理”再异步调用外部机器人会留下丢消息窗口；先调用再标记则可能重复，外部副作用还需使用其幂等键或可恢复任务。持久 inbox 本身不承诺外部副作用 exactly-once。 按事件 ID 去重与按序号保护状态是两件事。事件可能重复、乱序，时间窗不能代替去重；同一发布记录的旧 sequence 不得覆盖该发布记录的新状态。不同发布记录的通知不能仅因某个资源已见到更大序号就全部丢弃。较简单的做法是把通知作为“当前快照可能已变化”的信号，合并后重新查询更新接口，而不是用通知正文直接安装文件。 需要自动安装时重新读取当前兼容构建与文件，处理撤回后使旧缓存失效；查询 404 时停止使用旧资源快照。订阅不会补发历史、停用期间的变化也不会补发，因此首次订阅、接收端恢复、轮换后应主动同步当前快照。长期去重记录的保留应覆盖自身的恢复与人工重试窗口，不能只保留五分钟。",{"id":1740,"title":1741,"titles":1742,"content":1743,"level":632},"\u002Fguide\u002Fresource-updates-and-webhooks#投递重试与排查","投递重试与排查",[83],"平台将 2xx 视为已接收；网络\u002FDNS 错误、超时及 HTTP 408、429、5xx 最多尝试 8 次（包含首次），采用指数退避和抖动。第 1–7 次失败后的等待分别约为 1、2、4、8、16、32、64 秒，另加不足一秒随机抖动；实际投递时间可能延后，不保证固定时刻，也不按 Retry-After 另行排程。其它 HTTP 状态（包括重定向）或不可重试的传输校验错误进入失败终态。 接收端可靠保存事件后及时返回成功。返回 200 但响应正文过大或迟迟不结束，仍可能被平台视为失败；用无正文 204 最简单。网络结果未知时可能重复发送，不承诺 exactly-once。 在账户设置或投递列表检查 status、attempts、httpStatus 与 lastError。修复接收端后，只能人工重试当前端点版本的 failed 投递，且订阅仍存在、端点与关联应用仍有效、普通事件对应的发布仍处在相同公开代次；重试成功仅表示已重置为待发送，响应不是对端已接收的证明。轮换、URL\u002F启停变更后旧版本失败投递不能重试，cancelled 也不能重试，应同步当前快照。 已结束投递在结束 30 天后可被清理；事件在创建 30 天后、完成分发且已无关联投递时可被清理，未完成来源会保留。投递列表不是永久审计日志。完整离线变化日志和 changes API 不在本版范围内。",{"id":88,"title":87,"titles":1745,"content":1746,"level":597},[],"查询公开内容与组织，并按授权读取本人资料、维护内容和组织。 公共 API v1 包括公开查询、个人 API、OAuth、机器人事件和精简资源查询。每个接口页都有参数、响应和权限说明；对应的机器可读规范可从接口页下载。本页中的 http:\u002F\u002F127.0.0.1:4520 是示例地址，实际请求地址以对应接口规范的服务地址为准。机器人账号的申请、令牌与事件消费见机器人账号接入。",{"id":1748,"title":389,"titles":1749,"content":1750,"level":632},"\u002Fguide\u002Fpublic-api-v1#精简资源查询",[87],"精简资源接口只提供列表、详情和当前兼容构建。完整接口见精简资源参考，机器可读契约见 public-v1.json。 操作接口参考筛选资源GET \u002Fv1\u002Fresources读取详情GET \u002Fv1\u002Fresources\u002F{slug}查找当前构建GET \u002Fv1\u002Fresources\u002F{slug}\u002Fupdates 三条路径均支持 HEAD，执行与 GET 相同的校验并返回状态和响应头，不发送正文。已知路径的其它方法返回 405 和 Allow: GET, HEAD；未知版本或路径返回 404。",{"id":1752,"title":1753,"titles":1754,"content":1755,"level":632},"\u002Fguide\u002Fpublic-api-v1#发起查询","发起查询",[87],"curl --get 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fresources' \\\n  --data-urlencode 'loader=fabric' \\\n  --data-urlencode 'mc=1.20.1' \\\n  --data-urlencode 'limit=10' 无需令牌也可读取公开资源。若主动提供 PAT 或 OAuth access token，它必须具备 resource:read:feed；无效、过期、撤销或错误 scope 的凭据返回 401\u002F403，不会退回匿名读取。任何 Cookie 请求头均返回 400；请求不会创建网站会话，也不签发媒体权限。浏览器调用须使用 credentials: 'omit'，且只有运营方显式开放 CORS 后才可跨域访问。 const url = new URL('\u002Fv1\u002Fresources', 'http:\u002F\u002F127.0.0.1:4520')\nurl.searchParams.append('loader', 'fabric')\nurl.searchParams.append('loader', 'quilt')\nurl.searchParams.set('mc', '1.20.1')\nconst response = await fetch(url, { credentials: 'omit' })\nif (!response.ok) throw new Error(`请求失败：${response.status}`)\nconst result = await response.json()\nconsole.log(result.items)\n\u002F\u002F total 是十进制字符串，需要整数运算时用 BigInt(result.total)。 loader、mc、type、tag、capability 支持重复同名参数或逗号分隔，同维度 OR、跨维度 AND。加载器、游戏版本和类型必须由同一原始发布记录同时满足。例如 quilt 和 1.19.4 分别出现在两条记录上时，两者组合不会命中可用构建。加载器族不参与筛选。 q、sort、page、limit、cursor 是单值参数，重复键返回 400。未知参数、非法编码、空多选值及 GET\u002FHEAD 正文也会被拒绝。每维最多 64 个值，每值最多 128 字符；关键字最多 200 个 UTF-16 单元，请求 URI 最多 16 KiB、查询参数最多 256 个。 查询键和值中的 C0（U+0000–U+001F）及 DEL（U+007F）在 trim 去除首尾空白前拒绝，不能用编码后的制表符或换行绕过校验；正常 Unicode 查询与正文文本保留，不使用整段文本过滤。",{"id":1757,"title":1758,"titles":1759,"content":1760,"level":632},"\u002Fguide\u002Fpublic-api-v1#分页和稳定字段","分页和稳定字段",[87],"列表默认为 sort=updated&page=1&limit=20，最多 50 条，页码最多 1000；另可按 downloads 排序。nextCursor 仅用于 updated，继续请求时带上 cursor、保持 page=1 和其它筛选一致。游标不透明，不能解码后自行构造。格式、签名、版本或范围错误返回 400\u002FINVALID_INPUT；列表快照过期时返回 409\u002FCURSOR_STALE，此时从第一页重取。 成功直接返回该接口的对象；错误为 {\"error\":{\"code\":\"…\",\"message\":\"…\"}}。声明的字段稳定存在，coverUrl、body、nextCursor、更新的 name 和文件 sha512 在无值时为 null，数组为空时为 []。列表 total 和文件 size 均为十进制字符串，避免大整数精度损失。ID、revision 和游标按不透明字符串处理；发布时间保留源字符串中的微秒精度。 详情中的 releaseCount 和 matchedReleaseCount 统计展示合并单元；更新接口返回原始发布记录。详情不包含发布历史，不能从详情的加载器与版本数组任意组合出下载构建。正文是原始文本，应在客户端对应输出上下文转义或安全呈现。",{"id":1762,"title":1763,"titles":1764,"content":1765,"level":632},"\u002Fguide\u002Fpublic-api-v1#当前更新与条件请求","当前更新与条件请求",[87],"updates 只接受 loader、mc、type、releaseType 和 limit。渠道默认 release，也可多选 beta\u002Falpha；默认 20、最大 50 条。它是当前公开快照，hasMore 表示还有更旧构建，不提供历史 cursor。 收到 ETag 后可将其原值放入下一次请求的 If-None-Match。条件请求仍会核对令牌有效性和资源可见性；资源撤回或删除不会被旧标签掩盖。304 无正文，200 需要用新快照替换旧结果。安装前应再次复核构建。 公开 ETag 与响应中的绝对地址绑定。地址变化后，旧标签会被视为不匹配并返回 200；应使用新响应中的 ETag，不要用旧标签推断内容未变。未知标签也按不匹配处理；* 保留正常的存在性语义，并仍需通过相同的可见性校验。 响应使用 Cache-Control: private, no-store。429 表示请求超过频率额度，503 表示服务暂不可用；有 Retry-After 时按建议秒数等待。504 表示请求期限已到。单次响应上限为 2 MiB。 文件 url 是绝对地址。请直接使用返回的链接，不要将它重写成公共 API 域名，也不要将 SHA512 当作访问授权。",{"id":1767,"title":1768,"titles":1769,"content":1770,"level":632},"\u002Fguide\u002Fpublic-api-v1#公开组织与本人资料","公开组织与本人资料",[87],"组织与本人资料使用同一套 v1 路径。公开组织列表仅包含已批准、公开且未解散的组织；列表可使用 q、page 和 pageSize，每页最多 50 条。详情可返回公开组织资料，或已解散公开组织的最小墓碑。私有组织和成员关系不会进入公开响应。 操作接口所需权限列出公开组织GET \u002Fv1\u002Fsite\u002Forganizations匿名读取公开组织GET \u002Fv1\u002Fsite\u002Forganizations\u002F{slug}匿名读取本人展示资料GET \u002Fv1\u002Fpersonal\u002Fmeuser:read:self列出本人组织GET \u002Fv1\u002Fpersonal\u002Forganizationsorganization:read:self读取本人组织GET \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}organization:read:self创建组织POST \u002Fv1\u002Fpersonal\u002Forganizationsorganization:create编辑组织资料PUT \u002Fv1\u002Fpersonal\u002Forganizations\u002F{slug}organization:update:self curl --get 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fsite\u002Forganizations' \\\n  --data-urlencode 'q=创作' \\\n  --data-urlencode 'page=1' \\\n  --data-urlencode 'pageSize=20' \u002Fv1\u002Fpersonal 接受具有接口所列 scope 的 PAT 或 OAuth access token，不使用网站 Cookie。user:read:self 只读取本人的展示资料，与 OAuth userinfo 的 profile:read、email:read 分开；个人展示资料只提供读取接口。本人组织列表和详情仅覆盖本人拥有或作为活跃成员加入的组织，已解散组织只返回最小墓碑。浏览器跨域调用还取决于 API 的 CORS 配置，请使用 credentials: 'omit'。 curl 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fpersonal\u002Fme' \\\n  -H 'Authorization: Bearer \u003Caccess-token>' 创建组织要求账号可用、邮箱已验证且未被限制发布；创建者成为组织所有者。编辑只允许活跃所有者修改已批准且未解散的组织，必须提交当前正整数 version 和至少一个待修改字段。版本变化时返回 409；请先读取最新资料，再决定是否重试修改。 curl -X PUT 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fpersonal\u002Forganizations\u002Fexample-team' \\\n  -H 'Authorization: Bearer \u003Caccess-token>' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  --data '{\"version\":1,\"name\":\"更新后的组织名称\"}' 上述 scope 不授予网站后台或媒体管理权限。文档站不预填或保存令牌，也不代理凭据。",{"id":92,"title":91,"titles":1772,"content":1773,"level":597},[],"创建个人机器人、申请权限，并通过个人 API 和事件接口处理消息。 机器人使用独立账号发布内容和发送回复。资源、帖子与消息显示机器人的身份，公开主页标明其所有者。个人用户可在网站设置的开放中心创建和管理自己的机器人；官方通知账号另行管理。",{"id":1775,"title":1776,"titles":1777,"content":1778,"level":632},"\u002Fguide\u002Fbot-accounts#创建与授权","创建与授权",[91],"在开放中心创建机器人并编辑展示资料、头像与简介。申请所需的权限和全站指令。每次申请提交完整的权限与指令清单；审核期间，已有的生效授权继续有效。授权生效后，为机器人创建 PAT，勾选该令牌实际需要的 scope。令牌明文只显示一次。 资源、帖子、本人资料和组织的 14 项普通个人 API 权限默认都需要审核，包括读取权限。私信与房间事件权限各有策略；平台可将权限设置为自动批准、需要审核或禁用。生效授权、令牌 scope、内容所有权及操作时的账号状态会共同决定一次调用能否成功。策略禁用或账号停用会阻断已有授权。 机器人 PAT 只能代表该机器人，不能创建网站会话，也不能访问后台或媒体控制。使用普通个人 API 时，请参照个人 API中每项操作的 scope 与参数；机器人调用同一路径，资源、帖子和组织的归属由机器人身份决定。人工账号的 PAT 或 OAuth access token 不能代替机器人 PAT 调用机器人事件接口。",{"id":1780,"title":1781,"titles":1782,"content":1783,"level":632},"\u002Fguide\u002Fbot-accounts#房间指令","房间指令",[91],"机器人的指令清单在全站统一登记，房间管理者决定在自己的房间启用哪些指令。@handle 查服 参数 或有效的开头结构化提及需要机器人提及权限；无需提及的 \u002F查服 参数 需要另外申请房间指令权限，默认进入审核。指令名称精确匹配，且可配置最少和最多参数数量。私聊由用户先发起，机器人只能对收到的事件回复，不能主动私信尚未与其互动的用户。 无 @ 触发权限随完整指令清单申请，管理员可逐条核准哪些指令能无需 @ 触发；未核准的指令仍可按提及权限使用。房间管理者仍需逐条选择本房间启用的指令。 公开机器人目录支持按名称或账号标识搜索，每次返回最多 20 个机器人；继续查询时传入上次响应的 next_cursor，搜索词必须保持一致。目录接口单独限制每分钟最多 20 次请求。房间管理者仍须在房间内明确启用机器人及可用指令。",{"id":1785,"title":1786,"titles":1787,"content":1788,"level":632},"\u002Fguide\u002Fbot-accounts#接收事件和回复","接收事件和回复",[91],"完整字段、三类事件示例、TypeScript 消费代码与断线恢复见机器人事件与回复。 机器人事件参考提供 GET \u002Fv1\u002Fbots\u002Fme\u002Fevents 和 POST \u002Fv1\u002Fbots\u002Fme\u002Freplies。两者使用机器人 PAT 的 bot:events:read；回复时还会再次检查该事件对应的私信或房间回复权限。下面的地址仅为本地示例，实际地址以 bots.json 中的服务地址为准。 curl 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Fevents?after=0&limit=50' \\\n  -H 'Authorization: Bearer \u003Cbot-pat>' 按返回的 next_after 保存消费位置，重启后继续补取。事件中的 event_id 可用于回复；action_key 由机器人为本次动作稳定生成。同一机器人、事件和 action_key 只以首次提交为准：即使后续提交的 content 不同，也会返回首次发送的 message_id（duplicate: true），不会修改或再次发送消息。幂等重试仍须通过当前资格复核；每个事件最多接受 5 个新的回复键，不同业务动作使用不同键。 机器人事件及其回复幂等记录的保留期为 90 天，后台会分批清理到期记录。清理后不能再用旧 event_id 回复；聊天消息不受影响，事件序号也不会重置。因此客户端应持续保存 next_after，不要依赖从零开始重新获取全部历史事件。 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\":\"服务器在线\"}' 可连接 wss:\u002F\u002F\u003CAPI 域名>\u002Fv1\u002Fbots\u002Fme\u002Fevents\u002Fstream 接收事件变化提示。WebSocket 只推送 {\"event\":\"bot_events_changed\"}，不包含消息正文；建立连接和每次重连后仍需调用 HTTP 接口补取，运行期间也应定期补取。连接使用 Authorization: Bearer \u003Cbot-pat> 请求头，不在 URL 中放令牌。网页原生 WebSocket 不能设置该请求头，宜由可控制握手请求头的服务端客户端连接。 这些接口不使用 Cookie。Webhook 的订阅管理仍在网站同源接口下使用 Cookie、CSRF 和二次验证；资源发布事件仍由现有投递服务发送，与机器人事件 WebSocket 是两种不同通道。",{"id":96,"title":95,"titles":1790,"content":1791,"level":597},[],"了解私信和房间指令事件，按游标读取消息、可靠回复，并在断线后继续处理。 完成机器人账号接入后，可使用机器人自身 PAT 接收人工用户发来的私信和房间指令，再回复原来的会话。HTTP 接口提供事件正文；WebSocket 提示有新变化，帮助客户端及时补取。 接口地址、参数与响应见机器人事件 API。以下 http:\u002F\u002F127.0.0.1:4520 是本地 API 地址，部署时替换为自己的 API origin。",{"id":1793,"title":1794,"titles":1795,"content":1796,"level":632},"\u002Fguide\u002Fbot-events#哪些消息会产生事件","哪些消息会产生事件",[95],"事件类型触发方式必要权限与条件dm人工用户向机器人发送私信bot:events:read、bot:dm:read；机器人、所有者和授权仍有效mention房间消息以 @handle 命令 参数 开头，或消息携带有效的开头结构化机器人提及bot:events:read、bot:room:mention；机器人在房间内，安装的提及开关开启，且该指令已在房间选用slash房间消息以 \u002F命令 参数 开头bot:events:read、bot:room:slash；平台逐条核准该指令，房间管理者也逐条启用 平台批准斜杠指令后，房间仍须自行启用。普通房间聊天、句中提及、未知或无法唯一定位机器人的命令不会产生事件；机器人发送的消息也不会触发另一轮机器人事件。 指令登记时会去除首尾空白并转为小写，名称为 1–32 个 ASCII 小写字母、数字、下划线、常用中文或连字符，首字符不能是连字符；触发时精确匹配登记名。参数按空白拆分，不支持 shell 引号语法。超过 10 项时不识别为指令，也不生成事件；对于已识别的指令，参数数量不符合该指令配置时，人工用户的原消息仍会保存，发送响应包含 command_error，机器人不会收到该事件。",{"id":1798,"title":1799,"titles":1800,"content":1801,"level":632},"\u002Fguide\u002Fbot-events#读取事件","读取事件",[95],"curl 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Fbots\u002Fme\u002Fevents?after=0&limit=50' \\\n  -H 'Authorization: Bearer \u003Cbot-pat>' after 是十进制字符串，首次读取使用 \"0\"，最大为 \"9223372036854775807\"。limit 默认为 50，可设为 1–50。必须使用机器人的 PAT；所有者自己的 PAT、OAuth access token 和 Cookie 均不能代替它。 下面把三类事件放在同一个响应中，展示各字段的差异。ID、时间与内容均为示例。 {\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} 字段含义event_id事件 ID，回复时原样传入seq当前机器人的事件序号，十进制字符串message_id触发事件的人工消息 IDroom_id房间 ID；私信为 nullconversation_id私信会话 ID；房间事件为 nulltrigger_kinddm、mention 或 slashcommand_id触发的房间指令 ID；私信为 nullcommand_revision触发时的指令修订号；私信为 nullargs已拆分的指令参数；私信为空数组content人工用户发送的完整消息文本author_id发送消息的人工用户 IDcreated_at事件创建时间，ISO 时间字符串",{"id":1803,"title":1804,"titles":1805,"content":1806,"level":655},"\u002Fguide\u002Fbot-events#正确保存游标","正确保存游标",[95,1799],"事件按 seq 升序返回，但只包含当前仍有权限查看的消息。消息删除、权限变化或过期清理都可能造成序号间隔。 处理完一页后，保存响应中的 next_after，下次原样作为 after 传入。空页也可能推进 next_after；不要自行取最大序号、加一或猜测连续性。不要把 seq 或游标转为 JavaScript Number，大整数会丢失精度；也不要把本地未收到的较大数字当成游标。 同一机器人、相同 scope 集合、同一消费任务的多个实例应协调使用同一份持久化游标，避免相互覆盖进度。不同 scope 或独立业务消费者分别保存游标，防止一方推进后跳过另一方尚未处理的事件。首次启动、建立 WebSocket、重连以及正常运行期间，都应主动调用 HTTP 补取。",{"id":1808,"title":1809,"titles":1810,"content":1811,"level":632},"\u002Fguide\u002Fbot-events#回复与重复请求","回复与重复请求",[95],"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\":\"服务器在线。\"}' 成功返回 {\"message_id\":\"…\",\"duplicate\":false}。回复发送到原事件对应的私信会话或房间，无需再指定目标。action_key 为 1–64 个 ASCII 英文字母、数字、下划线、连字符、冒号或点；相同业务动作应稳定使用同一个键。content 去除首尾空白后不能为空，最长 10000 字符。 同一机器人、event_id 和 action_key 的重复请求返回首次发送的 message_id，并设置 duplicate: true；改变 content 不会覆盖首次回复。每个事件最多接受 5 个新的回复键，重试已有键不占新额度。不要在每次重试时随机生成键。 回复前会重新检查当前资格，包括 PAT、授权、源消息、房间安装与成员、指令修订和开关；私信还检查双方拉黑及对方消息隐私设置。私信回复需要 bot:dm:reply，房间回复需要 bot:room:reply，并保留触发该事件所需的读取权限。读取到事件并不保证稍后一定还能回复，幂等重试也不能绕过资格复核。",{"id":1813,"title":1814,"titles":1815,"content":1816,"level":632},"\u002Fguide\u002Fbot-events#typescript-消费示例","TypeScript 消费示例",[95],"将下面代码保存为 bot-consumer.ts。它处理一页事件，每个事件发送一次确认；你可以将确认文本替换为自己的业务结果。ack-v1 在每次重试时保持一致。 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} 例如在 Node.js 中用本地文件保存游标。将以下内容保存为同目录的 run-bot.ts，配置环境变量 BOT_TOKEN、BOT_API_ORIGIN，使用支持 TypeScript 的 Node.js 运行 node run-bot.ts： 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} 此示例使用单进程，每页完成后替换游标文件。发生读取、回复或保存错误时会停止，排查后可使用原游标重启；上一页已成功的确认会通过相同回复键去重。若还要写数据库、调用第三方服务等，应为这些副作用另外保存处理状态和幂等键，事件回复接口不会替你的业务事务去重。",{"id":1818,"title":1819,"titles":1820,"content":1821,"level":632},"\u002Fguide\u002Fbot-events#websocket-变化提示","WebSocket 变化提示",[95],"连接 wss:\u002F\u002F\u003CAPI 域名>\u002Fv1\u002Fbots\u002Fme\u002Fevents\u002Fstream，握手时使用 Authorization: Bearer \u003Cbot-pat>。接口拒绝 Cookie、URL 查询参数、请求正文和 Sec-WebSocket-Protocol；令牌不要放进 URL。网页原生 WebSocket 不能设置这个请求头，应使用支持自定义握手头的服务端客户端。 唯一的应用层通知如下： {\"event\":\"bot_events_changed\"} 收到通知后调用读取接口。通知没有事件序号、正文或确认机制，可以合并、重复或丢失；新连接不会为已有待处理事件发送初始提示，所以建连后应立即补取，并保留周期性 HTTP 轮询。 客户端不发送订阅或确认消息，任何客户端应用数据帧（包括空帧）都会使连接结束；标准 ping\u002Fpong 控制帧由客户端库正常处理。每条连接最长 30 分钟，每个 token 最多 2 条、每个网关实例最多 64 条连接。断流后适当退避重连，继续从持久化 next_after 获取正文；不要因为断流把游标重置为零。",{"id":1823,"title":1824,"titles":1825,"content":1826,"level":632},"\u002Fguide\u002Fbot-events#错误与事件保留","错误与事件保留",[95],"HTTP 状态处理方式400检查参数格式、游标上限和正文；修正后再请求401检查机器人 PAT 是否失效或过期，更新凭据403检查 scope、当前授权、账号状态及会话或房间资格；不要靠重复请求绕过404源事件或消息不存在，可能已删除或被清理；记录处置后再决定是否跳过429读取响应中的限流信息并退避；若已达到每事件五个回复上限，不再创建新回复键5xx 或网络中断保留游标，退避后重试同一动作；发送结果未知时也沿用原回复键 事件与关联回复幂等记录按事件创建时间保留 90 天，后台分批清理；不以最后回复时间延长。清理不删除聊天消息，也不重置事件序号，但旧事件将不能继续回复。长期离线可能丢失未处理事件，不应依赖从零重放完整聊天历史。 机器人事件与资源 Webhook是不同通道：前者用于机器人消息和指令，后者投递资源发布变化；Webhook 的网站 Cookie 管理接口不接受机器人 PAT。",{"id":100,"title":99,"titles":1828,"content":736,"level":597},[],{"id":1830,"title":1831,"titles":1832,"content":1833,"level":632},"\u002Fguide\u002Fcontent-subscriptions#订阅教程","订阅教程",[99],"在教程列表点击“订阅更新”，将链接添加到支持 Atom 的阅读器： \u002Ftutorials.atom\n\u002Ftutorials.atom?tag=utility&mc=1.20.1 列表订阅沿用现有公开教程列表，按整篇更新时间倒序返回。入口会保留当前标签和游戏版本筛选，不复制页码。默认最近 20 篇，可通过 limit=50 增加条数，最大 50；tag、mc 支持重复参数或英文逗号分隔，匹配语义沿用教程列表。 在单篇教程点击“订阅更新”，可以只关注该教程： \u002Ftutorials\u002Fexample-guide\u002Fupdates.atom 单篇订阅使用教程的稳定 ID，同一教程修改后更新原条目的更新时间、标题和摘要，并提供阅读链接。它提示整篇教程有更新，不提供逐章节更新记录、完整正文或修改对比。章节变更的后端设计不属于本次订阅范围。 两种订阅都匿名读取，只输出当前公开的教程。每次读取复核当前状态后再处理 ETag\u002F304；教程变为不可公开读取时，单篇订阅返回 404。网络故障不表示教程删除，阅读器应保留最后成功结果并退避重试。订阅是有界当前快照，不保证历史追赶或清除阅读器已保存的旧内容。 这些地址使用主站域名，站点应沿用全站 Feed 配置的 NUXT_SITE_URL，以生成正确的绝对链接；缺少该配置时教程 Atom 返回 503。它们属于 Web 站点输出，不增加公共 API 网关操作或机器 scope。",{"id":1835,"title":1836,"titles":1837,"content":1838,"level":632},"\u002Fguide\u002Fcontent-subscriptions#其它订阅","其它订阅",[99],"全站资源、教程与帖子混合订阅：\u002Fatom.xml；另有 \u002Frss.xml 和 \u002Ffeed.json。单个资源版本更新：\u002Fresources\u002F:slug\u002Freleases.atom，用法见资源更新与 Webhook。",{"id":120,"title":119,"titles":1840,"content":742,"level":597},[],{"id":127,"title":126,"titles":1842,"content":746,"level":597},[],{"id":132,"title":131,"titles":1844,"content":750,"level":597},[],{"id":137,"title":136,"titles":1846,"content":754,"level":597},[],{"id":142,"title":141,"titles":1848,"content":758,"level":597},[],{"id":147,"title":146,"titles":1850,"content":762,"level":597},[],{"id":152,"title":151,"titles":1852,"content":766,"level":597},[],{"id":157,"title":156,"titles":1854,"content":770,"level":597},[],{"id":162,"title":161,"titles":1856,"content":774,"level":597},[],{"id":113,"title":111,"titles":1858,"content":778,"level":597},[],{"id":167,"title":166,"titles":1860,"content":782,"level":597},[],{"id":172,"title":171,"titles":1862,"content":786,"level":597},[],{"id":177,"title":176,"titles":1864,"content":790,"level":597},[],{"id":182,"title":181,"titles":1866,"content":794,"level":597},[],{"id":187,"title":186,"titles":1868,"content":798,"level":597},[],{"id":192,"title":191,"titles":1870,"content":802,"level":597},[],{"id":197,"title":196,"titles":1872,"content":806,"level":597},[],{"id":202,"title":201,"titles":1874,"content":810,"level":597},[],{"id":207,"title":206,"titles":1876,"content":814,"level":597},[],{"id":212,"title":211,"titles":1878,"content":818,"level":597},[],{"id":217,"title":216,"titles":1880,"content":822,"level":597},[],{"id":222,"title":221,"titles":1882,"content":826,"level":597},[],{"id":234,"title":233,"titles":1884,"content":830,"level":597},[],{"id":241,"title":240,"titles":1886,"content":834,"level":597},[],{"id":248,"title":247,"titles":1888,"content":838,"level":597},[],{"id":253,"title":252,"titles":1890,"content":842,"level":597},[],{"id":258,"title":257,"titles":1892,"content":846,"level":597},[],{"id":263,"title":262,"titles":1894,"content":850,"level":597},[],{"id":270,"title":269,"titles":1896,"content":854,"level":597},[],{"id":275,"title":274,"titles":1898,"content":858,"level":597},[],{"id":228,"title":226,"titles":1900,"content":862,"level":597},[],{"id":280,"title":279,"titles":1902,"content":866,"level":597},[],{"id":285,"title":284,"titles":1904,"content":870,"level":597},[],{"id":289,"title":131,"titles":1906,"content":874,"level":597},[],{"id":294,"title":293,"titles":1908,"content":878,"level":597},[],{"id":298,"title":146,"titles":1910,"content":882,"level":597},[],{"id":302,"title":151,"titles":1912,"content":886,"level":597},[],{"id":307,"title":306,"titles":1914,"content":890,"level":597},[],{"id":311,"title":186,"titles":1916,"content":894,"level":597},[],{"id":315,"title":191,"titles":1918,"content":898,"level":597},[],{"id":319,"title":201,"titles":1920,"content":902,"level":597},[],{"id":323,"title":206,"titles":1922,"content":906,"level":597},[],{"id":327,"title":211,"titles":1924,"content":910,"level":597},[],{"id":332,"title":331,"titles":1926,"content":914,"level":597},[],{"id":337,"title":336,"titles":1928,"content":918,"level":597},[],{"id":342,"title":341,"titles":1930,"content":922,"level":597},[],{"id":348,"title":347,"titles":1932,"content":926,"level":597},[],{"id":353,"title":352,"titles":1934,"content":930,"level":597},[],{"id":365,"title":364,"titles":1936,"content":934,"level":597},[],{"id":370,"title":369,"titles":1938,"content":938,"level":597},[],{"id":375,"title":374,"titles":1940,"content":942,"level":597},[],{"id":359,"title":357,"titles":1942,"content":946,"level":597},[],{"id":380,"title":379,"titles":1944,"content":950,"level":597},[],{"id":385,"title":384,"titles":1946,"content":954,"level":597},[],{"id":390,"title":389,"titles":1948,"content":958,"level":597},[],{"id":396,"title":395,"titles":1950,"content":962,"level":597},[],{"id":401,"title":400,"titles":1952,"content":966,"level":597},[],{"id":408,"title":407,"titles":1954,"content":970,"level":597},[],{"id":413,"title":412,"titles":1956,"content":974,"level":597},[],{"id":417,"title":191,"titles":1958,"content":978,"level":597},[],{"id":422,"title":421,"titles":1960,"content":982,"level":597},[],{"id":435,"title":434,"titles":1962,"content":986,"level":597},[],{"id":440,"title":439,"titles":1964,"content":990,"level":597},[],{"id":445,"title":444,"titles":1966,"content":994,"level":597},[],{"id":450,"title":449,"titles":1968,"content":998,"level":597},[],{"id":429,"title":427,"titles":1970,"content":1002,"level":597},[],{"id":455,"title":454,"titles":1972,"content":1006,"level":597},[],{"id":460,"title":459,"titles":1974,"content":1010,"level":597},[],{"id":465,"title":464,"titles":1976,"content":1014,"level":597},[],{"id":470,"title":469,"titles":1978,"content":1018,"level":597},[],{"id":475,"title":474,"titles":1980,"content":1022,"level":597},[],{"id":480,"title":479,"titles":1982,"content":1026,"level":597},[],{"id":485,"title":484,"titles":1984,"content":1985,"level":597},[],"机器人令牌读取事件并幂等回复；实时变更提示通过独立 WebSocket 连接。 首次接入请阅读机器人事件接入指南，查看事件字段、消费与回复示例和断线恢复方式。 选择接口查看参数、响应、代码示例并手动发送请求。也可以通过站点搜索查找接口名称、路径或参数。 方法接口路径GET读取机器人事件\u002Fv1\u002Fbots\u002Fme\u002FeventsPOST回复机器人事件\u002Fv1\u002Fbots\u002Fme\u002Freplies",{"id":1987,"title":1988,"titles":1989,"content":1990,"level":632},"\u002Fapi\u002Fbots#websocket-事件变更提示","WebSocket 事件变更提示",[484],"握手路径： GET \u002Fv1\u002Fbots\u002Fme\u002Fevents\u002Fstream 握手认证： Bot PAT or OAuth access token in Authorization Bearer header only; OAuth tokens must come from a reviewed bot application with an active bot permission grant and are always bound to the bot user; no Cookie or query token 连接只发送事件变化提示，不包含事件正文。连接后、重连后及运行期间，仍应通过 HTTP 事件接口按已保存的游标补取。 服务端通知示例： {\n  \"event\": \"bot_events_changed\"\n} 连接限制当前值每个令牌最多连接数2单实例最多连接数64单条连接最长持续时间1800 秒 完整契约：bots.json。",{"id":491,"title":490,"titles":1992,"content":1034,"level":597},[],{"id":496,"title":495,"titles":1994,"content":1038,"level":597},[],{"id":105,"title":103,"titles":1996,"content":1042,"level":597},[],{"articles":1998,"collections":2045,"sections":2079,"authors":2192},[1999,2005,2008,2011,2015,2018,2021,2026,2029,2032,2036,2039,2042],{"path":588,"title":589,"description":590,"collection":2000,"author":2001,"updated":2002,"order":597,"related":2003,"keywords":2004},"account","NexusMC 团队","2026-10-18",[624,646],[592,593,594,595,596],{"path":624,"title":625,"description":626,"collection":2000,"author":2001,"updated":2002,"order":632,"related":2006,"keywords":2007},[588,646],[628,629,630,631],{"path":646,"title":647,"description":648,"collection":2000,"author":2001,"updated":2002,"order":655,"related":2009,"keywords":2010},[588,624],[650,651,652,653,654],{"path":541,"title":542,"description":543,"collection":2012,"author":2001,"updated":2002,"order":550,"related":2013,"keywords":2014},"downloads",[516,635],[545,546,547,523,548,549],{"path":516,"title":517,"description":518,"collection":2012,"author":2001,"updated":2002,"order":526,"related":2016,"keywords":2017},[541,503],[520,521,522,523,524,525],{"path":635,"title":636,"description":637,"collection":2012,"author":2001,"updated":2002,"order":643,"related":2019,"keywords":2020},[541,516],[639,640,641,642],{"path":565,"title":566,"description":567,"collection":2022,"author":2001,"updated":2023,"order":574,"related":2024,"keywords":2025},"publishing","2026-11-14",[553,529],[569,570,571,572,573],{"path":553,"title":554,"description":555,"collection":2022,"author":2001,"updated":2023,"order":562,"related":2027,"keywords":2028},[565,529],[557,558,559,560,561],{"path":529,"title":530,"description":531,"collection":2022,"author":2001,"updated":2023,"order":538,"related":2030,"keywords":2031},[553,612],[533,534,535,536,537],{"path":503,"title":504,"description":505,"collection":2033,"author":2001,"updated":2023,"order":512,"related":2034,"keywords":2035},"community",[600,612],[507,508,509,510,511],{"path":600,"title":601,"description":602,"collection":2033,"author":2001,"updated":2023,"order":609,"related":2037,"keywords":2038},[503,612],[604,605,606,607,608],{"path":612,"title":613,"description":614,"collection":2033,"author":2001,"updated":2002,"order":621,"related":2040,"keywords":2041},[503,529],[616,617,618,619,620],{"path":577,"title":578,"description":579,"collection":2022,"author":2001,"updated":2023,"order":585,"related":2043,"keywords":2044},[503,635],[581,582,583,570,584],[2046,2055,2063,2071],{"id":2047,"title":2048,"description":2049,"extension":2050,"icon":2051,"meta":2052,"order":597,"slug":2000,"stem":2053,"__hash__":2054},"collections\u002Fhelp\u002Fcollections\u002Faccount.yml","账户与安全","创建账号、恢复登录，并保护你的账号。","yml","shield",{},"help\u002Fcollections\u002Faccount","JTlB9kyK6Ijwv4r4nSAYJF6fvUPqxT2NB1SM5H79Z1o",{"id":2056,"title":2057,"description":2058,"extension":2050,"icon":2059,"meta":2060,"order":632,"slug":2012,"stem":2061,"__hash__":2062},"collections\u002Fhelp\u002Fcollections\u002Fdownloads.yml","查找与下载","找到需要的资源，选择适合自己环境的版本。","download",{},"help\u002Fcollections\u002Fdownloads","HcwJVJekWmrvK6fYJdGBjyGpEjgAlnVru2pcBfOB6VI",{"id":2064,"title":2065,"description":2066,"extension":2050,"icon":2067,"meta":2068,"order":655,"slug":2022,"stem":2069,"__hash__":2070},"collections\u002Fhelp\u002Fcollections\u002Fpublishing.yml","发布与维护","保存资源与教程草稿、发布新版本，并维护已有内容。","package",{},"help\u002Fcollections\u002Fpublishing","2-sqzevUZYF4bgwuXLvV3TlBxxYNvl5UOJfxyGrpwZA",{"id":2072,"title":2073,"description":2074,"extension":2050,"icon":2075,"meta":2076,"order":550,"slug":2033,"stem":2077,"__hash__":2078},"collections\u002Fhelp\u002Fcollections\u002Fcommunity.yml","社区与反馈","参与讨论、提出清楚的求助，并反馈内容问题。","messages",{},"help\u002Fcollections\u002Fcommunity","195XOUkPYQ0RWMhV0aCWet5927NghfzVPzzy3V05KkM",[2080,2082,2084,2086,2088,2090,2092,2094,2096,2098,2100,2102,2104,2106,2108,2110,2112,2114,2116,2118,2120,2122,2124,2126,2128,2130,2132,2134,2136,2138,2140,2142,2144,2146,2148,2150,2152,2154,2156,2158,2160,2162,2164,2166,2168,2170,2172,2174,2176,2178,2180,2182,2184,2186,2188,2190],{"id":503,"title":504,"titles":2081,"content":1046,"level":597},[],{"id":1048,"title":1049,"titles":2083,"content":1051,"level":632},[504],{"id":1053,"title":1054,"titles":2085,"content":1056,"level":632},[504],{"id":1058,"title":1059,"titles":2087,"content":1061,"level":632},[504],{"id":516,"title":517,"titles":2089,"content":1064,"level":597},[],{"id":1066,"title":1067,"titles":2091,"content":1069,"level":632},[517],{"id":1071,"title":1072,"titles":2093,"content":1074,"level":632},[517],{"id":1076,"title":1077,"titles":2095,"content":1079,"level":632},[517],{"id":529,"title":530,"titles":2097,"content":1082,"level":597},[],{"id":1084,"title":1085,"titles":2099,"content":1087,"level":632},[530],{"id":1089,"title":1090,"titles":2101,"content":1092,"level":632},[530],{"id":1094,"title":1095,"titles":2103,"content":1097,"level":632},[530],{"id":1099,"title":1100,"titles":2105,"content":1102,"level":632},[530],{"id":1104,"title":1105,"titles":2107,"content":1107,"level":632},[530],{"id":1109,"title":1110,"titles":2109,"content":1112,"level":632},[530],{"id":541,"title":542,"titles":2111,"content":1115,"level":597},[],{"id":1117,"title":1118,"titles":2113,"content":1120,"level":632},[542],{"id":1122,"title":1123,"titles":2115,"content":1125,"level":632},[542],{"id":1127,"title":1128,"titles":2117,"content":1130,"level":632},[542],{"id":553,"title":554,"titles":2119,"content":1133,"level":597},[],{"id":1135,"title":1136,"titles":2121,"content":1138,"level":632},[554],{"id":1140,"title":1141,"titles":2123,"content":1143,"level":632},[554],{"id":1145,"title":1146,"titles":2125,"content":1148,"level":632},[554],{"id":565,"title":566,"titles":2127,"content":1151,"level":597},[],{"id":1153,"title":1154,"titles":2129,"content":1156,"level":632},[566],{"id":1158,"title":1159,"titles":2131,"content":1161,"level":632},[566],{"id":1163,"title":1164,"titles":2133,"content":1166,"level":632},[566],{"id":1168,"title":1169,"titles":2135,"content":1171,"level":632},[566],{"id":577,"title":578,"titles":2137,"content":1174,"level":597},[],{"id":1176,"title":1177,"titles":2139,"content":1179,"level":632},[578],{"id":1181,"title":1182,"titles":2141,"content":1184,"level":632},[578],{"id":1186,"title":1187,"titles":2143,"content":1189,"level":632},[578],{"id":588,"title":589,"titles":2145,"content":1192,"level":597},[],{"id":1194,"title":1195,"titles":2147,"content":1197,"level":632},[589],{"id":1199,"title":1200,"titles":2149,"content":1202,"level":632},[589],{"id":1204,"title":1205,"titles":2151,"content":1207,"level":632},[589],{"id":600,"title":601,"titles":2153,"content":1210,"level":597},[],{"id":1212,"title":1213,"titles":2155,"content":1215,"level":632},[601],{"id":1217,"title":1218,"titles":2157,"content":1220,"level":632},[601],{"id":1222,"title":1223,"titles":2159,"content":1225,"level":632},[601],{"id":612,"title":613,"titles":2161,"content":1228,"level":597},[],{"id":1230,"title":1231,"titles":2163,"content":1233,"level":632},[613],{"id":1235,"title":1236,"titles":2165,"content":1238,"level":632},[613],{"id":1240,"title":1241,"titles":2167,"content":1243,"level":632},[613],{"id":624,"title":625,"titles":2169,"content":1246,"level":597},[],{"id":1248,"title":1249,"titles":2171,"content":1251,"level":632},[625],{"id":1253,"title":1254,"titles":2173,"content":1256,"level":632},[625],{"id":1258,"title":1259,"titles":2175,"content":1261,"level":632},[625],{"id":635,"title":636,"titles":2177,"content":1264,"level":597},[],{"id":1266,"title":1267,"titles":2179,"content":1269,"level":632},[636],{"id":1271,"title":1272,"titles":2181,"content":1274,"level":632},[636],{"id":1276,"title":1277,"titles":2183,"content":1279,"level":632},[636],{"id":646,"title":647,"titles":2185,"content":1282,"level":597},[],{"id":1284,"title":1285,"titles":2187,"content":1287,"level":632},[647],{"id":1289,"title":1290,"titles":2189,"content":1292,"level":632},[647],{"id":1294,"title":1295,"titles":2191,"content":1297,"level":632},[647],[2193],{"id":2194,"avatar":2195,"extension":2050,"meta":2196,"name":2001,"slug":2197,"stem":2198,"__hash__":2199},"authors\u002Fhelp\u002Fauthors\u002Fnexusmc-team.yml","\u002Flogo.png",{},"nexusmc-team","help\u002Fauthors\u002Fnexusmc-team","ZmmKrmgPl8-_VSgcMoUQK2bD1e684vm-KHZGYVrREms",{"id":2201,"title":566,"author":2001,"body":2202,"collection":2022,"description":567,"extension":2287,"keywords":2288,"meta":2289,"navigation":2290,"order":574,"path":565,"related":2291,"seo":2292,"stem":2293,"updated":2023,"__hash__":2294},"articles\u002Farticles\u002Fpublish-resource.md",{"type":2203,"value":2204,"toc":2281},"minimark",[2205,2214,2217,2225,2233,2235,2259,2262,2264,2266,2268,2275],[2206,2207,2208,2209,2213],"p",{},"打开",[2210,2211,569],"a",{"href":2212},"site:\u002Fresources\u002Fnew","，填写基本介绍并先保存草稿，再上传图片和文件。资料与发布记录准备好后，点击“发布”提交审核，通过并公开后再检查实际页面。",[2215,2216,1154],"h2",{"id":1154},[2206,2218,2219,2220,2224],{},"先在",[2210,2221,2223],{"href":2222},"site:\u002Fresources","资源库","搜索作品名称和原始地址。已有自己的资源时，更新原条目或发布新版本，不要为每个加载器、每次更新重复创建。",[2206,2226,2227,2228,2232],{},"转载、翻译或分支作品还应写清原作者、来源、许可与自己的维护范围。具体要求见",[2210,2229,2231],{"href":2230},"docs:\u002Fpublishing\u002Fnaming-and-attribution","命名、署名与转载要求","。",[2215,2234,1159],{"id":1159},[2236,2237,2238,2242,2245,2248,2251],"ol",{},[2239,2240,2241],"li",{},"填写名称、简介和介绍。名称为 2–60 个字符，简介为 10–200 个字符，介绍至少 10 个字符。",[2239,2243,2244],{},"选择“页面上要放什么”，填写所选项目需要的数据。",[2239,2246,2247],{},"点击“保存草稿”，再上传封面、正文图片或发布文件。",[2239,2249,2250],{},"有下载文件时，填写版本号与准确的支持组合，等待上传处理完成。",[2239,2252,2253,2254,2258],{},"检查内容后点击“发布”提交审核，在",[2210,2255,2257],{"href":2256},"site:\u002Fmember\u002Fpublications","发布审核记录","查看进度与反馈。首次发布的资源及同批次发布记录全部通过后才会公开，再打开详情核对文件、图片和链接。",[2206,2260,2261],{},"标签可以多选或留空。加载器和游戏版本应填写在支持范围中，不用开放标签代替。",[2215,2263,1164],{"id":1164},[2206,2265,1166],{},[2215,2267,1169],{"id":1169},[2206,2269,2270,2271,2274],{},"可从",[2210,2272,534],{"href":2273},"site:\u002Fmember\u002Fresources","找回已保存的草稿。先核对已有内容和发布记录，再继续提交，避免重复创建。",[2206,2276,2277,2278,2232],{},"介绍应说明用途、基本用法、依赖和已知限制；不要把尚未完成的计划当作已提供功能。完整填写要求见",[2210,2279,22],{"href":2280},"docs:\u002Fpublishing\u002Fresources",{"title":1534,"searchDepth":632,"depth":632,"links":2282},[2283,2284,2285,2286],{"id":1154,"depth":632,"text":1154},{"id":1159,"depth":632,"text":1159},{"id":1164,"depth":632,"text":1164},{"id":1169,"depth":632,"text":1169},"md",[569,570,571,572,573],{},true,[553,529],{"title":566,"description":567},"articles\u002Fpublish-resource","G5fC727jjzpbGLcBptxJPVqe25uSVJzq7j2AFVBar2o",1795179033492]