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、圖片、聽書和榜單提供契約與參考範例,按需要繼續實作。