名称： flowmind
描述： 通过 FlowMind 管理个人生产力——利用 REST API 处理目标、任务（含子任务）、笔记、联系人及标签。适用于用户需要创建、列出、更新或删除目标、任务、笔记、联系人、标签；管理专注/优先级；跟踪进度；或通过 FlowMind 组织其生产力工作空间的场景。

FlowMind

FlowMind 是一个个性化的生产力工作空间，将您的目标、任务、笔记和联系人集中在一处。与僵化的项目管理工具不同，FlowMind 适应您实际的思考和工作方式——将任务与更大的目标关联，根据精力水平和专注需求打标签，并清晰展示当前最重要的事项。除了任务管理，FlowMind 还帮助您维护人脉网络、安排会议、追踪习惯——这些通常分散在不同应用中的高效生活要素，在此得以整合。最重要的是，大多数功能可通过 AI 自然语言交互实现，您只需说出需求即可管理工作流。

设置

在您的代理配置或环境中设置以下参数：
- FLOWMIND_API_KEY — 来自您 FlowMind 账户的 Bearer 令牌（设置 → API 密钥）
- 基础 URL：https://flowmind.life/api/v1

所有请求均使用 Authorization: Bearer <FLOWMIND_API_KEY> 和 Content-Type: application/json 头部。

快速参考

目标

GET    /goals              — 列出（筛选：status, category, pinned；排序：title, target_date, progress）
POST   /goals              — 创建（必需：title）
GET    /goals/:id          — 获取详情
PATCH  /goals/:id          — 更新
DELETE /goals/:id          — 删除
GET    /goals/:id/tasks    — 列出目标下的任务

字段：title, description, status (active/completed/archived), category (business/career/health/personal/learning/financial), target_date, progress (0-100), pinned

任务

GET    /tasks              — 列出（筛选：status, priority, energy_level, goal_id, person_id, due_date_from/to, focused, focus_today）
POST   /tasks              — 创建（必需：title）
GET    /tasks/:id          — 获取详情
PATCH  /tasks/:id          — 更新
DELETE /tasks/:id          — 删除
GET    /tasks/:id/subtasks — 列出子任务
POST   /tasks/:id/subtasks — 创建子任务

字段：title, description, status (todo/in_progress/completed/archived), priority (low/medium/high/urgent), energy_level (low/medium/high), due_date, scheduled_time, goal_id, person_id, parent_task_id, estimated_minutes, actual_minutes, pinned, focused, focus_today, focus_order, icon

笔记

GET    /notes    — 列出（筛选：category, task_id, pinned）
POST   /notes    — 创建（必需：title）
GET    /notes/:id
PATCH  /notes/:id
DELETE /notes/:id

字段：title, content, category, task_id, is_protected, pinned

联系人

GET    /people             — 列出（筛选：relationship_type, tag_id, search）
POST   /people             — 创建（必需：name）
GET    /people/:id
PATCH  /people/:id
DELETE /people/:id
GET    /people/:id/tags    — 列出标签
POST   /people/:id/tags    — 添加标签（请求体：{tag_id}）
DELETE /people/:id/tags/:tagId

字段：name, email, phone, company, role, relationship_type (business/colleague/friend/family/mentor/client/partner/other), notes, birth_month, birth_day, location, last_met_date

标签

GET    /tags    — 列出（排序：name, created_at）
POST   /tags    — 创建（必需：name；可选：color）
GET    /tags/:id
PATCH  /tags/:id
DELETE /tags/:id

分页与排序

• page（默认 1），limit（默认 20，最大 100）
• sort 字段名，order=asc|desc

响应格式

{ "data": [...], "meta": { "pagination": { "page": 1, "limit": 20, "total": 42, "totalPages": 3, "hasMore": true } } }

错误处理

错误返回 { "error": { "code": "...", "message": "...", "details": [] } }。错误码：BAD_REQUEST, UNAUTHORIZED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED。

常用工作流

每日专注：GET /tasks?focus_today=true 查看今日专注列表。通过 PATCH /tasks/:id { "focus_today": true } 切换专注状态。

目标追踪：创建目标，通过 goal_id 关联任务，使用 GET /goals/:id 检查进度。

会议准备：GET /people/:id + GET /tasks?person_id=:id 在会议前回顾相关上下文。

完整 API 详情请参阅 references/api.md。