本页面由机器翻译。阅读英文原文。
设置
Commands 面板右上角的齿轮图标会打开这些设置 — 它是编辑器自己的设置页面,筛选到本扩展,也是唯一的设置界面。下面的所有设置也都可以从普通的 Settings 编辑器和你的设置文件中访问。

这些设置每一项都属于你,而不属于项目。 每一项描述的都是你自己的环境或你自己的阅读习惯 — 二进制文件在哪里、重新验证前等待多久、容忍多少次重新启动、是否显示可能被身后的人看到的值、你希望面板如何绘制 — 因此每一项都只限于你的用户设置,以及你在远程或容器化主机上工作时的远程设置。最后这一点对二进制文件路径尤其重要:编译器运行在扩展所在的主机上,因此该路径在你的笔记本电脑和容器之间可能不同,每个主机保留自己的值。
这一结果是有意为之的:仓库无法为打开它的任何人固定其中任何一项设置。 将某项写入工作区的 .vscode/settings.json 不起作用 — 编辑器会将其标记为在那里不适用,并继续使用你的值。如果你希望将某个选择记录在工作区本身中,选择 Release 下的两个 Release 命令就是用来做这件事的,它们写入的是 .aggrega/active-release 或 .aggrega-config.yaml,而不是编辑器设置。
| 设置 | 默认值 | 用途 |
|---|---|---|
aggrega.getStarted.show | true | 启动时是否打开欢迎页面。有三个界面会修改这同一项设置并保持同步:页面底部的复选框、Aggrega: Stop opening the welcome page on startup 以及 Aggrega: Get started。关闭它会阻止页面打开,而不是删除页面;用 Aggrega: Get started 重新开启它时也会打开该页面。 |
aggrega.server.binaryPath | aggrega | aggrega 二进制文件的路径。单纯的名称会在 PATH 中查找;以 ~/(Windows 上为 ~\)或 ${userHome} 开头的路径,从扩展所运行的主机上你的主文件夹中读取;其他任何路径按原样使用。 |
aggrega.server.debounceMs | 300 | 在更改时主动验证的防抖窗口。 |
aggrega.server.respawnAttempts | 5 | 在下述窗口内,语言服务器在未被要求的情况下停止后会被重新启动多少次;超过后,扩展将让它保持停止,并发出“停止响应”通知。重新启动后在应答之前就停止的服务器,与运行中停止的服务器同样计数。参见生命周期。 |
aggrega.server.respawnWindowSeconds | 180 | 统计这些重启次数的滑动窗口,以秒为单位。 |
aggrega.server.restartGraceSeconds | 5 | 更改 binaryPath 后,扩展自动重启语言服务器之前的宽限窗口。状态栏会显示倒计时;快捷操作菜单提供 Restart now 和 Cancel restart。 |
aggrega.server.buildOnInspect | false | 在检查图时运行工件渲染阶段,使 aggrega build 在渲染时发出的建议也作为编辑器问题显示。它不会添加任何会使构建停止的检查。运行时检查的开销更大;不会向磁盘写入任何内容。 |
aggrega.graph.showSensitiveValues | false | 在拓扑图中显示 Feature 声明为敏感的值,以明文显示按值传递的凭据;开启时,图请求会向语言服务器索取这些值。保持关闭时,语言服务器会在其发送的图中隐去这些值,并且在绘制图之前会再次将其移除。 |
aggrega.operations.layout | buttons | Commands 面板如何绘制其分组 — buttons 将所有操作放入一个自动换行的按钮流中,组与组之间不绘制任何内容;sections 将每个分组作为一个在其标题下展开的区块。两种方式下分组相同、操作相同、顺序相同。 |
aggrega.notifications.toastDebounceMode | time | 对于你未主动请求的工作(例如保存后重绘已打开的图),Release 没有锁文件的通知再次显示的频率:time 在上一次通知关闭后经过 toastThrottleSeconds 再次显示,session 在语言服务器重启前只显示一次。因缺少锁文件而被拒绝的 Build、Preview 或你打开的图总是会显示该通知。 |
aggrega.notifications.toastThrottleSeconds | 300 | 缺少锁文件的通知关闭后,针对你未请求的工作再次显示之前的秒数。仅当 toastDebounceMode 为 time 时读取。 |