频道托管协议
频道托管是客户端—中继协议的可选模块。客户端直接连接频道托管中继；频道操作不经过账户路由 DHT 或中继 RPC。中继提供频道托管服务时，必须完整实现本模块，并在有效 RelayDescriptor 中声明 channel.host.v1 能力。
创建者账户建立频道并自动成为 owner；owner 负责签署后续描述 revision，owner 与 moderator 可以维护公开时间线；具有有效设备会话的客户端可以解析和读取频道。托管中继验证操作权限，把频道描述、发帖、编辑和删除事件按接受顺序加入同一条频道时间线。频道关闭后描述和时间线永久停止写入。
协议内容
| 部分 | 内容 |
|---|---|
| 模型与时间线 | 固定托管、权限、描述 revision、统一时间线、帖子删除与有限保留 |
| 核心对象 | 频道 ID、ChannelDescriptor 和 ChannelEvent |
| 频道管理方法 | 频道创建、查询、更新与关闭 |
| 时间线方法 | 发布、编辑、删除、举报、读取和同步 |
| 订阅方法 | 频道订阅集合替换、订阅上限与失败处理 |
| 频道通知 | 频道时间线变更通知 |
方法索引
以下方法均使用设备会话。
| 方法 | HTTP | WebSocket |
|---|---|---|
channel.create |
POST | JSON-RPC |
channel.resolve |
GET | JSON-RPC |
channel.update |
PUT | JSON-RPC |
channel.close |
DELETE | JSON-RPC |
channel.post |
PUT | JSON-RPC |
channel.post.edit |
PATCH | JSON-RPC |
channel.post.delete |
DELETE | JSON-RPC |
channel.post.report |
PUT | JSON-RPC |
channel.read |
GET | JSON-RPC |
channel.subscribe |
N/A | JSON-RPC |
HTTP/WSS 映射和错误遵循客户端—中继方法约定。
通知索引
通知封装遵循客户端—中继通知约定。
一致性要求
- 描述与生命周期：按核心对象和频道管理方法验证 ID 派生、完整描述签名与替换、字段及总大小限制、连续 revision、冲突查询确认、当前描述防回退和关闭终态。
- 内容写入：按时间线方法验证 owner/moderator 权限、完整请求与证书绑定、帖子幂等、编辑中省略与删除的区别、连续编辑重建、删除与举报冲突，以及正文和附件的签名保护与安全处理。
- 提交与保留：按时间线生命周期和原子提交规则验证并发权限及状态检查、故障恢复、接受时间与序号稳定、保留配置变化、编辑和验证材料的保留依赖。
- 读取与重建：按
channel.read验证最新页、前向和后向读取、非连续位置、页内顺序、has_more、历史描述与证书验证，以及删除和清理后的可读范围。 - 订阅与通知：按订阅方法和频道通知验证集合原子替换、清空、上限调低、失败明细与原集合保留，以及通知合并和补读；通知不得直接推进同步位置。