插件源數據
PluginManifest
每個插件必須定義 PluginManifest,並掛載到 PLUGIN.manifest 上,用於描述插件的靜態信息。
Tip
推薦以插件 identifier 作為文件名,例如 sample.py 對應 identifier="sample"。
from app.plugins import PluginManifest, PluginKind
manifest = PluginManifest(
identifier="sample",
name="示例插件",
version="0.1.0",
description="演示如何集成 Little Tree Wallpaper Next 插件 API",
author="Your Name",
homepage="https://example.com",
permissions=("resource_data",), # 可選,需要訪問受保護數據時聲明
dependencies=("core>=1.0.0",), # 可選,支持簡單的版本比較運算符
kind=PluginKind.FEATURE, # 可選,可聲明為 PluginKind.LIBRARY
)字段說明:
| 字段 | 說明 |
|---|---|
identifier | 插件唯一標識符(用於存儲目錄、日誌等),建議使用小寫字母和下劃線 |
name | 插件顯示名稱 |
version | 插件版本號,採用語義化版本 |
description | 可選,插件簡介 |
author | 可選,作者信息 |
homepage | 可選,主頁或文檔鏈接 |
permissions | 可選,列出插件啟動前需要授予的權限標識符 |
dependencies | 可選,列出依賴的其他插件 identifier,可使用 core>=1.0.0、helper==0.2 這樣的語法描述版本要求 |
kind | 可選,插件類型,默認 PluginKind.FEATURE,當插件僅提供 API/庫能力時可設為 PluginKind.LIBRARY |
訪問 manifest.short_label() 可獲得 name + version 的組合字符串。