安装和更新 Sally

Sally 无需安装程序。发布包是适用于您平台（x64、x86 或 ARM64）的 .zip 文件；将其解压到有写入权限的文件夹，例如 C:\Tools\Sally，然后运行sally.exe。将plugins、toolbars和utils文件夹保留在sally.exe旁边。设置按用户保存在该文件夹之外，因此更新不会影响设置。

Sally 的更新程序utils\salupdate.exe会在 GitHub 上查找并安装新版本。Sally 本身不会联网检查更新，而是启动更新程序。

从 Sally 1.0.38 起，更新程序遵循 Sally 中选择的语言，即使 Windows 使用其他语言也会采用所选的英语。如果没有配置有效的 Sally 语言，则选择可用的 Windows 语言，并在必要时回退到英语。其窗口和确认消息使用 Sally 的对话框字体及应用程序图标。从 1.0.40 起，更新程序在配置了自定义面板字体时使用该字体，否则使用 Windows 对话框字体，并遵循已保存的应用程序图标颜色。

从 Sally 更新：

选择帮助/检查新版本。更新窗口会打开，向 GitHub 查询最新版本，并显示已安装版本、最新版本及发布说明。
显示新版本时，单击安装并重启。
更新程序下载发布包，根据随包发布的 SHA-256 校验和进行验证，解压后请您确认。
从同一文件夹启动的所有 Sally 窗口都会关闭，替换文件后重新启动 Sally。更新窗口随后会告知更新结果。

打开发布页面会显示 GitHub 上的发布版本。只有单击安装并重启才会安装。

发布说明和自愿支持

从 Sally 1.0.39 起，更新窗口将更新内容与来自维护者分开显示。经过签名的内容可提供所选语言的说明；可选内容无法加载时，仍提供英文发布说明。维护者消息向所有人显示。内容缺失不会妨碍免费更新。

帮助/更新内容完全离线打开已安装版本附带的说明，不检查新版本或安装任何内容。在其中使用检查更新可明确发起联网检查。

支持 Sally打开资金支持页面。在 1.0.40 中，自愿支持操作会出现在更新检查和简洁的更新成功确认窗口中。自愿获取的支持者密钥可启用支持者徽章：在关于及可选的 Sally 标题中显示您选择的名称。支持期限有效或尚未开始时，更新程序隐藏支持及输入密钥按钮。您仍可在关于中查看名称、日期及管理密钥；维护者消息仍然显示。所有功能和更新始终免费。关闭仅关闭更新窗口，不更改支持者偏好设置。

输入支持者密钥允许粘贴密钥或导入其文件。验证自动离线完成；检查名称和日期后，选择保存密钥。在关于中，支持者详情显示已保存的名称和支持日期。可选的标题名称复选框会立即保存。使用关闭旁的小箭头可替换、导出或经确认后在本地移除密钥。您的名称仅在自己的计算机上本地显示。

通过 PayPal 或 Buy Me a Coffee 支持后，使用支持页面上的申请链接，向badges [at] get-sally [dot] app发送邮件，提供希望显示的徽章名称、接收地址、付款平台及付款名称或交易参考信息。密钥人工签发，通常在一周内完成。所有功能和更新始终免费。

两个阅读面板中的链接均可用鼠标或右键菜单打开：将焦点移到面板，按 Shift+F10 或 Applications 键。

自动更新计划

Sally 也会自动查找新版本，默认每周一次，除非您在检查更新选项中另作选择（位于配置/常规，可从每天到每六个月，或从不）。没有新版本时不显示任何内容；发现新版本时，更新窗口不会抢占当前操作的键盘焦点，其任务栏按钮会闪烁。如果无法连接 GitHub，Sally 会在第二天重试。

截至 Sally 1.0.36，此功能由 Check Version 插件负责。Sally 1.0.37 接管其计划并移除该插件。

从自行下载的版本更新（也可离线）：

将适用于您平台的发布版 .zip 文件下载到某个文件夹，如有可能，也将其Sally-v<version>-SHA256SUMS.txt下载到同一文件夹。
将 .zip 文件拖放到 Sally 文件夹中的utils\salupdate.exe上，或运行utils\salupdate.exe <path to the .zip>。
更新程序显示已安装版本和新版本（安装旧版前会询问），说明 Sally 是否正在运行，并询问一次。Sally 关闭后，文件被替换，随后重新启动 Sally。

更新程序的命令行

<file>.zip	安装自行下载的版本（见上文）。
--yes	对所有问题回答是，并且不显示消息运行；仍会显示错误。结果会写入日志（见下文）。
--install <folder>	更新该文件夹中的 Sally，而非更新程序所在文件夹中的版本。
--check	打开更新窗口，与帮助/检查新版本相同。
--whats-new	离线显示已安装版本附带的说明，与帮助/更新内容相同。可与 --install 组合以选择 Sally 文件夹；此模式不接受联网检查和安装操作开关。
--auto	与 --check 合用：仅在有新版本时显示内容，与 Sally 自身的检查相同。退出代码为 0 表示 Sally 已是最新版本，1 表示显示了窗口，2 表示无法连接 GitHub。
--feed <address>	与 --check 合用：查询另一个以 GitHub 发布源格式响应的 HTTPS 地址（镜像）。
--report --result <file>	显示生成该结果文件的更新操作的结果。Sally 在更新后启动它。

不指定文件运行salupdate.exe，可撤消因断电等原因中断的更新。Sally 会使用其他内部开关（--prepare、--apply及其参数）启动更新程序来安装版本；这些开关不供用户手动输入。

更新会更改什么

仅替换发布包中的文件。非发布包文件（例如导出的配置或自行添加的文件）保持不变。
旧版本安装而新版本已不再包含的文件（例如 1.0.37 中移除的 Check Version 插件）会被删除。发布包在 Sally 文件夹的sally-update.obsolete中列出此类文件。
新文件准备就绪前不会做任何更改。如果有文件无法替换，会将所有文件精确恢复原状。
Windows 资源管理器会持续加载 Sally 的外壳扩展（utils\salextx64.dll、salextx86.dll或salextARM64.dll）。更新程序将已加载文件重命名到一旁，例如salextx64.dll.sally-old，再将新文件放到原位置；待资源管理器不再使用旧文件后，Sally 会在以后启动时删除旧副本。无需重启 Windows。
如果 Sally 文件夹位于Program Files中，会请求一次管理员权限，仅用于替换文件。

安装前，更新程序确认软件包是适用于您处理器的 Sally 发布包，并拒绝可能写入 Sally 文件夹之外的软件包。不符合已发布 SHA-256 校验和的软件包会被拒绝；没有可供比较校验和的软件包，仅在您确认后安装。

出现问题时查看哪里

更新程序的日志和最近结果：%LOCALAPPDATA%\Sally\Update\salupdate.log和result.txt。下载文件会保留在同一文件夹中，直到更新完成。
您随时可以手动更新：关闭 Sally，将新版本解压到 Sally 文件夹并覆盖。如果 Windows 提示salextx64.dll正在使用，请重命名该文件后重新复制。
Sally 1.0.35 及更早版本没有更新程序，需要先手动更新一次。

另请参阅

配置/常规
 此发行版的新功能
 使用参数启动 Sally