前言¶
使用 DeepSeek Harness（DSH）做智能体开发时，API 调用成本会随「高峰全价 / 空闲半价」时段变化。高峰与空闲的切换规则固定在北京时间，但界面本身不会常驻提示当前处于哪一档、下一次切换还有多久。开发者往往要对照文档或自行记表，容易在高峰段误开大批量任务。
下面介绍社区插件 dsh-plugin-peak-pricing（维护者 c-ling）：在 DSH Web 与 Desktop 侧边栏设置按钮附近展示峰谷时段徽章，纯 UI、无状态、不发网络请求，时段计算完全依赖本机时钟。
这是什么¶
dsh-plugin-peak-pricing 是 DSH 双面插件，分类为「趣味换装」，在 SkillHub 插件目录 可检索。当前包版本 2.0.1，许可证 MIT，目标运行时 DeepSeek Harness 0.2.1+（Web 与 Desktop）。
它不接入 host 路由、不持久化配置；所有展示逻辑在客户端完成，随 DSH 界面语言（Settings → General → Language）在中英文案之间切换。
核心功能¶
时段规则¶
规则按北京时间（UTC+8，无夏令时）：
- 高峰（全价）：09:00–12:00、14:00–18:00
- 空闲（半价）：其余时段
- 自 2026-08-24 起：周六、周日全天视为空闲；此前周末仍按上述工作日时段划分
插件每 30 秒刷新一次；跨过时段边界会自动切换展示。
展开与收起两种形态¶
展开状态：在侧边栏设置按钮下方贴底显示单行卡片，例如
● 空闲时段 · 半价 · 2小时12分后进入高峰。黄点表示高峰全价，绿点表示空闲半价；悬停可看北京时间详情。
收起状态：
- Web / Linux：在 56px 轨道内居中显示彩色圆点（36px 圆形 hover，与设置按钮一致），悬停弹出与 DSH 官方 Tooltip 同配色、字号的浮窗。
- Desktop（macOS / Windows）：侧边栏收起后整列宽度为 0 时，改用 28px 浮动圆点，固定在视口左下角（
left:12px; bottom:12px），仍可悬停查看完整文案。
与 DSH 版本的适配¶
v2.0.0 起采用 dsh.bundle + cordis.patch.yml 的安装形态，不再依赖 0.1.x 的 CSS Module hash；通过稳定类名后缀（footArea / collapsed / settingsArea）和 data-slot="sidebar.footer.action" 定位脚部区域，面向 0.2.x 小版本更稳。0.1.x 已非兼容目标。
安装与启用¶
安装前请自行查看 GitHub 仓库 源码与许可证。插件以当前 DSH 进程权限运行，安装即信任该包。
Bundle 模式（0.2.x 推荐）¶
Web 端执行（dsh plugin 会把包加入 profile 的 dsh.profile.bundles，由 bundle patch 插入 loader）：
dsh plugin --profile web add "github:c-ling/dsh-plugin-peak-pricing#v2.0.1"
# 或
npx @deepseek-ai/dsh plugin --profile web add "github:c-ling/dsh-plugin-peak-pricing#v2.0.1"
Desktop 需使用 Desktop 自带 CLI 或应用内 Plugins 页面（npx @deepseek-ai/dsh 会拒绝 --profile desktop）：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add "github:c-ling/dsh-plugin-peak-pricing#v2.0.1"
安装后须重启宿主：Web 重启 dsh web；Desktop 退出并重新打开 App。client-modules 按进程缓存包裁决，不重启新 bundle 不会生效。
手动模式（plain dependency）¶
若不用 bundle，可将包作为普通依赖安装并自行在 cordis.patch.yml 增加 insert 行；不要同时把包加入 dsh.profile.bundles，否则会重复激活。Desktop 端不推荐手改 profile，优先用 CLI 或 Plugins 页面。
典型用法与验证¶
经过上面的安装与重启，可按 README 建议在页面上自检：
- 展开侧边栏：设置按钮下方应出现时段卡片；切换 Settings → General → Language，文案应原地切换中英文。
- Web 收起侧边栏：56px 轨道内、设置按钮下方为彩色圆点；悬停显示浮窗。
- Desktop 收起侧边栏：圆点固定在窗口左下角，悬停仍可查看详情。
仓库内可用以下命令做本地校验（预期 11 项测试全绿）：
cd dsh-plugin-peak-pricing
node --check lib/index.js lib/client.js
node --test
python3 -m json.tool package.json
注意：本插件没有 /api/... 路由。不要用旧的匿名 GET /plugins/dsh-plugin-peak-pricing/client.js 判断是否加载成功；0.2.1 客户端 bundle 通过认证后的启动图加载。
更新与卸载¶
更新时对新版本标签重新执行安装命令即可，bundle 模式一般无需改 cordis.patch.yml：
dsh plugin --profile web add "github:c-ling/dsh-plugin-peak-pricing#v2.0.1"
Web 卸载：
dsh plugin --profile web remove dsh-plugin-peak-pricing
Desktop 可在 Plugins 页面移除，或使用 Desktop CLI 的 plugin --profile desktop remove。插件无持久化数据，卸载后布局可完全还原。
适用场景与注意¶
适合长期在 DSH Web 或 Desktop 里编排智能体、希望一眼看到当前是否处于半价时段、以及距离下一次高峰/空闲切换还有多久的开发者。它不替代官方计费页面，也不联网校对服务器时间；系统时钟被手动修改时，会在下一次 30 秒刷新时反映到展示上。
已知限制包括：若未来 DSH 改掉脚部 DOM 约定，徽章可能仍挂在 footer 操作条但位置偏离「设置按钮下方」；桌面左下角圆点偏移为固定值，若窗口左下角新增控件可能需要插件后续更新。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。需要源码、Issue 或英文说明时，可访问 GitHub：c-ling/dsh-plugin-peak-pricing，目录页：SkillHub - dsh-plugin-peak-pricing。
