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              — list (filter: status, category, pinned; sort: title, target_date, progress)
POST   /goals              — create (required: title)
GET    /goals/:id          — get
PATCH  /goals/:id          — update
DELETE /goals/:id          — delete
GET    /goals/:id/tasks    — list tasks for goal

字段：标题、描述、状态（活跃/已完成/已归档）、类别（商业/职业/健康/个人/学习/财务）、目标日期、进度（0-100）、置顶

任务

GET    /tasks              — list (filter: status, priority, energy_level, goal_id, person_id, due_date_from/to, focused, focus_today)
POST   /tasks              — create (required: title)
GET    /tasks/:id          — get
PATCH  /tasks/:id          — update
DELETE /tasks/:id          — delete
GET    /tasks/:id/subtasks — list subtasks
POST   /tasks/:id/subtasks — create subtask

字段：标题、描述、状态（待办/进行中/已完成/已归档）、优先级（低/中/高/紧急）、精力水平（低/中/高）、截止日期、预定时间、目标ID、人员ID、父任务ID、预计分钟数、实际分钟数、置顶、专注、今日专注、专注顺序、图标

笔记

GET    /notes    — list (filter: category, task_id, pinned)
POST   /notes    — create (required: title)
GET    /notes/:id
PATCH  /notes/:id
DELETE /notes/:id

字段：标题、内容、类别、任务ID、受保护、置顶

人员

GET    /people             — list (filter: relationship_type, tag_id, search)
POST   /people             — create (required: name)
GET    /people/:id
PATCH  /people/:id
DELETE /people/:id
GET    /people/:id/tags    — list tags
POST   /people/:id/tags    — add tag (body: {tag_id})
DELETE /people/:id/tags/:tagId

字段：姓名、电子邮件、电话、公司、角色、关系类型（商业/同事/朋友/家人/导师/客户/合作伙伴/其他）、备注、出生月份、出生日期、位置、最后见面日期

标签

GET    /tags    — list (sort: name, created_at)
POST   /tags    — create (required: name; optional: color)
GET    /tags/:id
PATCH  /tags/:id
DELETE /tags/:id

分页与排序

• 页码（默认1），限制（默认20，最大100）
• 排序字段名称，顺序=升序|降序

响应格式

{ "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详情，请参见参考文献/api.md.