跳转到正文
Onevium文档
本页内容

设置参考:选项、默认值与生效方式

按 1.3.3 设置分区查找关键选项,了解当前值、安装默认、作用范围与实验能力。

如何使用这份参考#

点击左侧导航栏底部的账户按钮,选择设置。设置左侧分为四组,本页按同样顺序排列:

分组分区
应用设置通用、通知、外观、会话整理、快捷键、语音
AI 与连接个性化、工具、AI 服务、Claude Code、浏览器、秘钥与主机、网络代理
编码工作树
账户与数据账户与许可证、Claude 订阅用量、活动、系统权限、隐私、存储、归档会话

当前显示值优先。 升级通常保留已有选择。表内区分全新安装默认值与已有配置缺失字段时的回退值。具体操作例子见设置与数据。

通用:语言、新会话与输入#

分组 → 选项怎么选、何时改生效与范围
界面与窗口 → 语言选择界面语言改界面,不是回答语言总开关
界面与窗口 → 窗口置顶需要边看结果边操作其他应用时开启即时作用于窗口
新会话默认值 → 默认权限模式默认权限、Auto 模式、完全访问,详见权限新会话默认;已有会话保留自己的选择
编辑器 → 纯文本编辑器希望输入时链接和引用保持为可编辑文字时开启默认关;立即作用于所有输入框
编辑器 → 显示上下文窗口用量不需要输入框的上下文用量提示时关闭默认开
编辑器 → 发送快捷键Enter 或 ⌘/Ctrl+Enter默认 Enter;Shift+Enter 始终换行
编辑器 → 跟进处理方式回复进行中再发消息时,选「排队」或「引导」当前回复默认排队;另一种方式可用说明中的快捷键临时使用
外部应用 → 默认打开工具指定已检测到的编辑器或终端,或「记住上次使用」控制外部编辑器入口的主动作;入口本身在「外观 → 对话显示」开启
后台运行 → 后台保持运行定时任务、渠道消息或会话运行时阻止系统休眠增加耗电;任务结束后恢复节能;不覆盖 macOS 合盖休眠
更新 → 检查更新查看版本与可用更新按状态下载安装、重启更新或手动下载

通知已移到独立的「通知」分区,显示相关控件在「外观」分区。

安装默认值与已有选择

选项全新安装基线旧配置缺失时的回退
主题/语言浅色/中文保留或按既有环境初始化
默认权限完全访问默认权限,或兼容已有完全访问配置
各类通知应用内关、桌面开早期版本明确关闭过桌面通知时,各类别的桌面通知保持关闭
自动 AI 命名关没有明确命名策略时关闭;已有保存选择继续生效
AI 浏览器控制关旧版本已启用的设置继续保留
后台保持运行开关
记忆每日预算$10从未设置过预算时为 $1

通知:类别、提示音与系统通知#

选项怎么选默认与说明
提醒类型 → 需要你确认Claude 提问、请求批准工具或等你审阅计划桌面开,提示音「叮」
提醒类型 → 秘钥授权AI 要使用、修改或读取已存秘钥,或首次连接服务器桌面开,独立提示音「上扬」
提醒类型 → 任务完成会话完成一轮回复、等你继续桌面开,提示音「和弦」
任务完成 → 提醒时机仅在后台时,或总是默认仅在你没看该会话时提醒,包括应用在前台但查看其他会话
提醒类型 → 后台任务与子智能体后台任务、子智能体或队友完成、失败、停止,或 Claude 调取记忆桌面开,提示音「气泡」
提醒类型 → 出错与失败回复出错中断,或工作树无法创建、恢复桌面开,提示音「警示」
每类的应用内/桌面/提示音分别勾选,选「静音」关闭该类声音;旁边的喇叭按钮试听立即保存;系统不支持桌面通知时桌面选项不可用
桌面通知 → 系统权限发送测试通知、打开系统设置、查看设置说明macOS 第一次测试通知会触发系统授权

图 1:通知的五个类别与各自的提示音,左侧是 1.3.2 的设置分组。真实通知设置组件的隔离演示,显示全新安装默认值;未发送通知或修改系统设置。

