-
Notifications
You must be signed in to change notification settings - Fork 8
Settings Reference
pixelnull edited this page Mar 15, 2026
·
14 revisions
Complete reference for every DeepLore Enhanced setting, organized by section.
| Setting | Default | Range | Description |
|---|---|---|---|
| Enable DeepLore Enhanced | Off | Toggle | Master toggle. When disabled, no entries are injected. |
| Obsidian API Port | 27123 |
1-65535 | Port for the Obsidian Local REST API plugin. Found in Obsidian Settings > Local REST API. |
| API Key | (none) | Text | Bearer token from Obsidian's Local REST API settings. Required for authenticated access. |
Test Connection button verifies the Obsidian connection using the configured port and API key.
| Setting | Default | Description |
|---|---|---|
| Lorebook Tag | lorebook |
Obsidian tag (without #) that marks a note as a lorebook entry. Only notes with this tag are indexed. |
| Always-Send Tag | lorebook-always |
Tag that forces a note to always be injected regardless of keyword matches. Like constant: true. |
| Never-Insert Tag | lorebook-never |
Tag that prevents a note from ever being injected, even if keywords match. Good for drafts or WIP notes. |
| Seed Tag | lorebook-seed |
Tag for entries whose content is sent to the AI as story context on new chats. Not injected; only informs AI selection. See Features#New Chat Features. |
| Bootstrap Tag | lorebook-bootstrap |
Tag for entries that force-inject when chat is short, then become regular entries. See Features#New Chat Features. |
| New Chat Threshold | 3 |
1-20. Message count below which seed context is sent and bootstrap entries are force-injected. |
| Setting | Default | Range | Description |
|---|---|---|---|
| Scan Depth | 4 |
0-100 | Number of recent chat messages to scan for keyword matches. Set to 0 to disable keyword matching (AI search only). |
| Case Sensitive | Off | Toggle | When on, keyword matching respects case (Eris won't match eris). |
| Match Whole Words | Off | Toggle | When on, keywords use word boundaries (war won't match warning). |
| Active Character Boost | Off | Toggle | Auto-match the active character's vault entry by name or keyword, even if not mentioned in chat. See Features#Active Character Boost. |
| Recursive Scanning | Off | Toggle | After initial matches, scan matched entries' content for keywords that trigger more entries. |
| Max Recursion Steps | 3 |
1-10 | Maximum recursive scan passes. Each pass scans newly matched entries for more triggers. |
| Re-injection Cooldown | 0 |
0-50 | Skip re-injecting an entry for N generations after last injection. 0 = disabled. Constants are exempt. |
| Unlimited Entries | On | Toggle | Remove the cap on how many entries can be injected per generation. |
| Max Entries | 10 |
1-100 | Maximum entries to inject (when Unlimited Entries is off). Sorted by priority. |
| Unlimited Token Budget | On | Toggle | Remove the token budget cap. A warning toast appears if injected lore exceeds 20% of context. |
| Token Budget | 2048 |
100-100000 | Maximum total tokens to inject (when Unlimited Token Budget is off). Entries added in priority order until budget is reached. |
| Setting | Default | Description |
|---|---|---|
| Injection Template | <{{title}}>\n{{content}}\n</{{title}}> |
Format for each injected entry. Use {{title}} for entry name and {{content}} for note body. |
| Injection Position | In-chat | Where to inject lore. Options: Before Main Prompt/Story String, After Main Prompt/Story String, or In-chat @ Depth. |
| Injection Depth | 4 |
0-9999. Chat depth for in-chat injection (0 = last message). |
| Injection Role | System | Message role for in-chat injection: System, User, or Assistant. |
| Allow World Info Scan | Off | Let SillyTavern's built-in World Info system scan injected lore for WI keyword matches. Enables cross-system triggering. |
Entries can override position, depth, and role via frontmatter. See Writing Vault Entries.
| Setting | Default | Description |
|---|---|---|
| Show Lore Sources Button | On | Add a book icon to AI messages showing which entries were injected and why. See Features#Context Cartographer. |
| Obsidian Vault Name | (none) | Your vault name for deep links. When set, entry names in the lore sources popup link directly into Obsidian. Must match the vault name in Obsidian's title bar. |
| Setting | Default | Range | Description |
|---|---|---|---|
| Enable AI Search | Off | Toggle | Toggle AI-powered semantic search. Makes one API call per generation (cached on regenerations). |
| Connection | Profile | Toggle | "Connection Profile" uses a saved ST profile (recommended). "Custom Proxy" uses a separate proxy server. |
| Connection Profile | (none) | Dropdown | (Profile mode) Select a saved Connection Manager profile. Any provider works. |
| Proxy URL | http://localhost:42069 |
Text | (Proxy mode) URL of the claude-code-proxy or compatible endpoint. Must expose /v1/messages. |
| Model Override | (none) | Text | Optional model override. In profile mode, leave empty to use the profile's model. In proxy mode, specify the model name. |
| Max Response Tokens | 1024 |
64-4096 | Token limit for the AI response. Keep low; only a JSON array is needed. |
| Timeout (ms) | 10000 |
1000-30000 | How long to wait for the AI before falling back to keyword-only results. |
| AI Search Mode | Two-Stage | Toggle | "Two-Stage (keywords → AI)" pre-filters with keywords. "AI Only (full vault)" sends entire manifest. See AI Search. |
| AI Scan Depth | 4 |
1-100 | Number of recent messages to send as context to the AI. Can differ from keyword scan depth. |
| Manifest Summary Length | 600 |
100-1000 | Max characters for entry summaries in the manifest. Only for entries without a summary field. |
| System Prompt Override | (none) | Text | Custom system prompt for AI selection. Leave empty for default. Supports {{maxEntries}} placeholder. |
Test AI Search button tests the AI connection. Preview AI Prompt button shows the full prompt that would be sent.
AI Stats shows session usage: AI calls, cache hits, estimated input/output tokens.
| Setting | Default | Range | Description |
|---|---|---|---|
| Enable Session Scribe | Off | Toggle | Auto-summarize sessions to your Obsidian vault. See Features#Session Scribe. |
| Auto-Scribe Every N Messages | 5 |
1-50 | Number of AI messages between automatic summaries. |
| Session Folder | Sessions |
Text | Vault folder where session notes are saved. Created if it doesn't exist. |
| Custom Summary Prompt | (none) | Text | Override the default summary prompt. Default summarizes events, character changes, and plot developments as bullet points. |
| Setting | Default | Range | Description |
|---|---|---|---|
| Cache TTL (seconds) | 300 |
0-86400 | How long to cache the vault index before re-fetching. 0 = always fetch fresh (slower). |
| Auto-Sync Interval | 0 |
0-3600 | Seconds between automatic vault re-checks. 0 = disabled. See Features#Vault Change Detection & Auto-Sync. |
| Show Sync Change Toasts | On | Toggle | Show toast notifications when vault changes are detected during index refresh. |
Refresh Index button clears the cache and re-fetches all entries. Test Match button simulates a generation to show which entries would match.
| Setting | Default | Range | Description |
|---|---|---|---|
| Review Response Tokens | 0 |
0-100000 | Token limit for /dle-review responses. 0 = auto (uses your connection profile's Max Response Length). |
| Debug Mode | Off | Toggle | Log detailed match info to browser console (F12). Shows keyword matches, AI results, gating, token counts, injection details. |
DeepLore Wiki
Getting started
Features
Reference
Help