Merge pull request #2 from imxcstar/dev

Dev

Author: imxcstar

CLAUDE.md

@@ -6,42 +6,48 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ```bash
 dotnet build
-dotnet run --project sharpclaw            # TUI mode (Terminal.Gui)
-dotnet run --project sharpclaw config     # Re-run config dialog
-dotnet run --project sharpclaw serve      # Web mode (WebSocket server, default port 5000)
-dotnet run --project sharpclaw serve --port 8080
+dotnet run --project sharpclaw tui                          # TUI mode (Terminal.Gui)
+dotnet run --project sharpclaw config                       # Re-run config dialog
+dotnet run --project sharpclaw web                          # Web mode (WebSocket server)
+dotnet run --project sharpclaw web --address 0.0.0.0 --port 8080
+dotnet run --project sharpclaw qqbot                        # QQ Bot mode
 ```
 
-First run auto-launches the config dialog (Terminal.Gui `ConfigDialog`) which writes `~/.sharpclaw/config.json`. Web mode requires config to exist already.
+First run of `tui` auto-launches the config dialog (Terminal.Gui `ConfigDialog`) which writes `~/.sharpclaw/config.json`. Web and QQ Bot modes require config to exist already. Running with no command (or `help`) prints usage info.
 
 No test project exists. Target framework is .NET 10 (`net10.0`).
 
 ## Configuration
 
-All settings live in `~/.sharpclaw/config.json`. Supports three providers: Anthropic, OpenAI, Gemini. Each sub-agent (main, recaller, saver, summarizer) can override the default provider/endpoint/model or inherit from `default`.
+All settings live in `~/.sharpclaw/config.json`. Supports three providers: Anthropic, OpenAI, Gemini. Each sub-agent (main, recaller, saver, summarizer) can override the default provider/endpoint/model or inherit from `default`. A `channels` section configures per-frontend settings (TUI, Web listen address/port, QQ Bot credentials).
 
-API keys are encrypted at rest with AES-256-CBC (`DataProtector`). The encryption key is stored in the OS credential manager via `KeyStore` (Windows Credential Manager / macOS Keychain / Linux libsecret).
+API keys are encrypted at rest with AES-256-CBC (`DataProtector`). The encryption key is stored in the OS credential manager via `KeyStore` (Windows Credential Manager / macOS Keychain / Linux libsecret). Config has auto-migration (current version 8, see `ConfigMigrator`).
 
 See `Core/SharpclawConfig.cs` for the schema and `Core/ClientFactory.cs` for client instantiation.
 
 ## Architecture
 
 Sharpclaw is a console/web AI agent with long-term memory, built on `Microsoft.Agents.AI` and `Microsoft.Extensions.AI`.
 
-### Dual Frontend via IChatIO
+### Multi-Channel Frontend via IChatIO
 
-The AI engine is decoupled from the frontend through `Abstractions/IChatIO.cs`. Two implementations exist:
-- `UI/ChatWindow.cs` — TUI frontend using Terminal.Gui v2 (chat area + log area + input field)
-- `Web/WebSocketChatIO.cs` — WebSocket frontend, served by `Web/WebServer.cs` (ASP.NET Core), single-client only
+The AI engine is decoupled from the frontend through `Abstractions/IChatIO.cs`. Three implementations exist under `Channels/`:
+- `Channels/Tui/ChatWindow.cs` — TUI frontend using Terminal.Gui v2 (chat area + log area + input field)
+- `Channels/Web/WebSocketChatIO.cs` — WebSocket frontend, served by `Channels/Web/WebServer.cs` (ASP.NET Core), single-client only
+- `Channels/QQBot/QQBotChatIO.cs` — QQ Bot frontend via `Luolan.QQBot`, served by `Channels/QQBot/QQBotServer.cs`
 
-Both frontends share the same agent logic. `Abstractions/IAppLogger.cs` + `AppLogger` provide a similar abstraction for logging.
+All frontends share the same agent logic. `Abstractions/IAppLogger.cs` + `AppLogger` provide a similar abstraction for logging.
 
 ### Entry Point (`Program.cs`)
 
