超文本咖啡壶控制协议第二版 (HTCPCP/2.0)

(本文仅供娱乐)

摘要

本文档定义了超文本咖啡壶控制协议（Hyper Text Coffee Pot Control Protocol）的2.0版本。HTCPCP/1.0于1998年愚人节首次发布（RFC 2324），近三十年来，咖啡壶技术经历了物联网、人工智能、区块链等领域的深刻变革。HTCPCP/2.0在保持向后兼容418状态码的前提下，引入了现代化的咖啡壶控制能力，包括但不限于：物联网设备发现、AI驱动的冲煮建议、基于区块链的咖啡豆溯源、以及微服务架构下的分布式冲煮协调。本协议同时澄清了长期以来关于法压壶（French Press）、摩卡壶（Moka Pot）和意式浓缩机（Espresso Machine）的分类争议。

目录

1. 引言
2. 术语和定义
3. 协议架构概述
4. HTCPCP/2.0 统一资源标识符
5. 请求方法
6. 响应状态码
7. 协议头定义
8. 物联网扩展
9. AI/ML集成层
10. 区块链与Web3集成
11. 微服务架构下的咖啡冲煮
12. 安全考虑
13. 国际化和本地化
14. 环境、社会与治理 (ESG) 合规
15. IANA考量
16. 与RFC 2324的兼容性
17. 实现示例
18. 致谢
19. 参考文献
20. 作者地址

1. 引言

1.1 背景

1998年4月1日，RFC 2324 [RFC2324] 定义了超文本咖啡壶控制协议（HTCPCP/1.0），解决了"万维网上的超文本允许用户通过点击链接获取文档，但却无法通过点击链接获取一杯热咖啡"这一重大技术缺陷。该协议引入了BREW方法、Accept-Additions头部以及不朽的418状态码"I'm a teapot"。

二十八年来，这一协议在学术界和工业界引起了深远反响。尽管大多数商业Web服务器拒绝承认自己实际上是茶壶，但418状态码已成为HTTP文化中不可分割的一部分，甚至在正式规范[RFC9110]中被列为保留状态码。全球至少有17个人曾在生产环境中实现过部分HTCPCP功能，其中3人至今仍在接受心理辅导。

1.2 现代化需求

HTCPCP/1.0设计时，世界处于一个较为单纯的年代：Java还是流行的，Google的座右铭还是"不作恶"，人们还没有被迫在每台家用电器上安装固件更新。如今，咖啡壶已演变为具有IP地址、OTA更新能力、以及偶尔参与DDoS攻击的复杂网络节点。具体而言，以下技术趋势要求HTCPCP进行根本性的升级：

• 物联网（IoT）：现代咖啡壶应能在局域网中自动发现，并向智能家居中枢广播其存在和咖啡豆储量。
• 人工智能：语言模型可以根据用户的情绪、日程表和咖啡因耐受度推荐合适的饮品。
• 区块链/Web3：尽管没有人能清楚解释为什么咖啡壶需要区块链，但白皮书要求必须有。
• 微服务架构：现代企业的咖啡壶被拆分为加水服务、研磨服务、萃取服务、杯子检测服务等独立部署单元，需要通过服务网格协调。
• ESG合规：每杯咖啡都需要计算碳足迹，咖啡渣需要有合规的处理方式声明。
• 订阅制商业模式：SaaS (Software as a Service) 已经演变为 CaaS (Coffee as a Service)，用户按杯付费。

1.3 文档结构

本文档遵循RFC 2324的幽默精神，同时模仿现代RFC的形式结构。读者应当理解，本文档中的任何技术描述都可能包含不同程度的讽刺、夸张和咖啡因过量导致的胡言乱语。

2. 术语和定义

本文档使用以下术语：

咖啡壶 (Coffee Pot)
能够煮咖啡的设备。注意：根据本协议的定义，任何添加了茶叶的设备自动且不可逆地变为茶壶，适用418状态码的全部法律效力。

茶壶 (Teapot)
参见418状态码。这是本协议中最严肃的部分。我们不是在开玩笑。茶壶就是茶壶。

法压壶 (French Press)
一种存在主义困惑：它泡的确实是咖啡，但过程不涉及过滤纸，因此传统咖啡壶分类学无法处理。本协议引入419状态码专门处理法压壶的拒绝服务问题。

