v1.3.1 — 跨版本兼容 + 发布物料

v1.3.1 — 跨版本兼容 + 发布物料

这个版本主要做两件事：让插件在现在和未来的 DSH 版本上都不容易挂掉，以及补齐发布到 GitHub 需要的全部物料。

跨版本兼容

DSH 的插槽名、客户端服务名属于组合层契约，不是永久不变的公开 API。这个版本不再写死单一名字，改成「候选链」：

• 侧边栏入口：sidebar.footer.action → sidebar.footer → sidebar.actions → sidebar.bottom，第一个真实存在的声明拿到座位
• 面板挂载：shell.overlay → shell.overlays → root.overlay
• 全都改名了：2.5 秒后仍没有 overlay 声明，就把同一套组件挂进 document.body 里的自有容器，保证面板不会「静默消失」
• React API：useSyncExternalStore 缺失时退回 useState + useEffect 订阅垫片（兼容 React 17）
• 样式注入：有宿主 styles 内置就用它，没有就插 <style> 标签
• 宿主服务：webServer 按 webServer → web-server → httpServer → server 的候选链查找；credentials / connection / locale 全部存在性守卫，缺哪个降级哪个

新增两个自检入口，报 issue 时贴上即可：

• 浏览器控制台 window.__dshAliyunCouponCompat：本次实际落座的插槽名、React 版本、styles 可用性
• GET /api/dsh-aliyun-coupon/diag 的 capabilities：本次实际用的 HTTP 服务名、路由是否绑定成功、credentials / connection / locale / browser 各是否存在

功能（沿用 1.2.0）

• 侧边栏实时余额 + 完整明细面板（面值、已用比例、券号、状态、适用范围、有效期、备注）
• 零 Token：本机无头 Chromium 直连阿里云费用控制台，不走大模型
• 1–30 分钟自动刷新滑块 + 独立开关，默认 5 分钟
• 深浅色跟随 DSH 原生主题，颜色全部走 --dsw-alias-*
• 零运行时依赖（WebSocket 与 CDP 都是内置实现）

安装

下载 dsh-aliyun-coupon-1.3.1.tgz，在 DSH 里「安装 bundle」，target 填 tgz 的绝对路径，重启。

已知限制

• 阿里云开启二次验证（短信 / 扫码）的账号无法纯脚本登录，需先用普通浏览器在该配置目录完成一次人工验证
• 自动刷新间隔建议不低于 1 分钟，避免触发阿里云风控