收不到桌面通知时,检查系统通知设置、勿扰或专注模式,再看系统权限。Dock 菜单与菜单栏快捷中心的会话列表见菜单栏快捷中心。

外观:主题、侧栏与对话显示#

外观分为四个标签,选择都会自动保存并应用于所有会话。若保存失败,界面恢复最近保存成功的外观,并提供「重试」。

主题与字体

选项怎么选生效与范围
浅色/深色/跟随系统固定明暗模式,或随系统变化作用于整个工作区
界面配色中性、暖纸、Codex 风格、GitHub 风格、Notion 风格、Claude 风格、Catppuccin、Nord八套配色各有浅色和深色方案;切换时也选用对应链接颜色
链接与焦点颜色跟随配色、蓝色、青绿、梅紫、暖棕调整对话链接和键盘焦点轮廓
视觉对比度标准对比度或增强对比度让辅助文字和边界更清楚
界面/消息/代码字体分别选择分开调整界面、对话正文和对话代码块
聊天字号/代码字号12–16px/10–16px分别调整,可查看实时预览
消息字重常规或适中标题与加粗保持层级,代码字重不变

内置终端和代码编辑器跟随工作区配色;这里不配置外部编辑器。恢复配色与字体默认值只恢复这组选择,保留阅读密度和明暗模式。

侧边栏与会话列表

选项怎么调整怎样核对
排版预设与单项位置从预设开始,分别调整标记、渠道/定时任务图标、运行状态在标题左侧或右侧同时检查预览和一条已有会话
侧栏字号调整导航、项目名称和会话标题消息与代码字号保持独立
初始默认宽度输入至少 260 px已手动拖动的宽度仍按原选择记忆;双击侧栏边缘恢复默认
渠道会话标题分别开关发送者、群组/联系人名称两项都开时发送者在前
导航入口勾选显示项并拖动排序隐藏项仍可从“探索”访问;“新会话”保持第一位

对话显示

选项怎么选生效与范围
阅读密度紧凑、标准或舒展调整所有会话的消息间距与行高;「恢复默认间距」只重置密度
消息导航器长对话中快速返回历史消息默认开;在聊天右侧悬停验证
音频可视化让会话刻度随麦克风和系统声音变化需要麦克风及屏幕与系统音频权限;只在本机分析,不录制、不上传
文件变更卡片显示每轮的文件变更卡片与实时摘要隐藏后仍记录改动,恢复功能不受影响
工具栏入口 → 外部编辑器入口/提交入口在右上角显示打开项目、提交按钮默认隐藏;不影响 Review 内提交

已完成轮次的过程会收起为摘要,点击可展开查看工具步骤;收起只影响显示。

动效与性能

选项怎么选生效与范围
减少视觉效果闪烁或卡顿时先尝试即时减少装饰动画
禁用硬件加速上述调整无效时再尝试重启后生效;可能降低流畅度

会话整理:标题规则与标签#

分区内有标题规则和标签两个标签。创建标签、给会话加标记和按标签筛选,见会话整理教程。标题规则自动保存;新建或编辑标签需要点击保存标签。

AI 命名需要主动开启:在标题规则启用自动更新会话标题,选择命名模型并检查提示词。开启不会立即重命名旧会话,手动命名的标题保持保护。已有保存策略继续保留,没有明确策略时默认关闭;手动“用 AI 生成”是独立操作。

快捷键:编辑、冲突与全局命令#

  1. 搜索命令,点击该行编辑,再按需要的组合键。
  2. 合法且无冲突时直接保存;按 Escape 取消录入。
  3. 冲突时可选转移,它会解除原命令对该组合键的占用。
  4. 可清空单项、恢复单项默认,或确认后重置全部。

命令按全局、聊天、文件面板、浏览器等作用域工作。双 Escape 停止、Shift+Tab 切 Plan 等是固定参考项,不能修改。

在任何应用中都可用的系统级命令——打开快捷窗口、打开秘钥快捷窗口、打开验证码、打开密码生成器、显示/隐藏 Onevium——默认不绑定组合键,避免占用其他应用已在用的按键。1.3.1 中默认的 ⌥⌘K(秘钥快捷窗口)和 ⌥⌘T(验证码)从 1.3.2 起不再默认占用;需要时在这里自行绑定。截取当前窗口默认是双击 Command 手势,需要辅助功能权限;改成普通组合键后不需要。快捷中心的用法见菜单栏快捷中心。

