flomo-web-crud

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Flomo Web CRUD

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.
This is the default recommendation for non-
mac
users, and the fallback path when
flomo-local-api
cannot run.
Default behavior (v1):
  • Full CRUD (
    query/search
    ,
    create/insert
    ,
    edit
    ,
    delete
    )
  • query
    defaults to context understanding: recent status, current concerns, and value signals
  • Text search first, but lock a target by
    memo_id
    before write actions
  • edit
    defaults to full content replacement (
    replace
    )
  • delete
    always requires explicit second confirmation
  • Auto deep scan for search with default cap of
    50
    memos
  • Minimal logging (do not persist memo body text)
使用Chrome MCP工具对
https://v.flomoapp.com/mine
上的实时flomo备忘录进行操作。
本技能仅用于网页UI自动化,不依赖flomo官方API。
这是面向非
mac
用户的默认推荐方案,也是
flomo-local-api
无法运行时的备选路径。
默认行为(v1版本):
  • 完整的CRUD功能(查询/搜索、创建/插入、编辑、删除)
  • 查询默认用于上下文理解:近期状态、当前关注重点和价值信号
  • 优先进行文本搜索,但在执行写入操作前需通过
    memo_id
    锁定目标
  • 编辑默认采用全内容替换模式(
    replace
  • 删除操作始终需要明确的二次确认
  • 自动深度扫描搜索结果,默认上限为50条备忘录
  • 极简日志记录(不持久化备忘录正文内容)

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.
  • 用户已在Chrome浏览器中登录flomo网页端
  • 当前Codex会话中Chrome MCP可用且正常运行
  • 优先使用桌面布局(宽视窗),移动端布局仅做尽力支持

Use This Skill When

适用场景

  • The user asks to search or find live flomo memos
  • The user asks to understand their recent状态/在想什么/价值观 from flomo content
  • The user asks to insert/create a flomo memo in their real account
  • The user asks to edit/update an existing memo
  • The user asks to delete a memo and accepts confirmation steps
  • 用户要求搜索或查找实时flomo备忘录
  • 用户要求通过flomo内容了解自己的近期状态/正在思考的内容/价值观
  • 用户要求在真实账户中插入/创建一条flomo备忘录
  • 用户要求编辑/更新现有备忘录
  • 用户要求删除备忘录并接受确认步骤

Do Not Use This Skill When

不适用场景

  • The user only wants to process exported flomo HTML/archives
  • The user asks for batch operations across many memos
  • The user asks for attachment upload/edit support
  • The user is on
    mac
    and only needs fast local query/create/edit that
    flomo-local-api
    can already handle
  • 用户仅需处理导出的flomo HTML文件/归档文件
  • 用户要求对大量备忘录进行批量操作
  • 用户要求支持附件上传/编辑
  • 用户使用
    mac
    设备,且仅需要
    flomo-local-api
    可实现的快速本地查询/创建/编辑功能

Default Workflow (High Level)

默认工作流程(概览)

  1. Confirm Chrome MCP connectivity and switch to the flomo tab (or navigate to flomo).
  2. For
    query/edit/delete
    , run search workflow and build memo candidates from visible memo cards/links.
  3. If needed, deep-scan by scrolling and repeating reads up to the scan cap.
  4. If the query intent is reflective, prioritize recent memos and extract recurring themes.
  5. For write operations, lock the target by
    memo_id
    and present a confirmation step.
  6. Execute UI actions with
    chrome_read_page
    refs first; refresh refs if they expire.
  7. Validate the result by re-reading the page and summarizing the outcome.
  1. 确认Chrome MCP连接正常,切换至flomo标签页(或导航至flomo页面)。
  2. 对于查询/编辑/删除操作,执行搜索流程并从可见的备忘录卡片/链接中构建候选备忘录列表。
  3. 如有需要,通过滚动页面重复读取内容,进行深度扫描,直至达到扫描上限。
  4. 如果查询意图为反思性需求,优先处理近期备忘录并提取重复出现的主题。
  5. 对于写入操作,通过
    memo_id
    锁定目标并展示确认步骤。
  6. 优先使用
    chrome_read_page
    引用执行UI操作;若引用过期则刷新引用。
  7. 通过重新读取页面验证操作结果并总结执行情况。

Safety Rules (Must Follow)

安全规则(必须遵守)

  • delete
    : Always require explicit second confirmation before actual deletion.
  • edit
    via text search: Require candidate confirmation before writing.
  • Do not persist memo body text to local files.
  • For reflective summaries, avoid medical/legal/diagnostic claims.
  • If target UI controls cannot be located reliably, stop and report a recoverable failure instead of guessing.
  • 删除操作:在实际执行删除前,始终要求用户进行明确的二次确认。
  • 通过文本搜索进行编辑:在执行写入操作前,要求用户确认候选目标。
  • 不得将备忘录正文内容持久化到本地文件。
  • 生成反思性总结时,避免做出医疗/法律/诊断类声明。
  • 若无法可靠定位目标UI控件,应停止操作并报告可恢复的失败,而非猜测执行。

Tool Priority

工具优先级

Use
mcp-chrome-global
Chrome MCP tools in this order of preference:
  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
按以下优先级使用
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

Intent Mapping

意图映射

query/search

查询/搜索

When user intent is "了解我最近状态/在想什么/价值观", return:
  • recent_state
  • active_topics
  • value_signals
  • supporting_memos
  • confidence_notes
Return candidate memos with:
  • memo_id
  • visible timestamp text
  • short snippet
  • match reason
当用户意图为“了解我最近状态/在想什么/价值观”时,返回以下内容:
  • recent_state
    (近期状态)
  • active_topics
    (关注主题)
  • value_signals
    (价值信号)
  • supporting_memos
    (支撑备忘录)
  • confidence_notes
    (可信度说明)
返回候选备忘录时需包含:
  • memo_id
  • 可见时间戳文本
  • 简短片段
  • 匹配理由

create/insert

创建/插入

Insert a new memo through the top editor and report success with best-effort new
memo_id
detection.
通过顶部编辑器插入新备忘录,并尽力检测新生成的
memo_id
以报告操作成功。

edit

编辑

Default mode is
replace
(replace full memo body).
append
/
prepend
are optional future modes.
默认模式为
replace
(替换备忘录全部内容)。
append
(追加)/
prepend
(前置)为可选的未来扩展模式。

delete

删除

Delete a single target memo only after the user confirms the selected candidate.
仅在用户确认选中的候选目标后,删除单个目标备忘录。

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
    edit
  • The user wants a scan cap larger than the default
    50
  • Reflective query has no time scope and "recent" is ambiguous
  • The page layout is mobile or controls cannot be found reliably
  • A destructive action reaches the final confirmation point
仅当问题会对操作产生实质性影响时才询问:
  • 多个候选目标匹配且用户请求执行写入操作
  • 用户未提供创建或编辑所需的新内容
  • 用户要求的扫描上限大于默认的50条
  • 反思性查询未指定时间范围,“近期”概念模糊
  • 页面为移动端布局或无法可靠定位控件
  • 破坏性操作到达最终确认环节

Reflective Query Heuristics

反思性查询启发规则

  • Default time scope: last 30 days
  • Use evidence-first summary
  • Prioritize repeated signals over one-off statements
  • Distinguish actions from values
  • Keep output compact and actionable
  • 默认时间范围:最近30天
  • 采用基于证据的总结方式
  • 优先考虑重复出现的信号而非一次性表述
  • 区分行动与价值观
  • 输出内容简洁且具备可操作性

References

参考资料

  • Workflow details:
    references/workflows.md
  • UI locator strategy and fallback policy:
    references/ui-locators.md
  • Safety and logging policy:
    references/safety.md
  • Validation checklist:
    references/test-checklist.md
  • 工作流程详情:
    references/workflows.md
  • UI定位策略与备选方案:
    references/ui-locators.md
  • 安全与日志记录规则:
    references/safety.md
  • 验证检查清单:
    references/test-checklist.md