DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

zhengjy01 /

zhengjy01/dsh-flomo

Verified

Send notes and memos to flomo (浮墨笔记) from DeepSeek Harness: flomo_send / flomo_config / flomo_status agent tools

★ 0 Stars0 Forks2 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@c471ce6e

dsh-flomo

English | 中文

Send notes, memos, and summaries straight into flomo (浮墨笔记) from DeepSeek Harness. Configure your flomo API URL or API Key once, then any agent can record ideas via the flomo_send tool.

Features

  • Settings panel — configure the API URL / API Key from the web GUI: Settings → Flomo. Save, test, clear, and a quick-send box.
  • flomo_send — write a memo with optional tags (tags become #tags), supporting **bold** and ![](image-url) inline syntax. Tags go through the tags argument; any ASCII # left in the body is escaped to the full-width # before sending, so flomo never parses body text as a tag (pass escapeBodyHashes: false to keep an inline #tag).
  • flomo_config — set apiKey (newer key format) or webhookUrl (the API URL from the flomo settings page, typically https://flomoapp.com/iwh/<token>/); reset: true clears the credential.
  • flomo_status — report whether the plugin is configured and where the credential lives, without echoing the full key.
  • Credential persisted to $DSH_HOME/dsh-flomo.json (default ~/.dsh/dsh-flomo.json) with mode 0600.
  • System-prompt announcement so agents know when to use the plugin.

Install

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

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

Restart dsh web. The plugin needs no build step — lib/index.js is plain ESM.

Configuration

Get your API URL at https://flomoapp.com/mine?source=incoming_webhook. Then either paste it into the plugin's cordis.patch.yml config, or let the agent configure it for you:

帮我配置 flomo,API URL 是 https://flomoapp.com/iwh/xxxx/

The agent calls flomo_config with your webhookUrl (or apiKey) and persists it to $DSH_HOME/dsh-flomo.json (default ~/.dsh/dsh-flomo.json, mode 0600). From then on:

把这句话记到 flomo:#ideas

The flomo API URL is a credential: anyone with it can write memos to your flomo. Keep it private; use flomo_config(reset: true) to clear it if it leaks.

Compatibility

  • DSH: declared under engines.dsh as ^0.1.0-rc.6 || ^0.1.7-alpha.1 || ^0.2.0-alpha.1 || ^0.2.1-alpha.1 || ^0.2.2-alpha.1.
  • Node.js: ^22.19.0 || >=24.0.0.
  • Exactly verified DSH releases (dsh.compatibility.dshReleases): 0.1.7-rc.1, 0.2.1-rc.5, 0.2.2-alpha.3, 0.2.2-rc.1 → compatible. Releases not listed stay unknown and are not claimed.
  • How each entry is verified: npm run verify packs the plugin, installs the tarball into a throwaway profile under an isolated DSH_HOME, boots the host, calls GET /api/dsh-flomo/config, checks the client bundle is in the shell boot list, then uninstalls.

Notes

  • Sending uses Node's built-in fetch (Node 22+), no extra dependencies.
  • The web settings panel talks to the host through the loopback-only /api/dsh-flomo route family.
  • Respects flomo's content syntax: **bold**, ![](https://.../image.png); tags are appended from tags, and body ASCII # is escaped to # so it can never spawn a stray tag.

License

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit c471ce6e0435

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout