Skip to content

v4.0.4

Latest
Latest

Choose a tag to compare

View all tags
@Eternal-dream-MAX Eternal-dream-MAX released this 06 Nov 01:52
v4.0.4
2d0b22e

安装指南 · 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.4_aarch64.dmg 多数现代 Mac
macOS Intel Tianshu_4.0.4_x64.dmg 2020 前的 Intel Mac
Windows 10（1809+）/ 11 x64 Tianshu_4.0.4_x64-setup.exe 安装向导，自带 WebView2 离线安装包
Linux x86_64 Tianshu_4.0.4_amd64.AppImage 免安装
Linux ARM64（树莓派 64 位等） Tianshu_4.0.4_aarch64.AppImage 免安装

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.4_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.4 — Windows 自愈、目标续跑与服务商修复

日期：2026-11-06
上一版本：v4.0.2（4.0.3 只发过候选版，没有推送给正式版用户）

本版说明

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

4.0.4 包含 4.0.3 候选版的全部修复，另外修好了 4.0.3 候选版的一个打包问题：Intel Mac 用的 x64 包里漏了内置的 Node 运行时，装上后本地服务起不来。正式版用户从 4.0.2 直接更新到 4.0.4 即可。

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

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

还有两种情况也一样：

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

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

怎么判断：

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

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

  1. 停掉正在运行的任务。
  2. 在访达里选「前往 → 个人」，新建一个空文件夹，比如「TianshuData」。不要建在「文稿」「桌面」「下载」里。
  3. 在天枢里打开「设置 → 存储」，选「自定义文件夹」，点「选择…」选中刚建的文件夹。勾选「将现有数据迁移到新位置」，点「应用并重启」。
  4. 重启后回到「设置 → 存储」，确认用的是新文件夹，会话列表里的会话都在。
  5. 再更新到 4.0.4。

容易踩的坑：

  • 这种安装下，「默认位置」和「便携位置（应用同目录）」都指向应用包里面，选它们等于没迁。要选「自定义文件夹」。
  • 新文件夹放在「文稿」「桌面」「下载」里的话，更新后第一次启动时，macOS 会先弹框问是否允许 Tianshu 访问这个文件夹。点「允许」之前天枢一直起不来，实测等了近 6 分钟还在等。点了「允许」马上恢复，数据都在。个人文件夹下的普通文件夹不会弹这个框。
  • 迁移是把数据复制过去。点「应用并重启」之后还写进旧位置的内容，新文件夹里没有，所以第 1 步要先停任务，第 4 步要确认会话都在。旧副本留在应用包里，更新时随旧包删掉，不影响新文件夹。

另外两点：

  • 迁出之前，不要先从 DMG 拖拽「替换」，那样数据同样会被删掉。
  • 只把应用挪进「应用程序」不够，数据可能还留在包里，照样要按上面的步骤迁。

数据已经丢了怎么办：

症状：更新后天枢直接进了主界面，但会话、服务商和代理设置、用量记录都不见了。这说明数据随旧应用包一起被删了。在「应用程序」以外从 4.0.1 更新到 4.0.2 的，那时就已经发生过同样的事。

