mirror of
https://github.com/SteamFramelyHomebrew/framely.git
synced 2026-10-28 10:02:11 +01:00
27 lines
1.9 KiB
Markdown
27 lines
1.9 KiB
Markdown
# 插件源订阅（Framely 0.4）
|
||
|
||
[English](en/source-subscriptions.md)
|
||
|
||
在管理窗口“插件源 → 源订阅”粘贴 HTTPS JSON 地址，预览后确认添加：
|
||
|
||
```json
|
||
{
|
||
"schemaVersion": 1,
|
||
"name": "Framely 社区源",
|
||
"sources": [
|
||
{"id":"stable", "name":"社区稳定版", "url":"https://example.org/stable/catalog.json"},
|
||
{"id":"testing", "name":"社区测试版", "url":"https://example.org/testing/catalog.json"}
|
||
]
|
||
}
|
||
```
|
||
|
||
每个源 id 在订阅内唯一且稳定，用于识别地址变更。禁止重复 URL、嵌套订阅、HTTP、带认证信息的 URL，最多 100 个源、512 KiB；每台设备最多 20 个订阅、200 个插件源。目录、包、图片继续由各源或作者托管，订阅只聚合目录地址。
|
||
|
||
默认每天自动刷新，也可关闭自动刷新或立即刷新。自动检查在 Framely 会话运行期间进行，启动后检查到期项；支持 ETag/Last-Modified 和最多五次 HTTPS 重定向。离线/失败保留已持久化的上次成功源列表，记录错误，按一分钟起的指数退避重试，最多一天。
|
||
|
||
新增源自动纳入；名称自动更新。相同 id 的 URL 改变时保留旧地址，显示待确认变更，确认后才采用新地址。刷新订阅后同时刷新插件目录。目录缓存沿用会话内缓存，重启后的离线商店不保证有目录缓存。
|
||
|
||
目录 URL 规范化后去重，一个源可由多个订阅和手动添加共同引用。删除订阅或移除订阅中的源只移除对应引用；没有任何引用才从源列表移除。已安装插件、来源记录和数据保留，不静默切换来源。
|
||
|
||
可在插件源列表单独停用源，刷新不会重新开启；即使移除后又加入同一 URL，也保留停用偏好。订阅源的 URL 在待确认变更中管理。刷新只更新源列表、商店资料和更新提示，不自动安装、更新或启用插件。
|