Sheerpower Scripting Debug 0.1.13

Sheerpower Scripting Debugger Extension：提升Sheerpower脚本调试效率

Sheerpower Scripting Debugger Extension是由cdturner和Dan Esbensen开发的调试工具，旨在为Sheerpower语言提供基本的调试支持，E-closing.com和TTINET提供了合作支持。

功能概述：

• 断点设置： 支持在运行程序中设置断点，方便您在关键位置暂停程序执行。
• 附加到运行进程： 可以附加到正在运行的Sheerpower进程，进行实时调试。
• 变量作用域： 支持查看全局变量、本地变量、例程参数和例程返回参数。
• 变量值修改： 允许在调试过程中修改变量值，测试不同场景。
• 控制台输出管理： 可以镜像和重定向Sheerpower控制台输出，方便查看程序运行情况。
• 命令输入： 支持在控制台中输入Sheerpower命令，进行交互式调试。

使用说明：

此调试扩展与Sheerpower语言扩展互补，提供基本的Sheerpower语言支持。目前此调试扩展仍处于实验阶段，可能会有些不稳定。如果遇到问题，重启Visual Studio Code编辑器即可重置。

程序执行时，调试器会在第一行暂停，这看起来有些奇怪，但确实有效。未来您将可以选择是否在开始时暂停。

断点设置：

通过在文件左侧列（行号左侧）点击，可以设置断点。断点设置后，左侧会出现一个红色小点，点击该点可以移除断点。未来将支持条件断点。

监视窗口：

目前不支持监视窗口，请勿使用，以免影响调试器的其他功能。未来将实现此功能。

命令与快捷键：

调试命令和快捷键与Visual Studio的C#模式类似，易于上手。

• 启动调试会话： 将鼠标光标置于spsrc文件窗口中，按F5键即可在调试器下启动脚本。启动时可能会暂停30秒，等待编辑器与调试器同步。

  • 快捷键：F5
  • 命令名称：sheerpower-debug.launchDebugger

• 附加到调试会话： 未来支持，通过按Shift-F5键，显示运行中的sp4gl.exe进程列表，选择要附加的进程。此功能要求进程在命令行中以/DEBUG参数启动。

  • 快捷键：Shift-F5
  • 命令名称：sheerpower-debug.attachDebugger

• 无调试运行：

  • 快捷键：Ctrl-F5
  • 命令名称：sheerpowerBasic.runSheerpower

可选语言扩展控制参数：

调试扩展暴露了许多属性，用于控制服务器的响应方式。具体参数待定。

发布版本：

• 0.1.0 初始演示版本，供团队内部使用。

当前缺失功能：

• 变量区域中对数组、多维数组和结构的支持。
• 设置当前语句（将当前执行移动到另一行）。
• 悬停查看变量值。
• 考虑当前作用域前缀的变量评估。
• 异常断点。
• 暴露基本属性以设置跟踪模式和启动时断点。
• 实现运行进程选择器。
• 探测进程是否处于调试模式等功能。

Sheerpower Scripting Debugger Extension为Sheerpower脚本开发者提供了强大的调试工具，尽管目前仍在完善中，但已具备基本的调试功能，未来将不断优化和扩展。