# 🚀 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 以确保扩展正常工作

### 方法二：命令行安装

```bash
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 开发体验！** 🎉