前言¶
BreezeBlue（Breeze TTS 2）每天給用戶一次免費積分，默認北京時間 08:00 重置、400 分，但要手工在網頁控制台點一下才拿得到。用 DSH（DeepSeek Harness）做 TTS 相關開發時，這個動作既浪費時間，也容易因爲忘了領而白丟額度。下面介紹的插件 mi-tuan/dsh-breeze-claim 就是處理這件事的：它在 DSH 的設置頁裏放一張「Breeze 積分」卡片，可以把領取變成一鍵操作，也可以到點自動領。
生態背景：DSH 的理念是「一切皆插件」，插件能力由社區提供。本文寫的這個插件來自 SkillHub 社區目錄（獨立站點），與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
一句話定位：給 DeepSeek Harness 用的 DSH 插件，自動領 BreezeBlue 的每日免費積分。
- 維護者：mi-tuan
- 來源：https://github.com/mi-tuan/dsh-breeze-claim
- 分類：聯網工具
- 版本：0.1.0（來自 package.json）
- 許可證：MIT（來自 package.json）
- 星標：公開頁面未見星標數據，不寫
- 解決的問題：BreezeBlue 的領取只在網頁端存在，開發者 API 沒有領取端點，手工領取不適合 piping 進開發流程，這個插件把它收進 DSH 的設置頁。
核心功能¶
下面是 README 明確列出的能力。
1、設置頁卡片：在「設置 → Breeze 積分」顯示餘額、今天領沒領、每次領多少、下次重置時間；數據來自 GET /api/credits/summary 返回的 daily_claim_claimed_today、daily_claim_available、daily_claim_next_reset_at。
2、現在領：點一下立即領取。
3、每天自動領：默認到北京時間 08:10 自己領一次，不用管。
4、登錄 Breeze：第一次使用時在彈出的窗口裏登錄；登錄態存在本機，之後都是普通 HTTP 請求，不再需要瀏覽器交互。
5、只讀餘額並領取那 400 免費額度，不會動訂閱、充值和聲音。
它怎麼領的¶
Breeze 的開發者 API 沒有領取端點，只有餘額 / 用量 / 合成。領取動作只存在於網頁端，插件直接向網頁接口發請求，README 裏給出的請求形態如下：
POST https://breezeblue.ai/api/credits/daily-claim
Cookie: breeze_blue_session=…
Origin: https://breezeblue.ai
Referer: https://breezeblue.ai/app/home
→ { "claimed": true, "credits_issued": 400, "balance": …, "daily_claim_claimed_today": true, … }
登錄態的獲取方式是：用 Playwright 驅動本機 Edge 登錄 Breeze，再把 cookies 導出成 cookies.json，獨立 profile 放在 ~/.dsh/breeze-claim/profile/ 下，不碰日常使用的瀏覽器。
安裝與啓用¶
安裝命令來自 README 原文，在 DSH 的 profile 裏執行。
# 1) 裝插件（在 DSH 的 profile 裏）
dsh plugin --profile desktop add github:mi-tuan/dsh-breeze-claim
# npm 上架後也可以：dsh plugin --profile desktop add dsh-breeze-claim
# 2) 重啓一次 DSH（bundle 層要重啓才組裝）
# 3) 打開「設置 → Breeze 積分」→ 點「登錄 Breeze」，在彈出的窗口登錄
從源碼裝：
dsh plugin --profile desktop add file:D:/path/to/dsh-breeze-claim
注意重啓這一步：bundle 層要在重啓時才組裝，裝完不重啓，設置頁看不到這張卡片。
依賴與配置¶
README 給出的依賴分兩條路徑。
| 用途 | 需要 |
|---|---|
| 讀狀態 / 領取 | Python 3.10+（只用標準庫） |
| 登錄 / 刷新登錄態 | Python + pip install playwright（用系統自帶的 Edge，不用另外下瀏覽器） |
插件默認調用 python。如果 python 不在 PATH 上，在設置頁「Breeze 積分 → Python 路徑」裏填完整路徑，例如某個 venv 裏的 python.exe。
插件的數據都放在 ~/.dsh/breeze-claim/：
config.json 插件設置（自動領、時間、python 路徑）
cookies.json 登錄態（敏感，別提交、別外發）
profile/ 獨立瀏覽器配置
claim.log 領取記錄
修改了 Python 路徑或自動領時間後，保存在 config.json 裏。
典型用法¶
第一次使用時，完整走一遍下面的順序。
1、先把 Python 3.10+ 準備好，用 Python 路徑設置項確認插件能找到解釋器。
2、裝 Playwright 依賴，用於第一次登錄和登錄態刷新：
pip install playwright
3、裝插件、重啓 DSH，命令見上一節。
4、打開「設置 → Breeze 積分」，點「登錄 Breeze」，在彈出的窗口裏登錄 Breeze。之後登錄態落在本機，日常使用不會再彈窗口。
5、想立刻確認當天額度是否到賬，點「現在領」，卡片會刷新 daily_claim_claimed_today 等狀態。
6、把「每天自動領」打開即爲長期方案：默認 08:10 觸發，claim.log 裏留下每次領取記錄，出問題時可以看失敗原因。
適用場景與注意¶
適合已經在用 DSH 且都接了 BreezeBlue 做 TTS 的開發者：想把每日免費積分領到這件事自動化，同時希望狀態在 DSH 裏看得見，而不是另開標籤頁點按鈕。
幾點要留意。
1、插件以當前 DSH 進程的權限運行，安裝第三方插件前先讀一遍源碼並確認許可證（本插件爲 MIT）。
2、自動操作網頁可能違反 Breeze 的服務條款，賬號風險自擔，README 寫的最壞情況是警告或封號。
3、網頁前端或接口隨時可能改，插件會失效；失敗時卡片會顯示原因，細節在 claim.log。
4、登錄態會過期，過期後點「登錄 Breeze」重新登錄一次即可。
5、不要提交或外發 cookies.json。
結尾¶
這個插件的價值在於把一個網頁上的手工點擊擠進了開發流程：狀態可讀、領取可點、定時可開，數據落在本機目錄裏。目錄頁在 https://www.skillhub.cn/plugins/mi-tuan/dsh-breeze-claim，源碼和 README 在 https://github.com/mi-tuan/dsh-breeze-claim。
