配置
sivtr 使用统一 home 下的 TOML 配置文件(默认 ~/.sivtr,可用 SIVTR_HOME 覆盖)。配置控制编辑器交接、archive 同步新鲜度、TUI 主题、MCP idle 退出和 Windows 热键按键。
sivtr config showsivtr config initsivtr config edit| 命令 | 行为 |
|---|---|
sivtr config show |
打印配置路径和有效文件内容或默认值 |
sivtr config init |
如果配置不存在,则创建默认配置 |
sivtr config edit |
必要时创建配置,并用配置的编辑器打开 |
[editor]command = ""
[sync]max_age_secs = 15
[hotkey]chord = "alt+y"
[theme]mode = "auto"
[mcp]idle_exit_secs = 60
[publish]endpoint = "https://share.hnnulwh.cn"[publish].endpoint 是加密公开链接服务地址。当前正式入口使用 https://share.hnnulwh.cn,由 Nginx 反向代理到同一台服务器上仅监听 loopback 的 Sivtr publication 服务;staging 或其他托管方式可以改为兼容同一 /api/v1 契约的 endpoint。该配置不会增加第二套认证路径。
字段级说明见配置文件。
Archive 同步新鲜度
Section titled “Archive 同步新鲜度”查询从统一的本地 archive(archive.db)读取。当 archive 比 [sync].max_age_secs 更旧时,查询会先触发一次增量同步:
[sync]# archive 距上次同步多少秒后,查询会触发一次增量重同步。0 = 每次查询都重新列目录。max_age_secs = 150 表示每次查询都重新列目录;调大则以新鲜度换延迟。用 sivtr sync 可强制执行一次同步。见数据位置。
[hotkey]chord = "alt+y"除非使用 --chord 覆盖,否则 sivtr hotkey start 会使用这个按键。
Provider 选择是运行时 CLI 选项,不是配置项:
sivtr hotkey start --provider allsivtr hotkey start --provider claudeTUI 主题
Section titled “TUI 主题”[theme]mode = "auto"auto 跟随系统外观,并根据终端能力选择 truecolor 或 ANSI 调色板。用 dark 或 light 强制配色:
[theme]mode = "dark"MCP 空闲退出
Section titled “MCP 空闲退出”[mcp]idle_exit_secs = 60无工具调用多少秒后 stdio MCP server 退出(0 = 保持到宿主关闭 stdin)。sivtr mcp serve --idle-exit flag 可在单次调用时覆盖此值。