语音:识别、润色与历史#

控件怎么配置怎样验证
语音识别模型下载适合语言的模型,再设为当前录一句短话验证
AI 润色需要纠正同音词、标点时开启默认开;文本可能发送给模型服务商
润色模型选择真实可用模型默认使用低价模型角色
启用语音输入关闭后隐藏麦克风并停用听写快捷键回到输入框检查;默认开
麦克风选择先授权,再选系统默认或已检测设备录音验证所选设备
历史与打开录音文件夹查看已有记录及本地音频核对最近记录,并打开对应音频
复制转写/下载录音/删除录音在历史记录的操作中执行粘贴或打开导出文件核对;删除前确认目标

本地语音识别与 AI 润色是两步。没有可见的“录音保留天数”设置。详见语音听写。

修正偏好与词汇

打开 语音 → 修正偏好 → 管理。例如写“产品名保留英文,不改数字”,再点 保存偏好。行业模板会填入可编辑的规则,保存前先检查;关闭弹窗不等于保存。

在 我的词汇 中添加正确写法及可选的常见误识别写法,然后保存词条。已学习词汇 来自发送前的明确修改,由后续一次 AI 修正提炼,发送当下不会额外请求模型;一次修改不保证立即学成词条。清空已学习词汇会同时移除待学习样例,保留手工词条和修正规则。

个性化与记忆空间#

分组 → 控件用途与何时调整默认、范围与生效
启用个性化总控用户规则、记忆和工具评估默认开
用户规则 → 启用用户规则写语言偏好、习惯等长期要求默认关闭;最多 4000 字符;自动保存;用户级
记忆 → 使用记忆从对话提取并使用长期信息默认开;不是保存全部聊天的开关
记忆 → 抽取频率高频每轮、平衡每 3 轮、经济每 5 轮,或关闭默认平衡;关闭仅停止新增,旧记忆仍可召回
记忆 → 深度抽取额外保存理由、备选方案与取舍默认关;会增加提取消耗
记忆 → 抽取语言控制新记忆语言默认跟随界面;不自动翻译旧记忆
记忆 → 排除的项目选择哪些项目不产生新记忆默认全部纳入;排除不删除已有记忆
召回与整理 → 召回阈值严格、平衡、宽松新安装严格;旧配置回退平衡
召回与整理 → 跨项目搜索检索其他项目的相关记忆默认关;不等于全量跨项目注入
召回与整理 → 记忆上下文长度简洁、适中、详细默认适中;控制注入的记忆量,不是模型窗口
召回与整理 → 自动整理频率每天、每周、关闭默认每天
后台 AI 模型与预算 → 工具评估、后台 AI 模型记忆提取和工具评估共用的模型需真实可调用
后台 AI 模型与预算 → 预算占用/预算上限查看当日用量,限制每日自动提取消耗按真实费用计入;新安装 $10,从未设置过的早期安装 $1;不是总聊天预算
记忆空间查看、搜索、更正、停用、遗忘记忆,查看来源、关联和使用情况从个性化页面进入,左侧仍高亮「个性化」

记忆的完整用法见记忆与回顾。@Memory 会发起 Claude Code 规则/记忆文件编写请求,不等于向记忆空间保存数据库记忆。每日简报已退役,替代方式见单独安装的每日复盘 Skill。

工具:内置工具组#

工具组用途默认或行为
定时任务管理定时任务主动启用:设置 → 工具,或对应能力卡
图表与交互内容创建可视化产物默认开
浏览器预览浏览器工具默认开;还需要在「浏览器」开启 AI 浏览器控制
会话与标题整理跨会话工作、子会话、队伍与标题整理主动启用:设置 → 工具,或对应能力卡
工作回顾生成工作回顾主动启用:设置 → 工具,或对应能力卡
图片创作生成和编辑图片默认开;还需配置图片服务
服务(托管进程)管理托管服务默认开
频道(管理机器人)让助手管理渠道配置默认关;不是现有机器人连接开关
秘钥与主机按引用使用秘钥、SSH默认关;在「秘钥与主机」开启
Turn 续跑/频道消息运行所需的自动工具说明行,不能手动关闭