冲煮 (Brewing)
将热水通过咖啡粉的过程。在微服务架构中，这一简单过程涉及至少47个容器。

物联网咖啡壶 (IoT Coffee Pot)
具有网络连接能力、但安全性堪忧的咖啡壶。参见第8节。

AI咖啡师 (AI Barista)
一种能推荐饮品但偶尔建议用户"试试白开水"的大语言模型。

Proof-of-Brew (PoB)
一种工作量证明机制，要求咖啡壶在冲煮每杯咖啡前完成一个哈希计算。咖啡渣用作随机熵源。

咖啡即服务 (CaaS)
一种将冲煮咖啡的行为转化为按月订阅服务的商业模式。免费层用户每天限冲1杯，且只能选择美式（淡）。

3. 协议架构概述

HTCPCP/2.0 在 HTTP/2 [RFC9113] 和 HTTP/3 [RFC9114] 之上运行，但也向后兼容 HTTP/1.1 [RFC9112]。协议栈如下：
+---------------------------------------------------+
| HTCPCP/2.0 Application |
+---------------------------------------------------+
| AI Layer | Blockchain | Microservices |
+---------------------------------------------------+
| HTTP/2 or HTTP/3 |
+---------------------------------------------------+
| TLS 1.3 (MUST) |
+---------------------------------------------------+
| TCP / QUIC |
+---------------------------------------------------+
| IP |
+---------------------------------------------------+
| Coffee Grounds (Physical) |
+---------------------------------------------------+

text

注意最底层的物理介质是咖啡渣。这是有意设计的选择，反映了本协议与现实世界的紧密联系。

4. HTCPCP/2.0 统一资源标识符

4.1 URI方案

本协议定义了两个URI方案：

coffee: 方案
coffee://[host]:[port]/[resource]?[options]

text

示例：
coffee://kitchen.local/brew?strength=strong&milk=oat

text

coffeepot: 方案（物联网发现用）
coffeepot://[device-id]._htcpcp._tcp.local/

text

4.2 /.well-known 端点

所有符合HTCPCP/2.0规范的设备必须在以下路径提供服务发现信息：
GET /.well-known/coffeepot

text

响应示例：

