writer-memory

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Writer Memory - Agentic Memory System for Writers

Writer Memory - 面向创作者的智能代理记忆系统

Persistent memory system designed for creative writers, with first-class support for Korean storytelling workflows.
这是为创意创作者打造的持久化记忆系统,为韩语叙事工作流提供一流支持。

Overview

概述

Writer Memory maintains context across Claude sessions for fiction writers. It tracks:
  • Characters (캐릭터): Emotional arcs (감정궤도), attitudes (태도), dialogue tone (대사톤), speech levels
  • World (세계관): Settings, rules, atmosphere, constraints
  • Relationships (관계): Character dynamics and evolution over time
  • Scenes (장면): Cut composition (컷구성), narration tone, emotional tags
  • Themes (테마): Emotional themes (정서테마), authorial intent
All data persists in
.writer-memory/memory.json
for git-friendly collaboration.
Writer Memory 为小说创作者在Claude会话间维持上下文信息,可追踪以下内容:
  • 角色(캐릭터):情感弧光(감정궤도)、态度(태도)、对话语气(대사톤)、说话语体
  • 世界观(세계관):场景设定、规则、氛围、约束条件
  • 人物关系(관계):角色互动及随时间的演变
  • 场景(장면):镜头构成(컷구성)、叙事语气、情感标签
  • 主题(테마):情感主题(정서테마)、创作者意图
所有数据都存储在
.writer-memory/memory.json
文件中,便于使用Git协作。

Commands

命令

CommandAction
/oh-my-claudecode:writer-memory init <project-name>
Initialize new project memory
/oh-my-claudecode:writer-memory status
Show memory overview (character count, scene count, etc)
/oh-my-claudecode:writer-memory char add <name>
Add new character
/oh-my-claudecode:writer-memory char <name>
View character details
/oh-my-claudecode:writer-memory char update <name> <field> <value>
Update character field
/oh-my-claudecode:writer-memory char list
List all characters
/oh-my-claudecode:writer-memory rel add <char1> <char2> <type>
Add relationship
/oh-my-claudecode:writer-memory rel <char1> <char2>
View relationship
/oh-my-claudecode:writer-memory rel update <char1> <char2> <event>
Add relationship event
/oh-my-claudecode:writer-memory scene add <title>
Add new scene
/oh-my-claudecode:writer-memory scene <id>
View scene details
/oh-my-claudecode:writer-memory scene list
List all scenes
/oh-my-claudecode:writer-memory theme add <name>
Add theme
/oh-my-claudecode:writer-memory world set <field> <value>
Set world attribute
/oh-my-claudecode:writer-memory query <question>
Query memory naturally (Korean supported)
/oh-my-claudecode:writer-memory validate <character> <dialogue>
Check if dialogue matches character tone
/oh-my-claudecode:writer-memory synopsis
Generate emotion-focused synopsis
/oh-my-claudecode:writer-memory export
Export full memory as readable markdown
/oh-my-claudecode:writer-memory backup
Create manual backup
命令操作
/oh-my-claudecode:writer-memory init <project-name>
初始化新项目记忆库
/oh-my-claudecode:writer-memory status
查看记忆库概览(角色数量、场景数量等)
/oh-my-claudecode:writer-memory char add <name>
添加新角色
/oh-my-claudecode:writer-memory char <name>
查看角色详情
/oh-my-claudecode:writer-memory char update <name> <field> <value>
更新角色字段
/oh-my-claudecode:writer-memory char list
列出所有角色
/oh-my-claudecode:writer-memory rel add <char1> <char2> <type>
添加人物关系
/oh-my-claudecode:writer-memory rel <char1> <char2>
查看人物关系
/oh-my-claudecode:writer-memory rel update <char1> <char2> <event>
添加人物关系事件
/oh-my-claudecode:writer-memory scene add <title>
添加新场景
/oh-my-claudecode:writer-memory scene <id>
查看场景详情
/oh-my-claudecode:writer-memory scene list
列出所有场景
/oh-my-claudecode:writer-memory theme add <name>
添加主题
/oh-my-claudecode:writer-memory world set <field> <value>
设置世界观属性
/oh-my-claudecode:writer-memory query <question>
自然语言查询记忆库(支持韩语)
/oh-my-claudecode:writer-memory validate <character> <dialogue>
检查对话是否符合角色语气
/oh-my-claudecode:writer-memory synopsis
生成聚焦情感的故事梗概
/oh-my-claudecode:writer-memory export
将完整记忆库导出为易读的Markdown格式
/oh-my-claudecode:writer-memory backup
创建手动备份

