壁纸与用量 AppliedYuu/dsh-WallpaperAndCost

dsh-WallpaperAndCost

一个合并版 DSH Web 插件，把壁纸自定义和 DeepSeek 余额与用量组件合到一起。

功能

🎨 壁纸（Wallpaper）

- 内置 8 款精选渐变（暮色 / 深渊 / 晨曦 / 森林 / 星夜 / 暖阳 / 青空 / 石墨）
- 上传自己的图片，保留原始分辨率（不压缩），存入 IndexedDB
- 动态壁纸：上传 MP4/WebM 视频，自动静音循环播放（铺底 元素，object-fit: cover）
- 裁剪编辑器：拖动平移 + 缩放（100%–250%），预览按视口比例实时显示
- 左侧边栏、对话栏、右侧边栏各有独立的绝对不透明度滑块（0–100%）——右侧边栏滑块现在同时控制 dsh-better-sidebar 面板和 DSH 官方右侧边栏（dsh-client-ui-sidebar-right，通过 [data-sidebar-right-panel] 识别）；只要任一右侧边栏出现，滑块就自动显示
- 壁纸选择重启后保留（localStorage + IndexedDB）
- 创意工坊壁纸提取（服务器目录）：输入 Wallpaper Engine 创意工坊条目文件夹的绝对路径（…steamapps\workshop\content\431960\<id>），由内置的 scripts/extract_scene_pkg.py 解析 scene.pkg / .tex（含 LZ4 解压、DXT/RGBA→PNG、内嵌 MP4），提取最佳壁纸供预览与下载。运行 DSH 的机器需要装 Python 3（脚本为纯 Python，Pillow 可选）。
- 桌面端支持「选择文件夹…」：DSH Desktop（Windows）上可直接用系统原生文件夹选择器选取条目文件夹，自动填入绝对路径，避免手输/粘贴路径出错而报「文件夹不存在」。
- 路径自动规整 + 明确报错：路径会先去空白、剥成对引号、展开 ~，并校验是否为绝对路径；读取失败会区分「文件夹不存在」「没有权限读取该文件夹（含 Windows 受控文件夹访问拦截）」「路径不是文件夹」，不再把权限问题笼统报成「文件夹不存在」。

🔍 Wallpaper Engine 创意工坊提取脚本

- 仓库自带独立脚本 scripts/extract_scene_pkg.py，可单独命令行使用：
python scripts/extract_scene_pkg.py --folder <创意工坊条目文件夹> --out <输出目录>
python scripts/extract_scene_pkg.py <scene.pkg> # 或直接解析单个 pkg
python scripts/extract_scene_pkg.py <scene.pkg> --list # 只列出包内文件

- 支持容器：PKGV（scene.pkg）、TEXV0005/TEXI0001/TEXB000x（.tex）。内容类型：内嵌 JPEG/MP4、DXT1/3/5→.dds（有 Pillow 转 .png）、RGBA8888/R8 裸像素→.png、其余文件原样导出。
- 浏览器端另有无需 Python 的「从 Wallpaper 导入」入口（File System Access API 纯 JS 解包），两者互补。

💰 余额与用量（Balance & usage）

- 对话头部有余额按钮：余额、今日消费、本次会话 token 用量与预估费用
- 价格来自 pricing.json（数据，不是代码）：正则匹配模型 id、可选的峰谷时段拆分、每百万 token 的人民币价格——见 模型定价
- 弹层里按模型、按时段（峰/谷）分别列出明细
- 每会话账本持久保存：主机重启不再把 token 计量清零。账本写入 $DSH_HOME/storages/dsh-wallpaper-cost-sessions.json，只有该对话归档/删除后才清除
- 平台消费（DEEPSEEK_PLATFORM_TOKEN）由主机从 DSH 凭据库读取（ctx.credentials.resolve），和 DEEPSEEK_API_KEY、OPENCODE_GO_API_KEY 的方式一样——组件内不抓取 token
- DeepSeek API key 始终不离开主机（只走主机侧路由）

🏷 模型定价（pricing.json）

价格表就是包根目录下的一个 JSON 文件。改它不用动代码，也不用重新构建；文件 mtime 一变，宿主立刻重新加载，下次回放时历史记录会按新价格重新计价。

{
"peakWindows": [{ "startHour": 9, "endHour": 12 }, { "startHour": 14, "endHour": 18 }],
"models": [
{
"match": "deepseek.flash", // regex, matched against the bare model id
"flags": "i",
"label": "deepseek flash 系列", "peak": true, // true = peak + offPeak (6 numbers); false = one flat group (3 numbers)
"price": {
"peak": { "cacheHit": 0.04, "cacheMiss": 2.0, "output": 8.0 },
"offPeak": { "cacheHit": 0.02, "cacheMiss": 1.0, "output": 4.0 }
}
}
]
}

