dsh-task-digest

DeepSeek Harness Web 插件：每晚逐任务 token/金额日报。

每天 00:05（北京时间）对前一天 Harness 执行过的任务生成中文 Markdown 日报：每个任务消耗多少 token、多少钱、什么类型、结果如何、后续建议；可在独立页面查看，也在 Session 列表里留下一个「每日总结」会话。

本插件与 dsh-task-plan 互相独立：不 import 计划包，也不读 plan.json。计划任务本身是普通 Session，日报按 Session 日志统计；两包可分别安装/启停。

查看方式

• 左侧栏「每日总结」→ 日报列表 + 正文；「生成昨日总结 / 重新生成」手动触发；「打开总结会话」跳到当天的总结 Session。
• 日报文件落在 dataDir/reports/，页面只读索引，不依赖计划页。
• 右侧栏不承载本插件（该版本右侧栏是每会话停靠面板）。

功能

• 每日 00:05 自动总结前一天；Host 白天启动会补最近一天，停机多天只补最近一天（其余可手动生成）。
• 逐任务：标题、类型（计划任务从 prompt 标记解析，其他用工具/标题启发式）、结果、输入/输出 token、峰/谷金额、耗时、会话 id。
• 子代理归并：子代理 Session 的用量并入父任务，不单独成行。
• 计划任务识别：首条 prompt 以 [[dsh-task-plan]] 开头时标为计划任务，并解析 （类型：开发/调研/…）；不依赖计划包。
• 跨午夜：会话首条事件在当日 → 统计整段会话；否则只统计当日时间窗。避免计划任务被午夜切半。
• 运行中：到点前若有 root Session 仍在 running，最多等 summaryWaitMs（默认 10 分钟），之后按 running/部分数据出报。
• LLM 失败兜底：模型超时/空输出时生成确定性模板日报，数字仍来自完整日志。
• 零常驻 token：不注册模型侧工具；只有总结 Session 本身消耗 token，金额单独显示为「本次总结消耗」。

峰谷与计费口径

与 dsh-token-cost 和 dsh-task-plan 保持一致：

• 峰时 = 北京时间周一至周五（排除 holidays 配置的中国法定节假日）09:00–12:00、14:00–18:00；其余全部为谷值。
• 价格（元 / 百万 token，缓存命中 / 未命中 / 输出）：
  • deepseek-flash：谷 0.02 / 1 / 4，峰 0.04 / 2 / 8
  • deepseek-v4-pro：谷 0.15 / 4.5 / 13.5，峰 0.3 / 9 / 27
• 每个用量样本按它自己的事件时间判峰谷；未知模型只统计 token，金额标未知。

金额是按公开单价估算，不是账单。两包的 lib/tier.js 是复制关系，test/parity.test.js 会对比规则与结果；调价时两份一起改。

从 GitHub / 插件市场安装

本包是标准 DSH 组合包（dsh.bundle.patch + cordis.patch.yml），可以直接从 GitHub 安装：

dsh plugin --profile web add github:nwasvsad/dsh-task-digest#<commit>

插件市场索引：

https://nwasvsad.github.io/dsh-plugin-market/index.json

Git 安装会拉取源码并执行 prepare（重新构建 lib/client.js）；如果 pnpm 要求构建授权，按提示把包名加入该 profile 的 pnpm-workspace.yaml 的 allowBuilds。lib/ 已提交，未授权构建时通常仍可直接加载。

安装后默认使用 $DSH_HOME/task-digest；计划任务的识别不依赖 dsh-task-plan，两个包可以分别安装。

本地安装（开发）

cd <repo>

node scripts/verify.mjs           # 只读校验
node scripts/verify.mjs --apply   # 追加 patch 行 + pnpm add

# 重启你的 dsh web（例如重新运行: dsh web）

刷新 http://127.0.0.1:3080，左侧应出现「每日总结」。

--apply 追加：

# dsh-task-digest: nightly per-task digest
- insert:
    - id: task-digest
      name: dsh-task-digest
      config:
        dataDir: '~/.dsh/task-digest'
        defaultCwd: '~'
        summaryAt: '00:05'
        summaryWaitMs: 600000
        holidays: []
        currency: '¥'

从旧版合并插件迁移日报

旧版 dsh-task-plan 把日报存在 .../task-plan/reports/。安装本包后执行一次（源目录不会被修改）：

node scripts/migrate-from-plan.mjs `
  --from ~/.dsh/task-plan `
  --to   ~/.dsh/task-digest

