dsh-whale-buddy

DSH PLUGIN浏览器与联网

仓库 RangeKing/dsh-whale-buddy

浏览器与联网 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness Web 带来一只静谧灵动的 DeepSeek 小鲸鱼:行内状态鲸随思考与工具调用实时游动,右侧 Whale Dock 常驻可拖拽交互。

一句话选型结论

按资料字段整理

dsh-whale-buddy 是浏览器与联网类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类浏览器与联网 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 1 复刻 0 · 未关闭 issue 未标注
最近更新 2026-09-26 创建于 2026-09-16
README 15.2 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add dsh-whale-buddy@0.2.1
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.0-rc.2 等 2 个;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.0-rc.2、0.2.0-rc.1版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-whale-buddy:DeepSeek Harness 里会呼吸的状态鲸鱼

  • 行内状态鲸实时伴随
  • 右侧 Whale Dock 常驻面板
  • 弹簧物理破水动画
  • 全生命周期任务状态感知
  • 适配深浅主题与无障碍

适用场景

联网搜索

上游标签

buddydeepseekdeepseek-harnessdsh-pluginsvg-animations

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-08): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2 等 2 个),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在浏览器与联网场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-whale-buddy当前 L5 · 运行验证通过 低风险 1 0.2.0-rc.2 等 2 个 有
dsh-our-free-model L3 · 安装规范通过 低风险 8,796 未标注 有
dsh-web L3 · 安装规范通过 低风险 8,549 未标注 无
BrowserSkill L4 · 沙盒安装通过 低风险 8,456 未标注 有
dsh-pocket L5 · 运行验证通过 低风险 1,656 0.2.0-rc.2 等 12 个 有
Browser4 L4 · 沙盒安装通过 中风险 1,152 未标注 有

仓库档案

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方RangeKing仓库 dsh-whale-buddy · 默认分支 未标注
分类浏览器与联网search
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言TypeScript仓库主语言
许可证BSD-3-Clause商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 未标注收录时的数值,非实时
创建 / 更新2026-09-16 · 2026-09-26最后推送 未标注
本站收录2026-09-17首次进入本站目录的时间

README 全文

15.2 KB
作者原文,中文版优先;只做安全转义,不改内容

🐋 dsh-whale-buddy

A physics-driven, state-aware companion that brings the DeepSeek whale to life in DeepSeek Harness Web.


> [!NOTE]
> Independent Community Project: dsh-whale-buddy is an independent open-source plugin. It is not an official DeepSeek product and is not affiliated with, sponsored by, or endorsed by DeepSeek. The whale mark belongs to DeepSeek; see THIRD_PARTY_NOTICES.md.


🌟 Overview

dsh-whale-buddy enriches DeepSeek Harness Web (DSH) with a lively, responsive companion that visually mirrors the AI's real-time reasoning, tool calls, and execution states.

Built on a deterministic spring physics engine, the whale breaches through simulated water when a turn begins, swims calmly alongside the active status label, and wears dynamic contextual props representing current tasks—all while preserving the exact vector geometry of the official DeepSeek mark.


✨ Key Features

  • 🌊 Procedural Breach & Water Simulation
    Breaches out of simulated water at the start of every turn, creating lively ripples, splash dynamics, and an engaging sense of presence.

  • 🐋 Living Breathing Companion
    Not just a static mark—the whale breathes steadily, blinks stochastically, and tilts its heading organically according to swimming velocity.

  • 🎯 Full-Lifecycle Task & State Awareness
    Instantly mirrors thinking, streaming responses, tool execution, file reading/editing, context compaction, and user interaction states with clear status labels and bespoke monochrome vector props.

  • 🧷 Dual Seamless Surfaces

  • Inline Status Whale: Nestled directly inside the conversation status row with zero layout shift or visual jitter — or, with the classic option on, in DSH 0.1.5's blue "Deep diving..." row above the composer.
  • Whale Dock: A sleek, edge-anchored floating pill button on the right edge, draggable vertically, expanding smoothly into a comprehensive companion panel.

  • 🎨 Native Visual Integration
    Automatically samples typography gradient color stops from the DSH interface, adapting flawlessly to dark and light themes without modifying official logo paths.

  • ♿ First-Class Accessibility
    Fully respects prefers-reduced-motion: reduce. Immediately presents stable static poses, offers instant panel toggling, and eliminates background frame loop overhead.


