语言服务器
语言服务器状态——状态栏左侧、Release 指示器旁边的指示器,显示 running、starting 或红色的 not running。无论编译器在做什么,它都是唯一始终存在的界面,因此你在这里得知没有任何东西在运行,而不必从已变得沉寂的界面去推断——它的工具提示会说明适用的是两种原因中的哪一种:这里没有任何文件夹是 Aggrega 能识别的,或者有这样的文件夹但服务器没有附加到它上面。点击它时,没有任何东西在运行则提供 Start,有东西在运行则提供 Restart,并执行你选择的操作。参见语言服务器未运行时。
语言服务器未运行时
此扩展提供的每个命令从扩展启动的那一刻起就存在,无论语言服务器是否在运行,其中只有两个要等待服务器后才会出现在命令索引中:下面提到的那一个,以及 Aggrega: Attach a Feature to the connection at the cursor,它只在语言服务器报告为 Aggregate 或 Release 的文档中列出。如果某个命令只有在服务器连接后才出现,那么恰恰在最需要它的时候——什么都没在运行、而你正在寻找启动方法的时候——它会从命令索引中缺失。
左侧的状态栏指示器是你了解当前状况的地方。 它显示 running、starting 或红色的 not running,其工具提示会说明原因:此窗口中没有 Aggrega 能识别的文件夹,或者有这样的文件夹但服务器未连接到它。点击它会提供 Start 或 Restart(视情况而定)并执行该操作。