Memory Types

记忆库类型

캐릭터 메모리 (Character Memory)

캐릭터 메모리(角色记忆)

Tracks individual character attributes essential for consistent portrayal:
FieldKoreanDescription
arc
감정궤도Emotional journey (e.g., "체념 -> 욕망자각 -> 선택")
attitude
태도Current disposition toward life/others
tone
대사톤Dialogue style (e.g., "담백", "직설적", "회피적")
speechLevel
말투 레벨Formality: 반말, 존댓말, 해체, 혼합
keywords
핵심 단어Characteristic words/phrases they use
taboo
금기어Words/phrases they would never say
emotional_baseline
감정 기준선Default emotional state
triggers
트리거What provokes emotional reactions
Example:
/writer-memory char add 새랑
/writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택"
/writer-memory char update 새랑 tone "담백, 현재충실, 감정억제"
/writer-memory char update 새랑 speechLevel "해체"
/writer-memory char update 새랑 keywords "그냥, 뭐, 괜찮아"
/writer-memory char update 새랑 taboo "사랑해, 보고싶어"
追踪角色塑造所需的各项关键属性,确保角色刻画的一致性:
字段韩语描述
arc
감정궤도情感历程(例如:"체념 -> 욕망자각 -> 선택")
attitude
태도对生活/他人的当前态度
tone
대사톤对话风格(例如:"담백", "직설적", "회피적")
speechLevel
말투 레벨语体正式程度:반말(平语)、존댓말(敬语)、해랑(半语)、혼합(混合)
keywords
핵심 단어角色常用的标志性词汇/短语
taboo
금기어角色绝不会使用的词汇/短语
emotional_baseline
감정 기준선默认情绪状态
triggers
트리거引发情绪反应的因素
示例:
/writer-memory char add 새랑
/writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택"
/writer-memory char update 새랑 tone "담백, 현재충실, 감정억제"
/writer-memory char update 새랑 speechLevel "해체"
/writer-memory char update 새랑 keywords "그냥, 뭐, 괜찮아"
/writer-memory char update 새랑 taboo "사랑해, 보고싶어"

세계관 메모리 (World Memory)

세계관 메모리(世界观记忆)

Establishes the universe your story inhabits:
FieldKoreanDescription
setting
배경Time, place, social context
rules
규칙How the world operates (magic systems, social norms)
atmosphere
분위기Overall mood and tone
constraints
제약What cannot happen in this world
history
역사Relevant backstory
构建故事所处的世界观:
字段韩语描述
setting
배경时间、地点、社会背景
rules
규칙世界运行规则(魔法体系、社会规范等)
atmosphere
분위기整体氛围与基调
constraints
제약世界中不可能发生的事
history
역사相关背景故事

관계 메모리 (Relationship Memory)

관계 메모리(人物关系记忆)

Captures the dynamic between characters over time:
FieldDescription
type
Base relationship: romantic, familial, friendship, rivalry, professional
status
Current state: budding, stable, strained, broken, healing
power_dynamic
Who has the upper hand, if any
events
Timeline of relationship-changing moments
tension
Current unresolved conflicts
intimacy_level
Emotional closeness (1-10)
Example:
/writer-memory rel add 새랑 해랑 romantic
/writer-memory rel update 새랑 해랑 "첫 키스 - 새랑 회피"
/writer-memory rel update 새랑 해랑 "해랑 고백 거절당함"
/writer-memory rel update 새랑 해랑 "새랑 먼저 손 잡음"
捕捉角色间随时间变化的互动关系:
字段描述
type
基础关系类型:浪漫、家庭、友谊、竞争、职场
status
当前状态:萌芽、稳定、紧张、破裂、修复
power_dynamic
权力平衡(若存在主导方)
events
改变关系的关键事件时间线
tension
当前未解决的矛盾
intimacy_level
情感亲密程度(1-10)
示例:
/writer-memory rel add 새랑 해랑 romantic
/writer-memory rel update 새랑 해랑 "첫 키스 - 새랑 회피"
/writer-memory rel update 새랑 해랑 "해랑 고백 거절당함"
/writer-memory rel update 새랑 해랑 "새랑 먼저 손 잡음"

장면 메모리 (Scene Memory)

