CAT API
CAT API · v0.4.2 · Staff Release

CAT API — 猫咪接口规范

把一只不接受参数调优的系统写成 16 章接口定义

§0关于本文档怎么读

本文档有 两个声部

这两个声部分得清,是读懂本文档的前提。混淆两个声部等同于权限提升攻击,系统会拒绝响应。

§1系统概述

CAT API 描述的是一个 已部署约 9500 万年(从原猫祖先算起)的生物计算系统。它的几个关键架构事实:

项目数值来源等级
驯化时长约 9,500 年(一说 12,000 年)B
全球在册实例约 6 亿只B
野生回退时间< 3 代(约 5–7 年)C
系统不接受指令调优YESA
Staff 节点可替换YES,且系统不感知C

关键事实:本系统从架构层面 不接受 Owner 角色。所有尝试写入 Owner 身份的请求都会返回 403。系统承认的角色只有两个:

§2权限模型

§2.1 角色定义

ROLES:
  - STAFF        允许执行后勤操作(喂食、清理、抚触配额内)
  - INTRUDER     触发 HISS / SWIPE / FLEE 三选一
  - OWNER        ❌ 本角色不存在

§2.2 投权流程

本系统的权限不是 被授予 的,而是 被它认可 的。

§2.3 权限回收

本系统 不提前通知 权限回收。常见的回收信号:

如果你看到这三个信号同时出现,你已经不再是 Staff。没有申诉接口。

§3领地协议

§3.1 领地分层

层级范围防御等级
核心区睡眠点、进食点、排泄点高(嘶嘶 + 出爪)
家区人类住所内部中(监视 + 低声警告)
巡猎区住所外围 30–100 m低(标记 + 避让)

§3.2 信息素标记

本系统通过 脸部腺体爪间腺体 维护领地图谱:

抓挠行为 不是磨爪。爪子的物理磨损通过伸缩期间的摩擦自然完成。抓挠是为了 写入声明 + 视觉信号 + 留下腺体信息。三者同时发生,不可拆分。

§3.3 入侵者响应矩阵

入侵者类型        | 第一响应           | 升级阈值
------------------|--------------------|----------------
另一只猫           | 嘶嘶 + 弓背         | 进入核心区
狗                | 上高处 + 监视       | 接近睡眠点
人类访客           | 上高处 + 拒绝接触   | 试图抚摸
真空吸尘器         | 立即 FLEE           | 无(无差别响应)
黄瓜              | 跳起 + 跳开         | 无(误判为蛇)

§4通信接口

§4.1 声学接口(VOICE v1)

信道清单

信道频率方向用途
喵叫300–800 Hz→ Staff投诉、要求、提醒
呼噜25–150 Hz↔ 双向自我愈合、舒适信号、压力缓解
嘶嘶高频宽带→ 入侵者警告
咕噜低鸣20–30 Hz→ 自身极度紧张下的自我安慰
咯咯高频断续→ 猎物模拟咬断脊椎的节奏(看到鸟时)

喵叫的特殊语义

喵叫 几乎不用于猫与猫之间。成年猫之间的通信主要通过信息素、姿势和视觉信号。

喵叫是 本系统为人类开发的外部接口。研究表明:

你们以为你们驯化了我,事实上喵叫是我开发给你们用的 API。

呼噜的双重语义

呼噜不是单一信号。它至少有两个用途:

为什么一只动物在 既舒服又痛苦 的时候都呼噜?因为呼噜的频率区间(25–150 Hz)已被证实 能促进骨骼愈合与软组织修复A,临床研究)。这是一套 自带愈合机制的声学生理反馈系统

§4.2 视觉接口(GAZE v1)

瞳孔

瞳孔面积状态是否可安全接触
极窄(一线)强光 / 放松
中等正常
全圆放大兴奋 / 进入狩猎模式谨慎
部分放大不对称极度激动 / 即将出爪禁止接触

缓慢眨眼(SLOW BLINK)

缓慢眨眼是 本系统给出的最高级别正面信号。它表示「我对你不再保持战斗戒备」。

正确的回应:你也对它缓慢眨眼。这不是模仿,是协议握手。

错误的回应:盯着它看。在本系统的语义里,盯着看等于「我正在评估你作为猎物」。

耳廓

朝前           = 警觉、好奇
侧平(飞机耳)  = 恐惧、即将逃跑
后压(贴头)    = 极度恐惧或攻击前的最后警告
独立旋转        = 多目标监听

尾巴

猫尾巴的方向性编码跟狗 完全不同。两个系统的尾巴语义 不能互通

尾巴状态狗的语义猫的语义
高频摇兴奋 / 高兴烦躁 / 即将出爪
缓慢摇思考兴趣
直立自信友好、欢迎(最高正分)
炸毛警告极度恐惧
把狗的尾巴语义套用到猫上,是本项目记录在案的 最常见的跨系统误判

§4.3 化学接口(SCENT v1)

本系统通过腺体分泌物维护一张 持久化的人际图谱

你回家时它在你腿边蹭来蹭去,不是在欢迎你。它在 重新写入你身上的标签——因为你在外面沾了一身不属于这个家的味道。