-1. `args.Contains("serve")` → dispatches to `WebServer.RunAsync()` (web mode)
-2. Otherwise → Terminal.Gui init → `ConfigDialog` if config missing → `AgentBootstrap.Initialize()` → `ChatWindow` + `MainAgent` → TUI event loop
+`switch` on the first CLI arg:
+1. `tui` → Terminal.Gui init → `ConfigDialog` if config missing → `AgentBootstrap.Initialize()` → `ChatWindow` + `MainAgent` → TUI event loop
+2. `web` → dispatches to `WebServer.RunAsync()` (WebSocket server)
+3. `qqbot` → dispatches to `QQBotServer.RunAsync()` (QQ Bot service)
+4. `config` → opens `ConfigDialog` only
+5. Default / `help` → prints usage info
 
-`Core/AgentBootstrap.Initialize()` is the shared bootstrap used by both TUI and Web mode: loads config, creates `TaskManager`, registers all command tools as `AIFunction[]`, creates `IMemoryStore`.
+`Core/AgentBootstrap.Initialize()` is the shared bootstrap used by all channels: loads config, creates `TaskManager`, registers all command tools as `AIFunction[]`, creates `IMemoryStore`.
 
 ### MainAgent and Memory Pipeline
 
@@ -84,6 +90,5 @@ Terminal.Gui dialog with `TabView` pages: default provider, per-agent overrides
 - Language: Chinese prompts and UI strings, English code identifiers
 - All sub-agents use tool calling (not text parsing) for structured output
 - Injected messages use `AdditionalProperties` dictionary keys (`AutoMemoryKey`, `AutoSummaryKey`) for identification and stripping
