前言¶
DeepSeek Harness (DSH) 是用於構建智能體的開發環境。DeepSeek 的 API 調用費用根據時段分爲峯價和谷價,通常谷價僅爲峯價的一半。在開發過程中,手動等待谷價時段再執行任務會增加心智負擔。
dsh-peak-scheduler 插件通過在輸入框工具行增加“峯谷調度”按鈕,解決這一痛點。它自動查詢當前時段,並允許將任務推遲到谷價時刻自動執行。
核心功能¶
該插件主要解決以下問題:
- 自動查詢:根據官方文檔規則自動判定當前是峯價還是谷價,並聯網獲取節假日日曆。
- 一鍵調度:在輸入框增加調度按鈕,提供“立即執行”或“推遲到谷價”兩個選項。
- 任務管理:推遲的任務不會立即運行,而是創建一個等待任務存儲在官方 schedule 服務中。
- 可視化反饋:側邊欄顯示等待任務的數量與列表,支持隨時手動開始或取消。
安裝與啓用¶
1. 安裝插件¶
使用 DSH 插件命令安裝,需要指定 profile(如 desktop 或 web):
dsh plugin --profile desktop add github:yizhiyizhi0128/dsh-peak-scheduler
2. 配置 Bundle¶
編輯 ~/.dsh/profiles/desktop/package.json,將插件加入 dsh.profile.bundles。同時,必須將官方的 schedule bundle 加入同一數組。
"dsh": {
"profile": {
"bundles": [
"dsh-peak-scheduler",
"@deepseek-ai/dsh-experimental-schedule-bundle" // 必須在此處登記
]
}
}
注意:官方 schedule bundle 不能寫在 dependencies 中,否則會導致 pnpm install 失敗。它只能通過 bundle 名按名插入。
3. 安裝依賴並重啓¶
執行安裝命令使配置生效,隨後必須重啓宿主進程。插件模塊在啓動時才加載,重啓前不會生效。
dsh plugin --profile desktop install
峯谷規則¶
插件的判斷依據取自 DeepSeek 官方 API 文檔。
- 高峯時段:週一至週五(不含中國法定節假日)的 09:00–12:00、14:00–18:00。
- 谷價時段:其餘全部時間,包括週末、中國法定節假日、以及調休補班的週末。
- 價格:谷價是峯價的一半。
文件結構¶
插件包含以下核心文件:
| 文件 | 作用 |
|---|---|
index.js |
宿主側:提供 HTTP 路由,調用 schedule 服務和 session controller |
lib/peak.js |
峯谷判定純邏輯,包含邊界、跨日、跨週末等測試用例 |
lib/holidays.js |
節假日日曆,支持聯網獲取、本地緩存與降級 |
src/client.js |
瀏覽器側:輸入框按鈕、彈窗、側邊欄任務面板 |
cordis.patch.yml |
Bundle 層配置,用於注入插件模塊 |
test/*.mjs |
包含峯谷判定、節假日校驗、宿主響應組裝等測試 |
典型用法¶
- 在 DSH 輸入框輸入提示詞。
- 點擊輸入框工具欄的 「峯谷調度」 按鈕。
- 彈窗顯示當前時段、價格判定及距離下次切換的時間。
- 選擇 「推遲到谷價時段自動執行」。
- 插件會計算到下一個谷價時刻的秒數(至少 2 秒)。
- 調用官方 schedule 服務創建一次性任務。
- 側邊欄“等待任務”角標增加。
- 在谷價時刻到來時,官方 schedule 服務自動將提示詞投遞迴原會話。
- 或者在等待期間,點擊側邊欄的“等待任務”手動“立即開始”。
依賴¶
該插件依賴官方的 @deepseek-ai/dsh-experimental-schedule-bundle 來實現等待任務的持久化存儲與到點投遞。確保該 bundle 已正確安裝在 profiles 中。
結語¶
該插件通過複用 DSH 生態能力,將複雜的峯谷定價邏輯封裝爲簡單的交互按鈕。所有任務數據存儲在官方 schedule 服務中,確保了數據的耐久性和跨會話可用性。