Origo Source · 元源

让好内容,有一个自己的源。

把你的书籍、文章和连载章节,通过统一的开放接口连接到阅读客户端。内容由你掌握,存储由你选择。

ORSP 1.6 候选版HTTP(S) / JSON

你的内容
小说与连载
文章与图文
书籍与录音
自己的服务器与存储
Origo SourceORSP
阅读客户端
开元阅读
其他 ORSP 阅读器
内容与阅读之间,一套清楚的接口。

从阅读开始,按需要扩展。

核心保持精简,新能力单独声明,已有接口继续使用。

文字与图文核心阅读

纯文本、Markdown 与安全 HTML,明确章节身份和图片地址的解析方式。

content
章节更新可选配置

跟上新增章节和旧文修订,也能识别删章、重排与目录快照变化。

top.xxread:chapter-updates
EPUB 整本阅读可选配置

提供保留原始排版的完整书籍文件,附带大小与校验值,同时保留文字章节。

top.xxread:publications
图片序列可选配置

按顺序提供图片页与资源信息,由实现媒体配置的阅读器展示。

top.xxread:image-sequence
录音听书可选配置

描述音频地址、有效期与有限刷新;阅读器自己的 TTS 朗读独立运行。

top.xxread:remote-audio
多个榜单可选配置

独立榜单、绝对排名与分页快照,原有热门浏览接口继续保留。

rankings

这些是协议定义的能力。每个书源只声明实际实现的功能,客户端支持情况需要单独验证。

边界清楚,才容易持续生长。

存储、内容适配和阅读客户端各有职责。以后换数据库、换存储,阅读接口可以继续保留。

稳定的身份
服务器、下载地址或存储发生变化,书源、书籍和章节的 ID 保持稳定。
明确的能力
做好一项,再声明一项。已有 1.x 书源继续使用原来的核心读取路径。
一致的快照
目录是派生缓存;内容变化就更新版本,不能只看总章节数是否增加。
最小发现文档示例
{
  "protocol": "origo-source",
  "protocolVersion": "1.6",
  "id": "org.example.my-library",
  "name": "My library",
  "apiBaseUrl": "https://books.example.org/api/",
  "capabilities": [
    "search",
    "detail",
    "catalog",
    "content"
  ]
}
/.well-known/origo-source.json

Origo Source 是 Origo X 的书源生态。ORSP 即元源协议,新书源使用 origo-source,公开服务推荐 HTTPS,同时支持 HTTP 与旧入口兼容。

用 Skill 搭建,用真实请求验证。

下载包包含可运行的 Python 起步项目、生成脚本、规范 Schema 和 HTTP 检查工具,拿到包就有完整的契约参考。

  1. 安装 Skill

    把解压后的 origo-source-builder 放入助手的 Skill 目录,也可以让助手先阅读 SKILL.md。

  2. 描述你的书源

    告诉助手你有哪些内容、内容存在哪里,以及需要哪些阅读能力。

  3. 运行并验证

    启动本地书源,试着修改一章,通过真实发现地址检查,再部署到自己的服务器。

可以这样告诉助手

使用 $origo-source-builder,帮我搭建自己的元源书源,提供原创文章与连载章节。保持 ID 稳定,支持章节更新,并用真实 HTTP 请求验证服务。

起步项目已实现文字阅读、浏览和章节更新。EPUB、图片、听书和榜单提供契约与参考样例,按需要继续实现。

下载包校验值9aba059412a89251b49da4aa6ef5550d35a686554b4682ae48f81971739dcb29对应协议源码

从这里,开始搭建。

查看协议