- 正则匹配 id：匹配前会先去掉厂商前缀（deepseek-official/deepseek-v4-flash），所以一条 deepseek.flash 规则就能覆盖 deepseek-flash、deepseek-v4-flash 和 deepseek-v4-flash-vision-exp。规则按文件顺序依次尝试，第一条命中的生效。
- peak: false：不区分峰谷的厂商只配一组三个数字（cacheHit 缓存命中、cacheMiss 缓存未命中、output 输出），峰时窗口对它不生效。
- peak: true：配六个数字，即 price.peak + price.offPeak，按消息所在的北京时间小时选用。
- 单位是每百万 token 的人民币价格。窗口逻辑本身（peakWindows 里的小时、周末一律算谷时）仍留在代码里，因为那是计费语义，不是价格数据。
- 表里没有的模型只计 token（unpriced），不会拿猜测的价格去算；文件缺失或损坏时回退到内置的 flash 价格表，费用不会悄悄变成零。

🟢 OpenCode Go 用量 (rolling / weekly / monthly)

- 会话头部新增一个 Go 按钮（与余额按钮并列于顶端）：默认只显示滚动 / 周 / 月三个用量的百分比
- 点开后用进度条展示每个窗口用量，并显示各自的重置时间，以及上次刷新时间与实际使用的密钥名
- 刷新时机跟随两条 Go 路由的请求：opencodego（自建供应商）与 opencode-go（DSH 官方供应商）任一发出请求（会话事件里的 assistant/message 或 request/header 带 provider），宿主就把用量版本号 +1，前端下次轮询才去上游拉一次；没有请求时前端每 5 秒问的只是本地宿主，宿主直接回缓存（不一定打上游）。点开面板会强刷一次（?force=1）
- 快照缓存 5 分钟保质、4 秒内合并连发的刷新；上游临时取不到时继续显示上次结果并给出提醒，不会把面板清空
- 数据来自 OpenCode Go 官方用量接口 GET https://opencode.ai/zen/go/v1/usage（Bearer 鉴权），由 host 端代理，key 通过 ctx.credentials.resolve 按 OPENCODEGO_API_KEY → OPENCODE_GO_API_KEY 顺序解析（前者 401/403 时自动退回后者），从不入源码/浏览器
- 该接口为社区发现的非官方文档化接口，响应结构可能随 OpenCode 变动；窗口解析做了兼容（usage. 前缀或裸窗口、resetsAt 或 resetsInSeconds）

Install

dsh plugin --profile web add dsh-WallpaperAndCost

or from GitHub:

dsh plugin --profile web add github:<owner>/dsh-WallpaperAndCost

Restart DSH afterwards.

Requirements

- DSH web profile
- DEEPSEEK_API_KEY credential (设置 → 模型) for the balance feature
- Optional DEEPSEEK_PLATFORM_TOKEN (set in 设置 → 模型) for exact platform consumption figures
- OPENCODEGO_API_KEY（自建 opencodego 供应商）或 OPENCODE_GO_API_KEY（官方 opencode-go 供应商）之一，用于 Go 用量面板

Structure

- lib/index.js — 宿主侧：余额/费用 API 路由（/api/deepseek-balance、/api/deepseek-session-cost）+ 壁纸工坊提取路由（/api/wallpaper-workshop/extract、/api/wallpaper-workshop/file）+ OpenCode Go 用量路由（/api/opencode-go-usage，支持 ?force=1；刷新由 opencodego / opencode-go 的会话请求驱动）
- lib/client.js — 浏览器侧：壁纸 + 余额组件 + OpenCode 用量组件 + 壁纸工坊提取界面（无需构建步骤）
- pricing.json — 模型计价表（正则 id、峰谷开关、CNY/百万 tokens），唯一价格数据源，改完热生效
- scripts/extract_scene_pkg.py — 独立的 Wallpaper Engine .pkg/.tex 提取引擎（由宿主路由调用；也可当命令行用）
- cordis.patch.yml — 打包补丁，挂载插件行

运行时文件（$DSH_HOME/storages/）

| 文件 | 用途 |
| deepseek-balance-widget-day.json | 当日计量起点（余额差估算今日消费） |
| dsh-wallpaper-cost-sessions.json | 分会话 token/费用账本：重启不清零，对话被归档/删除后由定时清理移除 |

License

MIT