本文档涵盖 LobeChat 完整的用户设置和偏好系统，包括用户界面偏好、模型配置、Agent 自定义和用户数据管理。该系统允许用户从多个维度自定义其聊天体验。
有关环境变量配置和系统级设置的信息，请参阅环境变量与提供商设置。有关通过环境变量自定义模型列表的详细信息，请参阅模型列表自定义。
LobeChat 的设置系统采用分层结构，包括全局设置、会话特定设置和单个 Agent 配置。该系统支持多语言本地化、数据持久化和云同步。
来源： src/locales/default/setting.ts1-532 locales/zh-CN/setting.json1-528
设置系统被组织成不同的类别，每个类别服务于用户体验的特定方面
| 类别 | 键 | 目的 | 范围 |
|---|---|---|---|
| 通用设置 | settingCommon | 语言、主题模式 | 全局 |
| 外观 | settingAppearance | 用户界面颜色、主题 | 全局 |
| 聊天设置 | settingChat | 聊天行为、历史记录管理 | 会话 |
| 聊天外观 | settingChatAppearance | 字体大小、代码高亮 | 会话 |
| 模型设置 | settingModel | AI 模型参数 | 会话 |
| Agent 信息 | settingAgent | Agent 元数据、提示词 | 独立 |
| 欢迎语设置 | settingOpening | 欢迎消息、问题 | 独立 |
| 系统设置 | settingSystem | 访问码、身份验证 | 全局 |
来源： src/locales/default/setting.ts245-261 src/locales/default/setting.ts173-189 src/locales/default/setting.ts187-232
LLM 配置系统通过综合界面管理 API 密钥、自定义模型和提供商特定设置
来源： src/locales/default/setting.ts57-132 locales/zh-CN/setting.json70-129
系统通过各种参数对 AI 模型行为提供细粒度控制
| 参数 | 设置键 | 描述 | 范围 |
|---|---|---|---|
| 温度 | settingModel.temperature | 创造性与随机性 | 0.0 - 2.0 |
| Top P | settingModel.topP | 核心采样阈值 | 0.0 - 1.0 |
| 频率惩罚 | settingModel.frequencyPenalty | 词汇多样性 | -2.0 - 2.0 |
| 存在惩罚 | settingModel.presencePenalty | 表达发散性 | -2.0 - 2.0 |
| 最大令牌数 | settingModel.maxTokens | 响应长度限制 | 取决于模型 |
| 推理强度 | settingModel.reasoningEffort | 推理强度 | 低/中/高 |
来源： src/locales/default/setting.ts262-308 locales/zh-CN/setting.json258-303
插件系统允许用户通过自定义插件和内置工具扩展 LobeChat 的功能
来源： src/locales/default/setting.ts131-146 src/locales/default/setting.ts519-532
LobeChat 提供全面的数据管理功能，包括本地存储、云同步和数据可移植性
来源： src/locales/default/setting.ts387-414 src/locales/default/setting.ts427-465
基于 WebRTC 的同步系统支持跨设备实时数据同步
| 组件 | 设置键 | 目的 |
|---|---|---|
| 通道名称 | sync.webrtc.channelName | 唯一同步通道标识符 |
| 通道密码 | sync.webrtc.channelPassword | 通道访问安全 |
| 信令服务器 | sync.webrtc.signaling | WebRTC 连接协调 |
| 设备名称 | sync.device.deviceName | 设备标识 |
| 同步状态 | sync.status | 连接状态监控 |
来源： src/locales/default/setting.ts437-464 locales/zh-CN/setting.json437-460
LobeChat 包含全面的文本转语音和语音转文本功能
来源： src/locales/default/setting.ts351-386 locales/zh-CN/setting.json347-381
LobeChat 提供用于访问管理和系统配置的管理控制
来源： src/locales/default/setting.ts323-350 src/locales/default/setting.ts14-36
热键系统提供可自定义的键盘快捷键，以实现高效导航
| 功能 | 设置键 | 描述 |
|---|---|---|
| 热键录制 | hotkey.record | 录制新的键盘快捷键 |
| 冲突检测 | hotkey.conflicts | 检测快捷键冲突 |
| 重置为默认 | hotkey.reset | 恢复默认快捷键 |
| 快捷键组 | hotkey.group | 按类别组织快捷键 |
| 按键验证 | hotkey.invalidCombination | 验证快捷键组合 |
来源： src/locales/default/setting.ts46-56 locales/zh-CN/setting.json46-55