天枢桌面端功能全解:Cockpit、主题工作室、本地语音输入与手机遥控审批
天枢桌面端功能全解:Cockpit、主题工作室、本地语音输入与手机遥控审批
天枢(Tianshu-harness)桌面端是一款基于 Tauri 构建的图形化终端编程智能体客户端。它通过 sidecar 驱动与 CLI 相同的 agent 内核,让终端用户也能用上图形界面。本文完整讲解天枢桌面端四大核心能力:Cockpit 驾驶舱(实时仪表盘)、ThemeStudio 主题工作室(个性化外观)、本地语音输入(离线隐私语音转写)与手机遥控审批(扫码连接、远程批准操作),帮助新手快速上手。
天枢桌面端是什么:CLI 内核 + 图形外壳
天枢桌面端与 CLI 命令 rivet 共用同一个 agent 内核——桌面端经 sidecar(HTTP/SSE)驱动内核,因此命令行里的一切能力(星域、工具档位、审查门)在桌面端都有图形化入口。
内核侧的终端形态如下图所示,桌面端可以理解为它的"图形化升级版":
📖 完整文档见 docs/desktop-guide.md
Cockpit 驾驶舱:一眼看穿 agent 内部状态
遇到"为什么变慢了""缓存命中率如何""agent 现在在干嘛"这类问题时,**Cockpit(驾驶舱)**是最直接的诊断入口。它每 2 秒轮询一次 agent 内部状态,用 5 个 Tab 实时展示:
| Tab | 展示内容 |
|---|---|
| Summary | 会话概览:模型、星域、token 用量、累计成本、turn 数 |
| Safety | doom loop 检测、风险信号、活跃 hook 告警 |
| Verify | 验证状态:改动文件的 RED 闸门、证据门、交付就绪度 |
| Model | 缓存命中率、推测解码命中、模型路由轨迹 |
| Context | 上下文占用、压缩状态、pinned anchors、压力指标 |
打开方式(二选一):
- 左侧栏「… 更多」菜单 → 「驾驶舱」
- 按
⌘/Ctrl+K打开命令面板,搜索「驾驶舱」
🧭 普通用户日常用不到它,但它是排查性能与缓存问题的第一现场。状态数据结构可参考 src/tui/cockpit/state.ts 与 src/tui/cockpit/types.ts。
ThemeStudio 主题工作室:26 套内置主题 + 自定义皮肤
天枢桌面端的外观定制能力集中在 Settings → 外观:
- 26 套内置主题:暗色/亮色各半,如
nebula、sakura、cyberpunk、tokyo-night、nord、dracula、catppuccin-mocha等 - ThemeStudio(主题工作室):自定义任意 CSS 变量(
--bg/--text/--accent/--panel等全量 token),支持导入/导出主题 JSON 与他人分享,自定义主题保存在~/.rivet/themes/*.json - Glass 模式与壁纸:让侧栏/主区变成半透明毛玻璃,支持自定义壁纸与模糊度;看不清时可用「智能基于壁纸调和配色」自动取色
- 主题切换带 220ms 交叉淡入动画,跟随系统深浅色切换
本地语音输入:离线隐私的语音转文字
输入框的麦克风按钮支持语音输入,macOS / Windows / Linux 三端通用,识别由本地 whisper.cpp 引擎完成——录音不上传任何服务器,中英文混杂场景精度优于系统自带识别。
首次使用只需三步:
- 点击麦克风按钮,自动下载识别模型(tiny 约 75MB,国内走镜像加速)
- macOS 首次会请求麦克风权限,点击「允许」即可
- 点一次开始录音,再点一次结束并识别
小贴士:
- 🔒 识别全程在本地完成,隐私无忧
- 追求更高精度可换 base 模型(约 244MB)
- 网络受限可设
RIVET_WHISPER_PROXY=http://代理:端口加速下载 - 本地引擎不可用时,macOS 自动回退系统语音识别
语音链路的服务端实现见 src/server/speech-routes.ts 与 src/server/whisper-engine.ts。
手机遥控审批:同一 Wi-Fi 扫码即连
人不在电脑前,agent 却停在"等待审批"?开启手机遥控后,手机浏览器即可看进度、批审批——免装软件、免账号、数据不出局域网。
最快路径:同一 Wi-Fi 直连(LAN Direct)
- 桌面端 设置 → 网络 → 远程访问 → 「同一 Wi-Fi 直连」 开关(默认关闭)
- 设置页显示二维码,手机连同一个 Wi-Fi 后扫码即连
- 手机端可看会话列表、只读时间线,并对审批三卡操作:授权 approve/reject、plan approve/reject、ask_user_question 文本回复,还有中止按钮
进阶:不在同一网络
手机用移动网络时,走 Tailscale Serve 等 HTTPS 隧道——桌面保持回环监听,手机拿到带可信证书的 HTTPS 地址。逐步操作见 手机端操作手册。
⚠️ 安全边界:LAN Direct 是局域网明文 HTTP(知情取舍);令牌要像密码一样保管,不要截图或写进公开配置;用完即关闭开关;公网方向绝不开放。详细说明见 docs/remote-access.md。
服务监听与远程端点实现见 src/server/serve.ts 与 src/server/remote-access-endpoint.ts。
常用快捷键速查表
| 快捷键 | 作用 |
|---|---|
⌘/Ctrl+K |
命令面板 |
⌘/Ctrl+, |
设置 |
⌘/Ctrl+J · Ctrl+` |
集成终端 |
⌘/Ctrl+; |
SideChat 旁路提问 |
Esc Esc |
RewindOverlay 时间旅行 |
Shift+Tab |
Plan / Agent 模式切换 |
按 ⌘/Ctrl+/ 可随时唤出完整快捷键速查表。
小结
天枢桌面端把"终端编程智能体"做成了人人可上手的图形产品:Cockpit 负责透明诊断,ThemeStudio 负责个性外观,本地语音输入负责高效输入,手机遥控审批负责随时随地接管关键决策。结合 Plan / Ask / Agent 三种会话模式与 RewindOverlay 时间旅行,新手也能放心把任务交给 agent。



