Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

23.5 KB
Raw Blame

title: 设置 description: 管理个人资料、偏好设置和密码;管理员还可以管理用户、代理、上传限制、公司模式、Agent API 和插件。

设置把不属于 Project 也不属于 Agent 的设置集中在一个对话框里:你的个人资料、界面偏好和密码;管理员还能在这里管理服务器的用户、代理、上传限制、公司模式、Agent API 和插件(包括沙盒)。

打开设置

  1. 在侧边栏底部点击你的用户行;侧边栏收起时,点击你的头像。账户菜单随即打开。
  2. 选择设置。

对话框的结构

对话框左侧是一列页面导航,每个页面由若干行设置项组成,标题在左,控件在右。窄屏上,这列导航会变成页面上方的一条横向滚动栏。

导航分为个人和服务器两组:

页面 分组 谁能看到
个人资料 个人 所有人
通用 个人 所有人
外观 个人 所有人
快捷键 个人 所有人
账户 个人 仅在有密码可改时出现
用户管理 服务器 仅管理员,桌面应用中没有
代理选项 服务器 仅管理员
上传限制 服务器 仅管理员
公司模式 服务器 仅管理员
Agent API 服务器 仅管理员
插件 服务器 仅管理员

个人偏好改动即生效,没有保存按钮,关掉对话框也不会丢失什么。唯一的例外是个人资料页的昵称:输入的文字需要显式提交,它的保存按钮就在输入框旁边,不在页面底部。

个人偏好的存储位置:

  • 保存在当前浏览器:语言、币种、任务完成通知、主题、终端主题、字号、主题色、快捷方式悬浮球和工具短名。
  • 随账户保存在服务器:个人资料、快捷键,以及你个人的公司模式开关。

服务器组的页面仅管理员可见,作用于整台服务器。非管理员既看不到这些条目,也无从得知它们存在:他们只能看到个人组的几页,导航也不再显示分组标题。

桌面应用里没有用户管理页,因为这时服务器是单用户的。桌面应用自己的窗口也没有账户页:它通过 shell 的 token 登录,没有密码可改;用密码登录同一台服务器的浏览器仍有这一页。

设置项标题旁的「?」可以查看这一项的说明,页面标题旁的「?」则说明整个页面。

检查更新不在这个对话框里,见更新 Adelie。

个人资料

个人资料页包含你的头像和昵称。它属于个人设置,在任何登录方式下都有,包括桌面应用自己的窗口,因为这两项都不需要密码就能修改。

这一页没有底栏:每个控件在使用时立即写入,负责写入的按钮就在对应的值旁边。

两项一开始都未设置。设置之前,侧边栏底部的用户行、收起后侧栏上的头像,以及从这两处打开的账户菜单顶部,都显示你的用户名和首字母头像。

设置之后,这三处都换成你的头像和昵称;账户菜单顶部仍会在昵称下方显示用户名。昵称还会显示在用户管理列表中用户名的下方。

更换头像

开始之前

  • 一张 PNG、JPEG 或 WebP 格式的图片。
  1. 在个人资料页选择更换头像。
  2. 选择一张 PNG、JPEG 或 WebP 图片。

头像立即生效。图片会按中心裁成正方形,重新编码为 128×128。

要换回首字母头像,选择更换头像旁边的恢复默认。

修改昵称

  1. 在个人资料页的昵称里输入 1–32 个字符的昵称。
  2. 选择保存。

长度按字符计算,因此中文昵称也可以写满 32 个字。保存空白昵称即清除昵称。

保存旁边的恢复默认把昵称恢复为默认值,即你的用户名。两个按钮都是点击即写入;要写入的值与已保存的值相同时,按钮不可用。

通用

通用页是个人设置。

设置 选项 作用
语言 English / 中文 / 跟随系统 「跟随系统」表示跟随浏览器。
币种 美元 $ / 人民币 ¥ 价格显示所用的币种。数据始终以美元存储,换算只发生在显示层。
任务完成通知 开 / 关(默认关闭) 窗口隐藏或失去焦点时 Task 结束,会弹出系统通知,点击即回到该 Session。
公司模式 开 / 关(默认开启) 只在管理员为服务器开启公司模式后出现。关闭只隐藏你自己的开发 / 公司切换,别的都不影响,组织照常运转。见公司模式。
导入 Trace — 把 Trace 文件导入为一段对话。只有你拥有至少一个 Project 时才会出现这一行。见导入 Trace。

[!NOTE] 打开任务完成通知时会当场向系统申请通知权限。系统只问一次:被拒绝后开关保持关闭并显示提示,只能到系统的通知设置里改回来。浏览器不支持系统通知时,开关不可用。

导入 Trace

导入 Trace 把 .jsonl 格式的 Trace 文件导入为某个 Agent 的一段对话。

开始之前

  • 一个从其他部署导出的 .jsonl Trace 文件,不超过 14MB。
  • 你是目标 Project 的 owner。