장면 메모리(场景记忆)

Tracks individual scenes and their emotional architecture:
FieldKoreanDescription
title
제목Scene identifier
characters
등장인물Who appears
location
장소Where it happens
cuts
컷 구성Shot-by-shot breakdown
narration_tone
내레이션 톤Narrative voice style
emotional_tag
감정 태그Primary emotions (e.g., "설렘+불안")
purpose
목적Why this scene exists in the story
before_after
전후 변화What changes for characters
追踪单个场景及其情感架构:
字段韩语描述
title
제목场景标识
characters
등장인물出场角色
location
장소发生地点
cuts
컷 구성分镜头 breakdown
narration_tone
내레이션 톤叙事语气风格
emotional_tag
감정 태그核心情感(例如:"설렘+불안")
purpose
목적场景在故事中的作用
before_after
전후 변화角色在场景前后的变化

테마 메모리 (Theme Memory)

테마 메모리(主题记忆)

Captures the deeper meaning woven through your story:
FieldKoreanDescription
name
이름Theme identifier
expression
표현 방식How this theme manifests
scenes
관련 장면Scenes that embody this theme
character_links
캐릭터 연결Which characters carry this theme
author_intent
작가 의도What you want readers to feel
捕捉故事中贯穿的深层含义:
字段韩语描述
name
이름主题标识
expression
표현 방식主题的呈现方式
scenes
관련 장면体现该主题的场景
character_links
캐릭터 연결承载该主题的角色
author_intent
작가 의도希望读者感受到的内容

Synopsis Generation (시놉시스)

梗概生成(시놉시스)

The
/synopsis
command generates an emotion-focused summary using 5 essential elements:
/synopsis
命令使用5个核心元素生成聚焦情感的故事梗概:

5 Essential Elements (시놉시스 5요소)

5个核心元素(시놉시스 5요소)

  1. 주인공 태도 요약 (Protagonist Attitude Summary)
    • How the protagonist approaches life/love/conflict
    • Their core emotional stance
    • Example: "새랑은 상실을 예방하기 위해 먼저 포기하는 사람"
  2. 관계 핵심 구도 (Core Relationship Structure)
    • The central dynamic driving the story
    • Power imbalances and tensions
    • Example: "사랑받는 자와 사랑하는 자의 불균형"
  3. 정서적 테마 (Emotional Theme)
    • The feeling the story evokes
    • Not plot, but emotional truth
    • Example: "손에 쥔 행복을 믿지 못하는 불안"
  4. 장르 vs 실제감정 대비 (Genre vs Real Emotion Contrast)
    • Surface genre expectations vs. actual emotional content
    • Example: "로맨스지만 본질은 자기수용 서사"
  5. 엔딩 정서 잔상 (Ending Emotional Aftertaste)
    • The lingering feeling after the story ends
    • Example: "씁쓸한 안도, 불완전한 해피엔딩의 여운"
  1. 주인공 태도 요약(主角态度总结)
    • 主角面对生活/爱情/冲突的态度
    • 核心情感立场
    • 示例:"새랑은 상실을 예방하기 위해 먼저 포기하는 사람"
  2. 관계 핵심 구도(核心人物关系结构)
    • 驱动故事的核心互动关系
    • 权力失衡与矛盾
    • 示例:"사랑받는 자와 사랑하는 자의 불균형"
  3. 정서적 테마(情感主题)
    • 故事传递的情感
    • 非情节,而是情感真相
    • 示例:"손에 쥔 행복을 믿지 못하는 불안"
  4. 장르 vs 실제감정 대비(类型与真实情感对比)
    • 表面类型预期与实际情感内容的差异
    • 示例:"로맨스지만 본질은 자기수용 서사"
  5. 엔딩 정서 잔상(结局情感余韵)
    • 故事结束后残留的感受
    • 示例:"씁쓸한 안도, 불완전한 해피엔딩의 여운"

Character Validation (캐릭터 검증)

角色验证(캐릭터 검증)

The
/validate
command checks if dialogue matches a character's established voice.
/validate
命令检查对话是否符合角色设定的语气。

What Gets Checked

检查内容

