目录

Caelum Orbis:给 AI 编程助手装一个会变色的 3D 状态球

写代码的时候,我最想知道的一件事是:它现在在干什么?Caelum Orbis 就是为这个问题做的——一个常驻在 DeepSeek Harness 界面上的 3D 状态球和一块小面板,把 AI 正在思考、正在跑命令、正在等你确认,变成一眼就能看见的颜色。

为什么需要它

用 AI 编程助手的时候,界面通常只告诉你两件事:在跑,或者跑完了。

中间那段才最难熬:它是在读代码?在跑测试?在等你点确认?还是已经卡住了?想搞清楚只能不停点开面板翻记录,翻完关掉,接着干活又心痒。

Caelum Orbis 的想法很简单:不用打开任何面板,让它自己在旁边告诉你。

Agent 一开始工作,对话区右侧就浮出一块玻璃小面板,写着当前任务、进行到哪一步、最近完成了哪几件事。闲下来,它自己收成一颗会呼吸的球,不占地方。

/images/dsh-orbis/hud-panel.webp

它长什么样

三块东西,随叫随到:

  • Always-on HUD:对话区右侧的常驻小面板。当前任务、阶段、运行时长、最近 5 条活动、当前状态。Agent 空闲时自动收起;你手动收起过之后,它不会再自己弹回来。
  • 3D 能量球:右下角一颗 76px 的球,随状态变色、流动、脉动。可以拖到任意位置,位置会记住。
  • 工作空间:点球打开的大面板。3D 球、完整活动记录、执行时间线、统计数字都在这里。

/images/dsh-orbis/orb-states-v2.webp

球不是贴图轮播,是真的 3D:内层能量材质、外层玻璃壳、多层轨道、外围粒子,状态切换是平滑过渡。

颜色就是状态

不用记任何术语,看颜色就知道它在干嘛:

颜色状态说人话
蓝 · 缓慢呼吸空闲没事做,在等你
紫 · 能量脉冲思考中正在推理、组织思路
青紫 · 加快准备中正在拼参数,马上要调工具
青蓝 · 粒子高速执行中正在跑命令、读写文件
紫 · 更快输出中正在写回答
琥珀 · 轨道变慢等待确认有操作需要你点同意
灰蓝 · 极静安静了在跑,但已经 30 秒没动静
绿 · 能量扩散完成这一轮干完了
琥珀 · 高频闪已中断被你或系统打断
红 · 短促警示出错出问题了

安静下来时,面板给的是真实秒数——「已连续 45 秒没有收到新的活动」,而不是含糊地说一句"卡死了"。

安装

前提:DeepSeek Harness 0.2.2-rc.1 或更高版本。

一条命令:

dsh plugin --profile desktop add dsh-orbis

如果你是用 dsh web 启动 Harness 的,把 desktop 换成 web。

装完刷新一次 Harness 页面,右下角就会出现那颗球。

不想用命令行也可以,GUI 两步:

  1. 打开 设置 → 插件
  2. 点 添加插件 → 安装第三方插件,填包名 dsh-orbis

国内网络慢的话,加一个镜像参数:

dsh plugin --profile desktop add dsh-orbis --registry=https://registry.npmmirror.com

怎么用

日常操作都在那颗球上:

想做的事怎么做
看详细信息点一下球,打开工作空间
关掉工作空间再点一次球,或按 ESC
换个位置按住球拖,松手就记住
看当前状态鼠标悬停在球上,显示状态和正在跑的工具数
暂时不想看悬停时点左上角 ×,球消失,原地留一颗小点,点小点能唤回来
让它别收起来点面板标题栏的 📌 固定
只要球不要面板设置里把显示模式改成「仅能量球」

三种显示模式,按习惯挑一个:

模式平时是什么点它做什么
自动展开干活时完整卡片,空闲时收成球展开 / 收起
始终紧凑一行小胶囊打开完整工作区
仅能量球只有 76px 的球打开完整工作区

设置里还能调:总开关、帧率 30/60、粒子密度、轨道、光效、减少动态(照顾晕动敏感)、后台暂停,以及各个列表的开关。

它不做什么

这一条比功能更重要:

  • 不调用大模型,不消耗 Token。 所有状态都来自 Harness 自己已经在发的事件,插件只是旁听。
  • 只读。 不执行工具、不改会话、不写数据库。关掉它,Harness 一切照旧。
  • 不改 DSH 源码。 装上就是一个插件,卸载就干净消失。
  • 局域网内其他设备看不到。 手机、另一台电脑都读不到这块面板——宁可不可用,也不要一个看起来能用、实际不设防的入口。

卸载

dsh plugin --profile desktop remove dsh-orbis

本地剩下的只有浏览器里的几个偏好设置(球的位置、面板折叠状态),清一下浏览器数据就没了。

链接

用起来有问题、或者想要什么效果,欢迎到 GitHub 开 issue。