用途
flomo-web-crud 用于通过 Chrome MCP 工具，在 flomo 网页版（https://v.flomoapp.com/mine）上操作用户真实的 flomo 笔记。该技能仅针对 Web UI 自动化，不依赖 flomo 官方 API。它是面向非 Mac 用户的默认推荐方案，也是 flomo-local-api 无法运行时的回退路径。
主要能力
默认行为（v1）包括：
- 完整 CRUD：查询/搜索、创建/插入、编辑、删除。
- 查询默认结合上下文理解：近期状态、当前关注点、价值信号。
- 先进行文本搜索，但在写操作前通过 memo_id 锁定目标。
- 编辑默认整篇内容替换（replace）。
- 删除始终需要明确的二次确认。
- 搜索时自动深度扫描，默认上限为 50 条笔记。
- 日志最小化，不持久化笔记正文。
使用方式
前提条件
- 用户已在 Chrome 中登录 flomo 网页版。
- Chrome MCP 在当前 Codex 会话中可用且正常工作。
- 优先使用桌面布局（宽视口）；移动布局仅为尽力支持。
适用场景
- 用户要求搜索或查找实时 flomo 笔记。
- 用户要求从 flomo 内容中了解其近期状态/在想什么/价值观。
- 用户要求在其真实账号中插入/创建 flomo 笔记。
- 用户要求编辑/更新已有笔记。
- 用户要求删除笔记并接受确认步骤。
不适用场景
- 用户只想处理导出的 flomo HTML/归档文件。
- 用户要求跨大量笔记的批量操作。
- 用户要求附件上传/编辑支持。
- 用户使用 Mac，且只需 flomo-local-api 已能处理的快速本地查询/创建/编辑。
默认工作流（高层）
- 确认 Chrome MCP 连通性，切换到 flomo 标签页（或导航到 flomo）。
- 对于查询/编辑/删除，运行搜索工作流，从可见的笔记卡片/链接构建候选笔记。
- 如需要，通过滚动并重复读取进行深度扫描，直至达到扫描上限。
- 如果查询意图是反思性的，优先处理近期笔记并提取反复出现的主题。
- 对于写操作，通过 memo_id 锁定目标并呈现确认步骤。
- 优先使用 chrome_read_page 的 refs 执行 UI 操作；若 refs 过期则刷新。
- 通过重新读取页面验证结果并总结结果。
安全规则（必须遵守）
- 删除：实际删除前始终需要明确的二次确认。
- 通过文本搜索编辑：写入前需要候选确认。
- 不要将笔记正文持久化到本地文件。
- 对于反思性总结，避免医疗/法律/诊断性断言。
- 如果无法可靠定位目标 UI 控件，停止并报告可恢复的失败，而不是猜测。
工具优先级
按以下优先顺序使用 mcp-chrome-global 的 Chrome MCP 工具：
- chrome_switch_tab / chrome_navigate
- chrome_read_page
- chrome_get_web_content
- chrome_click_element、chrome_fill_or_select、chrome_keyboard
- chrome_screenshot
- chrome_computer
- chrome_request_element_selection
意图映射
查询/搜索
当用户意图为“了解我最近状态/在想什么/价值观”时，返回：
- recent_state
- active_topics
- value_signals
- supporting_memos
- confidence_notes
返回候选笔记时包含：
- memo_id
- 可见时间戳文本
- 简短片段
- 匹配原因
创建/插入
通过顶部编辑器插入新笔记，并尽力检测新 memo_id 后报告成功。
编辑
默认模式为 replace（替换整篇笔记正文）。append / prepend 为可选的未来模式。
删除
仅在用户确认所选候选后，删除单个目标笔记。
追问问题（仅在需要时询问）
仅在会实质性改变操作时询问：
- 多个候选匹配且请求了写操作。
- 用户未提供创建或编辑所需的新内容。
- 用户希望扫描上限大于默认的 50。
- 反思性查询没有时间范围，且“近期”含义模糊。
- 页面布局为移动端，或无法可靠找到控件。
- 破坏性操作到达最终确认点。
反思性查询启发式
- 默认时间范围：最近 30 天。
- 使用证据优先的总结。
- 优先处理重复出现的信号，而非一次性陈述。
- 区分行动与价值观。
- 保持输出紧凑且可操作。
参考资料
- 工作流细节：references/workflows.md
- UI 定位策略与回退策略：references/ui-locators.md
- 安全与日志策略：references/safety.md
- 验证清单：references/test-checklist.md
限制
该技能仅支持 Web UI 自动化，不支持批量操作、附件上传/编辑，也不处理导出的 flomo HTML/归档文件。移动布局仅为尽力支持。若无法可靠定位目标 UI 控件，会停止并报告可恢复的失败。