mirror of
https://github.com/logancyang/obsidian-copilot.git
synced 2026-07-22 07:50:24 +00:00
89823e1d03
* feat(chat): power legacy chat from the model-management "chat" backend Legacy chat, project chat, vault QA, quick command, and quick ask now select models from the model-management "chat" backend (backends.chat.enabledModels) instead of the legacy activeModels / defaultModelKey. A new ConfiguredModel→CustomModel bridge feeds the existing ChatModelManager (the stubbed v4 ChatModelFactory is untouched), and a new "Quick Chat" curation section under the Agents settings tab lets users choose which BYOK/Plus models appear in the chat picker. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * style(skills): apply prettier formatting to builtinSkills.test.ts Collapse a multi-line expect() onto one line to satisfy the project's prettier config (surfaced when running npm run format). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(chat): stabilize chat backend model selections * fix(chat): address chat backend review regressions * fix(chat): show legacy chat models in a flat list Drop the per-provider _group on chat picker entries so the legacy chat model picker renders a single flat list (provider icons inline, no section headers), matching pre-migration behavior. Agent Mode keeps its per-backend headers via its own helper. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(chat): remove dead per-model parameter editing After the model-management chat migration, per-model parameter editing is unreachable: the chat selection is now a configuredModelId UUID, so the ChatSettingsPopover editor (gated on a legacy activeModels match) never renders, and TokenLimitWarning's activeModels lookup always misses and falls back to global settings. v4 agent mode no longer supports per-model parameter editing. - ChatSettingsPopover: drop the model-param plumbing (originalModel / bridgedModel / canEditModelParameters, local-model save/debounce, ModelParametersEditor); keep System Prompt + Disable Builtin controls. - TokenLimitWarning: always open the global Copilot settings tab. - Delete the now-orphaned ModelEditDialog and ModelParametersEditor. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(chat): drop dead legacy model-key fallback in streaming session The streaming chat session's chain cache key fell back to name|provider when configuredModelId was absent. Both callers (Quick Ask, custom-command chat) now source their model from useResolvedChatBackendModel -> configuredModelToCustomModel, which always stamps configuredModelId, so the fallback was unreachable. Derive the key directly from configuredModelId; a model without one is treated as no usable model via the existing guards. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(chat): remove test-only getLegacyChatModelKey helper The singular getLegacyChatModelKey was exported but had no production callers — only the barrel re-export and one test assertion referenced it. Remove it (and its export + assertion); the load-bearing plural getLegacyChatModelKeys, which powers legacy-key resolution in isChatModelSelectionForEntry, is kept and now carries the rationale comment. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(model-management): dedupe catalog-id to provider map Drop the duplicate CATALOG_ID_TO_LEGACY_PROVIDER table in chatModelSelection and reuse the now-exported CATALOG_ID_TO_CHAT_PROVIDER from configuredModelToCustomModel (extended with anthropic/google for the legacy-key path). Single source of truth for catalog-id to ChatModelProviders. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
132 lines
4.5 KiB
Markdown
132 lines
4.5 KiB
Markdown
# Projects
|
|
|
|
Projects are focused AI workspaces. Each project has its own model, system prompt, context sources, and completely isolated chat history. Use projects to keep separate AI conversations per client, topic, or area of work.
|
|
|
|
Projects support **50+ file types** beyond markdown, including PDFs, Word documents, PowerPoint, Excel, images, and more — making them ideal for analyzing large or diverse document collections.
|
|
|
|
> **Note**: Projects is an alpha feature. It may have rough edges and is subject to change.
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
In regular chat, all conversations share the same settings and model. Projects let you create dedicated workspaces with:
|
|
|
|
- **A specific context** — Specific notes, folders, URLs, or YouTube videos the AI always has access to
|
|
- **A dedicated model** — Different projects can use different AI models
|
|
- **A custom system prompt** — Each project can have its own instructions for the AI
|
|
- **Isolated chat history** — Conversations in one project don't mix with conversations in another
|
|
|
|
**Example use cases:**
|
|
|
|
- A "Research" project that always has your research notes as context
|
|
- A "Client Work" project with a specific system prompt and access to client-related notes
|
|
- A "Learning" project with YouTube video URLs for study materials
|
|
|
|
---
|
|
|
|
## Creating a Project
|
|
|
|
1. Open the chat panel
|
|
2. Click the mode selector at the top of the chat
|
|
3. Select **Projects (alpha)**
|
|
4. Click **New Project** (or the `+` button)
|
|
5. Fill in the project details and save
|
|
|
|
---
|
|
|
|
## Project Configuration
|
|
|
|
Each project has the following settings:
|
|
|
|
### Name
|
|
|
|
A short name for the project. Appears in the project list.
|
|
|
|
### Description
|
|
|
|
An optional description of what the project is for.
|
|
|
|
### Model
|
|
|
|
Choose which AI model to use for this project. The available options are the models enabled under
|
|
**Settings → Copilot → Agents → Quick Chat models**.
|
|
|
|
### Model Settings
|
|
|
|
Override the default temperature and max tokens specifically for this project.
|
|
|
|
### System Prompt
|
|
|
|
Set a custom system prompt for this project. This replaces (or supplements) the global default. See [System Prompts](system-prompts.md) for details.
|
|
|
|
---
|
|
|
|
## Context Sources
|
|
|
|
Projects let you pre-load context that is always available in the project's chat.
|
|
|
|
### File Inclusions and Exclusions
|
|
|
|
Specify which notes or folders to include in this project's context:
|
|
|
|
- **Inclusions**: Only these notes/folders are available for search and context
|
|
- **Exclusions**: These notes/folders are excluded from context
|
|
|
|
This scopes the AI's knowledge to just the notes relevant to your project.
|
|
|
|
### Web URLs
|
|
|
|
Add web page URLs that are fetched and included as context for every conversation in this project. Useful for documentation, reference pages, or web resources you frequently consult.
|
|
|
|
### YouTube URLs
|
|
|
|
Add YouTube video URLs whose transcripts are loaded into context for every conversation.
|
|
|
|
---
|
|
|
|
## Working in a Project
|
|
|
|
### Switching Projects
|
|
|
|
Use the project selector at the top of the chat panel to switch between projects. When you switch, the chat history clears and the new project's context loads.
|
|
|
|
### Isolated Chat History
|
|
|
|
Each project maintains its own chat history, completely separate from other projects and from regular (non-project) chat. Conversations don't bleed across projects.
|
|
|
|
### Context Loading
|
|
|
|
When you open a project, Copilot loads the configured context (notes, URLs, etc.) automatically. For large projects with many notes, this may take a moment.
|
|
|
|
---
|
|
|
|
## Project List Management
|
|
|
|
Go to the project selector to manage your projects:
|
|
|
|
- **Sort**: Projects can be sorted by most recently used or alphabetically
|
|
- **Edit**: Click the edit icon to change a project's settings
|
|
- **Delete**: Remove the project entry from the list (saved conversation files in your vault are not deleted)
|
|
|
|
Sort strategy: **Settings → Copilot → Basic → Project list sort strategy**
|
|
|
|
---
|
|
|
|
## Limitations
|
|
|
|
As an alpha feature, projects have some known limitations:
|
|
|
|
- Large context sources (many notes or large files) may slow down context loading
|
|
- The context loading on project switch is synchronous — the AI isn't available until loading completes
|
|
- Some features available in regular Plus mode may behave differently in projects
|
|
- Auto-compact behavior is the same as regular chat
|
|
|
|
---
|
|
|
|
## Related
|
|
|
|
- [Chat Interface](chat-interface.md) — Chat modes overview, new chat behavior, history
|
|
- [System Prompts](system-prompts.md) — Custom system prompts for projects
|
|
- [Context and Mentions](context-and-mentions.md) — How context works
|
|
- [Copilot Plus and Self-Host](copilot-plus-and-self-host.md) — Plus features
|