Tianshu-harness

4.0.3 已撤回，请改用 v4.0.4。

4.0.3 has been withdrawn. Please use v4.0.4 instead.

安装指南 · 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）：

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

macOS 安装步骤

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

   从 4.0.2 或更早版本手动升级的，拖之前先看下文「macOS：升级前先把数据移出应用包」一节：数据还在应用包里时，先迁出再替换。

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

   xattr -cr /Applications/Tianshu.app
   

3. 之后正常双击启动。若仍被拦：右键 App → 「打开」→ 再点「打开」，或系统设置 → 隐私与安全性 → 底部点「仍要打开」

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

Windows 安装步骤

1. 下载 Tianshu_4.0.3_x64-setup.exe，双击运行，按向导完成安装
2. 界面依赖 WebView2 Runtime——3.5.3 起安装器已内嵌离线安装包，通常无需额外操作
3. 窗口完全打不开时：开始菜单「修复 WebView2」，或手动安装 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、libgtk-3 和托盘库 libayatana-appindicator3。缺了的话，Ubuntu / Debian 用 sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1 装齐

3. 推荐 X11 会话（Wayland 尚未验证）

常见问题

• mac 提示「已损坏」：见上方 macOS 步骤 2 的 xattr 命令——这是 Gatekeeper 对未公证下载包的标准行为，不是包真坏了
• Windows 装完提示 rivet 无法识别：新开一个终端（旧终端的 PATH 是装 Node 之前快照的）
• Linux AppImage 双击没反应：先确认执行权限（chmod +x），再从终端运行，看报错。报错里有「Failed to load ayatana-appindicator3」，就是缺托盘库，Ubuntu / Debian 用 sudo apt install libayatana-appindicator3-1
• Linux AppImage 提示「Cannot mount AppImage, please check your FUSE setup」：先装 fuse3（Ubuntu / Debian：sudo apt install fuse3）。不要改用 --appimage-extract-and-run，原因见文末已知问题。
• 自动更新：桌面端应用内自动更新（mac Gatekeeper 仅影响首次手动安装）；已安装用户无需每版重下

v4.0.3 — Windows 自愈、目标续跑与服务商修复

日期：2026-11-05 上一版本：v4.0.2

本版说明

修复 4.0.2 之后用户和公开镜像报告的问题：Windows 上安装失败、启动卡住、强退后打不开、运行文件被杀毒软件隔离后不知道原因；macOS 上不在「应用程序」里运行时，更新会把数据连同旧应用包一起删掉；目标模式中途停下来问要不要继续；移除的服务商加不回来；OpenCode 上的 DeepSeek 调不了推理强度。修复都没有删减功能。

macOS：升级前先把数据移出应用包

谁受影响：用 4.0.2 及更早版本、而且不在「应用程序」文件夹里运行天枢的 mac 用户。「应用程序」文件夹指访达边栏里的那个，即 /Applications。比如把 Tianshu.app 放在「下载」「桌面」，或个人文件夹下的「应用程序」（~/Applications）里，都算受影响。这时天枢把数据存在应用包里面。应用内更新，或者从 DMG 拖拽「替换」，都会把旧应用包连同里面的数据一起删掉，不进废纸篓。

还有两种情况也一样：

• 在「设置 → 存储」里选过「便携位置（应用同目录）」的，不管装在哪里。
• 先在别处运行过、后来才挪进「应用程序」的，数据可能还在包里。

一直在「应用程序」里运行、没选过便携位置的用户不受影响，新安装 4.0.3 的也不受影响。从 4.0.3 起，天枢不再把数据存在应用包里，以后的更新不会再这样删数据。

怎么判断：

• 打开「设置 → 存储」，看页面上显示的数据路径。路径里有 Tianshu.app/Contents/MacOS/TianshuData，就是受影响。
• 也可以在访达里右键 Tianshu.app，选「显示包内容」，看 Contents → MacOS 里有没有 TianshuData 文件夹。
• 已经按下面的步骤换成自定义文件夹的，包里留的是迁移前的旧副本，没有影响，可以直接更新。

升级前怎么迁出（在 4.0.2 上做）：

1. 停掉正在运行的任务。
2. 在访达里选「前往 → 个人」，新建一个空文件夹，比如「TianshuData」。不要建在「文稿」「桌面」「下载」里。
3. 在天枢里打开「设置 → 存储」，选「自定义文件夹」，点「选择…」选中刚建的文件夹。勾选「将现有数据迁移到

v4.0.2 — Windows 体验与稳定性修复

日期：2026-11-04 上一版本：v4.0.1

本版说明

macOS：暂未 Apple 公证。首次打开提示「已损坏」时，拖进「应用程序」后执行一次 xattr -cr /Applications/Tianshu.app。应用内自动更新不受影响。

集中修复 4.0.1 上线后用户反馈的问题：Windows 安装器的弹窗与页面重叠、内置浏览器卡顿、动态壁纸被卡住、登录后反复检测账号导致卡顿，以及生成中无法切换模型、余额不显示等。所有修复都没有删减功能或降低画质。

内容清单

安装器（Windows）

• 「用户协议」「安装记录」窗口能用 ×、Esc、Alt+F4 和「关闭」按钮关闭；协议全文正常显示，可滚动、可复制。
• 覆盖安装页不再露出英文说明，选项改为「先卸载旧版本再安装」「直接覆盖安装（保留设置）」，底栏文字不再重叠，100%–200% 缩放下都不重叠。
• 完成页与失败页的 ×、Alt+F4 能正常关闭安装器；× 关闭不会启动天枢，只有「打开天枢 →」会启动。安装进行中点 × 会先确认，等安装完成再关闭。
• 覆盖安装后刷新快捷方式与任务栏图标，不再出现任务栏旧图标、托盘新图标并存。