-- `ChatMessage` alias: `using ChatMessage = Microsoft.Extensions.AI.ChatMessage` (disambiguates from OpenAI's type)
 - Session persistence: `history.json` (agent state), `memories.json` (vector memory store)
 - WebSocket protocol: JSON messages with `type` field (`input`, `cancel`, `chat`, `chatLine`, `state`)

README.md

@@ -15,9 +15,10 @@ A .NET 10 AI agent with long-term memory and system operation tools. Supports An
 - **Vector semantic search** — Two-phase retrieval: vector embedding recall + optional reranking
 - **Semantic deduplication** — Automatically merges memories when cosine similarity exceeds threshold, avoiding redundancy
 - **System tools** — File operations, process execution (dotnet/node/docker), HTTP requests, background task management
-- **Dual frontend** — TUI terminal interface (Terminal.Gui v2) + WebSocket web interface, sharing the same agent logic
-- **Slash commands** — Type `/` to trigger autocomplete, supports `/exit`, `/quit` and more
+- **Multi-channel architecture** — TUI terminal interface (Terminal.Gui v2) + WebSocket web interface + QQ Bot, all sharing the same agent logic via `IChatIO` abstraction
+- **Slash commands** — Type `/` to trigger autocomplete, supports `/exit`, `/quit`, `/config`, `/help`
 - **Streaming output** — Real-time streaming AI responses with reasoning logs and tool call tracing
+- **Configurable keybindings** — TUI quit key, log toggle key, and cancel key are all configurable
 - **Config data encryption** — Sensitive data like API keys are encrypted with AES-256-CBC, with encryption keys stored in the OS credential manager (Windows Credential Manager / macOS Keychain / Linux libsecret)
 
 ## Requirements
@@ -29,28 +30,45 @@ A .NET 10 AI agent with long-term memory and system operation tools. Supports An
 ### TUI Mode (Terminal Interface)
 
 ```bash
-dotnet run --project sharpclaw
+dotnet run --project sharpclaw tui
 ```
 
 First run automatically launches the configuration wizard. Select your AI provider, enter API keys, and configure per-agent settings.
 
 ![Config Dialog](preview/config.png)
 
-Config is saved to `~/.sharpclaw/config.json`. After that, launching goes straight to interactive chat. Type `/exit` or `/quit` to exit, `Ctrl+Q` to quit.
+Config is saved to `~/.sharpclaw/config.json`. After that, launching goes straight to interactive chat. Type `/exit` or `/quit` to exit, `Ctrl+Q` to quit (default, configurable).
 
 ### Web Mode (WebSocket Server)
 
 ```bash
-dotnet run --project sharpclaw serve
-dotnet run --project sharpclaw serve --port 8080
+dotnet run --project sharpclaw web
+dotnet run --project sharpclaw web --address 0.0.0.0 --port 8080
 ```
 
-Visit `http://localhost:5000` (default port) to open the web chat interface. The Web UI supports Markdown rendering, code highlighting, connection status indicators, and real-time status display.
+Visit `http://localhost:5000` (default) to open the web chat interface. The Web UI supports Markdown rendering, code highlighting, connection status indicators, and real-time status display.
 
 ![Web Chat Interface](preview/web.png)
 
 > Note: Web mode requires completing configuration via TUI mode first. Only one client connection is supported at a time.
 
+### QQ Bot Mode
+
+```bash
+dotnet run --project sharpclaw qqbot
+```
+
+Runs as a QQ Bot service, receiving messages from QQ channels, groups, and private chats. Requires QQ Bot AppId and ClientSecret configured in the config file.
+
+> Note: QQ Bot mode requires completing configuration via TUI mode first and enabling QQ Bot in the channels config.
+
+### Other Commands
+
+```bash
+dotnet run --project sharpclaw config    # Open config dialog
+dotnet run --project sharpclaw help      # Show usage info
+```
+
 ## Configuration
 
 Run the config wizard:
@@ -63,7 +81,7 @@ Config file structure (`~/.sharpclaw/config.json`):
 
 ```json
 {
-  "version": 4,
+  "version": 8,
   "default": {
     "provider": "anthropic",
     "endpoint": "https://api.anthropic.com",
@@ -85,11 +103,30 @@ Config file structure (`~/.sharpclaw/config.json`):
     "rerankEndpoint": "https://dashscope.aliyuncs.com/compatible-api/v1/reranks",
     "rerankApiKey": "sk-xxx",
     "rerankModel": "qwen3-vl-rerank"
+  },
+  "channels": {
+    "tui": {
+      "logCollapsed": false,
+      "quitKey": "Ctrl+Q",
+      "toggleLogKey": "Ctrl+L",
+      "cancelKey": "Esc"
+    },
+    "web": {
+      "enabled": true,
+      "listenAddress": "localhost",
+      "port": 5000
+    },
+    "qqBot": {
+      "enabled": false,
+      "appId": "",
+      "clientSecret": "",
+      "sandbox": false
+    }
   }
 }
 ```
 
-Each agent inherits from `default` unless overridden. Set `"enabled": false` to disable a sub-agent.
+Each agent inherits from `default` unless overridden. Set `"enabled": false` to disable a sub-agent. Channel settings configure per-frontend behavior.
 
 ## Memory Pipeline
 
@@ -113,15 +150,28 @@ User Input
 
 ```
 sharpclaw/
-├── Program.cs                  # Entry point: TUI / Web mode dispatch
+├── Program.cs                  # Entry point: command dispatch (tui/web/qqbot/config/help)
 ├── Abstractions/               # Interface definitions
-│   ├── IChatIO.cs              # Frontend I/O abstraction (shared by TUI and WebSocket)
+│   ├── IChatIO.cs              # Frontend I/O abstraction (shared by all channels)
 │   └── IAppLogger.cs           # Logger abstraction
 ├── Agents/                     # Agents
 │   ├── MainAgent.cs            # Main agent: conversation loop, streaming, tool calls
 │   ├── MemoryRecaller.cs       # Memory recall: incremental injection of relevant memories
 │   ├── MemorySaver.cs          # Memory save: analyze conversation, auto save/update/delete
 │   └── ConversationSummarizer.cs # Conversation summarizer: incremental summary of trimmed content
+├── Channels/                   # Multi-channel frontends
+│   ├── Tui/                    # TUI frontend (Terminal.Gui v2)
+│   │   ├── ChatWindow.cs       # Main chat window (chat + log + input areas)
+│   │   ├── SlashCommandSuggestionGenerator.cs # Slash command autocomplete
+│   │   └── TerminalGuiLogger.cs # TUI logger implementation
+│   ├── Web/                    # WebSocket frontend (ASP.NET Core)
+│   │   ├── WebServer.cs        # ASP.NET Core host with embedded index.html
+│   │   ├── WebSocketChatIO.cs  # WebSocket IChatIO implementation
+│   │   ├── WebSocketSender.cs  # WebSocket message sender
+│   │   └── WebSocketLogger.cs  # WebSocket logger implementation
+│   └── QQBot/                  # QQ Bot frontend
+│       ├── QQBotServer.cs      # QQ Bot service host (channel/group/C2C messages)
+│       └── QQBotChatIO.cs      # QQ Bot IChatIO implementation
 ├── Chat/
 │   └── SlidingWindowChatReducer.cs # Sliding window reducer with integrated memory pipeline
 ├── Clients/
@@ -133,35 +183,27 @@ sharpclaw/
 │   ├── SystemCommands.cs       # System info, exit
 │   └── TaskCommands.cs         # Background task management
 ├── Core/
-│   ├── AgentBootstrap.cs       # Shared initialization logic
+│   ├── AgentBootstrap.cs       # Shared initialization logic (all channels)
 │   ├── ClientFactory.cs        # Multi-provider AI client factory
 │   ├── DataProtector.cs        # AES-256-CBC encryption/decryption
 │   ├── KeyStore.cs             # OS credential manager key storage
-│   ├── SharpclawConfig.cs      # Config management (version migration, encryption)
+│   ├── SharpclawConfig.cs      # Config management (schema, version migration, encryption)
 │   ├── Serialization/          # JSON serialization
 │   └── TaskManagement/         # Background tasks: process tasks, native tasks
 ├── Memory/
 │   ├── IMemoryStore.cs         # Memory store interface
 │   ├── MemoryEntry.cs          # Memory entry model
 │   ├── VectorMemoryStore.cs    # Vector memory store (embedding + cosine + dedup + rerank)
 │   └── InMemoryMemoryStore.cs  # In-memory store (for testing)
-├── UI/                         # TUI frontend
-│   ├── ChatWindow.cs           # Main chat window (chat + log + input areas)
-│   ├── ConfigDialog.cs         # Config wizard dialog (TabView pages)
-│   ├── SlashCommandSuggestionGenerator.cs # Slash command autocomplete
-│   ├── AppLogger.cs            # Logger management
-│   └── TerminalGuiLogger.cs    # TUI logger implementation
-├── Web/                        # WebSocket frontend
-│   ├── WebServer.cs            # ASP.NET Core host
-│   ├── WebSocketChatIO.cs      # WebSocket IChatIO implementation
-│   ├── WebSocketSender.cs      # WebSocket message sender
-│   └── WebSocketLogger.cs      # WebSocket logger implementation
+├── UI/                         # Shared UI utilities
+│   ├── AppLogger.cs            # Global logger management
+│   └── ConfigDialog.cs         # Config wizard dialog (TabView pages)
 └── wwwroot/
-    └── index.html              # Web chat interface (single-file SPA)
+    └── index.html              # Web chat interface (single-file SPA, embedded resource)
 ```
 
 ## Data Persistence
 
-- `~/.sharpclaw/config.json` — Provider and agent configuration
+- `~/.sharpclaw/config.json` — Provider, agent, and channel configuration
 - `history.json` — Session state, auto-restored on startup
 - `memories.json` — Vector memory store