文件树与文件类型

zenstory 采用统一的文件系统来管理你的创作内容。所有文件都以树形结构组织，帮助你清晰地管理小说的各个组成部分。

文件树结构

文件树完整展示，显示左侧栏的文件夹层级结构

文件树位于界面左侧，采用经典的树形层级结构：

  • 文件夹（Folder）：用于组织和分类文件，支持嵌套
  • 文件：具体的创作内容，根据类型显示不同图标
  • 展开/折叠：点击文件夹可以展开或折叠其内容
  • 文件数量：每个文件夹右侧显示包含的文件数量

文件树会根据文件夹名称自动识别文件类型。例如，在"角色"文件夹中创建的文件会自动设置为角色卡类型。

四种核心文件类型

zenstory 支持四种核心文件类型，每种类型都有特定的用途和显示图标。

大纲（Outline）

用途：规划故事结构、章节安排、情节走向

特点：

  • 层级化结构，支持多级嵌套
  • 适合记录故事主线、分集大纲、情节要点
  • AI 可以基于大纲生成对应的手稿内容

典型用法：

  • 创建"大纲"文件夹，存放整体故事架构
  • 每个章节或情节点创建独立的大纲文件
  • 在 AI 对话中选中大纲，让 AI 据此生成正文

图标：文档图标（FileText）

手稿（Draft）

用途：撰写正文内容，是最终输出的核心

特点：

  • 富文本编辑器，支持格式化
  • 实时字数统计
  • 自动保存与版本历史
  • AI 可以续写、改写、扩写内容

典型用法：

  • 创建"正文"文件夹，按章节组织手稿
  • 选中手稿文件后，在 AI 对话中请求续写或修改
  • 利用版本历史功能回溯修改记录

图标：书本图标（BookOpen）

角色卡（Character）

用途：记录角色的详细设定和人物档案

包含信息：

  • 姓名、年龄、性别
  • 性格特点、人物关系
  • 外貌描述、穿着打扮
  • 背景故事、成长经历
  • 特殊能力、标志性特征

典型用法：

  • 创建"角色"文件夹，为每个主要角色建立档案
  • AI 在生成内容时会自动参考角色设定
  • 保持角色性格的一致性

图标：用户组图标（Users）

世界观（Lore）

用途：构建故事背景、世界设定、规则体系

包含信息：

  • 世界背景（时代、地点、环境）
  • 力量体系（魔法、武功、科技等）
  • 势力分布（国家、组织、门派）
  • 历史事件、重要设定
  • 社会规则、文化习俗

典型用法：

  • 创建"设定"文件夹，分类存放各类世界观设定
  • 常见分类：力量体系、势力、历史、地理等
  • AI 会根据世界观设定保持内容的逻辑一致性

图标：星星图标（Sparkles）

文件操作

新建文件

  1. 悬停在文件夹上，点击出现的 + 按钮
  2. 输入文件名称
  3. 按 Enter 确认创建，或按 Esc 取消

文件类型会根据所在文件夹自动识别：

  • "大纲"文件夹 → 大纲类型
  • "正文"文件夹 → 手稿类型
  • "角色"文件夹 → 角色卡类型
  • "设定"文件夹 → 世界观类型

重命名文件

目前需要通过删除并重新创建的方式重命名文件。后续版本将支持直接重命名功能。

删除文件

  1. 悬停在文件上，点击出现的 垃圾桶图标
  2. 确认删除操作

注意：删除操作不可恢复，请谨慎操作。

移动文件

目前暂不支持拖拽移动文件。后续版本将提供此功能。

文件夹管理

创建文件夹

  1. 在项目根目录下，点击 + 按钮创建新文件夹
  2. 输入文件夹名称（建议使用类型名称，如"大纲"、"角色"、"设定"等）

推荐的文件夹结构

项目名称
├── 大纲/           # 存放故事大纲
│   ├── 整体架构
│   └── 分集大纲
├── 正文/           # 存放手稿内容
│   ├── 第一章
│   ├── 第二章
│   └── ...
├── 角色/           # 存放角色设定
│   ├── 主角
│   ├── 配角A
│   └── ...
└── 设定/           # 存放世界观
    ├── 力量体系
    ├── 势力分布
    └── ...

