release 0.1.13

mula.liu 2026-11-20 18:29:35 +08:00
commit 04fd52d631
7 changed files with 170 additions and 0 deletions

View File

@ -0,0 +1,45 @@
Shift 0.1.13 - Windows x64
系统要求
--------
- Windows 10 或 Windows 11(x64;ARM64 设备通过系统兼容层运行)。
- Microsoft Edge WebView2 Runtime。当前 Windows 10/11 通常已内置;如果 Shift
启动后窗口空白或无法打开,请从微软官方页面安装:
https://developer.microsoft.com/microsoft-edge/webview2/
- 安装与运行都不需要管理员权限。只有在“运行组件”里安装外部工具时,
Windows 才可能弹出 UAC 确认。
安装
----
1. 运行 Shift-Setup-0.1.13-win-x64.exe,默认安装到
%LOCALAPPDATA%\Programs\Shift,并创建开始菜单与桌面快捷方式。
2. 这是未签名构建。若 SmartScreen 显示“Windows 已保护你的电脑”,请选择
“更多信息” > “仍要运行”。
3. 卸载请在“设置 > 应用”中移除 Shift,无需手动删除文件。
4. 首次启动若 Windows 安全中心询问网络访问,请允许 Shift 访问“专用网络”。
如果之前拒绝过,请到“Windows 安全中心 > 防火墙和网络保护 > 允许应用通过
防火墙”,勾选 Shift 的专用网络权限;否则“发送到设备”无法接收其它终端的信标。
运行组件
--------
打开 Shift 主窗口,进入“设置” > “运行组件”:
- 首次进入该页会自动检测,之后只在你点击“重新检测”时重新扫描;
扫描范围包括 PATH、WinGet、Chocolatey、Scoop 与常见安装目录。
- 页面显示本机实际使用的组件、版本、路径与来源。
- 缺失组件旁有“安装”,通过 Microsoft WinGet 安装,界面不会阻塞,
完成后自动重新检测。
WinGet 包映射:
- Pandoc: JohnMacFarlane.Pandoc
- Typst: Typst.Typst
- FFmpeg: Gyan.FFmpeg
- Poppler: oschwartz10612.Poppler
- ImageMagick: ImageMagick.ImageMagick
如果没有 WinGet,界面会给出微软官方安装说明入口。Shift 不会从第三方站点
下载运行库,也不会卸载或覆盖你已有的工具。
校验
----
PowerShell:
Get-FileHash .\Shift-Setup-0.1.13-win-x64.exe -Algorithm SHA256

View File

@ -0,0 +1,102 @@
Shift 0.1.13 - macOS 通用(universal)
本文件说明 macOS 安装包是怎么打出来的、在其它机器上会遇到什么,以及如何自己校验。
完整细节见仓库 docs/RELEASE.md 的「macOS packaging」和 docs/ENGINEERING-NOTES.md
的「macOS DMG 打包与跨机器安装」。
关于这个安装包
--------------
Shift 的 macOS 产物只有一个:Shift-0.1.13-macOS-universal.dmg,通用二进制,Apple silicon 与
Intel 都能用。它既是新机器的首次安装方式,也是软件内升级的载体(更新清单里的 macos
键指向它)。清单的键必须是 .dmg,因为软件内升级的交接脚本要用 hdiutil 挂载镜像再
取出应用包;早期曾随包发布的 .pkg 在验证过 DMG 可用后就撤掉了,不为它多维护一份
产物。
本项目的构建是 ad-hoc 签名(src-tauri/tauri.conf.json 里 signingIdentity 固定为
"-"),且没有 Apple Developer ID 可做公证。Gatekeeper 因此无法为任何 Shift 构建背书,
一台新机器上会看到「身份不明的开发者」提示——这是可以放行的,见下节。
在其它机器上安装
----------------
新机器首次安装
1. 下载并双击 Shift-0.1.13-macOS-universal.dmg 挂载镜像。
2. 把 Shift.app 拖进「应用程序」(或任何你有权限的位置)。
3. 首次启动会被拦:「无法打开,因为来自身份不明的开发者」。点取消,然后
右键 Shift.app → 打开,或在「系统设置 → 隐私与安全性」中点「仍要打开」。
4. 只需允许一次,之后再打开正常。
macOS 权限
截图与录屏需要「屏幕录制」,输出目录需要「文件与文件夹」,带声音录屏需要
「麦克风」,「发送到设备」需要「本地网络」。Shift 会在打开截图遮罩前先检查屏幕
录制权限,被拒绝时给的是可操作的提示,而不是一张全黑截图。
「本地网络」被拒绝时 Shift 无法可靠地发送或接收设备信标,设备列表会一直是空的。
若看不到其它终端,请到「系统设置 → 隐私与安全性 → 本地网络」确认当前安装的
Shift 是打开的;那里可能留着多条目,因为每次重新构建都是一个新身份,请对准当前
安装的那一个。
注意:ad-hoc 构建每次的代码签名哈希都不同,而 macOS 把「屏幕录制」「本地网络」
这类授权绑在这个哈希上,所以一次升级后可能需要重新授权——这与手动重装是同一
后果。要彻底消除它,需要 Developer ID 证书加公证(见仓库 docs/ROADMAP.md 的 M5)。
发布前的硬性回归
构建机能够打开自己生成的 DMG,不代表发布包合格。每次发版前必须通过发布源在另
一台 Mac(最好从未安装过 Shift)用浏览器下载最终 DMG,以保留真实用户会遇到的
quarantine 标记;然后挂载、拖入 Applications、完成首次授权并启动,确认版本号
正确。随后打开 Drop,确认能看到另一台 Shift 终端且不会很快消失。若该版本同时
提供软件内升级,还要从上一版实际升级一次,确认不会出现 Gatekeeper 提示。任何
一项未通过都不得上传 DMG。
软件内升级
设置 → 软件更新 里检查并安装:Shift 自己下载 .dmg,先核对字节数与 SHA256,
再由一个独立脚本等本进程退出后挂载镜像、ditto 出新副本、去掉隔离属性、用两次
mv 换上新版本并重新打开。下载不走浏览器,新副本不带隔离属性,所以这一步没有任何
Gatekeeper 提示。
如何自己构建
------------
构建机需先装好两个 Rust 目标,以及 macOS 侧的原生伴生进程(AppKit 拖拽桥、PDFKit
与文档渲染,会被打成通用二进制):
rustup target add aarch64-apple-darwin x86_64-apple-darwin
pnpm install
pnpm mac:drag-bridge
生成通用应用与 DMG:
pnpm tauri build --target universal-apple-darwin --bundles app,dmg
`pnpm mac:release` 会构建、校验并复制为 artifacts/Shift-0.1.13-macOS-universal.dmg。
发布流程(清单、签名、推送)见仓库 docs/RELEASE.md。
若希望更新通道能校验来源,构建时把 ed25519 公钥编进去(发布流程见仓库
docs/RELEASE.md 的「Signing the channel」):
export SHIFT_RELEASE_KEY=~/.config/shift-release/release.ed25519
export SHIFT_UPDATE_PUBKEY=$(python3 scripts/release-key.py pubkey \
~/.config/shift-release/release.ed25519)
如何校验
--------
哈希(本目录下的 SHA256SUMS.txt 覆盖所有产物):
shasum -a 256 -c SHA256SUMS.txt
签名形态(adhoc 是当前刻意选择的形式,不是出错):
codesign -dv --verbose=2 /Applications/Shift.app 2>&1 | grep -E 'Signature|Identifier'
# Signature=adhoc
# Identifier=app.nex.shift
镜像完整性:
hdiutil verify Shift-0.1.13-macOS-universal.dmg
校验后仍打不开的话,请确认不是在压缩包预览窗口里运行的,并按上面的「新机器首次安装」
处理首次允许:右键 → 打开,或在「系统设置 → 隐私与安全性」中点「仍要打开」。