🖥️ Product Surfaces

1. Inline Status Whale

When a conversation turn begins, the inline whale executes an authored breach out of a procedural sea, settling into an effortless swim beside the status label. It updates DSH's status text with clear, descriptive task names (深度求索中…, 正在作答…, 读取文件中…, 执行命令中…, etc.) and carries an appropriate task prop.

  • Zero Layout Shift: Employs calculated negative bleeds (fitToMark()) so the breach arc overflows cleanly without shifting surrounding chat layout.
  • Native Ink Sampling: Dynamically extracts DSH's gradient stops on mount, harmonizing with both dark and light modes.
  • Both DSH Label Shapes:
  • DSH 0.1.7 removed the blue "Deep diving..." row; the running label now lives in the turn's grey fold header ("深度求索中,用时12秒"). The whale goes into that header and wears its grey, and only the leading words are swapped (读取文件中,用时12秒), so DSH's own clock keeps ticking.
  • DSH 0.1.5 still draws the blue row, and the whale goes into it as before.
  • Classic "Deep diving" option (Dock panel → Classic "Deep diving", off by default): on DSH 0.1.7, draws the old blue row back — same type, same gradient sweep, clock after 15 s — directly above the composer with the whale in it, and leaves DSH's grey header untouched. Unlike the default, this row takes space: it appears and leaves once per turn, as DSH 0.1.5's own row did. The label stays Deep diving... in both languages while the whale follows the current task. On DSH 0.1.5, the same fixed wording is applied to the existing row without adding another.

2. Whale Dock & Companion Panel

Attached to the right edge of the viewport, the Whale Dock provides a persistent, low-profile companion presence.

  • Vertical Track Dragging: Drag the collapsed button vertically with a pointer, or focus it and use Arrow Up / Arrow Down / Home / End. Position persists proportionally across window resizes.
  • Continuous Surface Expansion: Opens inward into a compact companion panel featuring a live preview, state inspector, and quick toggles.
  • Fluid Dismissal: Closes gracefully via the close button, Escape, or outside clicks.

🎭 State & Gesture Matrix

State Status Label (zh) Contextual Prop Posture & Behavior
idle — Tossable ball (after 9s dwell) Relaxed swim, subtle drift, unhurried gestures
thinking 深度求索中… Pulsing dots Attentive posture, faster chase spring, slight nose dip
responding 正在作答… Breathing speech bubble Steady forward cruise
working 执行命令中… Articulated wrench Brisk, purposeful movement
working · reading 读取文件中… Flowing file stream Files stream horizontally beneath the hull
working · editing 编辑文件中… Sketching pencil Dynamic stroke cadence with steady drift
working · searching 搜索中… Sweeping magnifier Inquisitive scanning motions
compacting 压缩上下文中… None (Body deformation) Elastic vertical compression and rebound
waiting 等待你的确认… Tilted question mark Nose-up hover, near stillness
error 出错了 Red alert exclamation Urgent micro-shake with instant red accent

> [!TIP]
> All props are plugin-authored vector elements drawn outside the logo silhouette, ensuring DeepSeek's official geometry remains 100% pristine.


📦 Installation

dsh-whale-buddy installs as a standard DeepSeek Harness Web plugin.

1. Register in Web Profile

Add the plugin to your DSH web profile configuration:

// ~/.dsh/profiles/web/package.json
{
"dependencies": {
"dsh-whale-buddy": "^0.2.1"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-whale-buddy"
]
}
}
}

2. Install the Package

cd ~/.dsh/profiles/web
npm install dsh-whale-buddy@0.2.1

Environment Requirement: DeepSeek Harness 0.1.5-rc.2 through 0.1.7-rc.1 (requires the shell.overlay and conversation.input.overlay extension slots; the classic row also uses conversation.input.dock).


⚙️ Configuration

