请确保至少读完此处的内容,再继续使用 Serein。
Serein 依赖 Tracker 和规则表来运行。
Tracker 是一个列表,记录了你需要检查更新的软件 ID。
程序会根据 ID,在规则表中查找,并使用找到的规则,来获取新版本的版本号和下载链接。
默认的规则表 SereinRulesList 由 Vanadiry 维护。
如果你需要新的规则,可以自行创建,或者在默认规则表的仓库中提交 Issue 或 PR。
程序默认将 ~/.vSoft/Serein/ 视为程序的主目录。你可以通过环境变量 SEREIN_HOME 覆盖。
配置文件位于主目录的 config.toml 文件。
Serein 首次启动时,会生成默认配置:
[serein]
host = "127.0.0.1" # 监听地址,设为 0.0.0.0 则允许局域网访问
port = 12510 # 监听端口
first_run = true # 首次运行时展示欢迎指引,设为 false 可永久关闭
[tracker]
platforms = ["macos", "windows"] # 全局平台偏好,可被 Tracker 中的记录覆盖
[download]
concurrency = 8 # 检查更新时的并发数,最大允许 64
# downloader = "browser" # 下载器:browser(默认)| builtin | ndm | 自定义命令({url}替换为链接)
[access]
# github_token = "github_pat_xxx" # GitHub 令牌,用于提升请求限制
[profile] # 动态配置,指向 profile.json 文件
url = "https://raw.githubusercontent.com/Vanadiry/SereinRulesList/refs/heads/main/profile.json"
[[rule_sources]] # 规则源,默认为 Vanadiry 维护的规则源。你可以添加新的 url 来指定更多
url = "https://raw.githubusercontent.com/Vanadiry/SereinRulesList/refs/heads/main/_source.json"
[[rule_sources]] # 规则源 2
url = "https://222.xx/"如果你追踪的位于 GitHub Release 的软件比较多,那么建议你配置这个。
因为 GitHub 对未认证请求限制 60 次/小时,配置 Token 后提升至 5000 次/小时。
访问 GitHub Personal access tokens,点击 Generate new token。
设置名称和你想要的 Expiration 过期时间,其他全部默认即可,然后创建。
创建后,将 Token 写入到配置文件的 [access] 节,即可提升请求次数上限。
Serein 不会收集你的 Token,请勿将 Token 外泄。
在 [download] 节配置 downloader,留空则为默认:
browser(默认):在浏览器中打开下载链接,调用浏览器下载ndm:Neat Download Manager- 自定义命令:如
"aria2c {url}"、"IDMan.exe /d {url}",{url}会被 Serein 替换为下载链接
对于 VSIX 下载,使用 ndm 或自定义命令时会自动使用内建下载弹窗。
规则源可以配置多个,每条都必须指向一个 _source.json 文件,远端或本地皆可。
如果你是规则编写者,请查看 rules/source。
Serein 从远端拉取 profile.json 来自动更新前端行为,例如何种链接被下载器捕获、版本前后缀去除。
你可以在规则页面右上角拉取动态配置。
Tracker 文件存放在主目录的 tracker 目录下,每个 .toml 文件为一个 Tracker,你可以创建多个。
基本格式为:
display_name = "Tracker Name" # 可选,仅供前端展示
order = 1 # 可选,排序(数字小的在前)
type = "app" # 可选,类型(默认为 app,表示普通应用,或 msvsix / openvsx)
[[tracker]]
app_id = "vanadiry-seshat"
platforms = ["macos"] # 追踪平台。
[[tracker]]
app_id = "vanadiry-serein"
platforms = ["windows", "linux"]Tracker 中的 platforms 优先级高于配置文件中的 platforms。
当在配置文件中设置了追踪 A 和 B 平台,但 Tracker 中仅设置了 A,则最终只会检查 A 平台的更新。
不写此字段,将继承 [tracker] 节中的 platforms 设置。
可以从规则页面搜索规则并添加到默认 Tracker。
推荐你根据 Tracker 格式,手动创建和管理。
对于 VSCode 使用的 VSIX 扩展,Serein 内置了一套规则。
这使得无须规则表即可追踪来自“VS 插件市场”和“OpenVSX”的内容。
如何编写 Tracker,请查看rules/vsix
主目录下共有 3 个子目录、1 个文件存放重要数据。
rules/:规则表tracker/:追踪列表user/:已追踪软件版本、确认时间,以及动态配置config.toml:Serein 主配置
通常,你只需要备份 tracker/ 和 user/profile.json 即可。
你可以按需求决定。