mcpField
F
flomo-web-crud

flomo-web-crud

github.com/undertone0809生产力863 次安装18 周前更新
代码仓库

关于 flomo-web-crud

flomo-web-crud 是通过 Chrome MCP 操作 flomo 网页备忘录的技能，适合需要管理真实账户内容的用户。它提供搜索、增删改流程，并在写入前确认目标、删除前二次确认。

主要功能

  1. 01通过 Chrome MCP 操作 flomo 网页
  2. 02搜索并扫描备忘录
  3. 03创建、编辑和删除备忘录
  4. 04写入前锁定 memo_id
  5. 05删除前要求二次确认

适用场景

  1. 01查找账户中的实时备忘录
  2. 02从近期内容归纳状态与主题
  3. 03向 flomo 账户添加备忘录
  4. 04确认目标后修改或删除备忘录

MCP 相关

使用 Chrome MCP 工具在已登录的 flomo 网页中读取和操作备忘录；要求 Chrome MCP 可用。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/undertone0809/flomo-skills --skill flomo-web-crud

安装后在 Claude Code 中输入/flomo-web-crud确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
safety.md
test-checklist.md
ui-locators.md
workflows.md

详细介绍

Flomo 网页版 CRUD

概述

使用 Chrome MCP 工具操作 https://v.flomoapp.com/mine 上的 flomo 在线备忘录。

此技能仅用于网页 UI 自动化，不依赖 flomo 官方 API。

这是对非 mac 用户的默认建议，也是 flomo-local-api 无法运行时的备用方案。

默认行为（v1）：

  • 完整的 CRUD（query/search、create/insert、edit、delete）
  • query 默认用于理解上下文：近期状态、当前关注点和价值观信号
  • 优先进行文本搜索，但写入操作前必须通过 memo_id 锁定目标
  • edit 默认完整替换内容（replace）
  • delete 始终需要明确的二次确认
  • 搜索时自动进行深度扫描，默认上限为 50 条备忘录
  • 最少记录日志（不持久化备忘录正文）

前置条件

  • 用户已在 Chrome 中登录 flomo 网页版
  • 此 Codex 会话中已启用且可正常使用 Chrome MCP
  • 优先使用桌面布局（宽视口）。移动端布局仅尽力支持。

适用场景

  • 用户要求搜索或查找 flomo 在线备忘录
  • 用户要求根据 flomo 内容了解其近期状态、在想什么或价值观
  • 用户要求在其真实账户中插入或创建 flomo 备忘录
  • 用户要求编辑或更新现有备忘录
  • 用户要求删除备忘录并接受确认步骤

不适用场景

  • 用户只想处理导出的 flomo HTML/归档
  • 用户要求对多条备忘录进行批量操作
  • 用户要求支持上传或编辑附件
  • 用户使用 mac，且只需要 flomo-local-api 已能处理的快速本地查询、创建或编辑

默认工作流（高层级）

  1. 确认 Chrome MCP 连接正常，并切换到 flomo 标签页（或导航至 flomo）。
  2. 对于 query/edit/delete，运行搜索工作流，并根据可见备忘录卡片/链接整理候选备忘录。
  3. 如有需要，通过滚动并重复读取进行深度扫描，但不超过扫描上限。
  4. 如果查询意图是反思性的，优先关注近期备忘录并提取反复出现的主题。
  5. 对于写入操作，通过 memo_id 锁定目标并提供确认步骤。
  6. 优先使用 chrome_read_page 的 refs 执行 UI 操作；refs 过期时刷新。
  7. 重新读取页面以验证结果，并总结操作结果。

安全规则（必须遵守）

  • delete：实际删除前始终要求明确的二次确认。
  • 通过文本搜索进行 edit：写入前必须确认候选项。
  • 不要将备忘录正文持久化到本地文件。
  • 提供反思性总结时，避免作出医疗、法律或诊断性断言。
  • 如果无法可靠定位目标 UI 控件，应停止操作并报告可恢复的失败，不要猜测。

工具优先级

按以下优先顺序使用 mcp-chrome-global Chrome MCP 工具：

  1. chrome_switch_tab / chrome_navigate
  2. chrome_read_page
  3. chrome_get_web_content
  4. chrome_click_element、chrome_fill_or_select、chrome_keyboard
  5. chrome_screenshot
  6. chrome_computer
  7. chrome_request_element_selection

意图映射

query/search

当用户的意图是“了解我最近的状态/在想什么/价值观”时，返回：

  • recent_state
  • active_topics
  • value_signals
  • supporting_memos
  • confidence_notes

返回候选备忘录，并包含：

  • memo_id
  • 可见的时间戳文本
  • 简短摘录
  • 匹配原因
create/insert

通过顶部编辑器插入一条新备忘录，并尽可能检测新的 memo_id 后报告成功。

edit

默认模式为 replace（替换整条备忘录正文）。append / prepend 是未来可选模式。

delete

只有在用户确认所选候选项后，才能删除单条目标备忘录。

后续问题（仅在必要时询问）

只有当问题会实质性改变操作时才询问：

  • 有多个匹配项，且用户要求执行写入操作
  • 用户未提供用于 create 或 edit 的新内容
  • 用户要求的扫描上限高于默认值 50
  • 反思性查询未指定时间范围，且“最近”的含义不明确
  • 页面布局为移动端，或无法可靠地找到控件
  • 破坏性操作到达最终确认环节

反思性查询启发规则

  • 默认时间范围：过去 30 天
  • 总结时优先依据证据
  • 优先关注反复出现的信号，而非个别陈述
  • 区分操作与价值观
  • 保持输出简洁且可操作

参考资料

  • 工作流详情：references/workflows.md
  • UI 定位策略与回退政策：references/ui-locators.md
  • 安全与日志政策：references/safety.md
  • 验证清单：references/test-checklist.md

评论

支持 Markdown