展开/折叠文件夹

  • 点击文件夹名称展开或折叠
  • 展开后可以看到文件夹内的所有文件和子文件夹
  • 折叠后只显示文件夹名称和文件数量

快捷键

文件搜索

快捷键：Ctrl + K（Windows/Linux）或 Cmd + K（Mac）

快速搜索当前项目中的所有文件：

  1. 按下快捷键打开搜索框
  2. 输入文件名关键词（支持模糊匹配）
  3. 使用 上下箭头键 在结果中导航
  4. 按 Enter 打开选中的文件
  5. 按 Esc 关闭搜索

搜索特点：

  • 支持模糊匹配，不区分大小写
  • 按相关性排序（精确匹配 > 前缀匹配 > 包含匹配）
  • 显示文件的完整路径
  • 支持按文件类型筛选

其他快捷键

  • Enter：在新建文件输入框中确认创建
  • Esc：取消当前操作（新建、搜索等）
  • Delete：删除选中的文件（需确认）

小贴士

  1. 善用文件夹分类：清晰的文件夹结构有助于 AI 更好地理解项目结构，在对话时自动引用相关设定。

  2. 保持角色卡和世界观完整：AI 在生成内容时会参考这些设定，完整的设定能帮助 AI 保持内容的一致性。

  3. 利用大纲驱动创作：先创建详细的大纲，再让 AI 根据大纲生成正文，可以获得更符合预期的内容。

  4. 定期检查版本历史：手稿文件支持版本历史，可以随时回溯到之前的版本。

  5. 使用搜索快速定位：当项目文件较多时，使用 Ctrl/Cmd + K 快速搜索比手动浏览更高效。

常见问题

Q: 文件类型可以更改吗？ A: 目前文件类型在创建后无法直接更改。建议删除后重新创建正确类型的文件。

Q: 文件夹有数量限制吗？ A: 没有硬性限制，但建议保持结构清晰，避免过深的嵌套层级。

Q: AI 如何知道使用哪些设定？ A: AI 会自动分析对话上下文和选中的文件，智能引用相关的角色卡、世界观等设定。你也可以在对话中明确指定要参考的文件。

Q: 删除的文件可以恢复吗？ A: 目前删除操作是永久性的，无法恢复。后续版本将提供回收站功能。

File Tree & File Types

zenstory uses a unified file system to manage your creative content. All files are organized in a tree structure, helping you clearly manage the various components of your novel.

File Tree Structure

[Screenshot: Complete file tree view, showing the folder hierarchy in the left sidebar]

The file tree is located on the left side of the interface, using a classic hierarchical tree structure:

  • Folder: Used to organize and categorize files, supports nesting
  • File: Specific creative content, displays different icons based on type
  • Expand/Collapse: Click on a folder to expand or collapse its contents
  • File Count: The number of files contained is displayed on the right side of each folder

The file tree automatically identifies file types based on folder names. For example, files created in the "Characters" folder will automatically be set as character card type.

Four Core File Types

zenstory supports four core file types, each with a specific purpose and display icon.

Outline

[Screenshot: Outline file example, showing hierarchical chapter planning]

Purpose: Plan story structure, chapter arrangements, plot direction

Features:

  • Hierarchical structure, supports multi-level nesting
  • Ideal for recording main storylines, episode outlines, plot points
  • AI can generate corresponding draft content based on outlines

Typical Usage:

  • Create an "Outlines" folder to store the overall story architecture
  • Create separate outline files for each chapter or plot point
  • Select the outline in AI chat to have AI generate the main text based on it

Icon: Document icon (FileText)

Draft

[Screenshot: Draft file example, showing rich text editor and word count]

Purpose: Write actual content, the core of final output

Features:

  • Rich text editor, supports formatting
  • Real-time word count
  • Auto-save and version history
  • AI can continue, rewrite, or expand content

Typical Usage:

  • Create a "Drafts" folder to organize drafts by chapter
  • After selecting a draft file, request continuation or modification in AI chat
  • Use version history to track changes

Icon: Book icon (BookOpen)

Character Card

[Screenshot: Character card example, showing character name, personality, appearance, etc.]

Purpose: Record detailed character settings and profiles

Information Included:

  • Name, age, gender, identity
  • Personality traits, relationships
  • Physical description, attire
  • Background story, growth experience
  • Special abilities, signature features

