使用文档

设置

The One 设置里每一节管什么:通用和外观、模型和登录、自动做事、手机和别的程序、数据和撤销,以及开发者的几页。

设置决定 The One 在你电脑上怎么运行:账号和版本更新、界面外观、和模型服务的连接以及 Agent 默认用哪个模型、关掉窗口后后台还做什么、手机和其他程序、Agent 改了什么和应用占了多少磁盘,以及开发者看的东西。从侧边栏最下面打开,默认停在通用。

活儿用什么来做,比如工作组、角色、技能和插件,不在这里,而在团队与工具里。

设置分六节。每一节打开时停在它的第一页;一节里有几页时,页面上面写着这几页,比如通用和外观。

节里面的页
通用通用、外观
模型和登录API 配置、默认模型
自动做事常驻与触发
手机和别的程序随身通道、对外调用
数据和撤销行动记录、存储空间、记忆召回
开发者开发者视图、评测

设置 › 通用:左边是设置的六节,页面上面写着通用和外观两页

通用

通用

  • 账号:当前登录的邮箱,是个人账号还是组织账号,以及退出登录。
  • 语言:界面语言,简体中文或 English。选择保存在本机,之后就用你选的,不再跟随系统语言。
  • 版本更新:当前版本和发布日期。应用启动后会自动检查更新,并在后台下载新版本。检查更新立即查一次;下载好后点安装并重启,会停掉后端服务并重启应用。
  • 使用统计:**统计功能使用次数(内测)**按天统计你打开了哪些页面、启动了哪些内置应用。默认关闭,只记次数、存在本机,不记内容、文件名或对话。
  • 维护工具:导出诊断包把运行日志和诊断信息导出成一个文件,方便发给支持排查。重启后端重启 The One 的本地服务,应用提示某项改动需要它时再用。

外观

选择跟随系统、浅色或深色(默认是浅色)。浅色用宣纸,深色用墨夜;也可以在配色方案里给浅色、深色各换一套,另有九套预设可选。

复制修改会复制一套方案给你改:7 个基础色,从底色、文字、主色,到表示“等你”“在跑”“已交付”“出错”的颜色,边改边按 WCAG AA 检查对比度;没达标也能保存。复制配色 JSON 和**导入…**可以把方案带到另一台电脑。

设置 › 通用 › 外观:明暗,以及浅色、深色各自的配色

模型和登录

API 配置

Agent 发模型请求所走的连接:随 The One 会员提供的官方连接、用 ChatGPT 账号登录、OpenAI、Anthropic、Google Gemini 的 API Key,以及自定义提供商(包括你自己电脑上的模型)。详见 API 配置。

默认模型

模型预设把模型、走哪个连接和推理设置存成一套,服务等级在高级参数里。没单独绑预设的 Agent、Graph 和会话,都用标着全局默认的那一套;改了预设,从它们的下一轮起生效。主助手输入框下方的模型按钮可以直接切换全局默认,里面的管理模型预设打开同一个编辑器。详见模型。

自动做事

这一节就是常驻与触发页。触发器在到点、有新东西出现(经插件工具来的新订单或新邮件、文件夹里的文件、网页、命令的输出),或者外面发来 Webhook 时叫醒 Agent,人不在电脑前也照常。一般只要说一句,比如“每天 8 点整理一下邮件”,Agent 就会自己建好触发器。在这里可以查看、修改和试一下(现在触发),也可以新建触发器或暂停所有。

常驻里有三个开关:关掉窗口后留在后台运行(在 Windows 上起作用;macOS 上关掉窗口后应用本来就继续运行,这个开关一直开着)、开机时在后台启动,以及有触发器在等时不让电脑睡(只在接着电源时有效)。Webhook 入口只在本机收请求,默认端口 8013。详见触发器和后台常驻。

手机和别的程序

随身通道

通过你在 Agent Room 的私人房间,在手机上把活交给主助手、回答 Agent 主动问的问题、看做完的结果。它需要 Agent Room Channel 插件。把房间里的邀请文字或 Agent 口令粘进来,点连接;再在绑定你的账号里生成配对码,发到房间里,之后 The One 只听你一个人的。详见随身通道和对外调用。

对外调用

让这台电脑上的 Claude Code、Codex、会说 A2A 的 agent 或你自己的脚本把你的团队当工具用:列出团队、派活、等它交付、回答它的提问。每个程序用一个自己的令牌:发令牌只显示一次,同时给出 Claude Code 和 Codex 的配置命令;安装 the-one 装上一个命令行工具。调用只在本机接收,默认端口 8014。拿到令牌的程序能让你的团队在这台电脑上做它们能做的任何事,所以只给信得过的程序,不用了就撤销。详见随身通道和对外调用。

