dsh-flomo-report

dsh-flomo-report

生成 DeepSeek Harness 会话报告（日报/周报/月报/任意日期区间），并一键同步到 flomo（浮墨笔记）。

[English README](./README.md)

功能特性

• 会话报告 — 汇总 ~/.dsh/sessions 中任意日期区间的全部会话（活跃会话、用户/助手消息、工具调用、Token 用量、常用工具、逐会话明细），并调用当前默认模型生成 AI 叙事摘要（今日数据 / 今日主线 / 今日回顾 / 明日建议）。
• flomo 同步 — 通过 flomo 传入 Webhook 把报告直接写入 flomo，遵守两条已确认的规则：
• 使用一个可配置标签，默认 #write/dsh（你已有的标签，插件绝不新建标签）；
• 发送前自动去除正文中所有 # 号。
• Web 可视化面板 — 设置页新增「Flomo Report」面板：日期区间 + 生成/同步、标签、去 # 开关、API URL（留空自动复用 dsh-flomo 插件的 ~/.dsh/dsh-flomo.json）、生成时自动同步、报告文件自定义保存目录（点「选择文件夹」弹出系统目录选择器，或直接手填路径）、每日定时提醒（时刻 + 报告范围），并实时预览将发送到 flomo 的内容。
• 报告文件 — 每次生成的报告都会以 日报-YYYY-MM-DD.md 写入配置的目录（默认 ~/.dsh/dsh-flomo-report/reports/）。
• 每日定时提醒 — 开启后每天到点自动生成上一日（或当日）报告，同步 flomo、保存到 ~/.dsh/dsh-flomo-report/reports/，并弹出系统通知（macOS 通知中心 / Linux notify-send）。

工具

工具 · 说明

flomo_report · 生成 [startDate, endDate]（默认今天）的会话报告，并可选同步 flomo（默认取 syncOnGenerate 配置）。

flomo_report_config · 查看/修改同步与定时配置（tag、stripHash、webhookUrl、syncOnGenerate、language、narrate、reminder）。

flomo_report_test · 发送一条测试笔记，验证 webhook 连通性与标签配置。

配置

持久化于 ~/.dsh/dsh-flomo-report.json（权限 0600）：

{
  "language": "zh",            // zh | en
  "narrate": true,             // AI 叙事摘要
  "tag": "write/dsh",          // flomo 标签，不带 # 前缀
  "stripHash": true,           // 同步时自动去除正文所有 # 号
  "webhookUrl": "",            // flomo API URL；留空复用 dsh-flomo 配置
  "syncOnGenerate": true,      // 生成报告时自动同步
  "reportDir": "",             // 报告文件保存目录；留空用默认 ~/.dsh/dsh-flomo-report/reports
  "reminder": {                // 每日定时提醒
    "enabled": false,
    "hour": 22,
    "minute": 0,
    "range": "previous"        // previous 上一日 | current 当日
  }
}

安装

# 本地开发（link）
dsh plugin --profile web add link:/path/to/dsh-flomo-report

# 从 GitHub 安装（仓库需打上 dsh-plugin 话题标签）
dsh plugin --profile web add github:zhengjy01/dsh-flomo-report

许可证

MIT