目录

设置与通知

本页说明设置页里能配置的所有内容，以及 3Studio 在什么情况下会给你弹系统通知。

打开设置的入口

点击左侧栏底部的用户头像旁边的齿轮图标，即可打开设置页；设置页左上角有一个"←"箭头按钮，点击可返回主界面。

设置页顶部有四个标签：通用、LLM、工具、经验。切换到任一标签后，标签下方还有一条小字号的分区快捷跳转条，点击其中某个分区名可以直接滚动到对应内容，长页面找设置项时比较方便。

通用

语言

两个选项：中文 / English，点选即切换，界面文案会实时变化。默认是中文。本文档后续所有截图式描述都按默认中文界面书写。

⚠️ 3Studio 目前没有主题切换，界面固定为深色，设置里不会看到"深色/浅色"这类选项。

界面缩放

在系统自动适配的基础上再叠加一个倍率，供个人偏好微调。可选档位：80% / 90% / 标准（100%） / 110% / 125% / 150%。标准即纯自动适配，已经保证在不同显示器上占比一致；其余档位用于你个人觉得界面偏大或偏小时手动调整。

减弱动效

一个开关，默认关闭。打开后会减少动画、关闭装饰性动效，同时也会跟随你系统本身的"减弱动态效果"设置。

Agent 指令

这里控制 3Studio 里各个 Agent（替你干活的 AI 助手）的行为，指令分三层，自上而下叠加生效：

  • 全局指令：写在这里，对所有 Agent 生效（比如统一的语气、语言偏好、通用约束）。列表第一行是"全局指令（所有 agent）"，点"编辑"进入编辑页。
  • 各 agent 人设：每个 Agent 自己的角色设定，列表里每个 Agent 单独一行，点"编辑"单独修改。
  • 项目指令：每个项目根目录下的 AGENTS.md 文件，只在该项目内生效（这一层不在设置页里编辑，是工作区文件本身）。

改动只对新发起的对话生效，不会影响正在进行中的对话。如果你希望 Agent 用中文回答和思考，可以在全局指令里明确写出来，比如"请用中文回答与思考"——这是对模型的引导而非强制，个别模型仍可能不完全遵守。

LLM（模型服务）

第二个标签的名字是 LLM（大语言模型，Agent 背后驱动对话和决策的模型）。这里配置的模型服务是全局的：所有 Agent 共用同一份模型配置，无法给某个 Agent 单独指定不同的模型。

这个标签里显示什么内容，取决于你用的是哪种发行版：

  • 多数情况（自行配置模型服务）：显示"Model Provider"区域。你需要：
    1. 从 Provider 下拉框选一个预设（选择后会自动帮你填好下面的 Base URL / API 类型等字段），或选"自定义 Model ID"手动填。
    2. 填 API Key（密码框，输入内容会被遮盖）。
    3. 填 Chat Model ID——如果选的预设自带模型列表，会先给你一个下拉框挑选，也可以直接在下方文本框手填模型 ID。
    4. 下方"Compaction"区域有一个 Context Window（tokens） 数字框，控制对话上下文的容量上限；如果你手改过又想恢复模型默认值，旁边会出现"重置为 N tokens"的按钮。
    5. 更下面是一个可折叠的"高级"区域，收起时不显示；点开后能看到"聊天 Base URL"、"API 类型"（OpenAI Chat / Anthropic Messages 二选一）、"发送 Auth Header"复选框——这些是给需要对接自定义或非标准端点的用户用的，普通场景不需要碰。
    6. 改完之后要点 保存 Provider 按钮才会真正生效；有未保存的改动时按钮旁会提示"有未保存的更改"。
  • 商业发行版（且未开启内部调试面板）：不显示上述模型配置区域，改为显示 License 区域，用于填写激活码、查看积分余额和到期重置时间；此时模型服务由 3Studio 后台代管，不需要你自己填 API Key。如果激活的授权码带有路由能力，License 区域还会多出一个开关"主订阅额度不可用时使用组织积分继续请求"——打开后，主订阅额度用完时会自动改用组织积分继续请求；如果管理员没有开启这项权限，该开关会显示为禁用状态，并在旁边提示"管理员未开启付费 API fallback"。

工具

MCP 服务器

