| name | save_local_character |
| description | 把结构化人物卡写入工作区 `data/characters`。 |
| scenarios | ["authoring","play"] |
| metadata | {"author":"meathill","version":"1.1.0","group":"record","execution-mode":"native"} |
保存人物卡到本地文件
把结构化人物卡写入工作区 data/characters。
When to use
- 玩家角色创建完成后需要落盘时。
- AI 生成或更新人物卡后需要写入工作区文件时。
- 关键 NPC 创建完成后:关键 NPC(全程出现、有谈判树/战斗属性/触发脚本的 NPC)也应用此 skill 保存独立卡牌,文件名建议以
npc- 为前缀(如 npc-zhang-jianguo.json)。
Do not
- 只在上下文里临时持有角色,不做持久化。
- 保存关键 NPC 卡牌后忘记调用
patch_npc 在模组中添加 card_ref 关联。
保存后续步骤
| 角色类型 | 保存后必做 |
|---|
| 玩家角色 | 无需额外步骤 |
| 关键 NPC | 调用 patch_npc 在模组 npcs[id] 中添加 type: "key_npc" 和 card_ref |
Contract
当前 skill 的参数、边界与返回要求以本文件说明为准。
Usage
- 先理解用户当前意图是否真的需要此 skill。
- 根据本技能的说明填写参数。
- 不要在正文里伪造 tool 调用结果。
- 如果宿主支持执行层,可把该 skill 映射到项目内的同名实现。