SUZENT / 文档
SUZENT 使用手册

更新

如何更新 Suzent、修复快捷方式,以及跨版本升级已有安装时需要注意什么。

从 Microsoft Store 安装?

Store 版和其他 Store 应用一样,由 Microsoft Store 负责更新。本页其余内容适用于安装程序版和终端安装版:Store 版中 suzent update、suzent upgrade、suzent repair 以及应用内更新均已停用。更新不会影响 ~/.suzent 中的数据。

自动更新

Suzent 会自动保持最新。它每隔几个小时检查一次新版本,并在你继续使用时于后台下载。新版本会在 Suzent 下次关闭或启动时安装,只需几秒钟,安装后桌面应用会提示你已更新。如果 Suzent 以后台服务方式运行且没有打开桌面应用,它会在凌晨 3 点到 5 点之间、且所有对话都已空闲 30 分钟时安装更新。

要关闭自动更新,可以在 设置 → 关于 中取消勾选 自动更新,或运行:

suzent auto-update off      # 也可以用 on、status

在环境变量中设置 SUZENT_AUTO_UPDATE=0 同样可以关闭。

以下更新不会自动安装,需要你自己来(点击更新按钮或运行 suzent update):

  • 新的大版本;
  • 改动过 Suzent 自身文件的安装;
  • 源码仓库安装(跟随开发分支);
  • 已经失败两次的更新,此后 Suzent 会停留在当前可用的版本。

更新到最新版本

suzent update

这会把 Suzent 和桌面应用一起更新到同一个经过测试的版本。如果更新过程中出现问题,Suzent 会自动恢复到更新前的版本。如果更新途中电脑断电或被强制关机,请运行 suzent repair。

如果你是从源码仓库安装的 Suzent(用于开发),suzent update 会改为跟随最新的开发版本。

每个版本的具体改动见更新日志。

修复应用快捷方式

每次安装和更新都会创建或修复 Suzent 在开始菜单(Windows)、应用程序文件夹(macOS)或应用菜单(Linux)中的入口。想手动修复,或调整快捷方式出现的位置:

suzent shortcuts                    # 修复
suzent shortcuts --desktop          # 同时添加桌面快捷方式
suzent shortcuts --no-menu          # 移除菜单入口
suzent shortcuts --remove           # 移除 Suzent 创建的所有快捷方式

你的选择会在之后的更新中被记住。

从旧版本升级

全新安装无需关注这一部分。如果你在升级已有的安装,请找到你当前的版本,阅读之后每个版本的说明。

v0.10.0 之前:记忆升级

0.10.0 版本改变了记忆的存储和整理方式。大部分工作会自动完成,但有几点值得了解。

第一次运行会更慢,并消耗更多向量嵌入调用。 Suzent 会重建一次记忆搜索索引,重新读取所有每日日志和笔记本页面。如果你的向量嵌入按次计费,预计会有一笔与记忆总量成正比的一次性开销。

删除旧的笔记本文件夹前先检查。 如果你把笔记本移到了自己的文件夹(例如一个 Obsidian 知识库),~/.suzent/notebook 下的默认笔记本文件夹里可能仍有真实页面,它们是在某次找不到你的知识库时写入的。这个文件夹看起来像是空的残留物,删除前请先和你真正的知识库对比。

很早的记忆可能只存在于搜索索引中。 如果你在记忆改为 Markdown 存储之前就在用 Suzent,有些记忆在别处没有副本,请不要删除它们。在关闭 Suzent 的情况下,从 Suzent 文件夹运行下面的命令,查看有多少条,并把它们复制到每日日志中:

python scripts/retire_legacy_rows.py            # 只报告
python scripts/retire_legacy_rows.py --export   # 保存到每日日志

已有的 MEMORY.md 不会被覆盖。 MEMORY.md 现在是一份指向笔记本页面的简短链接地图(见 MEMORY.md 是一张地图),Suzent 不再重写它。要转换旧文件,运行 suzent memory cleanup:它会把建议的地图和其他修改写在记忆旁边供你查看,在你应用之前不会改动任何内容。

前几次 dream 之后笔记本会出现大量改动。 Suzent 会为已有页面添加复查日期和确认计数。如果你的笔记本在 Git 或同步文件夹中,这些改动是正常的。

搜索结果的排序可能会变化。 经常被确认的事实和你亲手写下的内容排名更高,过时的内容排名更低。没有任何内容会被删除。

重复的事实不再写入每日日志。 只是重复已有记录的事实会被计数,而不是再写一遍。计数保存在 notebook/.state/confirmations.jsonl 中。

在 GitHub 上编辑此页 ↗

本页内容