性能（Windows）

• 内置浏览器画面不再越来越卡：推流只保留最新一帧，前端只更新画面本身、不再整页重绘。分辨率与画质不变。
• 天枢运行时不再让 Wallpaper Engine 一类动态壁纸被判定为「有全屏应用」而暂停；桌宠窗口不再抢前台焦点，桌宠功能全部保留。
• 动态背景遇到解码器丢失、休眠唤醒等瞬时故障时自动重试恢复，不再弹出「加载失败」；持续失败时才提示，并提供「重试」。
• 设置里「预览启动动画」能正常播放，三套体验都可预览。

账号与对话

• 登录后不再反复检测账号状态：改为在启动、切回窗口、网络恢复和账号变化时检查，失败自动退避，窗口隐藏时暂停。每个窗口对服务器的请求约降为原来的 1/15。
• 生成或思考中也能打开模型选择，所选模型在本轮结束后生效。
• 账户余额稳定显示：暂时取不到最新值时显示上次的额度，并标注更新时间。

升级说明

• Windows 用户：下载 v4.0.2 安装包覆盖安装即可，账号、配置和会话都会保留；已装 v4.0.1 的也会收到自动更新。
• macOS 用户会通过自动更新收到 v4.0.2。

安装指南 · 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）：

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。

安装指南 · 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）：

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.0_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.0 — 桌面端全新外观、长对话治理与双层记忆

日期：2026-11-03 上一版本：v3.37.0

本版说明

4.0 是一次大版本发布。内核行为沿用 v3.37.0 的提交、验证、审查分离契约，在此之上换了一套桌面端的产品面：新的首屏和首次引导，可选的三种主题体验（极简、太一、大肥鱼），配套的开场视频、动态背景和桌宠，以及只用来聊天的共鸣星域。

长对话是这一版的另一条主线。XiaoSi Compress2.0 改写了长对话的整理方式，只在请求真的放不进上下文时才整理一次，并尽量保住已有的前缀缓存。Pro 用户另有 Xiaosi-VERA：整理时对照原文核对检查点，回答结束前核对答复里的引用和验证声称。跨会话的记忆交给新的插件接口 TPI 和内置的双层记忆插件 Xiaosi Axiom，记忆库可以导出成一个本地网页查看。

此外，官方模型与天枢账号的接入在桌面端完整落地，星港论坛可以沿用天枢账号免密登录；macOS 与 Linux 做了真机适配；日常使用中的卡顿做了两轮实测优化。

内容清单

• 桌面端新外观与体验：

  • 新的首次引导：七步走完连接模型、选择工作方式和主题体验，目标是把新用户带到发出第一条任务；全域换用新 Logo。
  • 主题体验三选一：极简、太一、大肥鱼。太一与大肥鱼带开场视频、动态背景和桌宠，极简保持安静的界面。
  • 桌宠可在太一和天琴两个角色间切换，切换后马上生效。
  • 新增共鸣星域（Pro）：在独立的对话空间里和天琴聊天，只保留对话和联网搜索，不读写文件、不运行命令。
  • 新增五套字符动态壁纸，颜色跟随当前主题；切主题、切壁纸改为从点击处圆形展开的过渡。
  • 输入框里输入 /theme 会打开主题与壁纸选择条，点一下即换。
  • 账户菜单重做：主题子菜单与 /theme 用同一份清单，用户行旁常驻设置入口；设置页统一成更简洁的结构，并新增「关于」页。

• 会话与输入：

  • 首页的对话方式（交接 / 长对话）改成左上角的一枚小胶囊，显示当前所选，点开再换。
  • 星域简介从首页卡片收进星域选择浮层，要选星域时才看到，不再占首页位置。
  • 点了欢迎页「试试」里的示例句后，输入框不再往上跳。
  • 会话页正文两侧新增拖动条，可自由调整正文列宽；消息导航改为右缘刻度条，悬停展开列表。
  • 思考过程与工具调用的显示改版；等待批准、断线、分叉、排队、停止等状态在会话头和时间线里的说法统一。
  • 输入框有草稿时按 ↑ 只移动光标，空输入框才翻历史；@ 选中文件后接着打字，字之间不再被插入空格。
  • 左栏收起时，左缘出现一枚可点的边签，顶栏补上「新建任务」和「需处理」。

• 长对话：Compress2.0 与 Xiaosi-VERA：

  • XiaoSi Compress2.0：长对话只在实际请求超过上下文预算时才整理一次历史，平时不改写，减少缓存重建。
  • 整理前完整原文先归档，检查点逐条记录要求、决定、待批准事项和下一步；单条格式不对时只丢那一条，不再让整次整理失败。
  • 侧问、风险解释和子任务沿用主请求的前缀，DeepSeek 前缀缓存的命中更稳定。
  • Xiaosi-VERA（Pro，随 Pro 默认开启）：整理检查点时逐条对照原文，编造的路径和标识符会被标注。
  • Xiaosi-VERA 在回答结束前核对答复里的带行号引用、测试计数、验证声称和用户原话，发现问题时长对话会打回重做一轮。
  • 缓存命中率不再计入整理后的那一次缓存重建，显示处同时给出计入后的数值；账单和费用口径不变。

• 插件与记忆：