前言¶
DeepSeek Harness (DSH) 是一个基于插件架构的 Web 客户端。在使用 DeepSeek API 进行开发时，区分高峰时段（费率较高）和空闲时段（谷价）有助于控制成本。dsh-client-ui-peak-valley 插件直接在对话框的模型选择按钮左侧显示当前 API 的价格状态，无需手动查询官方定价表。
核心功能¶
该插件专注于在 UI 层提供实时的价格状态反馈。
- 状态可视化：根据北京时间自动判断当前时段。绿色方块代表谷价（空闲时段），橙色方块代表峰价（高峰时段）。
- 自动刷新：每 30 秒自动检查一次时间状态，跨时段切换时无需手动操作。
- 条件显示：仅当当前会话选中的模型 ID 包含
deepseek（不区分大小写）时才显示状态。 - 兼容性：支持官方模型（如
deepseek-official）及中转网关模型（如opencode-go、commandcode等）。同时自动适配浅色和深色主题。
安装与启用¶
该插件为组合包（Bundle），注册行（id: peak-valley）已包含在包内的 cordis.patch.yml 中，无需手动在宿主配置文件中添加插入行。
在目标 profile 目录（例如 ~/.dsh/profiles/desktop/）下执行以下命令进行安装：
dshpm add file:./plugins/dsh-client-ui-peak-valley --profile desktop
安装完成后，必须重启 dsh 进程才能生效。通过 DSH 插件页的「已安装」区域开启或关闭该插件。
使用示例¶
插件根据模型 ID 的子串匹配进行显示判定。
显示状态：
- deepseek-chat
- deepseek/reasoner
- deepseek/deepseek-v4.1-flash
不显示状态：
- ds-v3（模型 ID 中不含 deepseek）
- minimax-m3（非 DeepSeek 模型）
注意事项¶
- 时区依赖：插件基于
Asia/Shanghai时区计算，不依赖浏览器的本地时区设置。 - 渲染位置：UI 注册在
conversation.input.right座位，位于模型选择按钮的左侧，不替换原生 UI。 - 安装方式：安装和管理依赖
dshpm命令。由于是组合包，宿主无需手动维护cordis.patch.yml的插入行。 - 重启要求：安装或卸载后，必须重启 DSH 应用。
结尾¶
dsh-client-ui-peak-valley 通过在开发环境中实时展示 API 价格状态，辅助开发者选择合适的调用时段。其核心价值在于将繁琐的定价查询转化为可视化的 UI 反馈。
