dsh-flomo

dsh-flomo

[English](README.md) | 中文

让 DeepSeek Harness 直接往 flomo（浮墨笔记）写笔记。配置一次 flomo API URL / API Key 后，Agent 就能通过 flomo_send 工具把想法、摘要、待办记进 flomo。

功能

• 设置面板 — 在 Web 设置页（设置 → Flomo）里配置 API URL / API Key：保存、测试、清除，还有快捷发送框。
• flomo_send — 发送一条笔记，tags 参数自动转成 #标签；内容支持 加粗、![](图片URL)。标签只走 tags 参数：正文里的半角 # 会在发送前替换成全角 ＃，flomo 只认半角 #，因此正文永远不会被误解析成标签（确需正文内联 #标签 时传 escapeBodyHashes: false）。
• flomo_config — 配置 apiKey（新版 Key）或 webhookUrl（flomo 设置页的 API URL，形如 https://flomoapp.com/iwh/<token>/）；reset: true 清除凭据。
• flomo_status — 查看是否已配置、凭据来源与配置文件路径，不回显完整 Key。
• 凭据持久化到 ~/.dsh/dsh-flomo.json（权限 0600）。
• 系统提示公告：Agent 知道何时该用这个插件。

安装

# GitHub 发布后（仓库带 dsh-plugin topic）
dsh plugin --profile web add github:zhengjy01/dsh-flomo

# 本地开发
dsh plugin --profile web add link:/path/to/dsh-flomo

重启 dsh web 生效。插件无需构建——lib/index.js 是纯 ESM。

配置

在 <https://flomoapp.com/mine?source=incoming_webhook> 获取你的 API URL，然后让 Agent 帮你配置：

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

Agent 会调用 flomo_config 保存 webhookUrl（或 apiKey）到 ~/.dsh/dsh-flomo.json（权限 0600）。之后直接说：

把这句话记到 flomo：#ideas

flomo API URL 等同于凭据：任何人拿到它都能往你的 flomo 写笔记。请保密；泄露后用 flomo_config(reset: true) 清除。

说明

• 发送使用 Node 内置 fetch（Node 22+），零第三方依赖。
• 设置面板通过仅限本机的 /api/dsh-flomo 路由族与宿主通信。
• 遵循 flomo 内容语法：加粗、![](图片URL)；标签由 tags 参数生成，正文里的半角 # 会替换成全角 ＃，不会再生成杂散标签。

License

MIT