Skip to content

Latest commit

 

History

History
66 lines (45 loc) · 2.77 KB

File metadata and controls

66 lines (45 loc) · 2.77 KB

ORSP 生态架构

English

本文是 ECOSYSTEM.md 的简体中文翻译。如果翻译与英文原文冲突,以英文原文为准。

ORSP 把生态拆分为三层,让社区能够成长,同时避免阅读器变得不安全或通信协议失去稳定性。

1. 通信协议

ORSP 核心是阅读器和书源实现的 HTTP 契约。它定义数据和行为,不定义抓取程序。阅读器接入 任何合规书源时,都不应需要书源专属代码。

2. 服务端适配器

适配器把已有且获得授权的内容服务转换成 ORSP。它可以在服务端使用 HTML 解析、厂商 API、 数据库或其他书源专属逻辑。凭据和可执行规则始终由适配器运营者掌握,不会发送给阅读器。

未来的 Adapter SDK 应提供:

  • 类型安全的 ORSP 响应模型;
  • 请求校验和分页工具;
  • 缓存、限流和安全上游请求默认值;
  • HTML 清理工具;
  • 一致性测试集成;
  • 传统书源格式迁移指南。

适配器兼容性与 ORSP 线上协议版本相互独立。传统格式变化或消失时,不应迫使所有阅读器升级。

3. 联邦式书源目录

书源目录帮助用户发现书源,但不是协议权威,也不需要只有一个。阅读器可以订阅多个社区、 地区、组织或私有目录。

未来的目录配套规范应定义具有签名或完整性保护的条目,至少包括:

  • 书源 ID 和发现文档 URL;
  • 运营者和维护者信息;
  • 支持的语言和能力;
  • 最近一次一致性测试结果和测试套件版本;
  • 不泄露私有基础设施的健康检查时间;
  • 内容权利声明、举报渠道和下架状态;
  • 可选的信誉与社区治理信息。

目录条目不得复制完整发现文档并形成第二事实来源。阅读器应从书源获取当前发现文档,并核对 稳定的书源 ID。

本仓库在 registry/ 中保留非官方参考 Schema 与工具,但 Open Reading 项目不运营或分发 Registry。独立社区可以 Fork 该参考实现,并用自己的运营 经验推动后续联邦格式。

信任模型

通过协议测试只证明接口互操作,不证明内容合法、质量优秀或运营者可信。目录必须把这些信号 分开显示。技术兼容的书源仍然可能不适合收录。

阅读器应清晰展示书源身份、来源、权限、安全警告和下架信息。私网书源必须由客户端策略明确 允许。

路线图

  1. 稳定 ORSP 1.0,发布可复用的核心一致性工具;
  2. 在至少两个服务端生态中建立 Adapter SDK;
  3. 测试多个独立阅读器和书源,发布兼容性矩阵;
  4. 根据真实运营经验起草联邦 Registry 配套规范;
  5. 只有扩展实现证明语义兼容后,才把新能力标准化。