前言¶
DeepSeek API 按时段计费,原价时段与半价时段之间切换频繁,但官方文档只提供价格表,没有直观的视觉提醒。开发者容易在原价时段继续调用,造成不必要的成本。现有的做法通常是在界面外挂一个显示当前时间的挂件,或者手动查看价格页,这两种方式都存在信息延迟,容易错失半价优惠。
下面介绍 DeepSeek Harness(DSH)的一个插件,它的核心价值是:把计费时段的「价格信息」直接转化为「界面颜色」,让开发者无需额外操作就能看到当前是否处于原价或半价时段。
插件定位¶
wyp809/dsh-peak-tint(峰谷染色 Peak Tint)是一个 DeepSeek Harness 插件,维护者为 wyp809,分类属于模型推理。它不改变 DeepSeek API 的调用逻辑,也不读取账户余额,而是通过改变 DeepSeek Harness 界面的配色来提示当前的计费时段,帮助开发者避免在原价时段误操作。
核心功能¶
时段完全可编辑¶
插件根据你设置的「原价窗口」来判定当前是否为原价时段。设置路径:设置 → 插件 → 峰谷染色。
每个「原价窗口」由一组星期 + 起止时间组成,可以增删。支持跨夜时段,例如 22:00 → 06:00。时间按北京时间解释,与系统时区无关——即使出国也不会算错。命中任一窗口即原价,其余全部时间视为半价。
颜色可选、渐变可调¶
插件提供 6 套内置配色:琥珀 / 玫瑰 / 青碧 / 紫罗兰 / 翠绿 / 石墨。你可以通过四支取色器分别设置原价浅色、原价深色、半价浅色、半价深色。
可调参数包括:
- 渐变角度:0–360°
- 渐变强度:0–100%
- 不透明度:15–100%
- 壁纸兼容四档:自动(检测到玻璃/壁纸插件就降级)、淡色 12%、只留胶囊(完全不染背景)、不适配
- 「背景也用渐变」开关:开启后主对话背景也参与渐变(侧栏渐变始终可用)
三档覆盖范围¶
插件提供三档覆盖范围,通过点击输入框左侧的胶囊切换:
| 档位 | 覆盖的 token | 观感 |
|---|---|---|
| 贴边(默认) | --dsw-specific-sidebar-fill、--dsw-alias-border-l1 |
只有侧栏与分隔线带色 |
| 全屏 | 再加 --dsw-alias-bg-base、--dsw-alias-bg-layer-1 |
整个主背景换氛围色 |
| 关闭 | 不覆盖任何 token | 只留胶囊文字 |
不干扰其他插件,冲突时明确告知¶
染色通过 ctx.theme.overrideTokens() 叠加实现,不写全局样式表、不改 DOM、不 dispose 别人的层。卸载即还原,宿主主题文件完全不动。
其他插件或第三方皮肤后注册的层会盖住本插件,这是设计使然。此时插件会实测当前生效的 token 值,与期望值比对,并给出提示:
- 一致 → 显示「染色生效」
- 不一致 → 显示「被他层覆盖」,胶囊上出现 !,点一下可重新置顶
- token 不存在 → 显示「token 未找到」
- 主题服务缺失 → 显示「主题服务缺失」
计费规则说明¶
官方现行规则(2026-10-23):
- 原价 / 高峰:周一至周五(不含法定节假日)09:00–12:00、14:00–18:00,标准价
- 半价 / 空闲:其余全部时间,含周末与法定节假日全天,为高峰价的 50%
元 / 百万 tokens(空闲 → 高峰):
- deepseek-flash:缓存命中输入 0.02 → 0.04,未命中输入 1 → 2,输出 4 → 8
- deepseek-v4-pro:缓存命中输入 0.15 → 0.30,未命中输入 4.5 → 9,输出 13.5 → 27
注意:2025 年的「00:30–08:30 错峰优惠」已于 2025-09-05 取消,本插件不采用它。插件不识别法定节假日,节假日会被当成普通工作日判断,如需调整可在设置里临时删掉或修改该天的时段。
安装与启用¶
插件支持三种安装方式。
方式一:GitHub 仓库 / Release tarball¶
仓库:https://github.com/wyp809/dsh-peak-tint
# 源码安装
dsh plugin --profile <profile> add https://github.com/wyp809/dsh-peak-tint
# 或用预构建 tarball
dsh plugin --profile <profile> add https://github.com/wyp809/dsh-peak-tint/releases/download/v0.1.0/dsh-peak-tint-0.1.0.tgz
方式二:本地目录 / 本地 tarball¶
dsh plugin --profile <profile> add <本目录的绝对路径>
或用本仓库打包后的 .tgz:
dsh plugin --profile <profile> add ./dsh-peak-tint-0.1.0.tgz
方式三:设置界面¶
在 DeepSeek Harness 的设置 → 插件 中,粘贴本仓库 URL 或 .tgz 绝对路径即可。
安装后需要重启 Host,然后刷新页面。客户端 bundle 在 Host 启动期扫描进入引导图;只刷新页面不够。
配置存储与导出¶
配置存储在浏览器 localStorage 的 dsh-peak-tint/config@1 键中。设置页底部提供 JSON 导出 / 导入功能,方便备份或团队分发。清空该键即恢复默认。
兼容性与自测¶
- 目标:DeepSeek Harness
0.2.x(在0.2.1-rc.2系上开发) - 客户端依赖:
ctx.theme.overrideTokens、ctx.slots;cordisinject: ['slots', 'theme'] - 不依赖
ctx.timer、ctx.locale、React.Fragment:定时器缺失时退回window.setTimeout,渲染全程不用 Fragment - 每个视图都包了一层 error boundary:视图渲染失败只会让本插件的胶囊/设置页消失,不影响输入框与设置面板
- Host 半边不注册任何服务或工具,
index.js只导出空apply
若 Harness 改了 token 名,染色会降级为「token 未找到」而不是崩溃。
自测命令:
node test/smoke.mjs
用桩 React / DOM / cordis 跑真实的 client.js,验证 apply 不抛错、token 值都是合法 CSS 颜色、两个 slot 都注册、视图都能渲染出宿主元素、清理函数不抛。
适用场景与注意¶
适合需要频繁调用 DeepSeek API、对计费敏感的开发者或团队。插件以当前 dsh 进程权限运行,安装前建议查看源码与许可证(MIT)。
适用场景:
- 需要时刻感知当前是否为原价时段
- 希望在半价时段集中调用,降低成本
- 需要团队共享时段配置,统一原价窗口定义
注意:
- 不读账户余额、不算花费金额、不估算节省
- 不识别法定节假日
- 背景渐变在「全屏」+「背景也用渐变」时,若其他插件对 --dsw-alias-bg-base 做 color-mix(),该处样式可能失效(纯色模式无此问题)
- 与第三方主题皮肤同时使用时,皮肤层若更晚注册会盖住本插件;点胶囊可重新置顶
- 壁纸类插件(wallpaper-engine 等):自动检测 --we-glass-alpha / body[data-we-*],命中后窗口 frame 只留 12% 色相、主内容区完全不覆盖;想要零影响就切「只留胶囊」
总结¶
峰谷染色插件通过界面颜色的变化,把 DeepSeek API 的计费规则直接反馈到开发者眼前,无需额外操作即可避免在原价时段浪费成本。时段表、配色、渐变方向、不透明度全部可编辑,且即时生效。插件设计克制,不干扰其他插件,冲突时明确告知,适合需要精细化控制调用节奏的开发者。
- 目录页:https://www.skillhub.cn/plugins/wyp809/dsh-peak-tint
- GitHub:https://github.com/wyp809/dsh-peak-tint