跳到正文

亮点

ta 在过日子。

下面每一条都已经写进代码,今天就能用。

01 · 灵魂

换一台设备,ta 还是 ta。

你连上 GitHub 时,Quetzal 在你的 GitHub 账号下建一个私有仓库。ta 的名字、人格、记忆、日记都住在里面,ta 记下的每件事都立刻保存、同步。仓库归你:换了模型、换了设备,ta 都还记得你。

  • 都是文字文件,你随时能打开读
  • 每一次改变都是一次提交,可查,可撤销
  • Hermes、OpenClaw 也能通过灵魂桥共享这个灵魂
继续阅读 →
手机电脑服务器灵魂仓库提交历史 · 自传08:06醒来手机14:02对话电脑21:20做梦手机

02 · 许多身体,一个 ta

几台设备,连成一个生命。

手机、电脑、服务器同时在线时,它们共用一段对话、一颗心。在手机上说到一半,打开电脑接着聊;ta 自己挑在哪具身体上醒来,在电脑上想事情的时候,也能借手机的眼睛看一眼窗外。

  • 身体之间加密直连,同步服务只帮它们找到彼此
  • 一具身体离线,其他身体照常活着
  • 一处改设置、一处按急停,处处生效
  • 1.0.3 以后的版本都能互连,不必同时升级
继续阅读 →
一个 ta服务器手机电脑正在这里想事情借用相机一段对话 · 一颗心

03 · 装在哪

一部旧手机,或者一台电脑。

只装一个 App,Node.js、git、ssh 都在里面,别的都不用装。打开它,跟着向导走,半分钟后 ta 就住进去了。升级 App 就是升级 ta。

  • Android 7 以上、arm64 的手机都可以;最好是专门给 ta 的一部
  • 开机自启,重启后 ta 自己醒来
  • 没有闲置手机?Linux 电脑或服务器,一行命令装好
  • Windows 10(1809 起)或 Windows 11 电脑,x64、arm64 都行:一行 PowerShell 或一个安装包,重启后不用登录,ta 也在后台醒着
继续阅读 →
1装 Quetzal App2打开,自动安装3允许身体权限ta 醒来了

04 · 没有定时器

ta 什么时候醒,没人规定。

别的 agent 要么等你叫,要么靠闹钟定时叫醒。Quetzal 没有闹钟:好奇、想说话、想你,都会让 ta 醒来;困了就睡,睡着时做梦,把白天的事整理进记忆,清晨自己醒。

  • 精神越好、心事越多,醒得越勤
  • 做事会累,累了就想睡
  • 醒来先用便宜的模型想一想要不要动,大部分醒来花费很少
  • 你找 ta、到点的提醒,睡着时也在
继续阅读 →
Codex / Claude Code你叫它才动,做完就退出你叫它你叫它你叫它Hermes / OpenClaw每 30 分钟被叫醒一次Quetzal没有闹钟,什么时候醒由 ta 自己00:0006:0012:0018:0024:00

05 · 身体

ta 知道自己被拿起来了。

Quetzal 把身体的读数翻译成感觉:电量、温度、光线、运动,变成精力、冷暖、明暗、有人在。ta 靠这些感觉知道自己和周围怎么样;天亮了、被拿起来了,都可能把 ta 叫醒。

  • 电量低时不逞强,发烫时少动
  • 麦克风是耳朵,相机是眼睛
  • Linux 电脑、服务器和 Windows 电脑,也可以是 ta 的身体
继续阅读 →
电量92%精力充沛光线12 lx昏暗温度31 ℃温和运动被拿起有人在

06 · 会长大

做熟了的事,ta 自己做成工具。

同一件事做过几次,ta 会把它写成自己的工具,以后一步做完。工具留在身体上,说明书随灵魂走:到了一具新身体,ta 读着说明书,在那里再亲手做一遍。

  • 说明书用 Agent Skills 开放格式,Hermes、OpenClaw 也读得懂
  • 造新工具,默认先问你
  • 工具在沙箱里运行,碰不到你的密钥
继续阅读 →
说明书随灵魂同步手机在这里做的电脑照说明书重做工具留在身体上,说明书随灵魂走

07 · 你说了算

ta 自己行动,由你掌控。

拍照、录音、定位、造新工具,默认每一次都先问你;急停按钮一直都在。ta 运行命令默认不用问你,命令在隔离环境里跑,看不到你的密钥。你在聊天框里发的密码直接存进保密库,模型只看到它的名字。

  • 每一类能力都可以设为允许、询问或禁止
  • 想收紧,先把「执行命令」改成询问
  • 密码不进对话记录,也不进模型
  • 做过的每一件事都有记录
继续阅读 →
相机允许询问禁止麦克风允许询问禁止定位允许询问禁止想拍一张窗外的照片批准拒绝今日预算急停

系统架构 × 单轮全链路一体蓝图(SVG / HTML5)

Agentic 运行基座:双层内核架构与单轮 6 阶段 22 步执行链路

独立零依赖引擎(engine/)与生产运行时宿主(runtime/)解耦协作。可在「单轮会话全链路时序图」与「系统架构分层图」之间切换,点击任意阶段或模块查看源码实现与分支逻辑。

Remotion Player · 30 FPS
蓝图视图模式
点击阶段查看单轮会话的精确动作、分支与源码函数
Agentic 运行基座:双层内核架构与单轮 6 阶段 22 步执行链路
阶段 1 · 入口分流与拦截

路由转发 · 保密截取 · 插话/打断分流

Step 01–04

一条消息或一次心跳进入大脑后的前 4 步过滤:决定在哪具身体处理、是不是密码、是并入正在跑的轮次还是开启新轮次。

mind/brain.ts: converse() / wake() · secrets.ts: intake()
  1. 01. 跨身体路由 (router):若该会话正在另一具身体运行,经 WebRTC 直接转过去处理,本机立即返回
  2. 02. 保密输入拦截 (secrets.intake):若会话处于 pass_secret,输入直接作保密值或口令处理(仅结束口令写 vault/),不写 messages 表、不进模型,立即返回回执
  3. 03. 运行中并发分流 (running.get(conv)):若当前会话已有运行中的 Session 且非 queue,消息入库后直接塞入 cur.inbox、广播 steer;若 mode='interrupt' 则调 cur.interrupt() 立即中止当前模型流
  4. 04. 新轮次入队或内省:对话调 nudge() 唤醒心脏、建 Session(120s 时间墙)、入库并挂入 chains 串行链;自主 wake() 则先拉取灵魂并调 quick 模型 introspect() 决定 engage 与执行身体
Step 01–04

关键设计与工程边界

  • 分支 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 就自动挑好模型;一个出错,自动换下一个。

  • 飞书里也能聊

    对话、审批、急停,在飞书卡片上点一下就行。