Character Manager - 角色管理工具

创建、编辑、查询角色档案的工具，支持角色关系网络、情感弧光、动机追踪。专为 AutoNovel Writer v5.0 设计，由 Architect 代理在 Phase 3 使用。

快速开始

bash
cd ~/.openclaw/workspace/skills/character-manager

安装依赖

pip3 install -r requirements.txt --user

创建新角色

python3 scripts/manage_characters.py create --name 林风 --role 主角 --output characters/linfeng.yml

查看角色列表

python3 scripts/manage_characters.py list --project ./my-novel

查询角色关系

python3 scripts/manage_characters.py query --name 林风 --relation 盟友

导出角色档案

python3 scripts/managecharacters.py export --project ./my-novel --output charactersexport.md

安全说明

重要: --project 参数用于指定项目目录，工具会读取和写入该目录中的 YAML 文件。

安全建议:

• - ✅ 仅指向小说项目目录（如 ./my-novel）
• ✅ 使用相对路径或工作区内的绝对路径
• ❌ 不要指向系统目录（如 /etc, /home, ~/.ssh）
• ❌ 不要指向包含敏感数据的目录

示例:
bash

✅ 安全

python3 scripts/manage_characters.py list --project ./my-novel
python3 scripts/manage_characters.py export --project /home/user/workspace/novels/my-book

❌ 危险 - 不要这样做

python3 scripts/manage_characters.py list --project /etc python3 scripts/manage_characters.py list --project ~/.ssh

命令行选项

选项	说明	必填
create	创建新角色档案	-
list

列出所有角色 | - | | query | 查询角色信息 | - | | update | 更新角色档案 | - | | delete | 删除角色档案 | - | | export | 导出角色档案 | - | | --name | 角色名称 | create/query/update | | --role | 角色类型（主角/配角/反派） | create | | --project | 项目目录 | list/export | | --output | 输出文件路径 | create/export |

角色档案结构

yaml

characters/linfeng.yml

name: 林风
role: 主角
age: 16
gender: 男

外貌特征

appearance: height: 175 build: 清瘦 features: - 剑眉星目 - 气质出尘 clothing_style: 朴素青衣

性格特征

personality: traits: - 坚韧不拔 - 重情重义 - 聪明机智 flaws: - 有时冲动 - 不愿示弱 mbti: ENFP

背景故事

background: origin: 青石镇普通少年 family: 父母早逝，与爷爷相依为命 key_events: - chapter: 1 event: 获得神秘玉佩传承 - chapter: 10 event: 加入青云宗

能力体系

abilities: cultivation: current_realm: 练气三层 max_realm: 未知 skills: - 基础剑法 - 青木诀 special: - 玉佩空间 - 快速学习

人际关系

relationships: - name: 苏媚 type: 女主角 status: 暧昧 description: 青云宗圣女，对林风有好感 - name: 萧炎 type: 竞争对手 status: 亦敌亦友 description: 同门师兄，天赋异禀

情感弧光

emotional_arc: start: 平凡少年，渴望力量 midpoint: 发现身世之谜，陷入迷茫 end: 接受使命，成长为强者

动机追踪

motivation: surface_goal: 成为强者，保护重要的人 deep_goal: 寻找父母失踪真相 internal_conflict: 力量与本心的平衡

支持的角色类型

类型	说明	示例
主角	故事核心人物	林风
女主角

感情线核心 | 苏媚 | | 重要配角 | 推动剧情的关键配角 | 导师、盟友 | | 配角 | 一般配角 | 同门、路人 | | 反派 | 对立面角色 | 宿敌、BOSS | | 中立 | 立场不明确的角色 | 商人、情报贩子 |

关系类型

类型	说明
盟友	站在主角一方的角色
敌人

对立面角色 | | 竞争对手 | 亦敌亦友的关系 | | 师徒 | 师傅/徒弟关系 | | 亲人 | 父母、兄弟姐妹 | | 暧昧 | 感情线未明确 | | 恋人 | 确定的恋爱关系 |

使用场景 (V5 流水线)

阶段	代理	输入	输出
Phase 3: 角色档案	Architect	outline.md + world.yml	characters/*.yml (≥3 个主角)

依赖

bash
pip3 install -r requirements.txt --user

主要依赖：

• - pyyaml>=6.0.1 - YAML 文件处理
• rich>=13.7.0 (可选) - CLI 美化输出

相关文件

• - scripts/managecharacters.py - 主程序
• configs/charactertemplates.yml - 角色模板配置
• references/character_design.md - 角色设计指南

---

Version: 1.0.0 基于: AutoNovel Writer v5.0 项目规划