光晕氛围 HSYrc/DeepVibe-dsh

DeepVibe-dsh

Deep-ambience coding plugin for DeepSeek Harness
DeepSeek Harness 的深度氛围感编程插件

GitHub · npm · Issues

DeepVibe-dsh immersive dashboard

Actual runtime · 实机运行：沉浸光环、会话主题，以及四张实时看板卡片。

Overview · 概览

DeepVibe-dsh is not a wallpaper that gets in the way. It is a session-aware ambience layer for DeepSeek Harness: when the model starts working the ring wakes up, tokens flow as light, finished tools light up a 10×10 heatmap, and the whole frame settles when the task ends.

中文 DeepVibe-dsh 不是一张会抢戏的壁纸，而是一层会读会话的深度氛围感编程插件。模型开工，光环醒来；词元流出，光点聚散；工具执行，热力图逐格亮起；任务收尾，整个画面慢慢安静。

Why it feels different · 为什么它不一样

- It breathes, but does not shout. Running, idle, approval and question states each have their own rhythm.
- Data is not decoration. Every light, heatmap cell and cost can be traced back to a session event or the Platform bill.
- One plugin, not a pile of scripts. Host and Client ship together; there is no Chrome, CDP, Playwright or local bridge to keep alive.

- 会呼吸，但不吵。 运行、空闲、审批、提问各有节奏；该亮的时候亮，该停的时候停。
- 数据不是装饰。 每一次亮起、每一格热力图、每一笔花费，都能在会话或平台账单里找到出处。
- 一个插件，不是一堆脚本。 Host 和 Client 打包在同一个插件里，装好即用，不用额外拉起浏览器或本地服务。

Architecture · 架构

DeepVibe-dsh runtime architecture

- Client consumes DSH session events and owns the ring, immersive dock, approval/question cards and session topic.
- Host uses the Host-only DSH account session to read Platform balance and today's usage; it sends only aggregate JSON to the Client.
- No external browser. Platform tokens never reach the renderer.

- Client：消费 DSH 会话事件，负责光环、沉浸看板、审批/提问卡与会话主题。
- Host：用 DSH 账户的 Host-only 凭据读取平台余额与今日 usage，只把聚合 JSON 交给 Client。
- 没有外部浏览器。 平台 token 不进入渲染器。

Features · 功能

- Full-frame Canvas overlay mounted in shell.overlay: transparent, additive light, click-through.
- Session-driven ring: tokens, tool calls, turn/step, tok/s and context all come from the live event stream.
- Immersive dock with four real cards: model, context/cost, 10×10 tool heatmap, balance/today spend.
- Approval card: reject or allow once without leaving immersion.
- Question card: options, multi-select, free-form supplement, reject, submit.
- Cache hit from DSH's tokenUsage projection, whole-session denominator, one decimal.
- Session topic: project · session title, each capped at 12 characters.
- 82 parameters, 6 groups, 3 presets. Everything is editable from Settings → DeepVibe-dsh.

- 全帧 Canvas 背景，挂载在 shell.overlay：透明底、加色发光、点击穿透。
- 会话驱动：词元、工具调用、turn/step、tok/s、上下文全部来自真实事件流。
- 沉浸看板四块真实数据卡：模型、上下文/花费、10×10 工具热力图、余额/今日消费。
- 审批卡：不用退出沉浸，直接「拒绝 / 允许一次」。
- 提问卡：选项、多选、补充输入、拒绝、提交。
- 缓存命中使用 DSH tokenUsage 投影，按整个会话口径统计，固定保留一位小数。
- 会话主题：项目名 · 会话标题，两部分各最多 12 个字。
- 82 个参数、6 个分组、3 个预设，都可以在 设置 → DeepVibe-dsh 中调整。

Install · 安装

需要先安装 DeepSeek Harness（桌面版或 dsh web）。

从 npm 安装：

dsh plugin --profile web add deepvibe-dsh

从解压后的包目录安装：

plugin_manager install_bundle target=<absolute path to this package>

从 Release tgz 安装：

tar -xzf DeepVibe-dsh-0.5.18.tgz
plugin_manager install_bundle target=<absolute path to the extracted package directory>

重启 DSH，打开 设置 → DeepVibe-dsh。

中文 需要先安装 DeepSeek Harness（桌面版或 dsh web）。

从 npm 安装：

dsh plugin --profile web add deepvibe-dsh

从解压后的包目录安装：

plugin_manager install_bundle target=<本包目录的绝对路径>

从 Release tgz 安装：

tar -xzf DeepVibe-dsh-0.5.18.tgz
plugin_manager install_bundle target=<解压出的 package 目录绝对路径>

刷新页面，侧栏出现 设置 → DeepVibe-dsh 即成功。

Find it in DSH · 在 DSH 中找到

DSH 不自带内置索引源。Discover 是自定义插件市场：用户添加索引 URL，然后在其中搜索。

本仓库提供一个索引：

https://raw.githubusercontent.com/HSYrc/DeepVibe-dsh/main/market/index.json