The Dock shows the current state and three settings: inline whale, classic status row, and motion. It follows DSH’s light and dark themes. The Dock, its expanded preview, and the session whale share the same task and state-change timing. Turning off the inline whale disables the classic-row control while preserving its preference.

Additional preferences are available through localStorage:

localStorage Key Accepted Values Default Description
dsh-whale-buddy.enabled 1 / 0 1 Global master toggle
dsh-whale-buddy.inlineEnabled 1 / 0 1 Enable/disable inline status whale
dsh-whale-buddy.classicStatus 1 / 0 0 Draw DSH 0.1.5's blue "Deep diving..." row above the composer (DSH 0.1.7+)
dsh-whale-buddy.dockEnabled 1 / 0 1 Enable/disable Whale Dock
dsh-whale-buddy.size 18 – 36 26 Inline whale display size (px)
dsh-whale-buddy.motion full / subtle / static full Motion profile intensity
dsh-whale-buddy.dockTop 0.0 – 1.0 0.5 Normalized vertical track position

🔬 Technical Implementation & Deep Dive

1. Physics-Driven Motion Core

  • 120 Hz Fixed-Step Integration: Uses fixed-step substeps combined with critically damped harmonic springs to compute kinematic equations, ensuring identical motion cadence across varying display refresh rates.
  • 33-Node Coupled Wave Simulation: Models the sea surface using 33 interconnected discrete harmonic springs, realistically simulating surface depression, fluid rebound, and bidirectional ripple propagation.
  • Sub-Pixel Precision: All trajectory scales and travel amplitudes are computed in CSS pixel dimensions rather than relative vector coordinates, guaranteeing razor-sharp visuals at any display scaling factor.

2. Non-Destructive DOM Anchoring & Zero Reflow

  • Reference Identity Tracking: Hooks into the DSH status element once via role="status", then tracks the DOM node by reference identity to eliminate recursive re-matching loops during text changes. On DSH 0.1.7 the role="status" element is a hidden announcement; the anchor follows it to the [data-turn-process] header right after it, and never writes into the announcement itself.
  • Negative-Bleed Headroom (fitToMark()): Offsets visual headroom through negative margins, keeping the host layout box clamped at a stable 26 px without triggering document reflows.
  • Clean Lifecycle Teardown: Automatically detaches all MutationObservers, animation frame loops, and restores DSH's original DOM state upon unmounting or session switching.

3. Reactive State Derivation & Debouncing

  • Reactive Snapshot Observation: Evaluates DSH snapshot signals directly to identify streaming states, tool queues, and blocking user interaction events.
  • 700 ms Minimum Dwell Window: Implements an intentional hold threshold to prevent microsecond tool calls from causing visual flickering.
  • Pulsed Error Tracking: Identifies error occurrences by detecting state delta events rather than reading latched error strings, preventing stale warnings from lingering permanently.

4. Zero Dependencies & Absolute Vector Fidelity

  • Zero external runtime dependencies; engine mathematics and rendering routines are fully decoupled from UI frameworks.
  • DeepSeek's official vector paths are rendered as an unmodified rigid body inside an SVG luminance mask, with 0 coordinate deformation.

🏗️ Architecture & Project Layout

src/
├── index.ts                     # Plugin entry point
├── client/
│   ├── index.ts                 # DSH slot registrations
│   ├── config.ts                # Schema-validated configuration
│   ├── locales.ts               # Bilingual copy definitions
│   ├── integration/
│   │   ├── dsh.ts               # React bridge for DSH slots
│   │   ├── thinking-state.ts    # Semantic state evaluator
│   │   └── status-anchor.ts     # Safe, non-destructive DOM status-line injector
│   ├── state/
│   │   └── whale-state.ts       # Shared reactive state store
│   ├── whale/                   # Standalone physics & motion core
│   │   ├── geometry.ts          # Unmodified DeepSeek vector mark paths
│   │   ├── types.ts             # Pose and kinematic interfaces
│   │   ├── spring.ts            # Fixed-step spring integrator
│   │   ├── leap.ts              # Analytical breach trajectory model
│   │   ├── water.ts             # 33-node coupled harmonic spring wave model
│   │   ├── props.ts             # Contextual prop definitions & scheduler
│   │   ├── renderer-svg.ts      # Hardware-accelerated SVG renderer
│   │   └── view.ts              # RAF lifecycle controller
│   └── surfaces/
│       ├── inline-status.ts     # Inline status surface controller
│       ├── whale-dock.ts        # Dock trigger surface
│       ├── dock-panel.ts        # Companion panel surface
│       └── dock-drag.ts         # Physics-based drag-and-drop controller
└── styles/
└── plugin-css.ts            # Scoped component styles & CSS variables

