跳转到主要内容
工作区是项目、会话、密钥和环境变量的归属范围。「设置」导航的「工作区」分组包含「基本信息」「机器」「密钥与环境变量」「项目」「已归档对话」。本页说明基本信息、密钥与环境变量和项目;机器见 运行环境:本机与云主机,已归档对话见 归档。

适用范围

桌面客户端、网页版、手机网页都支持;手机网页上设置导航改为分组列表,点进详情。

入口

账户菜单 ›「设置」,左侧导航「工作区」分组。

基本信息

修改名称时,名称 1–64 个字符,不能为空。

云主机管理员权限

「基本信息」下方是「云主机管理员权限」开关(开启后 Agent 可以在云主机上安装软件、调整系统配置;默认开启)和它的实际状态,见 云主机管理员权限。

密钥与环境变量

页面分两部分:
  • 项目:每个项目一组,显示项目名、来源和摘要(如「2 个变量 · 1 个密钥」)。
  • 所有项目共用:工作区级,对每个项目生效。
规则:
  • 同名时项目的值优先;项目里没有同名项时才用「所有项目共用」的值。项目组里覆盖了工作区的项带「覆盖 Workspace」,工作区组里被覆盖的项带「N 个项目覆盖」。
  • 密钥加密保存,AI 看不到原值;界面上密钥的值显示为圆点。
  • 每组右上角有「批量添加」和「添加密钥或变量」;每行有编辑和删除按钮。删除没有二次确认。

添加或编辑

批量添加

点「批量添加」,每行写一个 KEY=value,可以直接粘贴 .env 文件内容,同名的会被覆盖:
  • 名称里含 KEY、TOKEN、SECRET、PASSWORD 的按密钥保存,其余按变量保存。
  • 空行和 # 开头的行会被忽略;支持 export KEY=value;值两端成对的引号会被去掉。
  • 名称只能包含字母、数字和下划线,不能以数字开头,最长 64 个字符;值不能为空;同一名称不能写两行。
  • 不合格的行留在文本框里并标出「第 N 行:原因」,其余行照常保存。

密钥会用在哪里

  • 云主机上的项目环境:按上面的同名优先规则取值。
  • 本机方式执行时:设备的「可下发的密钥」决定哪些工作区密钥会提供给那台电脑,见 运行环境:本机与云主机。
  • AI 配置环境时发现缺少的密钥和变量,会在 环境检查 里请你填写,结果也保存在这里。

项目

「设置 › 工作区 › 项目」列出工作区的所有项目,每行显示名称、来源(GitHub 仓库或文件夹)、状态(如「待配置环境」「配置失败」「只在本机」)和变量数。点一行进入项目页,点行尾齿轮直接打开项目设置。状态含义见 项目环境 和 项目。

项目设置

单个项目的设置可以从项目列表的齿轮、项目页右上角「项目设置」或项目菜单「编辑」进入: 详见 项目 和 项目环境。

常见问题

项目和工作区里都有同名变量,用哪个?

用项目里的。「所有项目共用」的值只在项目里没有同名项时生效。

AI 能看到我填的密钥吗?

不能。密钥加密保存,界面和对话里只显示名称,运行时才提供给环境。

相关