v3.4.0
v3.4.0 更新内容
桌面端
- 底部微滚动:会话在最底部时单格上滚不再被钉底逻辑立即拉回(400ms 冷却窗内保留阅读意图)(PR#5,@HarriethWiKk)
- 通知残影修复(Win11):弹窗开合后右上角「子代理受阻」半截通知残影不再出现(issue #44)
CLI / TUI(公开仓 PR 五连修,@yq04)
- 排队消息语义对齐(#40):AI 输出期间排队的消息不再被自动注入——run 结束后回填输入框,由你按 Enter 确认发送
- 输入框贴底(#40):滚动到底时输入框位于屏幕最下方
- 命令面板换绑 Ctrl+P(#41):Ctrl+Esc 在 Windows 被开始菜单抢占且三条送达路径全断;翻历史用 ↑/↓、Ctrl+N、Ctrl+R
- Ctrl+C 退出确认可取消(#42):确认窗口内 Esc / 编辑 / 粘贴均取消退出,修复幽灵输入与带输入误退出
- 任务清单跨 run 不复活(#43):「任务 5/5 不更新」根修——上一轮全完成清单不再挂在新 run 头上
- slash 提示分层(#45):输入
/只展示 ~20 条核心命令,继续输入即过滤全部;/undo、/resume补进提示列表
存储治理
- 遥测/索引/备份文件无界增长收口(meridian DB 保留窗口 + WAL checkpoint + backups 保留策略)
📦 安装指南
1. 环境要求
- 桌面端:开箱即用,无需任何前置依赖。Windows 10(1809+)/ Windows 11 需 WebView2 Runtime(Win11 与多数 Win10 已预装,缺失时安装器自动下载;离线环境:https://aka.ms/webview2installer)
- CLI:Node.js 24.1.0(推荐;22+ 通常可用)——
node --version检查。Git 强烈建议(解锁检查点回滚 / worktree 隔离 / diff 审查)
2. 安装(任选其一)
方式 A:桌面端(开箱即用) —— 下方 Assets 下载:
- macOS Apple Silicon:
Tianshu_3.4.0_aarch64.dmg - macOS Intel:
Tianshu_3.4.0_x64.dmg - Windows:
Tianshu_3.4.0_x64-setup.exe(Win10 1809+/Win11,需 WebView2 Runtime,缺失时安装器自动下载)
首次启动后按引导配置服务商即可(/connect 向导:选内置或自定义 → 填 API 密钥 → 探测验证)。
方式 B:npm 全局安装(CLI,全平台立即可用) —— 已发布 tianshu-tui,无需本地构建,启动自动检查更新:
npm install -g tianshu-tui
rivetWindows 提示:装完提示
rivet 无法识别——先新开一个终端;仍不行,把npm prefix -g的目录加进用户 PATH 再开新终端(nvm/fnm/scoop 安装的 Node 需手动加一次)。
方式 C:从源码构建:
git clone https://github.com/huiliyi37/Tianshu-Tui.git
cd Tianshu-Tui
npm install
npm run build
npm start3. Shell 补全(可选)
仓库自带 completions/(bash / zsh / fish / PowerShell),用法见 README「启用 Shell 补全」。
已升级用户
桌面端自动更新自动送达(macOS 走 .app.tar.gz,无需重装);CLI 端 rivet 启动时自动检查,或手动 npm update -g tianshu-tui。
已知问题(如实标注)
- 桌面端未公证(无 APPLE_SIGNING_IDENTITY):macOS 安装后如提示「已损坏」,执行
xattr -cr /Applications/Tianshu.app - 国内自助支付渠道尚未配置:激活码请用管理台手工发放
致谢
本期 7/9 提交来自社区:@yq04(#40 #41 #42 #43 #45,均附根因分析与 RED→GREEN 测试基线)、@HarriethWiKk(#5 微滚动意图保留;#38 Provider onboarding 统一栈已随 v3.3.0 收录)。感谢每一位贡献者。