DeepSeek Harness Plugin Hub

发布与管理完整 Harness Profiles，发现适合你的插件。

探索

插件目录环境预设文档中心动态

社区

发布插件联系我们报告问题

相关链接

Plugin Hub GitHubDeepSeek Harness 官方项目系统状态隐私说明
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

独立、非官方社区项目，与 DeepSeek 官方无隶属、授权或背书关系。

DeepSeek Harness Plugin Hub
ProfilesPlugins分类动态文档登录管理 Profiles
ProfilesPlugins分类动态文档登录
← Plugins
E

@dsh-fly/dsh-energy-orb

Energy Orb

适用于 DeepSeek Harness Web GUI 的 Web3D 能量球：仅用于状态显示的装饰，在空闲时缩小并保持静默，在运行一个回合时以心跳方式显示。

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:ethanchen669/dsh-energy-orb#8bd3bc07d87bd0d9d3f8e4724554a462dbc26b8a
README兼容性版本

兼容性与来源证明

Energy Orb 以 @dsh-fly/dsh-energy-orb 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围
*
运行环境
web
发布来源
github
Registry 更新时间
2026/11/2

版本

0.2.0stable
2026/11/2
0.1.2stable
2026/11/2
0.1.1stable
2026/11/1

相关插件

正在加载相关插件…

最新版
0.2.0
DSH
*
HMR
重启进程
Tree shaking
未声明可安全裁剪
解包体积
未提供
文件数
未提供
Surface
web
许可证
MIT
发布源
github
GitHub
★ 1
周下载
0
最近提交
2026/11/2
查看源码 ↗
README Badge

点击下方 Badge 复制 Markdown，粘贴到 README 即可。

这是你的 Plugin？认领权益 · 优先安全扫描

验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。

认领这个 Plugin →
报告问题

相关插件

继续浏览 ui-customization 分类下经过校验的插件。

Web App@deepseek-ai/dsh-web-appdsh 浏览器界面捆绑包：位于 dsh-base 之上的 Web 补丁层，加上运行时粘合插件（提供前端 dist、Web 界面提示符、bash 运行时变量和 URL 行）Experimental Session Titles Bundle@deepseek-ai/dsh-experimental-session-titles-bundle新的用户提示到达时刷新会话标题。Personalized Recommendations@deepseek-ai/dsh-personalized-recommendations回答下方以卡片形式提供个性化页面和内置插件推荐Experimental Agent Team Web Profile@deepseek-ai/dsh-experimental-agent-team-web-profile用于 Agent Teams Remote 和 UI 插件的实验性 Web 配置层

README

dsh-energy-orb

DSH Web GUI 的 Web3D 能量球插件 —— 会话状态可视化装饰：静息时收缩沉默，回合运行时以双拍心跳涨缩。

dsh-energy-orb：会话状态可视化装饰 · Web3D 能量球

它是什么

一颗浮在界面右下角的能量球，只做状态可视化：不吃交互、不拦点击、不改变任何业务行为。

  • 跟随当前会话：状态看的是左侧栏当前打开的那个会话（retainedBy.mainView），切换会话立刻跟着变；宿主没有 sessions 服务时退回「任一回合在跑即激活」的全局口径。
  • 静息（没有回合在跑）：核心缩到 0.82×、辉光压到 0.5、心跳关闭——静态就是静态。
  • 激活（回合开始运行，与扫描杠亮起是同一个事件）：核心 1.08×、辉光 0.975（约为最初的 75%），进入双拍心跳， 心率 64 → 112 BPM 随活动强度提频；环速跟心跳挂钩：最快那圈 71 → 124 rev/min （0.85s → 0.49s 一圈，仍是 bpm 的 1.1 倍），核心按 0.6× 环速转（42 → 74 rev/min）， 另两环与灰尘场按基准角速度等比例推进，静息守在 0.825×（旧静息的 1.5 倍）。 转速有自己更陡的 ramp（170ms 精确落位，比其余参数的 420ms 更快）——静息↔运行切换时先给你一记"起转"， 核大小/亮度仍按 420ms 过渡；所有自转都是逐帧增量积分的，越用越久也不会出现"回卷抽搐"。
  • 隐藏 / 展开：展开时右上角有一个半透明的 ×（hover 时旁边浮出「隐藏 / hide」提示），点一下收成 40px 小把手，把手点一下又展开回去。收起是朝着 × 所在的右上角缩进去的，展开就是它的逐属性逆过程 （尺寸 / 透明度 / 缩放共用 220ms 同一条曲线，不是"收起顺滑、展开硬切"）。折叠状态记在 localStorage， 刷新后保持；折叠期间球体暂停渲染（不空烧 GPU）。
  • 点击充能一次（单次能量脉冲）、拖拽换位置——展开态和折叠态的把手都能拖 （位置/尺寸/显隐/折叠状态记在 localStorage；拖完那次 click 会被吞掉，不会"拖一下就展开"）。
  • 尊重 prefers-reduced-motion：停环、关心跳，只保留大小与亮度差异。

静息 / 激活 / 使用中 三态

材质是粒子能量核心 + 三圈前向机械环（刻度 / 节点 / 弧光，环管径 0.025 —— 0.007 的细线在 Bloom 里读不出转速，0.18 又太粗会遮住核心，0.025 是当前定稿；环上亮点直径 = 环厚的 4 倍（细环上 1.5×/2.2× 都只多零点几像素，读不出来））+ UnrealBloom，基于 three@0.180.0。

