Origo Source · 元源
让好内容,有一个自己的源。
把你的书籍、文章和连载章节,通过统一的开放接口连接到阅读客户端。内容由你掌握,存储由你选择。
ORSP 1.6 候选版HTTP(S) / JSON
开元阅读从阅读开始,按需要扩展。
核心保持精简,新能力单独声明,已有接口继续使用。
文字与图文核心阅读
纯文本、Markdown 与安全 HTML,明确章节身份和图片地址的解析方式。
content章节更新可选配置
跟上新增章节和旧文修订,也能识别删章、重排与目录快照变化。
top.xxread:chapter-updatesEPUB 整本阅读可选配置
提供保留原始排版的完整书籍文件,附带大小与校验值,同时保留文字章节。
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"
]
}Origo Source 是 Origo X 的书源生态。ORSP 即元源协议,新书源使用 origo-source,公开服务推荐 HTTPS,同时支持 HTTP 与旧入口兼容。
用 Skill 搭建,用真实请求验证。
下载包包含可运行的 Python 起步项目、生成脚本、规范 Schema 和 HTTP 检查工具,拿到包就有完整的契约参考。
安装 Skill
把解压后的 origo-source-builder 放入助手的 Skill 目录,也可以让助手先阅读 SKILL.md。
描述你的书源
告诉助手你有哪些内容、内容存在哪里,以及需要哪些阅读能力。
运行并验证
启动本地书源,试着修改一章,通过真实发现地址检查,再部署到自己的服务器。
使用 $origo-source-builder,帮我搭建自己的元源书源,提供原创文章与连载章节。保持 ID 稳定,支持章节更新,并用真实 HTTP 请求验证服务。
起步项目已实现文字阅读、浏览和章节更新。EPUB、图片、听书和榜单提供契约与参考样例,按需要继续实现。