该指示器之所以存在,是因为无法运行的命令什么也解释不了:命令索引会略去它而不说明原因,而且没有任何编辑器界面会在禁用的控件上显示工具提示。指示器就是写明原因的地方,也是你据此采取行动的地方。
启动失败时会说明编译器路径出了什么问题。 当 aggrega.server.binaryPath 未指向任何东西时,通知显示 Aggrega language server failed to start: the compiler at ⟨path⟩ was not found.(Aggrega 语言服务器启动失败:未找到位于 ⟨path⟩ 的编译器。);当它指向一个无法运行的文件时,显示 … ⟨path⟩ is not an executable file.(……⟨path⟩ 不是可执行文件。)。⟨path⟩ 是扩展尝试启动的文件:以 ~/ 或 ${userHome} 开头的设置会显示为从你的主文件夹解析后的路径,即实际查找的位置。两者接着都会提示将 aggrega.server.binaryPath 设置为 aggrega 二进制文件,并附带 Open binary path setting(在设置界面中打开这一项设置)和 Show output。当路径未指向任何东西时,通知还会在这两项之前附带 Download the compiler 和 Choose another file,因为此时没有可替换的编译器:前者按获取编译器所述下载一个编译器,后者请你选择一个已有的编译器文件并将该设置指向它。存在但无法运行的文件是你自己放在那里的,因此该通知不提供下载。任何其他启动失败都会在相同的开头之后给出所得到的原因,然后指明所运行的编译器以及指定它的设置。Aggrega 输出通道中也有相同的说明。
Validate 会说明服务器未运行,并提供恢复的途径。 在没有语言服务器运行时按下它,它会回答 Aggrega: the language server is not running.(Aggrega:语言服务器未运行。)——如果上次启动失败,后面还会以报告该失败时的原话说明原因——并附带 Show output、Open binary path setting 以及状态栏指示器自己的 Start。
列表面板会说明服务器未运行,而不是报告失败。 在没有语言服务器运行时,Registries 和 Catalog 面板都会在列表位置显示 The Aggrega language server is not running.(Aggrega 语言服务器未运行。),并附带指示器自己的工具提示,按下该行即可启动服务器。Plugins 面板的列表来自以命令方式运行编译器,而不是来自语言服务器,因此当该命令无法启动时,其行会用通知中的措辞说明路径出了什么问题,按下它会打开该设置。
在没有语言服务器应答时,Aggrega: Open status bar menu 不会出现在命令索引中:它提供的所有内容都是对正在运行的语言服务器的操作,而编辑器不会列出在那里无法运行的命令。一旦有服务器应答,它会立即重新出现。
不需要服务器即可工作的命令会保留在命令索引中,即使它与服务器有关。Aggrega: Toggle the artifact-rendering stage while inspecting 会写入一项偏好设置,而服务器在启动时读取该偏好——因此服务器停止时正是设置它的最佳时机,而不是隐藏它的理由。
生命周期
扩展管理语言服务器进程的完整生命周期。当它停止语言服务器时——编辑器关闭、语言服务器移到另一个 Aggrega 工作区,或者不再有唯一的工作区可供其附着——它会先请求语言服务器协作退出,从而让进行中的工作完成。如果在宽限时间结束时语言服务器仍在工作,会再请求一次——这一次是要求它放弃该工作,而不是完成它。如果它仍未退出,扩展会退而使用操作系统级别的终止。重启——重启命令、aggrega.server.binaryPath 的更改,或扩展自身做出的配置更改——不会发出请求:它在操作系统级别终止进程并启动一个新进程。每个步骤都会报告到 Aggrega 输出通道,因此关闭缓慢时可以看出是哪一步耗时,以及语言服务器是否作出了回应。在 POSIX 和 Windows 主机上,语义完全相同。
未经请求就停止的语言服务器会被重新启动,但次数有限。 当正在运行的服务器结束时,扩展会启动一个新的服务器;如果这个服务器也结束了——无论是在启动时、在应答扩展的初始请求之前,还是在运行之后——它会依次再被启动,最多重启 aggrega.server.respawnAttempts 次,时间窗口为 aggrega.server.respawnWindowSeconds 秒。最后一次重启之后的那次结束会让服务器保持停止状态,并发出 Aggrega language server has stopped responding.(Aggrega 语言服务器已停止响应。),其中给出重新启动它的命令;此后不会再有任何东西自动重新启动它——因此每次启动都会崩溃的服务器只会被重新启动这么多次,不会更多。Aggrega 输出通道会用文字说明每个步骤:服务器意外停止以及它是如何结束的、每次重启以及该设置允许的次数、未能成功启动的重启及其原因,以及不再重新启动它。你请求的停止或重启——重启命令、aggrega.server.binaryPath 的更改,或扩展自身做出的配置更改——不计入次数,并且重启会将计数从零重新开始。首次启动以及你请求的重启在失败时不会重复:每次都以语言服务器启动失败的通知结束,并附上原因。
每个语言服务器都从它自己报告的内容开始填充 Problems 面板。 当服务器启动时——第一个服务器、无论以何种方式请求的重启、在上一个意外停止后重新启动的服务器、移到另一个 Aggrega 工作区的服务器,以及在没有服务器运行的地方启动的服务器——Problems 面板会清空上一个服务器报告的所有内容,并且每个打开的 YAML 文件都会在新服务器一作出应答时立即针对它进行检查。服务器无法收回它已报告的内容,而在它之后启动的服务器也不知道那些内容是什么,因此保留下来的问题将没有任何正在运行的服务器为其负责——在移动之后,就会是关于你已离开的工作区的问题。在检查打开的文件期间,问题会短暂消失又重新出现。只有其他请求才会计算的问题,在该请求再次运行之前不会出现:构建的问题会在绘制图、运行构建或预览构建时回来,锁文件的漂移警告在绘制图时回来——如果在该 Release 上打开了图面板,两者会同时回来,因为服务器恢复时该面板会重新绘制——而发布约定的问题会在你运行 Lint 时回来。停止后没有被替换的服务器——重启次数已用完,或者没有可附着的 Aggrega 工作区——会让 Problems 面板保持原样。
语言服务器在启动时读取其配置,并一直保留到停止为止。 命令行每次运行都会重新读取配置,因此对 .aggrega-config.yaml 或 ~/.config/aggrega/config.yaml 的编辑会立即改变终端的行为,却不会改变已在运行的语言服务器中的任何内容。因此,扩展会监视正在运行的服务器报告其读取过的配置文件——即 Show config 在参与贡献的文件中列出的文件路径——当其中某个文件在磁盘上被更改、删除或重新出现,从而不再与服务器读取的内容一致时,扩展会发出一条警告,指出该文件,并说明语言服务器在启动时读取其配置,同时附带一个 Restart server 按钮,用于运行 Aggrega: Start or restart the language server。一次保存产生的多次写入只发出一条警告。当该警告仍显示在屏幕上时,不会针对该文件再次发出;你关闭它之后,在文件再次更改之前也不会再发出;重启会从重启后的服务器所读取的内容重新开始监视。服务器启动时不存在的配置文件未被读取,因此不会被监视,创建这样的文件也不会触发任何警告;下一次启动会读取它。每次服务器启动时,被监视的文件都会写入 Aggrega 输出通道。
扩展自身做出的配置更改通过重启语言服务器来生效,无需询问。 添加或删除 registry、从欢迎页预置 registry、添加或删除插件、从欢迎页创建工作区配置,以及在需要创建文件时执行 Aggrega: Set authoring_release in .aggrega-config.yaml…,之后都会进行一次重启;重启运行期间会显示一条通知,指出服务器即将读取的文件,而且这些操作都不会触发警告:这项更改是你要求的。如果创建工作区配置时会自行启动语言服务器——之前没有服务器在运行,或者它在为另一个文件夹运行——那么这次启动会读取新文件,不会再进行第二次重启。一旦在更改之后启动的语言服务器读取了该更改,操作自身的结束消息会增加一句话,说明更改现已生效,而不是另发一条通知;如果重启失败,或者没有正在运行的语言服务器来读取更改,则省略这句话,因为此时更改已写入文件但尚未生效。设置 authoring_release 的结束方式是打开该文件而不是一句话,因此不会增加任何内容。