LocalWhale v0.1.2

LocalWhale v0.1.2 — Shell refresh & self-update / 本地客户端设置重构与自更新

Release date / 发布日期：2026-08-15

LocalWhale 0.1.2 redesigns the shell's settings surface and adds staged shell self-update. The bundled initial runtime remains DeepSeek Harness 0.1.0-rc.6, Node.js 24.18.1, and pnpm 11.7.0.

LocalWhale 0.1.2 重构本地客户端设置入口，并新增带暂存校验的本地客户端自更新。随包初始运行时仍为 DeepSeek Harness 0.1.0-rc.6、Node.js 24.18.1 与 pnpm 11.7.0。

Added / 新增

• A dedicated title-bar settings button (gear) that opens a native settings dialog; close-to-tray, appearance theme, update checks, logs, and About now live in the dialog with live-apply behavior.
• 标题栏新增设置按钮（齿轮），打开原生设置对话框；关闭到托盘、外观主题、更新检查、日志与关于全部收纳其中，改动即时生效。
• A dedicated Harness restart button next to settings, for the many operations that need the web UI restarted.
• 设置按钮旁新增独立的 Harness 重启按钮，方便需要重启 Web 界面的操作。
• Shell self-update: optional GitHub release checks (at most once per 24 hours, on by default, manual check in settings), a bottom-right update card plus a system toast, click-to-download with byte-level SHA-256 verification against the release SHA256SUMS.txt, and staging under %LOCALAPPDATA%\LocalWhale\updates.
• 本地客户端自更新：可开关的 GitHub 发布检查（默认开启，最多每 24 小时一次，也可在设置中立即检查）；发现新版时右下角弹出系统通知与应用内更新卡片；点击下载后逐字节校验 SHA-256（与 Release 的 SHA256SUMS.txt 比对），暂存于 %LOCALAPPDATA%\LocalWhale\updates。
• Silent install on restart: the next launch re-verifies the staged package (version guard, install-location guard, SHA-256), then hands off to a detached /SILENT installer that reinstalls in place and relaunches the updated shell via /RESTARTAPP.
• 重启即安装：下次启动会再次校验暂存包（版本、安装目录与 SHA-256），交由分离的 /SILENT 安装器原位覆盖安装，并通过 /RESTARTAPP 自动启动新版本地客户端。

Changed / 改进

• Replaced the ellipsis (…) menu flyout with the two explicit title-bar commands; the tray menu is unchanged.
• 用两个明确的标题栏命令替换了 … 菜单弹层；托盘菜单保持不变。
• Manual Harness update checks and their results are now also shown inline in the settings dialog in addition to the bottom-right InfoBar.
• 手动检查 Harness 更新的结果除右下角 InfoBar 外，同时内联显示在设置对话框中。

Upgrade safety / 升级安全

• v0.1.1 settings without the new shellUpdateCheckEnabled, lastShellUpdateCheckUtc, or ignoredShellVersions fields migrate to enabled checks with no ignored versions; all existing fields are preserved.
• v0.1.1 设置缺少 shellUpdateCheckEnabled、lastShellUpdateCheckUtc 或 ignoredShellVersions 字段时，自动迁移为“开启检查、无忽略版本”；既有字段全部保留。
• A staged shell update is only installed after the version guard, install-directory guard, and SHA-256 re-verification pass; any failure clears the staging and continues a normal launch, so a broken download cannot brick startup.
• 暂存的本地客户端更新只有在版本守卫、安装目录守卫与 SHA-256 复验全部通过后才会安装；任何失败都会清理暂存并照常启动，损坏的下载不会破坏启动。
• System toasts degrade gracefully: if notification registration is unavailable, the in-app update card remains the sole, fully functional surface.
• 系统通知可优雅降级：注册不可用时，应用内更新卡片仍承担全部交互。
• %USERPROFILE%\.dsh is never read, copied, migrated, or removed; staged installers live under %LOCALAPPDATA%\LocalWhale and are removed by the uninstaller.
• 不会读取、复制、迁移或删除 %USERPROFILE%\.dsh；暂存安装包位于 %LOCALAPPDATA%\LocalWhale，卸载时一并删除。
• The official Harness WebUI remains untouched: no CSS injection, iframe wrapper, or frontend fork.
• 官方 Harness WebUI 保持原样：不注入 CSS、不套 iframe、不 fork 前端。

