插件源數據

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.0helper==0.2 這樣的語法描述版本要求
kind可選,插件類型,默認 PluginKind.FEATURE,當插件僅提供 API/庫能力時可設為 PluginKind.LIBRARY

訪問 manifest.short_label() 可獲得 name + version 的組合字符串。