dsh-period-report: DeepSeek Harness 周期性工作报告插件

前言¶

DeepSeek Harness (DSH) 插件生态强调模块化。dsh-period-report 专注于解决会话数据的归档与复盘问题，特别是针对需要周期性产出工作汇报的场景。

插件定位¶

这是一个 DeepSeek Harness 插件，用于生成 AI 撰写的周期性工作报告并安排系统提醒。由用户 zhengjy01 维护，遵循 MIT 协议。它允许从会话语料中提取数据，生成带自然语言摘要（如 “Today at a glance”）的完整统计报告，并支持通过系统通知触发自动化提醒。

核心能力¶

Web UI (v0.2.0): 提供会话报告设置页面，用于配置报告生成器与提醒功能。界面右下角设有提醒提示，可点击查看完整报告。
任意时间范围: 支持自定义 startDate 和 endDate，覆盖单日、多日或整月范围。
AI 叙事摘要: 利用部署的默认模型生成自然语言总结（如概览、亮点、回顾、建议）。若 AI 不可用或被禁用，会回退到模板高亮列表。
完整统计: 包含活跃会话数、新增会话、用户/助手消息数、工具调用次数、Token 使用情况等详细数据。
单会话详情: 展示标题、ID、工作目录、活跃窗口、消息/工具/回合数等。
周期性提醒: 支持自定义间隔（intervalDays）、锚点日期（anchorDate）、触发时间（hour、minute）以及报告范围（previous 或 current）。
系统通知: 在 macOS 上通过 osascript 触发通知中心横幅，在 Linux 上通过 notify-send 触发桌面通知。
双语支持: 报告支持中文 (zh) 或英文 (en)。
持久化配置: 配置文件存储于 ~/.dsh/dsh-period-report，权限为 0600。完整报告保存于 ~/.dsh/dsh-period-report/reports/。

安装¶

使用官方安装命令添加插件。

dsh plugin --profile web add github:zhengjy01/dsh-period-report

使用方法¶

插件提供了两个主要工具命令。

report_generate¶

生成任意时间范围的报告。

参数	类型	描述
`startDate`	string (required)	开始日期，`YYYY-MM-DD`（含）
`endDate`	string (required)	结束日期，`YYYY-MM-DD`（含）
`includeSubagents`	boolean	是否包含子代理会话（默认 false）
`withUsage`	boolean	是否包含 Token 使用统计（默认 true；关闭可提速）
`language`	string	语言 `zh` 或 `en`（默认 `zh`）
`narrate`	boolean	是否启用 AI 叙事摘要（默认 true；关闭则使用快速模板摘要）

report_config¶

查看或更新提醒配置（持久化于 ~/.dsh/dsh-period-report.json）。

参数	类型	描述
`enabled`	boolean	启用/禁用定时提醒
`anchorDate`	string	锚点日期 `YYYY-MM-DD`，周期从这一天开始计算
`intervalDays`	number	每 N 天提醒一次（1-90；7 为每周）
`hour` / `minute`	number	当天的提醒时间
`range`	string	`previous`（报告上一周期，默认）或 `current`
`language`	string	报告语言 `zh` / `en`
`narrate`	boolean	AI 叙事摘要开关

示例：设置从 2026-06-01 开始，每 2 天在 09:00 生成中文报告。

dsh report_config \
  enabled=true \
  anchorDate="2026-06-01" \
  intervalDays=2 \
  hour=9 \
  minute=0 \
  range="previous" \
  language="zh" \
  narrate=true

适用场景与注意¶

适用场景: 适合需要定期总结 AI 交互内容、追踪 Token 消耗、复盘工具调用情况，或需要自动化工作流提醒的开发者。
权限注意: 插件以当前 DSH 进程权限运行，需确保对配置目录 ~/.dsh/dsh-period-report/ 有写入权限。
源码审查: 安装前建议查看 GitHub 仓库源码与许可证（MIT）。

总结¶

dsh-period-report 提供了一套从数据提取、AI 摘要生成到系统通知触发的完整工作流闭环。通过配置 report_generate 和 report_config，可以快速建立符合个人或团队习惯的汇报机制。