# sgs-vm

**Repository Path**: jhpw/sgs-vm

## Basic Information

- **Project Name**: sgs-vm
- **Description**: sgs的解释器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-05-14
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 可视化脚本, Rust

## README

This project appears to be a virtual machine implementation for executing custom scripts. Based on the code structure and components, I'll create a README.md file explaining the project:

```markdown
# SGS 虚拟机 (SGS-VM)

SGS 虚拟机是一个用于执行自定义脚本语言的虚拟机实现。该项目提供了一个完整的虚拟机环境，可以解析和执行自定义的脚本代码，并包含丰富的内置函数支持。

## 项目结构

- `src/core/` - 核心虚拟机组件
  - `vm.rs` - 虚拟机实现核心
  - `token.rs` - 令牌解析器
  - `builtin.rs` - 内置函数实现
  - `utils.rs` - 工具函数

- `src/tests/` - 测试模块
- `data/sgs.json` - 配置文件

## 主要功能

虚拟机支持以下功能：
- 基本数学运算（取整、四舍五入、绝对值、平方根等）
- 字符串操作（查找、匹配、替换、拼接等）
- 文件读写操作
- 网络请求
- 延时执行

## 内置函数

虚拟机提供了一系列内置函数，包括：
- `print` - 控制台输出
- `print_vm` - 虚拟机专用输出
- `sleep` - 延时执行
- `vm_random` - 生成随机数
- 数学运算相关函数（floor, round, ceil, abs, sqrt 等）
- 文件操作函数（读取文件为字符串、写字符串到文件）
- 网络请求函数
- 字符串处理函数

## 使用方法

要使用虚拟机，请先初始化 Svm 实例，然后注册所需的函数和变量，最后执行解析后的令牌序列。

示例：
```rust
let mut vm = Svm::new(true);
vm.register_builtins();
let tokens = TokenDecoder::parse(script_code).unwrap();
vm.execute(tokens).await;
```

## 开发者

该项目由 jhpw 开发和维护。

## 许可证

本项目使用 MIT 许可证。
```