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
