Repository navigation
v4.0.0 — 桌面端全新外观、长对话治理与双层记忆
安装指南 · 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.0_aarch64.dmg |
多数现代 Mac |
| macOS Intel | Tianshu_4.0.0_x64.dmg |
2020 前的 Intel Mac |
| Windows 10(1809+)/ 11 x64 | Tianshu_4.0.0_x64-setup.exe |
安装向导,自带 WebView2 离线安装包 |
| Linux x86_64 | Tianshu_4.0.0_amd64.AppImage |
免安装 |
| Linux ARM64(树莓派 64 位等) | Tianshu_4.0.0_aarch64.AppImage |
免安装 |
CLI 用户也可 npm install -g tianshu-harness(需 Node.js ≥ 24),或用一键安装脚本。
macOS 安装步骤
-
下载
.dmg并双击打开,把 Tianshu 拖入「应用程序」文件夹 -
首次打开:本包为 ad-hoc 签名、未经 Apple 公证,浏览器下载后首次双击会报「已损坏,无法打开」或「无法验证开发者」。拖入应用程序后,在终端执行一次(移除下载隔离属性):
xattr -cr /Applications/Tianshu.app
-
之后正常双击启动。若仍被拦:右键 App → 「打开」→ 再点「打开」,或系统设置 → 隐私与安全性 → 底部点「仍要打开」
-
应用内自动更新不受 Gatekeeper 影响——只需首次手动放行
Windows 安装步骤
- 下载
Tianshu_4.0.0_x64-setup.exe,双击运行,按向导完成安装 - 界面依赖 WebView2 Runtime——3.5.3 起安装器已内嵌离线安装包,通常无需额外操作
- 窗口完全打不开时:开始菜单「修复 WebView2」,或从本 Release 底部
windows-repair目录双击repair-webview2.cmd,或手动安装 WebView2 离线安装包 后重启
Linux 安装步骤
-
按架构下载 AppImage,加执行权限后直接运行:
chmod +x Tianshu_*_amd64.AppImage # ARM 设备换成 _aarch64 ./Tianshu_*_amd64.AppImage
-
依赖:glibc ≥ 2.35(Ubuntu 22.04+ / Debian 12+ 等主流发行版)与系统图形栈
libwebkit2gtk-4.1.so.0+libgtk-3.so.0——多数桌面发行版已自带;精简/服务器版需按发行版安装 webkit2gtk 4.1,缺库时ldd Tianshu_*.AppImage自查 -
推荐 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 在回答结束前核对答复里的带行号引用、测试计数、验证声称和用户原话,发现问题时长对话会打回重做一轮。
- 缓存命中率不再计入整理后的那一次缓存重建,显示处同时给出计入后的数值;账单和费用口径不变。
-
插件与记忆:
- 新增天枢插件接口 TPI:插件需要声明清单和所需能力,不符合约束的拒绝加载;仍用旧格式的插件会提示迁移。
- 内置双层记忆插件 Xiaosi Axiom:每位用户一个本地记忆库,短期记忆每轮写入,长期记忆在会话结束时精炼,查不到时明确说查不到。
- Axiom Lens:可把记忆库导出成一个自包含的本地网页,查看各层记忆、时间线和检索过程;导出只读,页面不联网。
- 项目记忆加固:
/remember记下的笔记稳定带进新会话,已被取代的旧规则不再注入,自动记录的内容不再出现转义乱码。
-
官方模型、账号与星港:
- 天枢账号登录后可直接使用官方模型,模型目录按官网发布自动同步,你显式选过的模型会保留。
- 额度显示移进输入框的模型菜单,选模型时就能看到;侧栏的官方模型收成一行小条。
- 官方模型的推理强度关掉之后可以再调回来,包括最高档。
- 星港论坛在应用内窗口打开,已登录天枢账号时免密登录;退出或切换天枢账号,论坛窗口随之退出或重登。
- Codex 请求带上会话缓存键,同一会话的缓存命中明显提高。
-
对话与工作能力:
- 极限思考(实验性):开启前有两层确认,先说明会消耗大量 token,再确认档位;入口处常驻红色感叹号提示 token 消耗,关闭无需确认。
- 16 个星域各自有了本域方法:按真实动作给出方法提示,声称完成时按本轮记录核对交付。
- AI 可调用图像生成、语音转写、音频处理和朗读工具;文件阅读覆盖更多格式,附件可预览、下载原件和打开所在文件夹。
- 应用重启打断的会话标为「已中断」,可一键续跑,用户刚发出的消息不会丢失。
-
流畅度:
- 应用太一或大肥鱼体验时的约 1 秒卡顿已去掉。
- 太一体验在前台时,整体 CPU 占用从 21–26% 降到 14–18%(macOS 实测)。
- 桌宠在画面不变时不再反复重画,静止待机时降到片段帧率。
- 共鸣星域流式回答不再每帧整段重排,回答完成时不再往上弹一下。
- 启动、跑任务和发消息时少起同步子进程;Windows 上 bash 调用不再阻塞后台服务。
- 冷启动点开会话先显示本地历史;点开长会话时首帧直接是末尾几轮。
-
平台与安全:
- macOS 真机适配:桌宠正常显示,通知点击能打开会话,软链路径下的工作区行为正确。
- Linux 真机适配:提供 deb 与 AppImage;凭据密钥改存系统 Secret Service,不可用时自动退回本地密钥。
- 系统代理遵守系统自己的例外列表,本机和局域网地址不再被送进代理。
- 运行时代码的混淆不再因文件体积跳过,覆盖全部运行时文件。
- Git 页把天枢运行时文件收成「天枢本地数据」,可在本机一键隐藏或撤销。
升级须知
- 不需要重新激活:Pro 许可签名的密钥没有变,已激活的许可证继续有效。
- 完整性校验密钥独立于许可签名密钥,不影响已有许可证。
- macOS:如打开时提示「已损坏」,在终端执行
xattr -cr /Applications/Tianshu.app后再打开。 - Linux:AppImage 不走应用内自动更新,新版本请手动下载替换。
- 内核契约与 v3.37.0 相同:
deliver_task只负责提交,验证和审查需要显式发起。 - Node 运行时要求不变:24.x ≥ 24.22.1 或 26.x ≥ 26.12.1。