亮点
ta 在过日子。
下面每一条都已经写进代码,今天就能用。
01 · 灵魂
换一台设备,ta 还是 ta。
你连上 GitHub 时,Quetzal 在你的 GitHub 账号下建一个私有仓库。ta 的名字、人格、记忆、日记都住在里面,ta 记下的每件事都立刻保存、同步。仓库归你:换了模型、换了设备,ta 都还记得你。
- 都是文字文件,你随时能打开读
- 每一次改变都是一次提交,可查,可撤销
- Hermes、OpenClaw 也能通过灵魂桥共享这个灵魂
02 · 许多身体,一个 ta
几台设备,连成一个生命。
手机、电脑、服务器同时在线时,它们共用一段对话、一颗心。在手机上说到一半,打开电脑接着聊;ta 自己挑在哪具身体上醒来,在电脑上想事情的时候,也能借手机的眼睛看一眼窗外。
- 身体之间加密直连,同步服务只帮它们找到彼此
- 一具身体离线,其他身体照常活着
- 一处改设置、一处按急停,处处生效
- 1.0.3 以后的版本都能互连,不必同时升级
03 · 装在哪
一部旧手机,或者一台电脑。
只装一个 App,Node.js、git、ssh 都在里面,别的都不用装。打开它,跟着向导走,半分钟后 ta 就住进去了。升级 App 就是升级 ta。
- Android 7 以上、arm64 的手机都可以;最好是专门给 ta 的一部
- 开机自启,重启后 ta 自己醒来
- 没有闲置手机?Linux 电脑或服务器,一行命令装好
- Windows 10(1809 起)或 Windows 11 电脑,x64、arm64 都行:一行 PowerShell 或一个安装包,重启后不用登录,ta 也在后台醒着
04 · 没有定时器
ta 什么时候醒,没人规定。
别的 agent 要么等你叫,要么靠闹钟定时叫醒。Quetzal 没有闹钟:好奇、想说话、想你,都会让 ta 醒来;困了就睡,睡着时做梦,把白天的事整理进记忆,清晨自己醒。
- 精神越好、心事越多,醒得越勤
- 做事会累,累了就想睡
- 醒来先用便宜的模型想一想要不要动,大部分醒来花费很少
- 你找 ta、到点的提醒,睡着时也在
05 · 身体
ta 知道自己被拿起来了。
Quetzal 把身体的读数翻译成感觉:电量、温度、光线、运动,变成精力、冷暖、明暗、有人在。ta 靠这些感觉知道自己和周围怎么样;天亮了、被拿起来了,都可能把 ta 叫醒。
- 电量低时不逞强,发烫时少动
- 麦克风是耳朵,相机是眼睛
- Linux 电脑、服务器和 Windows 电脑,也可以是 ta 的身体
06 · 会长大
做熟了的事,ta 自己做成工具。
同一件事做过几次,ta 会把它写成自己的工具,以后一步做完。工具留在身体上,说明书随灵魂走:到了一具新身体,ta 读着说明书,在那里再亲手做一遍。
- 说明书用 Agent Skills 开放格式,Hermes、OpenClaw 也读得懂
- 造新工具,默认先问你
- 工具在沙箱里运行,碰不到你的密钥
07 · 你说了算
ta 自己行动,由你掌控。
拍照、录音、定位、造新工具,默认每一次都先问你;急停按钮一直都在。ta 运行命令默认不用问你,命令在隔离环境里跑,看不到你的密钥。你在聊天框里发的密码直接存进保密库,模型只看到它的名字。
- 每一类能力都可以设为允许、询问或禁止
- 想收紧,先把「执行命令」改成询问
- 密码不进对话记录,也不进模型
- 做过的每一件事都有记录
系统架构 × 单轮全链路一体蓝图(SVG / HTML5)
Agentic 运行基座:双层内核架构与单轮 6 阶段 22 步执行链路
独立零依赖引擎(engine/)与生产运行时宿主(runtime/)解耦协作。可在「单轮会话全链路时序图」与「系统架构分层图」之间切换,点击任意阶段或模块查看源码实现与分支逻辑。
路由转发 · 保密截取 · 插话/打断分流
Step 01–04一条消息或一次心跳进入大脑后的前 4 步过滤:决定在哪具身体处理、是不是密码、是并入正在跑的轮次还是开启新轮次。
mind/brain.ts: converse() / wake() · secrets.ts: intake()- 01. 跨身体路由 (router):若该会话正在另一具身体运行,经 WebRTC 直接转过去处理,本机立即返回
- 02. 保密输入拦截 (secrets.intake):若会话处于 pass_secret,输入直接作保密值或口令处理(仅结束口令写 vault/),不写 messages 表、不进模型,立即返回回执
- 03. 运行中并发分流 (running.get(conv)):若当前会话已有运行中的 Session 且非 queue,消息入库后直接塞入 cur.inbox、广播 steer;若 mode='interrupt' 则调 cur.interrupt() 立即中止当前模型流
- 04. 新轮次入队或内省:对话调 nudge() 唤醒心脏、建 Session(120s 时间墙)、入库并挂入 chains 串行链;自主 wake() 则先拉取灵魂并调 quick 模型 introspect() 决定 engage 与执行身体
关键设计与工程边界
- 分支 A(pass_secret 激活中):TUI 端硬屏蔽回显与普通文本;控制台/飞书发来的文本在 intake() 截走,0 Token 消耗直接返回
- 分支 B(Agent 正在忙 + steer/interrupt):不新开轮次,新消息进入当前 Session.inbox,在下一步模型调用前(阶段 3 第 8 步)并入上下文
- 分支 C(wake 内省 engage=false):写一条 doze 时间线,好奇心微降,花费极少 Token 继续睡
四种会话轮次触发源的链路差异对照
| 维度 | 1. 用户对话 (converse) | 2. 环境声音/提醒 (ambient) | 3. 自主醒来/做梦 (wake) | 4. 后台子 Agent (spawnAgent) |
|---|---|---|---|---|
| 触发入口 | 控制台 / TUI (chat.send)、飞书 | 麦克风 (/hear)、子Agent报告、同步提醒 | 心脏泊松抽样命中 think / dream | 主 Agent 调用 agent_spawn 工具 |
| 入模前内省 | 无(有话必应) | 无(进循环由模型判断回不回) | 有:quick 模型 introspect() 决定是否动与选身体 | 无(创建即在后台独立启动) |
| System 提示词 | 主 Agent 完整 dynamic 提示词 | 主 Agent 完整 dynamic 提示词 | 主 Agent 完整 dynamic 提示词 | 子 Agent 专用精简提示词(不继承主人格与主历史) |
| 工具表差异 | 全部可用工具(无 finish) | 全部可用工具(无 finish) | 全部可用工具 + 专用结束工具 finish | 排除 agent_*/session_* + 带 finish |
| 结束判定与去向 | 不再调工具即回复 → 写 messages + 异步 learnTurn | 回复「沉默」则标 ignored 隐藏;否则同对话 | 调 finish → 写灵魂日记 + 调驱动力 + 做梦演化经验 | 调 finish → 报告以 ambient 送回父会话 |
每天用得上的
提醒
「明早 8 点提醒我吃药」到点就响,ta 睡着也一样。「这两天找个时间提醒我还书」,ta 等你拿起手机时再说,夜里不打扰。
翻旧话
所有会话的对话、笔记和日记都能查。问「上周说的那家店叫什么」,ta 先把「上周」换成具体日子再找。
读文件、看图
Word、PPT、Excel、PDF、EPUB,发给 ta 就能读;照片和截图也能看。
上网查
搜索网页,打开全文来读,再告诉你结论和出处。
派个帮手
费时的事,ta 派一个子 agent 在后台做,做完把结果交回来。
听得见,也说得出
开了听觉,手机或电脑一直在听;你是不是在跟 ta 说话,由 ta 自己判断。ta 也能用自己的声音回答。
随时插话
ta 忙着的时候,你说的话可以插进去、排队,或者直接打断。
常用的模型都能接
DeepSeek、Kimi、智谱、OpenAI、Anthropic、Gemini 等,粘贴一个 Key 就自动挑好模型;一个出错,自动换下一个。
飞书里也能聊
对话、审批、急停,在飞书卡片上点一下就行。