Flomo Quick Save (F2)

Chrome 扩展：在网页中选中文字、图片或链接后，按 F2 快速保存到 flomo，并支持标签选择/新建。

Why This

• 快：F2 直接弹出保存面板
• 省事：记住 flomo API 地址、本地历史标签
• 兼容微信读书：支持“仅选中 / 高亮后 / 剪贴板回退 / 单条划线识别”

Features

• F2 快速保存到 flomo（内容可编辑）
• 保存文本 / 图片 / 链接
• 标签能力
  • 选择本地历史标签（自动积累）
  • 新建标签（输入后回车/点击添加）
  • 自动沿用上一次保存时使用的标签（可直接修改）
• 右键菜单保存
  • 保存选中文本到 flomo
  • 保存链接到 flomo
  • 保存图片到 flomo
• 微信读书（weread.qq.com）兼容增强
  • 只选中后按 F2
  • 高亮/马克笔后按 F2
  • 自动尝试复制当前选中内容（无需手动 Ctrl/Cmd+C）
  • 单条划线识别（使用当前登录态）

Quick Start

1) 安装扩展（开发者模式）

1. 打开 Chrome：chrome://extensions/
2. 开启“开发者模式”
3. 点击“加载已解压的扩展程序”
4. 选择本项目目录

2) 配置 flomo API

1. 打开扩展详情页 -> “扩展程序选项”（Options）
2. 填入你的 flomo Incoming Webhook 地址
3. 保存设置

示例格式：

https://flomoapp.com/iwh/...

3) 开始使用

1. 在网页中选中文字，或点击图片/链接
2. 按 F2
3. 选择/输入标签
4. 点击“保存到 flomo”

WeRead (微信读书) 支持说明

本扩展对 weread.qq.com 做了额外兼容，目标是尽量覆盖你在阅读时的真实操作习惯。

支持场景

• 只选中文字 -> F2
• 选中文字 -> 点击“马克笔/高亮” -> F2
• 如果页面选区读取失败：自动回退到剪贴板 / 微信读书单条划线接口

识别策略（简化说明）

扩展会综合使用以下候选来源，选择更可靠的文本：

• 当前选区（含 iframe 场景）
• 最近一次选中的正文缓存
• 高亮前缓存（pinned text）
• 剪贴板文本（自动 copy / 手动 copy）
• 微信读书“当前书最近一条划线”（单条接口 fallback，使用当前登录态）

注意

• 不需要额外登录（复用你当前浏览器里的微信读书登录状态）
• 文本内容默认不自动附带当前网页链接
• 若微信读书页面结构变化，最稳妥兜底方式仍是：Ctrl/Cmd+C 后按 F2

flomo 标签说明

flomo 公开 API 主要是写入（Webhook）能力，无法直接读取你账号中的完整标签列表。
因此本扩展采用：

• 本地历史标签缓存（自动积累）
• 手动新建标签

Permissions

• storage：保存 API 地址、标签历史
• contextMenus：右键菜单保存
• clipboardRead：读取剪贴板作为回退方案
• https://flomoapp.com/*：调用 flomo API
• https://weread.qq.com/*：微信读书兼容（单条划线识别 / 当前登录态请求）

Project Structure

• manifest.json：Chrome Extension Manifest (MV3)
• content.js：快捷键、内容识别、页面内弹窗、微信读书兼容逻辑
• background.js：flomo 写入、右键菜单、跨 frame 状态中转
• options.html / options.js / options.css：设置页

Development

• 修改代码后，到 chrome://extensions/ 点击“重新加载”
• 刷新目标页面后再测试

Troubleshooting

微信读书识别不到文本

按顺序检查：

1. 已登录微信读书网页版
2. 扩展已重新加载（尤其在你刚更新代码后）
3. 微信读书页面已刷新
4. 先尝试“仅选中 -> F2”
5. 再尝试“高亮/马克笔 -> F2”
6. 最后尝试 Ctrl/Cmd+C -> F2

flomo 保存失败

检查：

1. flomo API 地址是否正确（https://flomoapp.com/iwh/...）
2. 网络是否正常
3. webhook 是否仍有效

License

MIT (recommended if you plan to open-source publicly)