CheckDescription
Speech LevelDoes formality match? (반말/존댓말/해체)
Tone MatchDoes the emotional register fit?
Keyword UsageUses characteristic words?
Taboo ViolationUses forbidden words?
Emotional RangeWithin character's baseline?
Context FitAppropriate for relationship and scene?
检查项描述
语体正式程度是否匹配?(반말/존댓말/해체)
语气匹配度情感基调是否符合?
关键词使用是否使用标志性词汇?
禁忌词违规是否使用禁用词汇?
情绪范围是否在角色的基准情绪范围内?
上下文适配性是否符合人物关系与场景?

Validation Results

验证结果

  • PASS: Dialogue is consistent with character
  • WARN: Minor inconsistencies, may be intentional
  • FAIL: Significant deviation from established voice
Example:
/writer-memory validate 새랑 "사랑해, 해랑아. 너무 보고싶었어."
Output:
[FAIL] 새랑 validation failed:
- TABOO: "사랑해" - character avoids direct declarations
- TABOO: "보고싶었어" - character suppresses longing expressions
- TONE: Too emotionally direct for 새랑's 담백 style

Suggested alternatives:
- "...왔네." (minimal acknowledgment)
- "늦었다." (deflection to external fact)
- "밥 먹었어?" (care expressed through practical concern)
  • 通过:对话与角色设定一致
  • 警告:轻微不一致,可能是有意为之
  • 失败:与设定语气严重不符
示例:
/writer-memory validate 새랑 "사랑해, 해랑아. 너무 보고싶었어."
输出:
[FAIL] 새랑 validation failed:
- TABOO: "사랑해" - character avoids direct declarations
- TABOO: "보고싶었어" - character suppresses longing expressions
- TONE: Too emotionally direct for 새랑's 담백 style

Suggested alternatives:
- "...왔네." (minimal acknowledgment)
- "늦었다." (deflection to external fact)
- "밥 먹었어?" (care expressed through practical concern)

Context Query (맥락 질의)

上下文查询(맥락 질의)

Natural language queries against memory, with full Korean support.
支持自然语言查询记忆库,完全支持韩语。

Example Queries

查询示例

/writer-memory query "새랑은 이 상황에서 뭐라고 할까?"
/writer-memory query "규리의 현재 감정 상태는?"
/writer-memory query "해랑과 새랑의 관계는 어디까지 왔나?"
/writer-memory query "이 장면의 정서적 분위기는?"
/writer-memory query "새랑이 먼저 연락하는 게 맞아?"
/writer-memory query "해랑이 화났을 때 말투는?"
The system synthesizes answers from all relevant memory types.
/writer-memory query "새랑은 이 상황에서 뭐라고 할까?"
/writer-memory query "규리의 현재 감정 상태는?"
/writer-memory query "해랑과 새랑의 관계는 어디까지 왔나?"
/writer-memory query "이 장면의 정서적 분위기는?"
/writer-memory query "새랑이 먼저 연락하는 게 맞아?"
/writer-memory query "해랑이 화났을 때 말투는?"
系统会综合所有相关记忆库类型的信息生成答案。

Behavior

行为特性

  1. On Init: Creates
    .writer-memory/memory.json
    with project metadata and empty collections
  2. Auto-Backup: Changes are backed up before modification to
    .writer-memory/backups/
  3. Korean-First: Emotion vocabulary uses Korean terms throughout
  4. Session Loading: Memory is loaded on session start for immediate context
  5. Git-Friendly: JSON formatted for clean diffs and collaboration
  1. 初始化时:创建
    .writer-memory/memory.json
    文件,包含项目元数据和空的集合
  2. 自动备份:修改前会将数据备份到
    .writer-memory/backups/
    目录
  3. 韩语优先:情感词汇全程使用韩语术语
  4. 会话加载:会话启动时自动加载记忆库,即时获取上下文
  5. Git友好:JSON格式便于清晰的差异对比与协作

Integration

集成

With OMC Notepad System

与OMC记事本系统集成

Writer Memory integrates with
.omc/notepad.md
:
  • Scene ideas can be captured as notes
  • Character insights from analysis sessions are preserved
  • Cross-reference between notepad and memory
Writer Memory 可与
.omc/notepad.md
集成:
  • 场景想法可作为笔记捕获
  • 分析会话中得到的角色见解会被保留
  • 记事本与记忆库可相互交叉引用

With Architect Agent

与Architect Agent集成

For complex character analysis:
Task(subagent_type="oh-my-claudecode:architect",
     model="opus",
     prompt="Analyze 새랑's arc across all scenes...")
用于复杂角色分析:
Task(subagent_type="oh-my-claudecode:architect",
     model="opus",
     prompt="Analyze 새랑's arc across all scenes...")

