Preface

The DeepSeek Harness (DSH) ecosystem is built around plugins. When an agent needs to record state, organize conversation summaries, or capture ideas, connecting directly to an external note-taking service is a common requirement. The dsh-flomo plugin provides a connection from DSH to Flomo, allowing agents to send notes and memos through tools.

Installation and Enablement

This plugin relies on Node.js’s built-in fetch (requires Node 22+) and does not require additional build steps. After installation, restart dsh web for changes to take effect.

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

Core Features

The plugin can be operated through a Web settings panel and command-line tools.

Web Settings Panel

In the DSH Web interface, go to Settings → Flomo to configure the API URL or API Key.
* Actions: Supports saving configuration, testing connection, clearing credentials, and using the quick send box.
* Communication: The Web settings panel communicates with the host via the loopback address (/api/dsh-flomo).

Command-Line Tools

Agents can interact with Flomo by invoking the following tools:

  • flomo_send
    Writes a memo and supports optional tags. Content format must follow Flomo syntax, for example:
    • #tag: add a tag
    • **bold**: bold text
    • ![](image-url): insert an image
  • flomo_config
    Sets credentials. Supports setting apiKey (new key format) or webhookUrl (typically https://flomoapp.com/iwh/<token>/). If reset: true is passed, it clears the stored credentials.
  • flomo_status
    Checks whether the plugin is configured and where credentials are stored, but does not echo the full key content.

Credential Storage

Configured API Key and Webhook URL are persisted in ~/.dsh/dsh-flomo.json, with file permissions 0600, readable and writable by the owner only.

Typical Usage

In a conversation, you can instruct the agent to configure the plugin or send memos.

  1. Configure Flomo
    The agent reads the Webhook URL from your Flomo settings page and calls flomo_config to save it.
    帮我配置 flomo，API URL 是 https://flomoapp.com/iwh/xxxx/
  1. Send a Memo
    After configuration, the agent can send text directly to your Flomo.
    把这句话记到 flomo：#ideas
  1. Quick Send in Web Interface
    On the Flomo settings page in the DSH Web interface, there is a quick send box where you can enter content and test sending directly.

Technical Details and Notes

  • No Dependencies: Requests use Node.js’s built-in fetch and do not require an additional HTTP library.
  • Security: A Flomo API URL is essentially a write credential. Anyone with this URL can send notes to your Flomo. Keep it safe, and if leaked, use flomo_config(reset: true) to clear it.
  • Source Code: lib/index.js is pure ESM format and can run without building.

Summary

dsh-flomo connects DSH agents with Flomo through a Web GUI and command-line tools. It relies on Node 22+ native capabilities to send requests without external builds, making it suitable for scenarios that require capturing ideas and information within conversation flows.