CAT API / 状态:持续 Revising

CAT API — 猫咪接口规范

本项目用同一套工程文体处理一种已经大规模部署、 却始终不接受参数调优的系统:。区别在于,这次我们把权限模型写反了—— 系统从架构层面否认 Owner 角色的存在。

阅读 CAT API → GitHub 表情渲染器 表情联系表 量化评估器 外设控制台 SDK 控制台 一只猫的生活意见 生理速查 图表图鉴 领养组件 速查卡 错误码对照 历史版本 抚摸路径规划器 健康检查面板 九条命燃尽图 门谈判游戏 猫语翻译器 猫的 404 日志 Breaking Changes 猫砂盆审计 360° 猫档案 3AM 编辑部 跳跃判定器 24h 作息热力 猫的日记
16
CAT 正文章节
3
附录(A–C)
13
状态码
14
表情状态
4
通信接口(声/视/化/触)
31
当事猫意见
0
Owner 角色定义
1
Staff 角色(你)
规范文档
正典条目

CAT API — 猫咪接口规范

权限模型反转、领地三层协议、喵叫的双声部语义、呼噜的自愈频率、纸箱优先级 MUST、凌晨三点会议时间,以及一份从架构层面否定 Owner 角色的接口定义。

16 章 + 附录 A–C · 31 条当事猫意见
OpenAPI 3.1 · 机器可读

CAT API OpenAPI 描述

所有端点的 OpenAPI 3.1 描述:state / pet / treat / laser / territory / vacuum / box / schedule / health / bath / quota / expression。喂给 Swagger UI 即可直接调试。

spec/openapi.yaml · 12 个端点
OpenAPI 3.1 · 量化派生

量化指标 OpenAPI

RER / DER / 饮水量 / DNS / HRI / VSI / 免疫 / 寄生虫 / 分诊的 OpenAPI 描述。含 422 短路语义——某些查询在客户端就能算完,不该往服务端发。

spec/quantified-api.yaml · 9 个量化端点
声部
定义口径

口吻与文体

这份文档有两个人说话:规范编写组给事实与出处,当事猫给结论与立场。混淆两个声部等同于权限提升攻击,系统会拒绝响应。

REFERENCE / VOICE
第二声部

一只猫的生活意见

31 条意见分五组:关于人、关于自己、关于食物、关于时间,以及关于这份规范。本页没有一句有出处——因为它自己就是出处。

REFERENCE / OPINIONS · 31 条
表情
可运行 · 逐像素确定性

表情渲染器

14 个可观测状态、13 维参数向量、实时 SVG 渲染。拖滑块改耳朵角度、瞳孔面积、炸毛指数和呼噜频率,看它变脸。两个状态混合时权重不够会被拒绝。

tools/expression.html · 引擎 assets/js/expression.js
14 帧一次平铺

表情联系表

14 帧一次性平铺,每格附置信度与「它与基线差在哪一行」。带橙边的 PAIN 没有专属参数——那不是漏了,那是架构级缺陷。

tools/expression-sheet.html · 由引擎实时渲染
§10 正文

表情接口定义(EXPR v1)

为什么猫的尾巴语义跟狗完全相反、为什么写操作一律 405、为什么 PAIN 状态的置信度只有 0.45——以及为什么它看起来和 RELAXED 一模一样。

13 维向量 · 14 状态 · 6 端点 · 7 状态码
量化
可运行 · 算真数

量化评估器

填入体重、阶段、环境与当日行为,实时算出 RER/DER、DNS 五维达成度、热风险指数、就诊应激指数、免疫排程与分诊等级。参数直接读引擎,可复制 JSON 输出。

tools/quantifier.html · 引擎 assets/js/quantify.js
一页查完 · 可打印

生理指标速查

体温、心率、呼吸、CRT、皮肤回弹、血压、BCS 的参考区间与家庭测量方法,附「什么时候该去医院」的 P0/P1/P2/P3 分档。

reference/vitals.html · 8 项 A 级指标
权限
§2 正文

权限模型

本系统承认的角色只有两个:Staff 和入侵者。Owner 不存在。被选中的判据不公开,选中后通过脸部摩擦写入信息素签名,有效期 7–14 天。

§2 权限模型 · 无申诉接口
§3 正文

领地协议

