dsh-lowtide 0.1.2 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,12 +1,20 @@
1
1
  # dsh-lowtide
2
2
 
3
- 忙时投递、人工裁定、闲时低价执行、次日执行报告 —— 面向 DeepSeek 峰谷定价(2026-08-17 生效,2026-08-23 起周末全天低谷)的错峰批量任务流水线插件。
3
+ lowtide 是 DeepSeek Harness (dsh) 的一个插件。它解决的问题其实很自然:
4
4
 
5
- > **注意**:本包为发布候选状态(v0.1.1)——构建与全部单测已验证通过(core 44 + dsh 124),e2e 需真实 dsh web 实例运行。文档描述的是已实现的能力。
5
+ 通常,用户想让 Agent 干活的时候,就得坐在电脑前向它发送指令,等待回复,然后人工审核。但这种工作方式似乎忘了:用户日常有大把的空闲时间,也有避开某些模型峰谷定价的机会。
6
6
 
7
- ## 一句话
7
+ 用户在白天想到什么活儿(适合进行峰谷运行的任务),可以随手扔进队列,审一眼放行;它攒到用户设定的时间(比如晚上七点以后——那会儿 DeepSeek 是低谷价)自动开跑;第二天早上用户可以打开报告,查收晚上的具体成果。
8
8
 
9
- 忙时把任务**投递**到队列,**你亲自裁定**哪些任务值得在低价闲时段自动执行,执行完交回一份**执行报告**(结果 + 花费 + 省了多少钱)。
9
+ “时间就是金钱,效率就是生命”……
10
+
11
+ 几个关键能力:
12
+
13
+ - **四种执行策略**:单次、迭代、采样、复核,从“一遍过”到“跑五份用户来挑”
14
+ - **168 项单元测试 + 10 个端到端 spec**
15
+ - **桌面端和网页端用的是同一份构建产物**,装一次两端通用
16
+ - **闲时自动落在 DeepSeek 低谷价时段**,同样一批任务,成本大约是高峰的一半
17
+ - **各种自定义模块**,满足用户的高灵活性任务的日常需求
10
18
 
11
19
  ## 四种执行方式
12
20
 
@@ -52,6 +60,23 @@
52
60
 
53
61
  **核心语义**:只有 `queued` 状态的任务会被闲时 runner 拾取;`pending-review` 是人与机器之间的海关——机器永远不能自己把任务推过这道关(采样模式的"选哪份"也是人的事)。
54
62
 
63
+ ## 安装(用户)
64
+
65
+ 从 [GitHub Releases](https://github.com/KelaoHu/dsh-lowtide/releases/latest) 下载预构建的 `dsh-lowtide.tgz`(或在 dsh 插件市场中一键安装),无需本地构建。桌面端与网页端使用同一份产物,按需要装入对应 profile:
66
+
67
+ ```powershell
68
+ # 桌面端(DSH Desktop 客户端使用的 profile)
69
+ dsh plugin --profile desktop add dsh-lowtide.tgz
70
+
71
+ # 网页端(浏览器访问的 dsh web)
72
+ dsh plugin --profile web add dsh-lowtide.tgz
73
+ dsh web
74
+ ```
75
+
76
+ - 网页端需要 `@deepseek-ai/dsh` ≥ 0.1.1-rc.2(`npm i -g @deepseek-ai/dsh` 或随桌面客户端附带),与桌面端同代引擎可同时服务两端。
77
+ - 两个 profile 的状态文件相互独立(`DSH_PROFILE` 隔离),桌面端与网页端可并行运行。
78
+ - 状态文件:`$DSH_HOME/lowtide.json`(web 端为 `$DSH_HOME/profiles/web/lowtide.json`)。
79
+
55
80
  ## 安装(开发)
56
81
 
57
82
  ```powershell
@@ -62,8 +87,8 @@ pnpm.cmd --filter dsh-lowtide bundle # 构建 dsh 宿主半 + 客户端 bun
62
87
 
63
88
  # 首次:把插件 link 进 profile(client 半按包名从 profile 目录 resolve)
64
89
  # 桌面端与网页端通用同一份产物,按需要装入对应 profile:
65
- npx.cmd --yes @deepseek-ai/dsh@0.1.0-rc.7 plugin --profile desktop add ./packages/dsh # 桌面端
66
- npx.cmd --yes @deepseek-ai/dsh@0.1.0-rc.7 plugin --profile web add ./packages/dsh # 网页端
90
+ npx.cmd --yes @deepseek-ai/dsh@0.1.0-rc.7 plugin --profile desktop add ./packages/dsh-lowtide # 桌面端
91
+ npx.cmd --yes @deepseek-ai/dsh@0.1.0-rc.7 plugin --profile web add ./packages/dsh-lowtide # 网页端
67
92
 
68
93
  # 启动(本地源码 checkout 或 npx 均可)
69
94
  pnpm.cmd dev # = dsh web --patch ./cordis.dev.yml