Releases: zalify/offdesk
Release list
Offdesk 0.7.1 RC.1 — Cloud onboarding & Hub switching
Offdesk 0.7.1 RC.1 — Cloud onboarding and Hub switching
这是测试候选版。Android 与 macOS 应用名为 Offdesk RC,可与正式 App 并存。iOS 使用同一 TestFlight App,安装后替换当前 iOS 测试版本。
- App: 0.7.1-rc.1;iOS: 0.7.1 (28.1)。
- macOS 内置 Hub/Node: 0.21.1-rc.1。
- 源码:
3a1fa859ef73197394f4003467d802c54cd8e623,已合并的 #466。 - Cloud 控制台:https://cloud.offdesk.dev/ 。服务端实现保留在私有仓库。
这次测试什么
- 点击手机终端标题 → Hub & connection,能找到已保存的 Hub、连接方式以及添加/扫码入口;窄屏顶部保持紧凑。
- 使用 App 内的加密配对,确认 Hub 身份。局域网与远程连接可切换,不可达的选项正确提示。
- 添加第二个 Hub,来回切换后,终端内容和输入始终属于选中的 Hub。
- 目标 Hub 断网或连接失败时,原来的 Hub 保持选中并可重试;退出 App 重开后仍记得配对和选中的 Hub。
- 旧 RC 覆盖升级后已有配对保留;新装 RC 有独立配对记录,需要扫码一次。
- Mac 上检查 Cloud 登录、开通与连接验证、手机配对引导;Cloud 网页检查 Overview / Get started / My Hub / Pair a phone / Beta access / Account & security / Activity / Connection help。
Mac 首次安装测试请使用单独的 macOS 测试账号(例如 offdesk-test)。 App 身份独立,但“设为 Hub”仍管理当前 macOS 用户的 Hub/Node 服务,不能把同一用户下的两个 App 当成两个隔离的 Hub。Cloud 邀请测试期每个账号一个 Hub;已有 Hub 的账号请保留原来的 Hub 身份。
Android/macOS 的 RC 不走正式版自动更新。macOS RC 为本地临时签名,未公证,适合受控测试。iOS 已上传并通过 Apple 处理,待 App Store Connect 中启用现有内部 TestFlight 测试组。
English
This candidate adds Cloud setup guidance and a compact mobile Hub/connection picker. It retains multiple encrypted Hub pairings, verifies Hub identity and route reachability, keeps the previous Hub on a failed switch, and restores saved state after relaunch.
Android and macOS install as Offdesk RC beside the stable app. iOS 0.7.1 (28.1) uses the existing TestFlight app and replaces its current build. The bundled macOS Hub/Node version is 0.21.1-rc.1.
Please test encrypted pairing, LAN/remote selection, switching between two Hubs, failed-switch recovery, upgrading an existing RC, and relaunch persistence. Use a separate macOS user for clean Hub onboarding: desktop RC app storage is separate, but Hub services belong to the macOS user. Existing Cloud accounts retain their current Hub identity; the invitation beta includes one Hub per account.
The macOS RC is locally ad-hoc signed and not notarized. Android uses the existing RC test signature. No stable update channel or public download default is changed by this prerelease.
验证记录 / Verification
- Cloud: 25 tests passed; eight live authenticated pages checked; no pending database migration.
- Android: cold start, WebView input, foreground, retained-pairing upgrade and recovery passed on the Mac Mini emulator.
- macOS: bundled Hub isolated startup, embedded RC entry assets, app signature integrity and DMG integrity passed.
- Physical-device Cloud onboarding and multi-Hub switching remain the acceptance tasks for this RC.
Offdesk 0.21.0
Offdesk 0.7.0 / Hub 0.21.0
中文
本轮正式版将桌面端、Android 和 iOS 的版本统一提升至 0.7.0,Hub、Node 和 CLI 提升至 0.21.0。
新增功能
- 网页预览:通过 Hub 打开所选机器上的 localhost HTTP 服务,支持流式响应和 WebSocket 热更新。需要同时更新 Hub 与 Node,并自行配置专用预览域名、TLS 和入口;升级后不会自动开启。
- 附件多选:一次选择多张照片或多个文件,发送前可查看清单、移除单个附件或取消发送。
体验改进
- 改善手机端节点卡片中的延迟、CPU、内存和磁盘指标布局,避免信息挤出卡片。
- 优化附件确认弹窗在窄屏和较大字体下的布局,让文件清单可滚动,操作按钮更容易完整显示。
- 在桌面连接引导中提供更明显的返回入口,并改善宽屏 Settings 的内容布局。
- 明确区分 App 加密配对与浏览器登录的用途及扫码说明,减少两种二维码带来的困惑。
- App 名称、官网与 README 的品牌名称统一使用 Offdesk。
问题修复
- 恢复事件中断期间遗漏的待确认提醒。
- 保留熟悉的 JetBrains Mono 终端字体,加入很小的符号补充字体,修复
⏵⏵等播放控制符号显示为方框的问题。 - 改善 TestFlight 发布流程:按准确版本与构建号分发,重试时保留已完成的加密分类和测试组设置,并支持填写本轮测试说明。
升级说明与已知限制
- macOS、Linux、Windows 和 Android 使用各自的正式安装包;iOS 通过 TestFlight 分发,实际可用时间取决于 Apple 处理和审核。
- 覆盖升级原来的正式版以保留配置与配对。Offdesk RC 是独立测试安装,不会自动替代正式版。
- 加密连接使用 App 内置前端,因此需要同时更新 App 与 Hub。macOS/Linux 安装包内置 Hub 和 Node 0.21.0;独立部署的节点应另外更新。
- 网页预览使用 HTTPS,不属于终端的端到端加密通道。预览连接复用与缓存优化继续由 #456 跟进,不影响未开启预览的终端功能。
- 部分 Android 扫码黑屏反馈仍由 #448 跟进。本轮不宣称解决所有启动或扫码异常;iOS 原生附件选择流程仍欢迎真机测试反馈。
English
This stable release brings the desktop, Android and iOS apps to 0.7.0, alongside Hub, Node and CLI 0.21.0.
New features
- Web previews: open localhost HTTP services on a selected machine through the Hub, including streaming responses and WebSocket hot updates. Update both Hub and Node and configure a dedicated preview domain, TLS and ingress. Upgrading does not enable previews automatically.
- Multiple attachments: select several photos or files at once, review the list, remove individual items or cancel before sending.
Experience improvements
- Keep phone host latency, CPU, memory and disk metrics within their cards.
- Improve attachment review on narrow screens and with larger text, with a scrollable file list and more accessible action buttons.
- Make the return path in desktop connection setup more prominent and improve Settings layout on wide screens.
- Clarify the separate purposes and scanning instructions for encrypted App pairing and browser sign-in.
- Use Offdesk consistently across App names, the website and README.
Fixes
- Restore confirmation reminders missed during an event gap.
- Keep familiar JetBrains Mono terminal text and add a tiny symbol fallback to fix missing playback glyphs such as
⏵⏵. - Improve TestFlight distribution with exact version/build selection, retries that preserve completed encryption classification and group assignment, and release-specific testing notes.
Upgrading and known limitations
- Use the stable package for macOS, Linux, Windows or Android. iOS is distributed through TestFlight; availability depends on Apple processing and review.
- Upgrade the existing stable App in place to retain configuration and pairing. Offdesk RC is a separate test installation and does not replace the stable App automatically.
- Encrypted connections use the frontend bundled with the App, so update the App as well as the Hub. macOS/Linux packages include Hub and Node 0.21.0; update separately deployed nodes too.
- Web previews use HTTPS and are not carried inside terminal end-to-end encryption. Preview connection pooling and cache optimization remain in #456; terminal use without previews is unaffected.
- Some Android scanner black-screen reports remain open in #448. This release does not claim to resolve every startup or scanner issue. Physical-device feedback on the native iOS attachment picker is still welcome.
iOS 0.7.0
Offdesk iOS 0.7.0
- Select multiple photos/files, review and remove items before sending, with an attachment dialog that adapts to narrow screens and large text.
- Keep mobile host latency/resource metrics within their cards and restore missed confirmation reminders after event gaps.
- Restore JetBrains Mono terminal text with a tiny fallback for missing playback symbols such as
⏵⏵. - Clarify pairing instructions and use consistent Offdesk branding.
- Open opt-in private localhost web previews through an updated Hub and node. Requires dedicated DNS/TLS/ingress; website previews are HTTPS, not terminal E2EE. See https://github.com/zalify/offdesk/blob/main/docs/web-previews.md.
Includes the updated trusted frontend for encrypted connections. Upgrade the existing stable App in place to retain pairing; Offdesk RC is a separate installation. Ordinary Hub URLs still load that Hub's frontend.
Install through the existing TestFlight invitation on https://offdesk.dev. The IPA here records the uploaded build. TestFlight processing and external beta review are separate from this GitHub release; availability is subject to Apple processing/review. Native iOS attachment-picker acceptance remains a tester check.
中文:升级至 0.7.0,更新附件多选、手机布局、提醒恢复、字体符号和配对说明。通过现有 TestFlight 邀请安装;公开可用时间取决于 Apple 处理和审核。
Full release log / 完整中英文更新日志: https://github.com/zalify/offdesk/releases/tag/v0.21.0
Desktop 0.7.0
Offdesk Desktop 0.7.0
- Make the setup return path prominent, center Settings, and clarify App encrypted pairing versus browser sign-in.
- Restore familiar JetBrains Mono terminal text while fixing missing playback symbols through a small bundled fallback.
- Add attachment multi-selection and review, with responsive action buttons.
- Open private localhost web previews on the selected machine through an updated Hub/node, including streaming and hot updates.
- Use Offdesk capitalization for the App and interface; bundle Hub/node 0.21.0 on host-capable platforms.
macOS installer supports Apple silicon and Intel with the drag-to-Applications layout. Windows is a desktop client; macOS and Linux can host a Hub. Upgrade the existing stable app in place to retain its configuration. Offdesk RC is a separate installation.
Web previews are opt-in and require a dedicated domain and HTTPS ingress. They use HTTPS, not terminal end-to-end encryption. See https://github.com/zalify/offdesk/blob/main/docs/web-previews.md.
Setup guide: https://offdesk.dev/docs/mac/ (中文:https://offdesk.dev/zh/docs/mac/).
中文:本轮桌面版升至 0.7.0,改善设置和扫码引导、终端字体符号、附件多选,并加入可选网页预览。macOS/Linux 包内包含 0.21.0 Hub 和节点。
Full release log / 完整中英文更新日志: https://github.com/zalify/offdesk/releases/tag/v0.21.0
Android 0.7.0
Offdesk Android 0.7.0
- Select multiple photos/files, review and remove items before sending, with an attachment dialog that adapts to narrow screens and large text.
- Keep mobile host latency/resource metrics within their cards and restore missed confirmation reminders after event gaps.
- Restore JetBrains Mono terminal text with a tiny fallback for missing playback symbols such as
⏵⏵. - Clarify pairing instructions and use consistent Offdesk branding.
- Open opt-in private localhost web previews through an updated Hub and node. Requires dedicated DNS/TLS/ingress; website previews are HTTPS, not terminal E2EE. See https://github.com/zalify/offdesk/blob/main/docs/web-previews.md.
Includes the updated trusted frontend for encrypted connections. Upgrade the existing stable App in place to retain pairing; Offdesk RC is a separate installation. Ordinary Hub URLs still load that Hub's frontend.
Use the arm64-v8a APK for most phones. Android RC font/symbol rendering and native multi-selection received user physical-device feedback; release startup/input checks are performed on the signed package. Some scanner black-screen reports remain under investigation in #448 and are not claimed fully resolved.
中文:升级至 0.7.0,包含附件多选及弹窗布局、节点指标和提醒恢复、字体符号修复及可选网页预览。请覆盖正式版安装,保留配对;多数手机选择 arm64-v8a。
Full release log / 完整中英文更新日志: https://github.com/zalify/offdesk/releases/tag/v0.21.0
Android 0.6.7-rc.4
Android 0.6.7-rc.4, built on the validation Mac Mini from PR #459 commit 49cfe27bf7f18e49646d1951446869afd4513877.
Changes since RC 3:
- Restore JetBrains Mono as the default terminal text font.
- Keep
⏵⏵and related playback controls working with a 2,988-byte, seven-character fallback. Remove the full Iosevka font; ordinary letters and numbers retain the previous appearance. - Preserve custom font selection and system fallback for Chinese. Wait for both bundled resources before refreshing cached glyphs.
Offdesk RC is an isolated test app (dev.offdesk.desktop.validation). This ARM64 APK uses versionCode 6011, the same RC signing identity as RC 3, and can upgrade the previous RC without uninstalling it. It coexists with the stable app. New RC installations require their own pairing.
Test on an encrypted connection so the app uses its bundled frontend. Ordinary Hub URLs still use the Hub's frontend; this release does not update the Hub or macOS app.
Please check:
- Settings reports
0.6.7-rc.4and frontendandroid-0.6.7-rc.4-49cfe27. - Select App Default under Terminal Font. Check the ordinary text appearance,
⏵⏵, Chinese punctuation, and terminal alignment. - Check retained pairing after upgrade and normal input, paste, uploads, and toolbar keys after dismissing the system keyboard.
Validation: 11 focused unit tests, frontend build, and TypeScript checks passed. The APK passed Mac Mini Android emulator cold start, WebView input, foreground return, reinstall with retained connection files, and damaged-pairing recovery. Its package identity, version, signature and checksum were verified. All PR CI checks passed, including runner-container E2E; PR #459 is merged. Physical-device acceptance remains for testers.
中文:恢复 JetBrains Mono 的文字观感,仅用约 3 KB 的小字库补齐缺失符号。可覆盖上一版 Offdesk RC。请在加密连接中把 Terminal Font 设为 App Default,重点看普通文字、⏵⏵、中文标点和对齐。本轮不更新本机 Hub 或 macOS 安装包。
Android 0.6.7-rc.3
Android 0.6.7-rc.3, built on the validation Mac Mini from main 5832145b72cb7083a16a5684d635704faac0fdd4.
Changes since RC 2:
- Replace the bundled terminal font with Iosevka Term, including the missing
⏵⏵symbols. Use one fixed App Default across devices; keep custom fonts with the bundled fallback and system fallback for Chinese. (#458) - Clarify desktop setup navigation, center desktop Settings, and distinguish Offdesk App pairing from browser sign-in with one QR purpose shown at a time. (#457)
Offdesk RC is an isolated test app (dev.offdesk.desktop.validation). This ARM64 APK uses versionCode 6010 and the same RC signing identity as RC 2, so it can upgrade the previous RC. It can coexist with the stable app. New RC installations require their own pairing.
To test the bundled frontend, open an encrypted connection. Ordinary Hub URLs load that Hub's frontend; those screens require the corresponding Hub update. This release only provides the Android APK, not a Hub or macOS installation update.
Please check:
- Settings reports
0.6.7-rc.3and frontendandroid-0.6.7-rc.3-5832145on an encrypted connection. - With Terminal Font set to App Default,
⏵⏵ auto mode ondisplays without missing-glyph boxes. Check arrows, terminal borders, Chinese punctuation, and text alignment. - Existing pairing survives the upgrade; cold start and returning from the background work.
- Enter, arrows, and Tab do not reopen a dismissed keyboard; paste and file uploads still work.
Validation: main CI passed, including container-based E2E. The built APK passed Mac Mini Android emulator cold start, WebView input, foreground return, reinstall with retained connection files, and damaged-pairing recovery. Its signature, version, package identity, and download checksum were verified. Physical-device acceptance remains for testers.
中文:本次主要修复终端符号方框,使用统一的 Iosevka Term 默认字体。可直接覆盖上一版 Offdesk RC。请使用加密连接测试包内新前端,重点检查 ⏵⏵、中文标点和键盘快捷键;普通 Hub 连接仍显示 Hub 提供的前端。本轮仅发布安卓 RC,不更新本机 Hub 或 macOS 安装包。
Android 0.6.7-rc.2
Android 0.6.7-rc.2, built on the validation Mac Mini from main ca48ea797883a1e11b79f2584de5dc88db08d33e.
Includes private localhost web previews (#406), mobile host metrics layout, attachment multi-selection, attention resynchronization, and Offdesk branding. Web previews require an updated Hub and selected node plus a separately configured HTTPS preview ingress. They are HTTPS website proxies, not the terminal's end-to-end encrypted transport.
This is an isolated Offdesk RC app (dev.offdesk.desktop.validation), ARM64 APK, versionCode 6009. It upgrades RC 1 with the same package and signing identity. It can coexist with the stable app; a first-time RC installation needs its own pairing. Use encrypted pairing to load the bundled RC frontend; a normal Hub URL loads that Hub's frontend.
Test on your phone:
- Install over the previous RC and reopen. Confirm Settings shows
0.6.7-rc.2and buildandroid-0.6.7-rc.2-ca48ea7; check saved pairing, cold start and background return. - In a terminal on an updated node, open a localhost HTTP link or use the machine's Open web preview menu. Verify external-browser opening, page interaction, refresh and hot updates. After node reconnection, refresh the same preview URL. Revoke it and confirm access stops.
- Inspect machine latency/CPU/memory/disk layout at narrow phone and unfolded widths. Select multiple photos/files, remove or cancel selections, then upload.
- Regression: dismiss the system keyboard and use Enter/arrows/Tab; they should not reopen it. Try Chinese punctuation, long pasted text, attachment upload, and switching between LAN and remote encrypted routes.
Validation: exact-source PR CI passed, including runner-container E2E (139 passed, 3 existing skips). This APK passed Mac Mini Android emulator cold start, WebView input, foreground return, retained-pairing reinstall and recovery tests. Physical-device acceptance remains for testers.
中文:这是包含 #406 的新 RC,安装在“Offdesk RC”里,保留上个 RC 的配对。重点测试网页预览、多选附件、手机/折叠屏节点指标布局,以及键盘隐藏后的快捷键。网页预览需要更新后的 Hub/节点和 HTTPS 域名配置;安装 APK 本身不会自动部署该入口。
Android 0.6.7-rc.1
Android 0.6.7-rc.1
Pre-release for physical-device testing. Source: ccaeb777de10f513ffd1a07d0f56c17c064a74f5 (main, #454).
- Keep mobile host latency/resource metrics inside the host card when the session list is long.
- Recover confirmation banners after missed event sequences.
- Select multiple photos or files, remove individual selections, and review before sending. Canceled selections are not uploaded.
Built on the local Mac Mini. ARM64 only. Application: Offdesk RC, package dev.offdesk.desktop.validation, versionName 0.6.7-rc.1, versionCode 6008. Uses the existing Mac Mini debug signing key; coexists with production and updates the preceding isolated RC. It does not update or migrate the production app.
Use encrypted pairing to test the bundled RC frontend (rc-android-0.6.7-rc.1-ccaeb77). Ordinary LAN sign-in loads the Hub's current web UI instead. This candidate does not update a running Hub or node.
Test on your phone
- Open a long terminal list; latency, CPU, memory and disk values should remain inside the host card. Try the cover and unfolded screens.
- Choose multiple photos and multiple files. Remove one, cancel once, then send; check that the terminal receives the expected paths and file contents.
- Switch among terminals with confirmation requests, and reconnect; the attention banner should reflect current pending requests.
- Recheck Enter/arrows with the keyboard dismissed, Chinese input, startup and encrypted reconnect.
Source validation: all #454 CI checks passed; 340 frontend tests; container E2E 137 passed / 3 existing skips. Mac Mini ARM64 Android emulator: cold start, WebView input, foreground resume, retained-pairing reinstall, and recovery all passed. Validation waited for the emulator's initial system/theme setup: launching during that setup exited twice and remains a diagnostic follow-up; the passing run used the same APK. Android/iOS physical picker acceptance and the reported affected-device QR black screen remain open (#435, #448).
中文:本轮测试主机指标布局、待确认提醒恢复、照片/文件多选。安装后显示 Offdesk RC,与正式版共存;请使用加密配对测内置 RC 页面。尚未发布正式版或升级运行中的 Hub。
APK size: 47,198,108 bytes (~47 MB). SHA-256: bb35b541617a1e24532f14e6a10174ed31f40168b595f539b05afbe13d5c5c75. Signing certificate matches the preceding isolated 0.6.6 RC.
offdesk 0.20.4
Hub, CLI and node 0.20.4
This release improves first-time setup and the interface served by the Hub:
- Guide new installations through machine readiness and show a waiting state until a machine is ready.
- Improve macOS Chinese punctuation input and Android system-navigation spacing.
- Preserve startup reconnect choices and improve scan lifecycle handling.
Install with the official installer at https://offdesk.dev/install. Existing services do not need to be reset or re-paired.
Setup guide: https://offdesk.dev/docs/mac/ (中文: https://offdesk.dev/zh/docs/mac/).
Known limitation: an empty Watching terminal may need Take control, then Start terminal. Camera/black-screen reports remain under investigation in #448.
中文:改进首次连接等待与启动重连,包含 macOS 中文标点和 Android 底部安全间距修复。