主动启用的工具组缺少设置时为关闭,已经启用的选择继续保留。关闭工具组会阻止后续调用,新开启的工具在下一条消息可用;开关不会撤销已经发生的操作,也不删除已有会话、定时任务或回顾数据。

AI 服务:模型连接#

在此添加或调整服务商、模型和连接配置。先确认地址、认证和模型对应,再发一条短消息验证;保存成功不等于模型可用。字段见提供商教程和自定义提供商。

打开对应服务商的模型配置,展开默认推理力度,为支持多档强度的模型选择起始档位。每次选择按服务商和模型立即保存,用于新会话;已有会话保留自己的强度。

Anthropic API 兼容转发端点在服务商编辑 → 高级选项 → Endpoint supports 1M context 声明 1M 支持,同时启用 Claude Code 中的全局 1M 上下文窗口。OpenAI Responses、Chat Completions 和 Gemini 使用管理模型 → 高级 → 确认此模型支持 1M。完整步骤见 1M 上下文窗口。

Claude Code:共享 CLI 配置与高级选项#

分组 → 控件用途与选择保存、范围或限制
推理与上下文 → 扩展思考在支持的模型上调整扩展思考开关即时保存;模型实际支持程度不同
推理与上下文 → 1M 上下文窗口结合连接与逐模型能力启用长上下文实验能力;不保证账号和所有模型可用
推理与上下文 → 自动压缩时机默认,或 50%–95%(每 5%);70% 标为推荐说明行显示 200K 和 1M 上下文对应的压缩 token 数;只能比默认更早压缩;写入 ~/.claude/settings.json 的环境变量,终端里的 claude 同样生效
实验性协作 → Agent 团队启用实验性 CLI 团队功能不等于 Onevium 的 @Team 队伍协作
实验性协作 → 协作模式auto、in-process;按平台另有 tmux/iterm2Agent 团队开启后显示;只影响终端中的 Claude
权限 → 权限规则编辑 CLI 权限 JSON合法 JSON 后点保存;与会话权限按钮不是同一层
高级设置 → 环境变量修改传给 Claude 的环境变量编辑 JSON 后保存并确认;保留无关字段
高级设置 → 编辑原始 JSON编辑整份配置格式化、核对后保存;设置文件无法解析时会拒绝保存,避免覆盖原有内容

越早压缩,每轮发送的 token 越少,但更早丢失细节;先用推荐值,再按长任务的实际表现调整。CLI 布尔开关未勾选不代表所有模型的底层默认行为。配置内容可能含凭据,截图和分享前应移除。

浏览器:控制、身份与站点数据#

控件用途操作与限制
AI 浏览器控制启用 AI 浏览器工具全新安装默认关;旧版本已启用的设置保留;关闭不清空站点数据
控制哪个浏览器内置、外部或自动内置使用 Onevium 自带浏览器;外部通过 Claude in Chrome 扩展控制你的 Chrome;自动目前与内置相同
外部 Chrome 连接外部 Chrome 的扩展与连接状态选择外部时才显示
内置浏览器设置 → 默认视口新标签页采用的预设尺寸已有标签可在工具栏菜单单独覆盖
身份 → 新建身份/从浏览器导入…建立独立 Cookie、登录状态和网络的身份新身份初始为空;导入不保证目标网站保持登录
身份 → 此身份的网络跟随浏览器默认、跟随系统代理、直连或某条线路线路在「网络代理」管理;已打开页面可能在下次加载时生效
身份 → 设为应用默认会话还没选过身份时使用新标签按会话记住所用身份
身份 → 删除身份…删除身份及其登录数据、Cookie 和已存密码无法撤销;有标签正在执行操作时需稍后再删
密码从其他浏览器导入的登录信息用本机凭据存储加密;AI 在命令中使用的凭据放在「秘钥与主机」
浏览数据 → 清除浏览数据删除所有浏览器标签共用的 Cookie、缓存和网站数据会影响共用登录态

