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，可以快速建立符合個人或團隊習慣的彙報機制。