Files
lobehub__lobehub/docs/usage/user-interface/shortcuts.mdx
YuTengjing 191f3fe776 📝 docs: fix outdated content across the docs site (#16964)
* 📝 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.
2026-07-10 17:50:03 +08:00

79 lines
4.0 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Keyboard Shortcuts
description: >-
Master LobeHub with keyboard shortcuts — command palette, Agent switching,
message regeneration, and more. Customize to fit your workflow.
tags:
- LobeHub
- Keyboard Shortcuts
- Productivity
- Custom Shortcuts
---
# Keyboard Shortcuts
LobeHub provides a comprehensive set of keyboard shortcuts so you can work without constantly reaching for the mouse. Master a few key ones and your workflow noticeably speeds up — especially when switching Agents, managing conversations, or navigating the interface.
## How to Access Shortcut Settings
Click your user avatar in the top-right corner → **App Settings** → **Shortcuts**. You can view all shortcuts and customize most of them.
<Image alt={'Keyboard Shortcuts'} src={'/blog/assets58737403bd41f2f0ea70bdea609e9169.webp'} />
## Essential Shortcuts
| Action | Shortcut |
| -------------------------- | -------------------------------------- |
| **Open Command Menu** | `⌘ + K` (Mac) / `Ctrl + K` (Win/Linux) |
| **Focus search** | `⌘ + J` / `Ctrl + J` |
| **Switch to pinned Agent** | `Ctrl + 1–9` |
| **Toggle left panel** | `⌘ + [` / `Ctrl + [` |
| **Toggle right panel** | `⌘ + ]` / `Ctrl + ]` |
| **Shortcut help** | `Ctrl + Shift + ?` |
## Conversation Shortcuts
Conversation shortcuts use the **Option** key on Mac and **Alt** on Windows/Linux — a different modifier from the Essential Shortcuts above.
| Action | Shortcut |
| ------------------------------- | -------------------------------------------------------------------------- |
| **Open conversation settings** | `Option + ,` (Mac) / `Alt + ,` (Win) |
| **Regenerate message** | `Option + R` / `Alt + R` |
| **Delete last message** | `Option + D` / `Alt + D` |
| **Delete and regenerate** | `Option + Shift + R` / `Alt + Shift + R` |
| **New Topic** | `Option + N` / `Alt + N` |
| **Add message without sending** | `Option + Enter` / `Alt + Enter` |
| **Edit message** | `Option + double-click` message (Mac) / `Alt + double-click` message (Win) |
**Add message without sending** — useful when you want to add context to the conversation without triggering an immediate response. The Agent will see the new message when it next replies.
## Document Shortcuts
| Action | Shortcut |
| ----------------- | -------------------- |
| **Save document** | `⌘ + S` / `Ctrl + S` |
## Custom Shortcuts
Most shortcuts can be customized. In the Shortcuts settings panel, click the shortcut you want to change, then press your desired key combination. Useful when:
- Your muscle memory conflicts with another app
- You want to prioritize actions you use most
- You're on a different keyboard layout
**Tip:** Start with the Command Menu (`⌘ + K` / `Ctrl + K`) — it's the fastest way to jump to any Agent, Topic, or setting.
## Use Cases
**Power-user workflow** — `⌘ + K` to open Command Menu → type Agent name → Enter. Switch Agents in under a second.
**Quick iteration** — `Option + R` (Mac) / `Alt + R` (Win) to regenerate. `Option + Shift + R` / `Alt + Shift + R` if you want to delete the last message first, then regenerate.
**Multi-Agent work** — Pin your top Agents to the sidebar, then use `Ctrl + 1–9` to switch between them without touching the mouse.
<Cards>
<Card href={'/docs/usage/user-interface/command-menu'} title={'Command Menu'} />
<Card href={'/docs/usage/getting-started/page'} title={'Pages'} />
</Cards>