世界書檔案結構¶

gonovelmaker 使用結構化的 Markdown 檔案組織小說專案，所有檔案都使用 YAML frontmatter 儲存元數據。本頁面詳細說明各類檔案的格式和欄位。

專案結構概覽¶

your-novel-vault/
├── Config/
│   ├── project.md              # 專案設定檔
│   ├── chapter_prompt.md       # 章節提示詞範本（可選）
│   └── character_prompt.md     # 角色提示詞範本（可選）
├── World/
│   ├── 001_world_sample.md     # 世界觀條目
│   ├── 002_magic_system.md
│   └── 003_geography.md
├── Character/
│   ├── protagonist.md          # 角色檔案
│   ├── protagonist.png         # 角色圖片（可選）
│   ├── supporting_char.md
│   └── villain.md
├── Story/
│   ├── 001_prologue.md         # 章節檔案
│   ├── 002_ch1.md
│   ├── 003_ch2.md
│   └── ...
├── .obsidian/                  # Obsidian 設定
│   └── plugins/
│       └── obsidian-novelmaker/
└── README.md                   # 專案說明

Config/project.md¶

專案設定檔，定義整個小說專案的基本資訊。

Frontmatter 欄位¶

---
name: 專案名稱
---

欄位	類型	必需	說明
`name`	string	✅	專案名稱（小說標題）

內容區域¶

frontmatter 之後的內容用於描述專案概要、世界觀、系統提示詞等。

完整範例¶

---
name: 魔法學院編年史
---

一個充滿魔法的奇幻世界，故事發生在艾瑟利亞大陸的魔法學院中。

艾瑟利亞大陸分為五個王國，魔法是這個世界的核心力量。
魔法學院是培養魔法師的聖地，每年招收來自各地的有天賦的年輕人。

World/ 目錄¶

世界觀條目，用於描述世界設定、魔法系統、地理、歷史等背景資訊。

Frontmatter 欄位¶

---
tags: [標籤1, 標籤2, ...]
---

欄位	類型	必需	說明
`tags`	array	❌	分類標籤

標籤說明¶

標籤是用來做 RAG 檢索的關鍵字，建議使用與條目內容相關的詞彙。

範例¶

---
tags: [magic-system, rules]
---

# 魔法系統

## 元素魔法

魔法分為五大元素：火、水、風、地、光。

### 火系魔法
- 攻擊性強，適合戰鬥
- 需要強烈的情緒作為燃料
- 代表咒語：火球術、炎爆

### 水系魔法
- 防禦與治療為主
- 需要平靜的心境
- 代表咒語：水盾、治癒之泉

## 魔法學習

1. **感知階段**：感受魔力流動（1年）
2. **引導階段**：學習控制魔力（2-3年）
3. **施法階段**：掌握基礎咒語（3-5年）
4. **精通階段**：開發獨特魔法（終生）

## 限制

- 每次施法消耗魔力值
- 魔力復原需要休息
- 超載使用會導致魔力枯竭
- 某些禁忌魔法有嚴重副作用

Character/ 目錄¶

角色檔案，描述小說中的人物設定。

Frontmatter 欄位¶

---
name: 角色名稱
main: true
prompt: 角色生成提示詞
---

欄位	類型	必需	說明
`name`	string	✅	角色名稱
`main`	boolean	❌	是否為主要角色
`prompt`	string	✅	用於重新生成的提示詞

建議結構¶

角色檔案的內容建議包含以下部分：

基本資料：年齡、職業、種族等
外貌描述：身高、體型、特徵
性格特點：個性、習慣、口頭禪
背景故事：成長經歷、重要事件
能力技能：擅長領域、特殊能力
人際關係：與其他角色的關係
目標動機：行為驅動力、長期目標

完整範例¶

---
name: 艾莉絲·火羽
main: true
prompt: 16歲的魔法學院新生，擁有罕見的雙元素天賦（火與風），性格活潑好奇，來自鄉村
image: alice_firewing.png
---

# 艾莉絲·火羽

## 基本資料

- **年齡**：16歲
- **性別**：女
- **種族**：人類
- **職業**：魔法學院一年級學生
- **出生地**：南方省的小村莊「綠谷村」
- **家庭**：父親是鐵匠，母親是草藥師

## 外貌描述

- **身高**：165公分
- **體型**：纖瘦靈活
- **髮色**：火紅色長髮，通常綁成馬尾
- **瞳色**：翠綠色，情緒激動時會發出微光
- **特徵**：左手腕有火焰形狀的胎記
- **穿著**：學院制服（藍色長袍，鳳凰徽章）

