commit a4949f10035b306154fd6718eee593824e17aab8 Author: mula.liu Date: Mon Oct 26 19:10:33 2026 +0800 release 0.1.5 diff --git a/README-Windows-x64.txt b/README-Windows-x64.txt new file mode 100644 index 0000000..cbdf51d --- /dev/null +++ b/README-Windows-x64.txt @@ -0,0 +1,47 @@ +Shift 0.1.5 - Windows x64 + +系统要求 +-------- +- Windows 10 或 Windows 11(64 位)。 +- Microsoft Edge WebView2 Runtime。当前 Windows 10/11 通常已内置;如果 Shift + 启动后窗口空白或无法打开,请从微软官方页面安装: + https://developer.microsoft.com/microsoft-edge/webview2/ +- 安装与运行都不需要管理员权限。只有在“运行组件”里安装外部工具时, + Windows 才可能弹出 UAC 确认。 + +安装 +---- +1. 运行 Shift-Setup-0.1.5-win-x64.exe,默认安装到 + %LOCALAPPDATA%\Programs\Shift,并创建开始菜单与桌面快捷方式。 +2. 这是未签名构建。若 SmartScreen 显示“Windows 已保护你的电脑”,请选择 + “更多信息” > “仍要运行”。 +3. 卸载请在“设置 > 应用”中移除 Shift,无需手动删除文件。 + +便携版 +------ +不想安装时,解压 Shift-Portable-0.1.5-win-x64.zip,直接运行其中的 +shift.exe。请先完整解压,不要在压缩包的预览窗口里运行。 + +运行组件 +-------- +打开 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.5-win-x64.exe -Algorithm SHA256 diff --git a/README-macOS-universal.txt b/README-macOS-universal.txt new file mode 100644 index 0000000..6c9c03b --- /dev/null +++ b/README-macOS-universal.txt @@ -0,0 +1,93 @@ +Shift 0.1.5 - macOS 通用(universal) + +本文件说明 macOS 安装包是怎么打出来的、在其它机器上会遇到什么,以及如何自己校验。 +完整细节见仓库 docs/RELEASE.md 的「macOS packaging」。 + + +关于这个安装包 +-------------- + +Shift 的 macOS 产物只有一个:Shift-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-macOS-universal.dmg 挂载镜像。 + 2. 把 Shift.app 拖进「应用程序」(或任何你有权限的位置)。 + 3. 首次启动会被拦:「无法打开,因为来自身份不明的开发者」。点取消,然后 + 右键 Shift.app → 打开,或在「系统设置 → 隐私与安全性」中点「仍要打开」。 + 4. 只需允许一次,之后再打开正常。 + +macOS 权限 + 截图与录屏需要「屏幕录制」,输出目录需要「文件与文件夹」,带声音录屏需要 + 「麦克风」,「发送到设备」需要「本地网络」。Shift 会在打开截图遮罩前先检查屏幕 + 录制权限,被拒绝时给的是可操作的提示,而不是一张全黑截图。 + 「本地网络」被拒绝时比较安静:Shift 照常发出广播,也能回应主动找它的实例,但收 + 不到组播,于是设备列表一直是空的。若看不到其它终端,请到「系统设置 → 隐私与安全 + 性 → 本地网络」确认 Shift 是打开的;那里可能留着多条目,因为每次重新构建都是一 + 个新身份,请对准当前安装的那一个。 + 注意:ad-hoc 构建每次的代码签名哈希都不同,而 macOS 把「屏幕录制」「本地网络」 + 这类授权绑在这个哈希上,所以一次升级后可能需要重新授权——这与手动重装是同一 + 后果。要彻底消除它,需要 Developer ID 证书加公证(见仓库 docs/ROADMAP.md 的 M5)。 + +软件内升级 + 设置 → 软件更新 里检查并安装: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 + +产物在 src-tauri/target/universal-apple-darwin/release/bundle/macos/ 下:Shift.app +与 Shift-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-macOS-universal.dmg + +校验后仍打不开的话,请确认不是在压缩包预览窗口里运行的,并按上面的「新机器首次安装」 +处理首次允许:右键 → 打开,或在「系统设置 → 隐私与安全性」中点「仍要打开」。 diff --git a/SHA256SUMS.txt b/SHA256SUMS.txt new file mode 100644 index 0000000..e6fa19a --- /dev/null +++ b/SHA256SUMS.txt @@ -0,0 +1,5 @@ +2a3ac89c05a574b9f5e1e7c5863decc857ad17e7061f033466a9ed7ac979f802 Shift-macOS-universal.dmg +3c312020dfd878c04bd95ae048aa19fc2e9718abcf9157fec01a965728d2519c Shift-Setup-0.1.5-win-x64.exe +f70dde3b8041f939fd77182136dd36092865826c4108686ebba5f3d0ea820a73 Shift-Portable-0.1.5-win-x64.zip +eee40e20d9e3507a28c5147513614aceb13a90982cd6b3459e02a8a66b89149b README-Windows-x64.txt +4afd64482d58f3edd396b1cdb4c18baa73de467a1fc922a50b199dd16696d032 README-macOS-universal.txt diff --git a/Shift-Portable-0.1.5-win-x64.zip b/Shift-Portable-0.1.5-win-x64.zip new file mode 100644 index 0000000..5339ea3 Binary files /dev/null and b/Shift-Portable-0.1.5-win-x64.zip differ diff --git a/Shift-Setup-0.1.5-win-x64.exe b/Shift-Setup-0.1.5-win-x64.exe new file mode 100644 index 0000000..a531054 Binary files /dev/null and b/Shift-Setup-0.1.5-win-x64.exe differ diff --git a/Shift-macOS-universal.dmg b/Shift-macOS-universal.dmg new file mode 100644 index 0000000..ec19916 Binary files /dev/null and b/Shift-macOS-universal.dmg differ diff --git a/shift-update.json b/shift-update.json new file mode 100644 index 0000000..550d9b8 --- /dev/null +++ b/shift-update.json @@ -0,0 +1,18 @@ +{ + "schema": 1, + "version": "0.1.5", + "date": "2026-10-26", + "notes": "修复升级到新版本后「发送到设备」找不到局域网内其它 Shift 终端的问题。\n\n原因是 macOS 的「本地网络」授权。本项目的构建采用 ad-hoc 签名,每重新构建一次就\n是一副新的代码身份,而系统正是按这个身份记录授权,因此每次升级都会重新要一次。\n此前 Info.plist 从未声明 NSLocalNetworkUsageDescription,缺少这一条系统不会弹出\n任何询问,应用于是静默地收不到组播——广播照发、别人主动找它也能回应,唯独列表\n一直是空的,看不出哪里出了问题。\n\n现在补上了这条声明,升级到 0.1.5 后系统会正常询问;也可以在「系统设置 → 隐私与\n安全性 → 本地网络」里手动打开。那里可能留着好几条 Shift,因为每个构建都是一个\n新身份,请对准当前安装的这一个。\n\n另外,「软件更新」面板里下载校验完成后的两个按钮此前是从「运行组件」页借来的密\n排样式,一个是 27px 的胶囊、另一个是没有边框的小字链接,看起来不像一组选择。现\n在是一对尺寸一致的按钮,主操作用主色强调;正在安装时只保留那一个按钮。", + "artifacts": { + "macos": { + "file": "Shift-macOS-universal.dmg", + "sha256": "2a3ac89c05a574b9f5e1e7c5863decc857ad17e7061f033466a9ed7ac979f802", + "size": 55504368 + }, + "windows": { + "file": "Shift-Setup-0.1.5-win-x64.exe", + "sha256": "3c312020dfd878c04bd95ae048aa19fc2e9718abcf9157fec01a965728d2519c", + "size": 24521557 + } + } +} diff --git a/shift-update.sig b/shift-update.sig new file mode 100644 index 0000000..ed93096 --- /dev/null +++ b/shift-update.sig @@ -0,0 +1 @@ +BFl381mHbdf9DItB+2GCso4ZN8/Y3F6TuV3tPZ1S1Vg1bbtw/56cyrqGGXae+tio8mK7h6VOlOl7YKbGAQgECw==