# dsh-flomo

> [**English**](README.md) | **中文**

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

## 功能

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

## 安装

```sh
# 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 帮你配置：

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

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

```text
把这句话记到 flomo：#ideas
```

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

## 说明

- 发送使用 Node 内置 `fetch`（Node 22+），零第三方依赖。
- 设置面板通过仅限本机的 `/api/dsh-flomo` 路由族与宿主通信。
- 遵循 flomo 内容语法：`#标签`、`**加粗**`、`![](图片URL)`。

## License

MIT