设置与数据:找到选项并验证修改
按用途找到通知、外观、模型、网络、记忆和存储设置,备份数据库,检查系统权限,了解数据保存在哪里。
设置与排障先找到要调整的部分#
点击左侧导航栏底部的账户按钮(悬停显示「账户与设置」),选择设置;Windows 也可以在窗口顶部选择文件 → 设置。设置左侧分为「应用设置」「AI 与连接」「编码」「账户与数据」四组,按你想解决的问题选择分区,不必逐项修改。
| 你想做什么 | 去哪里 |
|---|---|
| 换语言、窗口置顶、新会话权限、发送快捷键、后台运行、检查更新 | 应用设置 → 通用 |
| 选择哪些事件发系统通知、各自用什么提示音 | 应用设置 → 通知 |
| 调整主题、配色、字体、侧栏、阅读密度或动效 | 应用设置 → 外观 |
| 设置自动命名与命名模型,创建可复用标签 | 应用设置 → 会话整理 |
| 修改或清空快捷键,给快捷中心等全局命令绑定组合键 | 应用设置 → 快捷键 |
| 下载识别模型、选择润色模型、设置修正规则与词汇 | 应用设置 → 语音 |
| 设置用户规则、记忆抽取、召回和预算,打开记忆空间 | AI 与连接 → 个性化 |
| 开关助手可调用的内置工具组 | AI 与连接 → 工具 |
| 连接模型、更改服务商和模型配置、默认推理力度 | AI 与连接 → AI 服务 |
| 修改 Claude Code 功能、自动压缩时机、权限规则或环境变量 | AI 与连接 → Claude Code |
| 选择浏览器后端、管理浏览器身份、默认视口与已保存密码 | AI 与连接 → 浏览器 |
| 管理服务器、数据库、API 和账号凭据 | AI 与连接 → 秘钥与主机 |
| 保存代理线路、设置应用代理和浏览器默认网络 | AI 与连接 → 网络代理 |
| 管理会话使用的 Git 工作树 | 编码 → 工作树 |
| 查看许可与设备、Claude 订阅额度、本机用量与费用 | 账户与数据 → 账户与许可证、Claude 订阅用量、活动 |
| 查看录屏、麦克风、辅助功能等系统权限状态 | 账户与数据 → 系统权限 |
| 开启诊断日志、查看数据说明、清除本地数据 | 账户与数据 → 隐私 |
| 查看占用空间、清理旧会话和预览、备份数据库 | 账户与数据 → 存储 |
| 恢复或永久删除归档会话 | 账户与数据 → 归档会话 |
会话标题和标签的完整操作见会话整理;秘钥与 SSH 主机见秘钥库与 SSH;工作树见工作树。每日简报已退役。需要可配置的替代流程,可安装官方每日复盘 Skill,把结果保存在资料空间。
修改前先看当前值#
已有配置会随升级保留。新安装默认值、旧版本缺失字段的回退值和你现在的选择可能不同;不要为了和教程截图一致而重置。
从 1.3.1 或更早版本升级时,有几项按新规则处理:开启但地址或端口不完整的旧代理会视为关闭;⌥⌘K 和 ⌥⌘T 不再默认占用;记忆的模型调用按真实费用计入每日预算,从未设置过预算的早期安装默认每日 $1。逐项默认值见完整设置参考。
常用调整#
让工作界面更清楚
- 打开外观 → 主题与字体。先选浅色、深色或跟随系统,再从八套界面配色中选择一套;在「字体与字号」调整聊天字号和消息字重,例如先试 15px、常规字重。
- 到外观 → 对话显示,长文阅读可试「舒展」密度,想一屏看更多消息可试「紧凑」。经常回看长对话,开启「消息导航器」。
- 想快速打开编辑器,在同一页开启「外部编辑器入口」,再到通用 → 外部应用选择默认工具。
外观选择会自动保存,并应用于所有会话;内置终端和代码编辑器的配色也会跟随。若提示保存失败,使用「重试」,界面会恢复到最近保存成功的外观。
调整侧栏,保留会话内容
- 打开外观 → 侧边栏与会话列表,先选排版预设,再分别调整标记、渠道/定时任务图标和运行状态的位置。
- 在渠道会话标题选择是否显示发送者与群/联系人名称;两项都开时,发送者在前。
- 在导航入口勾选显示项并拖动排序。隐藏项仍能从探索找到,新会话始终排在首位。
初始默认宽度只用于尚未手动调整侧栏的情况。拖动侧栏边缘后会记住你的宽度;双击侧栏边缘可重新使用默认值。
让新任务按合适权限开始
- 在通用 → 新会话默认值 → 默认权限模式选择默认权限、Auto 模式或完全访问。
- 新建会话检查权限按钮。已有会话保留自己的选择,不会因为改全局默认自动同步。
- 需要先审方案时另选 Plan;Plan 和权限档是两项设置。详见权限指南。
只在需要时收到通知
- 打开通知 → 提醒类型。每类事件(需要你确认、秘钥授权、任务完成、后台任务与子智能体、出错与失败)分别勾选应用内或桌面,并选择提示音;选「静音」即关闭该类声音。
- 「任务完成」下方的提醒时机默认为仅在后台时:你没在看这个会话时才提醒,包括应用在前台但正在看其他会话。想每轮都提醒选总是。
- 在桌面通知 → 系统权限点击发送测试通知。macOS 第一次发送会触发系统授权;收不到时点打开系统设置允许 Onevium,并关闭勿扰或专注模式。
选择会立即保存。用一个短任务切到其他会话等待完成,确认收到对应类别的通知和提示音。菜单栏快捷中心和 Dock 菜单可以直接打开等待确认、进行中和最近的会话,见菜单栏快捷中心。
让模型请求走代理线路
- 先在 AI 服务确认模型地址、凭据与选中模型;自定义接口见自定义提供商。
- 打开网络代理,在页面底部「线路」点击添加线路…。填写名称、协议(HTTP、HTTPS 或 SOCKS5)、地址、端口,以及服务方要求时的用户名和密码;也可以把
socks5://用户名:密码@proxy.example.com:1080整段粘贴到地址栏自动拆分。保存线路不会自动启用。 - 在「应用代理」把模式切到仅应用内,在线路中选择刚保存的线路,再点测试。只有一条线路时会自动选用;还没有线路时会直接打开添加线路窗口。
- 测试成功会显示出口 IP、延迟和测试时间;它只说明检测服务看到的出口,不验证模型账号或模型接口。回到新会话发一条短消息,确认真实模型结果。
应用代理用于模型请求、图片生成和终端里新开的命令;已经在运行的程序、SSH 和外部 MCP 不会因此改走代理。浏览器身份可以引用同一条线路,详见浏览器教程。只有需要影响其他应用时才选全局,它会写入系统代理,切回时恢复原设置。
备份数据库与大版本升级#
打开设置 → 存储。上方显示 Onevium 在本机的占用和分类(图 1 中的 ①),下方「数据库备份」可以随时备份,也可以定时备份。
- 点击立即备份一行的创建备份,完成后提示「数据库备份已完成」,「上次成功备份」更新为当前时间。备份可以在使用 Onevium 时进行。
- 需要定期备份时,打开定时备份数据库(图 1 中的 ②),选择每天或每周及星期几(图 1 中的 ③),设置备份时间和自动备份保留份数(1–100,默认 7),再点保存计划。
- 保存后显示「下次定时备份」时间。错过的备份会在下次启动 Onevium 时补做一次。
- 展开备份记录可下载某一份备份;展开备份位置查看保存目录。
图 1:① 本机占用分类,② 定时备份数据库开关,③ 备份频率、时间与保留份数。1.3.2 真实存储设置组件的隔离演示,占用数字、日期和路径均为虚构,未执行备份。
数据库备份包含私密会话与设置,不含原始图片、附件和项目文件。手动备份会一直保留,保留份数只作用于自动备份;备份同样占用空间,会计入「数据库备份」分类。
大版本升级时,首次启动会先在启动页显示真实进度:升级前备份数据、校验备份、升级数据。升级前的快照保存在数据目录的 upgrade-backups 中。升级到 1.3.3 后,1.3.2 无法直接读取新数据;不要用旧版本打开升级后的数据库,也不要删除升级快照。
系统权限与钥匙串#
打开设置 → 系统权限,查看麦克风、摄像头、屏幕与系统音频、辅助功能、自动化、文件与文件夹、通知的状态。打开这一页不会请求授权,也不会开始采集。
图 2:每项权限显示用途和系统状态,例如屏幕与系统音频为「系统未允许」。1.3.2 真实系统权限组件的 macOS 隔离演示,状态为虚构,未读取或修改真实系统权限。
- 状态为尚未申请时,可点申请权限;其他状态用打开系统设置到对应的系统面板,或点前往语音等按钮去相关功能。
- 系统未允许以红色显示。改完系统设置回到 Onevium,点重新检测,再实际使用一次该功能;「系统已允许」只是系统检查结果,不等于录制成功。
- 显示请在系统设置中确认的项目无法在这里可靠读取,请到系统设置核对后实际试用。
macOS 上已经开启仍无法使用时:更新或签名身份变化后,系统可能保留旧的权限记录。完全退出 Onevium,从「应用程序」重新打开后点重新检测;仍被拒绝时,在系统设置中把该权限关闭再开启,支持移除的面板可删除旧条目后添加当前应用。从 1.3.2 起应用使用固定签名,升级到 1.3.2 后需要重新授予一次录屏、麦克风和输入监控权限。
钥匙串密码或 Touch ID 提示与上面的权限无关:每个新版本第一次启动时,macOS 钥匙串会请求一次登录密码,选择始终允许即可。录屏和麦克风权限不会解锁钥匙串中的凭据。
什么时候算修改成功#
| 设置方式 | 生效方式 | 怎样检查 |
|---|---|---|
| 大多数开关、下拉选项、通知类别 | 选择后保存 | 重新进入设置核对,再试对应功能 |
| 界面配色、字体、字号、字重和阅读密度 | 自动保存;所有会话共用 | 查看预览和已有会话,确认没有未处理的保存错误 |
| 定时备份计划 | 点击「保存计划」 | 确认显示「下次定时备份」时间 |
| 代理线路 | 在添加/编辑线路窗口点「保存」 | 线路出现在列表,测试后显示出口与时间 |
| 用户规则、额外直连地址 | 编辑后移开焦点保存 | 离开再返回,确认文字保留 |
| CLI 权限规则、高级 JSON | 点保存;高级更改可能需要确认 | 确认 JSON 合法,保存成功后新开测试会话 |
| 默认权限、默认推理力度 | 用于新会话;会话可覆盖 | 使用对应服务商和模型创建新会话检查 |
| 默认浏览器视口 | 用于新打开的标签 | 新开网页检查尺寸 |
| 禁用硬件加速 | 重启应用后 | 保存任务后重启,再观察闪烁或卡顿 |
开启工具或调整连接后,还要确认一次实际调用;配置保存成功不等于业务操作成功。
数据实际保存在哪里#
| 内容 | 常见位置与范围 |
|---|---|
| Onevium 数据库、媒体、上传和图片 | macOS/Linux 默认 ~/.onevium/;Windows 默认 %APPDATA%/Onevium。自定义数据目录可能不同;「存储 → 存储位置」显示实际目录 |
| 数据库备份 | 数据目录下的 db-backups;「存储 → 备份位置」显示实际目录 |
| 大版本升级前的快照 | 数据目录下的 upgrade-backups |
| Onevium 创建的工作树 | 默认在数据目录下的 worktrees;在「编码 → 工作树」管理 |
| 用户 CLI 设置 | ~/.claude/settings.json;修改也可能影响使用同一配置的 Claude CLI |
| 用户 Skill 与 Agent | ~/.claude/skills/、~/.claude/agents/ |
| 项目扩展与规则 | 项目的 .claude/、CLAUDE.md 等文件 |
| 项目 MCP | 项目根目录 .mcp.json,不是 .claude/settings.json |
| 语音录音 | 由「语音 → 打开录音文件夹」定位 |
| 浏览器 Cookie 与站点数据 | 对应浏览器身份;同一身份的标签共享登录态 |
模型请求会发送到你选择的服务商。远程网站和 MCP 也可能联网。保存在本机,不等于所有处理都离线。
清理方式不要混用#
- 存储 → 清理旧会话:先审阅会话及其子会话,再移入回收站;清理可重建的预览只删除缓存的图片预览,保留原始图片、附件和日志。存储页不会删除正在使用的数据库,也不会自动压缩数据库。
- 归档会话:先预览,再恢复或永久删除选定会话。
- 浏览器 → 清除浏览数据:删除所有浏览器标签共用的 Cookie、缓存和网站数据,可能导致多个标签退出登录。
- 隐私 → 清除本地数据:删除 Onevium 数据库及媒体、上传、图片目录。它不清除项目文件、CLI 配置、浏览器身份、语音记录,也不删除
db-backups和upgrade-backups中的备份。
清理前先在「存储」创建一份数据库备份。不要用清空数据解决普通连接故障。
常见问题#
- 设置已改,旧会话没变化:检查是否为新会话默认值,以及旧会话的覆盖值。
- 看不到某选项:检查平台、安装版本和所需功能是否开启;不要照抄其他版本的截图。
- 代理开着却全部请求失败:线路一行显示「代理已开启但线路不可用」时,重新选择线路或把模式改回关闭;从旧版升级的不完整代理会被视为关闭,需要先添加完整线路。
- 测试成功但模型仍连不上:测试只验证检测服务看到的出口,回到 AI 服务核对地址、凭据和模型。
- 通知不出现:在「通知」点发送测试通知,检查系统通知权限和勿扰;「任务完成」默认只在你没看该会话时提醒。
- 升级后录屏或麦克风失效:在「系统权限」点重新检测,按上文完全退出重开或重新授权。
- 提示上次备份未完成:检查磁盘剩余空间和文件夹访问权限,再点创建备份重试。
- 关闭记忆抽取仍会想起旧事实:抽取控制新增,召回是另一件事;到「个性化 → 记忆空间」检查。
完整备份要包含资料空间
资料空间使用独立的 space 目录,包含数据库、资料文件、附件和版本。「创建备份」及主数据库自动备份计划不等于完整的资料空间备份。迁移电脑或回退 beta 时,请完全退出 Onevium,把当前整个数据目录复制到私有备份位置,另行保留原始项目文件。恢复后打开一份资料及其版本历史确认;仅看到备份文件名不能证明文件齐全。
1.3.3 升级后的主库不能直接交给旧版应用使用。尝试回退前保留升级快照和当前数据,详见安装与更新。