Known limits / 已知限制

• Windows 11 x64 only; no Windows 10, ARM64, Store, or cross-platform package.
• 仅支持 Windows 11 x64；不提供 Windows 10、ARM64、Microsoft Store 或跨平台版本。
• The personal preview installer remains unsigned and can show an unknown-publisher warning.
• 个人 preview 安装器仍未签名，Windows 可能显示“未知发布者”。
• Toast notification availability for unpackaged apps depends on the system; the in-app card is always shown.
• unpackaged 应用的系统通知可用性取决于系统；应用内卡片始终显示。
• Screenshots in the README still show the v0.1.1 title bar and will be refreshed alongside the v0.1.2 release.
• README 截图仍为 v0.1.1 界面，将随 v0.1.2 发布一并更新。

Release artifact / 发布产物

• Installer / 安装器：LocalWhale-Setup-x64.exe
• SHA-256：C209678F368616A0DCB3CC03640FA188D4506FAE2AA0A762C1D98450B452729F
• The installer is unsigned. Verify the hash after downloading it from this repository's Releases page.
• 安装器尚未签名；请从本仓库 Releases 页面下载后核对上述哈希。

LocalWhale v0.1.1

LocalWhale v0.1.1 — Visual identity update / 视觉标识更新

Release date / 发布日期：2026-08-15

LocalWhale 0.1.1 focuses on desktop identity and host-shell polish. The bundled initial runtime remains DeepSeek Harness 0.1.0-rc.6, Node.js 24.18.1, and pnpm 11.7.0.

LocalWhale 0.1.1 主要补齐桌面标识并优化宿主外观。随包初始运行时仍为 DeepSeek Harness 0.1.0-rc.6、Node.js 24.18.1 与 pnpm 11.7.0。

Added / 新增

• A simple LocalWhale whale-tail mark for the EXE, taskbar, Alt+Tab, AppWindow, tray, and Setup.
• 一个用于 EXE、任务栏、Alt+Tab、AppWindow、托盘与安装器的简洁鲸尾图标。
• An opt-in WhaleGirl theme with one optimized transparent portrait on host-owned startup, recovery, and About surfaces.
• 可选鲸鱼娘主题；优化后的透明角色立绘只出现在宿主的启动、恢复与关于界面。
• A persistent appearance menu with Original as the default.
• 可持久化的外观菜单，默认仍为原主题。

Changed / 改进

• Replaced the hand-built header with the Windows App SDK TitleBar, preserving native caption buttons, drag behavior, Snap, Mica, and DPI hit targets.
• 使用 Windows App SDK 原生 TitleBar 替换手搓标题栏，同时保留系统窗口按钮、拖动、Snap、Mica 与高 DPI 命中区。
• Reworked startup and recovery into a responsive Fluent card; narrow windows and high contrast hide decorative character art.
• 启动与恢复界面改为响应式 Fluent 卡片；窄窗口和高对比度模式会隐藏角色装饰。
• Replaced the custom update card with a native InfoBar without changing update, ignore, defer, staging, or rollback behavior.
• 使用原生 InfoBar 替换自定义更新卡片，不改变更新、忽略、稍后、候选验证或回滚行为。

Fixed / 修复

• Restored the connected title-bar state after manually restarting Harness, so a successful restart no longer leaves the shell showing a stale disconnected state.
• 修复手动重启 Harness 后标题栏连接状态未恢复的问题；重启成功后不再残留错误的“未连接”状态。
• Applied the same LocalWhale identity to the executable, taskbar, Alt+Tab switcher, native window, tray icon, and installer.
• 统一 EXE、任务栏、Alt+Tab、原生窗口、托盘与安装器中的 LocalWhale 标识，补齐 v0.1.0 缺失的应用身份信息。

Upgrade safety / 升级安全

• Existing v0.1.0 settings without visualTheme migrate to Original.
• v0.1.0 设置缺少 visualTheme 时自动使用默认主题。
• Close behavior, ignored Harness versions, and the last update-check time are preserved.
• 关闭行为、忽略的 Harness 版本与上次更新检查时间保持不变。
• %USERPROFILE%\.dsh is never read, copied, migrated, or removed by the shell upgrade or uninstaller.
• 桌面外壳升级与卸载程序都不会读取、复制、迁移或删除 %USERPROFILE%\.dsh。
• The official Harness WebUI remains untouched: no CSS injection, iframe wrapper, or frontend fork.
• 官方 Harness WebUI 保持原样：不注入 CSS、不套 iframe、不 fork 前端。

