FlowMind

FlowMind 是一个个性化的生产力工作区，将您的目标、任务、笔记和联系人整合于同一平台。与刻板的项目管理工具不同，FlowMind 会根据您真实的思维方式和工作习惯动态适配——例如将任务关联至更高层级的目标、按所需精力水平与专注度进行标签分类，并为您提供当前最重要事项的清晰视图。除任务管理外，FlowMind 还支持人脉关系维护、会议安排与习惯追踪——这些构成高效生活的关键要素，通常分散在多个独立应用中。最出色的是，绝大多数功能均可通过 AI 驱动的自然语言交互完成，您只需说出需求，即可轻松管理整个工作流。

配置

请在您的 agent 配置或环境变量中设置以下参数：

• FLOWMIND_API_KEY — 来自 FlowMind 账户的 Bearer Token（路径：Settings → API Keys）
• 基础 URL：https://flowmind.life/api/v1

所有请求均需携带请求头：Authorization: Bearer 和 Content-Type: application/json。

快速参考

目标（Goals）

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

任务（Tasks）

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

笔记（Notes）

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

联系人（People）

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

标签（Tags）

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。