前言¶
在 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 查找。
