@bitseek/hermes-webui 0.1.0-beta.0 → 0.1.0

package/vendor/agent-frontend-shell/bitseek_docs/en/01-Overview.md

@@ -0,0 +1,128 @@
+# BitSeek Claw Overview
+
+BitSeek Claw features a modern three-panel layout design, providing an intuitive user interface. Below is an introduction to the overall interface structure.
+
+## Interface Layout
+
+![Overall Layout](images/main-page.png)
+
+The BitSeek Claw interface is divided into three main areas:
+
+1. **Top Navigation Bar** - Function module switching
+2. **Left Sidebar** - Session management and navigation
+3. **Central Main Area** - Chat and workspace
+4. **Right Panel** - File browsing (optional)
+
+## Top Navigation Bar
+
+![Navigation Bar](images/navigation-bar.png)
+
+The navigation bar is located at the top of the page and contains the following function modules:
+
+| Icon | Name | Description |
+|------|------|-------------|
+| 💬 | Chat | Communicate with AI through dialogue |
+| 👥 | AI Colleagues | Manage and interact with multiple AI agents |
+| 📋 | Tasks | View and manage task lists |
+| 📊 | Kanban | Task kanban view |
+| ⚡ | Skills | Manage AI skill library |
+| 🧠 | Memory | View and manage AI memory |
+| 📁 | Workspace | File and project management |
+| ⚙️ | Profiles | Agent configuration management |
+| ✅ | Todos | Todo item management |
+| 📈 | Insights | Usage statistics and insights |
+| 📊 | Hermes Dashboard | System monitoring panel |
+| 📝 | Logs | System log viewing |
+| ⚙️ | Settings | System settings |
+
+## Left Sidebar
+
+![Sidebar](images/sidebar.png)
+
+The left sidebar provides session management and quick navigation:
+
+### Session Management
+- **New Conversation** - Create a new chat session
+- **Filter Conversations** - Filter sessions by keywords
+- **Session List** - Displays all historical sessions
+  - Grouped by time (today, yesterday, last week, etc.)
+  - Each session shows title and last active time
+  - Right-click menu provides more operations
+
+### Project Management
+- **All** - View all sessions
+- **Unassigned** - View sessions without assigned projects
+- **New Project** - Create new project group
+
+## Central Main Area
+
+![Chat Area](images/chat-area.png)
+
+The central main area is the primary workspace, displaying different content based on the currently selected function module:
+
+### Chat Interface
+- **Welcome Message** - Displays guide questions
+- **Message Input Box** - Enter messages to communicate with AI
+- **Quick Actions** - File selection, dictation, and other functions
+- **Context Information** - Shows current model, workspace, etc.
+
+### Other Function Interfaces
+- Task management, kanban view, skills management, etc.
+- Each function module has its own dedicated interface layout
+
+## Right Workspace Panel
+
+![Workspace Panel](images/workspace-panel.png)
+
+The right workspace panel provides file management functions:
+
+### File Browser
+- **File List** - Displays files and folders in the workspace
+- **File Operations** - Create new files, folders, refresh, etc.
+- **File Preview** - Click on a file to preview its content
+
+### Function Tabs
+- **Files** - File browser
+- **Artifacts** - Generated artifacts and content
+
+## Bottom Control Bar
+
+The bottom control bar provides session-level controls:
+
+### Model Selection
+- **AI Model** - Switch between different AI models
+- **Reasoning Effort** - Adjust AI reasoning intensity
+- **Profile** - Switch user profiles
+
+### Message Actions
+- **Send Button** - Send the entered message
+- **File Attachment** - Attach files to messages
+- **Dictation** - Voice input support
+
+## Themes and Appearance
+
+BitSeek Claw supports multiple themes:
+
+- **Dark Theme** - Default theme, comfortable for eyes
+- **Light Theme** - Bright and refreshing interface
+- **Custom Themes** - Supports custom color schemes
+
+## Responsive Design
+
+The interface supports different screen sizes:
+- **Desktop** - Complete three-panel layout
+- **Tablet** - Collapsible sidebar
+- **Mobile** - Single-column layout, adapted for phone screens
+
+## Keyboard Shortcuts
+
+Common keyboard shortcuts:
+- `Ctrl/Cmd + N` - New conversation
+- `Ctrl/Cmd + /` - Focus search box
+- `Ctrl/Cmd + Enter` - Send message
+- `Esc` - Close popup or cancel operation
+
+## Next Steps
+
+After understanding the overall layout, please refer to:
+- **[Page Operations](02-Page-Operations.md)** - Detailed operation guide for each function module

package/vendor/agent-frontend-shell/bitseek_docs/en/02-Page-Operations.md

@@ -0,0 +1,461 @@
+# 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

package/vendor/agent-frontend-shell/bitseek_docs/en/README.md

@@ -0,0 +1,61 @@
+# BitSeek Claw Operation Manual
+
+This directory contains the complete operation guide for BitSeek Claw (Hermes WebUI).
+
+## Directory Structure
+
+```
+Operation Manual/
+├── README.md                    # This file - Documentation directory
+├── 00-Installation.md           # Installation and startup instructions
+├── 01-Overview.md               # Interface overview
+├── 02-Page-Operations.md        # Detailed page operation guide
+└── images/                      # Screenshots and image resources
+    ├── main-page.png            # Main page screenshot
+    ├── navigation-bar.png       # Navigation bar screenshot
+    ├── chat-area.png            # Chat area screenshot
+    ├── sidebar.png              # Sidebar screenshot
+    ├── workspace-panel.png      # Workspace panel screenshot
+    ├── ai-colleagues.png        # AI colleagues interface screenshot
+    ├── tasks.png                # Task management interface screenshot
+    ├── kanban.png               # Kanban view screenshot
+    ├── skills.png               # Skills management interface screenshot
+    ├── memory.png               # Memory management interface screenshot
+    ├── memory-overview.png      # Memory overview screenshot
+    ├── memory-notes.png         # My Notes screenshot
+    ├── memory-profile.png       # User Profile screenshot
+    ├── memory-soul.png          # Agent Soul screenshot
+    ├── settings.png             # Settings interface screenshot
+    ├── settings-overview.png    # Settings overview screenshot
+    ├── settings-conversation.png # Conversation settings screenshot
+    ├── settings-appearance.png  # Appearance settings screenshot
+    ├── settings-preferences.png # Preferences settings screenshot
+    ├── settings-providers.png   # Providers settings screenshot
+    ├── settings-plugins.png     # Plugins settings screenshot
+    └── settings-system.png      # System settings screenshot
+```
+
+## Quick Navigation
+
+1. **[Installation](00-Installation.md)** - How to install and start BitSeek Claw
+2. **[Overview](01-Overview.md)** - Interface layout and main functional areas
+3. **[Page Operations](02-Page-Operations.md)** - Detailed operation guide for each page
+
+## About BitSeek Claw
+
+BitSeek Claw is a lightweight web interface for Hermes Agent that provides full parity with the CLI experience. It features a three-panel layout design, supports dark themes, and requires no build steps or frameworks.
+
+### Key Features
+
+- **Persistent Memory** - Maintains context and memory across sessions
+- **Multi-platform Support** - Supports 10+ messaging platforms
+- **Self-improving Skills** - Automatically learns and saves skills from experience
+- **Provider Agnostic** - Supports OpenAI, Anthropic, Google, and other providers
+- **Self-hosted** - Full control over conversations, memory, and hardware
+
+## Getting Help
+
+If you encounter any issues, please refer to:
+- `README.md` in the project root directory
+- Detailed documentation in the `docs/` directory
+- `CONTRIBUTING.md` contribution guide