@Mention

What Is @ Mention

When chatting with the AI, you can inject content from your novel as context to help the AI better understand your creative needs. Two types of references are supported:

  • Module references: Use the @ symbol to reference characters, scenes, chapters, and other modules — their full content is passed to the AI's context window
  • Text quotes: Select text passages from the editor to add to the conversation — the AI can analyze and work with specific paragraphs

Module References

What You Can Mention

You can @ any module in your current novel, including:

TypeExampleTypical Use
Characters@Lin WanerLet AI understand personality and background for in-character dialogue
Scenes@Imperial PalaceProvide environment details for accurate descriptions
Organizations@Royal GuardReference organizational structure and members
Props@Imperial SealAccess prop attributes and history
Settings@Magic SystemEnsure content follows world-building rules
Chapters@Chapter 3Reference existing chapter content for continuity

The module selector groups items by type for quick navigation.

How to Add

There are three ways to add modules as context for AI conversations:

Method 1: Trigger with @

  • Type @ in the AI assistant input field
  • A dropdown appears showing all modules in the current novel (grouped by type)
  • Continue typing to fuzzy-search and filter
  • Click or press Enter to select a module
  • The selected module appears as a badge in the input field

Method 2: Toolbar + Button

Click the + button on the left side of the AI assistant input field to open the same module selector dropdown. Selected modules appear as badges in the input field.

Method 3: Context Menu / Shortcut

Right-click any module in the module tree on the left panel and select "Add to Chat"; or select a module and press ⌘L to add it quickly.

Text Quotes

In addition to referencing entire modules, you can also quote specific text passages from the editor:

Select a text passage in the editor, then right-click and choose "Add to Chat" (or press ⌘L). The selected text will be added as a quote badge in the AI assistant input field, displayed as 📎 Chapter X, chars Y-Z, indicating the chapter and character position of the quote.

Keyboard Shortcut

ShortcutContextEffect
⌘LModule selected in the module treeAdd the selected module to the chat
⌘LText selected in the editorAdd the selected text as a quote to the chat

Manage Referenced Content

Selected modules appear as green badges in the input field, while text quotes appear as 📎 badges. Click the × on a badge to remove it. You can mention multiple modules and text passages in a single message to freely combine context.

Context Injection

When you send a message, all referenced content is injected into the AI's system prompt:

  • Module references: Injected as "Referenced Materials", including each module's title, type, and full content
  • Text quotes: Injected as "Text Quotes", including chapter info, character positions, and the actual text content
  • Overly long content is automatically truncated, preserving key information
  • Referenced content is sent alongside your message text, so the AI understands both "what you're saying" and "what you're referencing"

Use Cases

Character Dialogue Generation

@ two characters to have AI generate dialogue based on their personalities

@Lin Waner @Fan Xian Write a dialogue for their first meeting at the tavern

The AI reads both characters' full profiles (personality, speech patterns, background) and generates in-character dialogue.

Plot Continuation

@ a chapter outline or the previous chapter for AI to continue writing

@Chapter 5 Based on this chapter's ending, write the opening of Chapter 6

Setting Consistency Check

@ world-building settings to have AI verify content

@Magic System Does the spell usage in this battle scene follow the established rules?

Cross-Module Analysis

@ multiple modules to analyze relationships between them

@Lin Waner @Fan Xian @Emperor Qing Analyze the power dynamics between these three characters

Tips

  • Be precise: Only @ modules relevant to the current task — avoid injecting too much unrelated content that wastes the context window
  • Combine with skills: When triggering a skill (e.g., /character-operations), @ relevant characters so the AI can operate more precisely
  • Best in Agent mode: In Agent mode, AI can act on referenced content by calling tools; in Ask mode, it only uses references to inform answers