# BitSeek Claw Page Operations Guide

This guide provides detailed instructions on how to operate each function module of BitSeek Claw.

## Table of Contents

1. [Chat Function](#chat-function)
2. [AI Colleagues](#ai-colleagues)
3. [Task Management](#task-management)
4. [Kanban View](#kanban-view)
5. [Skills Management](#skills-management)
6. [Memory Management](#memory-management)
7. [Settings Configuration](#settings-configuration)

---

## Chat Function

![Chat Interface](images/chat-area.png)

Chat is the core function of BitSeek Claw, used for communicating with AI through dialogue.

### Sending Messages

1. **Enter Message**
   - Type text in the message input box at the bottom
   - Supports multi-line input (press `Shift + Enter` for new line)

2. **Send Message**
   - Click the send button 📤
   - Or press `Enter` key to send
   - Or press `Ctrl/Cmd + Enter` to send

3. **Quick Actions**
   - 📎 **Select File** - Attach files to messages
   - 🎤 **Dictation** - Voice input
   - ⚡ **Quick Commands** - Insert preset commands

### Session Management

#### New Conversation
1. Click the **"New Conversation"** button in the left sidebar

#### Switch Conversations
1. Click on the conversation you want to switch to in the session list in the left sidebar
2. Sessions are grouped by time (today, yesterday, last week, etc.)

#### Filter Conversations
1. Use the search box to enter keywords for filtering
2. Or use tags for filtering

#### Conversation Operations
- **Rename** - Right-click conversation → Rename
- **Delete** - Right-click conversation → Delete
- **Export** - Right-click conversation → Export as Markdown

### Message Operations

#### Edit Message
1. Hover over the message
2. Click the edit icon ✏️
3. Modify the content and save

#### Copy Message
1. Hover over the message
2. Click the copy icon 📋
3. The message will be copied to clipboard

#### Quote Message
1. Hover over the message
2. Click the quote icon 💬
3. The quoted content will be added to the input box

### Context Information

The bottom status bar displays the current session context:
- **Model** - Current AI model being used
- **Profile** - Current user profile
- **Workspace** - Current working directory
- **Reasoning Effort** - AI reasoning intensity setting

---

## AI Colleagues

![AI Colleagues Interface](images/ai-colleagues.png)

The AI Colleagues function allows you to manage and interact with multiple AI agents.

### View AI Colleagues List
1. Click the **"AI Colleagues"** button in the navigation bar
2. View all available AI agents

### Chat with AI Colleagues
1. Select an AI colleague from the list
2. Click to enter the chat interface
3. Enter messages to start communication

---

## Task Management

![Task Management Interface](images/tasks.png)

The task management function helps you track and manage various tasks.

### View Tasks
1. Click the **"Tasks"** button in the navigation bar
2. View all task lists
3. Filter by status, priority, or assignee

### Create Tasks
1. Click the **"New Task"** button
2. Fill in task information:
   - Title
   - Description
   - Due date
   - Priority
   - Assignee
3. Click save

### Task Operations
- **Edit Task** - Click task title to enter edit mode
- **Mark Complete** - Click the complete button
- **Delete Task** - Select task and delete
- **Add Comment** - Add comments to tasks

### Task Views
- **List View** - Traditional list display
- **Kanban View** - Kanban-style display
- **Timeline View** - Gantt chart display

---

## Kanban View

![Kanban Interface](images/kanban.png)

The kanban view provides an intuitive task management interface.

### Kanban Columns
Kanban typically includes the following columns:
- **To Do** - Tasks to be processed
- **In Progress** - Tasks currently being worked on
- **Completed** - Tasks that have been completed
- **Archived** - Tasks that have been archived

### Drag and Drop Tasks
1. Find the task card in the kanban column
2. Hold the left mouse button and drag
3. Release in the target column

### Manage Kanban
- **Add Column** - Click the add column button
- **Rename Column** - Double-click column title
- **Delete Column** - Right-click column → Delete
- **Adjust Order** - Drag column title to adjust order

### Card Operations
- **View Details** - Click card to view detailed information
- **Quick Edit** - Double-click card for quick edit
- **Add Members** - Add members to tasks
- **Set Labels** - Add color labels

---

## Skills Management

![Skills Interface](images/skills.png)

The skills management function manages the AI's available skill library.

### View Skills List
1. Click the **"Skills"** button in the navigation bar
2. View all available skills
3. Filter by category or status

### Skill Categories
- **System Skills** - Built-in core skills
- **Custom Skills** - User-created skills
- **Community Skills** - Skills obtained from the community

### Using Skills
1. Enter skill commands in chat
2. Or select through the skills panel
3. AI will execute the corresponding skill

### Managing Skills
- **Enable/Disable** - Control whether skills are available
- **Configure Parameters** - Modify skill settings
- **Delete Skills** - Remove unwanted skills

---

## Memory Management

![Memory Interface](images/memory.png)

The memory management function manages AI's memory system.

### Memory Submenu

The memory page provides the following submenu options:

#### 1. My Notes

![My Notes Interface](images/memory-notes.png)

- **Function**: Manage personal notes and memos
- **Operations**:
  - Click **"My Notes"** to enter notes management
  - Click **"Edit"** button to modify current note
  - View note's last modification time
- **Use Cases**:
  - Record important information and ideas
  - Save todo items
  - Record learning insights

#### 2. User Profile

![User Profile Interface](images/memory-profile.png)

- **Function**: Manage AI's understanding of the user
- **Content**:
  - User preference settings
  - Work habits
  - Communication style
  - Technical stack information
- **Operations**:
  - View AI-learned user characteristics
  - Manually add or modify user information
  - Delete inaccurate user profiles

#### 3. Agent Soul

![Agent Soul Interface](images/memory-soul.png)

- **Function**: Define AI's personality and behavior patterns
- **Configuration Items**:
  - **Personality Traits**: Define AI's communication style
  - **Expertise**: Specify AI's professional domains
  - **Behavioral Guidelines**: Set AI's behavioral boundaries
  - **Response Style**: Adjust AI's response methods
- **Use Cases**:
  - Customize personalized AI assistant
  - Adapt to different work scenarios
  - Optimize interaction experience

### Memory Types
- **User Memory** - About user preferences and habits
- **Session Memory** - Current session context
- **Repository Memory** - Codebase-related memory

### View Memory
1. Click the **"Memory"** button in the navigation bar
2. Browse different categories of memory
3. Search for specific memory content

### Manage Memory
- **Add Memory** - Manually add new memory
- **Edit Memory** - Modify existing memory
- **Delete Memory** - Delete unwanted memory
- **Export Memory** - Export memory to file

### Memory Search
1. Use the search box to enter keywords
2. Filter memory by category
3. Sort memory by time

---

## Settings Configuration

![Settings Interface](images/settings.png)

The settings function configures various options for BitSeek Claw.

### Settings Submenu

The settings page provides the following submenu options:

#### 1. Conversation

![Conversation Settings Interface](images/settings-conversation.png)

- **Function**: Manage current conversation settings and operations
- **Operation Options**:
  - **Record**: Export conversation as Markdown file
  - **JSON**: Export conversation completely as JSON format
  - **Import**: Import conversation history from JSON file
  - **Clear**: Clear all messages in current conversation
- **Use Cases**:
  - Backup important conversations
  - Sync conversations across different devices
  - Clean up unwanted conversation records

#### 2. Appearance

![Appearance Settings Interface](images/settings-appearance.png)

- **Function**: Customize interface appearance and theme
- **Configuration Items**:
  - **Theme Selection**:
    - Dark theme (default)
    - Light theme
    - Follow system
  - **Font Settings**:
    - Font size adjustment
    - Font style selection
  - **Layout Configuration**:
    - Sidebar show/hide
    - Panel size adjustment
    - Animation effects toggle
- **Use Cases**:
  - Adapt to different lighting environments
  - Personalize interface style
  - Optimize reading experience

#### 3. Preferences

![Preferences Settings Interface](images/settings-preferences.png)

- **Function**: Set personal usage preferences
- **Configuration Items**:
  - **Language Settings**:
    - Interface language selection
    - Time format settings
    - Date format settings
  - **Notification Settings**:
    - Desktop notification toggle
    - Sound reminder settings
    - Notification frequency adjustment
  - **Privacy Settings**:
    - Data collection options
    - Sharing preferences
    - Clear history records
- **Use Cases**:
  - Adapt to localization needs
  - Manage notification interruptions
  - Protect personal privacy

#### 4. Providers

![Providers Settings Interface](images/settings-providers.png)

- **Function**: Manage AI model provider configuration
- **Configuration Items**:
  - **API Key Management**:
    - Add new API keys
    - Test key validity
    - Delete invalid keys
  - **Model Configuration**:
    - Select default AI model
    - Set model parameters
    - Configure model priorities
  - **Provider Settings**:
    - OpenAI configuration
    - Anthropic configuration
    - Google configuration
    - Other provider configurations
- **Use Cases**:
  - Configure multiple AI providers
  - Optimize cost and performance
  - Test different model effects

#### 5. Plugins

![Plugins Settings Interface](images/settings-plugins.png)

- **Function**: Manage extension plugins and skills
- **Operation Options**:
  - **View Installed Plugins**: Browse currently installed plugins
  - **Install New Plugins**: Install from plugin marketplace
  - **Update Plugins**: Update to latest version
  - **Uninstall Plugins**: Remove unwanted plugins
  - **Plugin Configuration**: Adjust plugin settings
- **Use Cases**:
  - Extend BitSeek Claw functionality
  - Install community plugins
  - Manage plugin lifecycle

#### 6. System

![System Settings Interface](images/settings-system.png)

- **Function**: System-level configuration and management
- **Configuration Items**:
  - **Data Management**:
    - Export all data
    - Import backup data
    - Clear local data
  - **Network Settings**:
    - Proxy configuration
    - Firewall settings
    - Connection timeout settings
  - **Debug and Logs**:
    - Log level adjustment
    - Debug mode toggle
    - Error reporting settings
  - **System Information**:
    - Version information
    - System status
    - Resource usage
- **Use Cases**:
  - Data backup and recovery
  - Network troubleshooting
  - System performance optimization

---

## Quick Actions

### Global Keyboard Shortcuts
| Shortcut | Function |
|----------|----------|
| `Ctrl/Cmd + N` | New conversation |
| `Ctrl/Cmd + /` | Focus search box |
| `Ctrl/Cmd + Enter` | Send message |
| `Ctrl/Cmd + ,` | Open settings |
| `Esc` | Close popup |

### Message Keyboard Shortcuts
| Shortcut | Function |
|----------|----------|
| `Enter` | Send message |
| `Shift + Enter` | New line |
| `↑` | Edit previous message |
| `Ctrl/Cmd + C` | Copy selected text |

### Navigation Keyboard Shortcuts
| Shortcut | Function |
|----------|----------|
| `1-9` | Switch navigation tabs |
| `←` | Collapse sidebar |
| `→` | Expand sidebar |

---

## Troubleshooting

### Common Issues

#### Message Sending Failed
1. Check network connection
2. Verify API key is valid
3. Check console error messages

#### Interface Not Responding
1. Refresh the page (`F5` or `Ctrl/Cmd + R`)
2. Clear browser cache
3. Restart BitSeek Claw service

#### File Upload Failed
1. Check file size limits
2. Verify file type is supported
3. Check network connection

### Getting Help
- View system logs (Settings → Logs)
- Check console error messages
- Visit project documentation
