核心定位
开放连接不是把所有数据交给第三方。每个应用都必须明确知道自己能读什么、能写什么、代表谁执行、受到哪些配额限制,以及失败后如何恢复。
REZICS 的服务器路由与类型结构定义是唯一手写契约来源,再由它们生成 OpenAPI、类型客户端与文档。认证和权限则由服务器端类型化访问政策强制执行,不依赖界面隐藏按钮。
现在已经能做什么
- 通过公开 API 访问作品、内容、领域、进度与其他已开放能力。
- 使用服务器路由与类型结构定义生成一致的 OpenAPI 文档。
- 以会话或具权限范围的 API 令牌验证请求。
- 对不同操作应用配额、错误响应与服务器端访问政策。
- 使用生成的类型客户端与
@rezics/api软件包。 - 对内容结构等复杂工作流保留并发令牌、请求上限与可恢复语义。
OAuth 与 MCP 的方向
OAuth 将让用户授权第三方应用,而不交出密码或长期个人令牌;MCP 则能让 AI 工具在用户看得懂、可撤回的范围内协助补充书籍、更新元数据或执行工作流。
最终目标是让不熟悉 API 的用户也能通过受控工具参与作品数据建设。但 OAuth 第三方应用、授权同意页面、回调、安全审查与官方 MCP 服务器尚未全部实现,因此能力状态标记为「开发中」。
大型内容工作流
以书籍内容结构为例,单次请求限制 10,000 个编译后逻辑变更,不限制整本书总节点数。大型网络小说导入必须分批、保存检查点、处理过期修订与不确定结果,不能把数十万节点塞进一个无界交易。
关系与边界
OpenAPI 描述传输契约,不自动描述所有多步骤任务。API 也不绕过产品权限;MCP 不会因为由 AI 调用就获取额外授权。每次跨网络、存储或缓存边界都必须重新验证数据与查看者权限。