设置项参考
本页是 Elftia 所有用户可配置设置的完整参考。设置按标签页分组，与应用内的设置页面对应。
通用设置
位于 设置 → 通用。
语言
| 设置项 | 选项 | 默认值 | 说明 |
|---|---|---|---|
| 界面语言 | 简体中文 / English / 日本語 | 跟随系统 | 应用的界面显示语言 |
切换语言后立即生效，无需重启。
代理
| 设置项 | 选项 | 默认值 | 说明 |
|---|---|---|---|
| 代理模式 | 系统代理 / 自定义代理 / 无代理 | 系统代理 | 网络请求使用的代理方式 |
| 自定义代理 URL | 文本输入 | 空 | 仅在「自定义代理」模式下生效 |
详见 使用代理。
启动
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 开机自启动 | 开关 | 关 | 操作系统启动时自动运行 Elftia |
| 启动时最小化 | 开关 | 关 | 自启动后最小化到托盘而非显示窗口 |
托盘
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 最小化到托盘 | 开关 | 关 | 关闭窗口时最小化到系统托盘，而非退出应用 |
通知
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 桌面通知 | 开关 | 开 | 收到新消息时显示系统通知 |
| 通知音效 | 开关 | 开 | 通知时播放提示音 |
环境工具
显示系统中已安装的开发工具状态，位于通用设置页面底部。
| 工具 | 用途 | 可自动安装 |
|---|---|---|
| Node.js | MCP 服务器运行时 | 否 |
| Git | 版本控制 | 否 |
| ripgrep (rg) | 快速文件搜索 | 是 |
| uv | Python 包管理 | 是 |
| uvx | Python 工具运行 | 是 |
标记为「可自动安装」的工具可以点击「安装」按钮自动安装。
外观设置
位于 设置 → 外观。详细说明见 主题与外观。
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 主题模式 | 浅色 / 深色 / 跟随系统 | 跟随系统 | 界面配色方案 |
| 强调色 | 颜色选择 | 预设蓝色 | 按钮、链接等元素的主题色 |
| UI 字体 | 文本输入 | Inter | 界面文字的字体 |
| 代码字体 | 文本输入 | JetBrains Mono | 代码块的等宽字体 |
| 壁纸（浅色模式） | 图片上传 / URL | 无 | 浅色模式的背景壁纸 |
| 壁纸（深色模式） | 图片上传 / URL | 无 | 深色模式的背景壁纸 |
| 模糊强度 | 滑块 0-30 | 6 | 壁纸的高斯模糊程度 |
| 遮罩透明度 | 滑块 0-100 | 70 | 壁纸遮罩层的不透明度 |
| 紧凑窗口禁用壁纸 | 开关 | 开 | 窗口较小时自动关闭壁纸 |
| 自定义 CSS | CSS 编辑器 | 空 | 注入自定义样式 |
| 允许远程资源 | 开关 | 关 | 允许加载远程图片和字体 |
| 远程域名白名单 | 列表 | 默认列表 | 允许加载资源的域名 |
提供商设置
位于 设置 → 提供商设置。详细说明见 LLM 提供商配置。
每个提供商可配置以下选项：
| 设置项 | 类型 | 说明 |
|---|---|---|
| API Key | 密码输入 | 提供商的 API 密钥 |
| Base URL | 文本输入 | API 端点地址（支持自定义端点） |
| 启用 | 开关 | 是否激活此提供商 |
| API Key 池 | 多密钥管理 | 配置多个 API Key 进行负载均衡 |
API Key 池
每个提供商支持配置多个 API Key，系统会通过加权轮询自动选择：
| 设置项 | 类型 | 说明 |
|---|---|---|
| 密钥列表 | 列表 | 多个 API Key 条目 |
| 权重 | 数字 | 每个 Key 的选择权重 |
| 启用/禁用 | 开关 | 单个 Key 的启用状态 |
当某个 Key 遇到 429（限速）或 529（过载）错误时，系统会自动切换到其他可用 Key，并为失败 Key 设置冷却期（60 秒到 15 分钟的指数退避）。
默认模型
位于 设置 → 默认模型。
| 设置项 | 用途 | 说明 |
|---|---|---|
| 通用聊天 | 日常对话的默认模型 | 新建对话时自动选择 |
| 长上下文 | 长文档处理的模型 | 上下文超过阈值时自动切换 |
| 网页搜索 | 搜索总结的模型 | 启用网页搜索时使用 |
| 图片生成 | 图片生成模型 | 创建图片时使用 |
| 后台任务 | 后台处理的模型 | 对话标题生成、摘要等 |
每个类别可以从所有已启用提供商的可用模型中选择。
Agent 设置（Clawia）
位于 设置 → Clawia（Agent 配置标签页）。
Agent 引擎
| 设置项 | 选项 | 默认值 | 说明 |
|---|---|---|---|
| Agent 后端 | Claude SDK / TinyElf / CLI | Claude SDK | Agent 执行引擎 |
- Claude SDK：使用 Anthropic 的 Agent SDK，功能最完整。
- TinyElf：内置轻量级 Agent 引擎，支持任意 LLM 提供商。
- CLI：通过命令行调用外部 Agent 工具（Claude Code CLI、Codex CLI 等）。
CLI 后端设置（仅 CLI 模式）
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| CLI 工具 | 选择 | Claude Code | 使用的 CLI 后端 |
| 超时时间 | 数字（秒） | 300 | 单次执行的最大时长 |
| PTY 模式 | 开关 | 关 | 使用伪终端运行 |
| PTY 列数 | 数字 | 120 | PTY 终端宽度 |
| PTY 行数 | 数字 | 40 | PTY 终端高度 |
提示词版本
| 设置项 | 选项 | 默认值 | 说明 |
|---|---|---|---|
| 提示词版本 | V1 / V2 / V3 / V4 | V4 | 系统提示词的构建方式 |
- V1：SDK 预设 + 简单追加（时间、工作区、记忆、渠道）
- V2：完全自定义系统提示词（PromptBuilder）
- V3：V2 + 5 层结构（bootstrap、onboarding、记忆、渠道、动态）
- V4：SDK 预设 + bootstrap 文件 + soul/记忆/onboarding/渠道/调度
V4 是推荐的默认版本，结合了 SDK 的优化预设和项目特定的定制内容。大多数用户不需要更改此设置。
安全设置
| 设置项 | 选项 | 默认值 | 说明 |
|---|---|---|---|
| GuardianAgent 模式 | 关闭 / 监控 / 守卫 / 严格 | 关闭 | AI 安全审查级别 |
详见 安全设置。
会话模式
| 设置项 | 选项 | 默认值 | 说明 |
|---|---|---|---|
| 默认会话模式 | 继续 / 新建 | 继续 | 打开应用时的默认行为 |
- 继续：打开应用时恢复上次的对话会话。
- 新建：每次打开应用时创建新的对话会话。
开发者模式
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 开发者模式 | 开关 | 关 | 启用后可访问 DevTools 和额外的调试信息 |
开发者模式需要在 设置 → 关于 中通过特定操作激活（连续点击版本号），激活后在 Clawia 标签页中可以看到开发者模式的开关。
网页搜索设置
位于 设置 → 网页搜索。详细说明见 网页搜索功能。
| 设置项 | 类型 | 说明 |
|---|---|---|
| 搜索提供商 | 选择 | 选择网页搜索引擎提供商 |
| 编排策略 | 选择 | 搜索结果的编排方式 |
| 压缩设置 | 选项 | 搜索结果内容的压缩级别 |
| 域名黑名单 | 列表 | 不从这些域名获取搜索结果 |
系统设置
位于 设置 → 系统。
诊断工具
| 操作 | 说明 |
|---|---|
| Export Diagnostics | 导出诊断信息（日志、配置、运行时环境） |
| Clear Caches | 清除本地缓存数据 |
| Copy diagnostics log | 将诊断日志复制到剪贴板 |
| Prune attachments | 清理未关联的附件文件 |
数据库维护
| 操作 | 说明 |
|---|---|
| 数据库大小 | 显示当前 SQLite 数据库文件大小 |
| VACUUM | 执行数据库压缩优化，释放已删除数据占用的空间 |
资源清理
| 操作 | 说明 |
|---|---|
| 可清理数量 | 显示可以安全删除的孤立资源数量和大小 |
| 清理资源 | 执行资源清理 |
数据导入与迁移
| 操作 | 说明 |
|---|---|
| Legacy JSONL 导入 | 把 ~/.claude/projects/*.jsonl 同步到数据库，支持快速分页查询 |
| 缩略图生成 | 为已有图片批量生成缩略图，提升列表与图库加载速度 |
| 附件存储迁移 | 把旧版 media:// 附件迁移到 resource:// 内容寻址存储，去重并节省空间 |
实验性功能
部分正在测试的新功能可以在此区域开关。实验性功能可能不稳定，仅建议高级用户启用：
| 功能 | 说明 |
|---|---|
| 新文件系统 | 流式搜索、ripgrep 集成与自修复回退机制 |
| 优化文件树 | 增强的树形渲染与增量更新 |
遇到异常可随时关闭回退到稳定版本。
:::info Design Studio 已默认启用
Design Studio 在 0.1.7 起默认启用，不再放在 Experimental Features 里。导航栏直接出现 🎨 Design Studio 入口，启用门槛只剩一条：当前 LLM provider 的引擎要支持 Design 适配器（api engine 不支持）。详见 Design Studio。
:::
关于
位于 设置 → 关于。
| 信息 | 说明 |
|---|---|
| 版本号 | 当前 Elftia 版本 |
| 检查更新 | 手动检查是否有新版本 |
| 开发者模式 | 连续点击版本号启用 |
| DevTools | 开发者模式下可打开/关闭 Electron DevTools |
| 账号状态 | 登录状态和会员信息 |
如需了解安全相关设置的详细说明，请继续阅读 安全设置。