add plugins

pkg/plugin/types.go

@@ -0,0 +1,99 @@
+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
+}