1. 打开 插件 → 实验性插件 → 更多，启用 自定义插件市场。
2. 打开 发现 → 添加索引源。
3. 粘贴上面的 URL。
4. 搜索 DeepVibe-dsh，确认来源后安装。

索引现在指向 npm 包，因此安装的是 deepvibe-dsh@0.5.18。

中文 DSH 官方不内置任何索引源，Discover 是一个可添加索引 URL 的自定义插件市场。

本仓库提供一个可直接添加的索引：

https://raw.githubusercontent.com/HSYrc/DeepVibe-dsh/main/market/index.json

1. 打开 插件 → 实验性插件 → 更多，启用 自定义插件市场。
2. 进入 发现 → 添加索引源。
3. 粘贴上面的 URL。
4. 搜索 DeepVibe-dsh，确认来源后安装。

索引已指向 npm 包，安装的是 deepvibe-dsh@0.5.18。

Community listing · 社区收录：仓库已添加 dsh-plugin topic，并提交到 DSH Plugin Hub。Hub 由社区运营，不是 DeepSeek 官方目录。
社区市场由 dsh-plugin.org 维护，不是 DeepSeek 官方目录。DeepSeek 官方内置目录没有公开自助上架入口。

Usage · 使用

焦点不在输入框内时，快捷键可用：

| 按键 | 作用 |
| C | 打开/关闭快速调参浮层 |
| H | 打开/关闭 HUD |
| I | 进入/退出沉浸模式 |
| Esc | 关闭浮层 / 退出沉浸 |

模型开始运行后，沉浸看板自动升起。Esc 或 EXIT · ESC 只会退出沉浸，不会中断任务；任务仍在运行时，右下角 ENTER 可以重新进入。

中文 焦点不在输入框内时，快捷键可用：

| 按键 | 作用 |
| C | 打开/关闭快速调参浮层 |
| H | 打开/关闭 HUD |
| I | 进入/退出沉浸模式 |
| Esc | 关闭浮层 / 退出沉浸 |

模型开始运行后，沉浸看板自动升起。Esc 或 EXIT · ESC 只会退出沉浸，不会中断任务；任务仍在运行时，右下角 ENTER 可以重新进入。

Approval & questions · 审批与提问

沉浸模式下，审批请求会显示为右侧卡片：拒绝 或 允许一次。卡片直接驱动 DSH 原生审批面板，只有一条决策路径。

模型提问使用同一套界面：选项、可选多选、自由输入框、拒绝、提交。提交直接驱动原生提问 waterfall，不另开回答路径。

任一卡片等待期间，动画运动和粒子生成会逐渐停止；亮度保持在运行态。

中文 沉浸模式下，审批请求会显示在右侧卡片：拒绝 或 允许一次。卡片直接驱动 DSH 原生审批面板，只有一条决策路径。

模型提问使用同一套界面：选项、可选多选、补充输入、拒绝、提交。提交直接驱动原生提问 waterfall，不另开回答路径。

等待审批或回答期间，动画运动和粒子生成会逐渐停止，亮度保持在运行态。

Data modes · 数据档位

| Mode | Name | Ring text and numbers | Session reading |
| 0 | Animation only | sample words / synthetic numbers | tokens skipped; brightness still follows running/idle |
| 1 | Mixed 30% (default) | real tokens when available; synthetic headers | tokens + tool names + running state |
| 2 | Full capture | only real tokens, tools, STEP / TURN, tok/s, context; blank when unknown | full |

dataMode only affects text and numbers on the canvas. The H HUD is always a real session monitor.

| 档 | 名称 | 光环上的文字与数字 | 会话读取 |
| 0 | 纯动画 | 原作示例词表 / 合成数字 | 不抓词元；亮度仍随运行/静默变化 |
| 1 | 混合 30%（默认） | 有词元时用真实回答，表头仍为合成 | 词元 + 工具名 + 运行状态 |
| 2 | 完全抓取 | 只显示真实词元、工具、STEP / TURN、tok/s、上下文；没有就留空 | 全部 |

dataMode 只约束画布上的文字与数字；H 打开的 HUD 始终是真实会话监视器。

Readings · 关键读数

The dock separates what each number means:

- OUT: output tokens from the current stream.
- CACHE HIT: cacheRead / (uncachedInput + cacheRead + cacheWrite) over the whole session, one decimal; the top header, card and chart use the same value.
- INST TOK/S: tokens arriving in the last 50 ms slice.
- CONTEXT: used / left, window size, fill %, compactions and prunes.
- BALANCE / TODAY: Platform wallet and actual billed spend for the local day.

中文 看板会区分每个数字的含义：

- OUT：当前流里的输出词元。
- CACHE HIT：整个会话的 cacheRead / (uncachedInput + cacheRead + cacheWrite)，一位小数；顶部 CACHE、卡片和折线图共用同一个值。
- INST TOK/S：最近 50 ms 切片内到达的词元速率。
- CONTEXT：已用 / 剩余、窗口大小、占用百分比、压缩与 prune 次数。
- BALANCE / TODAY：平台钱包余额与本地今天实际账单。

