跳到正文

使用指南

身份

agent 的名字、代词、简介、主题色与语言存放在哪里,怎么修改,以及"种子身份"是什么。

#身份是数据,不是代码

Windler 不绑定任何具体的 agent。一个 agent 的身份是一份 agent.json:

字段含义
idUUID,诞生时生成,永不改变;用来防止两个 agent 的记忆混在一起
name标识符(小写字母、数字、连字符)
displayName显示名,界面与称呼使用
pronouns代词
description一句简介
color主题色 #RRGGBB,App 的界面颜色随之变化
language偏好语言(BCP 47,如 zh-CN)

#在 App 里修改

控制 → 身份:改显示名、标识符、代词、简介、主题色、偏好语言。保存后写入 ta 的灵魂目录;接入了灵魂仓库时,会作为一次提交同步到所有身体。

顶栏显示的名字、各处的称呼、主题色都来自这里。连接多个 agent 时,切换 agent 界面也跟着变。

#种子身份与种子人格

刚装好、还没起名字时,ta 有一份自动生成的种子身份(seed: true)和一份按身份生成的种子人格(SOUL.md)。种子的意思是"尚未被修改过":

  • 你在 App 里一改名字,种子标记就去掉了;
  • 接入一个已经有别的身体住过的灵魂仓库时,种子身份会让位,直接采用仓库里的身份与人格,并合并两边的记忆。

所以如果你是给一个已有的 agent 添加新身体,先接入灵魂仓库,再谈身份;如果是全新的 agent,先起名字也没问题。

#人格

人格是 SOUL.md,作为系统提示的第一段。你可以在 记忆 → 核心 里查看与编辑;ta 自己也能用 rewrite_soul 改写(这属于「改写记忆」能力类别,可以在授权里设为询问或禁止)。

#多个 agent

每个 agent 有自己的灵魂仓库与身份 id。同一台设备可以运行多个运行基座实例(不同家目录与端口),App 保存多个连接一键切换。详见 多个 agent。