Preface

Daily use of DeepSeek Harness (DSH) produces a large number of session records. Manually organizing these records and syncing them to flomo (Flomo Notes) is inefficient. dsh-flomo-report solves this problem by extracting data from session files and generating an AI summary, then pushing it directly to flomo via webhook.

Plugin Introduction

This is a workflow plugin used to aggregate DSH sessions and generate AI-authored summaries (daily reports, weekly reports, monthly reports, or any date range), then sync them to flomo with one click. The plugin is maintained by zhengjy01.

Core Features

  1. Session Aggregation: Reads ~/.dsh/sessions, extracts covered date ranges, user/assistant messages, tool calls, token usage, etc., and requests an AI summary from the deployed default model (e.g., today’s data and suggestions for tomorrow).
  2. flomo Sync: Pushes reports via webhook. Supports configuring tags (default #write/dsh) and automatically strips # from the body before sending.
  3. Web Settings Panel: In Settings, you can configure the date range, generate/sync switches, tags, # stripping switch, API URL, custom report save directory, daily reminder time, and live preview.
  4. File Output: Generated reports are saved as 日报-YYYY-MM-DD.md in the configured directory (default ~/.dsh/dsh-flomo-report/reports/).
  5. Daily Reminder: When enabled, the report is automatically generated and synced at the specified time, and a system notification is also sent.

Installation

Run the following command in the terminal to install it:

dsh plugin --profile web add github:zhengjy01/dsh-flomo-report

Usage

The plugin provides three main commands:

  • flomo_report: Generates a report for [startDate, endDate] (default is today), and optionally syncs it to flomo (default is syncOnGenerate).
  • flomo_report_config: Views or updates synchronization and reminder settings (including tags, stripHash, webhookUrl, syncOnGenerate, language, narrate, reminder, etc.).
  • flomo_report_test: Sends a test memo to flomo to verify the webhook connection and tag settings.

Configuration and Notes

  • Configuration File: The configuration is persisted in ~/.dsh/dsh-flomo-report, with file permissions set to 0600.
  • Tag Behavior: The plugin only uses existing flomo tags and will not create new tags.
  • Webhook URL: If left empty, it will reuse the ~/.dsh/dsh-flomo.json configuration from the dsh-flomo plugin.
  • Runtime Permissions: The plugin runs with the permissions of the current DSH process. It is recommended to check the source code and license (MIT) before installing.
  • Environment Requirements: Requires Node.js >= 18.

Closing

This plugin provides a standardized workflow for session retrospectives and knowledge accumulation for DSH users. For more plugin details, see the Plugin Catalog or the GitHub Repository.