前言¶
在 DeepSeek Harness（DSH）里长时间对话时，模型调用会按官方公布的峰谷时段计价：高峰（PEAK）与低谷（OFF-PEAK）单价不同。若你希望在高峰先写好内容、等到低谷再自动发出以控制成本，单靠手动盯表并不现实。社区插件 dsh-priceflow（维护者 williamzhangww）面向 DSH 对话界面，展示官方峰谷状态与倒计时，并在高峰提供「低谷排队发送」能力；分类为工作流。本文依据 GitHub 仓库 README 与 package 声明整理，便于安装前核对能力与限制。
这是什么¶
dsh-priceflow 是 DSH 的 npm 插件包（当前资料中版本 0.2.2，许可证 MIT）。它在 DSH 对话输入区增加状态面板和明确的低谷相关操作：显示当前 PEAK 或 OFF-PEAK、距下一次切换的倒计时、官方 USD 定价，以及官方中文页的 CNY 定价（CNY 仅展示，不由 USD 换算，也不驱动调度策略）。在 PEAK 时段可将文本消息排队，待 OFF-PEAK 再投递；OFF-PEAK 下普通发送仍走 DSH 常规范式。在 DSH 凭证可用时，还可展示 DeepSeek 账户余额。
核心功能¶
峰谷阶段与倒计时¶
PriceFlow 依据 DeepSeek 官方定价时间表展示 PEAK / OFF-PEAK 及下次切换剩余时间。阶段由 Host 侧定价引擎给出，Client 不在本地自行推算或翻转阶段。
USD 与 CNY 定价展示¶
USD 来自 DeepSeek 官方定价页；CNY 来自 官方中文定价页。定价数据会经校验后使用；刷新失败时可按 Last Known Good（LKG）策略继续展示并给出陈旧数据警告。内置定价 fixture 仅供参考，不能作为调度依据。某模型价格未知时，展示可能不可用，但峰谷检测仍可继续。
低谷排队发送¶
PEAK 期间可通过 PriceFlow 操作将纯文本加入队列，在 OFF-PEAK 投递。不支持附件。队列数据在 Host 重启后仍可保留，默认队列文件路径为 %DSH_HOME%\priceflow\queue.json（资料原文写法；实际目录取决于本机 DSH_HOME）。
投递采用 durable、至少一次（at-least-once）架构：中断后可能重试；缺少发送 API、API 错误或响应未满足 accepted: true 约定时会被拒绝，消息保留且不会因此被标记为已提交。可重试失败使用有上限的回退与有限次数。submitted 表示 DSH 已接受提交，不表示模型已完成回复；整体不保证 exactly-once。
节假日与调度¶
中国大陆法定节假日不计入工作日 PEAK 调度；周末为 OFF-PEAK，含调休补班周末。若缺少所需节假日日历覆盖，自动调度会失败关闭（fail closed）。
账户余额¶
在 DSH 凭证可用时，可向 DeepSeek 余额接口 请求余额；余额失败不影响定价、阶段检测或队列调度。API Key 在 Host 侧解析使用，PriceFlow 不把原始 Key 发给 Client；余额值保存在内存中，插件说明中未 intentionally 持久化或记录余额，且不增加自有遥测。
环境与兼容¶
安装与运行前请确认：
- Node.js 20 或更高
- DeepSeek Harness 版本范围：
>=0.2.0-rc.1且<0.3.0-0（含 DSH 预发布版）
README 写明已在 DSH 0.2.0-rc.1、0.2.0-rc.2 上测试；范围内其他 0.2.x 未逐一 API 验证，Host/Client API 变更可能需要插件更新。兼容性说明亦强调独立验证版本主要为上述两个 RC。
安装与启用¶
在终端中，将 npm 包安装到目标 DSH profile：
dsh plugin --profile <profile> add dsh-priceflow
将 <profile> 替换为你的 DSH profile 名称。声明的 DSH 版本上限低于 0.3.0，资料中未使用版本豁免。若使用暴露应用内 Plugins 页的 DSH Desktop 构建，也可在该页向 Desktop profile 安装同名包。
DSH 生态采用「一切皆插件」思路；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系，不宜等同于官方应用商店。
典型用法¶
安装并启用后，在 DSH 对话界面即可看到 PriceFlow 状态面板与相关操作，无需额外配置文件（资料未列出其他必填配置项）。
- 查看峰谷与价格：面板显示当前 PEAK/OFF-PEAK、倒计时，以及官方 USD/CNY 单价（以官方页面为准）。
- 高峰先写、低谷再发：在 PEAK 时段编辑文本，使用 PriceFlow 提供的低谷排队动作；进入 OFF-PEAK 后由调度投递。OFF-PEAK 内如需即时对话，仍使用 DSH 普通发送即可。
- 余额（可选）：配置好 DSH 凭证后，界面可展示账户余额；与排队、定价相互独立。
排队内容为本地存储的延迟文本及元数据（含目标 session ID），用于重启后恢复队列。
适用场景与注意¶
适合：长期在 DSH 中开发或对话、希望对照官方峰谷价控本、并能在高峰预先排队文本在低谷发送的用户。
务必注意：
- 插件以当前 DSH 进程权限运行；安装前请阅读 源码 与 MIT 许可证，自行评估信任边界。
- 延迟队列仅文本；勿依赖附件或 exactly-once 投递语义。
- 自动调度依赖已验证的定价策略；节假日日历缺失时调度可能关闭。
- 独立验证的 DSH 版本主要为
0.2.0-rc.1、0.2.0-rc.2；升级 DSH 前请对照engines.dsh范围与 README 限制。
参考链接¶
- 社区目录：williamzhangww/dsh-priceflow
- 源码与中文 README：GitHub — williamzhangww/dsh-priceflow
dsh-priceflow 把官方 DeepSeek 峰谷价、倒计时与低谷文本排队收进 DSH 对话工作流；若你的使用场景符合上述约束，可按 profile 安装后在面板中直接操作。
