wally8-8/dsh-done-whale
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,不需要额外其他依赖。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-done-whale(wally8-8/dsh-done-whale)
仓库:https://github.com/wally8-8/dsh-done-whale
本站详情页:https://www.yhbd.top/plugins/wally8-8-dsh-done-whale/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 10 · 最近提交 2026-09-24 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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的话同理。
更新
装好之后不用再碰终端:
- 打开 设置 → 鲸鱼状态灯:「版本与更新」块会自动检查一次(也可以点 检查更新 / 重新检查 手动查);
- 有新版时会出现 有新版本 vX.Y.Z 和 立即更新,点它就完成下载与安装;下载安装期间随时可以点 取消;
- 装完后 重启 Harness 才生效(宿主半是进程内的模块,只刷新页面不够)。
更新过程会显示阶段、百分比、已用时与依赖计数;网络失败可以直接重试。
卸载
dsh plugin --profile web remove dsh-done-whale
卸载后没有任何残留。
说明
- 只响应主会话;子代理会话不会让鲸鱼变色。
- 绿色和琥珀色同时存在时,显示绿色(干活完成优先)。
- 刷新页面后鲸鱼回到黑色:这是官方"已完成通知"的内存态语义,属正常现象。
- 颜色可改:设置 → 鲸鱼状态灯里能改完成色 / 待处理色 / 默认色,也能一键恢复默认。
给 AI 的更新指引(DSH 破坏性更新后请读这一段)
如果你是读到本文件来帮用户修插件的 AI agent,按下面顺序做,不要自己猜安装命令:
先看它现在是怎么装的:读
~/.dsh/profiles/web/package.json的dependencies["dsh-done-whale"](profile 名不是web就换成实际名字, 改过DSH_HOME就换成实际 home)。一律用 GitHub 通道重装——本项目从未发布到 npm,任何
dsh plugin --profile web add dsh-done-whale形式的命令都必然失败:dsh plugin --profile web add -w github:wally8-8/dsh-done-whale让用户重启 Harness:宿主半是进程内模块,磁盘换了新代码也必须重启才生效, 只刷新页面只能更新浏览器半。
插件能用时优先让它自己更新:设置 → 鲸鱼状态灯 → 「版本与更新」→ 检查更新 / 立即更新;也可以调用本插件注册的模型工具
whale_update(action="check"先看版本,action="update"真执行)。坏到界面都不出来时:本插件遵循"静默降级"——官方服务改名/消失时它整块不启动, 不会拖垮 DSH 界面。此时按第 2 步重装 + 重启即可恢复。
重装是安全的:
dsh plugin --profile web remove dsh-done-whale卸载零残留, 再按第 2 步装回即可。若依赖里写着link:(本地开发安装),重装会把它切换成 GitHub 安装,动手前先问用户。
License
MIT
liangmianya/dsh-synapse
alaliqing/claude-paper
acryldev/acryl
omdsh-dev/dsh-annotation
Anionex/dsh-turn-rewind
Tyan66666/billion-context-dsh
qkycir-123/dsh-run2skill