MCP（Model Context Protocol）服务器是给 Agent 扩展外部工具能力的外部程序，比如接入某个专业软件或数据源。这个分区：

  • 顶部有一个"刷新"按钮，重新检测已配置服务器的连接状态。
  • "编辑配置"按钮展开一个 JSON 配置编辑器，编辑前需要先选择范围：全局（对所有工作区生效）或项目（只对当前工作区生效）；改完点"保存"。
  • 下方是已连接服务器的列表，每条显示服务器 ID、连接状态标签、所属范围（global/project）、命令或地址，以及提供的工具数量；连接出错时会额外显示错误信息。

配置文件的 JSON 格式、两个作用域的文件位置、保存后何时生效以及连接问题排查，详见《MCP 扩展工具》。

工具审批

两个独立的开关，控制 Agent 执行"风险工具"（文件编辑 / Shell 命令 / 网络请求等）前是否需要你先确认：

  • 当前项目 · Auto-approve：关闭时，运行风险工具前会先询问你；打开后，自动批准这个项目里的所有工具调用。
  • Pebble 助手 · Auto-approve：单独控制 Pebble（内置的跨项目私人助理 Agent）的审批模式，和上面"当前项目"的开关互不影响，两者可以分别设置。

两个开关切换后立即生效并自动保存，不需要额外点保存按钮。

Python 环境（通用设置）

CAE/CAD 软件模块区域上方还有一张通用的 Python 环境 卡片，用来统一设置这些桥接程序背后依赖的基座 Python 和虚拟环境根目录，同样仅在 Windows 系统上出现；完整说明见《支持的 CAE/CAD 软件：概览与通用设置》。工具标签页顶部的分区跳转条里也有一个"Python 环境"直达入口，点击可以直接跳到这张卡片。

CAE/CAD 软件模块

这个标签最下方还会显示 MATLAB / STK / Ansys 三款专业软件的连接设置卡片，但仅在 Windows 系统上出现（在 macOS / Linux 上这部分完全不显示）。每张卡片的详细配置说明见「支持的 CAE/CAD 软件」章节：

记忆与经验

第四个标签"经验"里的开关都是立即生效自动保存的，跟 LLM 标签下"Model Provider"需要手动点"保存 Provider"不同。

  • 自动记忆抽取（开关，默认打开）：空闲时自动从对话里抽取记忆，作为后台兜底安全网；关闭它不影响你在对话过程中主动让 Agent 存记忆。
  • 梦境整理（开关，默认打开）：空闲时在后台整理已有记忆——合并重复内容、修正矛盾、删除过时事实、精简索引，每天最多执行一次。
  • 抽取 / 做梦模型（文本框）：指定抽取和梦境整理专用的模型，格式是 providerID/modelID；留空则使用你在 LLM 标签配置的主模型。填一个更便宜的模型（比如示例里给出的 anthropic/claude-haiku-4-5）可以节省 token 消耗。
  • 立即整理（按钮）：手动触发一次梦境整理，不用等到空闲时自动执行；旁边会显示"上次整理：<时间>"，从未整理过则显示"尚未整理过"。
  • 全局经验层（开关，默认打开）：把项目里积累的经验再蒸馏一层，变成跨项目通用的经验，供所有 Agent 复用。打开后如果已经有归档的全局经验条目，下方会列出条目名称、层级和证据条数，每条都有"查看"和"删除"按钮（删除前会弹窗二次确认）。

⚠️ 待核对：抽取 / 做梦模型输入框对格式没有做即时校验，填错格式（比如漏掉 /）具体会发生什么现象未在代码里确认，建议照 providerID/modelID 的格式填写。

系统通知

3Studio 会在以下几种情况下弹出你操作系统自带的通知：

  • Agent 完成一个任务时（弹"任务完成"类通知）。
  • Agent 执行任务出错时（弹"任务失败"类通知，附带错误信息）。
  • 后台任务结束时（完成 / 被手动终止 / 以其他方式结束，三种情况各对应不同的通知文案）。

前台不弹：只要 3Studio 窗口处于当前聚焦状态（也就是你正在看着这个窗口），就不会弹出系统通知——避免你正在用的时候被打断。点击一条通知会把 3Studio 窗口带到前台。

目前设置里没有可以单独关闭这些通知的开关。另外，通知标题当前固定是英文（例如 "Task Complete" "Task Failed" "Background Task Complete"），暂未跟随中文/English 界面语言切换。