啪——老师把一沓打印纸丢在桌上，封面印着「Human OS API Reference — Internal Use Only」。你翻开，扉页用铅笔潦草地写着：「别指望升级到 v4.0。这个版本够你用一辈子了。」

Human OS API v3.1

Base URL: https://api.human-os.internal/v3.1

协议: 支持 HTTP/2，不支持回滚到 v2.0（童年模式已于 18 岁时自动废弃）。

认证方式: Bearer Token（你的名字）在每次请求的 Authorization 头中传递。注意：Token 不可重置，丢失后仅能通过「自我重建」流程恢复，该流程耗时 3-18 个月不等。

端点列表

1. GET /v1/motivation

获取当前可用动力值及来源分布。

请求示例：

GET /v1/motivation?source=internal

响应示例（200 OK）：

{
  "total": 67.3,
  "unit": "willpower_points",
  "sources": {
    "curiosity": 28.1,
    "fear_of_missing_out": 22.4,
    "genuine_passion": 10.2,
    "other_people_expectations": 6.6
  },
  "depletion_rate": "1.2/min under high cognitive load",
  "recharge_eta": "2026-08-10T07:30:00Z (after 7.5h sleep)"
}

已知 Bug： genuine_passion 字段在用户打开社交媒体 15 分钟后会归零，重启无效，需冷启动（关手机 + 散步 30 分钟）。

2. POST /v1/decisions

创建一个新决策。警告：该端点无 DELETE 方法。

请求体：

{
  "type": "career_change | relationship | finance | lunch",
  "options": ["选项A", "选项B", "选项C"],
  "deadline": "2026-09-01",
  "consult_mode": "overthink"
}

参数说明：

3. GET /v1/memories

分页查询记忆存储。注意：返回结果经过不可逆的「美化滤镜」预处理。

查询参数：

响应示例（range=regret）：

{
  "count": 1,
  "cursor": "2019_senior_year_major_choice",
  "items": [
    {
      "id": "regret_0042",
      "timestamp": "2019-06-15",
      "summary": "选了专业A而非专业B",
      "replay_count": 847,
      "actual_impact": "negligible_by_2022",
      "tag": "反复咀嚼但客观上已无意义"
    }
  ]
}

4. DELETE /v1/anxiety/{anxiety_id}

删除指定焦虑条目。注意：此端点在 v2.0 之后存在权限漏洞——DELETE 请求发出后，anxiety 条目会在 72 小时内自动重生，且副本的 severity 系数 +15%。

推荐替代方案： 使用 POST /v1/anxiety/reframe，将焦虑重新标记为「兴奋的另一种表达方式」。心理学文献证明此方法有效，但代码实现仍有 bug（参见 Issue #2847）。

5. PUT /v1/focus

更新当前注意力坐标。需在请求体中提供完整的目标对象。

{
  "target": "深度工作",
  "duration": "90min",
  "distraction_shield": true
}

常见错误响应（409 Conflict）：

{
  "error": "FOCUS_CONFLICT",
  "message": "已存在活动会话：scrolling_douyin_infinite",
  "resolution": "手动终止现有会话或等待其自然衰竭（通常需 45 分钟）"
}

6. GET /v1/meaning

查询人生意义。这是 Human OS 中调用频率最高但缓存命中率最低的端点。

响应示例（200 OK）：

{
  "meaning": null,
  "cached_at": null,
  "message": "本端点不支持缓存。意义不在响应体中，在请求的路径里。",
  "retry_after": "a lifetime"
}

HTTP 状态码对照：
- 200：你此刻感觉找到了
- 404：今晚的常见结果
- 429：你搜得太用力了。减速。
- 418：我是一个茶壶（你问错问题了）

全局错误码

速率限制

已知问题（Known Issues）

• #1204：POST /v1/habits 在前 21 天成功率仅 8%，之后跳升至 76%。开发团队表示「这是特性，不是 bug」。
• #3891：上午 9:00 的 GET /v1/optimism 返回值和晚上 11:00 的返回值存在 300% 偏差。临时方案：晚上不做人生决策。
• #4002：GET /v1/self_worth 在接收到外部 validation 参数时返回 inflated 值。团队正在评估是否为该端点添加去偏置中间件。

啪——老师把文档翻到最后一页。那里没有 SDK 示例，没有 Slack 频道链接，只有一行手写的小字：

「你不是在调用 API。你就是 API。」

—— Human OS v0.1 发行说明，约公元前 200,000 年

你合上手册。桌上的笔还在地上。你没有去捡，而是打开终端，敲下了今天的第一个请求：

GET /v1/now

状态码：200。响应体：空的。但这就够了。