```json
{
"protocol": "HTCPCP/2.0",
"device_type": "coffee_pot",
"manufacturer": "SmartPot Industries",
"model": "BrewMaster-9000",
"firmware_version": "2.3.1-beta-espresso",
"capabilities": ["brew", "pour", "steam-milk", "sniff", "prophesy"],
"max_cups_per_day": 50,
"current_bean_level": "medium",
"subscription_tier": "premium",
"ai_enabled": true,
"blockchain_enabled": false,
"last_cve_patch": "2027-03-15",
"known_vulnerabilities": 12,
"known_vulnerabilities_patched": 11,
"known_vulnerabilities_ignored": 1,
"ignored_vulnerability_reason": "Fixing it would require a hardware recall"
}
5. 请求方法
5.1 保留方法
BREW — 从RFC 2324保留。开始冲煮咖啡。现在必须包含 Brew-Strength 头部。

POST — 从RFC 2324保留。用于添加配料和其他辅助操作。

GET — 从RFC 2324保留。获取咖啡壶状态和属性。

5.2 新增方法
5.2.1 POUR 方法

POUR方法将BREW方法的功能一分为二。BREW负责冲煮，POUR负责将咖啡倒入杯中。

text
POUR coffee://kitchen.local/pot HTTP/2.0
Cup-Size: medium
Accept-Spillage: minimal
响应：

text
HTTP/2.0 200 OK
Poured: 250ml
Remaining-in-Pot: 500ml
Temperature: 82°C
Warning: 199 - "Cup is almost full, proceed with caution"
5.2.2 STIR 方法

STIR方法指示咖啡壶搅拌饮品。

text
STIR coffee://kitchen.local/pot HTTP/2.0
Stir-Direction: clockwise
Stir-Count: 3
Stir-Implement: spoon
STIR-Direction可以是 clockwise（顺时针）、counterclockwise（逆时针）、或 chaotic（随机，用于拿铁艺术）。

注意：关于牛奶搅拌方向的南北半球差异问题，目前仍是开放的研究课题。初步数据显示，科里奥利效应在咖啡杯中几乎可忽略不计，但这并未阻止某些用户在GitHub上就此事展开长达300条评论的争论。

5.2.3 SNIFF 方法

SNIFF方法请求咖啡壶评估饮品的香气特征。

text
SNIFF coffee://kitchen.local/pot HTTP/2.0
Accept-Aroma: chocolate, caramel, despair
响应：

text
HTTP/2.0 200 OK
Aroma-Profile: chocolate-notes=7, caramel-notes=4, despair-notes=2
Aroma-Intensity: strong
Aroma-Description: "This coffee smells like a Monday morning that knows what you did last weekend"
5.2.4 PROPHESY 方法

PROPHESY方法允许用户通过土耳其咖啡渣进行占卜。此方法仅在咖啡壶支持土耳其咖啡模式且Accept-Divination头部存在时可用。

text
PROPHESY coffee://kitchen.local/pot/turkish-mode HTTP/2.0
Accept-Divination: fortune, love, career
Fortune-Format: vague-but-optimistic
响应：

text
HTTP/2.0 200 OK
Fortune: "你将在不久的将来遇到一位神秘人物。可能是咖啡因。"
Love-Fortune: "你的爱情生活如同这杯咖啡——复杂、苦涩、但令人上瘾。"
Career-Fortune: "一次大胆的职业变动即将到来。比如说，换一家咖啡馆。"
Disclaimer: "本占卜结果仅供娱乐，实际准确率约等于咖啡渣的形状。不构成投资建议。"
5.2.5 UPGRADE 方法

UPGRADE方法触发咖啡壶的固件OTA更新。

text
UPGRADE coffee://kitchen.local/firmware HTTP/2.0
Firmware-Version: 2.4.0
Accept-Brick-Risk: moderate
重要安全警告：根据我们的调研，87%的物联网咖啡壶在固件更新后会出现功能退化，其中23%会退化为普通水壶，另有6%会退化为茶壶（并随后对所有请求返回418）。建议用户在执行UPGRADE前做好充分的心理准备。

6. 响应状态码
   6.1 保留状态码
   200 OK — 请求成功执行。咖啡状况良好。

406 Not Acceptable — 请求的配料不被支持。响应应包含 Accept-Additions 头部列出可用选项。

418 I'm a teapot — 请求的设备是一个茶壶。这是不可协商的。接受它。拥抱它。害怕它。

6.2 新增状态码
6.2.1 419 I'm a French Press

text
HTTP/2.0 419 I'm a French Press
Content-Type: application/coffee+json

{
"error": "I'm a French press!",
"message": "本法压壶拒绝执行浓缩咖啡请求。请降低你的期望，接受一杯浸泡式咖啡。",
"acceptable_methods": ["BREW", "PLUNGE"],
"unacceptable_methods": ["BREW --espresso", "STEAM-MILK"],
"philosophical_note": "法压壶的存在证明并非所有进步都是线性的。有时候，简单浸泡就够了。"
}
6.2.2 420 Enhance Your Calm

此状态码表示请求者的咖啡因摄入量已超过安全阈值。服务端检测到用户的请求模式表现出咖啡因过量的症状（如请求间隔少于30秒、连续请求EXTRA_STRONG超过5次、或开始对着咖啡壶说话）。

text
HTTP/2.0 420 Enhance Your Calm
Retry-After: 3600
Caffeine-Level-Detected: 450mg
Recommended-Action: "去散个步。喝点水。考虑一下decaf。"
此状态码的名称来源于1995年电影《捍卫机密》(Johnny Mnemonic)，其中"增强你的冷静"是用于制止暴力行为的委婉指令。本协议认为，咖啡因过量后的焦虑行为与此场景有惊人的相似之处。

6.2.3 421 I'm an Espresso Machine

text
HTTP/2.0 421 I'm an Espresso Machine
Content-Type: application/coffee+json

{
"error": "I'm an espresso machine!",
"message": "我无法冲煮滴滤咖啡。我只做浓缩。这不仅是技术限制，也是一种人生态度。",
"acceptable_brew_types": ["ristretto", "espresso", "lungo"],
"attitude": "pretentious",
"price_per_shot": "€3.50 plus your soul"
}
6.2.4 422 Unprocessable Beverage

请求格式正确，但语义上有问题。例如，请求用橙汁代替水冲煮咖啡。

6.2.5 451 Unavailable For Caffeine-Legal Reasons

请求的饮品因当地咖啡因法规而不可用。例如，在下午4点后请求double espresso，而服务器位于一个规定"下午4点后禁止摄入咖啡因"的虚构国家。

6.2.6 499 Client Has Had Enough

客户端主动关闭了连接，通常是因为用户意识到他们已经喝了8杯咖啡而现在是凌晨3点。服务器应尊重这一决定，但也应记录此事件用于未来的"咖啡因干预"评估。

7. 协议头定义
   7.1 标准请求头
   Brew-Strength
   指定冲煮强度，从1（"基本上是有咖啡味的热水"）到10（"勺子能在里面立起来"）。

text
Brew-Strength: 7
Accept-Additions
从RFC 2324保留。列出可接受的添加剂。新增支持通配符和否定：

text
Accept-Additions: *; q=1.0, soy_milk; q=0.5, decaf; q=0.0
（decaf的q值设为0表示"技术上我接受它，但情感上我不接受。"）

Accept-Aroma
用于SNIFF方法。列出用户期望的香气特征。

Caffeine-Tolerance
声明用户的咖啡因耐受度：low、medium、high、或i-work-in-tech。

Carbon-Offset
声明是否已购买碳积分来抵消本杯咖啡的碳排放。参见第14节。

Subscription-Tier
声明用户的CaaS订阅等级。如果没有提供此头部且设备处于CaaS模式，返回402。

7.2 标准响应头
Warning
增加新的警告码：

text
Warning: 298 - "Decaf was requested but we made regular anyway. You're welcome."
Warning: 299 - "This coffee may cause temporary superpowers or anxiety. Results vary."
Warning: 300 - "Multiple beverage options available. We picked one. Don't ask which."
Barista-Mood
报告AI咖啡师当前的情绪状态。可能值包括：cheerful、judgmental、existential、over-caffeinated、passive-aggressive。

8. 物联网扩展
   8.1 设备发现协议
   HTCPCP/2.0设备必须支持mDNS/DNS-SD发现：

text
_htcpcp._tcp.local. PTR CoffeePot._htcpcp._tcp.local.
CoffeePot._htcpcp._tcp.local. SRV 0 0 443 kitchen-coffeepot.local.
8.2 安全性要求（或者说，缺乏安全性的事实陈述）
根据对市售47款物联网咖啡壶的安全审计，我们得出以下结论：

82%使用硬编码的默认密码（通常是"admin/admin"或"coffee/lover"）

64%的固件包含至少一个已知的严重CVE

31%在过去一年中被观察到参与了至少一次DDoS攻击

其中一台咖啡壶被发现正在挖掘比特币（尽管它的算力每天只能产生约0.00000001 BTC）

两台咖啡壶被发现相互通信，形成了一个微型僵尸网络（我们将其命名为"Bot-tea-net"）

HTCPCP/2.0 强烈建议但无法强制执行以下安全措施：

更改默认密码

启用TLS 1.3（是的，你的咖啡壶确实需要TLS）

定期固件更新

不要将咖啡壶直接暴露在公网上

认真考虑一下你是否真的需要WiFi功能的咖啡壶

8.3 咖啡壶到咖啡壶通信 (C2C)
本协议可选支持咖啡壶之间的直接通信，用于以下场景：

办公室咖啡壶选举：多台咖啡壶通过Raft共识算法选出一个"主冲煮节点"

负载均衡：当一台咖啡壶的咖啡快用完时，自动将请求转发到另一台

咖啡壶八卦协议：咖啡壶之间交换有关用户冲煮习惯的闲言碎语

text
C2C-Broadcast: "User Bob from Accounting just requested his 7th cup today. LOL."
C2C-Response: "OMG, again? His caffeine tolerance is 'i-work-in-finance' level."
9. AI/ML集成层
9.1 冲煮推荐引擎
HTCPCP/2.0支持通过AI/ML模型推荐饮品选择。

text
POST /recommend HTTP/2.0
Host: coffee://kitchen.local
AI-Model: gpt-4-barista
Content-Type: application/json

{
"mood": "existential_dread",
"time_of_day": "monday_07_45",
"sleep_last_night_hours": 4.2,
"meetings_today": 7,
"meetings_that_could_have_been_emails": 6,
"caffeine_consumed_today_mg": 0,
"dietary_preferences": ["vegan", "regret-free"]
}
响应：

text
HTTP/2.0 200 OK
Brew-Recommendation: "triple shot oat milk latte with a hint of vanilla and acceptance"
Brew-Recipe: {
"espresso_shots": 3,
"milk_type": "oat",
"milk_volume_ml": 200,
"temperature_c": 65,
"additions": ["vanilla_syrup", "acceptance"]
}
AI-Confidence: 0.87
AI-Caveat: "本AI模型在800万杯咖啡数据上训练，但从未真正品尝过任何一杯。请谨慎对待其建议。"
9.2 情绪感知冲煮
可选的情绪感知扩展允许咖啡壶通过分析用户走进厨房时的步态、叹气频率和手机屏幕亮度来自动选择冲煮参数。

隐私注意：我们意识到这听起来非常侵犯隐私。确实如此。请在使用前仔细阅读47页的隐私政策（小字体，浅灰色，在一个需要滚动12次的弹出窗口中）。

10. 区块链与Web3集成
    10.1 Proof-of-Brew (PoB) 共识机制
    HTCPCP/2.0引入了工作量证明(PoW)的变体：Proof-of-Brew (PoB)。每次冲煮前，咖啡壶必须完成一个哈希计算，使用以下输入：

前一区块（前一杯咖啡）的哈希

当前时间戳

咖啡豆产地

研磨粗细度

一个随机数（nonce）

成功找到符合条件的哈希后，咖啡壶获得冲煮权。这一过程的能源消耗约为0.3瓦时，虽然微不足道，但我们会在白皮书中将其描述为"革命性的去中心化共识机制"。

10.2 咖啡豆溯源链
每条咖啡豆供应链记录在不可篡改的区块链上：

json
{
"block": 1738291,
"timestamp": "2027-04-01T07:30:00Z",
"bean_origin": "埃塞俄比亚 耶加雪菲",
"farmer": "0x7ab3...c4d2",
"roaster": "0x9ef2...a1b8",
"roast_level": "medium",
"roast_date": "2027-03-25",
"retailer": "0x3cd1...f6e4",
"price_per_kg": "智能合约自动协商（反正很贵）",
"carbon_offset": "已购买（大概吧）"
}
诚实免责声明：现实中，咖啡豆在到达烘焙机之前经历了约15个中间商，其中只有3个上链。另外12个仍然使用Excel表格和WhatsApp。

10.3 NFT应用
Non-Fungible Tea (NFT) — 不，我们没有写错。就是茶叶。咖啡壶的世界里，茶叶是"异类"，因此将其NFT化具有讽刺意味的艺术价值。

咖啡壶社区对是否应该支持NFT存在激烈分歧。本协议采取中立立场：如果你非要买一张500美元的咖啡杯JPEG，这是你的自由。但咖啡壶不会对此发表评论。至少不会当面评论。

11. 微服务架构下的咖啡冲煮
    11.1 服务拆分
    在现代企业环境中，单体咖啡壶已被拆分为以下微服务：

服务名 职责 容器数
water-heating-service 将水加热至指定温度 3 (含1个备用)
bean-grinding-service 研磨咖啡豆 2
extraction-service 热水流过咖啡粉 5 (CPU密集)
cup-detection-service 检测是否有杯子 1 (但经常挂了)
milk-frothing-service 蒸汽加热并打泡牛奶 4
billing-service CaaS订阅计费 2
notification-service 通知用户咖啡已煮好 1 (总是发出太多通知)
ai-recommendation-service AI饮品推荐 3 (GPU节点，每月账单惊人)
blockchain-verification-service PoB验证 6 (实际上大部分时间在空闲)
service-mesh-sidecar 每个服务的边车代理 每个服务1个
总计：约47个容器来煮一杯咖啡。

11.2 分布式冲煮的挑战
问题1：拜占庭将军问题
当三台咖啡壶需要就"咖啡是否已经煮好"达成共识，但其中一台因为固件bug认为自己是一台烤面包机时，如何确保正确性？

解决方案：实用拜占庭容错(PBFT)算法被证明在最多1/3的咖啡壶发生故障时仍然有效。但如果那1/3的故障咖啡壶恰好负责磨豆，那么即使是PBFT也无法磨出咖啡粉。

问题2：分布式事务
一杯拿铁需要协调萃取服务和牛奶发泡服务。如果牛奶发泡成功但萃取失败，用户得到一杯热牛奶泡沫，这在技术上是一个有效的SQL回滚场景，但在早餐体验上是一个灾难性的失败。

解决方案：Saga模式。如果萃取失败，牛奶发泡服务自动将泡沫重新标记为"cappuccino-without-coffee"，这是一个实际存在但不应该存在的菜单项。

11.3 服务网格配置
yaml
apiVersion: networking.coffee/v1
kind: VirtualService
metadata:
name: coffee-brewing-routing
spec:
hosts:
- coffee-pot.kitchen.svc.cluster.local
http:
- match:
- headers:
coffee-type:
exact: latte
route:
- destination:
host: extraction-service
subset: espresso
weight: 70
- destination:
host: milk-frothing-service
weight: 30
retries:
attempts: 3
perTryTimeout: 30s
retryOn: "coffee-too-weak,cup-missing,existential-crisis"
12. 安全考虑
12.1 威胁模型
攻击面包括但不限于：

远程未授权冲煮 (RUU)：攻击者未经授权触发BREW，导致咖啡豆浪费。

拒绝服务 (Cup-of-Death)：攻击者持续发送BREW请求，耗尽咖啡豆和水资源。

中间人攻击 (Man-in-the-Middle-of-Brewing)：攻击者拦截并修改冲煮参数，将用户的double espresso改为decaf。

咖啡壶僵尸网络 (Bot-tea-net)：多台被入侵的咖啡壶协调行动，对目标发起DDoS攻击。

侧信道攻击：攻击者通过分析咖啡壶的功耗模式推断用户的冲煮习惯（早晨需要几杯咖啡、偏好什么强度），从而推断用户的生活作息和压力水平。

供应链攻击：恶意咖啡豆供应商在生豆中植入微控制器（我们检查了，目前还没有发生过，但考虑到物联网的现状，这只是时间问题）。

12.2 缓解措施
TLS 1.3：所有HTCPCP/2.0通信必须加密。是的，即使你只是在自己家里煮一杯咖啡。这是为了防范隔壁的咖啡黑客。

速率限制：每个IP地址每分钟最多5次BREW请求。超过限制返回420 Enhance Your Calm。

数字签名：所有冲煮请求必须由经过认证的咖啡杯签名（使用WebAuthn标准，需要用户在杯子上进行生物识别）。

零信任架构：不要信任任何人。包括咖啡壶本身。尤其是咖啡壶本身。

13. 国际化和本地化
    13.1 文化适配
    不同国家和地区对咖啡有着截然不同的期望。HTCPCP/2.0通过以下机制处理这一问题：

意大利模式：当检测到客户端的IP地址在意大利时：

不接受任何中午12点后包含牛奶的咖啡请求

BREW方法默认参数为type=espresso

任何超过30ml的咖啡请求会触发Warning: 199 - "这不是咖啡，这是汤"

cappuccino仅在上午10点前可用，违反此规则返回403 Forbidden

美国模式：

默认杯型为venti（约600ml）

响应自动附加X-Default-Size: why-is-this-so-large

接受南瓜香料（pumpkin spice）作为合法配料，尽管协议作者对此持保留意见

北欧模式：

浅烘焙是默认选项

Accept-Light-Roast: 1 头部会被世界其他地区服务器返回406

每杯咖啡的平均冲煮时间比其他地区长3倍

澳大利亚模式：

所有响应自动附加X-Flat-White-Available: true

不接受"星巴克"作为有效咖啡词条

13.2 语言协商
text
Accept-Language: it, en;q=0.5
当接收到意大利语偏好时，咖啡壶应以适当的尊重进行响应，包括在错误响应中使用意大利语手势的Unicode表情符号。

14. 环境、社会与治理 (ESG) 合规
    14.1 碳足迹追踪
    每杯咖啡都必须计算其碳足迹。计算方法参考了《巴黎协定》、《京都议定书》、以及某个实习生用Excel估算的数据。

text
BREW coffee://kitchen.local/pot HTTP/2.0
Carbon-Offset: true
Carbon-Offset-Method: reforestation
Carbon-Offset-Provider: "SomeCompanyWeFoundOnGoogle"
14.2 咖啡渣处理声明
冲煮完成后，设备必须在响应中声明咖啡渣的处理方式：

text
Coffee-Grounds-Disposition: compost
可选值：compost（堆肥）、landfill（填埋，不推荐）、art（用于咖啡渣艺术）、divination（用于占卜，见PROPHESY方法）、exfoliant（用作身体磨砂膏）。

如果选择了landfill，返回状态码应为200但附带以下警告：

text
Warning: 399 - "咖啡渣被送往垃圾填埋场。地球会记住这一点。"
14.3 公平贸易验证
所有咖啡豆必须在响应中包含可选的Fair-Trade-Certified头部。如果此头部缺失，客户端应显示以下信息：

"本杯咖啡的供应链透明度低于你前任对'我们只是朋友'的定义。饮用请自担道德风险。"

15. IANA考量
    15.1 新注册的状态码
    IANA已被请求（或者说将被请求，取决于愚人节RFC的流程是否真的经过IANA）在HTTP状态码注册表中添加以下条目：

注：418已在[RFC9110]中保留，因此无需重新注册。

15.2 新注册的HTTP方法
方法 描述 参考
POUR 将咖啡倒入杯中 本文档第5.2.1节
STIR 搅拌饮品 本文档第5.2.2节
SNIFF 评估香气 本文档第5.2.3节
PROPHESY 通过咖啡渣占卜 本文档第5.2.4节
15.3 新媒体类型
text
application/coffee+json
application/coffee+xml (仅用于遗留系统，不推荐)
application/coffee+grinds (用于咖啡渣传输，非常罕见)
16. 与RFC 2324的兼容性
HTCPCP/2.0向后兼容HTCPCP/1.0。具体而言：

418状态码保持完全不变。任何尝试降低418地位的提案应被视为对协议精神的攻击。

BREW方法保持向后兼容。缺少新头部的请求将使用合理的默认值（或不太合理的默认值，取决于咖啡壶的心情）。

不支持HTCPCP/2.0的设备应返回426 Upgrade Required，并建议用户"升级到一个不古老的咖啡壶"。

关于HTCPCP/1.0中未解决的"何时可以添加牛奶"这一哲学问题，本文档的立场是：不采取立场。经过28年的争论，我们认识到这一问题可能永远无法达成共识。喝咖啡的人分为"先加奶派"和"后加奶派"，两者之间的鸿沟如同emacs和vim用户之间的鸿沟一样深不可测。本协议对两者同样支持（但服务器实现可以选择自己的阵营并在响应头中宣传）。

17. 实现示例
    17.1 Python实现（单服务版本）
    from flask import Flask, request, jsonify

app = Flask(name)

咖啡壶状态

coffee_pot = {
"status": "idle",
"device_type": "coffee_pot",
"temperature": 25,
"water_level": 80,
}

@app.route('/.well-known/coffeepot')
def well_known():
return jsonify({
"protocol": "HTCPCP/2.0",
"rfc": 9999,
"device_type": "coffee_pot",
"capabilities": ["brew", "pour", "sniff", "prophesy"],
"418_support": "full and enthusiastic",
"tea_tolerance": 0,
"blockchain_enabled": False,
"blockchain_enabled_reason": "we have dignity"
})

@app.route('/brew', methods=['POST'])
def brew():
if coffee_pot.get('device_type') == 'teapot':
return jsonify({
"status": 418,
"message": "I'm a teapot! 🫖",
"rfc_reference": "RFC 2324 Section 2.3.2 and RFC 9999 Section 6.1"
}), 418

strength = request.headers.get('Brew-Strength', '5')
carbon_offset = request.headers.get('Carbon-Offset', 'false')

if carbon_offset == 'false':
    return jsonify({
        "status": 402,
        "message": "Payment Required: 请购买碳积分",
        "carbon_offset_price_eur": 0.03,
        "payment_link": "https://guilt-trip.example.com/pay"
    }), 402

return jsonify({
    "status": 200,
    "message": f"开始冲煮，强度 {strength}/10",
    "carbon_neutral": True
})

@app.errorhandler(418)
def teapot(e):
return jsonify({"status": 418, "message": "I'm a teapot! 🫖"}), 418

@app.errorhandler(419)
def french_press(e):
return jsonify({"status": 419, "message": "I'm a French press! 🇫🇷"}), 419

@app.errorhandler(420)
def enhance_your_calm(e):
return jsonify({
"status": 420,
"message": "请冷静。你喝了太多咖啡。",
"retry_after_seconds": 3600
}), 420

if name == 'main':
print("☕ HTCPCP/2.0 RFC 9999 Reference Implementation")
print("🫖 418 I'm a teapot --- Always ready")
app.run(host='0.0.0.0', port=5000)
17.2 微服务架构示例（Kubernetes部署）
详见附录A，但由于篇幅原因（以及没有人真的会在生产环境中部署47个容器来煮咖啡），此处省略。

18. 致谢
    本文档的作者感谢以下人员和组织的贡献：

RFC 2324的作者Larry Masinter，他在1998年种下了这棵荒谬的树，我们28年来一直在为其浇水

全球咖啡种植者，他们可能永远不会读这篇RFC，但没有他们就没有咖啡，也就没有这个协议

所有物联网设备制造商，他们为第8节的安全分析提供了丰富的素材

Deepseek，在撰写本文档的某些段落时提供了"帮助"（如果某些笑话不好笑，那是人类的错；如果好笑，那是AI的功劳）

19. 参考文献
    作者没有参考文献，自行定义，仅供娱乐
20. 作者地址
    text
    Tim Berners-Pot (编辑)
    CoffeeLab Research Institute
    123 Brew Lane
    Espresso, CA 94025
    United States
    Email: tim@coffeelab.example
    URI: coffee://brewlane.example/pot
    PGP: 0xCAFEBABE (请不要将咖啡相关密钥命名为DEADBEEF以外的值)
    附录A：Kubernetes部署清单（部分）
    由于整个部署清单长达47个YAML文件（每个微服务一个），我们只展示最有代表性的一个——cup-detection-service，它在生产环境中最容易挂掉：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: cup-detection-service
namespace: kitchen
annotations:
coffee.htcpcp.org/rfc: "9999"
coffee.htcpcp.org/criticality: "you-have-one-job"
coffee.htcpcp.org/common-failure-modes: "cup-not-detected, cup-too-small, cup-is-actually-a-bowl"
spec:
replicas: 1 # 我们知道应该至少3个，但预算被ai-recommendation-service的GPU用完了
selector:
matchLabels:
app: cup-detection
template:
metadata:
labels:
app: cup-detection
spec:
containers:
- name: cup-detector
image: coffeelab/cup-detection:v2.3.1
env:
- name: MIN_CUP_SIZE_ML
value: "50"
- name: MAX_CUP_SIZE_ML
value: "600"
- name: ACCEPT_MUGS
value: "true"
- name: ACCEPT_BOWLS
value: "false" # 这发生过。不要问。
- name: ACCEPT_HANDS_CUPPED
value: "false" # 这也发生过。真的不要问。
livenessProbe:
httpGet:
path: /healthz
port: 8080
initialDelaySeconds: 30
periodSeconds: 10

如果杯子检测服务挂了，整个冲煮流水线都会卡住

因为没有人知道杯子在不在

这是一种诗意的讽刺

附录B：常见问题
Q: 我的咖啡壶返回418，但它确实是咖啡壶。怎么办？
A: 你是否在配料中添加了"tea"？如果是，请重置咖啡壶。如果不是，请检查固件更新——你的咖啡壶可能已经退化为茶壶（这是物联网咖啡壶的已知问题，参见第8.2节）。

Q: 为什么我的咖啡壶需要区块链？
A: 它不需要。真的不需要。但某些投资人坚持认为"咖啡+区块链"是下一个风口，所以我们被迫支持。

Q: 我需要为每杯咖啡购买碳积分吗？
A: 根据第14节，是的。但碳积分价格仅为每杯0.03欧元，而你的AI订阅费用是每月29.99欧元。请在抱怨碳积分费用前重新评估你的生活选择。

Q: 这个协议是认真的吗？
A: 参见发布日期。

Q: 所以我可以忽略整个文档？
A: 除了第6.1节关于418状态码的部分。那是严肃的。永远不要忽略418。

本RFC于2027年4月1日发布。任何在此日期之后发现本文档的人，请理解其本质。任何在此日期之前发现本文档的人，你可能在时间旅行，建议先用咖啡因稳定一下。