文档
platform-guild-progression
# 平台成长、公会与社区 平台等级与游戏角色等级是两套数据。账号 XP、单游戏 XP、公会贡献来自服务端;不进入存档,读档或转世不会改变它们。游玩仍由既有 getchatmsg 请求报告,首次建立基准,相邻请求超过 300 秒整段不补。基础游玩每分钟 1 XP,账号跨游戏合计每日最多 180 XP,每个游戏每
# 平台成长、公会与社区
平台等级与游戏角色等级是两套数据。账号 XP、单游戏 XP、公会贡献来自服务端;不进入存档,读档或转世不会改变它们。游玩仍由既有 getchatmsg 请求报告,首次建立基准,相邻请求超过 300 秒整段不补。基础游玩每分钟 1 XP,账号跨游戏合计每日最多 180 XP,每个游戏每日也最多 180 XP;普通玩家个人任务(公会任务除外)每奖励 1 积分另发 1 账号 XP,不占游玩日额。创作者任务只发原有钻石奖励,不再新增账号经验,历史已领取经验保留。公会任务的经验奖励增加所属游戏的平台等级,不增加账号/社区经验。已有内置游玩规则升级到 v2 后,从下一完整 UTC 周起采用 180 的单游戏日上限,旧周期仍按原上限结算。
实际消费每 100 积分或钻石自动增加 1 账号/社区 XP。游戏 AI、付费道具、外部 HTML 游戏及云读档重置消费同时增加所属游戏 XP;有明确项目归属的钻石消费(包括编辑器 AI、生图和发布次数重置)也增加该项目的游戏 XP。普通积分用于编辑器只增加社区 XP;积分和钻石混合扣费时按实际明细分别计算,不重复累计。经验保留小数,例如消费 10 得 0.1 XP,不占基础游玩日额。充值、兑换、转账、打赏、预算预留和积分过期不属于此消费奖励;创建公会的费用增加社区 XP。历史记录没有明确项目或项目已删除时只增加社区 XP,不推测游戏归属。消费自动经验与领取公会任务的额外奖励分别结算,同一笔消费重复请求或历史补发均不会重复发放。消息、关注和保存本身不增加 XP。
# 默认开放与游戏接入
正式发布的游戏默认开放公会和公会任务,无需在编辑器中配置公会插件。创建、加入、退出公会和任务领奖统一在社区中心完成;平台运营开关、成员权限和配额仍由服务端校验。
游戏通过渲染布局和现有脚本接口读取公会状态、绘制界面、判断条件或计算本地玩法收益。成员数据通过 tools.guild.getMembers() 读取;其中的弱联网快照遵循游戏已发布的弱联网配置、当前成员资格和读取额度,无需额外的公会快照开关。
编辑器测试服可在监控面板的「公会」页签中设置账号/游戏等级、公会名称、描述和等级,添加虚拟成员,设置角色、累计/本周贡献,并指定当前玩家对应的成员。点击「同步到测试服」后,player.platform、tools.progression.getSnapshot()、tools.guild.getMine() 和 tools.guild.getMembers() 统一读取本地测试数据,不请求平台接口。关闭「当前玩家已加入公会」可测试未入会状态。设置按编辑器账号和项目保存在当前浏览器,重新打开测试服会恢复;不会发布到游戏或写入玩家存档。头像等字段使用默认值,虚拟成员没有弱联网快照,numbers、strings、object 返回空映射。
测试服的「社区中心」按钮和两个 openPanel() 接口只提示在监控面板中设置公会,并返回 cancelled,不打开管理页面。正式服继续使用真实平台接口;TapTap 的运行时白名单包含平台/个人成长快照、公开资历、公会查询与成员、贡献和任务,以及已支持运行时身份的创建、入会、退会和领奖接口,仍由服务端鉴权。
私聊和消息图片默认开放。账号默认接受陌生留言及所有人的公会邀请,游戏资历默认公开;玩家仍可在社区中心调整隐私设置或拉黑其他用户。关注无需申请或审批,双方互相关注即为好友。
公会 1 级容量为 50 人,每升 1 级增加 1 个成员名额,即容量为 50 + 公会等级 - 1;例如 2 级可容纳 51 人。最多 5 名管理员。创建公会消耗 1,000 普通积分,不消耗制作积分。
# 公会任务与贡献
新建公会当天即可参与每日任务,当周即可参与每周任务。默认包含个人每日、个人每周、团队每日和团队每周任务,按所属游戏的有效游玩分钟或成功消费积分累计进度。任务目标是固定总量,新公会直接参与当前周期。任务名称、说明、目标和奖励均由后台配置。
三种成长值分别记录:个人贡献是你在该公会的个人贡献记录;公会经验用于公会升级和扩容;游戏经验用于你在公会所属游戏的平台等级,不是存档中的角色属性。公会任务不会增加账号/社区经验。
基础游玩奖励保持不变:入会后每 10 分钟有效游玩增加 1 点个人公会贡献,同时增加 1 点公会经验;每人、每游戏、每天最多 6 点。下表的任务贡献是额外奖励。个人任务在领奖时同步增加等量公会经验;团队任务由后台在每档达标时自动增加一次公会经验,数值等于该档贡献奖励,不随成员数或领取人数增加。
所有默认任务均不奖励积分;每档奖励下表数值的游戏经验和个人贡献。目标和奖励按顺序一一对应,各档可分别领取。团队任务的公会经验独立结算,成员领奖只领取自己的奖励。
| 任务 | 累计目标档位 | 每档个人游戏经验/个人贡献各 |
|---|---|---|
| 个人每日游玩 | 5/10/30 分钟 | 5/10/30 |
| 个人每日消费 | 10/50/100 积分 | 2/10/20 |
| 个人每周游玩 | 60/180/300 分钟 | 60/180/300 |
| 个人每周消费 | 10/500/1000 积分 | 2/100/200 |
| 团队每日游玩 | 全会累计 60/150/300 分钟 | 每位符合条件成员 12/30/60 |
| 团队每日消费 | 全会累计 100/200/500 积分 | 每位符合条件成员 20/40/100 |
| 团队每周游玩 | 全会累计 300/900/1500 分钟 | 每位符合条件成员 60/180/300 |
| 团队每周消费 | 全会累计 1000/2000/5000 积分 | 每位符合条件成员 200/400/1000 |
个人和团队的每日、每周消费任务统一按目标积分数除以 5 计算奖励;团队个人奖励由每位符合条件成员分别领取。每日消费使用三档较低目标,按日独立累计、刷新和领奖;同一笔有效消费可同时推进当天和当周的个人、团队消费任务。各档分别领取并累加:个人每日消费三档合计各 32 点,团队每日消费三档每人合计各 160 点;个人每周消费三档合计各 302 点,团队每周消费三档每人合计各 1600 点,个人/团队周游玩三档各合计 540 点。团队每日消费全部达标只给公会增加 160 经验,团队每周消费全部达标只增加 1600 经验,团队每周游玩全部达标只增加 540 经验,均不乘成员人数。个人奖励需主动领取;消费本身的自动经验仍按每 100 积分 1 XP 计算。内置 v9 配置升级后,日任务从下一 UTC 日、周任务从下一 UTC 周采用新数值;当前周期的冻结条款和已领取奖励保留,管理员自定义配置不被覆盖。
游玩进度使用服务端结算的实际有效游玩时长,按毫秒累计并换算为分钟,不受基础贡献每天 6 点上限限制。个人任务统计当前会籍内的个人记录,团队任务汇总公会成员在会期间的记录,只要求累计总量达标。任务奖励本身不会增加任务进度。
团队游玩任务默认每位成员每个 UTC 日最多计入 30 分钟,按用户和日期汇总,退会后重新入会不会重置当天额度。同一段有效的 30 分钟可以同时推进团队每日和每周任务,不需要在两者之间分配。10 名成员每天各游玩 30 分钟,可累计 300 分钟团队进度;持续 5 天即可完成最高周目标 1500 分钟。个人任务和消费任务不受这一 30 分钟限制。
消费进度只计会籍有效期间、所属游戏中已成功提交的积分消费:游戏 AI、付费道具/外部 HTML 游戏消费及云读档冷却重置。充值、转账、打赏、创建公会、其他游戏、编辑器和积分过期不计入;同一笔成交记录只统计一次。
各档个人任务奖励可以分别领取;同账号、同游戏、同周期、同任务跨公会不可重复领取。通常当期领取,下一周期 UTC 00:00 后额外保留 1 小时,以便处理延迟结算。
团队任务完成时,后台自动给公会增加该档经验,并冻结所有仍在会且未被封禁成员的领奖资格,无需达到个人贡献、游玩或消费门槛。退会或解散后仍可在站点个人页领取已冻结的个人奖励;贡献归原会籍,游戏经验计入该公会所属游戏,领取时不再增加公会经验。同账号、同游戏、同周期、同任务、同奖励位跨公会只能领取一次。个人奖励需主动领取,任务游戏经验不占每天 180 点的单游戏基础游玩经验额度;基础游玩增加账号经验的规则不变。
升级前已完成的团队任务由后台分批核对:尚未给公会增加经验的补记一次;已通过成员领奖增加过的保留原记录和数值,后续领奖不再增加。公会经验不会因重复结算、重复点击或多名成员领取而重复发放。
每日按 UTC 00:00 刷新(北京时间每天 08:00),每周按周一 UTC 00:00 刷新(北京时间周一 08:00)。
# 后台配置任务
超级管理员通过平台公会任务专用接口管理任务,玩家的「公会任务」页面只展示任务和领取奖励,不提供配置入口:
GET /api/v1/admin/system/platform/guild-task-catalog:读取完整配置。POST /api/v1/admin/system/platform/guild-task-catalog:请求体为{"value": 配置对象},保存新版本。
先读取完整 value,修改所需任务并保留其他任务,再提交完整列表;省略任务即表示在新版本移除,is_enabled: false 表示停用。下面是只保留一个个人每日任务的配置示例;实际提交时替换 effective_from 为提交时至少次日的 UTC 零点,version 使用未用过的版本号。
{
"value": {
"version": "guild-tasks-custom-1",
"effective_from": "2026-11-16T00:00:00Z",
"tasks": [
{
"task_key": "guild_daily_exploration",
"name": "每日初探",
"description": "在公会所属游戏有效游玩 20 分钟。",
"name_en": "Daily exploration",
"description_en": "Play the guild's game for 20 valid minutes.",
"scope": "personal",
"period": "daily",
"is_enabled": true,
"sort_order": 0,
"metric": "play_minutes",
"target_value": 20,
"member_daily_play_minutes_cap": null,
"reward_points": 0,
"reward_xp": 2,
"reward_contribution": 2,
"reward_expires_days": 7
}
]
}
}
task_key 是稳定标识。scope 为 personal 或 team,period 为 daily 或 weekly;metric 为 play_minutes(有效游玩分钟)或 spend_points(成功消费积分)。个人和团队统一使用 target_value 直接指定目标,例如 30 分钟填写 30,消费 500 积分填写 500,不通过贡献换算。已有任务 key 的 scope、period 和 metric 不可变更,需要改类型时创建新 key。
member_daily_play_minutes_cap 只用于团队游玩任务,可填 1–1440 的整数;null(Python 中为 None)或省略表示不限。默认团队游玩任务显式设为 30。此上限不限制个人任务和消费进度。修改现有周任务目标时保留原 task_key,避免重复领奖和任务引用失效。
每版最多 32 项任务。reward_points 为积分,reward_xp 为所属游戏的平台经验,reward_contribution 为个人贡献,同时决定该档公会经验。个人任务在领奖时给公会增加等量经验;团队任务在完成时自动给公会增加一次,成员领奖不再叠加。三项独立配置,至少一项大于 0;游戏经验无需等于积分。积分有效期为 1–365 天。
配置版本及生效日期不能重复,历史版本不可覆盖。日任务按日初、周任务按周初冻结配置,日常运营修改从相应后续周期生效。全新或旧 v1 配置初始化为最新默认目录;已有内置 v2 自动安排 v3 于次日 UTC 零点生效。其中新增的团队每日任务当天即可补齐,既有任务的数值仍按后续日/周周期切换,不覆盖管理员自定义目录和已冻结实例。已完成冻结的奖励继续保留。
# 读取与条件
const p = player.platform
if (!p.available || p.stale) return '平台状态同步中'
if (!p.capabilities.progression) return '平台成长未启用'
return `账号 Lv.${p.accountLevel} · 游戏 Lv.${p.gameLevel}`
平台快照使用 schema_version: 2。账号经验 account_xp 和游戏经验 game.xp 为 number,服务端返回实际经验值,可包含小数,直接用于显示或计算。平台 ID、revision、公会经验与贡献计数仍为十进制字符串,公会经验和贡献按整数点使用;project_id 是项目标识。未知字段不当作零;只有 available 且未 stale、capabilities.guild 为 true 的快照中 guild === null 才代表当前游戏无有效公会。同账号断网保留快照并标 stale,切账号或游戏立即清空。私信、好友和隐私设置不在此投影中。
需求、显示条件和效果前置条件可以选择「平台状态」来源:账号/游戏/公会等级、本周贡献、有无公会、角色。成本和收益不可选择平台状态。未知或相应能力停用时条件不满足。
# 内容示例
- 老玩家委托:需求条件选择账号等级 ≥ 5;未联网时显示同步提示,不将未知等级当 0。
- 公会地图:入口显示条件使用
hasGuild=true;特定区域再要求公会等级 ≥ 2。 - 公会配方:脚本读取当前公会等级,自行决定配方是否开放;原材料仍使用普通游戏属性。
- 成员助战:用户点击后调用
await tools.guild.getMembers({page:1,page_size:20}),成员条目的weak_online字段包含是否授权、更新时间和可读数据;仅返回当前成员的正式分区、已发布且授权的弱联网数据。游戏快照不是平台战力认证,也不能覆盖平台身份或经验。 - 公会家园:用
player.platform.guild?.role显示当前角色对应装饰;角色治理由站点确认,脚本不能直接提升角色。 - 动态倍率:脚本检查状态可用且未过期,再按公会等级或贡献计算本地收益,例如公会等级达到 2 级时使用
base * 1.05。倍率规则由作者自己的公式决定,不在刷新时永久叠加属性。
# 渲染布局与交互
渲染布局可通过 tools.progression.getSnapshot() 同步读取与 player.platform 相同的只读状态,例如:
const p = tools.progression.getSnapshot()
if (!p.available || p.stale) return '<p>公会状态同步中</p>'
if (!p.capabilities.guild) return '<p>公会暂不可用</p>'
if (!p.guild) return '<p>尚未加入公会</p>'
return '<p>公会等级:' + (p.guild.level ?? '—') + '</p>'
布局脚本同步返回 HTML。联网读取成员或打开社区中心应由点击交互发起,避免随布局刷新重复请求。普通只读动态字符串使用 player.platform 读取状态。
# 面板与脚本工具
await tools.platform.openPanel() // 打开当前游戏的社区中心
const mine = await tools.guild.getMine() // 当前公会详情,未入会时为 null
const members = await tools.guild.getMembers({page:1,page_size:20})
tools.guild.openPanel() 同样打开社区中心;两个运行时入口都不接收参数。返回值仅表示 opened/closed/cancelled/unavailable,不表示入会或领奖成功,后续重新读取状态。联网查询提供当前游戏的 getMine()、getGameData() 与 getMembers({page,page_size})(页码从 1 开始,每页最多 50);加入、退出、创建和领奖由社区界面完成。只读脚本可以读 player.platform,不可调用联网或打开面板。
# 成员返回格式与展示
tools.guild.getMembers() 返回 {items,viewer,page,page_size,has_more,total,total_pages},默认第一页、每页 20,最多 50。无当前公会时 items=[]、viewer=null、total/total_pages=0;有公会但越过末页时 items=[],viewer 和总数仍保留。viewer 为 {membership_id:string,role:'owner'|'admin'|'member'}。
成员使用公开昵称 nickname 和头像 head 展示,不返回登录账号或邮箱。头像与排行榜、聊天共用渲染逻辑,布局直接使用 {member.head},无需处理外观结构。其他字段:
| 字段 | 类型与含义 |
|---|---|
| user_id / role | 字符串用户 ID / owner、admin 或 member;用 ID 区分重名 |
| head | 引擎处理好的头像片段;放到有宽高的元素内容,使用 {member.head},不放 img src |
| contribution_total / contribution_week | 十进制字符串或 null;整数贡献点,“0” 表示零 |
| account_level / game_level | 可选 number;游戏等级受公开资历与屏蔽关系限制 |
| muted | 可选 boolean;仅管理者视角提供 |
| numbers / strings / object | 按属性、动态字符串、对象类 ID 映射的字典;与 tools.queryWeakOnline 一致 |
| weak_online | {enabled,allowed,missing,updated_at,data};时间为 UTC ISO 或 null,data 是原始已解码快照或 null |
弱联网 data 保留内部槽位和对象 JSON 字符串。日常使用顶层 numbers['属性ID']、strings['动态字符串ID']、object['对象类ID'],对象已经解析为普通 JSON 数组。data=null 时三个映射均为 {};有快照但旧字段缺失时分别回退为 0、“”、[]。enabled 表示发布配置,allowed 表示当前读取资格和额度,missing 表示该成员没有可读快照;它们不代表成员实时在线。
成员按会长、管理员、普通成员,再按加入时间排序;没有 rank/score,分页名也不同于弱联网查询的 limit/hasMore。异步工具离线结算时返回 undefined;失败会抛错,不能当作空页。布局必须同步返回 HTML,先在交互脚本加载数据,再展示昵称和头像。昵称等文本要转义,head 头像直接使用占位符显示。
“成员列表”动态字符串从交互缓存返回成员数组的 JSON 字符串,头像模板可直接写:
<div lp-for="member in player.getString('成员列表')" lp-key="{member.user_id}">
<span style="display:inline-block;width:40px;height:40px">{member.head}</span>
</div>
外部 HTML SDK 使用自身界面接入方式,不提供 FangZhi 的 head 片段及 numbers/strings/object 映射。
外部 HTML 使用原 SDK 和原认证:client.platform.getSnapshot()、client.platform.onChange(callback)(返回取消订阅函数)、client.platform.openPanel({section:'guild'})(SDK 可指定面板)或 client.guild.openPanel()、client.guild.getMembers({page:1,page_size:20})。卸载时调用 client.dispose()。SDK 不新建游玩心跳或 token 交换;旧公开聊天调用仍沿用 30 秒限流。
AI 智能体每轮状态先建只读动态字符串,检查 available/stale/capabilities 后读取平台字段,再在 currentstateprompt 用 <|动态字符串ID|> 引用。平台字段不是 AI 可写属性。游戏作者控制本地内容,服务端仍独立检查奖励、权限和幂等。
# 游戏内公会研究与共享数据
会长可以发布公会自己的 JSON 游戏数据,成员直接读取,用于研究等级、玩法任务进度和小幅本地加成。数据独立于会长个人弱联网快照和存档;正常转让后保留。平台校验身份、会籍与写入版本,不验证作者自定义战斗、捐赠扣款或研究公式。
// 点击会长的研究按钮:先读,保留完整基线。
const base = await tools.guild.getGameData()
if (!base || base.game_data.status === 'blocked') return
const next = base.game_data.status === 'empty'
? { schemaVersion: 1, skills: { attack: 0 }, availableResearch: 0 }
: JSON.parse(JSON.stringify(base.game_data.data))
// 在这里校验 schema、研究点、等级上限,并按项目静态表计算下一状态。
const receipt = await tools.guild.uploadGameData(next, base)
// receipt = {ok:true,guild_id:string,revision:string};成功后引擎刷新平台快照。
getGameData() 通过统一的 economy-snapshot 刷新平台状态,先更新 tools.progression.getSnapshot() / player.platform,再返回 {guild_id,membership_id,game_data,member_stats},与自动刷新共用进行中的请求。已同步且无有效公会时为 null;读取失败或公会能力不可用时抛错,不返回旧缓存。uploadGameData(data, base) 仅当前会长可用,第二参数是编辑前读取的完整结果,包含公会、会籍和原始 revision。普通成员、管理员、已退会者及该游戏作弊者不可写。异步工具离线结算为 undefined;网络错误、权限错误和版本冲突会抛错。
game_data 为 {status,revision,data,updated_at,updated_by_user_id}。status 为 empty、available 或 blocked;empty/blocked 的 data=null。data 是完整替换的 JSON 对象,最多 32 KiB UTF-8、16 层,只能包含有限数值。每会成功改写间隔至少 3 秒。版本冲突需重新读取并重算,不能用新 revision 覆盖旧草稿;超时先核对是否已成功,不重复扣个人资源。共享数据上传不上传个人弱联网、不保存个人存档。
普通成员的布局同步读取 player.platform.guild.game_data,无需查询会长或遍历成员:
const p = player.platform
if (!p.available || p.stale || !p.capabilities.guild) return '<p>公会状态同步中</p>'
if (!p.guild) return '<p>尚未加入公会</p>'
const shared = p.guild.game_data
if (!shared || shared.status === 'empty') return '<p>研究未开启</p>'
if (shared.status === 'blocked') return '<p>公会研究暂不可用</p>'
const level = shared.data?.schemaVersion === 1 ? shared.data.skills?.attack : undefined
if (!Number.isSafeInteger(level) || level < 0 || level > 5) return '<p>研究数据待更新</p>'
return '<p>攻击研究 Lv.' + level + ' · 加成 ' + level * 2 + '%</p>'
同样的校验通过后,属性公式可使用 baseAttack * (1 + level * 0.02);失败则用基础值。不要在刷新时永久叠加属性,不直接渲染作者数据中的任意 HTML。实际项目对文案使用 tools.tr。getMine().guild 也包含 game_data/member_stats。
# 全会弱联网聚合
player.platform.guild.member_stats 包含 available/reason/member_count/snapshot_count/numbers/oldest_snapshot_at/newest_snapshot_at。numbers['属性ID'] 为 {count,sum,min,max},一次聚合全部当前有效、未被标记作弊成员的已上传数值,不受成员分页限制。没有字段值时 count=0,其余为 null;未启用或额度不足时 available=false,不能当成贡献归零。每次全会聚合占一次弱联网读取额度。
新快照记录数值槽位对应的属性 ID;旧快照没有标识、缺值或槽位已改绑时不计入该字段,需要玩家重新上传。原始成员快照 weak_online.data.propertyIds 保存槽位到属性 ID 的映射,配合原始 numbers 检查字段存在性。旧成员详情映射的默认 0 不能作为已上传证据。字符串和对象不聚合,时间是个人最近上传时间,不代表在线。
sum 表示“当前成员最近快照的和”,会随加入、退出、封禁、旧档变化,不能每次加进永久贡献,也不能简单以两次 sum 差额结算。永久研究点须由会长在结算时分页读取成员,按 user_id、membership_id 和周期保存入会基线、最高水位,将确认总量/已花点数/技能/水位作为同一版本上传。新成员不能把入会前终身累计再贡献一遍;旧账本没有水位时只建立保守基线。周期不同的个人快照不能直接混合为本周 sum。详细流程和异步 PvP、赛季实现均已合并进编辑器 platform_social_progression skill。
# 封禁与恢复
该游戏作弊者不能访问对应公会接口,统计排除其快照。现任会长或当前共享数据的最近写入者被标记作弊后,公会数据冻结为 blocked/data=null,转让会长不能解除冻结。有效成员仍可读取冻结状态。服务端仅用一张表保存每个公会的当前数据,不保留历史版本;revision 只用于并发冲突检查,封禁不追溯已被覆盖的数据写入者。超级管理员审核并恢复有效会长后,可用 POST /api/v1/admin/guilds/{guild_id}/game-data/reset?gid=项目ID(JSON:{"reason":"至少十个字符的审核原因"})清空恢复。
冻结不会撤销已发本地奖励或抹掉已下载数据,篡改客户端仍可能忽略规则。此机制适合有上限的共同任务和研究加成,不能作为可信公会仓库、可提现金库、玩家资产转账或高价值防刷领奖系统。
# 统一快照与刷新时机
GET /api/v1/project/economy-snapshot?gid=项目ID 保留原经济字段,并新增 platform,一次返回经济状态、账号/游戏成长、当前公会及 game_data/member_stats。外部 HTML 对应 GET /api/v1/external-html/economy-snapshot?projectid=项目ID。完整成员名单、成员对象、私信与好友列表仍按需读取,不放入周期快照。
FangZhi 正式服在运行时初始化后首次请求,无付费控件也同步;前台每 60 秒一次,页面重新可见、身份变化、经济状态刷新、openPanel 打开/关闭及共享数据上传成功时刷新。并发刷新合并,期间发生状态变化会补一轮;后台暂停轮询,快照 120 秒过期。getSnapshot()/player.platform 本身不联网。失败标记过期,账号切换清空;轮询不上传任何个人或公会数据。
外部 SDK 的 client.getEconomySnapshot()、client.platform.getSnapshot() 和 client.guild.getGameData() 共用合并接口及进行中的请求;首次读取后前台每 60 秒同步,恢复可见和打开/关闭面板刷新。client.guild.getGameData() 在更新平台缓存后返回公会数据,client.guild.uploadGameData(next, base) 沿用上述基线契约。旧 /platform/snapshot 保留兼容。监控面板会保存测试服回传的共享数据与成员快照,重开后可继续联调;测试数据不写入正式公会,仍需用正式账号验证联网行为。
HTTP 直接接入:从上述 economy-snapshot 响应的 platform.guild 读取公会身份、共享数据与统计,不再提供单独的公会游戏数据 GET 接口。PUT /api/v1/guilds/{guild_id}/game-data 提交 {"membership_id":"会籍ID","expected_revision":"原版本","data":{...}}。写入接口由服务端复核会长身份,响应只含成功标记、公会 ID 和新 revision。