# JsonGeek 用户指南

## 1. 快速开始

### 1.1 安装
1. 打开 Chrome 扩展管理页面 (`chrome://extensions/`)
2. 启用开发者模式
3. 点击"加载已解压的扩展程序"
4. 选择 JsonGeek 目录

### 1.2 基本使用
- 快捷键：
  - `Ctrl+Shift+J`: 打开 JsonGeek
  - `Alt+Shift+F`: 格式化 JSON
  - `Alt+Shift+M`: 压缩 JSON

## 2. 功能说明

### 2.1 JSON 查看器
- 语法高亮
- 折叠/展开
- 行号显示
- 搜索功能

### 2.2 格式化工具
- 自动格式化
- 自定义缩进
- 压缩模式
- 导出功能

### 2.3 类型分析
- 自动类型推断
- 格式检测
- 错误提示
- Schema 生成

### 2.4 可视化
- 力导向图
- 鱼眼放大
- 节点拖拽
- 主题切换

## 3. 高级功能

### 3.1 大文件处理
- 流式加载
- 分片处理
- 性能优化
- 进度显示

### 3.2 智能分析
- 上下文感知
- 模式识别
- 类型推断
- 错误检测

### 3.3 开发者工具
- 网络请求监控
- JSON 编辑器
- 调试工具
- 性能分析

## 4. 配置说明

### 4.1 常规设置
```json
{
  "theme": "auto",      // 主题：light, dark, auto
  "indentSize": 2,      // 缩进大小
  "maxDisplayDepth": 10, // 最大显示深度
  "autoFormat": true    // 自动格式化
}
```

### 4.2 可视化设置
```json
{
  "graph": {
    "radius": 120,      // 鱼眼半径
    "distortion": 2,    // 鱼眼失真度
    "nodeSize": 5,      // 节点大小
    "linkDistance": 30  // 连接距离
  }
}
```

### 4.3 性能设置
```json
{
  "chunkSize": 1048576, // 分片大小 (1MB)
  "maxMemory": 100,     // 最大内存使用 (MB)
  "cacheSize": 50       // 缓存大小 (MB)
}
```

## 5. 常见问题

### 5.1 性能问题
Q: 处理大文件时变慢？
A: 启用分片处理，调整分片大小。

Q: 内存占用高？
A: 配置最大内存使用，开启自动清理。

### 5.2 显示问题
Q: 图形显示混乱？
A: 调整力导向图参数，减小节点数量。

Q: 中文显示乱码？
A: 检查文件编码，确保为 UTF-8。

### 5.3 功能问题
Q: 快捷键不响应？
A: 检查快捷键冲突，重新设置。

Q: 类型推断不准？
A: 提供更多样本数据，调整置信度。

## 6. 最佳实践

### 6.1 性能优化
1. 使用分片处理大文件
2. 合理设置缓存大小
3. 及时清理无用数据
4. 避免过深的嵌套

### 6.2 可视化优化
1. 限制显示节点数量
2. 调整力导向参数
3. 使用适当的布局
4. 合理设置鱼眼参数

### 6.3 开发建议
1. 使用类型检查
2. 添加错误处理
3. 遵循编码规范
4. 编写单元测试

## 7. 更新日志

请参考 [CHANGELOG.md](../CHANGELOG.md)

## 8. 反馈建议

- GitHub Issues
- 邮件支持
- 在线文档
- 社区讨论