• 复制 reports/*.json|*.md，合并索引，lastSummaryDate 取最新日期（避免首启重跑 10-22）。
• 幂等；重复执行只补缺失文件。--force 可覆盖目标文件。
• 迁移后旧 reports/ 保留为备份；计划包不再使用它。

配置

键	默认	说明
enabled	true	总开关
dataDir	$DSH_HOME/task-digest	reports/ 根目录
defaultCwd	process.cwd()	总结 Session 的工作目录
agentPreset	部署默认	总结 Session 的 preset
summaryEnabled	true	每日总结开关
summaryAt	'00:05'	总结前一天的时刻（北京时间）
summaryWaitMs	600000	等待运行中 root Session 的上限；0 表示不等
summaryTimeoutMs	600000	总结 Session 超时
summaryMaxSessions	40	日报最多任务数
summaryResultChars	400	每任务结果进 prompt 的截断
skipEmptyDays	true	无会话不生成日报，只推进日期
reportKeepDays	180	预留的报告保留天数
holidays	[]	全天谷值的 YYYY-MM-DD
currency	'¥'	金额前缀
startTimeoutMs	15000	总结 Agent 进入 running 的上限
pollIntervalMs	500	状态轮询

holidays / currency 应与计划包保持一致，否则两边的金额口径会不同；代码规则本身由 parity 测试保证。

数据

<dataDir>/
  reports/
    index.json          # { version, lastSummaryDate, items[] }
    2026-10-22.json     # 事实 + Markdown + summaryUsage/summaryCost
    2026-10-22.md       # Markdown 原文

• 索引与报告均原子写；索引缺失/损坏时从 reports/*.json 重建，lastSummaryDate 取最新日期。
• lastSummaryDate 只前进不后退；空日跳过也会推进，避免反复重试。
• 历史总结 Session 通过索引里的 summarySessionId 与 prompt 标记排除，不会进入下一次日报。

HTTP API

全部走 connection.requestRejection，body ≤ 64KB。

方法	路径	说明
GET	/api/task-digest/state	下次总结、运行状态、日报列表
POST	/api/task-digest/summary	{date?}，默认昨天；运行中 409
GET	/api/task-digest/reports	日报列表
GET	/api/task-digest/report?date=	单份日报

运行机制

1. 每 30 秒 tick；当前 ≥ 当天 summaryAt 且 lastSummaryDate !== 昨天 时触发。
2. sessionController.list 取 root Session；按 updatedAt 过滤当日候选；排除子代理与历史总结会话。
3. 逐个读日志：
   • createdAt 在当日 → 折叠整段会话；否则只折叠当日时间窗。
   • 计划任务识别 [[dsh-task-plan]]，类型解析 （类型：X）；否则用标题/工具启发式。
   • 最后一条 non-empty assistant 文本作为结果；子代理用量归并。
4. 构建事实 JSON → 总结 Session 写中文 Markdown；失败用 fallback 模板。
5. 写报告文件 + 索引 + lastSummaryDate；页面轮询 state。

注意与限制

• Host 必须常开；停机则当天不生成，启动后补最近一天。
• 计划任务的边界：若任务在创建 Session 前就失败（无会话），日报看不到；计划页仍会显示失败。
• 跨午夜：当日创建的会话按整段统计，可能包含少量次日凌晨用量；报告会标注 whole-session。
• 审批：总结 Session 继承部署的 sandbox/approval 策略；Prompt 要求不调用工具，但不会强制。
• 配置重复：两包的 tier.js/usage.js 是复制关系；修改价格/峰谷规则时两份一起改，parity 测试会失败提醒。
• 不新增模型侧工具；日报质量取决于当天日志与总结模型。

开发与测试

node scripts/build-client.mjs
node scripts/verify.mjs
npm test

源码结构：

lib/tier.js       峰谷、价格、日期/时刻（与计划包同一份规则）
lib/usage.js      会话日志 → 用量/费用/结果/工具统计
lib/session.js    create → rename → prompt → 等 idle → 读日志
lib/store.js      reports/index.json、lastSummaryDate、原子写
lib/report.js     仅扫描 Session 的事实/提示词/fallback
lib/scheduler.js  00:05 判定、等待 running、去重
lib/routes.js     HTTP 路由
lib/index.js      Host 入口
src/client.js     浏览器日报页
scripts/migrate-from-plan.mjs  旧日报迁移