安装与管理插件

从商店安装

打开管理窗口“商店”。当前代码首次初始化加入社区 stable/testing 来源；来源内容取决于服务和设备配置。没有目录或插件时，进入“插件源”添加开发者提供的完整 HTTPS catalog.json 地址。
可按关键词、标签、来源或安装状态筛选。
打开详情，查看作者、介绍、更新记录、运行用户和依赖。默认显示推荐版本，历史版本会按需加载。
点击安装或检查所选版本。下载、校验和依赖解析完成后，阅读确认页。
检查包内实际运行用户以及依赖带来的 root 权限，确认后安装。安装后在插件列表启用或打开。

商店提供的运行用户只是目录资料，最终确认以下载包内声明为准。steamos 使用 Steam 会话用户，root 可修改系统和设备设置。包哈希用于校验内容，不等于对作者身份或安全性的担保。

单个目录地址：在“插件源”添加名称和 https://.../catalog.json，测试连接后保存。

多个源的订阅：在“源订阅”粘贴开发者提供的订阅 JSON 地址，预览所含来源后确认添加。它和单个目录不是同一种文件。订阅刷新仅更新来源和商店资料，不自动安装或更新插件。

停用或删除来源不会自动卸载已安装插件；订阅管理的 URL 变更需另行确认。格式与刷新行为见源订阅参考。

插件包扩展名为 .framely，无需自行解压。进入管理窗口“插件”，打开导入入口：

两种方式都需要阅读安装确认，涉及运行用户变更时另行确认。导入的是插件包；Framely 本体 tar.gz 和普通 ZIP 不能作为插件安装。

在 Frame 的 SSH 终端也可安装：

sudo /var/lib/framely/current/bin/framely install ./plugin.framely --approve

只有在确认旧版到新版确实需要改变运行用户时才增加 --approve-run-as。命令行不会代替你判断来源是否可信。

商店提示“可更新”时进入详情，查看变化后按安装确认流程更新。需要旧版时，在详情选择历史版本再检查；换来源也会明确提示。设置和收藏通常保留，但运行用户改变会使用另一份数据目录，不自动迁移旧身份的数据。

从插件管理弹窗卸载。卸载钩子负责清理该插件的外部资源，保存的数据保留；不要直接删除系统中的插件目录。停用只停止使用，不卸载程序和数据。