临时身份在浏览器里新建,关闭最后一个标签后清除,不会出现在设置列表。完整操作见浏览器教程。

秘钥与主机#

集中管理服务器、数据库、API 和云账号凭据,供 AI 按引用使用;AI 使用默认关闭。顶部的快捷中心一栏可以打开快捷窗口。条目类型、SSH、导入与授权见秘钥库与 SSH。

网络代理:线路、应用代理与浏览器默认网络#

应用内提示也把这一页称为「设置 → 网络」。页面分三部分:

部分 → 控件怎么填写或选择生效与检查
应用代理 → 模式关闭、仅应用内、全局用于模型请求、图片生成和终端里新开的命令;已在运行的程序、SSH 和外部 MCP 不改走代理。关闭时 Onevium 直连(电脑上的 VPN 仍生效)
应用代理 → 线路选择一条已保存线路,点测试显示「已保存 · 已应用到应用内请求」及出口验证状态;有多条线路时要先选好线路才会开启
应用代理 → 系统代理状态全局模式下查看已应用/未应用全局会写入电脑的系统代理,切回其他模式时恢复原设置
应用代理 → 额外直连地址(可选)逗号分隔的域名或主机本地和内网地址已自动直连,无需重复填写
应用代理 → 浏览器验证出口 IP全局模式下在默认浏览器打开检测页单独核对系统浏览器的实际出口
浏览器默认网络 → 浏览器默认跟随系统代理、直连、与应用代理相同,或某条线路只作用于选择“跟随浏览器默认”的身份;「跟随系统代理」只读取系统设置,不会修改它
线路 → 添加线路…名称、协议(HTTP/HTTPS/SOCKS5)、地址、端口、可选用户名和密码可粘贴 socks5://用户名:密码@主机:1080 自动拆分;保存线路不会自动启用
线路 → 编辑…/测试/删除在每条线路的「⋯」菜单中操作修改地址后,引用它的地方立即改走新地址;应用代理正在用的线路要先换掉才能删除

图 2:① 应用代理所选线路的状态与出口验证,② 已保存线路的协议、地址、测试结果和使用次数。1.3.2 真实网络代理组件的隔离演示,地址为 example 域名,出口 IP 与测试结果为模拟数据,未修改系统代理,也未实际执行测试。

测试范围: 测试会经所选线路访问 IP 检测服务,记录检测服务看到的出口 IP、所在地、延迟和时间。优先用内置浏览器的网络测试;不可用时改用应用网络测试,结果会标注「应用网络测试」。它不测试 Anthropic 或自定义模型接口,也不验证模型账号;其他网站看到的出口可能不同。

删除被身份或浏览器默认网络引用的线路时,需要选择:先保持断开、改为跟随默认,或替换为另一条线路。Windows 系统代理无法保存用户名密码,GNOME 的 SOCKS 系统代理不支持认证;Onevium 自己的请求仍会带上认证,其他应用可能另行索要或不带认证。

从 1.3.1 或更早版本升级时,完整的旧代理会自动转成一条以「主机:端口」命名的线路;开启但缺少地址或端口的旧代理视为关闭。

工作树#

管理 Onevium 为会话创建的独立 Git 工作副本,以及项目的本地环境(告诉 Onevium 如何准备工作树)。完整流程见工作树;旧工作树占用的空间也可以从「存储 → 管理工作树」进入清理。

账户与许可证:账号、许可和设备#

查看邮箱、许可状态、类型、开始/到期时间及剩余天数。替换许可入口受账号资格控制;可替换时输入新激活码并提交,再核对更新后的状态与日期。

设备列表展示设备名、平台、版本和最近活动;此页没有删除设备按钮。退出登录也不是清理本地会话。

Claude 订阅用量:订阅额度#

这里显示 Claude 官方订阅账号、额度窗口与行为分析,并提供刷新或重试。使用 Pro/Max 订阅登录后才能取得相应额度;API Key 或第三方服务商不一定提供这类数据。

“暂不可用”不是额度为零。「活动」的本机 token/费用统计与此处订阅额度分开查看。

活动:本机用量与费用观察#

