dsh-flomo：DeepSeek Harness 与 Flomo（浮墨笔记）的集成

前言¶

DeepSeek Harness（DSH）的生态以插件为核心。当智能体需要记录状态、整理对话摘要或保存灵感时，直接对接外部笔记服务是常见需求。dsh-flomo 插件提供了从 DSH 到 Flomo（浮墨笔记）的连接，允许智能体通过工具发送便签和备忘录。

安装与启用¶

该插件依赖 Node.js 内置的 fetch（需要 Node 22+），无需额外的构建步骤。安装后需重启 dsh web 才能生效。

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

核心功能¶

插件提供 Web 设置面板和命令行工具两种方式来操作。

Web 设置面板¶

在 DSH 的 Web 界面中进入 Settings → Flomo，可以配置 API URL 或 API Key。
* 操作：支持保存配置、测试连接、清除凭证以及使用快速发送框。
* 通信：Web 设置面板通过回环地址（/api/dsh-flomo）与宿主机通信。

命令行工具¶

智能体可以通过调用以下工具与 Flomo 交互：

• flomo_send
  写入备忘录，支持可选标签。内容格式需符合 Flomo 语法，例如：
  • #tag：添加标签
  • **bold**：加粗文本
  • ![](image-url)：插入图片
• flomo_config
  设置凭证。支持设置 apiKey（新版密钥格式）或 webhookUrl（通常为 https://flomoapp.com/iwh/<token>/）。若传入 reset: true，将清除已存储的凭证。
• flomo_status
  检查插件是否已配置以及凭证存储位置，但不会回显完整的密钥内容。

凭据存储¶

配置的 API Key 和 Webhook URL 会持久化存储在 ~/.dsh/dsh-flomo.json，文件权限为 0600，仅允许所有者读写。

典型用法¶

在对话中，你可以指示智能体完成配置或发送备忘录。

1. 配置 Flomo
   智能体会读取你的 Flomo 设置页面的 Webhook URL，并调用 flomo_config 工具保存。

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

2. 发送备忘录
   配置完成后，智能体可以直接将文本发送到你的 Flomo。

    把这句话记到 flomo：#ideas

3. Web 界面快速发送
   在 DSH 的 Web 界面 Flomo 设置页，有一个快速发送框，可以直接输入内容并测试发送。

技术细节与注意事项¶

• 无依赖：发送请求使用 Node.js 内置的 fetch，不需要安装额外的 HTTP 库。
• 安全性：Flomo 的 API URL 本质上是一个写入凭证。任何人拥有该 URL 都能向你的 Flomo 发送笔记。请妥善保管，若泄露请使用 flomo_config(reset: true) 清除。
• 源码：lib/index.js 是纯 ESM 格式，无需构建即可运行。

总结¶

dsh-flomo 通过 Web GUI 和命令行工具，将 DSH 智能体与 Flomo 连接起来。它不依赖外部构建，利用 Node 22+ 的原生能力发送请求，适合需要在对话流中记录灵感和信息的场景。

• GitHub 仓库
• DSH 插件目录