mirror of
https://github.com/lobehub/lobehub.git
synced 2026-09-20 04:56:13 +08:00
191f3fe776
* 📝 docs: fix outdated content across the docs site Audited docs/ against the current codebase and fixed stale content that drifted after major refactors (Clerk/NextAuth → Better Auth, src/server → apps/server, src/{config,envs,locales} → packages/*, model-bank updates). - self-hosting/auth: mark removed NextAuth/Clerk pages with deprecation warnings; fix microsoft/zitadel alias claims and the Logto callback path - environment-variables & advanced: correct wrong defaults (S3_SET_ACL, AI_IMAGE_DEFAULT_IMAGE_NUM, index/proxy URLs), drop non-existent env vars and fictional feature flags, fix OIDC config guidance - development: update refactored paths, Better Auth, .mjs configs, remove the MSW section (msw is not a dependency) - providers & model examples: replace retired model ids with in-bank ones; fix comfyui frontmatter corruption - usage: rename Moderator→Orchestrator, GTD→Task, correct shortcut keys, channel capability tables, Feishu/Lark WebSocket mode - platform/migration: fix dead links, docker service name, npx/npm → bun EN and zh-CN pairs updated together. * 📝 docs: fix Logto callback path and AUTH_SECRET deprecation guidance - Revert Logto/Sealos callback URLs to /api/auth/callback/logto to match the runtime SSO redirectURI override - Narrow legacy auth Callout: AUTH_SECRET remains required for Better Auth; mark NEXT_AUTH_SECRET as deprecated in zh-CN * 📝 docs: refresh agent skills for locales, env, auth, and agentRun paths Align OSS agent guidance with post-refactor layout: - packages/locales/src/default + bun run i18n - packages/env/src for env schemas (@/envs alias) - spa-auth shell + src/routes/auth segments - chat agentRun/transports/hetero instead of aiChat * 📝 docs: document APP_URL as required for Better Auth base URL Self-hosted auth uses appEnv.APP_URL as baseURL, not request-header auto-detection. NEXT_PUBLIC_AUTH_URL remains deprecated. * 📝 docs: note self-host search provider setup for web search Built-in lobe-web-browsing needs no client plugin, but self-hosted servers still require SEARCH_PROVIDERS / SEARXNG_URL (default SearXNG). * 📝 docs: point feature guide welcome UI at AgentHome Opening message/questions on the agent chat page live in src/features/AgentHome, not Onboarding WelcomeMessage.
82 lines
3.6 KiB
Plaintext
82 lines
3.6 KiB
Plaintext
---
|
|
title: Interface Appearance
|
|
description: >-
|
|
Customize LobeHub's look — theme, colors, language, code highlighting, and
|
|
Mermaid diagrams. Make it yours.
|
|
tags:
|
|
- LobeHub
|
|
- Appearance
|
|
- Theme
|
|
- Language
|
|
- Customization
|
|
---
|
|
|
|
# Interface Appearance
|
|
|
|
Appearance settings let you customize how LobeHub looks and feels. Switch themes, pick accent colors, set the default language for Agent responses, and tune code and diagram styling. All visual-related options are grouped here.
|
|
|
|
**How to access:** Click your user avatar in the top-right corner → **App Settings** → **Appearance**.
|
|
|
|
## Language
|
|
|
|
Switch the interface language. LobeHub supports multiple locales — choose the one that fits your workflow.
|
|
|
|
## Theme Mode
|
|
|
|
Three options:
|
|
|
|
| Mode | Best For |
|
|
| ----------------- | ------------------------------------------ |
|
|
| **Light** | Bright environments, daytime use |
|
|
| **Dark** | Low-light environments, reduced eye strain |
|
|
| **Follow System** | Match your OS preference (default) |
|
|
|
|
**Follow System** automatically switches between light and dark based on your operating system setting. Useful if you use LobeHub across different times of day or environments.
|
|
|
|
## Theme Colors
|
|
|
|
Beyond light and dark, you can set an **accent color** — the color used for buttons, highlights, links, and other interactive elements. LobeHub offers preset theme and neutral colors. Click a swatch to apply it; the interface updates immediately.
|
|
|
|
**Use cases:** Match your brand, reduce visual clutter with a neutral palette, or pick a color that helps you focus.
|
|
|
|
## Agent Language
|
|
|
|
Set the **default language for Agent responses**. Once selected, Agents will prioritize replying in that language unless you explicitly request another in the conversation.
|
|
|
|
**Example:** If you set "Chinese," the Agent will reply in Chinese by default. You can still say "Reply in English" for a specific message.
|
|
|
|
## Code Highlighting
|
|
|
|
When your conversation or document includes code blocks, you can choose a **syntax highlighting theme**. Choose one that complements your overall theme — light themes pair well with light code themes, dark with dark.
|
|
|
|
**Use cases:** Improve readability during code reviews, match your IDE's color scheme for consistency, or reduce eye strain in long coding sessions.
|
|
|
|
## Mermaid Theme
|
|
|
|
Mermaid is a text-based diagram tool. When your conversation or document includes Mermaid diagrams (flowcharts, sequence diagrams, etc.), you can choose a **Mermaid theme** for them. Align it with your overall theme so diagrams look consistent with the rest of the interface.
|
|
|
|
## Response Animation
|
|
|
|
Choose the animation speed used for the application's response actions (e.g. message streaming and transitions).
|
|
|
|
| Mode | Description |
|
|
| ----------- | --------------------------------- |
|
|
| **Off** | Disable response animations |
|
|
| **Agile** | Quick, snappy animation timing |
|
|
| **Elegant** | Smoother, slower animation timing |
|
|
|
|
## Right-Click Menu Mode
|
|
|
|
Choose whether the right-click context menu is enabled for some list items.
|
|
|
|
| Mode | Description |
|
|
| ------------ | --------------------------------------------------- |
|
|
| **Disabled** | No right-click menu on the supported list items |
|
|
| **Default** | Enable the right-click menu for the supported items |
|
|
|
|
<Cards>
|
|
<Card href={'/docs/usage/user-interface/shortcuts'} title={'Keyboard Shortcuts'} />
|
|
|
|
<Card href={'/docs/usage/agent/translate'} title={'Conversation Translation'} />
|
|
</Cards>
|