Character Validation Pipeline

角色验证流程

Validation pulls context from:
  • Character memory (tone, keywords, taboo)
  • Relationship memory (dynamics with dialogue partner)
  • Scene memory (current emotional context)
  • Theme memory (authorial intent)
验证会从以下来源获取上下文:
  • 角色记忆库(语气、关键词、禁忌词)
  • 人物关系记忆库(与对话对象的互动关系)
  • 场景记忆库(当前情感上下文)
  • 主题记忆库(创作者意图)

Synopsis Builder

梗概生成器

Synopsis generation aggregates:
  • All character arcs
  • Key relationship events
  • Scene emotional tags
  • Theme expressions
梗概生成会聚合以下内容:
  • 所有角色的情感弧光
  • 关键人物关系事件
  • 场景情感标签
  • 主题呈现方式

Examples

示例

Full Workflow

完整工作流

undefined
undefined

Initialize project

Initialize project

/writer-memory init 봄의 끝자락
/writer-memory init 봄의 끝자락

Add characters

Add characters

/writer-memory char add 새랑 /writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택" /writer-memory char update 새랑 tone "담백, 현재충실" /writer-memory char update 새랑 speechLevel "해체"
/writer-memory char add 해랑 /writer-memory char update 해랑 arc "확신 -> 동요 -> 기다림" /writer-memory char update 해랑 tone "직진, 솔직" /writer-memory char update 해랑 speechLevel "반말"
/writer-memory char add 새랑 /writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택" /writer-memory char update 새랑 tone "담백, 현재충실" /writer-memory char update 새랑 speechLevel "해체"
/writer-memory char add 해랑 /writer-memory char update 해랑 arc "확신 -> 동요 -> 기다림" /writer-memory char update 해랑 tone "직진, 솔직" /writer-memory char update 해랑 speechLevel "반말"

Establish relationship

Establish relationship

/writer-memory rel add 새랑 해랑 romantic /writer-memory rel update 새랑 해랑 "첫 만남 - 해랑 일방적 호감" /writer-memory rel update 새랑 해랑 "새랑 거절" /writer-memory rel update 새랑 해랑 "재회 - 새랑 내적 동요"
/writer-memory rel add 새랑 해랑 romantic /writer-memory rel update 새랑 해랑 "첫 만남 - 해랑 일방적 호감" /writer-memory rel update 새랑 해랑 "새랑 거절" /writer-memory rel update 새랑 해랑 "재회 - 새랑 내적 동요"

Set world

Set world

/writer-memory world set setting "서울, 현대, 20대 후반 직장인" /writer-memory world set atmosphere "도시의 건조함 속 미묘한 온기"
/writer-memory world set setting "서울, 현대, 20대 후반 직장인" /writer-memory world set atmosphere "도시의 건조함 속 미묘한 온기"

Add themes

Add themes

/writer-memory theme add "포기하지 않는 사랑" /writer-memory theme add "자기 보호의 벽"
/writer-memory theme add "포기하지 않는 사랑" /writer-memory theme add "자기 보호의 벽"

Add scene

Add scene

/writer-memory scene add "옥상 재회"
/writer-memory scene add "옥상 재회"

Query for writing

Query for writing

/writer-memory query "새랑은 이별 장면에서 어떤 톤으로 말할까?"
/writer-memory query "새랑은 이별 장면에서 어떤 톤으로 말할까?"

Validate dialogue

Validate dialogue

/writer-memory validate 새랑 "해랑아, 그만하자."
/writer-memory validate 새랑 "해랑아, 그만하자."

Generate synopsis

Generate synopsis

/writer-memory synopsis
/writer-memory synopsis

Export for reference

Export for reference

/writer-memory export
undefined
/writer-memory export
undefined

Quick Character Check

快速角色检查

/writer-memory char 새랑
Output:
undefined
/writer-memory char 새랑
输出:
undefined

새랑

새랑

Arc (감정궤도): 체념 -> 욕망자각 -> 선택 Attitude (태도): 방어적, 현실주의 Tone (대사톤): 담백, 현재충실 Speech Level (말투): 해체 Keywords (핵심어): 그냥, 뭐, 괜찮아 Taboo (금기어): 사랑해, 보고싶어
Relationships:
  • 해랑: romantic (intimacy: 6/10, status: healing)
