Skip to content

v4.0.1 — Windows 启动闪退热修

Choose a tag to compare

@Eternal-dream-MAX Eternal-dream-MAX released this 03 Nov 13:50

安装指南 · Installation

本段落随每个版本发布,嵌在 Release 正文顶部。完整安装与平台说明见 docs/guides/installation.md(含 Android Termux、源码构建、Shell 补全、自动更新)。

This section is published with every release. For the full installation & platform guide (Android Termux, building from source, shell completions, auto-update), see docs/guides/installation.md.

下载哪个文件 · Which file to download

按平台与 CPU 架构选(不确定架构?mac 点左上角苹果菜单「关于本机」;Windows 设置 → 系统 → 系统信息;Linux 终端 uname -m):

平台 文件 说明
macOS Apple Silicon(M1/M2/M3/M4) Tianshu_4.0.1_aarch64.dmg 多数现代 Mac
macOS Intel Tianshu_4.0.1_x64.dmg 2020 前的 Intel Mac
Windows 10(1809+)/ 11 x64 Tianshu_4.0.1_x64-setup.exe 安装向导,自带 WebView2 离线安装包
Linux x86_64 Tianshu_4.0.1_amd64.AppImage 免安装
Linux ARM64(树莓派 64 位等) Tianshu_4.0.1_aarch64.AppImage 免安装

CLI 用户也可 npm install -g tianshu-harness(需 Node.js ≥ 24),或用一键安装脚本。

macOS 安装步骤

  1. 下载 .dmg 并双击打开,把 Tianshu 拖入「应用程序」文件夹

  2. 首次打开:本包为 ad-hoc 签名、未经 Apple 公证,浏览器下载后首次双击会报「已损坏,无法打开」或「无法验证开发者」。拖入应用程序后,在终端执行一次(移除下载隔离属性):

    xattr -cr /Applications/Tianshu.app
  3. 之后正常双击启动。若仍被拦:右键 App → 「打开」→ 再点「打开」,或系统设置 → 隐私与安全性 → 底部点「仍要打开」

  4. 应用内自动更新不受 Gatekeeper 影响——只需首次手动放行

Windows 安装步骤

  1. 下载 Tianshu_4.0.1_x64-setup.exe,双击运行,按向导完成安装
  2. 界面依赖 WebView2 Runtime——3.5.3 起安装器已内嵌离线安装包,通常无需额外操作
  3. 窗口完全打不开时:开始菜单「修复 WebView2」,或从本 Release 底部 windows-repair 目录双击 repair-webview2.cmd,或手动安装 WebView2 离线安装包 后重启

Linux 安装步骤

  1. 按架构下载 AppImage,加执行权限后直接运行:

    chmod +x Tianshu_*_amd64.AppImage   # ARM 设备换成 _aarch64
    ./Tianshu_*_amd64.AppImage
  2. 依赖:glibc ≥ 2.35(Ubuntu 22.04+ / Debian 12+ 等主流发行版)与系统图形栈 libwebkit2gtk-4.1.so.0 + libgtk-3.so.0——多数桌面发行版已自带;精简/服务器版需按发行版安装 webkit2gtk 4.1,缺库时 ldd Tianshu_*.AppImage 自查

  3. 推荐 X11 会话(Wayland 尚未验证)

常见问题

  • mac 提示「已损坏」:见上方 macOS 步骤 2 的 xattr 命令——这是 Gatekeeper 对未公证下载包的标准行为,不是包真坏了
  • Windows 装完提示 rivet 无法识别:新开一个终端(旧终端的 PATH 是装 Node 之前快照的)
  • Linux AppImage 双击无反应:先确认执行权限(chmod +x),再 ldd 查缺库
  • 自动更新:桌面端应用内自动更新(mac Gatekeeper 仅影响首次手动安装);已安装用户无需每版重下

v4.0.1 — Windows 启动闪退热修

日期:2026-11-03
上一版本:v4.0.0

本版说明

修复 v4.0.0 在 Windows 上一启动就闪退的问题。原因是 Windows 主线程默认只预留 1 MB 栈空间,而 4.0 启动时有一个函数需要约 1.04 MB,导致立即栈溢出。现在把 Windows 主线程栈预留调到 8 MB,与 macOS、Linux 一致。

本次只改了 Windows 的链接参数,功能与 v4.0.0 相同。从后台日志看,闪退发生在读入会话之后,没有发现会话数据损坏。

内容清单

  • Windows:主线程栈预留由 1 MB 调到 8 MB,修复启动即闪退。
  • macOS 与 Linux 安装包随版本号一并更新,内容与 v4.0.0 相同。

升级说明

  • 已装 v4.0.0 的 Windows 用户:直接下载 v4.0.1 安装包覆盖安装即可,账号、配置和会话都会保留。
  • macOS 用户会通过自动更新收到 v4.0.1。