目前主題協議 V4

當前協議為 V4。 新作品統一使用 V4，應用外觀、啟動畫面、配色、閱讀主題和字體可獨立選擇；舊 V1/V2/V3 包繼續兼容。導入先保存，應用由用戶確認。當前清單 · 歷史 V1。

統一模組目錄

V1、V2、V3、V4 使用相同分類、名稱與順序。版本只擴充支援範圍；模組固定展示，分別標示「已提供」「作者未提供」「此協議版本不支援」，只有已提供的模組可選。

分類	模組	鍵名	最低協議
應用外觀	應用配色	`palette`	V1
應用外觀	介面圖示	`icons`	V1
應用外觀	頁面背景	`pageBackground`	V1
應用外觀	導覽裝飾	`navigation`	V1
應用外觀	啟動畫面	`launchScreen`	V4
閱讀外觀	閱讀紙張	`readerPaper`	V2
閱讀外觀	段評裝飾	`paragraphReview`	V2
閱讀外觀	載入動畫	`openingIndicator`	V2
閱讀外觀	資訊列樣式	`informationBars`	V2
閱讀外觀	評論卡片	`commentCard`	V3
字體	字體	`fonts`	V2

「評論卡片」統一包含本章說與神評論的底色、邊框、圓角、內邊距和徽章；與「閱讀紙張」「段評裝飾」（段評按鈕素材）分開選擇，組合下載互不夾帶。不改變評論內容或啟用功能。字體仍是一個模組，內含 ui/body/header/footer 角色。skin、palette、reader、fonts 是四個儲存容器，不是另一套使用者模組分類；一個容器可承載多個獨立可選模組。

機器協議的 moduleCatalog 提供相同目錄。catalogVersion: 3 增加 V4 啟動畫面模組；新主題包使用 schemaVersion: 4。作者作品的 version 是另一套獨立遞增的發佈序號。

目前 V4 套裝清單

V4 使用整數 schemaVersion: 4 與 format: "origo.theme-suite"。components 可宣告 skin、palette、reader、fonts；省略元件表示套用時保留接收者現有選擇，明確系統選擇則恢復相應內建能力。直向啟動畫面 skin.artwork.launchScreen 與可選橫向畫面 launchScreenLandscape 都使用必填 asset 與可選 darkAsset，只接受靜態 PNG/WebP，單檔不超過 2 MiB、最長邊不超過 2048 像素。未提供橫向畫面時 App 以 contain 置中回退直向畫面；首頁準備好後立即離開，不強制停留。以下有效範例不需要預覽圖或額外素材：

{
  "schemaVersion": 4,
  "format": "origo.theme-suite",
  "id": "my-shared-theme",
  "version": 1,
  "name": "My shared theme",
  "author": "Your Name",
  "license": "Your actual license",
  "components": {
    "skin": {
      "base": "original"
    },
    "palette": {
      "light": {
        "seed": "#456789"
      },
      "dark": {
        "seed": "#345678"
      }
    },
    "reader": {
      "light": {
        "background": "#FFFDF7",
        "text": "#202020",
        "controlBar": "#FFFDF7"
      }
    },
    "fonts": {
      "resources": [],
      "roles": {
        "ui": {
          "builtin": "system"
        },
        "body": {
          "builtin": "system"
        },
        "header": {
          "builtin": "system"
        },
        "footer": {
          "builtin": "system"
        }
      }
    }
  }
}

配色與字型

每個配色外觀使用單個 seed，或齊全的 primary、secondary、tertiary，兩種形式互斥；均可帶 topBar。純系統字型可使用 resources: []，role 可為 { "builtin": "system" }。自訂字型 role 引用 resources ID，資源須宣告 family、asset、license、licenseAsset；字型檔與授權文字都須隨包提供。

閱讀資源與交付

V3 的 reader 協議支援明暗紙張、背景變體、段評圖示、資訊列樣式、評論卡片與受限 WebP 開書動畫；這些是格式能力，不代表「分享目前搭配」會擷取全部可選設定。目前擷取範圍見使用與分享。完整分享包不可帶有元件交付用的 distribution。

資訊列樣式的範圍

reader.informationBars 可提供 style、contentPreset，或兩者同時提供。style.header 與 style.footer 可調整字型角色、字號（8–24）、字重（100–900，步長 100）、語意顏色（text、muted、accent）、透明度（0.2–1）和密度（compact、regular、relaxed）；也可按資訊類型覆寫字型角色、字重、顏色與透明度。字型角色引用 components.fonts.roles，組合下載只附帶實際引用的字型與授權。

contentPreset 僅允許頁首和頁尾，每側最多兩行；每行左、中、右三組各最多三個項目。可用類型固定為時間、電量、書名、章名、章節頁數、剩餘頁數、章節數、剩餘章節數、章節進度、全書進度、本次閱讀時長、今日閱讀時長與本書閱讀時長。格式同樣受限，例如時間僅 auto/12h/24h，電量僅 auto/icon/percent/both，進度僅 auto/percent/bar/both。它不是任意文字、腳本或遠端資料入口。

套用時，資訊列樣式預設不勾選。使用者明確選擇後才套用作者宣告的樣式或有限內容預設；未宣告的一側保持原樣，裝置位置與邊距等本機配置也會保留。它不控制狀態列、正文排版、閱讀進度來源或即時統計計算。

下載創作工具中的 references/protocol.json 從真實模型產生，references/suites.md 說明欄位與資源限制。檢查器依實際協議使用同源驗證器，接受 original 皮膚、單 seed 與空資源系統字型，無須偽造素材。V4 本機驗證壓縮/展開上限為 128/192 MiB，另有角色預算；臨時分享前後均限 32 MiB。--complete 對 V2/V3/V4 只審計四元件是否存在，對 V1 仍審計素材完整覆蓋；預設允許合法部分包。

下載目前機器協議。作者上傳一個完整 ZIP。可選 media.images 使用圖片 ID 與包內路徑，media.cover 引用圖片 ID。組合下載保留所選資源和授權，省略宣傳圖片。V1/V2/V3 仍可讀取；新作品使用 V4。

版本標識

schemaVersion: 4 表示主題包協議 V4。catalogVersion: 3 只表示統一模組目錄的名稱與說明版本。versionName: "4.0" 是作者顯示版本，也支援 1.1、2.2、3.0；version 是遞增整數交付序號，用於精確下載與更新識別。舊包未宣告 versionName 時，整數 1 顯示為 1.0。

V3 的可選 reader.commentCard 定義本章說與神評論卡片的明暗底色、邊框、圓角、內邊距和徽章；正文文字跟隨閱讀文字顏色。閱讀設定可獨立選擇評論卡片，組合下載時也與閱讀紙張獨立投影。