PNArchives/Memoh
1
0
Fork 0
mirror of https://github.com/memohai/Memoh.git synced 2026-04-25 07:00:48 +09:00
Code Issues Packages Projects Releases Wiki Activity

chore: update AGENTS.md

Browse Source
This commit is contained in:
Acbox
2026-04-14 21:56:42 +08:00
parent 2a1c4a2e5f
commit 19d5cd606d
2 changed files with 224 additions and 108 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+138 -72
View File
@@ -2,7 +2,7 @@
## Project Overview ## Project Overview
Memoh is a multi-member, structured long-memory, containerized AI agent system platform. Users can create AI bots and chat with them via Telegram, Discord, Lark (Feishu), Email, and more. Every bot has an independent container and memory system, allowing it to edit files, execute commands, and build itself — providing a secure, flexible, and scalable solution for multi-bot management. Memoh is a multi-member, structured long-memory, containerized AI agent system platform. Users can create AI bots and chat with them via Telegram, Discord, Lark (Feishu), DingTalk, WeChat, Matrix, Email, and more. Every bot has an independent container and memory system, allowing it to edit files, execute commands, and build itself — providing a secure, flexible, and scalable solution for multi-bot management.
## Architecture Overview ## Architecture Overview
@@ -30,14 +30,17 @@ Infrastructure dependencies:
- **API Docs**: Swagger/OpenAPI (swaggo) - **API Docs**: Swagger/OpenAPI (swaggo)
- **MCP**: modelcontextprotocol/go-sdk - **MCP**: modelcontextprotocol/go-sdk
- **Containers**: containerd v2 (Linux), Apple Virtualization (macOS) - **Containers**: containerd v2 (Linux), Apple Virtualization (macOS)
- **TUI**: Charm libraries (bubbletea, glamour, lipgloss) for CLI interactive mode
### Frontend (TypeScript) ### Frontend (TypeScript)
- **Framework**: Vue 3 (Composition API) - **Framework**: Vue 3 (Composition API)
- **Build Tool**: Vite - **Build Tool**: Vite 8
- **State Management**: Pinia + Pinia Colada - **State Management**: Pinia 3 + Pinia Colada
- **UI**: Tailwind CSS 4 + custom component library (`@memohai/ui`) + Reka UI - **UI**: Tailwind CSS 4 + custom component library (`@memohai/ui`) + Reka UI
- **Icons**: lucide-vue-next + `@memohai/icon` (brand/provider icons)
- **i18n**: vue-i18n - **i18n**: vue-i18n
- **Markdown**: markstream-vue + Shiki + Mermaid + KaTeX - **Markdown**: markstream-vue + Shiki + Mermaid + KaTeX
- **Desktop**: Tauri (wraps `@memohai/web`)
- **Package Manager**: pnpm monorepo - **Package Manager**: pnpm monorepo
### Browser Gateway (TypeScript) ### Browser Gateway (TypeScript)
@@ -51,7 +54,7 @@ Infrastructure dependencies:
- **Linting**: golangci-lint (Go), ESLint + typescript-eslint + vue-eslint-parser (TypeScript) - **Linting**: golangci-lint (Go), ESLint + typescript-eslint + vue-eslint-parser (TypeScript)
- **Testing**: Vitest - **Testing**: Vitest
- **Version Management**: bumpp - **Version Management**: bumpp
- **SDK Generation**: @hey-api/openapi-ts - **SDK Generation**: @hey-api/openapi-ts (with `@hey-api/client-fetch` + `@pinia/colada` plugins)
## Project Structure ## Project Structure
@@ -60,22 +63,29 @@ Memoh/
├── cmd/ # Go application entry points ├── cmd/ # Go application entry points
│ ├── agent/ # Main backend server (main.go, FX wiring) │ ├── agent/ # Main backend server (main.go, FX wiring)
│ ├── bridge/ # In-container gRPC bridge (UDS-based, runs inside bot containers) │ ├── bridge/ # In-container gRPC bridge (UDS-based, runs inside bot containers)
│ │ └── template/ # Prompt templates for bridge (TOOLS.md, SOUL.md, IDENTITY.md, etc.)
│ ├── mcp/ # MCP stdio transport binary │ ├── mcp/ # MCP stdio transport binary
│ └── memoh/ # Unified binary wrapper (Cobra: serve, migrate, version) │ └── memoh/ # Unified CLI (Cobra: serve, migrate, chat, bots, compose, docker, login, install, support)
├── internal/ # Go backend core code (domain packages) ├── internal/ # Go backend core code (domain packages)
│ ├── accounts/ # User account management (CRUD, password hashing) │ ├── accounts/ # User account management (CRUD, password hashing)
│ ├── acl/ # Access control list (source-aware chat trigger ACL) │ ├── acl/ # Access control list (source-aware chat trigger ACL)
│ ├── agent/ # In-process AI agent (Twilight AI SDK integration) │ ├── agent/ # In-process AI agent (Twilight AI SDK integration)
│ │ ├── agent.go # Core agent: Stream() / Generate() via Twilight SDK │ │ ├── agent.go # Core agent: Stream() / Generate() via Twilight SDK
│ │ ├── model.go # Model creation (OpenAI completions/responses, Anthropic, Google)
│ │ ├── stream.go # Streaming event assembly │ │ ├── stream.go # Streaming event assembly
│ │ ├── sential.go # Sential (sentinel) loop detection logic │ │ ├── sential.go # Sential (sentinel) loop detection logic
│ │ ├── tags.go # Tag extraction from streaming text (attachments, reactions, speech) │ │ ├── prompt.go # Prompt assembly (system, heartbeat, schedule, subagent, discuss)
│ │ ├── prompt.go # Prompt assembly (system, heartbeat, schedule, subagent) │ │ ├── config.go # Agent service dependencies
│ │ ├── config.go # Agent configuration types (RunConfig, ModelConfig)
│ │ ├── types.go # Shared types (StreamEvent, GenerateResult, FileAttachment) │ │ ├── types.go # Shared types (StreamEvent, GenerateResult, FileAttachment)
│ │ ├── fs.go # Filesystem utilities │ │ ├── fs.go # Filesystem utilities
│ │ ├── prompts/ # Prompt templates (system.md, heartbeat.md, schedule.md, subagent.md) │ │ ├── guard_state.go # Guard state management
│ │ ├── retry.go # Retry logic
│ │ ├── read_media.go # Media reading utilities
│ │ ├── spawn_adapter.go # Spawn adapter for sub-processes
│ │ ├── prompts/ # Prompt templates (Markdown, with partials prefixed by _)
│ │ │ ├── system_chat.md, system_discuss.md, system_heartbeat.md, system_schedule.md, system_subagent.md
│ │ │ ├── _tools.md, _memory.md, _contacts.md, _schedule_task.md, _subagent.md
│ │ │ ├── heartbeat.md, schedule.md
│ │ │ └── memory_extract.md, memory_update.md
│ │ └── tools/ # Tool providers (ToolProvider interface) │ │ └── tools/ # Tool providers (ToolProvider interface)
│ │ ├── message.go # Send message tool │ │ ├── message.go # Send message tool
│ │ ├── contacts.go # Contact list tool │ │ ├── contacts.go # Contact list tool
@@ -84,26 +94,34 @@ Memoh/
│ │ ├── web.go # Web search tool │ │ ├── web.go # Web search tool
│ │ ├── webfetch.go # Web page fetch tool │ │ ├── webfetch.go # Web page fetch tool
│ │ ├── container.go # Container file/exec tools │ │ ├── container.go # Container file/exec tools
│ │ ├── inbox.go # Inbox tool │ │ ├── fsops.go # Filesystem operations tool
│ │ ├── email.go # Email send tool │ │ ├── email.go # Email send tool
│ │ ├── subagent.go # Sub-agent invocation tool │ │ ├── subagent.go # Sub-agent invocation tool
│ │ ├── skill.go # Skill activation tool │ │ ├── skill.go # Skill activation tool
│ │ ├── browser.go # Browser automation tool │ │ ├── browser.go # Browser automation tool
│ │ ├── tts.go # Text-to-speech tool │ │ ├── tts.go # Text-to-speech tool
│ │ └── federation.go # MCP federation tool │ │ ├── federation.go # MCP federation tool
│ │ ├── image_gen.go # Image generation tool
│ │ ├── prune.go # Pruning tool
│ │ ├── history.go # History access tool
│ │ └── read_media.go # Media reading tool
│ ├── attachment/ # Attachment normalization (MIME types, base64) │ ├── attachment/ # Attachment normalization (MIME types, base64)
│ ├── auth/ # JWT authentication middleware and utilities │ ├── auth/ # JWT authentication middleware and utilities
│ ├── bind/ # Channel identity-to-user binding code management │ ├── bind/ # Channel identity-to-user binding code management
│ ├── boot/ # Runtime configuration provider (container backend detection) │ ├── boot/ # Runtime configuration provider (container backend detection)
│ ├── bots/ # Bot management (CRUD, lifecycle) │ ├── bots/ # Bot management (CRUD, lifecycle)
│ ├── browsercontexts/ # Browser context management (CRUD) │ ├── browsercontexts/ # Browser context management (CRUD)
│ ├── channel/ # Channel adapter system (Telegram, Discord, Feishu, QQ, Local, Email) │ ├── channel/ # Channel adapter system
│ │ ├── adapters/ # Platform adapters: telegram, discord, feishu, qq, dingtalk, weixin, wecom, wechatoa, matrix, misskey, local
│ │ └── identities/ # Channel identity service
│ ├── command/ # Slash command system (extensible command handlers) │ ├── command/ # Slash command system (extensible command handlers)
│ ├── config/ # Configuration loading and parsing (TOML) │ ├── compaction/ # Message history compaction service (LLM summarization)
│ ├── config/ # Configuration loading and parsing (TOML + YAML providers)
│ ├── containerd/ # Container runtime abstraction (containerd / Apple Virtualization) │ ├── containerd/ # Container runtime abstraction (containerd / Apple Virtualization)
│ ├── conversation/ # Conversation management and flow resolver │ ├── conversation/ # Conversation management and flow resolver
│ │ ├── service.go # Conversation CRUD and routing │ │ ├── service.go # Conversation CRUD and routing
│ │ └── flow/ # Chat orchestration (resolver, streaming, memory, triggers) │ │ └── flow/ # Chat orchestration (resolver, streaming, memory, triggers)
│ ├── copilot/ # GitHub Copilot client integration
│ ├── db/ # Database connection and migration utilities │ ├── db/ # Database connection and migration utilities
│ │ └── sqlc/ # ⚠️ Auto-generated by sqlc — DO NOT modify manually │ │ └── sqlc/ # ⚠️ Auto-generated by sqlc — DO NOT modify manually
│ ├── email/ # Email provider and outbox management (Mailgun, generic SMTP, OAuth) │ ├── email/ # Email provider and outbox management (Mailgun, generic SMTP, OAuth)
@@ -112,55 +130,70 @@ Memoh/
│ ├── healthcheck/ # Health check adapter system (MCP, channel checkers) │ ├── healthcheck/ # Health check adapter system (MCP, channel checkers)
│ ├── heartbeat/ # Heartbeat scheduling service (cron-based) │ ├── heartbeat/ # Heartbeat scheduling service (cron-based)
│ ├── identity/ # Identity type utilities (human vs bot) │ ├── identity/ # Identity type utilities (human vs bot)
│ ├── inbox/ # Bot inbox service (notifications, triggers)
│ ├── logger/ # Structured logging (slog) │ ├── logger/ # Structured logging (slog)
│ ├── mcp/ # MCP protocol manager (connections, OAuth, tool gateway) │ ├── mcp/ # MCP protocol manager (connections, OAuth, tool gateway)
│ ├── workspace/ # Workspace container lifecycle management
│ │ ├── manager.go # Container reconciliation, gRPC connection pool
│ │ ├── manager_lifecycle.go # Container create/start/stop operations
│ │ ├── bridge/ # gRPC client for in-container bridge service
│ │ └── bridgepb/ # Protobuf definitions (bridge.proto)
│ ├── media/ # Content-addressed media asset service │ ├── media/ # Content-addressed media asset service
│ ├── memory/ # Long-term memory system (multi-provider: Qdrant, BM25, LLM extraction) │ ├── memory/ # Long-term memory system (multi-provider: Qdrant, BM25, LLM extraction)
│ ├── message/ # Message persistence and event publishing │ ├── message/ # Message persistence and event publishing
│ ├── models/ # LLM model management (CRUD, variants) │ ├── messaging/ # Outbound message executor
│ ├── models/ # LLM model management (CRUD, variants, client types, probe)
│ ├── oauthctx/ # OAuth context helpers
│ ├── pipeline/ # Discuss/chat pipeline (adapt, projection, rendering, driver)
│ ├── policy/ # Access policy resolution (guest access) │ ├── policy/ # Access policy resolution (guest access)
│ ├── providers/ # LLM provider management (OpenAI, Anthropic, etc.) │ ├── providers/ # LLM provider management (OpenAI, Anthropic, etc.)
│ ├── prune/ # Text pruning utilities (truncation with head/tail) │ ├── prune/ # Text pruning utilities (truncation with head/tail)
│ ├── registry/ # Provider registry service (YAML provider templates)
│ ├── schedule/ # Scheduled task service (cron) │ ├── schedule/ # Scheduled task service (cron)
│ ├── searchengines/ # Search engine abstraction (reserved)
│ ├── searchproviders/ # Search engine provider management (Brave, etc.) │ ├── searchproviders/ # Search engine provider management (Brave, etc.)
│ ├── server/ # HTTP server wrapper (Echo setup, middleware, shutdown) │ ├── server/ # HTTP server wrapper (Echo setup, middleware, shutdown)
│ ├── session/ # Bot session management service
│ ├── settings/ # Bot settings management │ ├── settings/ # Bot settings management
│ ├── storage/ # Storage provider interface (filesystem, container FS) │ ├── storage/ # Storage provider interface (filesystem, container FS)
│ ├── subagent/ # Sub-agent management (CRUD)
│ ├── textutil/ # UTF-8 safe text utilities │ ├── textutil/ # UTF-8 safe text utilities
│ ├── timezone/ # Timezone utilities
│ ├── tts/ # Text-to-speech provider management │ ├── tts/ # Text-to-speech provider management
│ └── version/ # Build-time version information │ ├── tui/ # Terminal UI (Charm stack for CLI interactive mode)
│ ├── version/ # Build-time version information
│ └── workspace/ # Workspace container lifecycle management
│ ├── manager.go # Container reconciliation, gRPC connection pool
│ ├── manager_lifecycle.go # Container create/start/stop operations
│ ├── bridge/ # gRPC client for in-container bridge service
│ └── bridgepb/ # Protobuf definitions (bridge.proto)
├── apps/ # Application services ├── apps/ # Application services
│ ├── browser/ # Browser Gateway (Bun/Elysia/Playwright) │ ├── browser/ # Browser Gateway (Bun/Elysia/Playwright)
│ │ └── src/ │ │ └── src/
│ │ ├── index.ts # Elysia server entry point │ │ ├── index.ts # Elysia server entry point
│ │ ├── browser.ts # Playwright browser lifecycle │ │ ├── browser.ts # Playwright browser lifecycle
│ │ ├── modules/ # Route modules (action, context, devices) │ │ ├── modules/ # Route modules (action, context, devices, session, cores)
│ │ ├── middlewares/ # CORS, error handling, bearer auth │ │ ├── middlewares/ # CORS, error handling, bearer auth
│ │ ├── types/ # TypeScript type definitions │ │ ├── types/ # TypeScript type definitions
│ │ ├── storage.ts # Browser context storage │ │ ├── storage.ts # Browser context storage
│ │ └── models.ts # Zod request schemas │ │ └── models.ts # Zod request schemas
│ └── web/ # Main web app (@memohai/web, Vue 3) │ ├── desktop/ # Tauri desktop app (@memohai/desktop, wraps @memohai/web)
│ └── web/ # Main web app (@memohai/web, Vue 3) — see apps/web/AGENTS.md
├── packages/ # Shared TypeScript libraries ├── packages/ # Shared TypeScript libraries
│ ├── ui/ # Shared UI component library (@memohai/ui) │ ├── ui/ # Shared UI component library (@memohai/ui)
│ ├── sdk/ # TypeScript SDK (@memohai/sdk, auto-generated from OpenAPI) │ ├── sdk/ # TypeScript SDK (@memohai/sdk, auto-generated from OpenAPI)
│ ├── icons/ # Brand/provider icon library (@memohai/icon)
│ └── config/ # Shared configuration utilities (@memohai/config) │ └── config/ # Shared configuration utilities (@memohai/config)
├── spec/ # OpenAPI specifications (swagger.json, swagger.yaml) ├── spec/ # OpenAPI specifications (swagger.json, swagger.yaml)
├── db/ # Database ├── db/ # Database
│ ├── migrations/ # SQL migration files │ ├── migrations/ # SQL migration files (0001–0067+)
│ └── queries/ # SQL query files (sqlc input) │ └── queries/ # SQL query files (sqlc input)
├── conf/ # Configuration templates (app.example.toml, app.docker.toml, app.apple.toml, app.windows.toml) ├── conf/ # Configuration
├── devenv/ # Dev environment (docker-compose, dev Dockerfiles, app.dev.toml, bridge-build.sh, server-entrypoint.sh) │ ├── providers/ # Provider YAML templates (openai, anthropic, codex, github-copilot, etc.)
│ ├── app.example.toml # Default config template
│ ├── app.docker.toml # Docker deployment config
│ ├── app.apple.toml # macOS (Apple Virtualization) config
│ └── app.windows.toml # Windows config
├── devenv/ # Dev environment
│ ├── docker-compose.yml # Main dev compose
│ ├── docker-compose.minify.yml # Minified services compose
│ ├── docker-compose.selinux.yml # SELinux overlay compose
│ └── app.dev.toml # Dev config (connects to devenv docker-compose)
├── docker/ # Production Docker (Dockerfiles, entrypoints, nginx.conf, toolkit/) ├── docker/ # Production Docker (Dockerfiles, entrypoints, nginx.conf, toolkit/)
├── docs/ # Documentation site ├── docs/ # Documentation site (VitePress)
├── scripts/ # Utility scripts (db, release, install) ├── scripts/ # Utility scripts (db-up, db-drop, release, install, sync-openrouter-models)
├── docker-compose.yml # Docker Compose orchestration (production) ├── docker-compose.yml # Docker Compose orchestration (production)
├── mise.toml # mise tasks and tool version definitions ├── mise.toml # mise tasks and tool version definitions
├── sqlc.yaml # sqlc code generation config ├── sqlc.yaml # sqlc code generation config
@@ -179,12 +212,15 @@ Memoh/
2. Install toolchains and dependencies: `mise install` 2. Install toolchains and dependencies: `mise install`
3. Initialize the project: `mise run setup` 3. Initialize the project: `mise run setup`
4. Start the dev environment: `mise run dev` 4. Start the dev environment: `mise run dev`
5. Dev web UI: `http://localhost:18082` (server: `18080`, browser gateway: `18083`)
### Common Commands ### Common Commands
| Command | Description | | Command | Description |
|---------|-------------| |---------|-------------|
| `mise run dev` | Start the containerized dev environment (all services) | | `mise run dev` | Start the containerized dev environment (all services) |
| `mise run dev:minify` | Start dev environment with minified services |
| `mise run dev:selinux` | Start dev environment on SELinux systems |
| `mise run dev:down` | Stop the dev environment | | `mise run dev:down` | Stop the dev environment |
| `mise run dev:logs` | View dev environment logs | | `mise run dev:logs` | View dev environment logs |
| `mise run dev:restart` | Restart a service (e.g. `-- server`) | | `mise run dev:restart` | Restart a service (e.g. `-- server`) |
@@ -192,11 +228,15 @@ Memoh/
| `mise run sqlc-generate` | Regenerate Go code after modifying SQL files | | `mise run sqlc-generate` | Regenerate Go code after modifying SQL files |
| `mise run swagger-generate` | Generate Swagger documentation | | `mise run swagger-generate` | Generate Swagger documentation |
| `mise run sdk-generate` | Generate TypeScript SDK (depends on swagger-generate) | | `mise run sdk-generate` | Generate TypeScript SDK (depends on swagger-generate) |
| `mise run icons-generate` | Generate icon Vue components from SVG sources |
| `mise run db-up` | Initialize and migrate the database | | `mise run db-up` | Initialize and migrate the database |
| `mise run db-down` | Drop the database | | `mise run db-down` | Drop the database |
| `mise run docs` | Start documentation dev server |
| `mise run build-embedded-assets` | Build and stage embedded web assets | | `mise run build-embedded-assets` | Build and stage embedded web assets |
| `mise run build-unified` | Build the memoh CLI locally | | `mise run build-unified` | Build memoh CLI locally |
| `mise run bridge:build` | Rebuild bridge binary in dev container | | `mise run bridge:build` | Rebuild bridge binary in dev container |
| `mise run desktop:dev` | Start Tauri desktop app in dev mode |
| `mise run desktop:build` | Build Tauri desktop app for release |
| `mise run lint` | Run all linters (Go + ESLint) | | `mise run lint` | Run all linters (Go + ESLint) |
| `mise run lint:fix` | Run all linters with auto-fix | | `mise run lint:fix` | Run all linters with auto-fix |
| `mise run release` | Release new version (bumpp) | | `mise run release` | Release new version (bumpp) |
@@ -251,10 +291,13 @@ Migrations live in `db/migrations/` and follow a dual-update convention:
- The AI agent runs **in-process** within the Go server — there is no separate agent gateway service. - The AI agent runs **in-process** within the Go server — there is no separate agent gateway service.
- Core agent logic lives in `internal/agent/`, powered by the [Twilight AI](https://github.com/memohai/twilight-ai) Go SDK. - Core agent logic lives in `internal/agent/`, powered by the [Twilight AI](https://github.com/memohai/twilight-ai) Go SDK.
- `internal/agent/agent.go` provides `Stream()` (SSE streaming) and `Generate()` (non-streaming) methods. - `internal/agent/agent.go` provides `Stream()` (SSE streaming) and `Generate()` (non-streaming) methods.
- Model creation (`internal/agent/model.go`) supports four client types: `openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai`. - Model/client types are defined in `internal/models/types.go`: `openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai`, `openai-codex`, `github-copilot`, `edge-speech`.
- Model types: `chat`, `embedding`, `speech`.
- Tools are implemented as `ToolProvider` instances in `internal/agent/tools/`, loaded via setter injection to avoid FX dependency cycles. - Tools are implemented as `ToolProvider` instances in `internal/agent/tools/`, loaded via setter injection to avoid FX dependency cycles.
- Prompt templates (system, heartbeat, schedule, subagent) are embedded Go Markdown files in `internal/agent/prompts/`. - Prompt templates are embedded Go Markdown files in `internal/agent/prompts/`. Partials (reusable fragments) are prefixed with `_` (e.g., `_tools.md`, `_memory.md`). System prompts include `system_chat.md` (standard chat) and `system_discuss.md` (discuss mode).
- The conversation flow resolver (`internal/conversation/flow/`) orchestrates message assembly, memory injection, history trimming, and agent invocation. - The conversation flow resolver (`internal/conversation/flow/`) orchestrates message assembly, memory injection, history trimming, and agent invocation.
- The discuss/chat pipeline (`internal/pipeline/`) provides an alternative orchestration path with adaptation, projection, rendering, and driver layers.
- The compaction service (`internal/compaction/`) handles LLM-based conversation summarization.
- Loop detection (text and tool loops) is built into the agent with configurable thresholds. - Loop detection (text and tool loops) is built into the agent with configurable thresholds.
- Tag extraction system processes inline tags in streaming output (attachments, reactions, speech/TTS). - Tag extraction system processes inline tags in streaming output (attachments, reactions, speech/TTS).
@@ -265,12 +308,13 @@ Migrations live in `db/migrations/` and follow a dual-update convention:
- API calls use the auto-generated `@memohai/sdk`. - API calls use the auto-generated `@memohai/sdk`.
- State management uses Pinia; data fetching uses Pinia Colada. - State management uses Pinia; data fetching uses Pinia Colada.
- i18n via vue-i18n. - i18n via vue-i18n.
- See `apps/web/AGENTS.md` for detailed frontend conventions.
### Container / Workspace Management ### Container / Workspace Management
- Each bot can have an isolated **workspace container** for file editing, command execution, and MCP tool hosting. - Each bot can have an isolated **workspace container** for file editing, command execution, and MCP tool hosting.
- Containers communicate with the host via a **gRPC bridge** over Unix Domain Sockets (UDS), not TCP. - Containers communicate with the host via a **gRPC bridge** over Unix Domain Sockets (UDS), not TCP.
- The bridge binary (`cmd/bridge/`) runs inside each container, mounting runtime binaries from `$WORKSPACE_RUNTIME_DIR` and UDS sockets from `/run/memoh/`. - The bridge binary (`cmd/bridge/`) runs inside each container, mounting runtime binaries from `$WORKSPACE_RUNTIME_DIR` and UDS sockets from `/run/memoh/`. Bridge prompt templates live in `cmd/bridge/template/`.
- Container images are standard base images (debian, alpine, ubuntu, etc.) — no dedicated MCP Docker image needed. - Container images are standard base images (debian, alpine, ubuntu, etc.) — no dedicated MCP Docker image needed.
- `internal/workspace/` manages container lifecycle (create, start, stop, reconcile) and maintains a gRPC connection pool. - `internal/workspace/` manages container lifecycle (create, start, stop, reconcile) and maintains a gRPC connection pool.
- `internal/containerd/` provides the container runtime abstraction layer (containerd on Linux, Apple Virtualization on macOS, socktainer for socket-based management). - `internal/containerd/` provides the container runtime abstraction layer (containerd on Linux, Apple Virtualization on macOS, socktainer for socket-based management).
@@ -278,43 +322,61 @@ Migrations live in `db/migrations/` and follow a dual-update convention:
## Database Tables ## Database Tables
| Table | Description | The canonical source of truth for the full schema is `db/migrations/0001_init.up.sql`. Key tables grouped by domain:
|-------|-------------|
| `users` | User accounts (username, email, role, display_name, avatar) | **Auth & Users**
| `channel_identities` | Unified inbound identity subject (cross-platform) | - `users` — User accounts (username, email, role, display_name, avatar)
| `user_channel_bindings` | Outbound delivery config per user/channel | - `channel_identities` — Unified inbound identity subject (cross-platform)
| `llm_providers` | LLM provider configurations (name, base_url, api_key) | - `user_channel_bindings` — Outbound delivery config per user/channel
| `search_providers` | Search engine provider configurations | - `channel_identity_bind_codes` — One-time codes for channel identity → user linking
| `models` | Model definitions (chat/embedding types, modalities, reasoning) |
| `model_variants` | Model variant definitions (weight, metadata) | **Bots & Sessions**
| `bots` | Bot definitions with model references and settings | - `bots` — Bot definitions with model references and settings
| `mcp_connections` | MCP connection configurations per bot | - `bot_sessions` — Bot conversation sessions
| `bot_channel_configs` | Per-bot channel configurations | - `bot_session_events` — Session event log
| `bot_preauth_keys` | Bot pre-authentication keys | - `bot_channel_configs` — Per-bot channel configurations
| `channel_identity_bind_codes` | One-time codes for channel identity → user linking | - `bot_channel_routes` — Conversation route mapping (inbound thread → bot history)
| `bot_channel_routes` | Conversation route mapping (inbound thread → bot history) | - `bot_acl_rules` — Source-aware chat access control lists
| `bot_history_messages` | Unified message history under bot scope |
| `bot_history_message_assets` | Message → content_hash asset links (with name and metadata) | **Messages & History**
| `containers` | Bot container instances | - `bot_history_messages` — Unified message history under bot scope
| `snapshots` | Container snapshots | - `bot_history_message_assets` — Message → content_hash asset links (with name and metadata)
| `container_versions` | Container version tracking | - `bot_history_message_compacts` — Compacted message summaries
| `lifecycle_events` | Container lifecycle events |
| `schedule` | Scheduled tasks (cron) | **Providers & Models**
| `subagents` | Sub-agent definitions | - `providers` — LLM provider configurations (name, base_url, api_key)
| `browser_contexts` | Browser context configurations (Playwright) | - `provider_oauth_tokens` — Provider-level OAuth tokens
| `storage_providers` | Pluggable object storage backends | - `user_provider_oauth_tokens` — Per-user provider OAuth tokens
| `bot_storage_bindings` | Per-bot storage backend selection | - `models` — Model definitions (chat/embedding/speech types, modalities, reasoning)
| `bot_inbox` | Per-bot inbox (notifications, triggers) | - `model_variants` — Model variant definitions (weight, metadata)
| `bot_heartbeat_logs` | Heartbeat execution records | - `search_providers` — Search engine provider configurations
| `email_providers` | Pluggable email service backends (Mailgun, generic SMTP) | - `memory_providers` — Multi-provider memory adapter configurations
| `bot_email_bindings` | Per-bot email provider binding with permissions |
| `email_outbox` | Outbound email audit log | **MCP**
| `email_oauth_tokens` | OAuth2 tokens for email providers (Gmail) | - `mcp_connections` — MCP connection configurations per bot
| `memory_providers` | Multi-provider memory adapter configurations | - `mcp_oauth_tokens` — MCP OAuth tokens
| `tts_providers` | Text-to-speech provider configurations |
| `tts_models` | TTS model definitions | **Containers**
| `token_usage` | Per-message LLM token usage tracking | - `containers` — Bot container instances
| `chat_acl` | Source-aware chat access control lists | - `snapshots` — Container snapshots
- `container_versions` — Container version tracking
- `lifecycle_events` — Container lifecycle events
**Email**
- `email_providers` — Pluggable email service backends (Mailgun, generic SMTP)
- `email_oauth_tokens` — OAuth2 tokens for email providers (Gmail)
- `bot_email_bindings` — Per-bot email provider binding with permissions
- `email_outbox` — Outbound email audit log
**Scheduling & Automation**
- `schedule` — Scheduled tasks (cron)
- `schedule_logs` — Schedule execution logs
- `bot_heartbeat_logs` — Heartbeat execution records
- `browser_contexts` — Browser context configurations (Playwright)
**Storage**
- `storage_providers` — Pluggable object storage backends
- `bot_storage_bindings` — Per-bot storage backend selection
## Configuration ## Configuration
@@ -331,6 +393,10 @@ The main configuration file is `config.toml` (copied from `conf/app.example.toml
- `[sparse]` — Sparse (BM25) search service connection - `[sparse]` — Sparse (BM25) search service connection
- `[browser_gateway]` — Browser Gateway address - `[browser_gateway]` — Browser Gateway address
- `[web]` — Web frontend address - `[web]` — Web frontend address
- `[registry]` — Provider registry (`providers_dir` pointing to `conf/providers/`)
- `[supermarket]` — Supermarket integration (base_url)
Provider YAML templates in `conf/providers/` define preset configurations for various LLM providers (OpenAI, Anthropic, GitHub Copilot, etc.).
Configuration templates available in `conf/`: Configuration templates available in `conf/`:
- `app.example.toml` — Default template - `app.example.toml` — Default template
apps/web/AGENTS.md
+86 -36
View File
@@ -20,7 +20,11 @@
| Toast | vue-sonner | | Toast | vue-sonner |
| Tables | @tanstack/vue-table | | Tables | @tanstack/vue-table |
| Markdown | markstream-vue + Shiki + Mermaid + KaTeX | | Markdown | markstream-vue + Shiki + Mermaid + KaTeX |
| Utilities | @vueuse/core | | Charts | ECharts + vue-echarts |
| Terminal | @xterm/xterm + @xterm/addon-fit + @xterm/addon-serialize |
| Code Editor | Monaco Editor + stream-monaco |
| Utilities | @vueuse/core, @vueuse/integrations |
| Animation | animate.css + tw-animate-css |
| TypeScript | ~5.9 (strict mode) | | TypeScript | ~5.9 (strict mode) |
## Directory Structure ## Directory Structure
@@ -32,7 +36,7 @@ src/
├── router.ts # Route definitions, auth guard, chunk error recovery ├── router.ts # Route definitions, auth guard, chunk error recovery
├── style.css # Tailwind imports (delegates to @memohai/ui/style.css) ├── style.css # Tailwind imports (delegates to @memohai/ui/style.css)
├── i18n.ts # vue-i18n configuration ├── i18n.ts # vue-i18n configuration
├── assets/ # Static assets (logo.png, vue.svg) ├── assets/ # Static assets (logo.png)
├── components/ # Shared components ├── components/ # Shared components
│ ├── sidebar/ # Bot list sidebar (collapsible, bot items, settings link) │ ├── sidebar/ # Bot list sidebar (collapsible, bot items, settings link)
│ │ ├── index.vue # Sidebar with bot list + settings gear footer │ │ ├── index.vue # Sidebar with bot list + settings gear footer
@@ -45,14 +49,16 @@ src/
│ ├── chat/ # Chat UI sub-components │ ├── chat/ # Chat UI sub-components
│ │ ├── chat-status/ # Chat connection status indicator │ │ ├── chat-status/ # Chat connection status indicator
│ │ └── chat-step/ # Chat processing step indicator │ │ └── chat-step/ # Chat processing step indicator
│ ├── data-table/ # TanStack table wrapper │ ├── file-manager/ # File browser (list + viewer + utils)
│ ├── file-manager/ # File browser (list + viewer) │ ├── terminal/ # Terminal emulator wrapper (xterm)
│ ├── monaco-editor/ # Monaco code editor wrapper │ ├── monaco-editor/ # Monaco code editor wrapper
│ ├── model-capabilities/ # Model capabilities display
│ ├── context-window-badge/ # Context window size badge
│ ├── bot-select/ # Bot selection dropdown
│ ├── form-dialog-shell/ # Dialog wrapper for forms │ ├── form-dialog-shell/ # Dialog wrapper for forms
│ ├── confirm-popover/ # Confirmation popover │ ├── confirm-popover/ # Confirmation popover
│ ├── loading-button/ # Button with loading state │ ├── loading-button/ # Button with loading state
│ ├── status-dot/ # Status indicator dot │ ├── status-dot/ # Status indicator dot
│ ├── warning-banner/ # Warning banner
│ ├── channel-icon/ # Channel platform icon │ ├── channel-icon/ # Channel platform icon
│ ├── provider-icon/ # LLM provider icon (icons.ts + index.vue) │ ├── provider-icon/ # LLM provider icon (icons.ts + index.vue)
│ ├── search-provider-logo/ # Search provider icons (custom-icons.ts + index.vue) │ ├── search-provider-logo/ # Search provider icons (custom-icons.ts + index.vue)
@@ -70,9 +76,10 @@ src/
│ │ ├── useChat.chat-api.ts # Bot/session CRUD (fetchBots, fetchSessions, etc.) │ │ ├── useChat.chat-api.ts # Bot/session CRUD (fetchBots, fetchSessions, etc.)
│ │ ├── useChat.message-api.ts # Message fetch, SSE streaming, local channel │ │ ├── useChat.message-api.ts # Message fetch, SSE streaming, local channel
│ │ ├── useChat.sse.ts # SSE stream reader and parser │ │ ├── useChat.sse.ts # SSE stream reader and parser
│ │ ├── useChat.ws.ts # WebSocket connection (send, abort, reconnect)
│ │ ├── useChat.content.ts # Message content parsing (tool calls, text, reasoning)
│ │ ├── useChat.sse.test.ts # SSE parser tests │ │ ├── useChat.sse.test.ts # SSE parser tests
│ │ ├── useChat.ws.ts # WebSocket connection (send, abort, reconnect)
│ │ ├── useChat.ws.test.ts # WebSocket tests
│ │ ├── useChat.content.ts # Message content parsing (tool calls, text, reasoning)
│ │ ├── useContainerStream.ts # Container creation SSE stream │ │ ├── useContainerStream.ts # Container creation SSE stream
│ │ └── usePlatform.ts # Platform list query + create mutation │ │ └── usePlatform.ts # Platform list query + create mutation
│ ├── useDialogMutation.ts # Mutation wrapper with toast error handling │ ├── useDialogMutation.ts # Mutation wrapper with toast error handling
@@ -82,11 +89,13 @@ src/
│ ├── useAvatarInitials.ts # Avatar initial generation │ ├── useAvatarInitials.ts # Avatar initial generation
│ ├── useClipboard.ts # Clipboard utilities │ ├── useClipboard.ts # Clipboard utilities
│ ├── useKeyValueTags.ts # Tag management │ ├── useKeyValueTags.ts # Tag management
│ ├── usePinnedBots.ts # Pinned bots management
│ ├── useShikiHighlighter.ts # Shiki syntax highlighter singleton │ ├── useShikiHighlighter.ts # Shiki syntax highlighter singleton
│ └── useTerminalCache.ts # Terminal output cache │ └── useTerminalCache.ts # Terminal output cache
├── constants/ # Constants ├── constants/ # Constants
│ ├── client-types.ts # LLM client type definitions │ ├── client-types.ts # LLM client type definitions
│ └── compatibilities.ts # Feature compatibility flags │ ├── compatibilities.ts # Feature compatibility flags
│ └── acl-presets.ts # ACL preset configurations
├── i18n/locales/ # Translation files (en.json, zh.json) ├── i18n/locales/ # Translation files (en.json, zh.json)
├── layout/ ├── layout/
│ └── main-layout/ # Top-level layout (SidebarProvider) │ └── main-layout/ # Top-level layout (SidebarProvider)
@@ -101,18 +110,17 @@ src/
│ │ ├── composables/ # Page-specific composables │ │ ├── composables/ # Page-specific composables
│ │ │ ├── useFileManagerProvider.ts # File manager context │ │ │ ├── useFileManagerProvider.ts # File manager context
│ │ │ └── useMediaGallery.ts # Media gallery state │ │ │ └── useMediaGallery.ts # Media gallery state
│ │ └── components/ # Chat UI components (26 files) │ │ └── components/ # Chat UI components (28 files)
│ │ ├── chat-area.vue # Main chat area (messages, input, attachments) │ │ ├── chat-area.vue # Main chat area (messages, input, attachments)
│ │ ├── session-sidebar.vue # Session list sidebar (search, filter, CRUD) │ │ ├── session-sidebar.vue # Session list sidebar (search, filter, CRUD)
│ │ ├── bot-sidebar.vue # Alternative bot sidebar layout │ │ ├── session-info-panel.vue # Session info panel
│ │ ├── chat-header.vue # Chat top bar (status, step indicator) │ │ ├── chat-header.vue # Chat top bar (status, step indicator)
│ │ ├── message-item.vue # Single message (user/assistant, markdown, blocks) │ │ ├── message-item.vue # Single message (user/assistant, markdown, blocks)
│ │ ├── session-item.vue # Session list row (avatar, title, timestamp) │ │ ├── session-item.vue # Session list row (avatar, title, timestamp)
│ │ ├── session-metadata.vue # Collapsible session metadata panel
│ │ ├── bot-item.vue # Bot item in sidebar
│ │ ├── thinking-block.vue # Collapsible thinking/reasoning block │ │ ├── thinking-block.vue # Collapsible thinking/reasoning block
│ │ ├── attachment-block.vue # Attachment grid (images, audio, files) │ │ ├── attachment-block.vue # Attachment grid (images, audio, files)
│ │ ├── media-gallery-lightbox.vue # Fullscreen media lightbox │ │ ├── media-gallery-lightbox.vue # Fullscreen media lightbox
│ │ ├── tool-call-block.vue # Generic tool call wrapper block
│ │ ├── tool-call-generic.vue # Generic tool call (name, status, JSON I/O) │ │ ├── tool-call-generic.vue # Generic tool call (name, status, JSON I/O)
│ │ ├── tool-call-list.vue # File listing tool display │ │ ├── tool-call-list.vue # File listing tool display
│ │ ├── tool-call-read.vue # File read tool display │ │ ├── tool-call-read.vue # File read tool display
@@ -128,20 +136,51 @@ src/
│ │ ├── tool-call-schedule.vue # Schedule tool display │ │ ├── tool-call-schedule.vue # Schedule tool display
│ │ ├── tool-call-contacts.vue # Contacts tool display │ │ ├── tool-call-contacts.vue # Contacts tool display
│ │ ├── tool-call-subagent.vue # Sub-agent tool display │ │ ├── tool-call-subagent.vue # Sub-agent tool display
│ │ └── tool-call-skill.vue # Skill activation tool display │ │ ├── tool-call-skill.vue # Skill activation tool display
│ │ ├── schedule-trigger-block.vue # Schedule trigger display
│ │ └── heartbeat-trigger-block.vue # Heartbeat trigger display
│ ├── bots/ # Bot list + detail (tabs: overview, memory, channels, etc.) │ ├── bots/ # Bot list + detail (tabs: overview, memory, channels, etc.)
│ │ ├── index.vue # Bot grid with create dialog │ │ ├── index.vue # Bot grid with create dialog
│ │ ├── detail.vue # Bot detail with tabbed interface │ │ ├── detail.vue # Bot detail with tabbed interface
│ │ └── components/ # Bot sub-components (25+ files) │ │ └── components/ # Bot sub-components (27 files)
│ ├── models/ # LLM provider & model management │ │ ├── bot-overview.vue # Bot overview tab
│ ├── search-providers/ # Search provider management (12+ engine configs) │ │ ├── bot-settings.vue # Bot settings tab
│ ├── memory-providers/ # Memory provider management │ │ ├── bot-channels.vue # Channel configuration tab
│ ├── tts-providers/ # TTS provider & model management │ │ ├── bot-memory.vue # Memory configuration tab
│ ├── email-providers/ # Email provider management │ │ ├── bot-mcp.vue # MCP connections tab
│ ├── browser-contexts/ # Browser context management │ │ ├── bot-schedule.vue # Schedule management tab
│ │ ├── bot-heartbeat.vue # Heartbeat configuration tab
│ │ ├── bot-email.vue # Email configuration tab
│ │ ├── bot-container.vue # Container management tab
│ │ ├── bot-files.vue # File browser tab
│ │ ├── bot-terminal.vue # Terminal tab
│ │ ├── bot-skills.vue # Skills tab
│ │ ├── bot-access.vue # Access control tab
│ │ ├── bot-compaction.vue # Compaction settings tab
│ │ ├── bot-card.vue # Bot card component
│ │ ├── create-bot.vue # Create bot dialog
│ │ ├── model-select.vue # Model selection dropdown
│ │ ├── model-options.vue # Model options configuration
│ │ ├── reasoning-effort-select.vue # Reasoning effort selector
│ │ ├── reasoning-effort.ts # Reasoning effort constants
│ │ ├── search-provider-select.vue # Search provider selector
│ │ ├── memory-provider-select.vue # Memory provider selector
│ │ ├── browser-context-select.vue # Browser context selector
│ │ ├── tts-model-select.vue # TTS model selector
│ │ ├── channel-settings-panel.vue # Channel settings panel
│ │ ├── container-create-progress.vue # Container creation progress
│ │ └── weixin-qr-login.vue # WeChat QR login
│ ├── providers/ # LLM provider & model management
│ ├── web-search/ # Web search provider management
│ ├── memory/ # Memory provider management
│ ├── speech/ # TTS / speech provider & model management
│ ├── email/ # Email provider management
│ ├── browser/ # Browser context management
│ ├── supermarket/ # Supermarket (template/skill marketplace)
│ ├── usage/ # Token usage statistics │ ├── usage/ # Token usage statistics
│ ├── settings/ # User settings (profile, password, bind codes) │ ├── profile/ # User profile settings (password, bind codes)
│ ├── platform/ # Platform management │ ├── platform/ # Platform management
│ ├── about/ # About page
│ └── oauth/ # OAuth callback pages │ └── oauth/ # OAuth callback pages
│ └── mcp-callback.vue # MCP OAuth callback handler │ └── mcp-callback.vue # MCP OAuth callback handler
├── store/ # Pinia stores ├── store/ # Pinia stores
@@ -149,12 +188,15 @@ src/
│ ├── settings.ts # UI settings (theme, language) │ ├── settings.ts # UI settings (theme, language)
│ ├── capabilities.ts # Server capabilities (container backend) │ ├── capabilities.ts # Server capabilities (container backend)
│ ├── chat-selection.ts # Current bot/session selection (localStorage persisted) │ ├── chat-selection.ts # Current bot/session selection (localStorage persisted)
│ └── chat-list.ts # Chat messages, streaming state, SSE/WS event processing │ ├── chat-list.ts # Chat messages, streaming state, SSE/WS event processing
│ └── chat-list.utils.ts # Chat list utility functions (+ chat-list.utils.test.ts)
├── stores/ # Additional stores (non-core)
│ └── supermarket-mcp-draft.ts # Supermarket MCP draft state
└── utils/ # Utility functions └── utils/ # Utility functions
├── api-error.ts # API error message extraction ├── api-error.ts # API error message extraction
├── date-time.ts # Date/time formatting ├── date-time.ts # Date/time formatting
├── date-time.test.ts # Date/time tests ├── date-time.test.ts # Date/time tests
├── channel-icons.ts # Channel platform icons ├── channel-type-label.ts # Channel type label utilities
├── key-value-tags.ts # Tag ↔ Record conversion ├── key-value-tags.ts # Tag ↔ Record conversion
├── key-value-tags.test.ts # Tag conversion tests ├── key-value-tags.test.ts # Tag conversion tests
├── image-ref.ts # Image reference URL resolution ├── image-ref.ts # Image reference URL resolution
@@ -182,15 +224,17 @@ Both routes render the same `home/index.vue` component. The `home` route shows a
|------|------|-----------|-------------| |------|------|-----------|-------------|
| `/settings/bots` | bots | `bots/index.vue` | Bot list grid | | `/settings/bots` | bots | `bots/index.vue` | Bot list grid |
| `/settings/bots/:botId` | bot-detail | `bots/detail.vue` | Bot detail with tabs | | `/settings/bots/:botId` | bot-detail | `bots/detail.vue` | Bot detail with tabs |
| `/settings/models` | models | `models/index.vue` | LLM provider & model management | | `/settings/providers` | providers | `providers/index.vue` | LLM provider & model management |
| `/settings/search-providers` | search-providers | `search-providers/index.vue` | Search provider management | | `/settings/web-search` | web-search | `web-search/index.vue` | Web search provider management |
| `/settings/memory-providers` | memory-providers | `memory-providers/index.vue` | Memory provider management | | `/settings/memory` | memory | `memory/index.vue` | Memory provider management |
| `/settings/tts-providers` | tts-providers | `tts-providers/index.vue` | TTS provider & model management | | `/settings/speech` | speech | `speech/index.vue` | TTS / speech provider & model management |
| `/settings/email-providers` | email-providers | `email-providers/index.vue` | Email provider management | | `/settings/email` | email | `email/index.vue` | Email provider management |
| `/settings/browser-contexts` | browser-contexts | `browser-contexts/index.vue` | Browser context management | | `/settings/browser` | browser | `browser/index.vue` | Browser context management |
| `/settings/supermarket` | supermarket | `supermarket/index.vue` | Template/skill marketplace |
| `/settings/usage` | usage | `usage/index.vue` | Token usage statistics | | `/settings/usage` | usage | `usage/index.vue` | Token usage statistics |
| `/settings/profile` | settings | `settings/index.vue` | User profile settings | | `/settings/profile` | profile | `profile/index.vue` | User profile settings |
| `/settings/platform` | platform | `platform/index.vue` | Platform management | | `/settings/platform` | platform | `platform/index.vue` | Platform management |
| `/settings/about` | about | `about/index.vue` | About page |
`/settings` redirects to `/settings/bots` by default. `/settings` redirects to `/settings/bots` by default.
@@ -206,7 +250,7 @@ Both routes render the same `home/index.vue` component. The `home` route shows a
- All routes except `/login` and `/oauth/*` require `localStorage.getItem('token')`. - All routes except `/login` and `/oauth/*` require `localStorage.getItem('token')`.
- Logged-in users accessing `/login` are redirected to `/`. - Logged-in users accessing `/login` are redirected to `/`.
- Chunk load errors (dynamic import failures) trigger an automatic page reload. - Chunk load errors (dynamic import failures) trigger an automatic page reload.
- Tauri integration: `afterEach` hook calls `resize_for_route` when running inside Tauri. - Tauri integration: `afterEach` hook calls `resize_for_route` via `@tauri-apps/api/core` when running inside Tauri.
## Layout System ## Layout System
@@ -219,15 +263,15 @@ Two-section layout architecture, both sharing the same `MainLayout` wrapper:
- **MainContainer** (`components/main-container/`) — `<KeepAlive>` wrapped `<RouterView>` for chat pages. - **MainContainer** (`components/main-container/`) — `<KeepAlive>` wrapped `<RouterView>` for chat pages.
3. **Settings Section** (`pages/settings-section/`) — Uses `MainLayout` with: 3. **Settings Section** (`pages/settings-section/`) — Uses `MainLayout` with:
- **SettingsSidebar** (`components/settings-sidebar/`) — Collapsible settings navigation. Top has a "back to chat" button that restores the last selected bot/session. Menu items: Bots, Models, Search Providers, Memory Providers, TTS Providers, Email Providers, Browser Contexts, Usage, Settings, Platform. - **SettingsSidebar** (`components/settings-sidebar/`) — Collapsible settings navigation. Top has a "back to chat" button that restores the last selected bot/session. Menu items: Bots, Providers, Web Search, Memory, Speech, Email, Browser, Supermarket, Usage, Profile, About.
- **SidebarInset** — `<KeepAlive>` wrapped `<RouterView>` for settings pages. - **SidebarInset** — `<KeepAlive>` wrapped `<RouterView>` for settings pages.
4. **Home/Chat Page** (`pages/home/`) — Internal layout: 4. **Home/Chat Page** (`pages/home/`) — Internal layout:
- **SessionSidebar** — Left panel: session search, source filter, new session button, session list. - **SessionSidebar** — Left panel: session search, source filter, new session button, session list.
- **ChatArea** — Center panel: message list with scroll, input area with attachments. - **ChatArea** — Center panel: message list with scroll, input area with attachments.
- **SessionMetadata** — Right panel (currently disabled): collapsible session metadata. - **SessionInfoPanel** — Right panel: session info display.
Several settings pages use **MasterDetailSidebarLayout** (`components/master-detail-sidebar-layout/`) for left-sidebar + detail-panel patterns (models, search providers, email providers, memory providers, tts providers, browser contexts). Several settings pages use **MasterDetailSidebarLayout** (`components/master-detail-sidebar-layout/`) for left-sidebar + detail-panel patterns (providers, web search, email, memory, speech, browser).
## CSS & Theming ## CSS & Theming
@@ -265,6 +309,7 @@ All UI primitives are provided by `@memohai/ui` (43 component groups built on Re
``` ```
style.css — Tailwind + theme tokens style.css — Tailwind + theme tokens
animate.css — Animation utilities
markstream-vue/index.css — Markdown rendering markstream-vue/index.css — Markdown rendering
katex/dist/katex.min.css — Math rendering katex/dist/katex.min.css — Math rendering
vue-sonner/style.css — Toast notifications (in App.vue) vue-sonner/style.css — Toast notifications (in App.vue)
@@ -377,7 +422,12 @@ SDK also generates colada helpers: `getBotsQuery()`, `postBotsMutation()`, query
| `settings` | `settings` | Theme (dark/light), language (en/zh), synced with `useColorMode` and vue-i18n locale | | `settings` | `settings` | Theme (dark/light), language (en/zh), synced with `useColorMode` and vue-i18n locale |
| `capabilities` | `capabilities` | Server feature flags (container backend, snapshot support), loaded once from `getPing()` | | `capabilities` | `capabilities` | Server feature flags (container backend, snapshot support), loaded once from `getPing()` |
| `chat-selection` | `chat-selection` | Current bot ID and session ID, persisted via `useStorage` to localStorage | | `chat-selection` | `chat-selection` | Current bot ID and session ID, persisted via `useStorage` to localStorage |
| `chat-list` | `chat` | Chat messages, sessions, bots, streaming state, SSE/WS event processing. Depends on `chat-selection` store for current bot/session | | `chat-list` | `chat` | Chat messages, sessions, bots, streaming state, SSE/WS event processing. Depends on `chat-selection` store for current bot/session. Utility functions in `chat-list.utils.ts` |
Additional stores in `stores/`:
| Store | Purpose |
|-------|---------|
| `supermarket-mcp-draft` | Supermarket MCP draft state management |
Stores use Composition API style (`defineStore(() => { ... })`), with persistence via `pinia-plugin-persistedstate` or `useStorage`. Stores use Composition API style (`defineStore(() => { ... })`), with persistence via `pinia-plugin-persistedstate` or `useStorage`.
@@ -410,7 +460,7 @@ Chat supports two transport modes: **Server-Sent Events (SSE)** and **WebSocket*
- Locales: `en` (English, default), `zh` (Chinese) - Locales: `en` (English, default), `zh` (Chinese)
- Files: `src/i18n/locales/en.json`, `src/i18n/locales/zh.json` - Files: `src/i18n/locales/en.json`, `src/i18n/locales/zh.json`
- Usage: `const { t } = useI18n()` → `t('bots.title')` - Usage: `const { t } = useI18n()` → `t('bots.title')`
- Key namespaces: `common`, `auth`, `sidebar`, `settings`, `chat`, `models`, `provider`, `searchProvider`, `emailProvider`, `mcp`, `bots`, `home` - Key namespaces: `common`, `auth`, `sidebar`, `breadcrumb`, `settings`, `about`, `chat`, `models`, `provider`, `webSearch`, `memory`, `speech`, `email`, `browser`, `mcp`, `home`, `bots`, `usage`, `supermarket`
## Vite Configuration ## Vite Configuration