MoodPet 是一个“一切皆插件”的开源情感陪伴平台。伙伴的性格、情绪表达、声音、UI 风格——全在插件里。容器的核心能力扩展——TTS、语音识别、额外面板——也在插件里。这套文档讲两件事：怎么开发一个插件，以及容器怎么把插件送到用户设备上。

插件开发者：想给 MoodPet 写一个 Friend（情绪伙伴）、Application（能力扩展）或整合包的人。从插件类型开始看，然后跳到对应类型的开发页面，最后看发布上架。

容器开发者：在 MoodPet Flutter 客户端里工作、需要理解或修改市场系统的人。直接看架构总览，然后按需跳到对应 API 页面。

插件市场本身是一个 GitHub 仓库：Tangmjiu/moodpet-plugin-market。仓库的目录结构就是插件索引——friend/ 目录下有哪些 .meta.json，市场里就有哪些 Friend 插件。没有 index.json，没有数据库，没有服务器。PR 合并即上架，客户端下拉刷新即见。

• 插件开发者：Fork 仓库 → 加文件 → 提 PR → CI 自动验证 → 合并上架
• 用户：在客户端浏览三个 Tab（伙伴 / 应用 / 整合包）、看详情、一键安装、自动检测更新
• 容器开发者：完整的市场数据层（配置 / 缓存 / 仓库 / 安装器 / 更新检查器）+ Riverpod providers + Material Design 3 UI

仓库	作用
moonpet	Flutter 客户端，包含市场数据层和 UI
moodpet-plugin-market	GitHub 上的插件市场仓库，存放所有插件包和元数据