Known limits / 已知限制

• Windows 11 x64 only; no Windows 10, ARM64, Store, or cross-platform package.
• 仅支持 Windows 11 x64；不提供 Windows 10、ARM64、Microsoft Store 或跨平台版本。
• The personal preview installer remains unsigned and can show an unknown-publisher warning.
• 个人 preview 安装器仍未签名，Windows 可能显示“未知发布者”。
• Harness is still a developer preview; incompatible npm updates are rejected and the current known-good runtime remains active.
• Harness 仍处于开发者预览阶段；不兼容的 npm 更新会被拒绝，当前已知良好运行时继续使用。
• Theme resources affect only the desktop host. The upstream WebUI deliberately does not inherit the WhaleGirl palette.
• 主题资源只影响桌面宿主；上游 WebUI 不会继承鲸鱼娘配色，这是有意保持的边界。

Release artifact / 发布产物

• Installer / 安装器：LocalWhale-Setup-x64.exe
• SHA-256：A8B5481B5BA3EF3538B1F9B13A5C3CC85A5B7B7BED3E2A8BB0D615FD25C4B43D
• The installer is unsigned. Verify the hash after downloading it from this repository's Releases page.
• 安装器尚未签名；请从本仓库 Releases 页面下载后核对上述哈希。

LocalWhale v0.1.0

LocalWhale v0.1.0

首个公开 preview：将官方 DeepSeek Harness WebUI 封装为 Windows 11 x64 桌面应用。

中文

• 原生 WinUI 3 Fluent 标题栏、Mica、WebView2 与系统窗口按钮。
• 隐藏启动随包 Node 24.18.1 和 DeepSeek Harness 0.1.0-rc.6；使用随机 127.0.0.1 端口。
• 安装包内置 Node、pnpm、Harness 与 WebView2 Evergreen 离线安装器，首次启动不依赖网络或本机开发环境。
• 标准按用户安装向导始终显示安装位置选择页，默认 %LOCALAPPDATA%\Programs\LocalWhale。
• 单实例、可选托盘模式、优雅关闭与 Job Object 子进程清场。
• Harness 候选更新在隔离目录进行 integrity、生命周期脚本和启动冒烟验证。
• 修复官方 Harness 首次创建 profile 链接时可能出现的 ERR_MODULE_NOT_FOUND：仅对当前 DSH_HOME\profiles 的已知竞态自动重试一次。
• %USERPROFILE%\.dsh 中的官方 Harness 配置、会话与凭据不会在卸载时删除。

安装包尚未进行商业代码签名，Windows 可能显示“未知发布者”。请从本 Release 下载，并用 SHA256SUMS.txt 校验。

资源说明：开发机稳定样本约 1.85 秒启动、Harness Node 私有内存约 121 MiB、空闲 CPU 约 0.013%、0.53 秒退出。WinUI 外壳私有内存约 110 MiB，外壳 + Harness + WebView2 后代进程工作集直接求和约 684 MiB（共享页会重复计入），仍是后续优化项。

English

The first public preview of a native Windows 11 x64 shell for the official DeepSeek Harness WebUI.

• Native WinUI 3 Fluent title bar, Mica backdrop, WebView2, and system caption buttons.
• Bundled Node 24.18.1, pnpm, DeepSeek Harness 0.1.0-rc.6, and the WebView2 Evergreen offline installer.
• Hidden startup on a random loopback port; no system development environment or network is required for first launch.
• Per-user Setup wizard with an always-visible destination page.
• Single-instance activation, optional tray behavior, graceful shutdown, and Job Object cleanup.
• Isolated integrity, lifecycle-script, bridge, UI-load, and shutdown validation for Harness candidates.
• One bounded retry for the upstream first-profile module-link race.
• Official Harness data under %USERPROFILE%\.dsh is preserved during uninstall.

This personal preview is unsigned, so Windows may show an unknown-publisher warning. Download from this Release and verify it with SHA256SUMS.txt.

Known resource limitation: the measured WinUI shell private memory and summed shell/Harness/WebView2 working set remain above the original targets. See the README for the exact development-machine sample and scope.