Skip to content

dsh-flomo-report

Verified

dsh-flomo-report · v0.1.1 · MIT · Web UI

Daily session report generator for DeepSeek Harness with one-click flomo sync: generates AI-narrated daily/weekly/monthly digests over any date range from the session corpus and pushes them straight into flomo (浮墨笔记) using a configurable tag (default #wri

Install

dsh plugin add dsh-flomo-report

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

dsh-flomo-report

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

English README

功能特性

  • 会话报告 — 汇总 ~/.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