zhengjy01/dsh-flomo

English | 中文

让 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_HOME/dsh-flomo.json（默认 ~/.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_HOME/dsh-flomo.json（默认 ~/.dsh/dsh-flomo.json，权限 0600）。之后直接说：

把这句话记到 flomo：#ideas

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

兼容性

• DSH：在 engines.dsh 中声明为 ^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。
• 逐版本实测的 DSH 版本（dsh.compatibility.dshReleases）：0.1.7-rc.1、0.2.1-rc.5、0.2.2-alpha.3、0.2.2-rc.1 → compatible。未列出的版本保持 unknown，不做声明。
• 验证方式：npm run verify 打包插件 → 在隔离的 DSH_HOME 里用一次性 profile 安装 tarball → 启动宿主 → 调 GET /api/dsh-flomo/config → 确认客户端 bundle 进了 shell 启动清单 → 卸载。

说明

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

License

MIT