装在界面的哪里

右侧留白、不挡内容 —— 默认 240 × 240 的悬浮层（视图等比放大 1.25× 之后），贴在右下角（shell.overlay），可拖拽到任意角落。 官方 UI 实拍（纯净 DSH Web GUI，未加载任何皮肤）：

官方 UI 实拍：静息态，悬浮在右下角

近景：粒子核心 + 三圈机械环，透明背景

在工作区右下角的样子

安装

# 发布到 npm 之后（版本按实际最新）
cd ~/.dsh
dsh plugin --profile=<你的 profile> add @dsh-fly/dsh-energy-orb --registry=https://registry.npmjs.org/

装完必须重启 dsh web：引擎把客户端包缓存在进程内，只刷新页面不够。

开发期直接装本地目录（软链，改码即生效，重启后加载）：

cd ~/.dsh
dsh plugin --profile=<你的 profile> add link:/绝对路径/dsh-plugins/dsh-energy-orb

配置

项位置说明
enabledcordis Config唯一配置项，默认 true；关掉等于不挂载
visible / collapsed / size / anchor / offset浏览器 localStorage，键 energy-orb.display显隐、是否折叠成 40px 把手、直径（size 32–256，默认 120 → 240px；旧存档按 v:2 自动 ×1.25 迁移一次）、贴哪一角、拖拽偏移

没有别的配置面：状态来自 Harness 的会话事件，不来自配置。

工作原理

Harness 'api-session/status' ─→ ActivityProjector（Host 折叠 running 集合）
                                     │  { version:1, active, intensity, phase, updatedAt }
                                     ▼
                     GET /api/energy-orb/state   （loopback-only 围栏）
                                     │  2s 轮询 / 10s 退避
                                     ▼
   OrbClient（shell.overlay）── 状态 → 球体参数（420ms 插值）──→ SphereRenderer
                                     │                         （vendored three 闭包）
                                     └── import('/energy-orb/assets/sphere/energy-sphere.js')
  • Host 零持久化：running 集合在内存里；updatedAt 是每次快照的时刻（liveness 心跳）， 所以长回合不会被误判成陈旧。
  • 插件名 / 行 id：dsh-fly-energy-orb（bundle patch 的行 id，市场与配置里看到的就是它）； npm 包名是 @dsh-fly/dsh-energy-orb，客户端 bundle 的 ModuleLoader id 用完整包名。
  • 资产路由只放行精确白名单（15 个文件：球体模块 + three 闭包），越界 404、非 loopback 403。
  • 运行期零依赖：three 与后处理链是 vendored 副本（MIT，含 license 头），装包不需要构建、 不需要 npm install、不会因为上游 three 升版而碎。vendored 资产由 scripts/vendor-sphere.mjs 按 import 图遍历生成，client/vendor/manifest.json 记 sha256 与溯源。
  • 失败即降级：模块 404 / WebGL 不可用 / 上下文丢失 → 可见的 CSS 降级球（渐变 + 呼吸）， console.warn 恰一次，不空白、不炸页。

兼容性

  • 平台：DSH Web GUI（dsh.client.platform = "web"，挂 shell.overlay，root 级悬浮层）。
  • 依赖宿主提供的 webServer 服务（路由）与 api-session/status 事件；缺任一则该插件不生效，而不是拖垮宿主。
  • 需要 WebGL2；不可用时自动降到 CSS 球。

开发与验证

node --test                                # 单测：宿主接线 / 状态契约 / 映射表 / 降级 / vendor 完整性
node scripts/verify-host.mjs               # 宿主级集成：真 cordis + 真 dsh-host-webserver 起真监听（12 项）
node scripts/verify-visual.mjs             # 浏览器 probe：真资产路由 + 真 WebGL 像素（42 项；产物落 .tmp/，加 --save 写回 docs/verify/）
node scripts/verify-live.mjs --self-test   # live 检查脚本自证
node scripts/vendor-sphere.mjs --check     # vendored 资产与上游 demo 是否一致
node scripts/shoot-readme.mjs              # 重出 hero/states/overlay（夹具，DPR1）
DSH_BIN=../dsh-fly/node_modules/.bin/dsh \
  node scripts/shoot-vanilla-ui.mjs        # 重出「官方 UI 实拍」两张（scratch home + npm 版 + 真 dsh web）

本仓同时被 dsh-fly 的 plugins.lock.json 登记为外部插件： scripts/ 下四个契约脚本（构建器 / 源哈希 / 两道署名闸门）必须是主仓同名脚本的逐字节副本 （npm test 里有一条比对，主仓在本机时生效；主仓门禁会以同样的尺子量这里）。

发版流程（首次 npm stage publish → 配 Trusted Publisher → 之后推 tag 自动发）见 docs/publishing.md。

设计、决策记录与验收：docs/design.md · docs/adr/ · docs/plans/（含逐条实测的验收契约）。

License

MIT。vendored 的 three@0.180.0 同为 MIT（Copyright © 2010-2025 three.js authors，license 头随文件一起分发）； 球体组件的来源、补丁与 vendored 清单见 client/vendor/README.md。