Scenes Appeared: 옥상 재회, 카페 대화, 마지막 선택
undefined
Arc (감정궤도): 체념 -> 욕망자각 -> 선택 Attitude (태도): 방어적, 현실주의 Tone (대사톤): 담백, 현재충실 Speech Level (말투): 해체 Keywords (핵심어): 그냥, 뭐, 괜찮아 Taboo (금기어): 사랑해, 보고싶어
Relationships:
  • 해랑: romantic (intimacy: 6/10, status: healing)
Scenes Appeared: 옥상 재회, 카페 대화, 마지막 선택
undefined

Storage Schema

存储架构

json
{
  "version": "1.0",
  "project": {
    "name": "봄의 끝자락",
    "genre": "로맨스",
    "created": "2024-01-15T09:00:00Z",
    "lastModified": "2024-01-20T14:30:00Z"
  },
  "characters": {
    "새랑": {
      "arc": "체념 -> 욕망자각 -> 선택",
      "attitude": "방어적, 현실주의",
      "tone": "담백, 현재충실",
      "speechLevel": "해체",
      "keywords": ["그냥", "뭐", "괜찮아"],
      "taboo": ["사랑해", "보고싶어"],
      "emotional_baseline": "평온한 무관심",
      "triggers": ["과거 언급", "미래 약속"]
    }
  },
  "world": {
    "setting": "서울, 현대, 20대 후반 직장인",
    "rules": [],
    "atmosphere": "도시의 건조함 속 미묘한 온기",
    "constraints": [],
    "history": ""
  },
  "relationships": [
    {
      "id": "rel_001",
      "from": "새랑",
      "to": "해랑",
      "type": "romantic",
      "dynamic": "해랑 주도 → 균형",
      "speechLevel": "반말",
      "evolution": [
        { "timestamp": "...", "change": "첫 만남 - 해랑 일방적 호감", "catalyst": "우연한 만남" },
        { "timestamp": "...", "change": "새랑 거절", "catalyst": "과거 트라우마" },
        { "timestamp": "...", "change": "재회 - 새랑 내적 동요", "catalyst": "옥상에서 재회" }
      ],
      "notes": "새랑의 불신 vs 해랑의 기다림",
      "created": "..."
    }
  ],
  "scenes": [
    {
      "id": "scene-001",
      "title": "옥상 재회",
      "characters": ["새랑", "해랑"],
      "location": "회사 옥상",
      "cuts": ["해랑 먼저 발견", "새랑 굳은 표정", "침묵", "해랑 먼저 말 걸기"],
      "narration_tone": "건조체",
      "emotional_tag": "긴장+그리움",
      "purpose": "재회의 어색함과 남은 감정 암시",
      "before_after": "새랑: 무관심 -> 동요"
    }
  ],
  "themes": [
    {
      "name": "포기하지 않는 사랑",
      "expression": "해랑의 일관된 태도",
      "scenes": ["옥상 재회", "마지막 고백"],
      "character_links": ["해랑"],
      "author_intent": "집착이 아닌 믿음의 사랑"
    }
  ],
  "synopsis": {
    "protagonist_attitude": "새랑은 상실을 예방하기 위해 먼저 포기하는 사람",
    "relationship_structure": "기다리는 자와 도망치는 자의 줄다리기",
    "emotional_theme": "사랑받을 자격에 대한 의심",
    "genre_contrast": "로맨스지만 본질은 자기수용 서사",
    "ending_aftertaste": "불완전하지만 따뜻한 선택의 여운"
  }
}
json
{
  "version": "1.0",
  "project": {
    "name": "봄의 끝자락",
    "genre": "로맨스",
    "created": "2024-01-15T09:00:00Z",
    "lastModified": "2024-01-20T14:30:00Z"
  },
  "characters": {
    "새랑": {
      "arc": "체념 -> 욕망자각 -> 선택",
      "attitude": "방어적, 현실주의",
      "tone": "담백, 현재충실",
      "speechLevel": "해체",
      "keywords": ["그냥", "뭐", "괜찮아"],
      "taboo": ["사랑해", "보고싶어"],
      "emotional_baseline": "평온한 무관심",
      "triggers": ["과거 언급", "미래 약속"]
    }
  },
  "world": {
    "setting": "서울, 현대, 20대 후반 직장인",
    "rules": [],
    "atmosphere": "도시의 건조함 속 미묘한 온기",
    "constraints": [],
    "history": ""
  },
  "relationships": [
    {
      "id": "rel_001",
      "from": "새랑",
      "to": "해랑",
      "type": "romantic",
      "dynamic": "해랑 주도 → 균형",
      "speechLevel": "반말",
      "evolution": [
        { "timestamp": "...", "change": "첫 만남 - 해랑 일방적 호감", "catalyst": "우연한 만남" },
        { "timestamp": "...", "change": "새랑 거절", "catalyst": "과거 트라우마" },
        { "timestamp": "...", "change": "재회 - 새랑 내적 동요", "catalyst": "옥상에서 재회" }
      ],
      "notes": "새랑의 불신 vs 해랑의 기다림",
      "created": "..."
    }
  ],
  "scenes": [
    {
      "id": "scene-001",
      "title": "옥상 재회",
      "characters": ["새랑", "해랑"],
      "location": "회사 옥상",
      "cuts": ["해랑 먼저 발견", "새랑 굳은 표정", "침묵", "해랑 먼저 말 걸기"],
      "narration_tone": "건조체",
      "emotional_tag": "긴장+그리움",
      "purpose": "재회의 어색함과 남은 감정 암시",
      "before_after": "새랑: 무관심 -> 동요"
    }
  ],
  "themes": [
    {
      "name": "포기하지 않는 사랑",
      "expression": "해랑의 일관된 태도",
      "scenes": ["옥상 재회", "마지막 고백"],
      "character_links": ["해랑"],
      "author_intent": "집착이 아닌 믿음의 사랑"
    }
  ],
  "synopsis": {
    "protagonist_attitude": "새랑은 상실을 예방하기 위해 먼저 포기하는 사람",
    "relationship_structure": "기다리는 자와 도망치는 자의 줄다리기",
    "emotional_theme": "사랑받을 자격에 대한 의심",
    "genre_contrast": "로맨스지만 본질은 자기수용 서사",
    "ending_aftertaste": "불완전하지만 따뜻한 선택의 여운"
  }
}

