Skritt Debugger：Visual Studio Code的Duktape调试客户端

Skritt Debugger是一款专为Visual Studio Code设计的Duktape调试客户端，旨在帮助开发者高效调试Typescript代码。在使用此调试器之前，需要对调试目标进行一些配置，具体请参阅开发者使用说明。

客户端使用方法：

1. 打开调试选项卡，从下拉菜单中选择“添加配置”。
2. 选择“Skritt Debugger”并保存文件。
3. 从下拉菜单中选择“Scratch”，然后按下绿色三角形或F5键。
4. 此时调试器应已连接到目标。

如果您有多个调试选项，可以返回到launch.json文件中删除其他配置，或者直接用以下配置替换launch.json文件中的所有内容。

Skritt Debugger launch.json配置：

{
    "version": "0.2.0",
    "configurations": [   
        {
            "name": "Scratch",
            "type": "skritt-debugger",
            "request": "attach",

            "address": "localhost",
            "port": 9091",

            "localRoot": "${workspaceRoot}",
            "sourceRoot": "asset",

            "stopOnEntry": false,
            "validateVersion": false,
            "supportsCachedBreakpoints": true,
            "debugLogLevel": 0,
            "showDebugVariables": false
          }
    ]
}

开发者使用说明：

在使用此调试器之前，目标需要实现两个应用请求：

1. Pause请求：通过单一字符串标识符"Pause"处理暂停请求，用于指示duktape暂停。无需回复。
2. 源映射获取：通过请求从目标获取源映射。第一个参数是字符串标识符"GetMap"，后跟另一个字符串，表示从源根目录开始的typescript文件路径。回复将包含VLQ源映射的字符串。

此外，目标还可以实现三个可选的应用通知：

1. Log通知：字符串标识符"Log"后跟一个字符串消息，将消息记录到调试控制台。
2. UpdateMap通知：字符串标识符"UpdateMap"后跟一个字符串路径（从源根目录开始）和另一个包含VLQ源映射的字符串，指示调试器更新该源文件的源映射（如果已有）。
3. SourceLoaded通知：与"UpdateMap"使用相同参数，允许调试器添加缓存的未验证断点（假设"supportsCachedBreakpoints"为true）。重要的是，调试目标在发送此通知后必须执行duk_debugger_pause()，以便调试器在目标执行超过断点之前有机会添加断点。

参考资料：

• Duktape
• Duktape debugger.rst
• VSCode扩展概述
• VSCode示例调试器扩展
• Harold Bernes的VSCode Duktape调试器
• 源映射与VLQ格式化
• 更多VLQ格式化

许可证：

BSD-3-Clause