製作與更新 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 仍獨立遞增。

選擇需要的模塊

新作品使用 schemaVersion: 4 和 format: "origo.theme-suite"。從 App 導出已有搭配，或使用 V4 模板。components.skin 管理圖示、應用背景與啟動畫面，palette 管理淺深配色，reader 管理閱讀紙張等閱讀外觀，fonts 管理主題字型。至少提供一個模塊；未提供的模塊保留接收者現有選擇。不要為了湊齊模塊偽造素材。直向啟動畫面使用 skin.artwork.launchScreen，可選橫向畫面使用 launchScreenLandscape；兩者都支援可選 darkAsset，只接受靜態 PNG/WebP，單檔不超過 2 MiB、最長邊不超過 2048 像素。未提供橫向畫面時 App 以 contain 置中回退直向畫面；首頁準備好後立即離開，不強制停留。

統一素材風格

按語義選擇 80 個圖標槽，保持線條、透視、視覺大小和透明留白一致。全套圖標建議使用 128 或 192 像素；靜態圖片累計解碼不超過 2400 萬像素，可選普通、選中及淺深變體。應用背景與閱讀背景是不同資源。按鈕形狀、彈簧反饋、玻璃與實底由 App 控制。

配色的每個明暗外觀使用一個 seed，或齊全的 primary/secondary/tertiary；不可混用。字型文件必須可再分發，隨包附許可文本；系統字型使用顯式系統選擇，不複製設備字型。

清單、預覽與打包

完整字段見 V4 清單。預覽可選，使用包內 media.images，以 media.cover 指定封面；不再使用 V1 根 preview。預覽是宣傳圖片，不是閱讀背景或安裝模塊。真實截圖與素材示意應明確區分。

ZIP 根目錄放 manifest.json，所有引用資源放 assets/，可保留根 README.md 和 LICENSE.txt。刪除未引用素材、系統雜文件和草稿；Skill 本身不能放進主題目錄。上傳仍然只有一個完整 ZIP，使用者在詳情頁勾選模塊後下載一個組合 ZIP。

更新與舊包遷移

保留原 ZIP，另建工作副本。先在 創作者工作台 覈實歸屬和所有投稿中的最高版本，保留 ID、作者、許可與未改素材字節；新投稿遞增作品 version，普通內容更新不再提升 schemaVersion。無法覈實私有記錄時，可繼續本機製作並標記待作者覈實。

V1 遷移需要重組結構：圖標、背景、縮放移入 components.skin；舊配色移入 components.palette.light/dark；原預覽聲明為 media.images。資源字節與署名保留，重新校驗。不能只改協議數字；詳見 歷史說明。

本機檢查

下載最新 創作 Skill，按其中說明運行：

uv run --with pillow --with 'pydantic>=2,<3' python scripts/check_theme.py ./my-theme --output ./my-theme.zip

默認允許合法部分套裝。--complete 僅在主動需要時審計四個存儲容器是否齊備，不要求每個可選圖標或資源。交付完整 ZIP、模塊說明、校驗結果及實際測試邊界。繼續閱讀 投稿與更新。