mirror of
https://github.com/QwenLM/qwen-code.git
synced 2025-12-19 09:33:53 +00:00
126 lines
3.6 KiB
Markdown
126 lines
3.6 KiB
Markdown
# Welcome Back Feature
|
|
|
|
The Welcome Back feature helps you seamlessly resume your work by automatically detecting when you return to a project with existing conversation history and offering to continue from where you left off.
|
|
|
|
## Overview
|
|
|
|
When you start Qwen Code in a project directory that contains a previously generated project summary (`.qwen/PROJECT_SUMMARY.md`), the Welcome Back dialog will automatically appear, giving you the option to either start fresh or continue your previous conversation.
|
|
|
|
## How It Works
|
|
|
|
### Automatic Detection
|
|
|
|
The Welcome Back feature automatically detects:
|
|
|
|
- **Project Summary File:** Looks for `.qwen/PROJECT_SUMMARY.md` in your current project directory
|
|
- **Conversation History:** Checks if there's meaningful conversation history to resume
|
|
- **Settings:** Respects your `enableWelcomeBack` setting (enabled by default)
|
|
|
|
### Welcome Back Dialog
|
|
|
|
When a project summary is found, you'll see a dialog with:
|
|
|
|
- **Last Updated Time:** Shows when the summary was last generated
|
|
- **Overall Goal:** Displays the main objective from your previous session
|
|
- **Current Plan:** Shows task progress with status indicators:
|
|
- `[DONE]` - Completed tasks
|
|
- `[IN PROGRESS]` - Currently working on
|
|
- `[TODO]` - Planned tasks
|
|
- **Task Statistics:** Summary of total tasks, completed, in progress, and pending
|
|
|
|
### Options
|
|
|
|
You have two choices when the Welcome Back dialog appears:
|
|
|
|
1. **Start new chat session**
|
|
- Closes the dialog and begins a fresh conversation
|
|
- No previous context is loaded
|
|
|
|
2. **Continue previous conversation**
|
|
- Automatically fills the input with: `@.qwen/PROJECT_SUMMARY.md, Based on our previous conversation, Let's continue?`
|
|
- Loads the project summary as context for the AI
|
|
- Allows you to seamlessly pick up where you left off
|
|
|
|
## Configuration
|
|
|
|
### Enable/Disable Welcome Back
|
|
|
|
You can control the Welcome Back feature through settings:
|
|
|
|
**Via Settings Dialog:**
|
|
|
|
1. Run `/settings` in Qwen Code
|
|
2. Find "Enable Welcome Back" in the UI category
|
|
3. Toggle the setting on/off
|
|
|
|
**Via Settings File:**
|
|
Add to your `.qwen/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"enableWelcomeBack": true
|
|
}
|
|
```
|
|
|
|
**Settings Locations:**
|
|
|
|
- **User settings:** `~/.qwen/settings.json` (affects all projects)
|
|
- **Project settings:** `.qwen/settings.json` (project-specific)
|
|
|
|
### Keyboard Shortcuts
|
|
|
|
- **Escape:** Close the Welcome Back dialog (defaults to "Start new chat session")
|
|
|
|
## Integration with Other Features
|
|
|
|
### Project Summary Generation
|
|
|
|
The Welcome Back feature works seamlessly with the `/summary` command:
|
|
|
|
1. **Generate Summary:** Use `/summary` to create a project summary
|
|
2. **Automatic Detection:** Next time you start Qwen Code in this project, Welcome Back will detect the summary
|
|
3. **Resume Work:** Choose to continue and the summary will be loaded as context
|
|
|
|
## File Structure
|
|
|
|
The Welcome Back feature creates and uses:
|
|
|
|
```
|
|
your-project/
|
|
├── .qwen/
|
|
│ └── PROJECT_SUMMARY.md # Generated project summary
|
|
```
|
|
|
|
### PROJECT_SUMMARY.md Format
|
|
|
|
The generated summary follows this structure:
|
|
|
|
```markdown
|
|
# Project Summary
|
|
|
|
## Overall Goal
|
|
|
|
<!-- Single, concise sentence describing the high-level objective -->
|
|
|
|
## Key Knowledge
|
|
|
|
<!-- Crucial facts, conventions, and constraints -->
|
|
<!-- Includes: technology choices, architecture decisions, user preferences -->
|
|
|
|
## Recent Actions
|
|
|
|
<!-- Summary of significant recent work and outcomes -->
|
|
<!-- Includes: accomplishments, discoveries, recent changes -->
|
|
|
|
## Current Plan
|
|
|
|
<!-- The current development roadmap and next steps -->
|
|
<!-- Uses status markers: [DONE], [IN PROGRESS], [TODO] -->
|
|
|
|
---
|
|
|
|
## Summary Metadata
|
|
|
|
**Update time**: 2025-01-10T15:30:00.000Z
|
|
```
|