4623a7f031
All checks were successful
Build Multi-Platform Binaries / build (push) Successful in 11m9s
100 lines
2.7 KiB
Go
100 lines
2.7 KiB
Go
package plugin
|
|
|
|
import (
|
|
"net"
|
|
"time"
|
|
)
|
|
|
|
// PluginType 定义 plugin 类别
|
|
type PluginType string
|
|
|
|
const (
|
|
PluginTypeProxy PluginType = "proxy" // 代理处理器 (SOCKS5, HTTP 等)
|
|
)
|
|
|
|
// PluginSource 表示 plugin 来源
|
|
type PluginSource string
|
|
|
|
const (
|
|
PluginSourceBuiltin PluginSource = "builtin" // 内置编译
|
|
PluginSourceWASM PluginSource = "wasm" // WASM 模块
|
|
)
|
|
|
|
// PluginMetadata 描述一个 plugin
|
|
type PluginMetadata struct {
|
|
Name string `json:"name"` // 唯一标识符 (如 "socks5")
|
|
Version string `json:"version"` // 语义化版本
|
|
Type PluginType `json:"type"` // Plugin 类别
|
|
Source PluginSource `json:"source"` // builtin 或 wasm
|
|
Description string `json:"description"` // 人类可读描述
|
|
Author string `json:"author"` // Plugin 作者
|
|
Checksum string `json:"checksum,omitempty"` // WASM 二进制的 SHA256
|
|
Size int64 `json:"size,omitempty"` // WASM 二进制大小
|
|
Capabilities []string `json:"capabilities,omitempty"` // 所需 host functions
|
|
ConfigSchema map[string]string `json:"config_schema,omitempty"`
|
|
}
|
|
|
|
// PluginInfo 组合元数据和运行时状态
|
|
type PluginInfo struct {
|
|
Metadata PluginMetadata `json:"metadata"`
|
|
Loaded bool `json:"loaded"`
|
|
LoadedAt time.Time `json:"loaded_at,omitempty"`
|
|
Error string `json:"error,omitempty"`
|
|
}
|
|
|
|
// Dialer 用于建立连接的接口
|
|
type Dialer interface {
|
|
Dial(network, address string) (net.Conn, error)
|
|
}
|
|
|
|
// ProxyHandler 是所有 proxy plugin 必须实现的接口
|
|
type ProxyHandler interface {
|
|
// Metadata 返回 plugin 信息
|
|
Metadata() PluginMetadata
|
|
|
|
// Init 使用配置初始化 plugin
|
|
Init(config map[string]string) error
|
|
|
|
// HandleConn 处理传入连接
|
|
// dialer 用于通过隧道建立连接
|
|
HandleConn(conn net.Conn, dialer Dialer) error
|
|
|
|
// Close 释放 plugin 资源
|
|
Close() error
|
|
}
|
|
|
|
// LogLevel 日志级别
|
|
type LogLevel uint8
|
|
|
|
const (
|
|
LogDebug LogLevel = iota
|
|
LogInfo
|
|
LogWarn
|
|
LogError
|
|
)
|
|
|
|
// ConnHandle WASM 连接句柄
|
|
type ConnHandle uint32
|
|
|
|
// HostContext 提供给 WASM plugin 的 host functions
|
|
type HostContext interface {
|
|
// 网络操作
|
|
Dial(network, address string) (ConnHandle, error)
|
|
Read(handle ConnHandle, buf []byte) (int, error)
|
|
Write(handle ConnHandle, buf []byte) (int, error)
|
|
CloseConn(handle ConnHandle) error
|
|
|
|
// 客户端连接操作
|
|
ClientRead(buf []byte) (int, error)
|
|
ClientWrite(buf []byte) (int, error)
|
|
|
|
// 日志
|
|
Log(level LogLevel, message string)
|
|
|
|
// 时间
|
|
Now() int64
|
|
|
|
// 配置
|
|
GetConfig(key string) string
|
|
}
|