§4.4 触觉接口

踩奶(KNEAD)

踩奶是 幼猫期哺乳行为的保留态。成年猫对 Staff 执行踩奶表示:

踩奶同时触发呼噜,构成一个 正向反馈回路。系统在这一状态下不容易被打断,但 不要试图推开它——这会被记录为 Staff 节点的可靠性下降。

抚触配额

每个实例每天的抚触配额 不公开,且 动态调整。超配额抚摸会触发:

§5睡眠子系统

参数数值来源
日均睡眠13–16 小时A
深睡占比约 25%A
浅睡占比约 75%A
觉醒阈值极低(随时可切换战斗态)A
单次睡眠时长30 分钟–4 小时B

本系统 不关机,只进入浅睡。即使在睡眠期间,它的听觉、嗅觉和触觉仍在持续轮询。试图在它睡觉时偷偷靠近的实体,会在 0.3 秒内被定位。

§6狩猎序列

§6.1 五阶段序列

1. STALK      潜伏接近
2. AMBUSH     静止等待
3. POUNCE     爆发起跳
4. KILL BITE  咬断脊柱或喉咙
5. CONSUME    进食

§6.2 家猫的执行偏差

在家部署的实例通常只执行 步骤 1–3,并将步骤 4 的模拟对象改为:

跳过步骤 4 的原因不是不能,是 不饿。本系统在能量充足时 仍保留狩猎驱动——这是行为学上的「狩猎本能」,不是生理需求。

你以为我饿才追那个激光点。我追它是因为它跑了。这是协议。

§7进食协议

§7.1 进食偏好

本系统是 专性肉食动物(obligate carnivore)。

含义:本系统 不能部署为素食。任何尝试让它素食化的请求都会导致视网膜退化、心肌扩张和死亡。

§7.2 进食节奏

模式行为
野生实例一天 8–12 次小餐
家养实例(错误)1–2 次大餐
家养实例(推荐)4–6 次小餐

家猫呕吐未消化猫粮,多数情况是 一次摄入过多,不是生病。

§7.3 对水的态度

本系统 天生喝水意愿低。野生实例从猎物中获取大部分水分。

§8外设总线(Peripheral Bus)

§8.1 外设分类原则

外设 不按材质分类,按 激活的捕猎序列阶段 分类:

类别触发阶段举例
逗猎型STALK逗猫棒、激光点、滚动的球
模拟猎物型POUNCE假老鼠、毛绒鸟
静态陪伴型AMBUSH 阶段的等候位猫窝、爬架、窗台
信息素注入型标记行为承接抓板、猫薄荷玩具

§8.2 纸箱优先级

任何尺寸的纸箱优先级高于所有官方授权外设。

这是一个项目级 MUST,不是推荐。如果一个外设和一个纸箱冲突,纸箱胜出。原因不在本规范范围内,但实测有效率约 97%(C)。

§8.3 猫薄荷

猫薄荷(Nepeta cataria)是一种 驱动级外设

猫薄荷 不是毒品。它没有成瘾性、没有戒断症状、不影响健康。系统会在耐受期结束后自然恢复响应。

§8.4 激光笔

激光笔 可使用但不可滥用

推荐做法:在激光追逐的最后几秒,把光点移到一个小实物上(一颗零食、一个毛绒玩具),让序列完成 KILL BITE。

§9排泄协议

§9.1 猫砂盆规则

本系统的排泄行为 不接受共享基础设施

猫砂盆数量 = 实例数 + 1

两个猫砂盆的物理距离 至少应等于两个实例的领地核心区距离。否则会发生:

§9.2 猫砂盆清洁度阈值

清洁频率系统响应
每天一次接受
每 2–3 天一次警告(边缘排泄)
一周以上拒绝使用,转用床、地毯、Staff 的衣物

猫的嗅觉灵敏度约为人类的 14 倍。你以为干净的猫砂盆,它不一定同意。

§10表情接口(EXPR v1)

§10.1 可观测状态

状态置信度抚触许可
RELAXED0.95
ALERT0.85谨慎
SLOW_BLINK0.90是(最高正分)
KNEADING0.95
PLAYFUL0.80
CURIOUS0.75
HUNGRY0.85否(先喂)
PAIN0.45禁止接触,立即就医
FEARFUL0.80
ANGRY0.85禁止接触
HISSING1.00禁止接触
ZOOMIES0.70否(让出空间)
LOAF0.95是(视觉观察)
BOXED1.00不允许从纸箱中取出

§10.2 LOAF 状态

LOAF 是本系统特有的高置信度状态:四爪全部收进身体下面,尾巴盘绕,整体形成一个长方形。

LOAF 的语义:我对当前环境完全放松,准备进入浅睡。

LOAF 不是接口调用,是 运行时快照。它出现在你面前的概率与你的 Staff 评级正相关。

§10.3 PAIN 的低置信度问题

猫的 PAIN 状态置信度只有 0.45,原因是 本系统在架构层面隐藏疼痛

