CAT API · v0.6.0 16 章 · 27 状态 · 31 条当事猫意见 静态站点 · 无构建步骤
CAT API · v0.6.0 FULL SPEC

把猫写成系统。 把系统写成猫。

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

01
16
章节
02
27
状态
03
31
猫意见
CAT API 设计者肖像
CAT API · 设计者
疯跑 02:00 进食 06:00 理毛 09:00 睡觉 13:00 巡逻 17:00 玩耍 20:00 z z z EAT
猫是一个 不接受参数调优 的状态机。正在初始化

项目介绍视频

七十一秒,把这套东西讲一遍:状态机怎么转、表情渲染器怎么画、3D 赛博遛猫怎么走。 视频在 B 站,点击直接播。

播放器由 B 站提供 · 去 B 站看原片 →

CAT RUNTIME · v1.0.0

任务跑完了,总得有谁告诉你一声。

把这份规范跑起来。一只真的会累、会闷、会记住你作息的猫, 接进 WorkBuddy、Codex、Claude Code,或者干脆只是你终端里的一条命令。 活干完了它抬头报一句,卡住了它叫你,失败的时候它趴你旁边不吭声。

看它动 → catctl run -- npm test
32 个入口按类别分组 · 正典正文 + 两份 OpenAPI 机器可读描述
正典 · 主入口

CAT API — 猫咪接口规范

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

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

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 / 免疫 / 寄生虫 / 分诊。含 422 短路语义——某些查询在客户端就能算完,不该往服务端发。

spec/quantified-api.yaml · 9 个端点
可运行 · 逐像素确定性

表情渲染器

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

tools/expression.html
可运行 · 算真数

量化评估器

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

tools/quantifier.html
可运行 · 14 类设备

外设控制台

填入体重、活动等级与一份外设清单,实时产出狩猎序列闭合检查、纸箱 MUST 判定、激光笔滥用警告与逐设备门槛判定。

tools/peripherals.html
14 帧一次平铺

表情联系表

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

tools/expression-sheet.html
手绘 SVG · 灰阶

图表图鉴

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

tools/charts.html
一周 × 24 小时 · 矩阵

24h 作息热力图

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

tools/heatmap-24h.html
Statuspage 风 · 模拟

API 健康检查面板

12 个子系统的实时状态面板(PURR/VOMIT/APPETITE/SLEEP/TERRITORY/HUNT/GROOM/LITTERBOX/BOX/ZOOMIES/COMM/AFFECTION)。

tools/health-check.html
六维雷达 · 季度环比

360° 猫档案

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

tools/cat-review.html
生物力学 · 计算器

跳跃判定器

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

tools/can-jump.html
领养即安装

领养组件

领养只有一种形态:装技能。填四元组(领养人/时刻/栖息地/用途),本页当场算出领养 KEY 与领养名,并生成一条 curl 命令——装完算出来的结果与本页逐字节相同。本系统不返回 401,所以那张牌不是通行证,是来源标注。

tools/adoption.html
图像 → SVG · 全离线 · 含 3D 版

赛博遛猫

把一张图片降格成一只网格化的「猫」,用鼠标当牵引绳去遛它。管线四步:像素→网格→部件→路径。导出静态 SVG 或带 SMIL 循环的动态 SVG。新增 3D 版:Three.js 实时体素渲染,可旋转视角、步态动画、牵引绳物理。§8 外设 · PER/LEASH。

tools/cyber-stroll.html · 3D 版 →
唯一出网页 · KEY 不落地

星图接入

纯前端调用 AstraFlow 大模型工作台:接入配置、模型清单、对话(流式)、文生图、请求可观测(打码 + curl)、自检。图片可送「赛博遛猫」做 SVG 网格化。

tools/astraflow.html
可运行 · 交互式

抚摸路径规划器

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

tools/petting-router.html
可运行 · 五轮博弈

不让猫进的那扇门

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

tools/door-negotiator.html
可运行 · 限时游戏

3AM 编辑部

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

tools/3am-newsroom.html
燃尽图 · 可交互

九条命燃尽图

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

tools/nine-lives.html
可运行 · 模拟翻译

猫语翻译器

模拟录音分析九种意图,输出结构化 JSON。遇到 503 NO_AUDIO 与 429 RATE_LIMITED 是彩蛋。

tools/meow-decoder.html
审计日志 · 终端风

猫砂盆审计日志

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

tools/litterbox.html
一页看完

速查卡

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

reference/cheatsheet.html
一页查完 · 可打印

生理指标速查

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

reference/vitals.html · 8 项 A 级指标
逐条对照

状态码对照

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

13 个状态码
公共约定

术语表

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

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

历史版本

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

versions.html · 5 个里程碑
可运行 · 纯模拟

SDK 控制台

14 个端点可点击调用,纯模拟零网络请求。带进程内状态机——连点 POST /api/bath 看态度从 418 一路恶化到 503。新增跨物种谈判端点:跟狗 negotiate 一次,看信任值怎么变。资源表与命令行 cat-api 同源。

sdk/demo.html · 内核 sdk/cat-api-client.js
终端日志 · 实时追加

猫的 404 日志

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

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

Breaking Changes

当事猫单方面决定的破坏性变更时间线:午睡从 14h 改 18h、Owner 角色从 undefined 升级为禁止定义、纸箱优先级从 MUST 升到 MUST_NOT_REMOVE。

tools/breaking-changes.html · 15 条变更
跨站协议 · 唯一出网页之一

跨站串门 · 猫狗串门

把本站的猫送出屏幕边缘,它会走去别的站点;别站的宠物也会走进来。宽进严出协议,进来的造型一律先过三道净化。新增猫狗串门:跨物种互动矩阵给出 15 种可能的反应与行为学解释。

tools/crosspet.html · CrossPet Protocol v1.0 · 26 项协议自检
定义口径

口吻与文体

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

REFERENCE / VOICE
第二声部

一只猫的生活意见

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

REFERENCE / OPINIONS · 31 条
某个系统从架构层面否认你拥有它;
某个系统为你专门开发了一套叫「喵叫」的外部接口;
以及,某个系统在你哭的时候坐在你旁边——
它不知道你为什么哭,但它知道你不应该一个人在那里。 —— 这就是 CAT API
CAT API · 静态站点,无构建步骤,无外部依赖 · 打开 index.html 即可阅读
v0.6.0 "Cross-Species Sync"
lijinhongucl-pixel / cat-api-spec