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 插件目錄