Pluggable Desktop Plugins

Pluggable Desktop Service 的官方插件源码仓库。

当前包含可独立构建和下载的音乐与 AList 插件，目标为 Linux x86_64。主底座为 pluggable-desktop-service。

本仓库只承载官方插件源码、SDK 使用示例、测试夹具、registry 元数据源文件和发布工具。插件运行时、信任根、沙箱、安装器、授权、Secret Service、传输状态机和桌面 UI 归属底座仓库 pluggable-desktop-service。

初始边界

• 首期目标仅为 Linux x86_64 官方签名插件。
• plugins/music 是 media.music：本地音乐库、队列、mpv 播放、音源、下载及转换，保留用户的 localdesk/music.sqlite3 数据位置。
• plugins/alist 是 provider.alist：通过短期 credential lease 连接 AList，提供只读列表、元数据和文件读取。
• 插件依赖精确版本的 SDK 与类型契约。发布前的本地验证从底座生成 .crate 包，仅在本次构建中映射这些 package，不依赖底座源码目录。
• Git 不保存持续增长的插件二进制历史；发布制品应进入 Release 或独立制品存储。

目录

• plugins/：官方插件源码和包内测试。
• tools/：manifest、打包、签名、SBOM 和 provenance 工具。
• fixtures/：协议、SDK 和验收夹具。
• registry/：官方 registry 元数据源文件，不存放插件二进制。
• release/：发布流程、目标平台矩阵和产物清单定义。
• plugins/example-directory/：只读、无网络、无宿主文件访问的 deterministic SDK fixture。
• tools/plugin-release-tools/：release identity、SBOM、provenance 和摘要验证工具。
• docs/phase-0-consumer-contract.md：本仓库消费的 Phase 0 归属、准入、数据、发布和阶段门禁。

本地构建、GitHub 发布和可信目录配置见 发布指南。官方市场使用本仓库的 GitHub Releases；信任根和音乐发布者公钥位于 registry/，私钥不进入 Git。发布状态以 GitHub Release 为准。