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/manage_characters.py export --project ./my-novel --output characters_export.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: 角色档案Architectoutline.md + world.ymlcharacters/*.yml (≥3 个主角)

依赖#

bash

pip3 install -r requirements.txt --user

主要依赖：

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

相关文件#

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

---

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