wally8-8/dsh-done-whale

Plugin插件 Native原生 ⭐ 10 MIT Sessions & Context会话与上下文

DeepSeek Harness 插件:标签页鲸鱼状态灯 —— 会话完成时变绿,有待处理交互时变琥珀。标签页鲸鱼状态灯:完成时绿色,有需等待事项时琥珀色。

Project Overview项目介绍

This is a purpose-built plugin for DeepSeek Harness that turns the default whale favicon of DSH tabs into a session status indicator. It uses the exact same official status signal that the sidebar notification dots use, so statuses are always in sync with the rest of the DSH interface. Since the plugin is not published to npm, users have to install it directly from this GitHub repository via the DSH CLI command matching their current profile name, and restart DSH or refresh the page after installation to activate it correctly.

The plugin uses three colors to mark different session statuses: green means the session finished running while the user was not looking at the tab, amber means the session is waiting for user input like approval, question answering, or plan confirmation, and black is the default state meaning all is well. Only main sessions will trigger a color change; sub-agent sessions do not affect the whale icon color. If multiple statuses are present at the same time, green is displayed first. This plugin is ideal for DSH users who work across multiple open tabs and don’t want to miss any important session status notifications.

The plugin allows users to customize all three status colors in the "Whale Status Light" section of DSH’s settings panel, and it also supports one-click reset to the original default color scheme. After installation, the plugin includes an auto-update feature that checks for new versions automatically on load, and users can also trigger manual checks or updates from the settings panel or via the built-in whale_update tool. It only requires an official version of DeepSeek Harness with no other extra dependencies, it’s released under the open-source MIT license, and leaves no residual files after uninstallation.

这是一个专为 DeepSeek Harness 开发的原生插件,核心功能是将 DSH 默认的标签页鲸鱼图标修改为会话状态指示灯,方便用户在切换其他标签页忙碌时,一眼就能知道当前会话的处理状态。它使用和 DSH 侧边栏通知圆点完全一致的官方状态信号,状态永远同步。因为该插件没有发布到 npm,用户需要通过 DSH CLI 命令从当前 GitHub 仓库直接安装,安装后重启 DSH 或刷新页面即可生效。

插件用三种颜色区分不同会话状态:绿色代表会话在用户未查看该标签页时已经运行完成,琥珀色代表会话正在等待用户处理提问、审批、计划确认等交互,黑色代表一切正常,为默认状态。只有主会话会触发图标变色,子代理会话不会触发状态变更,同时存在多种状态时优先显示绿色。这款插件适合需要多标签页切换工作,不想错过会话完成或待处理通知的 DSH 用户。

插件支持自定义颜色,用户可以在 DSH 的设置面板「鲸鱼状态灯」板块修改完成色、待处理色和默认色,也支持一键恢复默认设置。安装后插件自带自动更新功能,用户可在设置面板手动检查更新,也可调用内置工具触发更新。本项目采用 MIT 许可开源,卸载后无残留,仅依赖官方版本的 DeepSeek Harness,不需要额外其他依赖。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 10 stars - an early-stage project星标 10,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add -w github:wally8-8/dsh-done-whale

把 wally8-8/dsh-done-whale 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-done-whale 🐋

让 DeepSeek Harness 的标签页鲸鱼图标变成状态灯——您在别的网页忙的时候,瞄一眼标签就知道:有会话干完活了,还是有事情等您拍板。

效果

鲸鱼颜色 含义 什么时候恢复
🟢 绿色 有会话在您没看它的时候跑完了 点开那个会话后自动恢复;全部看完回黑
🟠 琥珀色 有会话有事等您处理:向您提问 / 等您审批 / 等您审核计划 处理完后自动消失
⚫ 黑色 一切正常(原版鲸鱼) 默认状态

颜色和侧边栏里的绿点、琥珀点用的是同一份官方信号,永远同步。

要求

  • 官方版本的 DeepSeek Harness(插件走官方插件机制,不需要任何额外依赖)

安装

dsh plugin --profile web add -w github:wally8-8/dsh-done-whale

装完重启 Harness(或刷新页面)即生效。

⚠️ 本插件没有发布到 npm,所以 dsh plugin --profile web add dsh-done-whale 会失败(找不到这个包)。请用上面这条 GitHub 安装命令。 用别的 profile 就把 web 换成你的 profile 名;改过 DSH_HOME 的话同理。

更新

装好之后不用再碰终端:

  1. 打开 设置 → 鲸鱼状态灯:「版本与更新」块会自动检查一次(也可以点 检查更新 / 重新检查 手动查);
  2. 有新版时会出现 有新版本 vX.Y.Z 和 立即更新,点它就完成下载与安装;下载安装期间随时可以点 取消;
  3. 装完后 重启 Harness 才生效(宿主半是进程内的模块,只刷新页面不够)。

更新过程会显示阶段、百分比、已用时与依赖计数;网络失败可以直接重试。

卸载

dsh plugin --profile web remove dsh-done-whale

卸载后没有任何残留。

说明

  • 只响应主会话;子代理会话不会让鲸鱼变色。
  • 绿色和琥珀色同时存在时,显示绿色(干活完成优先)。
  • 刷新页面后鲸鱼回到黑色:这是官方"已完成通知"的内存态语义,属正常现象。
  • 颜色可改:设置 → 鲸鱼状态灯里能改完成色 / 待处理色 / 默认色,也能一键恢复默认。

给 AI 的更新指引(DSH 破坏性更新后请读这一段)

如果你是读到本文件来帮用户修插件的 AI agent,按下面顺序做,不要自己猜安装命令:

  1. 先看它现在是怎么装的:读 ~/.dsh/profiles/web/package.json 的 dependencies["dsh-done-whale"](profile 名不是 web 就换成实际名字, 改过 DSH_HOME 就换成实际 home)。

  2. 一律用 GitHub 通道重装——本项目从未发布到 npm,任何 dsh plugin --profile web add dsh-done-whale 形式的命令都必然失败:

    dsh plugin --profile web add -w github:wally8-8/dsh-done-whale
    
  3. 让用户重启 Harness:宿主半是进程内模块,磁盘换了新代码也必须重启才生效, 只刷新页面只能更新浏览器半。

  4. 插件能用时优先让它自己更新:设置 → 鲸鱼状态灯 → 「版本与更新」→ 检查更新 / 立即更新;也可以调用本插件注册的模型工具 whale_update (action="check" 先看版本,action="update" 真执行)。

  5. 坏到界面都不出来时:本插件遵循"静默降级"——官方服务改名/消失时它整块不启动, 不会拖垮 DSH 界面。此时按第 2 步重装 + 重启即可恢复。

  6. 重装是安全的:dsh plugin --profile web remove dsh-done-whale 卸载零残留, 再按第 2 步装回即可。若依赖里写着 link:(本地开发安装),重装会把它切换成 GitHub 安装,动手前先问用户。

License

MIT

← 上一个 Prev dsh-plugin-integration 下一个 Next dsh-mini-tui →