dsh-task-plan
DeepSeek Harness Web 插件：谷值自动执行的任务计划表。
白天在「任务计划」页面把想到的任务写进去；到谷值时段（默认北京时间 18:00）插件自动为每个待执行任务新建一个独立 Session 并发执行，并记录 token、金额、耗时与结果。
每晚的逐任务 token/金额日报已拆到独立插件
dsh-task-digest。两个插件可分别安装、启停和排障；本包不再包含日报代码、路由、定时器或页面。
查看方式
- 看单个任务：每个任务是一个普通 Session，标题固定为任务名，出现在左侧会话列表里它工作目录对应的 workspace 分组下。运行中的会话不会被折叠，始终可见；点开就是中间的实时对话（工具调用、输出），会话头部的 token-cost 徽标可看实时用量。
- 看总览：点左侧栏的「任务计划」图标，打开总看板：排队/运行/完成、耗时、token、金额、结果摘要，点「打开会话」直接跳到对应 Session。
- 回看板：在任意会话里再点左侧「任务计划」图标即可切回，页面会重新拉取状态。
功能
- 计划表：标题、说明、类型、工作目录、启用开关；持久化到本地 JSON，重启不丢。
- 谷值自动执行：默认 18:00（北京时间）执行当天全部
pending任务；若配置时刻落在峰时且offPeakOnly=true，自动顺延到下一个谷值起点（12:00 或 18:00）。周末/节假日不调整。 - 并发：每个任务一个 Session，默认并发 2，可配 1–8；单个任务失败/超时不影响其他任务。
- 费用可见：任务完成后按峰/谷单价估算 token 金额，显示在任务表和结果里。
- 零常驻 token：不注册任何模型侧工具、skill 或 prompt 片段；空闲时不增加请求 token。
- 可恢复：Host 重启时把上次
queued/running的任务标记为interrupted并补一条记录，不自动重跑，可在页面手动重试。
峰谷与计费口径
与 dsh-token-cost 和 dsh-task-digest 保持一致：
- 峰时 = 北京时间周一至周五（排除
holidays配置的中国法定节假日）09:00–12:00、14:00–18:00；其余全部为谷值。 - 价格（元 / 百万 token，缓存命中 / 未命中 / 输出）：
deepseek-flash：谷 0.02 / 1 / 4，峰 0.04 / 2 / 8deepseek-v4-pro：谷 0.15 / 4.5 / 13.5，峰 0.3 / 9 / 27
- 每个用量样本按它自己的事件时间判峰谷；未知模型只统计 token，金额标未知。
金额是按公开单价估算，不是账单。官方调价时改
lib/tier.js的RATE_TABLE；日报包有一份相同规则，两包由 parity 测试防止漂移。
从 GitHub / 插件市场安装
本包是标准 DSH 组合包（dsh.bundle.patch + cordis.patch.yml），可以直接从 GitHub 安装：
# 推荐固定 commit，避免后续推送改变实际运行内容
dsh plugin --profile web add github:nwasvsad/dsh-task-plan#<commit>
也可以使用插件市场索引（Discover → Index sources）：
https://nwasvsad.github.io/dsh-plugin-market/index.json
Git 安装会拉取源码并执行 prepare（重新构建 lib/client.js）；如果 pnpm 要求构建授权，按提示把包名加入该 profile 的 pnpm-workspace.yaml 的 allowBuilds。lib/ 已提交，未授权构建时通常仍可直接加载。
安装后默认使用 $DSH_HOME/task-plan，在 profile 的 cordis.patch.yml 里按需覆盖。
本地安装（开发）
前置：已安装 dsh，并有一个可用的 Web profile（下面以 web 为例）。
cd <repo>
# 1) 只读校验
node scripts/verify.mjs
# 2) 安装进 web profile：追加 patch 行 + pnpm add
node scripts/verify.mjs --apply
# 3) 重启 dsh web（会结束当前会话进程，请手动执行）
# 例如重新运行: dsh web
然后刷新 http://127.0.0.1:3080，左侧应出现「任务计划」。
--apply 会向 $DSH_HOME/profiles/web/cordis.patch.yml 追加：
# dsh-task-plan: off-peak task plan
- insert:
- id: task-plan
name: dsh-task-plan
config:
dataDir: '~/.dsh/task-plan'
defaultCwd: '~'
runAt: '18:00'
offPeakOnly: true
concurrency: 2
holidays: []
如果 profile 已有该行，脚本不会覆盖，按需手动改 config。旧版 patch 里的 summaryAt 等键会被忽略，不影响本插件。
配置
| 键 | 默认 | 说明 |
|---|---|---|
enabled |
true |
false 时 Host 不调度、页面显示禁用 |
dataDir |
$DSH_HOME/task-plan |
plan.json 根目录 |
defaultCwd |
process.cwd() |
任务未写 cwd 时的工作目录 |
agentPreset |
部署默认 | 任务 Session 的 preset；默认不传 |
runAt |
'18:00' |
每日自动执行时刻（北京时间） |
offPeakOnly |
true |
峰时顺延到下一个谷值起点 |
autoRunEnabled |
true |
关闭后只允许手动执行 |
holidays |
[] |
全天谷值的 YYYY-MM-DD |
concurrency |
2 |
1–8 |
maxTasksPerRun |
20 |
单次 run 上限，其余留到下一次/手动 |
taskTimeoutMs |
1800000 |
单任务超时（30 分钟） |
startTimeoutMs |
15000 |
等待 Agent 进入 running 的上限 |
pollIntervalMs |
500 |
Agent 状态轮询 |
currency |
'¥' |
金额前缀 |
非法值会回落到默认值并记日志。
数据
<dataDir>/
plan.json # 任务、最近 200 次执行、lastAutoRunDate
plan.json原子写（临时文件 + rename）；损坏时改名plan.json.corrupt-<ts>，以空计划启动并告警。- 所有 HTTP 写操作与调度器共用同一串行锁。
- 旧版同目录下的
reports/不再使用；日报数据由dsh-task-digest管理。
HTTP API
全部走浏览器信任栅栏（connection.requestRejection），body ≤ 64KB。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/task-plan/state |
任务、运行状态、下次执行 |
| POST | /api/task-plan/tasks |
新建任务 |
| PATCH | /api/task-plan/tasks |
修改任务（运行中只允许改标题） |
| DELETE | /api/task-plan/tasks?id= |
删除任务（运行中需先取消） |
| POST | /api/task-plan/run |
{ids?} 立即执行；已有 run 时 409 |
| POST | /api/task-plan/cancel |
{taskId} 取消 |
日报相关路由已移除，见 dsh-task-digest。
运行机制
- 每 30 秒 tick 一次。
- 自动执行条件：有
enabled && pending、当前 ≥ 当天生效runAt、当前谷值、lastAutoRunDate !== 今天、无进行中的 run。 - 每个任务：
sessionController.create→rename为任务标题 →prompt→ 轮询agent.status直到running → idle；超时则sessionController.cancel。 - 完成后读一次完整会话日志：按
(turn, step)去重折叠assistant/message用量，按事件时间判峰谷计价，取最后一条 assistant 文本作为结果；subagents.listDescendants的子代理用量并入父任务。 - 任务 Session 的标题与首条 prompt 带有
[[dsh-task-plan]]标记，日报包据此把它识别为计划任务。
注意与限制
- Host 必须常开：本插件不用 OS 计划任务；停机则当天不执行，pending 留到下一次。
- 权限审批：任务 Session 继承部署的 sandbox/approval 策略；需要人工审批的操作会挂起到超时。建议把自动任务写成无需审批的工作区操作。
- 一个任务 = 一个 Session：已完成任务不会每天自动重复；需要重复的任务请手动重试或每天新增（暂不做 recurrence）。
- 标题即会话名：Host 会 best-effort
rename，失败时退回首条 prompt 自动标题。 - 不注册模型侧工具：因此没有每请求 token 开销。
- 卸载本插件不会删除历史 Session 或
plan.json；日报不受影响。
开发与测试
node scripts/build-client.mjs # 改 src/client.js 后重新生成 lib/client.js
node scripts/verify.mjs # 只读校验
npm test # 单进程单元/集成测试
源码结构：
lib/tier.js 峰谷、价格、日期/时刻
lib/usage.js 会话日志 → 用量/费用/结果/工具统计
lib/plan.js 持久化与串行锁
lib/runner.js Session 执行与完成检测
lib/scheduler.js 自动执行判定、恢复、并发
lib/routes.js HTTP 路由
lib/index.js Host 入口
src/client.js 浏览器任务页面
No comments yet. Be the first to write one.