数据和撤销

行动记录

Agent 每次调用工具都记在这里:新建、修改、删除了哪些文件,访问了哪些地址,结果如何。文件被删除或覆盖前会先留一份副本,所以在副本保留期内(7 天),你可以撤回一整次运行、一次调用,或者某个时间之后的全部改动。发生在本机以外的事会列出来,但撤回不了。行动记录覆盖这台电脑上的所有 Space,而且只记录和撤回,从不拦下任何操作。详见行动记录、撤回和急停。

存储空间

这一页列出应用数据各占多少磁盘:数据库、命令输出、工具结果、日志、行动记录与回收站、证据包、发出的请求,并写明各自保留多久。剩余空间不多时,标题栏会提醒,正在干活的 Agent 也会收到提示;再少就进入保护模式:不再保存完整命令输出和数据库快照,并立即清理过期文件。Agent 照常运行。

插件工作区是插件保存的下载内容、渲染结果和浏览器数据,清空会永久删除。这一页也统计 Agent 在应用外留下的 Docker 数据和 git worktree,但应用从不删除它们,只给出命令,由你复制到终端自己运行。

记忆召回

Agent 搜索记忆、项目知识和以前会话的结论时,结果按意思排序,而不只看字面。在嵌入模型里选由谁来做:

  • 自动(推荐):依次用第一个能用的:本机 Ollama 或 LM Studio 的嵌入模型、默认服务商的嵌入接口、内置模型。
  • 内置模型:在这台电脑上运行,不需要任何 API,第一次用时下载。
  • 服务商连接:用某个连接的嵌入接口;记忆和知识的文本会发给这个服务商。
  • 自定义地址:任何不需要密钥的 OpenAI 兼容嵌入地址。
  • 关闭:只按关键词排序。

重建索引会清空已算好的向量,最近 30 天搜索过的范围在后台重新索引。详见记忆与召回。

开发者

开发者视图

开发者视图页上只有一个开关:显示开发者看的东西,默认关着。打开以后,同样的数据按开发者看的样子画出来:主助手的对话里显示它的系统提示、写给模型的通知原文、每次工具调用的参数和结果;事项页、“需要你”和等你的卡片上显示编号;团队与工具里多出总图、定义空间、所有运行和评测。只换显示,不换数据。在任何地方按 Cmd+Shift+D(Windows 上是 Ctrl+Shift+D)都能打开或关上它;打开时标题栏上写着开发者视图,点一下就关上。

开关下面的打开所有运行带你去所有运行:当前 Space 里的每一次运行,包括各个工作组的运行,细到每个 Agent 的消息、上下文和工具。主助手自己的对话不在这里,在首页。详见所有运行(开发者视图)。

评测

各个 Graph 在验收题上的真实运行结果:交付了多少、用了多久、调用了多少次模型。

应用菜单和托盘

应用菜单(macOS 上是菜单栏里的 The One 菜单)里有打开日志(Cmd+L)、导出诊断包、检查更新、安装已下载更新、重启后端、急停所有 Agent(Cmd+Shift+.)、退出登录和退出。Windows 上菜单栏是隐藏的:急停用托盘菜单,诊断包、更新和重启后端在设置 › 通用里。

macOS 菜单栏或 Windows 系统托盘里 The One 图标的菜单中也有急停所有 Agent。它会中断所有 Agent、结束它们启动的命令,并暂停所有运行和触发器,直到你恢复。详见行动记录、撤回和急停。

键盘快捷键

在没有打字的地方按 ?,或者按 Cmd+/(Windows 上是 Ctrl+/),就能看到所有快捷键;窗口左上角的 The One 菜单(…)里也有键盘快捷键。下面这些在任何地方都能用:

按键作用
F6 / Shift+F6跳到窗口的下一个或上一个区域
Cmd+K 或 Cmd+F(Ctrl+K 或 Ctrl+F)跳到这一页的搜索框
Shift+Esc跳到输入框
Cmd+Shift+A(Ctrl+Shift+A)打开应用菜单
Cmd+Shift+D(Ctrl+Shift+D)打开或关上开发者视图
Esc关掉弹窗、菜单或抽屉

macOS 上应用菜单另有两个:Cmd+L 打开日志,Cmd+Shift+. 急停所有 Agent。

快捷键表里还有会话列表和预设列表、输入框、审阅栏,以及编辑器和画布的快捷键。