YScript 脚本语言

YScript 是一门面向网络安全领域的脚本语言，提供丰富的内置网络、系统、编码和加密函数库，用于快速编写端口扫描、数据包分析、漏洞验证、日志处理等安全工具。

特性

• 内置网络库 — TCP/UDP 连接、端口扫描、HTTP 请求、SSL/TLS、CIDR 子网计算
• 系统交互 — 进程执行、Shell 命令（反引号）、文件 IO、目录遍历、符号链接
• 编码与加密 — Base64、Hex、JSON、XML、CSV、AES、RSA、Gzip 压缩
• 并发编程 — warp 多线程、Mutex/RWMutex、Channel、信号量、原子操作
• 函数式能力 — 闭包捕获、高阶函数（array.Map/Filter/Reduce、iter.*）
• 内存与指针 — @ 取地址、@> 解引用、alloc/free
• 空安全 — ?. 安全访问、?? nil 合并
• 类型系统 — byte/short/int/long/float/double、string、bytes、list、dict、struct、enum、interface、泛型
• 面向对象 — struct 方法（func this.method()）、接口多态（鸭子类型）
• 现代语法 — 三元运算符、match 多值/范围分支、多返回值、a..b 区间、for-in（list/string/dict）
• 函数默认参数 — func scan(target, port = 80, verbose = false)
• 二进制与字节 — b"..." 字节字面量、binary 编解码、hexdump
• 正则表达式 — 内置 regex 匹配与提取
• 编译执行 — 直接编译为字节码在轻量级 VM 上运行
• 安全沙箱 — #!permit 权限声明 + --sandbox 命令行策略（文件/命令/网络强制检查）
• 运行时求值 — eval() 动态编译执行、regex.replace_fn() 回调替换
• FFI 外部调用 — cgo+dlopen 真实调用 C 函数（getpid/strcmp/sysinfo 等），ffi.alloc/read/write/str 真实内存操作
• pcap 抓包 — 实时抓包（libpcap/Npcap）+ .pcap 文件读写（纯 Go）
• 字节码与独立产物 — --emit 落盘 .ybc、--build 生成单文件可执行程序

演示

• 完整演示文件
• 二进制处理

插件

• Vim/Nvim：Vim/Nvim插件
• VScode：VScode插件

快速开始

yscript hello.ys
yscript -e 'println("hello")'
yscript -c hello.ys            # 语法检查
yscript --emit app.ybc app.ys  # 编译为字节码
yscript app.ybc                # 直接运行字节码
yscript --build tool app.ys    # 生成独立可执行文件

国际化（i18n）

全部运行时错误消息支持中英双语，按 LANG 环境变量自动切换：

LANG=zh_CN.UTF-8 yscript app.ys   # 中文错误消息（默认）
LANG=en_US.UTF-8 yscript app.ys   # English error messages

语法示例

端口扫描

let conn = net.DialTimeout("192.168.1.1:80", 2)
if conn != nil {
    printf("[+] port 80 open\n")
}

并发 warp

let w = warp {
    println("hello from warp")
}
w.await()

HTTP 请求

let resp = http.Get("https://example.com")
if resp.status == 200 {
    println(resp.body)
}

字节与编码

let b = b"\x90\x90\x90"
let e = encoding.base64_encode(b)
let d = encoding.base64_decode(e)

空安全

let data = nil
let host = data?.host ?? "localhost"

加密

let key = "0123456789abcdef0123456789abcdef"
let encrypted = crypto.aes_encrypt(key, "secret data")
let decrypted = crypto.aes_decrypt(key, encrypted)

内置模块

模块	功能
net	TCP/UDP 连接、端口扫描、DNS 解析、CIDR、SSL/TLS
http	HTTP GET/POST/通用请求、超时、代理
io	文件读写、临时文件、chmod、walk、glob、symlink
os	进程执行、shell、hostname、getpid
encoding	base64、hex 编解码
json	JSON 解析与序列化
regex	正则匹配与提取
compress	gzip 压缩/解压
crypto	AES 加密/解密、RSA
binary	大端/小端编解码、PutUint16/32/64
sync	Mutex、RWMutex、Cond、Atomic、Chan、Semaphore、TLS、WorkerPool、WaitGroup、select
sys	CPU 信息、OS 信息、当前用户、网络接口
time	时间戳、格式化、解析、持续时间
path	路径 join、basename、ext
array	排序、查找
log	分级日志输出
stdio	交互式提示输入
rand	随机数、UUID 生成
ffi	C 语言外部函数调用（真实 ABI，cgo+dlopen；含真实内存操作）
color	ANSI 终端颜色输出
raw	原始 socket 操作 + pcap 抓包（实时/文件）
reflect	运行时类型反射
errors	错误码定义与匹配

安装

git clone https://github.com/your/project
cd yscript
go build -o yscript ./cmd/yscript/
sudo cp yscript /usr/local/bin/

测试

cd test
yscript main.ys

编辑器支持

目前支持 — vim、vscode