前言¶
在 DSH 的 web 端，会话状态通常由 logo 或状态点表达。dsh-bloub-mood 把 favicon、侧边栏字标、首页标题换成 bloub 心情形象，让状态变化直接呈现在界面上。
它还提供桌面启动子功能：在 macOS/Windows 上为共用 dsh web 后端的入口创建一个桌面入口。
这是什么¶
dsh-bloub-mood 是 Yuuhann1999 维护的 DSH 插件，许可证为 MIT。
它面向 DSH web profile，主要解决两个问题：
- 把 web 端 logo/状态点换成可自定义的 bloub 心情形象。
- 为
dsh web后端提供 macOS/Windows 桌面启动入口。
核心功能¶
会话状态形象¶
- favicon、侧边栏字标、首页标题随会话状态播放 bloub 引擎原生小剧场动画。
- 支持
8 形状 × 12 颜色 × 16 表情组合。 - 点击界面上的任何黑球，随机切换 16 种表情之一。
- 每个表情带原生 180 帧眨眼动画。
设置页自定义¶
- 形状、颜色、文字可在设置页自定义。
- 设置页支持中英双语，并跟随界面语言实时切换。
桌面启动¶
- macOS/Windows 桌面入口共用
dsh web后端。 - 后端在线时直接复用；离线时自动拉起
dsh web并等待就绪。 - macOS 形态为原生独立 App 壳。
- Windows 形态为 Chromium app 窗口。
- macOS 原生壳依赖
Xcode Command Line Tools；缺失时自动回退浏览器窗口模式。 - Windows 无额外依赖，使用系统
PowerShell建快捷方式。 - mac/win 之外的平台，设置页会提示不支持桌面启动。
- 关闭桌面启动开关等于移除入口文件；重启后尊重持久化状态，不会擅自重建。
- macOS 失败处理：窗口内错误页 + 一键重试，至多 150 秒。
- Windows 失败处理：弹窗提示 + 日志，至多 120 秒。
桌面启动日志位于：
~/.dsh/logs/desktop-entry.log
运行方式¶
- 插件为纯客户端 + webServer 路由。
- 无 API key，零网络请求。
安装与启用¶
1、执行安装命令：
dsh plugin --profile web add dsh-bloub-mood
2、重启 dsh web，刷新页面。
3、在“设置 → 心情图标”中选择造型，并打开桌面启动。
典型用法¶
切换表情¶
点击界面上的任何黑球，随机切换 16 种表情之一。
使用桌面启动¶
桌面启动后端在线时直接复用；离线时自动拉起 dsh web 并等待就绪。
配置位置¶
心情配置存于：
localStorage
桌面启动配置存于：
$DSH_HOME/dsh-bloub-mood/desktop-entry.json
桌面启动日志位于：
~/.dsh/logs/desktop-entry.log
适用场景与注意¶
适合需要在 DSH web 端增加状态反馈、并希望从桌面直接打开后端的用户。
注意：
- 插件以当前 dsh 进程权限运行。
- 安装前建议检查源码、依赖与
MIT许可证。 - macOS 桌面原生壳依赖
Xcode Command Line Tools；缺失时回退浏览器窗口模式。 - Windows 使用系统
PowerShell建快捷方式。 - mac/win 之外的平台不支持桌面启动，设置页会提示。
结尾¶
dsh-bloub-mood 把 DSH web 端的视觉状态与桌面入口合到同一个插件里：状态变化可见，桌面启动可开可关。
GitHub 仓库为：
https://github.com/Yuuhann1999/dsh-bloub-mood
社区目录页 URL 未在已核实资料中给出；如从社区目录使用，可按插件名 dsh-bloub-mood 查找。