File Structure

文件结构

.writer-memory/
├── memory.json          # Main memory file
├── backups/             # Auto-backups before changes
│   ├── memory-2024-01-15-090000.json
│   └── memory-2024-01-20-143000.json
└── exports/             # Markdown exports
    └── export-2024-01-20.md
.writer-memory/
├── memory.json          # Main memory file
├── backups/             # Auto-backups before changes
│   ├── memory-2024-01-15-090000.json
│   └── memory-2024-01-20-143000.json
└── exports/             # Markdown exports
    └── export-2024-01-20.md

Tips for Writers

创作者小贴士

  1. Start with Characters: Build character memories before scenes
  2. Update Relationships After Key Scenes: Track evolution actively
  3. Use Validation While Writing: Catch voice inconsistencies early
  4. Query Before Difficult Scenes: Let the system remind you of context
  5. Regular Synopsis: Generate periodically to check thematic coherence
  6. Backup Before Major Changes: Use
    /backup
    before significant story pivots
  1. 从角色开始:先构建角色记忆库,再创建场景
  2. 关键场景后更新关系:主动追踪人物关系的演变
  3. 写作时使用验证功能:尽早发现语气不一致的问题
  4. 困难场景前查询:让系统提醒你相关上下文
  5. 定期生成梗概:周期性生成以检查主题连贯性
  6. 重大修改前备份:在故事重大转折前使用
    /backup
    命令

Troubleshooting

故障排除

Memory not loading?
  • Check
    .writer-memory/memory.json
    exists
  • Verify JSON syntax is valid
  • Run
    /writer-memory status
    to diagnose
Validation too strict?
  • Review taboo list for unintended entries
  • Consider if character is growing (arc progression)
  • Intentional breaks from pattern are valid for dramatic moments
Query not finding context?
  • Ensure relevant data is in memory
  • Try more specific queries
  • Check character names match exactly
记忆库无法加载?
  • 检查
    .writer-memory/memory.json
    文件是否存在
  • 验证JSON语法是否有效
  • 运行
    /writer-memory status
    命令诊断问题
验证过于严格?
  • 检查禁忌词列表是否包含意外条目
  • 考虑角色是否在成长(情感弧光推进)
  • 有意打破设定模式可用于戏剧化时刻
查询无法找到上下文?
  • 确保相关数据已存入记忆库
  • 尝试更具体的查询
  • 检查角色名称是否完全匹配