squirrelVsis/INSTALL_GUIDE.md

🚀 Squirrel NUT Explorer - 安装和使用指南

📦 已修复版本特性

✅ 修复了所有代码错误检测的误报问题

• 字符串检测不再误报
• 括号检测不再误报
• 智能语法检查
• 快速错误修复

✅ 完整的功能支持

• 代码自动完成
• 悬停信息显示
• 定义跳转
• 函数签名帮助
• 代码格式化
• 错误检测和修复

📋 安装步骤

方法一：通过 VSIX 文件安装 (推荐)

1. 打开 VS Code

2. 打开扩展面板

   • 快捷键：Ctrl+Shift+X
   • 或点击左侧活动栏的扩展图标

3. 安装扩展

   • 点击扩展面板右上角的 "..." 菜单
   • 选择 "从 VSIX 安装..."
   • 浏览并选择：squirrel-nut-explorer-1.0.1.vsix

4. 重启 VS Code

   • 安装完成后重启 VS Code 以确保扩展正常工作

方法二：命令行安装

code --install-extension squirrel-nut-explorer-1.0.1.vsix

🎯 使用方法

1. 激活扩展

   • 扩展会在 VS Code 启动时自动激活
   • 在活动栏中会看到 "Squirrel" 图标

2. 连接到 pvfUtility

   • 确保 pvfUtility 服务正在运行
   • 点击 Squirrel 面板中的"连接到 pvfUtility"按钮
   • 连接成功后即可使用所有功能

3. 编辑 NUT 文件

   • 打开或创建 .nut 文件
   • 享受完整的语言支持功能

🔧 功能说明

代码错误检测

• 实时检测：输入时即时显示错误
• 智能识别：不会误报正常的字符串和括号
• 快速修复：点击灯泡图标或 Ctrl+. 应用修复

代码自动完成

• 关键字完成：Squirrel 语言关键字
• 函数完成：内置和自定义函数
• 变量完成：当前作用域的变量
• 跨文件完成：其他 NUT 文件中的函数

悬停信息

• 函数说明：显示参数、返回值和描述
• 类信息：显示类的方法和属性
• 跨文件信息：其他文件中的函数信息

其他功能

• 定义跳转：F12 或 Ctrl+点击
• 格式化代码：Shift+Alt+F
• 函数签名提示：输入函数参数时显示
• 输入时格式化：输入 )、;、} 时自动格式化

🐛 问题反馈

如果遇到任何问题，请检查：

1. VS Code 版本是否为 1.99.0 或更高
2. pvfUtility 服务是否正常运行
3. 文件扩展名是否为 .nut

📄 更新日志

v1.0.1 (修复版)

• ✅ 完全修复字符串检测误报问题
• ✅ 完全修复括号检测误报问题
• ✅ 改进语法错误检测精度
• ✅ 增强快速修复功能
• ✅ 优化性能和稳定性

---

享受无误报的 Squirrel 开发体验！ 🎉