本文是
ECOSYSTEM.md的简体中文翻译。如果翻译与英文原文冲突,以英文原文为准。
ORSP 把生态拆分为三层,让社区能够成长,同时避免阅读器变得不安全或通信协议失去稳定性。
ORSP 核心是阅读器和书源实现的 HTTP 契约。它定义数据和行为,不定义抓取程序。阅读器接入 任何合规书源时,都不应需要书源专属代码。
适配器把已有且获得授权的内容服务转换成 ORSP。它可以在服务端使用 HTML 解析、厂商 API、 数据库或其他书源专属逻辑。凭据和可执行规则始终由适配器运营者掌握,不会发送给阅读器。
未来的 Adapter SDK 应提供:
- 类型安全的 ORSP 响应模型;
- 请求校验和分页工具;
- 缓存、限流和安全上游请求默认值;
- HTML 清理工具;
- 一致性测试集成;
- 传统书源格式迁移指南。
适配器兼容性与 ORSP 线上协议版本相互独立。传统格式变化或消失时,不应迫使所有阅读器升级。
书源目录帮助用户发现书源,但不是协议权威,也不需要只有一个。阅读器可以订阅多个社区、 地区、组织或私有目录。
未来的目录配套规范应定义具有签名或完整性保护的条目,至少包括:
- 书源 ID 和发现文档 URL;
- 运营者和维护者信息;
- 支持的语言和能力;
- 最近一次一致性测试结果和测试套件版本;
- 不泄露私有基础设施的健康检查时间;
- 内容权利声明、举报渠道和下架状态;
- 可选的信誉与社区治理信息。
目录条目不得复制完整发现文档并形成第二事实来源。阅读器应从书源获取当前发现文档,并核对 稳定的书源 ID。
本仓库在 registry/ 中保留非官方参考 Schema 与工具,但
Open Reading 项目不运营或分发 Registry。独立社区可以 Fork 该参考实现,并用自己的运营
经验推动后续联邦格式。
通过协议测试只证明接口互操作,不证明内容合法、质量优秀或运营者可信。目录必须把这些信号 分开显示。技术兼容的书源仍然可能不适合收录。
阅读器应清晰展示书源身份、来源、权限、安全警告和下架信息。私网书源必须由客户端策略明确 允许。
- 稳定 ORSP 1.0,发布可复用的核心一致性工具;
- 在至少两个服务端生态中建立 Adapter SDK;
- 测试多个独立阅读器和书源,发布兼容性矩阵;
- 根据真实运营经验起草联邦 Registry 配套规范;
- 只有扩展实现证明语义兼容后,才把新能力标准化。