规划中的大插件
本页汇总两个尚未进入代码的大插件:Collection、Online。它们只有设计文稿层面的接口登记,仓库内没有对应的 contract.ts,也没有进入根插件名单。已落地的地图与养成范围分别见 Explore 大插件 与 Growth 大插件。
顶部信息表
| 大插件 | 所属阶段 | 契约版本 | 当前状态 | 源码目录 |
|---|---|---|---|---|
| Collection | Phase 3 | — | 未实现 | 未建立 |
| Online | Phase 5 | — | 未实现 | 未建立 |
两个插件均无 contract.ts,未进入根插件名单,因此没有可用的契约版本。下表复述文稿登记的服务、通知、机制插槽与实现位;具体字段、调用顺序、错误行为与写边规则尚未登记,本页不推测。
共同边界
- 两个插件都未进入根插件名单;启动时的清单与入口哈希校验不包含它们。
- 第三方不能新增大插件。新玩法只能落在 Extra 的
gameplay:module@1实现位下,以小的插件或 Mod 形式提供。 - 规划接口不等于可用接口;在对应
contract.ts建立前,不应在代码或包清单中引用这些名称。 - 状态统一为「未实现」,不按单个接口拆分「测试中」或「实现中」。
Collection(图鉴·任务·商店)
职责
负责图鉴与收集、成就、任务、商店与货币;不负责内容条目的实际剧本与资源,图鉴条目、任务定义与商品仍由数据包提供。
对外接口
| 名称 | 类别 | policy | 说明 |
|---|---|---|---|
archive:gallery | 服务 | 文稿未标注 | 图鉴与收集 |
quest:registry | 服务 | 文稿未标注 | 任务登记与查询 |
vendor:shop | 服务 | 文稿未标注 | 商店与货币 |
quest:resolve-completion | 机制插槽 | trusted | 任务完成判定 |
vendor:resolve-price | 机制插槽 | trusted | 商品价格解析 |
quest:on-complete | 通知 | — | 任务完成 |
vendor:on-purchase | 通知 | — | 购买完成 |
gallery:layout@1 | 实现位 | 文稿未标注 | 图鉴布局 |
quest:tracker@1 | 实现位 | 文稿未标注 | 任务追踪 |
关键语义与边界
- 完成判定、价格解析与购买副作用的输入输出尚未登记;不能据此实现货币扣减或重复领取保护。
- 图鉴解锁、任务状态与货币余额均属进度数据,须走 Save 的归属登记。
- 商店条目与任务定义应由数据包登记,不应硬编码进插件。
当前实现范围
- 未实现:三个服务、两个机制插槽、两个通知与两个实现位。
- 未实现:图鉴、成就、任务、商店与货币的具体模型。
Online(在线与运营)
职责
负责账号与登录、分发与热更新、社交、活动与日程、扭蛋、支付、邮件与公告;不负责本地存档与本地进度,在线状态与本地进度的合并规则尚未登记。
对外接口
| 名称 | 类别 | policy | 说明 |
|---|---|---|---|
account:auth | 服务 | 文稿未标注 | 账号与登录 |
update:hotfix | 服务 | 文稿未标注 | 热更新 |
social:* | 服务族 | 文稿未标注 | 社交 |
liveops:schedule | 服务 | 文稿未标注 | 活动与日程 |
gacha:* | 服务族 | 文稿未标注 | 扭蛋 |
payment:* | 服务族 | 文稿未标注 | 支付 |
online:resolve-endpoint | 机制插槽 | trusted | 端点解析 |
gacha:resolve-pool | 机制插槽 | trusted | 卡池解析 |
liveops:on-event | 通知 | — | 活动事件 |
account:on-login | 通知 | — | 登录 |
net:transport@1 | 实现位 | 文稿未标注 | 网络传输 |
gacha:rng@1 | 实现位 | 文稿未标注 | 扭蛋随机 |
payment:provider@1 | 实现位 | 文稿未标注 | 支付提供方 |
关键语义与边界
- 凭据与敏感能力必须放在宿主侧,网页侧只拿结果;本页不记录任何端点、协议或服务器配置。
update:hotfix不得更新大插件,也不得更新根插件名单;热更新只能覆盖允许更新的内容与资源。- 账号、扭蛋与支付涉及信任与用户知情权,具体权限、审计与失败回滚规则须在实现前登记。
- 支付提供方的凭据不得进入网页 realm、插件清单或文档。
当前实现范围
- 未实现:全部服务、机制插槽、通知与实现位。
- 未实现:账号协议、热更新边界、社交、活动、扭蛋、支付与邮件公告。
- 所属阶段为 Phase 5;Phase 4 的平台适配完成后才进入该阶段。
相关链接
- 插槽与实现位:实现位、multi 与 single 的登记规则。
- policy 与写边:规划插件落地时必须遵守的写边约束。
- 装载管线与 guard:新大插件为何不能由第三方加入根插件名单。
- Phase 3 玩法与内容:Explore、Growth、Collection、Extra 的阶段边界。
- Phase 4–6 平台、在线与创作:Online 所属阶段。
- 大插件总表:已完成与规划中大插件的完整列表。