开过「时间机器」的，可以试着从备份里找回，找回的是更新前最后一次备份时的数据：

  1. 退出天枢。
  2. 在访达里打开当初放 Tianshu.app 的文件夹，从菜单栏的「时间机器」图标选「浏览“时间机器”备份」，回到这次更新之前的时间点。菜单栏里没有这个图标的话，从「应用程序」打开「时间机器」。
  3. 选中那时的 Tianshu.app，点「恢复」。提示同名项目已存在时，选「保留两者」，不要选「替换」。之后两份应用并排放着，右键选「显示简介」看版本号，就能认出哪份是恢复出来的旧版。
  4. 不要打开恢复出来的旧版应用。
    • 右键它，选「显示包内容」，进入 Contents → MacOS → TianshuData。双击 TianshuData 打不开时，右键选「在新标签页中打开」。
    • 按 Shift-Command-句点（.）显示隐藏文件，里面的 .rivet 文件夹就是原来的数据。
    • 在个人文件夹里新建一个文件夹，比如「天枢数据」，不要建在「文稿」「桌面」「下载」里。把 .rivet 拷进去，再把拷进去的 .rivet 改名为「旧数据」。
    • 不要直接拷到个人文件夹下：4.0.4 自己的数据就在个人文件夹的 .rivet 里，名字会冲突。
  5. 打开 4.0.4，到「设置 → 存储」选「自定义文件夹」，点「选择…」选中「旧数据」。不要勾选「将现有数据迁移到新位置」，点「应用并重启」。
  6. 确认会话都回来了，再删掉恢复出来的那份旧版应用。

没有「时间机器」或其他备份的话，就找不回了：数据不会进废纸篓。

内容清单

安装与启动（Windows）

  • 安装器遇到残缺的 PowerShell（缺 Security 模块）时换下一份再试，不再当成权限问题拒绝安装；都不可用时明说要修复 Windows PowerShell 5.1。
  • 数据目录文件很多时，权限加固转到后台继续，不再卡在「无法保护数据目录」横幅、起不来。
  • 强制退出后 WebView2 本地存储损坏、连续启动失败时，自动把损坏的存储挪到备份目录再启动，不删除任何数据；代价是首次使用引导会再出现一次。
  • 运行文件被杀毒软件隔离时，按文件名报出缺了哪些文件，并说明怎样从隔离区恢复；放回后点「立即重试」即可，不用重启。辅助进程 job-launch.exe 带上了天枢的版本信息。
  • 安装进行中打开「安装记录」，内容随安装实时刷新；安装完成后记录仍保留。
  • 从托盘恢复主窗口时，不再停在最小化状态。
  • 冷启动时窗口不再整体卡住几秒：14 个会阻塞的命令挪出了界面主线程。

数据与启动（macOS）

  • Intel Mac 用的 x64 包重新带上内置的 Node 运行时（4.0.3 候选版的 x64 包漏了它，装上后本地服务起不来）。打包流程现在会核对每个包里本架构的 Node 是否齐全，下载中断或缺文件时直接失败。
  • 数据不再放进应用包。启动时会把包里的旧数据搬出来；搬不走时（例如放在外置磁盘上）停下更新，并提示到「设置 → 存储」换位置，不会让更新把数据删掉。存储位置也不能再选到应用包里面。
  • 数据还留在应用包里时，「设置 → 存储」默认选中包外的「默认位置」，勾好「将现有数据迁移到新位置」，并在页面上说明原因。
  • 4.0.2 及更早版本在「应用程序」以外运行、更新时数据已随旧应用包删掉的，4.0.4 第一次启动会如实提示一次，并给出从「时间机器」找回的步骤。
  • Apple 芯片的 Mac 上运行 x64（Intel）版时，更新后第一次启动要等 Rosetta 翻译，不再因为等得久被当成启动失败。

