模版与角色使用指南

核心概念

模版是类，角色是实例

模版：预设的NPC原型（如LuLu、曹操），包含人设、性格、基础记忆等配置

角色：基于模版创建的独立个体，每个用户/设备需要创建自己的角色实例

使用流程

选择一个模版ID（从下方测试模版中选择或使用自定义模版）

调用 init_with_template 接口为每个用户/设备创建独立的角色

获得该用户专属的角色NPC ID，后续对话使用此ID

记忆机制

模版记忆（共享）：所有基于该模版创建的角色都会继承的基础记忆（如曹操的征战经历）

角色记忆（独立）：每个角色与用户的独特对话和互动记忆，互不干扰

举例说明：
假设1000个用户使用曹操模版：

只需创建1个曹操模版

需要创建1000个独立的曹操角色实例（每个用户1个）

每个角色都继承相同的"征战记忆"（模版记忆）

但各自发展独立的"与用户的故事"（角色记忆）

测试模版

以下是预设的测试模版ID，可用于快速创建和测试角色：

LuLu：XDSK5Wa351a5fb19eb4c448dcca568ca284176

Sandra：UY2FEP48228b5e8bf8413eaa430dc3ded2dd29

Isabella：XDSK5W11f67322228941e9a68f5499ff60c9f0

Scarlett：XDSK5W70c3c190cda647f6b7b3fca06a85330d

Sakura：XDSK5We3e47adbc5484ba49a94c0b2fa7ef48e

CaoCao：BRGJW56d2d16248a3149e397d7d26e682797fa

Guanyu：BRGJW5bc6a2af252344ca9ae58fede93ca56c6

Huangmei：BRGJW570af8ccf6c7146ba8968435357c02ae9

角色个性化调整

创建角色后，可使用 modify_npc 接口对角色进行个性化调整（如修改性格、增加特定记忆等），这些调整仅影响当前角色，不会影响模版和其他基于该模版创建的角色。

常见问题

Q: 多个用户可以共用一个角色NPC ID吗？

A: 不可以。每个用户/设备都需要基于模版创建自己的角色实例，获得独立的NPC ID，这样才能保证记忆不会相互干扰。

Q: 如果用户想重置角色怎么办？

A: 可以基于相同的模版重新调用 init_with_template 接口，创建一个全新的角色实例，原有角色的记忆将不会保留。

Q: 模版记忆可以修改吗？

A: 模版记忆可以灌入。

Q: 一个用户可以创建多个角色吗？

A: 可以。一个用户可以基于不同的模版（或同一模版）创建多个角色，每个角色都有独立的NPC ID和记忆。

模版 与 角色

模版与角色使用指南#

核心概念#

使用流程#

记忆机制#

测试模版#

角色个性化调整#

常见问题#

Q: 多个用户可以共用一个角色NPC ID吗？#

Q: 如果用户想重置角色怎么办？#

Q: 模版记忆可以修改吗？#

Q: 一个用户可以创建多个角色吗？#

模版与角色