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