目标 Project 和目标 Agent 都要自己选:Agent 要选,是因为 Trace 文件本身无法指明本机的哪个 Agent;Project 要选,是因为这个对话框里看不出当前打开的是哪个 Project,这也意味着 Trace 可以导入到当前打开的 Project 之外。下拉框只列出你自己拥有的 Project,因为导入是 owner 的操作;一个都没有时,这一行不出现。

  1. 在通用页的导入 Trace 一行选择目标 Project:你拥有当前打开的 Project 时默认选它,否则默认选你拥有的第一个 Project。
  2. 选择目标 Agent,默认是该 Project 的 default_agent。
  3. 点击选择文件,选中 .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。各命令的缺省组合见「对话」中的快捷键。

  1. 点击某一行的组合,按钮开始等待新的组合。
  2. 按下新的组合。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] 通过首次登录链接登录时,设置密码不需要输入当前密码,因为这个账户此前的密码从来没有人见过。

修改密码

  1. 在账户页选择修改密码。
  2. 在当前密码里输入当前密码。通过首次登录链接登录后,这个字段不会显示。
  3. 在新密码里输入新密码(至少 8 个字符)。
  4. 在确认新密码里再输入一遍。
  5. 选择保存。

用户管理

用户管理页列出服务器上的所有用户。仅管理员可见;桌面应用里的服务器是单用户的,没有这一页。

在这里可以新增用户、重置密码和删除用户。

新增用户

  1. 在用户管理页选择新增用户。
  2. 输入用户名(2–32 个字符:以小写字母开头,后面只能用小写字母、数字和下划线)和初始密码(至少 8 个字符)。
  3. 选择创建。

新用户会得到一个名为 <userId>-default_project 的默认 Project。仍在使用初始密码的用户会带有「初始密码」徽标。

重置用户密码

  1. 在用户管理页找到用户,选择重置密码。
  2. 输入新的初始密码,选择保存。

重置密码会让该用户的所有登录会话失效,之后须用新密码重新登录。

删除用户

[!WARNING] 删除用户会一并删除其名下的全部 Project,包括数据目录,且不可恢复。

  1. 在用户管理页找到用户,选择删除。
  2. 在对话框中选择删除,再选择确认。

管理员角色的用户没有删除按钮,服务器也会拒绝删除内置的 admin。

代理选项

代理选项页仅管理员可见,作用于整台服务器,决定哪些出站流量走代理。

设置 默认值 覆盖范围
应用程序使用代理 开 服务器自身的出站流量:LLM 请求、更新检查、图片抓取。
Agent 环境使用代理 开 Agent 命令子进程的环境。
代理地址 空 可选,两个开关共用。留空表示跟随代理环境变量。

代理地址接受 undici dispatcher 支持的任何代理 URL:http://、https://、socks5:// 或 socks://,可以带凭据。裸的 host[:port] 也可以,存储时会规范化为 http://…。其他输入一律拒绝,原因显示在输入框下方。

点击保存之前不会写入任何内容。保存时整个表单通过一次 PUT 提交,所以地址被拒时其余各项也不会写入。保存后出站 dispatcher 随即重建,对新建立的连接生效,无需重启。回环地址始终直连。

设置并测试代理

开始之前

  • 你的代理地址,使用上文支持的任意一种格式。
  1. 在代理选项页的代理地址中填入代理地址;留空则跟随代理环境变量。
  2. 打开应用程序使用代理,让服务器自身的出站流量走代理。默认已开启。
  3. 打开 Agent 环境使用代理,让 Agent 命令子进程的环境也使用代理。默认已开启。
  4. 选择保存。地址无效时不会写入任何内容,原因显示在输入框下方。
  5. 在保存下方选择测速,运行连通性测速。

连通性测速测量的是本服务器出站到各模型供应商这一跳。运行前页面会先列出目标: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 里只要有一个字段不合法,其他字段也都不会写入。

修改上传限制

  1. 在上传限制页的「单个附件上限(MB)」里输入 1 到 200 之间的整数。
  2. 在「单条消息附件合计上限(MB)」里输入 1 到 200 之间的整数,且不能低于单个附件上限。
  3. 选择保存。

保存立即生效,无需重启:附件校验和请求体上限都在每次请求时读取这项设置。

公司模式

公司模式页仅管理员可见,作用于整台服务器。页面上只有启用公司模式这一个总开关,默认关闭,需由管理员在这里打开。

开关一拨即生效,没有保存按钮。

关闭后,组织调度器和全部组织路由随之停用,所有人的模式切换也会隐藏。磁盘上的组织不受影响;重新打开后,错过的触发不会补发。

[!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 的命令、钩子脚本、stdio MCP Server 和文件工具隐藏的路径,读取也不例外;每行一个绝对路径,最多 64 条。

两种封禁模式都不允许 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 保留它创建时的策略。重启后设置仍然保留。