Platform billing · 平台账单

BALANCE and TODAY are read by the Host through the DSH account's Host-only Platform session. The client receives only aggregates.

- Polling is 30 seconds; Platform data itself may lag about 5 minutes.
- BALANCE prefers the DSH account's getBalance.
- If Platform usage is unavailable (for example a 202/rate limit), TODAY shows —. It never falls back to a made-up estimate.
- A DSH account login is required. API-key-only mode has no wallet balance.

中文 BALANCE / TODAY 由 Host 通过 DSH 账户的 Host-only Platform session 读取，客户端只拿到聚合值。

- 轮询间隔 30 秒；平台数据本身可能有约 5 分钟延迟。
- BALANCE 优先使用 DSH 账户的 getBalance。
- 平台 usage 不可用（例如 202/限流）时，TODAY 显示 —，不会回退到编造的估算。
- 需要 DSH 账户登录；纯 API Key 模式没有钱包余额。

Data provenance · 数据来源

Everything is read-only and derived from the current session:

- ctx.sessions.binding(sessionId) → eventSource
- transient assistant/live-chunk → streaming tokens
- durable turn/step, user/message, assistant/message, tool/call, tool/result
- useSessions / useSessionStatus → current session and running state
- DSH tokenUsage projection → whole-session cache hit
- Host route GET /haloflux/platform-summary → Platform aggregates

No session log is written; bindings, timers and subscriptions are released on switch/dispose.

中文 所有数据都是只读的，来自当前会话：

- ctx.sessions.binding(sessionId) → eventSource
- transient assistant/live-chunk → 流式 token
- durable turn/step、user/message、assistant/message、tool/call、tool/result
- useSessions / useSessionStatus → 当前会话与运行状态
- DSH tokenUsage 投影 → 整个会话缓存命中率
- Host 路由 GET /haloflux/platform-summary → 平台聚合数据

不写会话日志；切换会话或销毁时会释放绑定、定时器和订阅。

Settings · 设置

Open Settings → DeepVibe-dsh. There are 82 parameters in 6 groups: original 56 (Global 5 / Ring 7 / Inner 18 / Outer 17 / Depth 9) plus 26 plugin parameters.

Useful defaults:

opacity 0.55 idle canvas opacity
runOpacity 1.00 immersive running opacity
readOpacity 0.22 running but outside immersion
runLevel 1.60 running intensity
idleMotion 0.18 idle motion
dataMode 1 mixed
attackMs 800 attack
releaseMs 2600 release

Three presets are included; Save as default writes to localStorage, so settings survive restarts.

中文 打开 设置 → DeepVibe-dsh。共 82 个参数、6 个分组：原作 56 项（全局 5 / 圆环 7 / 圈内 18 / 环外 17 / 空间层次 9），加上 26 个插件参数。

常用默认值：

opacity 0.55 空闲不透明度 runOpacity 1.00 沉浸运行不透明度 readOpacity 0.22 运行但退出沉浸时 runLevel 1.60 运行强度 idleMotion 0.18 静默态运动 dataMode 1 混合 attackMs 800 起势 releaseMs 2600 收势

内置 3 个预设；保存为默认写入 localStorage，跨重启保留。

Build & test · 构建与测试

The source is split into plain fragments and assembled into one browser artifact:

node build.mjs
node --check client.js

Headless tests (no browser, no files outside the package):

node tools/engine-smoke.cjs
node tools/live-selftest.mjs
node tools/client-smoke.cjs
node tools/dock-smoke.cjs
node tools/session-switch.cjs

After changing src/, rebuild and reinstall (or restart Host) before refreshing the page.

中文 源码按片段组织，最终拼成一个浏览器产物：

node build.mjs
node --check client.js

无头测试（不需要浏览器，也不依赖包外文件）：

node tools/engine-smoke.cjs
node tools/live-selftest.mjs
node tools/client-smoke.cjs
node tools/dock-smoke.cjs
node tools/session-switch.cjs

改完 src/ 后需要重新构建并重装（或重启 Host），再刷新页面。

Compatibility · 兼容性

实测于 DeepSeek Harness 0.2.1-rc.5（Windows 桌面版）。依赖宿主约定：shell.overlay / settings.section 槽位、useSessions / useSessionStatus、sessions.binding() 的 eventSource。DSH 大版本升级后若背景消失，先排查这些接口。

License & credits · 许可与致谢

本项目使用 PolyForm Noncommercial License 1.0.0：仅限个人非商业使用，禁止商业使用。再分发或修改时请保留 LICENSE 与 NOTICE。

原作 HALOFLUX：Copyright (c) 2026 Ryder191（RYDER CODE / Ms MAIKEBAIs CAT），<https://github.com/Ryder191/haloflux>，PolyForm Noncommercial License 1.0.0。

如果它让你的工作流更舒服，欢迎在 GitHub 点一个 ⭐。