Yuuhann1999/dsh-bloub-mood 预览 preview

Yuuhann1999/dsh-bloub-mood

动态心情图标 · DeepSeek Harness 插件 — bloub表情随会话状态切换favicon与logo,形状/颜色/文字可配置(8种形状×12种颜色,动态SVG,MIT协议)

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that adds animated mood indicators and a native desktop entry feature. It adapts the bloub animated avatar engine to change the favicon, sidebar wordmark, and homepage title dynamically based on DSH’s current session state. Users can choose from 16 different moods, and all visual elements including shapes, colors, and text can be fully customized through DSH’s settings page. To install the plugin, users just need to run dsh plugin --profile web add dsh-bloub-mood in their terminal, and they can also install directly from the GitHub source if they prefer.

Once enabled, the plugin automatically triggers different animations based on the current session state. When the agent is running a task, it plays a comet dash animation; when it is waiting for user input, it shows a notification bounce animation; after the task is completed, it plays a confetti celebration animation; if DSH is idle for over two minutes, it shows a sleeping animation. Users can click the mood icon anywhere on the interface to randomly switch to one of 16 available moods, and it will automatically revert to the session state animation the next time the session status changes.

This plugin is released under the open source MIT license, so it is free to use and modify. All configurations are persisted, with mood settings stored in the browser’s localStorage and desktop entry settings stored in the $DSH_HOME/dsh-bloub-mood/desktop-entry.json file, so your settings remain after refreshing or restarting DSH. The desktop entry feature currently supports macOS and Windows only, with different native implementations for each platform. On macOS, it requires Xcode Command Line Tools to build the native app shell, and it automatically falls back to browser mode if the tools are missing.

这是专为DeepSeek Harness(DSH)打造的原生插件,为DSH添加了动态心情图标和独立桌面入口功能。它接入bloub动画头像引擎,让favicon、侧边栏字标、首页标题随DSH会话状态变化,16种心情可点击切换,形状、颜色、文字都能在设置页完全自定义。

开启插件后,它会自动根据当前会话状态播放对应动画:执行中显示彗星冲刺动画,等待用户输入时显示通知弹跳,完成后显示爆散庆祝,空闲超过两分钟还会显示沉睡动画。用户点击界面上的心情图标就能随机切换16种心情之一,下次会话状态变化会自动回归对应状态动画。

插件基于MIT许可证开源,可通过DSH官方命令一键安装,配置会分别保存在浏览器localStorage和DSH_HOME目录下,配置持久化,刷新重启后不会丢失。桌面入口功能支持macOS和Windows,非官方平台暂不支持,macOS需要Xcode命令行工具,缺失自动回退到浏览器模式。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 17 stars - an early-stage project星标 17,属于早期项目
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 dsh-bloub-mood

把 Yuuhann1999/dsh-bloub-mood 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-bloub-mood

动态心情图标 + 桌面入口 — DeepSeek Harness (DSH) 的会话感知动画形象:favicon、侧边栏字标、首页标题随会话状态播放 bloub 引擎原生小剧场动画,16 种表情可点击切换,形状 / 颜色 / 文字全部在设置页自定义;并内置桌面启动子功能,把共用同一后端的 DSH 变成 Dock 里真正的独立 App。

灵感来自 bloub(bloub, avatar SVG animé · GitHub)。本插件把它的表情与动画引擎接到 DSH 的会话状态机上——扫一眼标签页,就知道 agent 在干活、在等你、还是做完了。

效果预览

设置页:表情(16 种)/ 形状(8 种)/ 颜色(12 种)/ 文字(4 处)四层自定义,顶部实时大预览与 iOS 风格启停开关,中英双语跟随界面语言:

设置页 · 表情与形状颜色

桌面启动(设置页底部):一行开关 + 三个 bloub 形象图标点选,所见即桌面所得:

设置页 · 桌面启动

Dock 里的独立 App —— 不是浏览器窗口,是真正属于自己的图标、名字与进程:

Dock · DSH Desktop

DSH Desktop 主界面 —— 系统原生窗口,无浏览器地址栏,共用当前 dsh web 后端(会话、插件、工作区全部同步):

DSH Desktop 主界面

桌面启动 / Desktop Launch(v2.4.0)

给共用同一后端的 dsh web 一个桌面入口,双击即用:后端在线直接复用;离线自动拉起 dsh web 并等待就绪。壳与 DSH 版本完全解耦——升级 harness 后无需重建入口,打开即最新版。

macOS 与 Windows 的形态区别(功能一致,窗口形态不同):

macOS Windows
入口形态 ~/Applications/DSH Desktop.app(启动台 / Dock 可见) 开始菜单项 + 桌面快捷方式
窗口类型 原生独立 App:系统 WebKit 编译壳(~90KB),Dock 显示自己的图标与名字、独立进程、独立 Cmd+Tab 身份,外链自动转默认浏览器 Chromium(Edge/Chrome)--app 无栏窗口:无地址栏无标签页,但进程归属浏览器
图标 .icns(三个 bloub 形象之一,设置页点选即换) .ico(插件现场生成,快捷方式使用)
依赖 Xcode Command Line Tools(编译原生壳;缺失时自动回退浏览器窗口模式,功能不丢) 无(PowerShell 系统自带,用于建快捷方式)
冷启动后端 登录 shell 拉起(继承 nvm 等 PATH;记录的 dsh 绝对路径失效时自动回退 PATH 里的 dsh) start /B 后台拉起
失败处理 窗口内错误页 + 一键重试(至多 150 秒) 弹窗提示 + 日志(至多 120 秒)

三个图标形象(设置页实时预览实际生成图):

id 形象 出典
classic 经典黑球(默认) cercle · neutre
joy 大笑鹅卵石 galet · hilare
excite 兴奋胶囊 capsule · excite
  • 持久化:$DSH_HOME/dsh-bloub-mood/desktop-entry.json,优先级 持久化 > config.desktopEntry > 默认
  • 关闭开关 = 移除入口文件;重启后尊重持久化状态,不会擅自重建
  • 日志:~/.dsh/logs/desktop-entry.log
  • Host 路由:GET /desktop-entry/api/state · POST .../enabled · POST .../icon · GET /desktop-entry/icon/:id.png(mac/win 之外的平台设置页提示不支持)

小剧场(v2.0 引擎原生动画)

自动状态播放从 bloub 引擎逐帧渲染的 GIF 小剧场(透明背景,官网导出管线直出):

状态 触发 小剧场
执行中 会话 running 思考转圈 → 彗星冲刺 → 思考
等你输入 pendingInteraction 瞪眼 → 警觉 → 通知弹跳
完成待读 completed 惊叹 → 通知 → 爆散庆祝
空闲 以上都不是 呼吸 → 眨眼 → 六边形变身
困倦 空闲超 2 分钟 沉睡

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev ramify-dsh 下一个 Next bifrost →