跳到主要内容

设置项参考

本页是 Elftia 所有用户可配置设置的完整参考。设置按标签页分组,与应用内的设置页面对应。

通用设置​

位于 设置 → 通用。

语言​

设置项选项默认值说明
界面语言简体中文 / English / 日本語跟随系统应用的界面显示语言

切换语言后立即生效,无需重启。

代理​

设置项选项默认值说明
代理模式系统代理 / 自定义代理 / 无代理系统代理网络请求使用的代理方式
自定义代理 URL文本输入空仅在「自定义代理」模式下生效

详见 使用代理。

启动​

设置项类型默认值说明
开机自启动开关关操作系统启动时自动运行 Elftia
启动时最小化开关关自启动后最小化到托盘而非显示窗口

托盘​

设置项类型默认值说明
最小化到托盘开关关关闭窗口时最小化到系统托盘,而非退出应用

通知​

设置项类型默认值说明
桌面通知开关开收到新消息时显示系统通知
通知音效开关开通知时播放提示音

环境工具​

显示系统中已安装的开发工具状态,位于通用设置页面底部。

工具用途可自动安装
Node.jsMCP 服务器运行时否
Git版本控制否
ripgrep (rg)快速文件搜索是
uvPython 包管理是
uvxPython 工具运行是

标记为「可自动安装」的工具可以点击「安装」按钮自动安装。

外观设置​

位于 设置 → 外观。详细说明见 主题与外观。

设置项类型默认值说明
主题模式浅色 / 深色 / 跟随系统跟随系统界面配色方案
强调色颜色选择预设蓝色按钮、链接等元素的主题色
UI 字体文本输入Inter界面文字的字体
代码字体文本输入JetBrains Mono代码块的等宽字体
壁纸(浅色模式)图片上传 / URL无浅色模式的背景壁纸
壁纸(深色模式)图片上传 / URL无深色模式的背景壁纸
模糊强度滑块 0-306壁纸的高斯模糊程度
遮罩透明度滑块 0-10070壁纸遮罩层的不透明度
紧凑窗口禁用壁纸开关开窗口较小时自动关闭壁纸
自定义 CSSCSS 编辑器空注入自定义样式
允许远程资源开关关允许加载远程图片和字体
远程域名白名单列表默认列表允许加载资源的域名

提供商设置​

位于 设置 → 提供商设置。详细说明见 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 / CLIClaude SDKAgent 执行引擎
  • Claude SDK:使用 Anthropic 的 Agent SDK,功能最完整。
  • TinyElf:内置轻量级 Agent 引擎,支持任意 LLM 提供商。
  • CLI:通过命令行调用外部 Agent 工具(Claude Code CLI、Codex CLI 等)。

CLI 后端设置(仅 CLI 模式)​

设置项类型默认值说明
CLI 工具选择Claude Code使用的 CLI 后端
超时时间数字(秒)300单次执行的最大时长
PTY 模式开关关使用伪终端运行
PTY 列数数字120PTY 终端宽度
PTY 行数数字40PTY 终端高度

提示词版本​

设置项选项默认值说明
提示词版本V1 / V2 / V3 / V4V4系统提示词的构建方式
  • 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
账号状态登录状态和会员信息

如需了解安全相关设置的详细说明,请继续阅读 安全设置。