dsh-livechat cover # dsh-livechat [![version](https://img.shields.io/badge/version-0.6.14-blue)](https://github.com/huashenglian/dsh-livechat) [![license](https://img.shields.io/badge/license-MIT-green)](#license) [![platform](https://img.shields.io/badge/platform-DeepSeek%20Harness-orange)](https://github.com/deepseek-ai) **Bilibili-style live-chat danmaku overlay for [DeepSeek Harness](https://github.com/deepseek-ai) (`dsh`) Web.** Watch your agent work while a crowd of floating comments drifts across the conversation area — preset banter, optional LLM-generated quips, and your own messages too. [中文](./README.md) · `English` [Installation](#installation) · [Features](#features) · [Module docs](#module-documentation) · [Architecture](#architecture)
--- ## Installation The plugin is a **bundle**: it carries its own `cordis.patch.yml` and self-activates — one command, no manual patch editing. ```bash # From a local directory dsh plugin --profile web add ./dsh-livechat # From npm (prebuilt — skips the allowBuilds approval) dsh plugin --profile web add dsh-livechat # From GitHub dsh plugin --profile web add github:huashenglian/dsh-livechat # From a packed tarball (pnpm pack / npm pack) dsh plugin --profile web add ./dsh-livechat-0.2.0.tgz ``` Restart `dsh web`, then open . The danmaku overlay and a floating control ball appear over the conversation area. > [!NOTE] > The bundle ships its own `cordis.patch.yml` that self-activates the plugin (`insert id: livechat`). **Do not** add a duplicate `insert` entry in your profile patch — a second insert throws `duplicate loader entry id: livechat` at boot. If you don't have the `dsh` CLI yet, you can run the web server directly: ```bash npx @deepseek-ai/dsh web ``` ### Quick health check ```bash curl http://127.0.0.1:3080/api/danmaku/health # {"ok":true,"name":"dsh-danmaku","version":"0.6.14"} ``` --- ## What it does When the agent sends a message, finishes a reply, calls a tool, or completes a task, a burst of danmaku floats across the conversation column — just like watching a livestream. Preset packs cover general / coding / casual vibes, and an optional LLM generates fresh, context-aware quips on a throttle. A draggable ball gives you quick controls; a settings card tunes everything. ![Danmaku in action](assets/danmaku-demo.png) *Live danmaku drifting over the conversation area while the agent works — multi-track, color-weighted, with the floating control ball (top-right).* --- ## Features | Module | What it covers | Doc | |---|---|---| | **Overlay & rendering** | `shell.overlay` mount, DOM renderer, multi-track collision avoidance, anti-occlusion fade, render-backend chain | [overlay-and-rendering.md](docs/overlay-and-rendering.md) | | **Presets & LLM** | Three preset packs, event-triggered sampling, fatigue dedup, a preset-feature master switch (off = LLM only), optional LLM generation with smart/interval/tool-call wake modes, style templates | [presets-and-llm.md](docs/presets-and-llm.md) | | **Interaction** | Draggable control ball, hover-pause, click-for-detail (copy / block / delete), user-sent danmaku, heat bar, welcome & task-done effects | [interaction.md](docs/interaction.md) | | **Session pools** | Per-session `.jsonl` danmaku pools, history replay with decay + like-boost, archive/restore, in-app pool editor | [session-pools.md](docs/session-pools.md) | | **Gift effects** | Three-pane modal (gift library / asset library / config; draggable dividers with persisted widths), left-column search + one category dropdown (bilibili / custom, both levels in one popover), center toolbar (room-id extract + import ▾ + icon size + new folder + clear assets), assets usable as soon as added (nothing to bind), card-click effect position (click the grid's blank area to deselect), basics row for global/asset animation size, "+"/red "×", 3 default gift cards (master switch off by default, zero room ids) | [gift-effects.md](docs/gift-effects.md) | | **Configuration & API** | Settings card UI, every config field with defaults/range, full HTTP API reference | [configuration.md](docs/configuration.md) | ### Highlights - **Three layouts**: roll (scroll), top-fixed, bottom-fixed — weighted per-config - **Anti-occlusion**: overlay dims while you read, brightens when the crowd gets loud - **LLM with safe fallback**: generation fails → silent preset fallback, no error popups (no fallback once the preset master switch is off — LLM only) - **AI-only per-session memory**: only LLM comments are cached/replayed and likeable; presets stay live-generated, and deleted sessions clean up automatically - **Chromium-first**: tuned for Edge / Chrome; `translate3d`, page-`hidden` pause, on-screen cap - **Paused items stay**: hover/detail-locked danmaku remain on screen until they resume and leave the range - **Danmaku off = plugin off**: turning off 启用弹幕 stops every danmaku, gift effect and gift tip, and deletes a playing gift animation immediately; gift effects keep their own `giftEnabled` gate - **Config survives restarts**: every save writes a local mirror (`$DSH_HOME/danmaku-config.json`) plus a minimal `danmaku:` section in `settings.yaml`; boot resolves mirror → settings → defaults, so a restart never resets your setup - **Sessions by name**: the pool editor labels each pool with the real dsh session title instead of a truncated session id --- ## Recent updates > Full version history lives in [`docs/version-history.md`](https://github.com/huashenglian/dsh-livechat). Highlights of the 0.6.x line: | Version | What changed | |---|---| | 0.6.14 | **Privacy + emoji rendering fixes** (local, unpublished): ① **the danmaku LLM can no longer read user secrets** — session text, thinking snippets, tool names, warnings and usage are run through `redactSecrets()` at ingestion (`sk-`/`rk-`, GitHub/Slack/AWS/Google keys, JWTs, `Bearer`, `apiKey=…`/`token: …`/`密码：…`, PEM private-key blocks, 32+ hex / 40+ base64 blobs, `C:Users`, `/home/` → `［已隐藏］`), and `buildLlmPrompt` redacts every dynamic field again as defence in depth; trigger previews are masked too. ② **Emoji keep their own colours on the non-DOM backends** (webgl2 / webgl2-worker) — text was baked white and tinted from `t.r/t.a`, but a colour-emoji glyph is a bitmap that ignores `fillStyle`, so it came out in the danmaku colour and partly hollow; lines containing emoji now bake their real colour and use the `vSc` keep-baked-colour branch, while text-only lines keep the shared white bake + per-instance tint (atlas reuse unchanged); ③ **the floating quick panel's number field can exceed its slider** (`sliderField` gained `numMin`/`numMax`) — max-on-screen keeps the 5–80 slider but the input accepts the settings card's **1–200**, with the thumb parked at the end, so raising a value no longer needs the full settings card; ④ **full-screen danmaku**: the track count is no longer hard-coded to **16** — it is `floor(height / lineHeight)` per layout (ceiling 64), and row choice is now the **Bilibili algorithm, per layout**: roll/reverse take a **random enterable row inside the live band** (candidates are the enterable rows of the band; the band only grows — between its first two free rows — when nothing inside it can take the line, so it stays contiguous with no holes, yet rows are not reused in fill order and never form parallel diagonals; a row becomes reusable once its predecessor has travelled 0.25 of the viewport, so each row holds ~3 lines; box width + gap + catch-up prediction means no overlap), while **top hugs the top edge and bottom hugs the bottom**, stacking row by row. The rate budget is **3/6/8/10 lines per second** (density 1–2 / 3–5 / 6–8 / 9–10), but **one line per tick**, and the interval is never shorter than what the current band can absorb (`rows / row-reuse cycle`) — a small display area slows down automatically instead of dropping spawns and bunching the survivors into waves; the GPU instance batch went 48 → **200** to match the max-on-screen ceiling (anything beyond was silently not drawn); `density` ceiling 5 → **10**, and max-on-screen is clamped 1–200; ⑤ **settings-card section dividers** are dashed → **solid** and coloured with `color-mix(… 28%)` of the theme text colour (measured 1.29:1 → **2.43:1** on the dark card), with the whole-element `opacity:.85` removed | git log | | 0.6.13 | **The per-line cap is now a real, configurable hard cap** — five pool/parse paths used to hard-code 48 and silently cut longer text, with no way to raise them; new **`contentMaxChars`** (8–2000, default 200) is what the Basics section's **per-comment char cap** and the floating quick panel edit, and pool writes / likes / rewrites / LLM parsing all clip to it; the LLM section keeps **"LLM max chars"** (`styleMaxChars`, default 24 — prompt text only, clips nothing); **the Text/List choice is now a global, persisted preference** (`dsh-danmaku-preset-view` in localStorage — survives pack switches, reopening the editor and restarting dsh; packs over 500 rows still open in list to avoid a 1 MB textarea); **the session pool is now LLM-only** — only `source:'ai'` entries are cached/replayed and likeable, presets and user-sent text are never persisted, and liking a preset is a no-op (legacy rows stay on disk but are filtered on read) | git log | | 0.6.0 | Gift module UX rework: single-entry modal (asset warehouse / effect position / basics / test), 3 default gift cards | | 0.6.1 | Weight edits apply immediately + refresh-write failures reported | | 0.6.2 | Floating-ball out-of-bounds clamping fixed — a persisted position can no longer hide the ball | | 0.6.5 | Gift modal rebuilt as three panes: draggable dividers with persisted widths, asset library moved to a center toolbar panel | | 0.6.6 | Gift modal polish: fixed-height cards, elastic trigger-row slider, import merged into one card | | 0.6.7 | Asset-card selection highlight + master-switch gating, render backend defaults to `auto` per client, dark-theme native `select` popup fix, animation / icon size, fixed danmaku leaking into the titlebar after applying a display area | | 0.6.8 | Three-backend window resize adaptation, viewport-ratio floating-ball repositioning, desktop titlebar exclusion | | 0.6.9 | Settings "More" menu: reset all config / **clear all caches (gift assets are restored to the defaults: builtin assets + default gift cards)**; the "More" popover shares the settings-window background and follows the theme; gift library = **search on the LEFT + one category dropdown on the RIGHT** (both levels in ONE popover: bilibili / custom + 金瓜子 / 银瓜子) + **assets are usable as soon as they are added** (nothing to bind — triggering and position both hang off the asset); draggable custom effect position (left-mid / right-mid / custom); clicking the grid's blank area drops the selected card; turning off 启用弹幕 (danmaku) turns off the plugin (no danmaku of any kind, no gift effects, no gift tips; a playing gift animation is deleted immediately), `giftEnabled` still being the gift module's own gate; gift tip danmaku bypass the onscreen soft cap and only fire after the effect really mounts; pop-menu viewport clamping, second resize path merged | | 0.6.12 | **Preset pack editor: dual view + file import** (**local change, not yet published**): the editor title row is now three sections — Import | Text / List — and **packs with more than 500 rows open straight into the list view** (so a 22k-line pack never degrades into one ~1MB textarea). The list view has a search bar (filtering spans every page), per-row checkboxes, a per-row ×, a bottom 「＋ Add entry」 button, a pager and a **page-size** field (`dsh-danmaku-preset-page-size` in localStorage, default 50, clamped 10..500). **Select-all only selects the current filtered result** (the button reads 「Select all filtered (N)」), and **emptying a row never deletes it** — the empty row is kept and outlined in red, removable only via × or Delete selected, because auto-deleting would shift every later selected index and delete the wrong rows. The new Import button accepts `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.ndjson` / `.xml` (bilibili `` danmaku); the new host route `POST /api/danmaku/presets/import` parses it (cap **16 MB, covering file + existing entries combined**), dedupes with trim → NFC → exact comparison (case-sensitive) and **appends** to the end of the pack, never overwriting existing lines; the result is reported as added / existing / skipped. Import and editing both touch the draft only — the footer Save is still the single writer | git log | | 0.6.11 | **The retired gift-binding (`giftBindings`) legacy logic is deleted outright**: the field had no write path since 0.6.9's「即加即用」 rework; this release removes it together with its three `DEFAULTS` entries, the normalization branches in both `clampGiftConfig` twins, the supporting constants, and the one-shot boot migration `migrateGiftPositions`. No behaviour change — trigger candidates have always been **the assets in the library with `weight > 0`** (add to the middle column = enable, remove = disable) and the effect position has always lived on the **asset manifest**. The binding-clamp tests were removed with the field; the same contract stays covered by the asset-side `itemPosition` / `setPosition` tests | | 0.6.10 | **Every feature switch is now a sliding toggle** (ball quick panel / settings card / gift modal — track + knob animation, disabled state dimmed); **each session card in the pool editor gets an × delete button** — one click opens a confirmation, and confirming deletes ONLY that session's live + archive danmaku cache (other sessions untouched; `DELETE /api/danmaku/pool/session`); fixed the settings-card pool row showing a hardwired 「活跃 0」 (it used to read stats for a nonexistent probe session — it now reads the real session list, live / archive are true entry counts, and the row refreshes when the pool editor closes); **the 「弹幕 Live Chat」 footer Save is now the single writer for every sub-window** — the preset pack editor lost its own Save button and only edits the draft, and the only ways back are the footer Undo or closing that window; **deleting a preset pack is staged before it is applied** (confirmation removes it from the draft only; the footer Save is what makes it real, and a deleted pack stops being sampled immediately); the **More** menu entries are renamed **Reset all parameters / Reset everything** (each confirmation states its own scope); **fixed the laggy settings-card left nav** (the section flash forced a full relayout per element, blocking the click for 2-4s before scrolling began — now one relayout, scrolling starts within 36-73ms) | Earlier milestones also include the emoji library (imports / weights / manifest), the display-area editor, advanced danmaku (reverse scroll), and the optional LLM smart / interval / tool-call wake modes. ### Desktop support **Since v0.6.8 the plugin officially supports the DeepSeek Harness desktop app (Electron):** - The floating ball never enters the Windows titlebar strip (`--dsh-windows-titlebar-height` exclusion); - The danmaku display area adapts to window resizes; - Other 0.6.8 behaviors this round: after a resize, **on-screen danmaku keep their original coordinates and finish their run** (new danmaku are born at the new size); the floating ball is repositioned by **viewport ratio** (clamping takes precedence over ratio, with a one-shot migration of legacy pixel records). ![Desktop app](assets/desktop-danmaku.png) --- ## Architecture ``` dsh-livechat/ ├─ package.json # dsh.bundle + dsh.client declaration ├─ cordis.patch.yml # self-activating bundle layer (insert id: livechat) ├─ lib/ │ ├─ index.js # Host: settings namespace, session/event ring, HTTP routes, optional LLM │ ├─ client.js # Client: shell.overlay layer + settings card + DOM renderer + drag ball │ ├─ presets.js # Shared: preset packs, sampling, track-collision pure functions │ └─ emoji-lib.js # Emoji library: folders, imports (git/zip), weights, manifest ├─ tests/presets.test.js # unit tests (node --test) ├─ docs/ # module documentation (this README links out) └─ assets/ # demo screenshots & cover art ``` - **Host** (`lib/index.js`): registers the `danmaku` settings namespace, observes `session/event` into a trigger ring buffer, serves config/trigger/LLM/pool HTTP routes, and optionally generates danmaku via a configured LLM provider. - **Client** (`lib/client.js`): a self-contained `window.__ModuleLoader__` factory — mounts a `pointer-events:none` overlay on `shell.overlay`, renders danmaku via DOM (`translate3d`), runs the drag ball, the settings card (`settings.plugin.item`), and the pool editor. - **Shared** (`lib/presets.js`): preset packs, weighted sampling, layout/color picks, and track-collision checks — all pure functions, unit-tested. The renderer interface aligns with the design doc (`参考文档/danmaku-renderer-design.md`). First release ships the **L5 DOM** backend; the architecture reserves a drop-in upgrade path to WebGL2 / Worker+WebGL2 without touching the business layer. ### Test ```bash node --test tests/presets.test.js ``` --- ## Uninstall ```bash dsh plugin --profile web remove dsh-livechat ``` This removes the dependency and the bundle entry. If the server is still running, uninstall also wipes pool cache (`~/.dsh/danmaku-pools/`). You can also clear all pools from the pool editor’s red **Clear all pools** button. --- ## License MIT