first commit

Lua/ILuaHost.cs

@@ -0,0 +1,63 @@
+namespace anjianjingling.Lua
+{
+    /// <summary>
+    /// Lua 脚本能力宿主：由主窗体实现，向 Lua 引擎提供系统级操作能力。
+    /// 所有方法均在后台执行线程上被调用。
+    /// </summary>
+    public interface ILuaHost
+    {
+        void Log(string msg);
+
+        /// <summary>是否启用拟人化（落点随机偏移 + 随机微延时）。</summary>
+        bool JitterEnabled { get; }
+
+        // ---- 鼠标 ----
+        void MouseMove(int x, int y);
+        void MouseMoveR(int dx, int dy);
+        void MouseClick(string button, int? x, int? y);
+        void MouseDoubleClick(int? x, int? y);
+        void MouseDown(string button);
+        void MouseUp(string button);
+        void MouseWheel(int delta);
+        void MouseDrag(int x1, int y1, int x2, int y2, int durationMs);
+        (int X, int Y) MousePosition();
+
+        // ---- 键盘 ----
+        void KeyPress(string key);
+        void KeyDown(string key);
+        void KeyUp(string key);
+        void HotKey(string expression);
+        void TypeText(string text);
+
+        // ---- 屏幕与视觉 ----
+        (int W, int H) ScreenSize();
+        string ColorAt(int x, int y);
+        (int X, int Y) FindColor(int x1, int y1, int x2, int y2, string hex, int tolerance);
+        (int X, int Y, double Score) FindImage(int x1, int y1, int x2, int y2, string templatePath, double similarity);
+        void ScreenShot(string path);
+
+        /// <summary>弹出框选截图，返回保存路径（用户取消返回 null）。</summary>
+        string? PickRegion(string? savePath);
+
+        // ---- 窗口 / 系统 ----
+        void Launch(string path, string? arguments);
+        bool ActivateWindow(string titleKeyword);
+        string[] ListWindows();
+
+        // ---- 剪贴板 ----
+        string ClipGet();
+        void ClipSet(string text);
+
+        // ---- 内嵌浏览器 ----
+        void BrowserOpen(string url);
+        bool BrowserClick(string selector);
+        bool BrowserType(string selector, string text);
+        bool BrowserWaitFor(string selector, int timeoutMs);
+        string BrowserGetText(string selector);
+        string BrowserExecJs(string js);
+        void BrowserShot(string path);
+        void BrowserBack();
+        void BrowserForward();
+        void BrowserReload();
+    }
+}