前言¶
在 DeepSeek Harness（DSH）里做开发或跑任务时，如果顺手还要盯阿里云「云工开物」学生专属 300 元代金券还剩多少，常见做法是另开浏览器登录费用控制台，或把账号信息交给某个会消耗 Token 的助手去查。前者打断工作流，后者既费 Token 又涉及凭据怎么传、怎么存的问题。
下面介绍社区插件 dsh-aliyun-coupon（维护者 KERBALMans，分类：联网工具）。它在 DSH 侧边栏提供入口，由本机 Host 侧无头 Chromium 直连阿里云费用与成本控制台抓取余额，不经过大模型，官方 README 表述为零 Token 消耗；界面跟随 DSH 原生主题变量，支持 1–30 分钟自动刷新。当前 GitHub 星标为 2，许可证 MIT，最新发布包版本 1.3.1（以 Releases 为准）。
这是什么¶
dsh-aliyun-coupon 是 DeepSeek Harness 插件 bundle：Client 半边在侧边栏底部挂载「云工开物代金券」入口，点开弹出居中对话框；Host 半边注册 HTTP 路由，启动或复用无头浏览器访问 billing-cost.console.aliyun.com 相关页面，解析表格得到结构化余额 JSON，再供 Web UI 通过 fetch 读取。
插件不依赖 puppeteer / playwright / ws，CDP 与 WebSocket 在 index.js 内自实现，运行时零 npm 依赖。支持 Windows、macOS、Linux。
核心功能¶
零 Token、本机抓取¶
余额数据由你机器上的 Chromium 内核浏览器（Chrome / Edge / Chromium / Brave / Vivaldi 等，可自动探测）登录阿里云控制台并读取页面表格，不调用 LLM。Client 通过 GET /api/dsh-aliyun-coupon/balance 向 Host 要结果。
实时与缓存提示¶
每次打开面板或点击「刷新」都会重新联网读取。界面会先展示上一次读数（标注「上次结果」），新结果返回后替换；失败时保留旧值并标注「缓存值」及失败原因。宿主侧另有 30 秒最短抓取间隔，避免手动刷新与定时刷新连续启动多个无头浏览器。
自动刷新（默认 5 分钟）¶
DSH 保持运行期间，插件可按设定间隔自动重读。面板底部提供 1–30 分钟滑块（每格 1 分钟），默认 5 分钟；旁边开关可临时关闭自动刷新（关闭后滑块变灰但记住位置）。省流量方面 README 说明：可调间隔、浏览器热启动（DSH_ALIYUN_IDLE_MS 默认 720000 ms）、以及上述 30 秒间隔兜底。README 给出热启动条件下单次定时抓取约 93 KiB 的实测参考（Windows + Edge，资源已缓存），并按间隔估算每日流量（例如 5 分钟约 26 MiB/天）。
原生观感与跨版本兼容¶
颜色、圆角、字号使用 DSH 的 --dsw-alias-* 主题变量，浅色 / 深色随 DSH 切换。插槽名、React API、样式注入、宿主服务名均有多路 fallback（例如侧边栏依次尝试 sidebar.footer.action → sidebar.footer → …；overlay 挂不上时在约 2.5 秒后降级挂到 document.body），避免 DSH 小版本改名后面板静默消失。自检：window.__dshAliyunCouponCompat（Client）与 GET /api/dsh-aliyun-coupon/diag（Host）。
凭据与安全边界¶
首次使用在面板填写阿里云账号（手机号 / 邮箱 / 会员名）与登录密码，保存到本机 DSH 凭据库（refs：ALIYUN_CONSOLE_ACCOUNT / ALIYUN_CONSOLE_PASSWORD）。README 明确：不上传外部服务器、无上报端点；无 GUI 场景可用环境变量 ALIYUN_CONSOLE_ACCOUNT / ALIYUN_CONSOLE_PASSWORD 提供凭据。账号开启短信 / 扫码等二次验证时，纯脚本登录可能失败，需先在普通浏览器完成验证或调整账号设置。
环境要求¶
| 项 | 要求 |
|---|---|
| DeepSeek Harness | 桌面版 / Web 版均可；Host 需提供 webServer（或 fallback 链中的等价服务），缺失时插件静默不注册路由 |
| Node.js | ≥ 20 |
| 浏览器 | 任意 Chromium 内核；探测不到时可设 DSH_ALIYUN_BROWSER |
| package.json engines.dsh | >=0.2.0-rc.1 |
README 实测一行记录：DSH 0.2.1-rc.3、插件 1.3.1、插槽 sidebar.footer.action + shell.overlay。
安装与启用¶
官方 README 未提供 dsh plugin add github:… 一类命令，安装方式为在 DSH 中执行「安装 bundle」，target 填 bundle 的绝对路径。
方式一：Release tarball（推荐给分发）
从 GitHub Releases 下载 dsh-aliyun-coupon-1.3.1.tgz，例如：
C:\Users\<you>\Downloads\dsh-aliyun-coupon-1.3.1.tgz
在仓库目录自行打包时：
npm pack
方式二：源码目录（开发）
安装时 target 填克隆或解压后的目录绝对路径；profile 会生成指向源码的 Junction，改 Host 侧 index.js 后需在插件管理里关闭再打开插件一次（Host 不热更新），Client 侧 client.js 随页面刷新生效。
安装成功后，侧边栏底部出现「云工开物代金券」入口。
典型用法¶
- 点击侧边栏「云工开物代金券」。
- 首次在「连接你的阿里云账号」表单填写账号与密码，点「保存并读取」。Host 启动无头浏览器登录并读取，README 称首次约 15–25 秒。
- 之后每次打开面板实时读取，约 5–10 秒；可拖动自动刷新滑块、用开关控制定时刷新。
- 面板底部「账号设置」可更换或清除凭据；「打开阿里云控制台」可人工核对同一页面。
可选环境变量（均有默认值，节选）：
| 变量 | 说明 |
|---|---|
DSH_ALIYUN_BROWSER |
浏览器可执行文件绝对路径 |
DSH_ALIYUN_PROXY / HTTPS_PROXY / HTTP_PROXY |
代理；系统代理仅在端口可连通时使用 |
DSH_HOME |
默认 ~/.dsh；浏览器配置与缓存在 storages/aliyun-coupon/ |
DSH_ALIYUN_IDLE_MS |
无头浏览器空闲关闭时间，默认 720000 |
DSH_ALIYUN_COUPON_REQUIRE_AUTH |
设为 0 可关闭 DSH 连接鉴权（调试用） |
适用场景与注意¶
适合谁：已在 DSH 中长时间工作、持有云工开物学生代金券、希望侧边栏一眼看到余额且不想为「查余额」消耗 Token 的用户。
使用前请知悉：
- 插件以当前 DSH 进程权限运行，会启动本机无头浏览器并保存登录相关数据到
DSH_HOME下目录；安装前应阅读 GitHub 仓库 源码与 MIT 许可证，自行评估凭据与合规风险。 - 社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文仅介绍该社区插件能力，不代表官方背书。
- 二次验证、浏览器未安装、代理残留等场景见 README「常见问题」；报障时可附上
window.__dshAliyunCouponCompat与/api/dsh-aliyun-coupon/diag输出。
结尾¶
经过上面的步骤，你可以在 DSH 内用本机浏览器直连阿里云控制台的方式查看云工开物代金券余额，默认五分钟自动刷新，深浅色与内置界面一致。详情与截图见仓库 README；安装 bundle 时 target 指向 Release 的 dsh-aliyun-coupon-1.3.1.tgz 或本地源码目录即可。
- 目录页：https://www.skillhub.cn/plugins/KERBALMans/dsh-aliyun-coupon
- GitHub：https://github.com/KERBALMans/dsh-aliyun-coupon
