캐릭터 형식 폐기 및 마이그레이션 가이드
폐기 예정인 캐릭터 형식을 인지하고, 캐릭터 카테고리가 있는 시트로 마이그레이션하는 방법. 속성 재연결, 캔버스·플롯보드·문서·백링크 업데이트 포함.
캐릭터 형식 폐기 및 마이그레이션 가이드
폐기 안내
캐릭터 파일 형식은 폐기 예정입니다. 캐릭터 파일을 캐릭터 카테고리가 있는 새 시트 형식으로 마이그레이션하는 것을 권장합니다. 새 형식은 앱 전반에서 지원되며 지속적으로 개선됩니다.
캐릭터 파일이 남아 있다면 열 때 폐기 안내가 표시됩니다. 이 가이드는 데이터와 연결을 유지한 채 캐릭터를 시트로 마이그레이션하는 방법을 설명합니다.
마이그레이션 개요
마이그레이션은 다음 몇 단계로 진행합니다:
- 생성: 같은 폴더에 캐릭터 카테고리의 새 시트를 만듭니다(사이드바에서).
- 복사: 기존 캐릭터의 내용과 속성을 새 시트로 복사합니다.
- 재연결: 링크형 속성을 같은 대상(또는 마이그레이션한 새 시트)에 다시 연결합니다.
- 업데이트: 기존 캐릭터를 참조하던 모든 위치를 새 시트를 가리키도록 수정합니다(캔버스, 플롯보드, 문서, 백링크, 작업, 다른 시트/캐릭터).
4단계를 건너뛰면 기존 캐릭터로의 링크가 끊기거나 폐기된 파일을 계속 가리키게 됩니다.
1단계: 캐릭터 카테고리의 새 시트 만들기
- 사이드바에서 기존 캐릭터가 있는 같은 폴더로 이동합니다.
- "새로 만들기"(또는 "추가") 동작을 사용해 시트를 선택합니다.
- 시트를 만들거나 편집할 때 카테고리를 캐릭터로 설정합니다(시트 헤더 또는 시트 설정에서).
- 캐릭터와 같은 제목을 시트에 붙이거나 원하는 이름을 지정하고, 폴더 내 원하는 위치에 둡니다.

사이드바에서 새로 만들기 → 시트, 카테고리를 캐릭터로 설정
이제 기존 캐릭터를 대체할 빈 시트가 준비되었습니다.
2단계: 내용과 속성 복사
- 기존 캐릭터와 새 시트를 엽니다(두 창 또는 탭에서).
- 캐릭터 본문/에디터의 메인 내용을 시트 에디터로 복사·붙여넣기 합니다.
- 속성 복사:
- 캐릭터의 텍스트(또는 비링크) 속성마다 시트에 같은 속성을 추가하고 값을 붙여넣습니다.
- 링크형 속성(문서, 캐릭터, 플롯보드, 폴더)은 시트에 같은 속성을 추가하되 원시 ID를 붙여넣지 마세요—다음 단계에서 다시 연결합니다.
캐릭터에 초상화나 다른 미디어가 있었다면, UI에서 지원하는 경우 시트에 다시 추가하거나 업로드합니다.
3단계: 링크형 속성 재연결
다른 파일에 연결할 수 있는 속성(예: "관련 문서", "관련 캐릭터", "관련 플롯보드", "관련 폴더")은 새 시트에서 다시 연결해야 합니다:
- 같은 대상: 연결된 파일이 그대로인 경우(예: 다른 문서나 마이그레이션하지 않은 시트), 시트의 "링크"/"연결" UI로 해당 파일에 다시 연결합니다.
- 마이그레이션된 대상: 연결된 파일이 시트로 마이그레이션한 다른 캐릭터였다면, 기존 캐릭터 대신 새 시트에 연결합니다.
모든 링크형 속성에 대해 이 작업을 수행해 새 시트가 기존 캐릭터와 동일한 관계를 갖도록 합니다(올바른 현재 파일을 가리키도록).
🚨 4단계: 기존 캐릭터 참조 업데이트 (중요)
기존 캐릭터를 가리키던 모든 항목을 새 시트를 가리키도록 업데이트해야 합니다. 그렇지 않으면 링크가 끊기거나 폐기된 파일을 가리키게 됩니다.
다음을 확인하고 업데이트하세요:
| 위치 | 할 일 |
|---|---|
| 캔버스 | 기존 캐릭터에 연결된 캔버스 노드나 카드는 새 시트에 연결되도록 업데이트합니다(연결된 파일을 기존 캐릭터에서 새 시트로 변경). |
| 플롯보드 | 기존 캐릭터를 언급하거나 연결한 플롯 파트나 플롯보드는 새 시트를 언급하거나 연결하도록 업데이트합니다. |
| 문서 | 문서 에디터에서 기존 캐릭터를 참조하던 캐릭터 멘션을 새 시트를 참조하도록 수정합니다(멘션을 편집해 새 시트를 가리키게 함). |
| 백링크 | 이 캐릭터로 링크하는 다른 파일(문서, 시트, 플롯보드 등)은 백링크로 표시됩니다. 각 파일에서 기존 캐릭터에서 새 시트로 링크를 변경합니다. |
| 시트 및 캐릭터 | 이 캐릭터를 가리키는 "관련 캐릭터"(또는 유사) 속성이 있는 시트나 캐릭터는 새 시트를 가리키도록 편집합니다. |
| 작업 | 작업이 기존 캐릭터 파일에 연결되어 있다면 새 시트에 연결되도록 업데이트합니다. |
| 관계 그래프 | 관계 그래프를 사용한다면, 이 엔티티가 포함된 관계가 새 시트를 사용하도록 확인합니다. |
이후에는 기존 캐릭터를 참조하는 항목이 없습니다. 잠시 백업으로 보관해 두었다가 새 시트로 모두 전환된 것이 확실하면 삭제해도 됩니다.
요약
- 폐기 예정: 캐릭터 파일 형식. 권장: 캐릭터 카테고리가 있는 시트 사용.
- 마이그레이션: 같은 폴더에 시트(캐릭터 카테고리) 생성 → 내용·속성 복사 → 링크형 속성 재연결 → 모든 참조 업데이트(캔버스, 플롯보드, 문서, 백링크, 다른 시트/캐릭터, 작업, 관계 그래프).
- 주의: 기존 캐릭터를 참조하던 모든 위치를 새 시트로 업데이트해야 하며, 그렇지 않으면 링크가 끊기거나 폐기된 파일을 가리키게 됩니다.
궁금한 점이 있으면 team@pensiv.so로 문의하거나 Discord에 참여해 주세요.