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對應協定原始碼

從這裡,開始搭建。

查看協定