参考
术语表
Quetzal 文档里反复出现的名词:运行基座、身体、适配器、心脏、内驱力、灵魂仓库、灵魂桥、闸门、保密库……
#术语
| 术语 | 英文 | 含义 |
|---|---|---|
| 运行基座 | runtime | Quetzal 的核心程序(单文件 main.cjs),让 agent 活在一具身体里 |
| agent | agent | 住在运行基座里的 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 / interrupt | ta 工作时你发消息的三种处理方式 |
| 时间墙 | idle wall | 按「无进展」计时的保护:模型调用 90 秒、会话 120 秒 |
| 灵魂 | soul | agent 的人格与记忆(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 memory | memories/MEMORY.md 与 USER.md,§ 分隔的条目,不限长 |
| 笔记 | notes | 共享的长期笔记,最多 4 层的目录树 |
| 日记 | journal | 情节记忆,每具身体每天一个文件 |
| 记忆目录 | memory index | 放进上下文的笔记索引(分类、篇数、标题与摘要) |
| 闸门 | guard | 能力授权(允许 / 询问 / 禁止)、审批、预算、急停、审计 |
| 能力类别 | permission category | 联网、执行命令、设备、相机、麦克风、定位、主动发消息、改参数、改记忆、操作屏幕、索取保密信息 |
| 审批 | approval | 「询问」类能力的请求,30 分钟未处理视为拒绝 |
| 急停 | emergency stop | 家目录里的 STOP 文件,存在即冻结一切行动 |
| 审计 | audit | 工具调用、配置修改、记忆修改、审批决定的记录 |
| 保密传递 | pass_secret | ta 索取凭据的协议:你在聊天框里发,内容不进对话与上下文 |
| 保密库 | vault | QUETZAL_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 code | 8 位字母数字(如 ABCD-EFGH)、5 分钟有效、输错多次会锁定一段时间,用于另一台设备上的控制台连接网关;同一台机器上的浏览器不需要(网关直接放行) |
| 网页控制台 | web console | 控制台的网页版,由运行基座的网关托管(http://127.0.0.1:7788/),按电脑横屏重新排布;随 npm 包装到 Linux 机器上 |
| 启动 | ignite | 基座离线时 App 重新启动自己的前台服务(App 内置的运行基座);离线横幅上的「启动」按钮 |
| 安全模式 | safe mode | 10 分钟内启动超过 5 次后的保护状态:只开网关与飞书 |
| 此刻 | Now | App 首页:状态、驱动力、ta 想分享的一句话 |
| 心流 | Flow | App 的时间线页:醒来、做梦、对话的记录 |
| 主动消息 | proactive message | ta 自己醒来时用 send_message 发出的消息 |
| hands | hands | 适配器的「手」:读屏幕(无障碍树)、截图、点击、输入、按键、打开应用的接口;核心据此提供 screen_* 工具 |
| 身体接口 | body interface | Quetzal App 在本机提供给内置运行基座的身体能力(传感器、通知、相机、麦克风、定位……),只认令牌,地址与令牌在 secrets/body.json |
| 身体助手 | body helper | Windows 上控制台托盘在登录时启动的 windows-body.mjs。开机任务里的运行基座看不到桌面,通知、截图、剪贴板、打开、播放、拍照、录音由它完成;端口与令牌在 secrets\desktop-body.json |
| 家目录 | QUETZAL_HOME | 运行基座的全部数据所在。默认:安卓 App 数据目录下的 files/home/quetzal(旧的 Termux 安装为 ~/quetzal)、Linux ~/.quetzal、Windows %LOCALAPPDATA%\Quetzal\home;可用环境变量改 |