Character Manager

v1.0.4

小说角色管理工具。创建、编辑、查询角色档案，支持角色关系网络、情感弧光、动机追踪。Use when: Architect 代理在 Phase 3 需要创建角色档案、管理角色关系、追踪角色成长轨迹。

⭐ 0· 241·0 current·0 all-time

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for yuzhihui886/character-manager.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "Character Manager" (yuzhihui886/character-manager) from ClawHub.
Skill page: https://clawhub.ai/yuzhihui886/character-manager
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install character-manager

ClawHub CLI

Package manager switcher

npx clawhub@latest install character-manager

Security Scan

VirusTotal

Pending

View report →

OpenClaw

Benign

high confidence

✓

Purpose & Capability

The name, description, provided templates/configs, example YAMLs, reference guide, and the included Python script all align: this is a local character-management tool for novel projects. There are no unexpected dependencies or credentials requested that don't fit the stated purpose.

✓

Instruction Scope

SKILL.md instructs installing Python deps and running the included script with project paths. It explicitly documents that the tool reads/writes YAML files in the provided --project directory and warns users not to point it at system or sensitive directories. The runtime instructions do not ask the agent to read environment vars or contact external endpoints.

✓

Install Mechanism

There is no automated install spec; instructions recommend running 'pip3 install -r requirements.txt --user' (requirements are pyyaml and rich). This is a standard, low-risk install pattern from PyPI and the package list is proportional to the repository's needs.

✓

Credentials

The skill declares no required environment variables, no primary credential, and no required config paths beyond its own configs. The files and dependencies listed are consistent with local YAML manipulation and CLI output formatting.

✓

Persistence & Privilege

always is false (no forced inclusion). The skill does not request permanent elevated privileges or modify other skills. It can be invoked autonomously (platform default), which is appropriate for this type of tool.

Assessment

This skill appears coherent and self-contained, but be cautious when choosing the --project path: run it against your novel workspace, not system or sensitive directories. If you plan to allow an agent to call this autonomously, review the script's create/update/delete code paths (especially the delete operation) before granting it access, and consider running it in a sandboxed workspace or a git-tracked project so accidental overwrites can be reverted.

Like a lobster shell, security has layers — review code before you run it.

latestvk978xmwvvzxsdwj7zwawt2h9bn8413jv

241downloads

0stars

5versions

Updated 3w ago

v1.0.4

MIT-0

Character Manager - 角色管理工具

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

快速开始

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）
❌ 不要指向包含敏感数据的目录

示例:

# ✅ 安全
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

角色档案结构

# 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 个主角)

依赖

pip3 install -r requirements.txt --user

主要依赖：

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

Comments

Loading comments...