天枢桌面端功能全解:Cockpit、主题工作室、本地语音输入与手机遥控审批

原创2026-10-14 04:19:151,436 阅读
文章标签:人工智能AI Agent代码智能体CLIMCP Clients

天枢桌面端功能全解:Cockpit、主题工作室、本地语音输入与手机遥控审批

天枢(Tianshu-harness)桌面端是一款基于 Tauri 构建的图形化终端编程智能体客户端。它通过 sidecar 驱动与 CLI 相同的 agent 内核,让终端用户也能用上图形界面。本文完整讲解天枢桌面端四大核心能力:Cockpit 驾驶舱(实时仪表盘)、ThemeStudio 主题工作室(个性化外观)、本地语音输入(离线隐私语音转写)与手机遥控审批(扫码连接、远程批准操作),帮助新手快速上手。

天枢Tianshu桌面编程智能体星域主题预览图

天枢桌面端是什么:CLI 内核 + 图形外壳

天枢桌面端与 CLI 命令 rivet 共用同一个 agent 内核——桌面端经 sidecar(HTTP/SSE)驱动内核,因此命令行里的一切能力(星域、工具档位、审查门)在桌面端都有图形化入口。

天枢桌面端主界面与左侧会话列表

内核侧的终端形态如下图所示,桌面端可以理解为它的"图形化升级版":

天枢终端TUI界面启动画面

📖 完整文档见 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 引擎完成——录音不上传任何服务器,中英文混杂场景精度优于系统自带识别。

首次使用只需三步:

  1. 点击麦克风按钮,自动下载识别模型(tiny 约 75MB,国内走镜像加速)
  2. macOS 首次会请求麦克风权限,点击「允许」即可
  3. 点一次开始录音,再点一次结束并识别

小贴士:

  • 🔒 识别全程在本地完成,隐私无忧
  • 追求更高精度可换 base 模型(约 244MB)
  • 网络受限可设 RIVET_WHISPER_PROXY=http://代理:端口 加速下载
  • 本地引擎不可用时,macOS 自动回退系统语音识别

语音链路的服务端实现见 src/server/speech-routes.ts 与 src/server/whisper-engine.ts。

手机遥控审批:同一 Wi-Fi 扫码即连

人不在电脑前,agent 却停在"等待审批"?开启手机遥控后,手机浏览器即可看进度、批审批——免装软件、免账号、数据不出局域网。

最快路径:同一 Wi-Fi 直连(LAN Direct)

  1. 桌面端 设置 → 网络 → 远程访问 → 「同一 Wi-Fi 直连」 开关(默认关闭)
  2. 设置页显示二维码,手机连同一个 Wi-Fi 后扫码即连
  3. 手机端可看会话列表、只读时间线,并对审批三卡操作:授权 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+/ 可随时唤出完整快捷键速查表。

小结

天枢Tianshu品牌横幅与北斗星域图

天枢桌面端把"终端编程智能体"做成了人人可上手的图形产品:Cockpit 负责透明诊断,ThemeStudio 负责个性外观,本地语音输入负责高效输入,手机遥控审批负责随时随地接管关键决策。结合 Plan / Ask / Agent 三种会话模式与 RewindOverlay 时间旅行,新手也能放心把任务交给 agent。

登录后查看全文
Tianshu-harness