🛠️ Development & Verification

The project includes an extensive automated test suite verifying physical convergence, DOM safety, and bundle integrity:

# Type check TypeScript sources
npm run typecheck

# Build production bundle
npm run build

# Run complete test suite (138 tests against production bundle)
npm run verify

# Launch visual interactive demo sandbox
npm run demo        # Open http://localhost:4173/demo/index.html

# Capture visual artifacts and showcase recordings
npm run shots       # Headless screenshot generation
npm run film        # Record showcase animation video

🧩 Compatibility & Graceful Fallbacks

  • Verified Hosts: @deepseek-ai/dsh@0.1.5-rc.1 with client packages at 0.1.5-rc.2 (measured in the running app); client packages at 0.1.7-rc.1 (types, and markup read from the published ui-chat / ui-conversation bundles — not yet run against a live 0.1.7 app).
  • DSH 0.1.7 signal changes: useSessionPendingInteraction is gone (the waiting state now reads useSessionStatus), and the session list no longer names the current session, so the Dock takes its state from the session-scoped entry instead. Both are handled per host, so 0.1.5 keeps working.
  • Graceful Degradation: If future DSH updates change internal slot names or alter status row markup, the plugin fails silently without interrupting conversation flow.
  • Dynamic Theme Adaptation: Adapts automatically to DSH --dsw-alias-* CSS variables, backed by high-contrast standalone fallback themes.

🙏 Acknowledgements

  • Implementation Heritage: dsh-thought-buddy (BSD-3-Clause) for the host/client bundle architecture, fixed-step spring timing model, and bundle verification strategy.
  • Interaction Inspiration: dsh-notch (MIT) for the edge-anchored continuous surface concept.
  • Classic Row Styling: an independent re-creation of DSH 0.1.5's running-turn label style (@deepseek-ai/dsh-client-ui-chat, MIT, © DeepSeek), using DSH's own design tokens.
  • Trademark Notice: The whale mark is the intellectual property of DeepSeek, incorporated from deepseek-harness (FishLogo.tsx) with zero coordinate alterations.

📄 License

BSD-3-Clause © 2026 dsh-whale-buddy contributors.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-whale-buddy 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add dsh-whale-buddy@0.2.1` 即可。

dsh-whale-buddy 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-whale-buddy 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-whale-buddy 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-whale-buddy 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2、0.2.0-rc.1。

dsh-whale-buddy 用的是什么许可证?

上游标注为 BSD-3-Clause。商用或二次分发前请到仓库确认许可证原文。

dsh-whale-buddy 有哪些功能?

行内状态鲸实时伴随、右侧 Whale Dock 常驻面板、弹簧物理破水动画、全生命周期任务状态感知、适配深浅主题与无障碍。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

浏览器与联网
按星标排序,可作替代方案

dsh-our-free-model

dsh-our-free-model

在 DeepSeek Harness 中装上这个 DSH plugin,无需登录、注册或填 API Key,即可直接调用 DeepSeek

L3 · 安装规范通过 8,796 星

dsh-web

dsh-web

侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。

L3 · 安装规范通过 8,549 星

BrowserSkill

BrowserSkill

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edg

L4 · 沙盒安装通过 8,456 星

dsh-pocket

dsh-pocket

DSH Pocket 让 DeepSeek Harness 装进口袋:电脑跑 dsh web,手机扫码即实时同步访问(局域网+公网),人在外

L5 · 运行验证通过 1,656 星

Browser4

Browser4

L4 · 沙盒安装通过 1,152 星

agentrq

agentrq

L4 · 沙盒安装通过 1,140 星

RangeKing 的其它插件

2 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-08。