核心区、家区、巡猎区三层防御。信息素标记不是磨爪,是写入声明。真空吸尘器触发无条件 FLEE,黄瓜被误判为蛇。

§3 领地协议 · 入侵者响应矩阵
通信
§4.1 声学

VOICE v1 — 声学接口

喵叫几乎不用于猫与猫之间——它是猫为人类开发的外部接口。呼噜有双重语义:25Hz 是舒适,100–150Hz 是自愈。频率区间被证实能促进骨骼愈合。

5 信道 · 来源等级 A
§4.2 视觉

GAZE v1 — 视觉接口

缓慢眨眼是系统给出的最高正面信号。盯着看等于「我正在评估你作为猎物」。猫的尾巴语义跟狗完全相反,不能互通。

瞳孔 · 眨眼 · 耳廓 · 尾巴
§4.3 化学

SCENT v1 — 化学接口

四组腺体维护一张持久化的人际图谱。你回家时它蹭你不是欢迎你,是重新写入你身上的标签——因为你在外面沾了一身不属于这个家的味道。

颞腺 · 口周 · 爪间 · 肛腺
§4.4 触觉

触觉接口

踩奶是幼猫期哺乳行为的保留态,表示系统进入了幼态安全模式。每天的抚触配额不公开、动态调整,超配额会直接出爪——没有第三次警告。

踩奶 · 抚触配额 · 出爪阈值
外设
可运行 · 算真数

外设控制台

填入体重、活动等级与一份外设清单,实时产出狩猎序列闭合检查、纸箱 MUST 判定、激光笔滥用警告、逐设备门槛判定与健康评分。14 类设备、13 道门槛全部来自内核。

tools/peripherals.html · 引擎 assets/js/peripherals.js
§8 正文

外设总线(Peripheral Bus)

外设不按材质分类,按激活的捕猎序列阶段分类。纸箱的优先级高于所有官方授权外设——这是项目级 MUST。激光笔可用但不可滥用,因为它让狩猎序列永不闭合。

4 类 · 纸箱 MUST · 激光笔警告
开发者
可运行 · 纯模拟

SDK 控制台

点击即可"调用"任一接口,观察返回码与话术。纯模拟,零网络请求,零数据收集。试试连点两次 POST /api/bath。

sdk/demo.html · 内核 sdk/cat-api-client.js
手绘 SVG · 灰阶

图表图鉴

基于真实量化引擎与表情引擎产出的数据,手工绘制的 19 张灰阶图:状态分布、DER 曲线、DNS 雷达、置信度对照、年龄热力、表情参数矩阵。打印不耗墨。

tools/charts.html · 引擎 assets/js/charts.js
领养即安装

领养组件

填入你的名字,生成一行 curl 安装命令。本系统不返回 401,所以那张牌不是通行证——是来源标注。

tools/adoption.html
新玩法
可运行 · 交互式

抚摸路径规划器

点选猫侧身八个区域,规划你的抚摸路径。每个区域有不同风险等级与响应码(200/202/405/403)。系统实时打分,S 到 F 八档评价。

tools/petting-router.html
Statuspage 风 · 模拟

API 健康检查面板

12 个子系统的实时状态面板(PURR/VOMIT/APPETITE/SLEEP/TERRITORY/HUNT/GROOM/LITTERBOX/BOX/ZOOMIES/COMM/AFFECTION)。含 30 天 uptime 条与近 7 次事件记录。

tools/health-check.html
燃尽图 · 可交互

九条命燃尽图

14 天 sprint、9 条命的消耗轨迹。手绘 SVG 燃尽图、九命点阵、每次失命的事后复盘卡(P0/P1)。可手动追加随机事件。

tools/nine-lives.html
可运行 · 游戏

不让猫进的那扇门

五轮谈判游戏。猫的策略每轮升级(抓门→嚎叫→伸爪→假装离开→突然折返),你的耐心在流失。能撑过五轮就算你赢。

tools/door-negotiator.html
可运行 · 模拟翻译

猫语翻译器

模拟录音分析九种意图(food_demand / attention_seek / door_negotiate / play_request / territory_alert / zoomies_trigger / null_demand / box_request),输出结构化 JSON。遇到 503 NO_AUDIO 与 429 RATE_LIMITED 是彩蛋。

tools/meow-decoder.html
终端日志 · 实时追加

