MeowCat 框架详解

纯抽象的 AI Agent 骨架 — 定义结构、连接、信号规则,不写任何具体逻辑

Python 3.10+ MIT License Zero I/O Core

一句话定位

MeowCat 是纯抽象的 AI Agent 骨架。它只定义「猫有什么器官、器官间怎么连」,不写任何具体逻辑。你来实现每个器官的具体行为 — LLM 推理、记忆存储、安全检查、工具执行。

独立 pip 包,零外部依赖。框架定义骨架,你来选择材料。

Agent 应该是什么样的?

❌ 传统 Harness 模式

LLM → 挂工具 → 编排工作流。Agent 是功能单元,约束靠 prompt guard。

VS

✅ MeowCat 生命体模式

器官 → 角色约束 → 神经信号 → 行为涌现。架构层硬约束,行为自然产生。

核心设计思想

为什么用生物神经范式?从第一性原理重新思考 AI Agent 的构建方式

🧬

生命体 > 工具链

Agent 不是工具的组合,而是一个完整的生命体。器官各司其职,行为从架构层自然涌现,而非靠 prompt 堆砌。

🔒

硬约束 > 软提示

安全不该依赖 prompt。架构层的禁止边、熔断器、Amygdala 旁路,让约束铁打不动。

🕸️

记忆是图,不是向量

实体-关联-事件三元组 + 六层衰减,这才是真正的记忆。扁平向量库做不到。

📈

越用越强,而非越用越贵

双闭环生长:技能结晶、角色涌现、反思进化。习惯变成永久能力,不靠堆 token。

20 个器官 · 5 大分类

模拟猫的真实神经解剖学,每个器官有明确的角色、入口/出口规则

🧠 BRAIN 脑区

Cerebrum 大脑LLM 深度推理
Cerebellum 小脑效应器唯一网关
Amygdala 杏仁核安全旁路,危险时跳过推理
Hippocampus 海马体实体图记忆
Thalamus 丘脑感觉中继枢纽
Hypothalamus 下丘脑记忆衰减 + 清理
Frontal 前额叶意图解析
Cortex 皮质L0→L3 认知管道
Brainstem 脑干自主反射

👂 SENSE 感官

Ears 耳文本/语音输入
Eyes 眼视觉/图像感知
Whiskers 须盲点检测

🗣️ VOICE 嗓音

Mouth 口输出回复
Purr 呼噜流式输出
Tail 尾状态指示

💾 STORAGE 存储

EntityStore实体图持久化
SharedStoreColony 共享存储

🌱 GROWTH 生长

PinealGland 松果体融合周期触发
Crystallizer 结晶器技能模板生成
RoleEmergence角色自然分工

Slot-Plug · 四层信号 · 生物防御 · 双闭环

ALGORITHM

纯算法实现,无外部依赖。如 Brainstem 自主反射。

RULE

规则引擎实现,声明式配置。如 Amygdala 安全策略。

MODEL

LLM/ML 模型实现。如 Cerebrum 调用 GPT-4 / DeepSeek。

HYBRID

混合实现,组合多种风格。如 Hippocampus 图存储 + 向量检索。

🔌 Slot-Plug 架构

框架定义 Slot(Protocol),你提供 Plug(实现)。4 种风格:ALGORITHM | RULE | MODEL | HYBRID

📶 四层信号系统

Path → Chain → Loop → LoopSequence。从原子信号到编排,层层组合

🛡️ 生物级防御

Amygdala 安全旁路 · 熔断器 · 禁止边 · Kittens 权限视图

🔄 双闭环生长

内环 CatSelf 反思进化,外环 Colony 集体生长。猫越用越聪明

四层执行模型

从原子到编排,层层组合。不是工作流定义,而是神经系统架构。

L1

Path 原子信号

器官间的单向信号传递。31 条内置路径。如 EARS → THALAMUS.hear。

L2

Chain 序列 + 回滚

多个 Path 的顺序执行,失败自动回滚。8 条内置链条。如感知 → 路由 → 执行。

L3

Loop 触发 + 退出 + 事件

条件触发的循环,有明确的进入/退出条件。7 条内置循环。如生长闭环、反思闭环。

L4

LoopSequence 编排

多个 Loop 的顺序编排。如维护序列:清理→蒸馏→生长。

Colony 多猫系统

猫舍大看板共享 · 单人宿舍私有 · 角色自然分工

🏠 猫舍大看板 · Shared Board
👤 用户画像
📋 猫舍规则
📚 共享知识
🐱 猫列表
🌱 集体生长
🐱 宿舍 01
CatSelfScribblePad实体图
🐱 宿舍 02
CatSelfScribblePad实体图
🐱 宿舍 03
CatSelfScribblePad实体图

快速开始

01

安装框架

Terminal
pip install meowcat
02

创建 Colony + Cat

Python
from meowcat.defaults import create_cat
from meowcat.colony import Colony
colony = Colony()
cat = create_cat(container=colony,
    cerebrum=YourImpl(), name="Kitty")
03

感知世界

Python
response = await cat.perceive("你好!")
print(response)