dsh-flomo-report

dsh-flomo-report

Generate DeepSeek Harness session reports (daily / weekly / monthly / any date
range) with one-click sync to flomo (浮墨笔记).

中文文档

Features

• Session reports — aggregate every session overlapping a date range from
  ~/.dsh/sessions (active sessions, user/assistant messages, tool calls,
  token usage, top tools, per-session details) and ask the deployment's
  default model for an AI-narrated digest (今日数据 / 今日主线 / 今日回顾 /
  明日建议).
• flomo sync — pushes the report straight into flomo through its incoming
  webhook with two user-verified rules:
  • one configurable tag, default #write/dsh (your existing tag — the plugin
    never creates new tags);
  • every # in the report body is automatically stripped before sending.
• Web settings panel — "Flomo Report" section in Settings: date range +
  generate/sync, tag, strip-# toggle, API URL (empty = reuse the dsh-flomo
  plugin's ~/.dsh/dsh-flomo.json webhook), auto-sync on generate, custom
  report-save directory (pick any local folder with the native folder
  dialog, or type a path), daily reminder (time + report range), and a live
  preview of the memo body.
• Report file — every generated report is written as 日报-YYYY-MM-DD.md
  to the configured directory (default ~/.dsh/dsh-flomo-report/reports/).
• Daily reminder — when enabled, every day at the configured time the
  previous-day (or current-day) report is generated, synced to flomo, saved to
  ~/.dsh/dsh-flomo-report/reports/ and announced with a system notification
  (macOS Notification Center / Linux notify-send).

Tools

Config

Persisted at ~/.dsh/dsh-flomo-report.json (mode 0600):

{
  "language": "zh",            // zh | en
  "narrate": true,             // AI narrative digest
  "tag": "write/dsh",          // flomo tag, no '#' prefix
  "stripHash": true,           // strip all '#' from the memo body
  "webhookUrl": "",            // flomo API URL; empty = reuse dsh-flomo config
  "syncOnGenerate": true,      // auto-sync when generating
  "reportDir": "",             // report save dir; empty = ~/.dsh/dsh-flomo-report/reports
  "reminder": {                // daily reminder
    "enabled": false,
    "hour": 22,
    "minute": 0,
    "range": "previous"        // previous | current
  }
}

Install

# local development
dsh plugin --profile web add link:/path/to/dsh-flomo-report

# from GitHub (repo tagged with the `dsh-plugin` topic)
dsh plugin --profile web add github:zhengjy01/dsh-flomo-report

License

MIT