4
SHA256SUMS.txt 100644
View File

@ -0,0 +1,4 @@
07c5c0314c78c68f26e029afacef4cc343a5ce8afb67ed56dc79a21f5ae51435 Shift-0.1.13-macOS-universal.dmg
ddeecbdb56ede1b001342cfff2d3b68f6cb52011bb1f334aa39c37d0d09695a3 Shift-Setup-0.1.13-win-x64.exe
96e48edc8b761855fbbee25e14d0633a54c68904cd3645d828da1f5cdc073286 README-Windows-x64.txt
86177a57ffd4bc44d873c005e06a72596dfee02dc651644128bc7ab43545f061 README-macOS-universal.txt

Binary file not shown.

Binary file not shown.

18
shift-update.json 100644
View File

@ -0,0 +1,18 @@
{
"schema": 1,
"version": "0.1.13",
"date": "2026-11-20",
"notes": "图标、钉图放大、收藏标记,以及 Windows 安装与更新的修复(0.1.13 重发)。\n\n- 系统小图标改为黑白单色:托盘图标由系统着色,深色/浅色菜单栏都能自动匹配。\n- 应用图标与托盘共用同一份几何(六块扇形+中心挖出的加号),但在 Dock 与界面里仍是彩色平涂,两者一眼是同一个作品。\n- Windows 实测「运行组件」一键安装必然失败,四个原因都已修复:已经装过不再被当成失败;钉住 winget 源,不再卡在没人回答的源协议上;机器级组件会请求管理员权限;装完立刻能检测到了,不再谎报「找不到工具」。\n- 钉在屏幕上的图片新增「放大/还原」按钮:按屏幕可用区域放大并保持比例,不会跑到屏幕外,再点一下退回钉住时的大小。\n- 「最近使用」里收藏的文件在缩略图角上带常驻星标,不用悬停就能看出来。\n- 有新版本时主面板顶部会显示升级提示,点一下直接跳到设置 → 软件更新;提示跨启动保留,升级重启后也还在。\n- 降低闲置开销:实测空转 CPU 由 240ms/60s 降到 100ms/60s(伴生进程 −71%)。\n- 修复 Windows 应用内更新下载后重启失败:`cmd.exe /C` 会剥掉含空格临时路径的首尾引号,辅助脚本从未启动;现在路径经环境变量传入并保留外层引号。\n- 修复 Windows 静默安装可能被 WebView2 提示框永久卡住:无人可点的提示在静默更新中不再弹出。\n- 安装器在结束 Shift 进程后等待其真正释放 EXE,避免覆盖失败。",
"artifacts": {
"macos": {
"file": "Shift-0.1.13-macOS-universal.dmg",
"sha256": "07c5c0314c78c68f26e029afacef4cc343a5ce8afb67ed56dc79a21f5ae51435",
"size": 54939111
},
"windows": {
"file": "Shift-Setup-0.1.13-win-x64.exe",
"sha256": "ddeecbdb56ede1b001342cfff2d3b68f6cb52011bb1f334aa39c37d0d09695a3",
"size": 24520277
}
}
}

1
shift-update.sig 100644
View File

@ -0,0 +1 @@
5xpNemim5lripvfLWIxjWPmlHRpBsqnjjKFirRcOcRrE+9INuwebVMqKrLNUi8u7oFoMqyFHV8EIoFwO25zaCw==