## 性格特點

- **優點**：
  - 充滿好奇心，勇於探索
  - 樂觀開朗，容易交朋友
  - 學習熱情高，不怕困難
  - 富有同情心，樂於助人

- **缺點**：
  - 有時過於衝動，不考慮後果
  - 對規則較不重視
  - 容易被挑釁
  - 過度自信

- **口頭禪**：「沒問題，交給我！」

## 背景故事

艾莉絲出生在偏遠的綠谷村，從小就對魔法充滿嚮往。
8歲時，村莊遭受魔獸襲擊，她在危急時刻無意中釋放出火焰魔法，
嚇退了魔獸。這個事件讓她的天賦被發現。

經過8年的等待和基礎訓練，16歲時她終於收到魔法學院的入學通知。
她帶著全村人的期望，離開家鄉前往首都。

## 能力技能

### 魔法天賦

- **雙元素親和**：火系 + 風系（極為罕見）
- **魔力值**：中等偏上，仍在成長
- **控制力**：尚在學習階段，有時會失控

### 已掌握咒語

1. **火球術**（初級）- 投擲小型火球
2. **火焰之手**（初級）- 手部纏繞火焰
3. **疾風術**（初級）- 產生強風
4. **組合魔法：炎風螺旋**（自創，不穩定）

### 非魔法技能

- 草藥知識（從母親處學習）
- 基礎鍛造（從父親處學習）
- 攀爬與跑步（鄉村生活培養）

## 人際關係

### 家人

- **父親 - 瓦特·火羽**：村莊鐵匠，支持女兒的夢想
- **母親 - 羅莎·火羽**：草藥師，擔心女兒但全力支持

### 學院好友

- **[[托比·水鏡]]**：同班同學，水系魔法師，互補的友誼
- **[[莉莉·星辰]]**：室友，光系魔法師，性格較內向

### 導師

- **[[梅林教授]]**：空間魔法教授，嚴格但關心學生

### 競爭對手

- **[[達克斯·暗影]]**：高年級學生，看不起平民出身的魔法師

## 目標與動機

### 短期目標

- 在學院中取得優異成績
- 掌握火風雙元素的組合魔法
- 結交更多朋友，了解魔法世界

### 長期目標

- 成為一流的魔法師
- 保護家鄉，讓村民過上更好的生活
- 探索雙元素天賦的秘密

### 內在衝突

- 鄉村出身的自卑感 vs. 想要證明自己的決心
- 遵守學院規則 vs. 好奇心驅使的冒險慾望

## 備註

艾莉絲代表著「平凡中的不平凡」主題，
她的成長之路象徵著突破階級與出身限制的可能性。

角色圖片¶

角色圖片使用相同檔案名儲存在 Character/ 目錄：

Character/
  ├── alice.md
  ├── alice.png        # 使用 gen-char-img 生成
  ├── merlin.md
  └── merlin.png

在 Markdown 中引用：

![艾莉絲](alice.png)

Story/ 目錄¶

章節檔案，儲存小說的實際內容。

Frontmatter 欄位¶

---
index: 1
title: 章節標題
prompt: 生成提示詞
---

欄位	類型	必需	說明
`index`	integer	✅	章節順序（用於排序）
`title`	string	✅	章節標題
`prompt`	string	✅	用於重新生成的提示詞

檔案命名規範¶

{index}_{slug}.md

範例：

001_prologue.md - 序章
002_ch1.md - 第一章
003_ch2.md - 第二章
010_ch9.md - 第九章

命名建議

使用三位數字前綴（001, 002, ...）確保檔案排序正確，最多支援 999 章。

章節範例¶

---
index: 5
title: 第四章：秘密圖書館
prompt: 艾莉絲在深夜偷偷潛入圖書館禁區，發現一本神秘的古老魔法書。氛圍神秘緊張，展現她的好奇心和勇氣。
---

月光透過高大的彩色玻璃窗灑進圖書館，在地板上投下斑駁的光影。
艾莉絲小心翼翼地踮著腳尖，沿著書架之間的走道前進，心跳聲在寂靜中格外清晰。

「應該就在這附近...」她低聲自語，眼睛掃視著一排排古老的書籍。

突然，一本書封泛著微弱紅光的書吸引了她的注意...

[章節內容繼續...]

章節結構建議¶

開場：設定場景，營造氛圍
發展：展開劇情，角色互動
高潮：衝突或轉折點
結尾：留下懸念或過渡到下一章

下一步¶

🔧 CLI 命令 - 學習檔案操作命令