Typical Usage:

  • Create a "Characters" folder, establish profiles for each main character
  • AI automatically references character settings when generating content
  • Maintain consistency in character personalities

Icon: User group icon (Users)

Lore

[Screenshot: Lore file example, showing power systems, faction distributions, etc.]

Purpose: Build story background, world settings, rule systems

Information Included:

  • World background (era, location, environment)
  • Power systems (magic, martial arts, technology, etc.)
  • Faction distributions (nations, organizations, sects)
  • Historical events, important settings
  • Social rules, cultural customs

Typical Usage:

  • Create a "Lore" folder to categorize and store various world-building settings
  • Common categories: power systems, factions, history, geography, etc.
  • AI maintains logical consistency in content based on lore settings

Icon: Sparkles icon

File Operations

Create New File

  1. Hover over a folder, click the + button that appears
  2. Enter the file name
  3. Press Enter to confirm creation, or press Esc to cancel

File type is automatically identified based on the folder:

  • "Outlines" folder -> Outline type
  • "Drafts" folder -> Draft type
  • "Characters" folder -> Character card type
  • "Lore" folder -> Lore type

Rename File

Currently, renaming files requires deleting and recreating them. Direct rename functionality will be supported in future versions.

Delete File

  1. Hover over a file, click the trash icon that appears
  2. Confirm the deletion

Note: Deletion is irreversible, please proceed with caution.

Move File

Drag-and-drop file moving is not currently supported. This feature will be provided in future versions.

Folder Management

Create Folder

  1. In the project root directory, click the + button to create a new folder
  2. Enter the folder name (recommended to use type names like "Outlines", "Characters", "Lore", etc.)

Recommended Folder Structure

Project Name
├── Outlines/        # Store story outlines
│   ├── Overall Structure
│   └── Episode Outlines
├── Drafts/          # Store draft content
│   ├── Chapter 1
│   ├── Chapter 2
│   └── ...
├── Characters/      # Store character settings
│   ├── Protagonist
│   ├── Supporting Character A
│   └── ...
└── Lore/            # Store world-building
    ├── Power System
    ├── Faction Distribution
    └── ...

Expand/Collapse Folders

  • Click the folder name to expand or collapse
  • When expanded, you can see all files and subfolders within the folder
  • When collapsed, only the folder name and file count are displayed

Keyboard Shortcuts

File Search

Shortcut: Ctrl + K (Windows/Linux) or Cmd + K (Mac)

Quickly search all files in the current project:

  1. Press the shortcut to open the search box
  2. Enter file name keywords (supports fuzzy matching)
  3. Use Up/Down arrow keys to navigate through results
  4. Press Enter to open the selected file
  5. Press Esc to close the search

Search Features:

  • Supports fuzzy matching, case-insensitive
  • Sorted by relevance (exact match > prefix match > contains match)
  • Displays the full path of files
  • Supports filtering by file type

Other Shortcuts

  • Enter: Confirm creation in the new file input box
  • Esc: Cancel current operation (new file, search, etc.)
  • Delete: Delete selected file (requires confirmation)

Tips

  1. Use folders effectively for categorization: A clear folder structure helps AI better understand the project structure and automatically reference relevant settings during conversations.

  2. Keep character cards and lore complete: AI references these settings when generating content. Complete settings help AI maintain content consistency.

  3. Use outlines to drive creation: First create detailed outlines, then have AI generate main text based on the outlines for more expected results.

  4. Check version history regularly: Draft files support version history, allowing you to revert to previous versions at any time.

  5. Use search to quickly locate: When the project has many files, using Ctrl/Cmd + K for quick search is more efficient than manual browsing.

FAQ

Q: Can file types be changed? A: Currently, file types cannot be directly changed after creation. It is recommended to delete and recreate the file with the correct type.

Q: Is there a limit on the number of folders? A: There is no hard limit, but it is recommended to keep the structure clear and avoid excessively deep nesting levels.

Q: How does AI know which settings to use? A: AI automatically analyzes the conversation context and selected files, intelligently referencing relevant character cards, lore, and other settings. You can also explicitly specify which files to reference in the conversation.

Q: Can deleted files be recovered? A: Currently, deletion is permanent and cannot be recovered. Future versions will provide a recycle bin feature.