目标与极限思考

  • 目标模式一直执行到清单全部勾完，不再中途停下来问「要不要继续下一步」；桌面目标条的暂停、恢复、关闭按钮恢复可用。
  • 会话重启后残留的目标可以正常取消。
  • 极限思考在等你选方案或已暂停时，目标会等待而不是继续往下跑；目标条上给出提示，可直接打开卡片，搜索结束后目标自动恢复。
  • 极限思考在当前会话用不了时（例如太一默认档、共鸣星域的闲聊），开关置灰并写明原因和改法；已开启但不生效的会话，徽标显示「未生效」。
  • /team 等写代码的子代理与极限思考搜索互不打架：搜索占用仓库时写任务等搜索结束再派发，只读任务照常；落地方案前有子代理在改工作区会先拒绝，文件对不上时列出是哪些文件、可能被谁改过。
  • 搜索中换模型、发消息、退出计划或只问模式时，卡片和输入框如实说明会怎样；打开极限思考的确认框列出对当前会话的影响。
  • 极限思考已暂停，或停在待选方案时，派写代码的子代理会先提示：续跑或落地方案可能因为文件对不上被拒。隔离子进程里嵌套派出的子代理也过同一道检查。
  • 已暂停的极限思考在会话换模型后，如实写出续跑会用哪个模型；同一个模型换了服务商时，两边都带上服务商名。
  • 并行协作时点开子代理详情不再崩溃；收起的极限思考卡片不会在重试后自己弹出来。
  • 极限思考的写锁只在搜索占用仓库时生效，搜索暂停后可以正常改文件；非 git 工作区不再建议在父目录 git init，改为指向真正的仓库。
  • 星域会话里能看到编排与委派工具；消息里写出 council_convene 即可挂载它。
  • 子代理报告格式出错时会先补救一次，不再直接判失败；委派失败时写明原因和卡在哪一步。
  • /team 规划给出格式不对的结果时不再崩溃；主视角声明的阻塞项和换算不了的验证项会留在合并后的计划里，不再悄悄丢掉。星河集群里指定只读角色时，不会再被错当成要改代码而拒绝派发。

模型与服务商

  • 移除 Codex、claude 等内置服务商后，可以在「添加服务商」里重新添加并授权。
  • OpenCode 上的 DeepSeek 可以设置推理强度，档位按上游声明提供。
  • 推理强度菜单只列当前模型生效的档；存着的档不生效时，写明实际按哪一档发送。OpenCode 上的 GLM、Kimi 也能调推理强度；OpenCode Go 预设里已下线的 deepseek-v4-flash 换成 deepseek-v4.1-flash。
  • 已有配置里还在用 OpenCode Go 的 deepseek-v4-flash 的，升级后一次性改指 deepseek-v4.1-flash，并提示一次；「模型已下线」的提示只在服务商回 400 / 404 时出现。
  • 配置文件写不进去时，迁移提示如实写明只在本次运行生效、下次启动还会再改一次，并列出实际生效的配置文件。
  • 上下文压缩钉在 OpenCode Go、火山方舟等网关上的 deepseek-v4-flash，不再被官方 DeepSeek 的下线迁移误改成 deepseek-flash（误改后压缩会悄悄改用会话主模型）；早先已被误改的，启动时提示一次该改哪个文件。
  • 官方 DeepSeek 选「关」时真正关闭思考。
  • 首次设置里删除服务商或模型的确认框不再被引导遮住；账号状态查不到时也能完成首次设置，完成页可「重新检查」。
  • 本机地址的服务商请求永远不经代理；余额与平台查询和模型请求用同一套代理设置，只开了系统代理（如 Clash）也生效。

账号与用量

  • 侧栏左下角的官方模型用量小条默认关闭，可在 设置 → 模型提供商 → 天枢官方模型 里打开；续期被限流时如实显示「请求过于频繁」和等待时间。
  • 账号头像可以保存，并与官网资料同步。
  • 启用 Pro 时能分清限流、服务暂时故障和被拒绝，瞬时故障会自动重试。
  • 会员续期、用量上传等后台请求失败后按服务端给的等待时间退避，不再每秒重试。
  • 窗口全部隐藏、又没有进行中的官方模型请求时，不再定时访问官网和网关；会员租约快到期时仍会在后台续期。账号信息改为每 10–15 分钟刷新一次，切回窗口、购买后回到天枢、权益变化或登录失效时立即刷新。
  • 买完会员马上生效，不用再等 5–6 分钟；打开账号页、点「检查授权」时立即续期。
  • 本机时钟比服务器慢 5 分钟以内时，官方模型和会员的授权都能正常装上，不再反复失效；偏差更大时按退避间隔重试，不再十几秒一轮地反复开通、撤销。续期被限速时，按服务端给的等待时间再试，不再 1.5 秒后就重试。
  • 本机时钟与服务器差 5 分钟以内时，官方模型的报价不再被误判为「价格已变化」；设置页出现这个提示时，指向卡片上的「刷新状态」按钮。

