插件管理

paseo-plugin-management 是 Paseo 里的一个界面，用来同时浏览多个插件目录，并管理你从这些目录里安装的插件。侧边栏只有一项「Plugins」，打开就是这个界面：可以搜索，按来源、分类和安装状态筛选，在插件与主题之间切换，也可以打开任意条目查看它的说明、截图，以及它究竟会安装哪个产物。标题栏的按钮切到已安装列表，已安装列表里也有按钮切回市场。

主题有单独的标签页，以截图网格呈现。插件显示图标、简短说明、作者和目录报告的安装量，已安装或有可用更新时会有标记。每个条目都带有来源标记，所以同名插件来自不同来源时不会混淆。

市场源

市场把任意数量的源聚合成一个列表。内置两个源，默认启用：

• Paseo registry —— https://plugins.paseo.sh，官方 Paseo registry 协议 v1（index.json）。条目按 owner/slug 安装。
• Paseo Cafe —— https://paseo.cafe，Cafe 目录 API（api/plugins）。条目按它声明的 npm 包或 Git 仓库安装。

你可以在「设置 → 插件 → paseo-plugin-management」里添加自己的源。自定义源可以是上面任意一种，也可以让市场根据抓取到的内容自动识别形状。每个源都必须使用 HTTPS，或 localhost 上的 HTTP。插件目录条目决定会安装什么，所以只使用你信任的源。对于 daemon 无法直接安装的源（例如托管在路径前缀下的源），市场会显示需要你自己执行的命令，而不是安装按钮。

某个源无法访问时，市场继续展示已加载源的结果，并单独报告该源的失败原因。

工作原理

daemon 下载每个启用的源并缓存五分钟。条目的说明在你打开时从同一个源抓取。截图和图标由你的 Paseo 应用直接从条目声明的 URL 加载，通常是 GitHub 或某个包 CDN，因此这些主机会看到你的请求。

安装、更新、启用、禁用、重载和卸载都会在 daemon 主机上运行 paseo 命令行。安装前，应用会显示已锁定的 npm 版本或 Git commit，以及它来自的仓库，由你确认。daemon 随后安装的正是这个已审阅的产物。如果在你打开审阅之后目录移动了锁定点，安装会被拒绝。不会自行安装任何东西：每一次安装、更新、启用、禁用、重载和卸载都由你发起。

语言

界面提供英文和中文。paseo-plugin-management 的设置里有「语言」选项：自动跟随系统语言，无法判断时回退到英文；也可以固定其中一种。条目正文（例如 README 和注意事项）不翻译，按插件自己提供的语言显示。

环境要求

paseo-plugin-management 需要 Paseo 0.11.0 或更高版本，并且 daemon 的 PATH 上有 paseo 命令。

能力与限制

• 自动更新默认关闭。在已安装列表或插件详情页打开后，daemon 启动 30 秒后检查一次，之后按 paseo-plugin-management 设置里的间隔执行，默认 720 分钟。每个启用的插件会移动到它当前的目录锁定点，或 npm 包 / Git 源的最新版本；某个插件失败不会影响其他插件。用本地目录安装的插件永远不会被自动更新；也可以在设置里立即执行一次检查。
• 市场侧边栏项显示有可用更新的插件数量。
• 已安装视图列出你安装的所有插件，提供启用、禁用、重载、更新和卸载操作，以及每个插件报告的状态。
• 一个输入框附件来源让你把插件条目的说明附加到 prompt，让 agent 在安装前先审阅。条目文本随后成为该 prompt 的一部分，并按你其他消息的方式到达 agent 提供方。
• paseo-plugin-management 在它的 Paseo 设置里保存你的源、上次的搜索与筛选、你打开了自动更新的插件，以及你禁用的插件。它只联系你启用的源；安装和更新按 paseo 命令原本的方式从 npm 或 Git 获取产物。
• 在目录出现之前从 npm 或 Git 安装的插件会按包名或仓库识别，匹配到条目时显示为已安装。
• 列出的插件来自社区提交。它们仍然在你的 daemon 主机上以无沙箱方式运行，所以安装前请阅读插件源码。