联网与插件
聊天与排行榜
选择平台聊天、排行榜或弱联网，并定义公开数据与失败行为。
联网与插件
先选择联网模型，再设计入口
聊天和排行榜是平台托管能力。作者定义频道、公开字段和展示方式，平台负责身份、存储和查询；页面脚本不能直接伪造服务端结果。
# 三种能力不要混用
| 目标 | 使用能力 | 数据所有者 |
|---|---|---|
| 玩家发送消息 | 聊天插件 | 平台聊天服务 |
| 比较一个已配置属性 | 排行榜插件 | 平台排行服务 |
| 查询自定义玩家快照、队伍或世界状态 | 弱联网 | 作者配置的公开快照 |
聊天不是动态表格，排行榜也不是任意数据库查询。需要多个自定义字段、条件树或聚合时，转到 弱联网脚本。
# 纯 AI 创作契约
向编辑器 AI 提供：
- 频道范围：个人、系统或全部；
- 是否允许匿名玩家查看或发送；
- 聊天保留数量和页面展示密度；
- 排行属性 ID、公开名称和升降序语义；
- 独立插件页还是嵌入某个场景；
- 加载、空列表、未登录、限流和网络失败状态。
AI 应先查询真实属性和控件 ID，再配置插件与渲染布局。不要要求它通过 fetch 调用内部接口。
# 传统配置字段
打开传统模式文档后，可以手动维护：
| 插件 | 字段 |
|---|---|
| 聊天 | 链接标签、聊天记录数、使用所需属性 |
| 排行榜 | 链接标签、排行属性、展示名称、使用所需属性 |
| 嵌入控件 | 聊天频道或排行类型、头像/名字/日期/发送按钮显示 |
普通控件可在 插件相关 转为聊天或排行入口。独立页适合完整列表；嵌入控件适合场景的一部分，但两者读取同一平台数据。
# 运行时流程
flowchart LR
A[玩家打开入口] --> B{身份和使用条件}
B -- 不满足 --> C[显示登录或条件提示]
B -- 满足 --> D[平台读取数据]
D --> E{成功?}
E -- 否 --> F[失败和重试状态]
E -- 是 --> G[渲染消息或排行]
发送聊天还必须禁用重复提交，等待平台确认后再显示成功。排行榜只展示服务端结果，不以当前页面的本地属性冒充已上传名次。
# 隐私与验收
不要公开私密文本、完整存档或未获授权的对象字段。测试未登录、空数据、正常数据、长昵称、重复发送、限流、断网恢复、多个排行属性和移动端滚动。
下一步：成就插件。