控件可看什么使用技巧
Token 活动按年显示每日 token 或消息热力图,连续天数、每日峰值与最长一轮点某一天,下方切换到该日
概览/模型/会话/图像生成汇总与趋势、按模型与连接、按会话排行、图像生成尝试点模型或会话查看明细
时间范围今天、昨天、7/30/90 天,可前后翻页;默认 7 天排查一次用量高峰时缩小范围
连接与模型筛选全部连接/全部模型,或指定一项找到消耗来自哪一路连接
每日用量Token、仅输出或用量记录比较前统一口径
费用参考与缓存命中率服务商报告与按当前价格的估算未知价格不计入;不是付款账单

估算费用、缓存节省和官方账单不是同一概念。

系统权限:状态与恢复#

逐项显示麦克风、摄像头、屏幕与系统音频、辅助功能、自动化、文件与文件夹、通知的用途和系统状态:系统已允许、系统未允许、受系统策略限制、尚未申请、请在系统设置中确认。可用按钮包括申请权限、打开系统设置和前往相关功能;点重新检测刷新状态。打开此页不会请求授权。

macOS 上「已经开启,仍然无法使用?」一栏说明恢复方法:完全退出后从「应用程序」重新打开,仍被拒绝时在系统设置中关闭再开启该权限,或移除旧条目后添加当前应用。Windows 的麦克风还取决于“允许桌面应用访问麦克风”;Linux 取决于桌面环境的隐私、音频和通知设置。操作步骤见设置与数据。

隐私:诊断与数据清理#

SDK 事件日志默认关闭。排查具体问题时开启,复现后关闭;分享日志前检查其中的会话元数据。

清除本地数据删除数据库及其伴随文件、media、uploads、images,不删除 db-backups 和 upgrade-backups 中的备份。不要把它当作清除 CLI 设置、项目文件、浏览器身份或语音记录的操作。数据根目录及清理区别见设置与数据。

本机存储不等于离线处理;模型与外部连接的数据去向仍由实际使用的服务决定。

存储:占用、清理与数据库备份#

控件用途说明
此设备显示 Onevium 总占用及数据库与会话、附件、图片与媒体、工作树、预览、数据库备份、日志、其他数据大小为估算;点刷新重新扫描;「存储位置」显示实际目录
清理旧会话 → 审阅审阅会话及其子会话后移入回收站回收站在「归档会话」中恢复或永久删除
管理工作树跳到「工作树」设置旧工作树保留数量
清理可重建的预览 → 审阅清理删除缓存的图片预览保留原始图片、附件和日志
数据库备份 → 立即备份创建一份一致的快照使用中也可以备份;手动备份不受保留份数限制
数据库备份 → 定时备份数据库每天或每周、备份时间、自动备份保留份数(1–100)默认关,开启后默认每天 03:00、保留 7 份;点「保存计划」生效;错过的备份在下次启动时补做
备份记录/备份位置下载某份备份,查看保存目录默认在数据目录的 db-backups

存储页不会删除正在使用的数据库,也不会自动压缩数据库;删除记录后数据库内可能保留可复用空间。

归档会话:找回与永久删除#

先用搜索、项目和时间筛选找到会话,打开预览,再选择恢复或删除。恢复后到对应项目核对内容。支持批量操作;“删除全部”针对当前筛选结果。

永久删除会移除所选会话及消息,不能撤销。首次学习用演示会话,不用真实历史做删除测试。

找不到设置项时#

  • 核对顶部适用版本,以及对应功能是否已开启。「账户与许可证」只在需要登录的版本中显示。
  • 平台专属选项只在受支持系统显示,请在实际执行任务的设备上检查。
  • CLI Agent 团队与 1M 上下文虽有界面入口,仍属于受模型、账号或平台限制的实验能力。
  • 从 1.3.1 升级后:不完整的旧代理视为关闭,⌥⌘K/⌥⌘T 不再默认绑定,记忆调用按真实费用计入预算;1.3.1 无法读取升级后的数据。
  • 修改后,用一次实际聊天、通知、浏览器操作或录音确认生效。

下一步#

回到设置与数据完成常用调整;查权限决定任务执行方式,或用工作技巧安排日常流程。