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

Tool	Description
flomo_report	Generate a report for [startDate, endDate] (default today) and optionally sync it to flomo (defaults to syncOnGenerate).
flomo_report_config	View / update sync + reminder config (tag, stripHash, webhookUrl, syncOnGenerate, language, narrate, reminder).
flomo_report_test	Send a test memo to verify webhook connectivity and the tag.

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