A local-first multi-agent app development platform, built on PenguinHarness
title: 设置 description: 管理个人资料、偏好设置和密码;管理员还可以管理用户、代理、上传限制、公司模式、Agent API 和插件。
设置把不属于 Project 也不属于 Agent 的设置集中在一个对话框里:你的个人资料、界面偏好和密码;管理员还能在这里管理服务器的用户、代理、上传限制、公司模式、Agent API 和插件(包括沙盒)。
打开设置
- 在侧边栏底部点击你的用户行;侧边栏收起时,点击你的头像。账户菜单随即打开。
- 选择设置。
对话框的结构
对话框左侧是一列页面导航,每个页面由若干行设置项组成,标题在左,控件在右。窄屏上,这列导航会变成页面上方的一条横向滚动栏。
导航分为个人和服务器两组:
| 页面 | 分组 | 谁能看到 |
|---|---|---|
| 个人资料 | 个人 | 所有人 |
| 通用 | 个人 | 所有人 |
| 外观 | 个人 | 所有人 |
| 快捷键 | 个人 | 所有人 |
| 账户 | 个人 | 仅在有密码可改时出现 |
| 用户管理 | 服务器 | 仅管理员,桌面应用中没有 |
| 代理选项 | 服务器 | 仅管理员 |
| 上传限制 | 服务器 | 仅管理员 |
| 公司模式 | 服务器 | 仅管理员 |
| Agent API | 服务器 | 仅管理员 |
| 插件 | 服务器 | 仅管理员 |
个人偏好改动即生效,没有保存按钮,关掉对话框也不会丢失什么。唯一的例外是个人资料页的昵称:输入的文字需要显式提交,它的保存按钮就在输入框旁边,不在页面底部。
个人偏好的存储位置:
- 保存在当前浏览器:语言、币种、任务完成通知、主题、终端主题、字号、主题色、快捷方式悬浮球和工具短名。
- 随账户保存在服务器:个人资料、快捷键,以及你个人的公司模式开关。
服务器组的页面仅管理员可见,作用于整台服务器。非管理员既看不到这些条目,也无从得知它们存在:他们只能看到个人组的几页,导航也不再显示分组标题。
桌面应用里没有用户管理页,因为这时服务器是单用户的。桌面应用自己的窗口也没有账户页:它通过 shell 的 token 登录,没有密码可改;用密码登录同一台服务器的浏览器仍有这一页。
设置项标题旁的「?」可以查看这一项的说明,页面标题旁的「?」则说明整个页面。
检查更新不在这个对话框里,见更新 Adelie。
个人资料
个人资料页包含你的头像和昵称。它属于个人设置,在任何登录方式下都有,包括桌面应用自己的窗口,因为这两项都不需要密码就能修改。
这一页没有底栏:每个控件在使用时立即写入,负责写入的按钮就在对应的值旁边。
两项一开始都未设置。设置之前,侧边栏底部的用户行、收起后侧栏上的头像,以及从这两处打开的账户菜单顶部,都显示你的用户名和首字母头像。
设置之后,这三处都换成你的头像和昵称;账户菜单顶部仍会在昵称下方显示用户名。昵称还会显示在用户管理列表中用户名的下方。
更换头像
开始之前
- 一张 PNG、JPEG 或 WebP 格式的图片。
- 在个人资料页选择更换头像。
- 选择一张 PNG、JPEG 或 WebP 图片。
头像立即生效。图片会按中心裁成正方形,重新编码为 128×128。
要换回首字母头像,选择更换头像旁边的恢复默认。
修改昵称
- 在个人资料页的昵称里输入 1–32 个字符的昵称。
- 选择保存。
长度按字符计算,因此中文昵称也可以写满 32 个字。保存空白昵称即清除昵称。
保存旁边的恢复默认把昵称恢复为默认值,即你的用户名。两个按钮都是点击即写入;要写入的值与已保存的值相同时,按钮不可用。
通用
通用页是个人设置。
| 设置 | 选项 | 作用 |
|---|---|---|
| 语言 | English / 中文 / 跟随系统 | 「跟随系统」表示跟随浏览器。 |
| 币种 | 美元 $ / 人民币 ¥ | 价格显示所用的币种。数据始终以美元存储,换算只发生在显示层。 |
| 任务完成通知 | 开 / 关(默认关闭) | 窗口隐藏或失去焦点时 Task 结束,会弹出系统通知,点击即回到该 Session。 |
| 公司模式 | 开 / 关(默认开启) | 只在管理员为服务器开启公司模式后出现。关闭只隐藏你自己的开发 / 公司切换,别的都不影响,组织照常运转。见公司模式。 |
| 导入 Trace | — | 把 Trace 文件导入为一段对话。只有你拥有至少一个 Project 时才会出现这一行。见导入 Trace。 |
[!NOTE] 打开任务完成通知时会当场向系统申请通知权限。系统只问一次:被拒绝后开关保持关闭并显示提示,只能到系统的通知设置里改回来。浏览器不支持系统通知时,开关不可用。
导入 Trace
导入 Trace 把 .jsonl 格式的 Trace 文件导入为某个 Agent 的一段对话。
开始之前
- 一个从其他部署导出的
.jsonlTrace 文件,不超过 14MB。 - 你是目标 Project 的 owner。
目标 Project 和目标 Agent 都要自己选:Agent 要选,是因为 Trace 文件本身无法指明本机的哪个 Agent;Project 要选,是因为这个对话框里看不出当前打开的是哪个 Project,这也意味着 Trace 可以导入到当前打开的 Project 之外。下拉框只列出你自己拥有的 Project,因为导入是 owner 的操作;一个都没有时,这一行不出现。
- 在通用页的导入 Trace 一行选择目标 Project:你拥有当前打开的 Project 时默认选它,否则默认选你拥有的第一个 Project。
- 选择目标 Agent,默认是该 Project 的
default_agent。 - 点击选择文件,选中
.jsonl文件,导入随即开始。
Trace 会成为该 Agent 的一段新对话。如果该 Agent 下已有相同 id 的 Session,导入会被拒绝。
导出是反方向的操作,入口和要下载的文件在一起,位于对话的轨迹观测面板中。
外观
外观页是个人设置。
| 设置 | 选项 | 作用 |
|---|---|---|
| 主题 | 通用 / 白领 / 极客,外加这台机器导入的主题 | 界面的整体风格:布局、线条、字体与动效随之改变。每张卡片画着它自己的底色、面板色、文字色与强调色,所以不用逐个试。 |
| 明暗 | 浅色 / 深色 / 跟随系统 | 主题的明暗版本。 |
| 终端主题 | 跟随主题 / 浅色 / 深色 | 终端面板有自己的明暗配色,默认跟随应用主题。固定为浅色或深色即与应用主题脱钩,适合只针对一种底色调校过的命令行提示符和 TUI。 |
| 字号 | 小 / 中 / 大 | 界面字号。 |
| 强调色 | 灰白、蓝、绿、紫、红、橙,以及当前主题自带的那几个 | 界面的强调色。 |
| 快捷方式悬浮球 | 开 / 关 | 浮在对话区右缘的圆形按钮,展开后是通往工作台各面板和终端的快捷方式。关掉它与点击展开项里的隐藏悬浮球效果相同。 |
| 工具短名 | 开 / 关 | 对话里的工具卡片用短名称呼内置工具(read_file 显示为「读取」)。其余工具(含 MCP 工具)和轨迹观测始终显示工具原名,悬停短名也能看到原名。 |
| 托盘图标 | 开 / 关(默认开启) | 仅桌面应用。见下文。 |
关于导入的主题:主题只是一组取值,所以一台机器可以拥有自己的主题。把主题的 .json 文件放进数据根下
的 themes/ 目录,再点主题列表下方的重新读取,它就会作为一张卡片出现在导入主题那一组里,画着它
自己的颜色。这个目录在哪、文件长什么样,点旁边那个「?」都有;管理员还可以点导入主题… 直接把文件
传上去,不用走到目录里。主题文件只写得出一部分取值也没关系:没写的那些沿用「通用」主题,列表下方会
写哪几个令牌不认识、哪几个沿用了默认值,点一下能看见具体名字。
关于主题库:管理员在主题列表下面还会看到一栏卡片,那是远端的一份主题目录——服务端把目录读进来,
每张卡片画着它在浅色和深色下的底色、面板色、文字色与强调色。点导入,服务端就取回那份主题文件、按同
一套读法校验、写进本机的 themes/ 目录,于是它立刻出现在上面的「导入主题」组里;已经装过的那张会标
「已安装」,再点一次先问要不要覆盖。默认目录来自 npm 上的 @lmliheng/adelie-themes(国内镜像,取不到时
退到 jsDelivr 的 GitHub 副本),自建镜像设环境变量 ADELIE_THEME_REGISTRY 指向自己的目录即可。目录里
没有想要的、或者这台机器连不上外网,都不影响上面的主题与导入:主题库只是多一条来路。
关于托盘图标:桌面应用运行期间,会在系统托盘(Windows 的通知区域、macOS 的菜单栏、Linux 的托盘)里常驻一个图标。点击图标回到窗口,右键可以开新会话或退出。
关掉后图标立即消失,无需重启。此后关闭窗口不再收进托盘:macOS 上应用留在 Dock 中,Windows 和 Linux 上则直接退出。
快捷键
快捷键页是个人设置。它按分组列出所有可以改绑的命令,每行按平台写法显示当前的组合:Mac 上为 ⌥⌘S,其余平台为 Ctrl+Alt+S。各命令的缺省组合见「对话」中的快捷键。
- 点击某一行的组合,按钮开始等待新的组合。
- 按下新的组合。Esc 取消,Backspace 或 Delete 清除绑定。组合必须带 Ctrl 或 Alt(Mac 上为 ⌘ 或 ⌃),F 键除外:单独的 Shift,以及 Mac 上单独的 Option,只是输入。
改过的行会出现恢复默认按钮,全部恢复默认一次恢复所有行。改动立即生效,当前浏览器的其他标签页同步跟随;你的其他浏览器和桌面应用在下次加载时取得。绑定按平台分别保存,Mac 和 Windows 各有一套。
绑定一设好,这一行下方就会说明挡在它前面的东西:
- 另一条命令使用同一组合:说明两条中哪一条生效。
- 浏览器自己保留的组合,例如 Ctrl+W 或 ⌘W:只在桌面应用里生效。这条提示为琥珀色。
- 在桌面应用中,菜单同样带有的组合:绑定会覆盖那个菜单项。
- 浏览器本身也用的组合,例如打印的 Ctrl+P 或 ⌘P:在浏览器标签页里,绑定会取代浏览器的那个功能。
绑定由你的浏览器和桌面应用共用,所以浏览器相关的提示在桌面应用里也会出现。缺省组合都不落在浏览器保留的组合上。保存仍是 Ctrl+S / ⌘S,编辑器有焦点时取代浏览器的「另存网页」,所以这一行带有提示;在 Mac 上,缺省组合也被 Chrome 使用的两行(⌥⌘P 与 ⌥⌘N)同样带有提示。
账户
账户页提供修改密码操作。
只有存在可修改的密码时才有这一页。桌面应用自己的窗口用 shell 的一次性 token 登录,从来没有密码,所以没有账户页;用密码登录同一台服务器的浏览器仍有这一页。
[!NOTE] 通过首次登录链接登录时,设置密码不需要输入当前密码,因为这个账户此前的密码从来没有人见过。
修改密码
- 在账户页选择修改密码。
- 在当前密码里输入当前密码。通过首次登录链接登录后,这个字段不会显示。
- 在新密码里输入新密码(至少 8 个字符)。
- 在确认新密码里再输入一遍。
- 选择保存。
用户管理
用户管理页列出服务器上的所有用户。仅管理员可见;桌面应用里的服务器是单用户的,没有这一页。
在这里可以新增用户、重置密码和删除用户。
新增用户
- 在用户管理页选择新增用户。
- 输入用户名(2–32 个字符:以小写字母开头,后面只能用小写字母、数字和下划线)和初始密码(至少 8 个字符)。
- 选择创建。
新用户会得到一个名为 <userId>-default_project 的默认 Project。仍在使用初始密码的用户会带有「初始密码」徽标。
重置用户密码
- 在用户管理页找到用户,选择重置密码。
- 输入新的初始密码,选择保存。
重置密码会让该用户的所有登录会话失效,之后须用新密码重新登录。
删除用户
[!WARNING] 删除用户会一并删除其名下的全部 Project,包括数据目录,且不可恢复。
- 在用户管理页找到用户,选择删除。
- 在对话框中选择删除,再选择确认。
管理员角色的用户没有删除按钮,服务器也会拒绝删除内置的 admin。
代理选项
代理选项页仅管理员可见,作用于整台服务器,决定哪些出站流量走代理。
| 设置 | 默认值 | 覆盖范围 |
|---|---|---|
| 应用程序使用代理 | 开 | 服务器自身的出站流量:LLM 请求、更新检查、图片抓取。 |
| Agent 环境使用代理 | 开 | Agent 命令子进程的环境。 |
| 代理地址 | 空 | 可选,两个开关共用。留空表示跟随代理环境变量。 |
代理地址接受 undici dispatcher 支持的任何代理 URL:http://、https://、socks5:// 或 socks://,可以带凭据。裸的 host[:port] 也可以,存储时会规范化为 http://…。其他输入一律拒绝,原因显示在输入框下方。
点击保存之前不会写入任何内容。保存时整个表单通过一次 PUT 提交,所以地址被拒时其余各项也不会写入。保存后出站 dispatcher 随即重建,对新建立的连接生效,无需重启。回环地址始终直连。
设置并测试代理
开始之前
- 你的代理地址,使用上文支持的任意一种格式。
- 在代理选项页的代理地址中填入代理地址;留空则跟随代理环境变量。
- 打开应用程序使用代理,让服务器自身的出站流量走代理。默认已开启。
- 打开 Agent 环境使用代理,让 Agent 命令子进程的环境也使用代理。默认已开启。
- 选择保存。地址无效时不会写入任何内容,原因显示在输入框下方。
- 在保存下方选择测速,运行连通性测速。
连通性测速测量的是本服务器出站到各模型供应商这一跳。运行前页面会先列出目标:OpenAI、Anthropic、Gemini、DeepSeek、Z.ai 和 BigModel 的模型列表地址。点击测速后,向每个目标各发一次不带凭据的 GET 请求,结果先到先显示,每个目标最多等待 5 秒。
- 只要收到 HTTP 响应就算已连通,401、403 也算,因为凭据被拒恰好说明域名解析、TCP 连接和 TLS 握手都已走通。已连通的目标会显示耗时。
- 失败会给出具体原因:连接超时、域名解析失败、连接被拒绝、TLS 握手失败或无法连接。
[!NOTE] 测速用的是已保存的设置,因为只有保存才会重建出站 dispatcher。如果你改过地址,请先保存再测速。
上传限制
上传限制页仅管理员可见,作用于整台服务器,用来设置两个以整数 MB 计的大小:
| 字段 | 默认值 | 允许范围 |
|---|---|---|
| 单个附件上限(MB) | 100MB | 1–200MB |
| 单条消息附件合计上限(MB) | 120MB | 1–200MB |
合计上限不能低于单个附件上限,否则一个本身合法的附件会发不出去。超出范围的值会被拒绝,原因显示在输入框下方,例如想设「100GB」而在 MB 字段里填了 102400。校验先于写入:一次 PUT 里只要有一个字段不合法,其他字段也都不会写入。
修改上传限制
- 在上传限制页的「单个附件上限(MB)」里输入 1 到 200 之间的整数。
- 在「单条消息附件合计上限(MB)」里输入 1 到 200 之间的整数,且不能低于单个附件上限。
- 选择保存。
保存立即生效,无需重启:附件校验和请求体上限都在每次请求时读取这项设置。
公司模式
公司模式页仅管理员可见,作用于整台服务器。页面上只有启用公司模式这一个总开关,默认关闭,需由管理员在这里打开。
开关一拨即生效,没有保存按钮。
关闭后,组织调度器和全部组织路由随之停用,所有人的模式切换也会隐藏。磁盘上的组织不受影响;重新打开后,错过的触发不会补发。
[!NOTE] 公司模式是内测功能。见公司模式。
Agent API
Agent API 页(设置 › 服务器 › Agent API)仅管理员可见,作用于整台服务器。页面上只有允许 Agent API 这一个开关,默认开启,统管所有 Agent 的 API,也就是 Adelie 之外的程序与 Agent 对话所用的 HTTP API(见 Agent API)。
开关一拨即生效,没有保存按钮。
关闭前会先确认,因为此后所有调用 Agent 的程序都会失败。关闭后,所有 Agent API 请求都以 403 agent_api_disabled 拒绝。各 Agent 自己的开关、审批模式和密钥都会保留,重新开启后照常可用。在此期间,各 Agent 的 API 标签页对所有成员显示为开关不可用,并附说明。
插件
插件页仅管理员可见,作用于整台服务器。页面列出每个已装载插件声明的选项,表单按插件自己的 schema 生成;没有声明选项的插件不会出现。保存后立即送达插件,无需重启。
沙盒
沙盒是页面上的第一张卡片,设置新建 Session 所处的封禁策略。同一份策略约束 Agent 执行的命令、Session 运行的钩子脚本、它以 stdio 方式启动的 MCP Server,以及文件工具(read_file、edit_file、write_file):
- 启用:卡片顶部的开关。关闭时(全新安装即如此),新 Session 拥有完全的文件与网络访问,只受审批模式约束,输入框的权限菜单只列出审批模式。关闭期间卡片只显示这个开关:预设表、高级选项、后端自身的设置与卡片的提示都在打开后原样恢复。
- 预设:权限菜单提供的选项表,每个预设一行:名称、文件模式(关闭、仅工作区、只读)、网络(完全、仅本机、无)、审批方式,以及操作一组图标:图钉表示是否进菜单,拖动手柄,以及「…」菜单,内有设为默认和(仅新增预设上的)删除。默认行在名称后标有「(默认)」;每个名称旁的「?」说明这一行的用途——新增的预设,或改过取值的内置预设,则逐项说明各取值的作用。每个标题旁的「?」说明该列(或每个图标)的含义。拖动手柄(或在手柄上按上下方向键)调整顺序,菜单按此顺序列出。添加预设新增一行;只有新增的行可以删除,且不能是默认行。仅工作区时,可写的是 Session 的 Workspace、它的 scratchpad(计划文件、goal 的状态文件与附件都在这里)和临时目录;只读时只有临时目录可写。网络档位同样约束
read_file读取的图片 URL,仅本机需要能实施它的后端。默认行是开关打开时新 Session 的起点——取该行的文件模式、网络与审批方式;未改动时为 Workspace Write。预设表出现之前保存的设置,在你设定默认行之前沿用自身的文件模式与网络:卡片把起点与之完全相同的那一行标为默认,保存时写入它。没有这样的行时(网络为无网络或仅本机,或文件模式为关闭而设了屏蔽路径),不标任何一行,卡片顶部的提示写明实际生效的值,保存其他设置也保留它;把一行设为默认,或先添加一条同值的预设再设为默认即可。 - 收在默认折叠的高级选项里:
- 临时目录:是否保持可写。默认开启,两种封禁模式下都生效,因为 Shell 与大多数工具没有它就无法启动。关闭它需要能关闭临时目录的后端:只有 DSH 在用时开关保持开启并说明原因(在 Landlock 下,临时目录就是宿主共享的
/tmp)。 - 屏蔽路径:对 Agent 的命令、钩子脚本、
stdioMCP Server 和文件工具隐藏的路径,读取也不例外;每行一个绝对路径,最多 64 条。
- 临时目录:是否保持可写。默认开启,两种封禁模式下都生效,因为 Shell 与大多数工具没有它就无法启动。关闭它需要能关闭临时目录的后端:只有 DSH 在用时开关保持开启并说明原因(在 Landlock 下,临时目录就是宿主共享的
两种封禁模式都不允许 Agent 写自己的 Agent State:AGENTS.md、system_config.yaml、Skill、钩子包、记忆、vault 与定时任务。要让 Agent 写记忆、自行编写 Skill 或钩子包、修改自己的配置,用该对话的权限按钮把它切到完全访问。以 stdio 方式启动的 MCP Server 在启动时(上下文开启或重连)受同样的封禁:必须写这些目录之外、或访问网络档位所切断的网络的 Server,在封禁的 Session 里会连接失败;经 http / sse 访问的 MCP Server 不是本机进程,不在封禁之列。
真正实施封禁的是以插件形式安装的沙盒后端(bwrap、Seatbelt、WSL、DSH),它们约束全部四类:文件工具经一个由同一后端包裹的助手进程工作(见文件工具)。卡片第一行写明本机实施什么、由什么实施——默认的 Ubuntu 上是 本机实施:文件写入,由 Landlock (dsh-local) 实施——以及不实施什么,其下的更多信息列出每个已安装但未启用的后端及原因(Ubuntu 上的沙盒);一个后端都没有时会明确说明。本机没有后端能实施的网络级别或屏蔽路径会显示为灰色或被拒绝,而不会只实施一部分。没有后端时,除关闭外的任何模式都会拒绝 Agent 的每条命令与每次文件操作,每个钩子都会失败,stdio MCP Server 也一个都连不上。有两个后端需要说明:DSH 不让 scratchpad 可写,也无法关闭临时目录——更多信息列出它所用的那一级留下的缺口,以及较旧的 Landlock 上 (partial) 的含义;WSL 用发行版初始化时装入的 nodejs 运行钩子脚本与文件工具的助手——在此之前初始化的发行版需要重新初始化,在那之前钩子与文件操作在其下会失败,而不会脱离封禁运行;stdio MCP Server 只有命令在发行版里存在时才能运行。
后端自己的选项(例如 bwrap 的程序路径与 1–30 秒的探测超时,Seatbelt 的程序路径)画在同一张卡片里,卡片的一个保存一并存下。未通过自检的后端(例如程序路径写错)会在这次保存后重新加载,无需重启。
设置对保存之后创建的 Session 生效;每个 Session 保留它创建时的策略。重启后设置仍然保留。