介绍
# FlowMind
[FlowMind](https://flowmind.life/) 是一个个性化的生产力工作区，将你的目标、任务、笔记和联系人集中在一个地方。与僵化的项目管理工具不同，FlowMind 会适应你的实际思考和运作方式——将任务与更大的目标关联，按能量水平和专注需求打标签，并让你清楚地看到当下最重要的事情。除了任务管理，FlowMind 还帮助你维护人脉、安排会议和追踪习惯——所有这些通常分散在不同应用中的生产力元素。最重要的是，大多数功能都可以通过 AI 自然语言访问，因此你只需说出需求即可管理工作流。
## 设置
在你的 agent 配置或环境中设置以下项： - `FLOWMIND_API_KEY` — 来自你的 FlowMind 账户的令牌（Settings → API Keys） - Base 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 ``` 字段：title, description, status (active/completed/archived), category (business/career/health/personal/learning/financial), target_date, progress (0-100), pinned
### 任务 ``` 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 ``` 字段：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 — list (filter: category, task_id, pinned) POST /notes — create (required: title) GET /notes/:id PATCH /notes/:id DELETE /notes/:id ``` 字段：title, content, category, task_id, is_protected, pinned
### 联系人 ``` 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 ``` 字段：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 — list (sort: name, created_at) POST /tags — create (required: name; optional: color) GET /tags/:id PATCH /tags/:id DELETE /tags/:id ```
## 分页与排序 - `page`（默认 1），`limit`（默认 20，最大 100） - `sort` 字段名，`order=asc|desc`
## 响应格式 ```json { "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](references/api.md)。