跳到正文

参考

术语表

Quetzal 文档里反复出现的名词:运行基座、身体、适配器、心脏、内驱力、灵魂仓库、灵魂桥、闸门、保密库……

#术语

术语英文含义
运行基座runtimeQuetzal 的核心程序(单文件 main.cjs),让 agent 活在一具身体里
agentagent住在运行基座里的 ta;身份来自灵魂仓库的 agent.json
身体body运行着一个运行基座(或灵魂桥)的设备:安卓手机、Linux 机器、Windows 电脑等;同一个 agent 可以有多具身体
身体适配器body adapter设备与核心之间唯一的边界:采样、通知、播放、设备工具;仓库自带安卓、Termux、Linux、Windows 四个
身体数字孪生body twin把物理采样镜像为内部模型,派生精力、冷热、明暗、被拿起等身体感受
sense 事件sense event身体状态的显著变化(插电、光线、被拿起、过热…),会调整驱动力
心脏heart决定何时醒来的模块:内驱力、生物钟、醒来抽样
内驱力drives好奇心、表达欲、想念、牵挂,0–1,随时间趋向饱和
生物钟body clock睡眠压力 S 与昼夜节律 C 的双过程模型;困意 = S − C
醒来率wake rate (hazard)瞬时醒来概率密度(次 / 小时),由驱动力、清醒度与抑制决定
抑制inhibition急停、暂停、无模型、过热、低电、离线、预算用尽对醒来率的乘法系数
大脑mind一次醒来或对话的执行:内省 → 工具循环 → 反思(finish)
内省模型quick model醒来时用于"想不想动"轻量判断的便宜模型
做梦dream睡眠中的醒来:整理记忆(把细节从常驻记忆移进笔记)
会话session一组对话的容器;同一会话顺序处理,不同会话并行,彼此可见
插话 / 排队 / 打断steer / queue / interruptta 工作时你发消息的三种处理方式
时间墙idle wall按「无进展」计时的保护:模型调用 90 秒、会话 120 秒
灵魂soulagent 的人格与记忆(SOUL.md、常驻记忆、日记、笔记、身份)
灵魂目录soul directory本机 QUETZAL_HOME/soul/,一个 git 仓库
灵魂仓库soul repository多具身体共享的私有 git 仓库,<agent>.soul
灵魂同步soul sync基座全自动的拉取、合并、推送;ta 改动灵魂目录后立即提交并推送,推送失败或两边改动冲突时才提醒 ta
多具身体multiple bodies同时在线的几具身体直接连成一个心智:一份对话、一颗心、一份设置
同步服务sync service让身体互相找到、打不通时中转的服务(sync/);只有账户与身体登记,看不到对话与记忆
协调者coordinator此刻持有心跳的那具身体,由它决定 ta 什么时候醒来;其他身体跟随
灵魂桥soul-bridge装在 Hermes / OpenClaw 机器上的可插拔同步守护进程
身份守卫identity guard拒绝合并 agent.json.id 不同的仓库
种子身份 / 种子人格seed identity / seed soul自动生成、尚未修改的身份与人格;遇到远端已有的会让位
整理租约consolidation lease做梦前在仓库里取得的 30 分钟锁,避免两具身体同时整理记忆
常驻记忆resident memorymemories/MEMORY.md 与 USER.md,§ 分隔的条目,不限长
笔记notes共享的长期笔记,最多 4 层的目录树
日记journal情节记忆,每具身体每天一个文件
记忆目录memory index放进上下文的笔记索引(分类、篇数、标题与摘要)
闸门guard能力授权(允许 / 询问 / 禁止)、审批、预算、急停、审计
能力类别permission category联网、执行命令、设备、相机、麦克风、定位、主动发消息、改参数、改记忆、操作屏幕、索取保密信息
审批approval「询问」类能力的请求,30 分钟未处理视为拒绝
急停emergency stop家目录里的 STOP 文件,存在即冻结一切行动
审计audit工具调用、配置修改、记忆修改、审批决定的记录
保密传递pass_secretta 索取凭据的协议:你在聊天框里发,内容不进对话与上下文
保密库vaultQUETZAL_HOME/vault/,保密值的存放处;每项多端同步(经身体间加密通道)或仅本机
结束口令done spell保密输入时标记"输入完毕"的随机短语 done-xxxxxx
网关gateway运行基座的接口:本机 127.0.0.1:7788 明文 HTTP + WebSocket RPC;对局域网开放时另有 https://<地址>:7789(HTTPS / WSS)
证书指纹certificate fingerprint网关自签名证书的 SHA-256 指纹,短格式如 1a2b 3c4d 5e6f 7a8b;配对时在 App 与配对通知里核对,之后 App 只认这张证书
配对码pairing code8 位字母数字(如 ABCD-EFGH)、5 分钟有效、输错多次会锁定一段时间,用于另一台设备上的控制台连接网关;同一台机器上的浏览器不需要(网关直接放行)
网页控制台web console控制台的网页版,由运行基座的网关托管(http://127.0.0.1:7788/),按电脑横屏重新排布;随 npm 包装到 Linux 机器上
启动ignite基座离线时 App 重新启动自己的前台服务(App 内置的运行基座);离线横幅上的「启动」按钮
安全模式safe mode10 分钟内启动超过 5 次后的保护状态:只开网关与飞书
此刻NowApp 首页:状态、驱动力、ta 想分享的一句话
心流FlowApp 的时间线页:醒来、做梦、对话的记录
主动消息proactive messageta 自己醒来时用 send_message 发出的消息
handshands适配器的「手」:读屏幕(无障碍树)、截图、点击、输入、按键、打开应用的接口;核心据此提供 screen_* 工具
身体接口body interfaceQuetzal App 在本机提供给内置运行基座的身体能力(传感器、通知、相机、麦克风、定位……),只认令牌,地址与令牌在 secrets/body.json
身体助手body helperWindows 上控制台托盘在登录时启动的 windows-body.mjs。开机任务里的运行基座看不到桌面,通知、截图、剪贴板、打开、播放、拍照、录音由它完成;端口与令牌在 secrets\desktop-body.json
家目录QUETZAL_HOME运行基座的全部数据所在。默认:安卓 App 数据目录下的 files/home/quetzal(旧的 Termux 安装为 ~/quetzal)、Linux ~/.quetzal、Windows %LOCALAPPDATA%\Quetzal\home;可用环境变量改