📚 NotePia AI Features Manual
Complete guide to AI-powered content generation, category management, and automated organization features.
📋 Table of Contents
🤖 AI Note Generation
📝 Create with AI Button
Use the "Create with AI" button in the note creation interface to generate content automatically.
Features:
- Generates content based on note title and category context
- Maintains consistent formatting and theme colors
- Automatically applies proper text styling for dark/light modes
- Creates structured, educational content
⚠️ Known Issues & Solutions
Text Color in Dark Mode:
If AI-generated text appears black in dark mode, the system automatically applies theme-based color corrections.
- CSS overrides ensure proper text visibility
- Backend processing removes hardcoded color values
- All AI content uses theme-aware CSS variables
🏷️ AI Category Generation
📍 Accessing Category Manager
Navigate to categorymanager.astro to access AI-powered subcategory generation.
🎯 AI Generation Modes
📋 Manual Mode
- Set exact number of subcategories to generate
- Specify count from 1-10
- Provides precise control over output
- Best for structured content organization
🤖 AI Decide Mode
- AI determines appropriate number of categories
- Supports count detection from prompts
- Handles list-based input
- Ideal for exploratory content creation
🔢 Count Detection System
📊 Automatic Count Recognition
The AI system automatically detects when you specify a number in your prompts and generates exactly that many categories.
✅ Supported Formats:
"10개 만들어 달라""Create 5 items""Generate 8 categories""7개의 주제를 만들어주세요"
ℹ️ Range Limits:
- Minimum: 1 category
- Maximum: 10 categories
- Outside range defaults to AI decision
- Safety limit prevents overgeneration
📝 List Detection System
🎯 Intelligent List Processing
Provide a list of items and the system will automatically count them and generate exactly that many categories based on your list.
📋 Supported List Formats
📝 Comma Separated
🔢 Numbered List
• Bullet Points
📋 Line Breaks
🔍 Detection Algorithm
How it works:
- Searches for list indicators: "다음", "following", "list:", or colon ":"
- Applies multiple regex patterns to detect different list formats
- Filters out empty or too-short items (minimum 2 characters)
- Automatically counts valid list items
- Generates exact number of categories matching list length
🔧 Troubleshooting
❓ Common Issues
🚫 Wrong Number Generated
Problem: Requested 10 categories but only got 5
Solution: Ensure your prompt clearly states the number
- Use explicit format: "10개 만들어 달라"
- Check that number is between 1-10
- Restart Django server after code updates
⚡ List Not Detected
Problem: Provided list but got generic categories
Solution: Format your list properly
- Use clear separators (commas, line breaks, numbers, bullets)
- Include list indicators: "다음", "following", or ":"
- Ensure each item is at least 2 characters long
🎨 Academic Style Override
Problem: All categories generated in academic style
Solution: Recent update allows natural intent-matching
- System now respects user intent (cooking, entertainment, etc.)
- No longer forces academic terminology
- Generates categories matching your content type
🛠️ Technical Requirements
- Django server must be running for AI features
- OpenAI API integration required for content generation
- Token authentication needed for API access
- Recent browser required for optimal performance
📖 Need More Help?
This documentation is continuously updated as new AI features are added to NotePia.