Soar Language Support 0.9.13

Soar Language Support for VSCode是一款专为Soar语言开发者设计的强大扩展，通过使用Language Server Protocol（LSP），为Soar语言提供全面的支持和功能，帮助开发者提升编程效率和代码质量。

主要功能：

• Tcl扩展：扩展会生成一个名为~tcl-expansion.soar的文件。每当光标位于定义生产的命令上（如sp或内部生成生产的Tcl宏），该文件将更新为生成的原始Soar代码。
• 跳转到定义：支持对Tcl变量和Tcl过程的定义跳转。
• 查找引用：可以查找Tcl变量和Tcl过程的引用。
• 悬停显示Tcl变量值：悬停在Tcl变量上时，可以查看其值。
• 悬停显示Tcl过程文档：悬停在Tcl过程调用上时，将显示其定义前的注释。
• 错误和警告报告：所有代码在内部JSoar实例中执行，任何错误或警告都会被捕获并在IDE中显示。IDE会尽量继续执行，以确保分析尽可能完整。
• 重命名：可以重命名Tcl变量，并更新已知的所有实例。
• 自动完成：在输入顶级命令或[时，会显示Tcl过程列表；在输入$后，会显示Tcl变量列表。
• 代码折叠：可以折叠注释、规则和Tcl过程。
• 语法高亮：由Bryan DeGrendel的Soar扩展提供。

项目设置：

为了让Soar LSP知道如何加载您的代理，您需要在工作区根目录创建一个soarAgents.json文件。此文件定义了工作区中存在的代理，以及默认使用的代理。由于目前无法解决两个不同代理定义相同变量时的冲突，因此需要默认代理。

示例文件内容如下：

{
    "entryPoints": [
        {
            "path": "agent1/load.soar",
            "name": "agent1"
        },
        {
            "path": "agent2/load.soar",
            "name": "agent2"
        }
    ],
    "active": "agent1",
    "rhsFunctions": ["force-learn"]
}

entryPoints列表定义了每个代理的名称和启动文件。此列表中至少应有一个条目。active字段是默认使用的代理名称，应与entryPoint列表中的一个条目名称匹配。

rhsFunctions列表是可选的，用于列出不应产生警告的右侧函数，即使它们默认未定义。

扩展设置：

此扩展提供了以下设置：

• soar.languageServer.enable：启用/禁用对.soar文件的语言服务器支持
• soar.languageServer.executablePath：Soar Language Server可执行文件的绝对路径
• soar.trace.server：跟踪VS Code与语言服务器之间的通信
• soar.maxNumberOfProblems：控制服务器生成的最大问题数量

通过这些功能和设置，Soar Language Support for VSCode为Soar语言开发者提供了强大的工具，帮助他们更高效地编写和管理代码。