Event Manager - 事件管理工具

创建、编辑、查询事件档案的工具，支持因果链、时间线、多线叙事追踪。专为 AutoNovel Writer v5.0 设计，由 Architect 代理在 Phase 2 使用。

快速开始

cd ~/.openclaw/workspace/skills/event-manager

# 安装依赖
pip3 install -r requirements.txt --user

# 创建新事件
python3 scripts/manage_events.py create --title "获得传承" --type "转折点" --output events/main.yml

# 查看事件列表
python3 scripts/manage_events.py list --project ./my-novel

# 查询事件因果链
python3 scripts/manage_events.py query --title "获得传承" --project ./my-novel --show-chain

# 导出时间线
python3 scripts/manage_events.py export --project ./my-novel --output timeline.md

命令行选项

事件档案结构

# events/main.yml
title: 获得传承
type: 转折点
chapter: 1

# 事件描述
description: 主角在山上采药时意外坠崖，被神秘老者所救，获得古老玉佩传承。

# 因果链
causality:
  causes:
    - title: 上山采药
      chapter: 1
  effects:
    - title: 加入青云宗
      chapter: 5
    - title: 被同门嫉妒
      chapter: 8

# 参与角色
characters:
  - name: 林风
    role: 主角
    action: 获得传承
  - name: 神秘老者
    role: 导师
    action: 传授传承

# 伏笔
foreshadowing:
  - id: FS-001
    description: 玉佩上的神秘纹路
    payoff_chapter: 50
    payoff_description: 揭示玉佩是上古宗门信物

# 情绪曲线
emotion_arc:
  start: 平静
  middle: 紧张
  end: 惊喜

支持的事件类型

因果链示例

# 主线事件因果链
event_chain:
  - title: 上山采药
    chapter: 1
    type: 日常
    
  - title: 获得传承
    chapter: 1
    type: 转折点
    causes: [上山采药]
    effects: [加入青云宗]
    
  - title: 加入青云宗
    chapter: 5
    type: 成长
    causes: [获得传承]
    effects: [被同门嫉妒，遇见女主角]
    
  - title: 被同门嫉妒
    chapter: 8
    type: 冲突
    causes: [加入青云宗]
    effects: [比武大会]

使用场景 (V5 流水线)

依赖

pip3 install -r requirements.txt --user

主要依赖：

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

相关文件

• scripts/manage_events.py - 主程序
• configs/event_templates.yml - 事件模板配置
• references/event_design.md - 事件设计指南

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