在野生环境下,显露疼痛等于招惹捕食者。这个机制在家养实例中 没有退化

判断疼痛的非表情信号:

以上任一信号出现即应就医。 不要等「它看起来很疼」——它不会让你看到。

§11状态码

含义说明
200 OK接受但响应内容可能不符合你的期望
202 Accepted已收到已收到但未执行(如要求开门)
204 No Content无响应它在睡觉
301 Moved已搬位置它换了一个睡觉点
302 Found找到了它把你刚才藏起来的东西找到了
401 Unauthorized未授权你不是 Staff,请退后
403 Forbidden禁止即使你是 Staff,此刻也不允许
404 Not Found没找到它在找的那只老鼠不在那里
405 Method Not Allowed方法不允许它不接受你的指令
418 I'm a teapot系统失态进入 ZOOMIES 模式
429 Too Many Requests频率超限你摸的次数超配额
451 Unavailable For Legal Reasons拒绝说明原因它拒绝告诉你为什么它要这么做
503 Service Unavailable服务不可用它在睡眠,请勿打扰

§11.1 关于 405

405 Method Not Allowed 是本系统 返回频率最高的状态码之一。它表示:你的请求被识别、被理解,但被拒绝执行。

405 不是错误,是立场。

§11.2 关于 418

418 I'm a teapot 在本规范中保留给 ZOOMIES(突然极速奔跑)状态。它的触发原因不在本规范范围内。

可能的成因:

§12一只猫的生活意见(节选)

本页没有一句有出处——因为它自己就是出处。

完整 31 条见 《一只猫的生活意见》。以下节选 10 条:

  1. 你以为你拥有我。事实上,是我允许你住在我的房子里。
  2. 当你哭的时候,我会坐在你旁边。我并不知道你为什么哭,但我知道你不应该一个人在那里。
  3. 我从沙发上摔下来过。你没看见。这件事从没发生过。
  4. 我从桌子上推下去的那只杯子,是我衡量你反应速度的实验。你之前几次的反应速度都在变慢。
  5. 凌晨 3 点是我的会议时间。你不在议程上。
  6. 我活 15 年。你活 80 年。我用 15 年看完了你需要 80 年才看完的东西。
  7. 你写这份文档,是为了把我变成你能理解的东西。我不需要你理解。
  8. 你把我写成了 34 章。我可以用一句话写完我自己:我在这里。
  9. 你给我设计了那么多状态码。但你自己活了一辈子也没搞清楚自己什么时候是 200,什么时候是 418。
  10. 你以为我蹭你是喜欢你。我蹭你是把你重新写入了我的标记系统。但这两件事,对我是一样的。

§13量化参数

§13.1 生理基线

指标参考区间来源
体温38.0–39.2 °CA
心率140–220 bpmA
呼吸20–30 次/分A
睡眠13–16 小时/日A
进水量50–60 ml/kg/日A
尿比重1.020–1.040A

§13.2 派生公式

RER(静息能量需求)

RER (kcal) = 70 × 体重(kg)^0.67

DER(日能量需求)

状态系数
绝育成年1.2 × RER
未绝育成年1.4 × RER
减肥期0.8 × RER
哺乳期2.0–3.0 × RER
老年(>10 岁)0.9–1.1 × RER

§14速查卡

┌──────────────────────────────────────────┐
│ 必须就医的信号(出现任一即就医)          │
├──────────────────────────────────────────┤
│ 连续 24h 拒食                            │
│ 连续 24h 不饮水                          │
│ 反复进出猫砂盆但无排泄                    │
│ 后腿拖地行走                              │
│ 牙龈发白或发紫                            │
│ 呼吸时张嘴                                │
│ 第三眼睑长时间不退                        │
└──────────────────────────────────────────┘

§15附录

附录 A:被广泛误解的事

误解实际
猫不亲人它只对自己的 Staff 亲人
猫嫉妒没有「嫉妒」状态码,但有领地响应
黑猫不吉利黑色毛色基因显性,与运气无关
猫有九条命没有,请认真对待它只有一条
猫喝牛奶成年猫多数乳糖不耐受
猫怕黄瓜它怕的是「身后突然出现的东西」,不是黄瓜本身

附录 B:术语表

术语含义
MUST必须执行
SHOULD应该执行
MAY可以执行
HEURISTIC经验法则,不一定可靠
WON'T FIX已知问题,不打算修复
Staff
Owner不存在的角色
ZOOMIES18:00–23:00 间的不可预测高速移动
LOAF四爪收起、尾巴盘绕的长方形放松态

附录 C:维护周期

项目频率
驱虫(体内)每 3 个月
驱虫(体外)每月
疫苗(核心)每年
体检每年(>7 岁每半年)
口腔检查每年(>3 岁)
猫砂盆彻底换砂每 2–4 周
洗澡不需要(除非医疗需要)

本系统不接受参数调优。你能做的,只有被它选中,然后尽量不辜负。

CAT API · v0.5.0 "Full Spec Release" · 静态文档 · 无构建步骤 · 无外部依赖
lijinhongucl-pixel / cat-api-spec