Flomo Web CRUD
Overview
Use Chrome MCP tools to operate on live flomo memos at https://v.flomoapp.com/mine.
This skill is for Web UI automation only. It does not depend on flomo official APIs.
Default behavior (v1):
- - Full CRUD (
query/search, create/insert, edit, delete) - Text search first, but lock a target by
memo_id before write actions - INLINECODE6 defaults to full content replacement (
replace) - INLINECODE8 always requires explicit second confirmation
- Auto deep scan for search with default cap of
50 memos - Minimal logging (do not persist memo body text)
Preconditions
- - User is already logged in to flomo Web in Chrome
- Chrome MCP is available and working in this Codex session
- Prefer desktop layout (wide viewport). Mobile layout is best-effort only.
Use This Skill When
- - The user asks to search or find live flomo memos
- The user asks to insert/create a flomo memo in their real account
- The user asks to edit/update an existing flomo memo
- The user asks to delete a flomo memo and accepts confirmation steps
Do Not Use This Skill When
- - The user only wants to process exported flomo HTML/archives (use
flomo-memo-to-markdown instead) - The user asks for batch operations across many memos (not v1)
- The user asks for attachment upload/edit support (not v1)
Default Workflow (High Level)
- 1. Confirm Chrome MCP connectivity and switch to the flomo tab (or navigate to flomo).
- For
query/edit/delete, run search workflow and build memo candidates from visible memo cards/links. - If needed, deep-scan by scrolling and repeating reads up to the scan cap.
- For write operations, lock the target by
memo_id and present a confirmation step. - Execute UI actions with
chrome_read_page refs first; refresh refs if they expire. - Validate the result by re-reading the page and summarizing the outcome.
Safety Rules (Must Follow)
- -
delete: Always require explicit second confirmation before actual deletion. - INLINECODE15 via text search: Require candidate confirmation before writing.
- Do not persist memo body text to local files.
- If target UI controls cannot be located reliably, stop and report a recoverable failure instead of guessing.
Tool Priority
Use mcp-chrome-global Chrome MCP tools in this order of preference:
- 1.
chrome_switch_tab / INLINECODE18 - INLINECODE19 (structured refs)
- INLINECODE20 (fast visible text read)
- INLINECODE21 ,
chrome_fill_or_select, INLINECODE23 - INLINECODE24 (debugging / visual confirmation)
- INLINECODE25 (coordinate fallback, minimal use)
- INLINECODE26 (human-in-the-loop fallback after repeated failures)
Intent Mapping
query/search
Return candidate memos with:
- - INLINECODE28
- visible timestamp text
- short snippet
- match reason
create/insert
Insert a new memo through the top editor and report success with best-effort new memo_id detection.
edit
Default mode is replace (replace full memo body). append/prepend are reserved optional modes and may be unsupported in v1 unless explicitly implemented during the run.
delete
Delete a single target memo only after the user confirms the selected candidate.
Candidate / Action / Result Shapes
Use these internal conventions in responses and reasoning (no code API required):
MemoCandidate
- - INLINECODE37
- INLINECODE38
- INLINECODE39
- INLINECODE40
- INLINECODE41
ActionPlan
- - INLINECODE43
- INLINECODE44
- INLINECODE45
- INLINECODE46
- INLINECODE47 (default
50) - INLINECODE49
ActionResult
- - INLINECODE51
- INLINECODE52
- INLINECODE53
- INLINECODE54
- INLINECODE55
- INLINECODE56
Follow-Up Questions (Ask Only When Needed)
Ask only if it changes the action materially:
- - Multiple candidates match and a write action is requested
- The user did not provide new content for
create or INLINECODE58 - The user wants a scan cap larger than the default INLINECODE59
- The page layout is mobile or controls cannot be found reliably
- A destructive action (
delete) reaches the final confirmation point
References
- - Workflow details: INLINECODE61
- UI locator strategy and fallback policy: INLINECODE62
- Safety and logging policy: INLINECODE63
- Validation checklist: INLINECODE64
Flomo Web CRUD
概述
使用 Chrome MCP 工具在 https://v.flomoapp.com/mine 上对实时 flomo 备忘录进行操作。
此技能仅用于 Web UI 自动化,不依赖 flomo 官方 API。
默认行为(v1):
- - 完整 CRUD(查询/搜索、创建/插入、编辑、删除)
- 优先文本搜索,但在写操作前通过 memo_id 锁定目标
- 编辑 默认为全文替换(替换)
- 删除 始终需要明确的二次确认
- 自动深度扫描搜索,默认上限为 50 条备忘录
- 最小化日志记录(不持久化备忘录正文文本)
前置条件
- - 用户已在 Chrome 中登录 flomo Web
- Chrome MCP 在此 Codex 会话中可用且正常工作
- 优先使用桌面布局(宽视口)。移动端布局仅尽力支持。
使用此技能的场景
- - 用户要求搜索或查找实时 flomo 备忘录
- 用户要求在其真实账户中插入/创建 flomo 备忘录
- 用户要求编辑/更新现有 flomo 备忘录
- 用户要求删除 flomo 备忘录并接受确认步骤
不使用此技能的场景
- - 用户仅需处理导出的 flomo HTML/归档文件(改用 flomo-memo-to-markdown)
- 用户要求跨多条备忘录进行批量操作(非 v1)
- 用户要求附件上传/编辑支持(非 v1)
默认工作流程(高级)
- 1. 确认 Chrome MCP 连接并切换到 flomo 标签页(或导航至 flomo)。
- 对于 查询/编辑/删除,运行搜索工作流并从可见的备忘录卡片/链接构建候选备忘录。
- 如有需要,通过滚动和重复读取进行深度扫描,直至达到扫描上限。
- 对于写操作,通过 memoid 锁定目标并呈现确认步骤。
- 首先使用 chromeread_page 引用执行 UI 操作;如果引用过期则刷新。
- 通过重新读取页面并总结结果来验证操作结果。
安全规则(必须遵守)
- - 删除:在实际删除前始终要求明确的二次确认。
- 通过文本搜索的 编辑:在写入前要求候选确认。
- 不要将备忘录正文文本持久化到本地文件。
- 如果无法可靠定位目标 UI 控件,停止并报告可恢复的失败,而不是猜测。
工具优先级
按以下优先顺序使用 mcp-chrome-global Chrome MCP 工具:
- 1. chromeswitchtab / chromenavigate
- chromereadpage(结构化引用)
- chromegetwebcontent(快速可见文本读取)
- chromeclickelement、chromefillorselect、chromekeyboard
- chromescreenshot(调试/视觉确认)
- chromecomputer(坐标回退,最小化使用)
- chromerequestelement_selection(重复失败后的人工介入回退)
意图映射
查询/搜索
返回候选备忘录,包含:
创建/插入
通过顶部编辑器插入新备忘录,并尽力检测新的 memo_id 报告成功。
编辑
默认模式为 替换(替换完整备忘录正文)。追加/前置 为保留的可选模式,在 v1 中可能不支持,除非在运行期间明确实现。
删除
仅在用户确认所选候选后删除单个目标备忘录。
候选/操作/结果格式
在响应和推理中使用以下内部约定(无需代码 API):
MemoCandidate
- - memoid: string
- timestamptext: string
- snippet: string
- match_reason: string
- score?: number
ActionPlan
- - action: query | create | edit | delete
- targetquery?: string
- targetmemoid?: string
- editmode?: replace | append | prepend
- scanlimit: number(默认 50)
- requiresconfirmation: boolean
ActionResult
- - success: boolean
- action: string
- memoid?: string
- matchedcount?: number
- message: string
- warnings?: string[]
后续问题(仅在需要时询问)
仅在会实质性改变操作时询问:
- - 多个候选匹配且请求写操作
- 用户未提供 创建 或 编辑 的新内容
- 用户希望扫描上限大于默认的 50
- 页面布局为移动端或无法可靠找到控件
- 破坏性操作(删除)到达最终确认点
参考
- - 工作流详情:references/workflows.md
- UI 定位策略和回退策略:references/ui-locators.md
- 安全和日志策略:references/safety.md
- 验证检查清单:references/test-checklist.md