用途：在 Claude Code 中根据主题或问题生成思维导图文件，把想法整理成结构化脑图，支持不同布局类型并导出可分享链接。触发关键词包括思维导图、脑图、mindmap、mind map、thinking map，以及 /felo-mindmap 或“use felo mindmap”等显式命令。不适用于实时信息查询（应使用 felo-search）、本地代码库文件问题，以及无需生成脑图的纯文本任务。
主要能力：支持 MIND_MAP（默认经典思维导图）、LOGICAL_STRUCTURE（逻辑结构图）、ORGANIZATION_STRUCTURE（组织架构图）、CATALOG_ORGANIZATION（目录组织图）、TIMELINE（时间线图）、FISHBONE（鱼骨图）等布局；可将脑图添加到已有 LiveDoc；成功时返回 mindmap_url，使用 --json 时还输出 resource_id、status、livedoc_short_id。
使用方式：先获取 API key（访问 felo.ai，在 Settings -> API Keys 创建并复制），再配置环境变量。Linux/macOS 执行 export FELO_API_KEY="your-api-key-here"；Windows PowerShell 执行 $env:FELO_API_KEY="your-api-key-here"。随后用 Bash 工具按流程执行：先检查 API key 是否设置，缺失则停止并返回配置说明；再运行捆绑脚本，例如 node felo-mindmap/scripts/run_mindmap_task.mjs --query "USER_PROMPT_HERE" --timeout 60，指定布局时加 --layout "TIMELINE"，添加到已有 LiveDoc 时加 --livedoc-short-id "EXISTING_LIVEDOC_ID"，需要结构化输出时加 --json。脚本通过 POST https://openapi.felo.ai/v2/mindmap 创建脑图，API 为同步接口，无需轮询，成功时打印 mindmap_url。
限制与错误处理：需有效 API key，否则返回 INVALID_API_KEY（401）；其他已知错误包括 MINDMAP_CREATE_FAILED（502）、LIVEDOC_CREATE_FAILED（502）、LIVEDOC_NOT_FOUND（404）、LLM_SERVICE_UNAVAILABLE（503）、LLM_REQUEST_TIMEOUT（504）。应保持 API 调用最少，每张脑图一次请求。