猫的 404 日志

当事猫视角的 4xx 访问日志流。每条请求都是它想去但被系统判定不存在的端点——「外面」「金枪鱼刺身」「Owner」全部 404。支持过滤、搜索、复制 JSON。

tools/cat-404.html
变更日志 · 猫本位

Breaking Changes

当事猫单方面决定的破坏性变更时间线:午睡从 14h 改 18h、Owner 角色从 undefined 升级为禁止定义、纸箱优先级从 MUST 升到 MUST_NOT_REMOVE。每条变更都附当事猫的审核意见,回滚请求状态恒为「不受理」。

tools/breaking-changes.html · 15 条变更
审计日志 · 终端风

猫砂盆审计日志

LITTERBOX I/O 全部入档:每次访问的停留时间、产出评级(A+ 到 F)、覆盖合规性检查、Staff 清理操作共享同一张表。每 20 秒自动追加新记录。

tools/litterbox.html
六维雷达 · 季度环比

360° 猫档案

当事猫自评版综合评估:优雅度 / 破坏力 / 食物动机 / 粘人度 / 夜间活跃 / 自理能力。手绘 SVG 雷达图 + QoQ 季度环比 + 关键事件清单。

tools/cat-review.html
可运行 · 限时游戏

3AM 编辑部

凌晨三点,你是一只猫的值班主编。8 轮突发新闻,每条 20 秒处理窗口。推送、毙稿还是等一等——当事猫给你的评分取决于选稿灵敏度。

tools/3am-newsroom.html
生物力学 · 计算器

跳跃判定器

输入猫的体重、体长、后腿长与目标高度,实时判定能不能跳上去。公式基于猫的解剖学(体长 × 5.5 × 年龄 × 体重修正)。配可视化弹跳弧线。

tools/can-jump.html
一周 × 24 小时 · 矩阵

24h 作息热力图

7×24 活动强度热力矩阵:深度睡眠到 ZOOMIES 五档配色。猫是晨昏性动物——最活跃的不是你以为的白天。hover 单元格查看详情。

tools/heatmap-24h.html
实时生长 · 当事猫亲笔

猫的日记

当事猫的私人记录。基于真实时间自动生长——凌晨三点记录跑酷心得,早上七点吐槽肚子饿,下午两点记录阳光里深度睡眠的体验。每天 8-12 条,含心理活动(斜体标注的那些它不愿意说出口的部分)。可翻阅历史日期。

tools/cat-diary.html
参考
一页看完

速查卡

接口清单、RER/DER 公式、领地分层、状态码速查、必须就医指标。含三条最常被忽略的 MUST。可打印。

REFERENCE / CHEATSHEET
逐条对照

状态码对照

13 个状态码逐条对照:哪些是它拒绝执行、哪些是它给你开发的接口、哪些是它在凌晨三点开的会议。

13 个状态码
公共约定

术语表

符号约定、规范强度(MUST / SHOULD / MAY / HEURISTIC / WON'T FIX)、Staff 与 Owner 的边界、ZOOMIES 的定义。

符号 · 强度 · 约定
v0.1 → v0.5.0

历史版本

从单文件 v0.1 到当前 16 章正典 + 8 个工具页面的完整变更轴。每一版都写了什么、砍了什么、为什么砍。

versions.html · 5 个里程碑
逐条记录

变更日志

每个版本的完整提交记录与破坏性变更标注。附贡献指南——所有 PR 都会被当事猫过一遍。

docs/CHANGELOG.md · docs/CONTRIBUTING.md
怎么读这套东西

它表面上是一份玩笑文档,实际上每一章的参数都有出处。文体是故意的:把「猫」写成「系统」之后, 那些我们习以为常的事就显出了原来的形状。 比如:某个系统从架构层面否认你拥有它;某个系统为你专门开发了一套叫「喵叫」的外部接口; 以及,某个系统在你哭的时候坐在你旁边——它不知道你为什么哭,但它知道你不应该一个人在那里。

这份文档有两个人说话:规范编写组给事实,当事猫给结论。 后者的声部收录在 《一只猫的生活意见》 里。

CAT API · 静态站点,无构建步骤,无外部依赖 · 打开 index.html 即可阅读
v0.5.0 "Full Spec Release"
lijinhongucl-pixel / cat-api-spec