felo-mindmap

Felo 思维导图技能

使用时机

遇到以下有关创建思维导图文件的请求时，使用此技能：

• 根据主题或问题创建／生成思维导图
• 将想法整理成结构化思维导图
• 使用不同布局类型（时间线、鱼骨图等）创建思维导图
• 将思维导图内容导出为可分享链接

触发关键词：

• 关于制作思维导图的中文提示（思维导图、脑图）
• 英文：mindmap、mind map、thinking map、generate mindmap
• 明确指令：/felo-mindmap、“use felo mindmap”

以下情况不要使用此技能：

• 查找实时信息（使用 felo-search）
• 询问本地代码库文件
• 不需要生成思维导图的纯文本任务

设置

1. 获取 API 密钥

1. 访问 felo.ai
2. 打开 Settings -> API Keys
3. 创建并复制 API 密钥

2. 配置环境变量

Linux/macOS：

export FELO_API_KEY="your-api-key-here"

Windows PowerShell：

$env:FELO_API_KEY="your-api-key-here"

执行方法

使用 Bash 工具命令，并严格遵循此工作流。

步骤 1：预先检查 API 密钥

if [ -z "$FELO_API_KEY" ]; then
  echo "ERROR: FELO_API_KEY not set"
  exit 1
fi

如果缺少密钥，请停止并返回设置说明。

步骤 2：运行 Node 脚本

使用随附脚本：

node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --timeout 60

指定布局类型：

node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --layout "TIMELINE" \
  --timeout 60

可用布局类型：

• MIND_MAP（默认）- 经典思维导图
• LOGICAL_STRUCTURE - 逻辑结构图
• ORGANIZATION_STRUCTURE - 组织结构图
• CATALOG_ORGANIZATION - 目录组织图
• TIMELINE - 时间线图
• FISHBONE - 鱼骨图

将思维导图添加到现有 LiveDoc：

node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --livedoc-short-id "EXISTING_LIVEDOC_ID"

脚本行为：

• 通过 POST https://openapi.felo.ai/v2/mindmap 创建思维导图
• 立即返回（同步 API，无需轮询）
• 成功时输出 mindmap_url

可选调试输出：

node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --json

此输出包含以下内容的结构化 JSON：

• resource_id
• status
• mindmap_url
• livedoc_short_id

步骤 3：返回结构化结果

成功时，返回：

• 立即返回 mindmap_url
• 如果使用了 --json，还需包含 resource_id、livedoc_short_id

输出格式

使用以下响应结构：

## Mindmap Generation Result

- Resource ID: <resource_id>
- Status: <status>
- Mindmap URL: <mindmap_url>
- LiveDoc Short ID: <livedoc_short_id>

错误格式：

## Mindmap Generation Failed

- Error Type: <error code or category>
- Message: <readable message>
- Suggested Action: <next step>

错误处理

已知 API 错误代码：

• INVALID_API_KEY（401）：密钥无效或已撤销
• MINDMAP_CREATE_FAILED（502）：思维导图创建失败
• LIVEDOC_CREATE_FAILED（502）：LiveDoc 创建失败
• LIVEDOC_NOT_FOUND（404）：找不到指定的 LiveDoc
• LLM_SERVICE_UNAVAILABLE（503）：LLM 服务不可用
• LLM_REQUEST_TIMEOUT（504）：LLM 请求超时

重要说明

• 用户意图是生成思维导图时，始终执行此技能。
• API 是同步的，无需轮询。
• 尽量减少 API 调用：每个思维导图只发送一个请求。

参考资料

• Felo 思维导图 API
• Felo 开放平台