界面

  • macOS 上动态背景不再播几秒就定格再重播；新增画质档位（自动 / 原画 / 均衡 / 省电），默认「自动」。
  • 展开的 Mermaid 全屏图不会再自己关闭；Windows 多屏下桌宠跨屏后，对话面板不再错位、被压扁。
  • 共鸣历史的重命名用鼠标和键盘都能正常完成。
  • 桌宠话少了，消息按轻重分级：等你审批、任务失败这类要你处理的事照常提示并钉住；喝水、走动等提醒合并后再说，闲聊有限额。设置 → 太一 新增「说话频率」，默认「适中」，比以前安静。
  • 桌宠的对话卡片改成独立窗口：第一次出现在她旁边，之后她怎么走动卡片都不跟着动；卡片可以单独拖动，位置会记住。
  • 关掉再打开内置星港论坛，主题偏好不会丢；被篡改的论坛页面也不能再让天枢在 macOS 上崩溃。
  • TUI 显示生成速度和首字延迟。
  • 技能脚本运行失败时（例如缺 Python 模块），命令行和桌面「运行环境」面板会给出下一步，例如补 requirements 后重建环境。

稳定性与安全

  • 修复外部审计和公开镜像报告里仍成立的问题，例如登录流程只打开 http/https 链接。
  • deliver_task 在 worktree 和冷启动慢的仓库里不再误报失败。
  • 上下文钩子连续超时时自动熔断，不再刷屏；bash 内建命令不再被误判。
  • 上下文整理失败时，提示如实说明对话内容没有被替换，下一条消息会自动再试一次。
  • computer_use 不再在会话中途被误拒；挂载随会话保存；自动化浏览器退出后自动恢复。
  • 用过 computer_use 的对话，放置 30 分钟以上再接着用时，不再留下多余的辅助进程和浏览器连接；用过 computer_use 的命令行进程结束时能正常退出，不再挂住。
  • 打包后的 macOS / Linux 版安装本地插件时能找到随包的 npm。
  • Linux AppImage 的签名文件改在重打包之后生成，可以正常验签。

已知行为

  • 设备时钟偏慢时，可能多发一次被网关拒绝的请求，这次请求不计费。
  • 本机时钟偏差超过 5 分钟时，官方模型的授权和报价仍可能失败，设置页点「刷新状态」也读不到报价；把系统时间改回自动设置即可。

升级说明

  • Windows 用户：下载 v4.0.4 安装包覆盖安装即可，账号、配置和会话都会保留；已装 v4.0.2 的也会收到自动更新。
  • macOS 用户会通过自动更新收到 v4.0.4。天枢不在「应用程序」文件夹里运行的，更新前先看上面「macOS：升级前先把数据移出应用包」一节。
  • 装过 4.0.3 候选版 Intel（x64）包、本地服务起不来的：从本页下载 Tianshu_4.0.4_x64.dmg，按上面的 macOS 安装步骤重新安装。
  • Linux 用户：重新下载 AppImage。
  • 本版只在 GitHub 和 OSS 发布，不在 AtomGit 发布。「下载来源」保持「自动（推荐）」的用户会从 GitHub 收到更新；手动选了 AtomGit 的，请改回「自动（推荐）」或 GitHub。
  • 侧栏的官方模型用量小条升级后默认隐藏，需要时在设置里打开。

已知问题（Linux）

  • 用 --appimage-extract-and-run 或设了 APPIMAGE_EXTRACT_AND_RUN=1 运行时，数据会写进 /tmp 下的临时解压目录，退出、重启或升级后可能丢失。请直接运行 AppImage，后续版本会修复。
Assets 17
Loading