THEZYZSTUDIO commited on
Commit
0e43ef6
·
verified ·
1 Parent(s): 20cd670

Delete computer_mode_v20-1.py

Browse files
Files changed (1) hide show
  1. computer_mode_v20-1.py +0 -1834
computer_mode_v20-1.py DELETED
@@ -1,1834 +0,0 @@
1
- """
2
- THE Z AI — Computer Mode Server v20 "Headless-Native"
3
- =====================================================================================
4
- إعادة كتابة كاملة من الصفر — بنية مختلفة تماماً عن v11-v13.
5
-
6
- ── لماذا إعادة كتابة كاملة؟ ──
7
- البنية القديمة (v11-v13) اعتمدت على:
8
- Xvfb (X server وهمي منفصل) + Firefox/Chromium عادي يرسم عليه + التقاط
9
- الشاشة بأداة خارجية (import/ImageMagick، أو python-xlib، أو xwd) + xdotool
10
- لكل حركة فأرة/كيبورد.
11
- هذا يعني *عمليتين منفصلتين* لكل مستخدم (Xvfb + المتصفح) + عملية subprocess
12
- ثالثة لكل لقطة شاشة واحدة، وكلها تتواصل عبر بروتوكول X11 الثقيل. على سيرفر
13
- موارد محدودة (HF Free: 2 vCPU/16GB مشتركة)، هذا يعني استهلاك ذاكرة/CPU أعلى
14
- بكثير من اللازم، وأي بطء عابر في X11 يُفسَّر كـ"فشل التقاط" فيُفعّل ريستارت
15
- تلقائي للجلسة كاملة — وهذا بالضبط ما كان يسبب الريستارت المتكرر والأخطاء.
16
-
17
- ── البنية الجديدة v20 ──
18
- Chromium بوضع "--headless=new" (الوضع الرسمي الحديث من Google) *فقط*.
19
- بدون Xvfb. بدون X server من أي نوع. Chromium يرندر الصفحة بالكامل داخلياً
20
- في الذاكرة (نفس محرك الرندر الحقيقي، بدون نافذة مرئية)، ونتحدث معه حصرياً
21
- عبر Chrome DevTools Protocol (CDP) عبر WebSocket واحد لكل مستخدم:
22
- - Page.captureScreenshot → لقطة الشاشة (JPEG) مباشرة من المتصفح نفسه،
23
- بدون subprocess خارجي، بدون فحص "هل الصورة
24
- سوداء" (headless لا يُنتج شاشات سوداء أصلاً
25
- لأنه لا يعتمد على X server قد يتعطل).
26
- - Input.dispatchMouseEvent → حركة/نقر/سحب الفأرة (بدل xdotool mousemove/click)
27
- - Input.dispatchKeyEvent → كتابة/اختصارات لوحة المفاتيح (بدل xdotool key/type)
28
- - Page.navigate → فتح رابط/تبويب جديد
29
- - Runtime.evaluate → لصق النص العربي (clipboard بديل)، تنفيذ سكربت مساعد
30
-
31
- نتيجة هذا التبسيط:
32
- - عملية واحدة فقط لكل مستخدم (Chromium) بدل عمليتين (Xvfb+متصفح).
33
- - استهلاك ذاكرة أقل بشكل ملحوظ (لا X server منفصل يُبقي framebuffer في الذاكرة).
34
- - لا وجود لمفهوم "فشل التقاط الشاشة" الذي كان يُفعّل ريستارت — لو فشل CDP
35
- فالمشكلة الوحيدة الممكنة هي أن Chromium نفسه توقف، فنُعيد تشغيله هو فقط
36
- (لا حاجة لأي "reset" أوسع يمسح بروفايلات أو Xvfb لأنه غير موجود أصلاً).
37
- - أخف تعقيداً: أداة تحكم واحدة (CDP) بدل خليط (xdotool + import + xlib + xwd).
38
-
39
- ── ما الذي أُزيل من v13 ولماذا ──
40
- أدوات "browser_get_elements / browser_click_element / browser_type_into_element /
41
- browser_find_element / browser_get_page_text / browser_execute_js / browser_navigate
42
- (CDP) / browser_scroll_to_element / browser_get_state" — هذه لم تكن تُستخدم إطلاقاً
43
- من الواجهة الأمامية (index.html) بعد فحص الكود الفعلي؛ الواجهة تُرسل فقط:
44
- screenshot, terminal, mouse_move, mouse_click, mouse_drag, keyboard_type,
45
- keyboard_hotkey, keyboard_press, scroll, clipboard_write, clipboard_read, paste,
46
- open_app, open_tab, close_tab, browser_back, browser_forward, browser_search,
47
- screen_info, reset_computer. إزالة الكود الميت قلّلت التعقيد والـ WebSocket
48
- overhead لأدوات لا أحد يستدعيها.
49
-
50
- ── التوافق مع الواجهة الأمامية ──
51
- البروتوكول (أسماء actions، أسماء حقول رسائل screenshot/terminal_result/
52
- computer_reset/error/connected/screen_info) مطابق 100% لما تتوقعه
53
- index_plus_prompt_enhanced_v2-3.html — لا حاجة لأي تعديل في الفرونت إند.
54
-
55
- ── v20.1 — إضافات: تعدد المتصفحات + بحث رسمي بدون كابتشا ──
56
- 1) تعدد المتصفحات (Multi-Browser Fallback):
57
- عند إقلاع السيرفر، يُفحص كل مرشحي المتصفح المعروفين (Chromium بأسمائه
58
- المختلفة حسب التوزيعة، Chrome، Edge، Brave...) بتشغيل حقيقي فعلي (مو مجرد
59
- "هل موجود بالمسار") واختي��ر أول واحد يستجيب فعلاً على CDP. لو المتصفح
60
- المعتمد فشل لاحقاً أثناء تشغيل جلسة مستخدم حقيقية (مثلاً تحديث كسر الثنائي)،
61
- السيرفر يجرب بقية المرشحين تلقائياً ويعتمد أول بديل ناجح لبقية الجلسات —
62
- بدون أي تدخل يدوي أو إعادة نشر.
63
-
64
- 2) Brave Search API — قناة بحث رسمية بدون كابتشا إطلاقاً:
65
- المشكلة الأصلية: فتح duckduckgo.com/google.com كموقع فعلي عبر المتصفح
66
- لأجل "البحث عن معلومة" يواجه كابتشا حتمياً، لأن هذي المحركات مصممة لمنع
67
- الطلبات الآلية تحديداً. الحل: بدل زيارة الموقع، الذكاء الاصطناعي يرسل أمر
68
- terminal بصيغة search: نص الاستعلام (بدل curl معقد) فيُستدعى Brave
69
- Search API مباشرة (بدون فتح أي متصفح، بدون كابتشا، لأنه مرخّص لهذا الغرض
70
- تحديداً من مزوّده). فتح متصفح Computer Mode الفعلي يبقى محفوظاً فقط لما
71
- يحتاج المستخدم "تصفح موقع بعينه بصرياً" أو التفاعل مع صفحة معينة — بالضبط
72
- نفس فلسفة عمل وكلاء مثل Manus: بحث نظيف عبر API لسطر الأوامر أولاً، ومتصفح
73
- حقيقي فقط للتصفح الفعلي.
74
-
75
- التفعيل: عيّن متغيّر بيئة BRAVE_API_KEY (من
76
- https://api-dashboard.search.brave.com — فيه باقة مجانية 2000 استعلام/شهر)
77
- على منصة النشر (Render/HF Spaces → Settings → Environment Variables).
78
- بدون المفتاح، يستمر السيرفر بالعمل عبر مصادر API المجانية البديلة
79
- (DuckDuckGo Instant Answer, Wikipedia, HackerNews, Reddit) تلقائياً.
80
-
81
- ── v20.2 — Camoufox: محرك متصفح ثانٍ مضاد للكشف ──
82
- المشكلة: حتى مع Brave Search API، أحياناً المستخدم يطلب فعلياً "تصفّح
83
- موقع معيّن بصرياً" (مو بحث)، وبعض المواقع (خصوصاً المحمية بـ Cloudflare/
84
- DataDome) تكتشف Chromium العادي فوراً حتى لو headless، لأنه يسرّب علامات
85
- أتمتة واضحة (navigator.webdriver=true، بصمة toString مكشوفة، إلخ).
86
-
87
- الحل: محرك بديل اختياري (Camoufox — Firefox معدَّل من مستوى C++، مفتوح
88
- المصدر ومجاني بالكامل) يُخفي هذي العلامات وينتج بصمة متصفح واقعية إحصائياً.
89
- يُفعَّل عبر أمر جديد يرسله الفرونت إند:
90
- {"action": "switch_engine", "data": {"engine": "camoufox"}}
91
- وللرجوع للمحرك الافتراضي السريع:
92
- {"action": "switch_engine", "data": {"engine": "chromium"}}
93
- بقية كل الأوامر (screenshot, mouse_click, keyboard_type...) تبقى بنفس
94
- الصيغة والبروتوكول تماماً — فقط تُنفَّذ عبر المحرك النشط للمستخدم، بدون
95
- أي تعديل مطلوب على الفرونت إند لتوجيه الأوامر بنفسها.
96
-
97
- تنبيه واقعي مهم: Camoufox يقلل ظهور الكابتشا بشكل ملحوظ، لكنه **ليس حلاً
98
- سحرياً 100%** — مواثيق Camoufox نفسها تذكر أن مواقع متقدمة جداً قد تكتشفه
99
- أحياناً عبر تحليل بصمات متقدم. كما أن سمعة IP السيرفر (Render/HF) تبقى
100
- عاملاً منفصلاً؛ Camoufox يعالج بصمة *المتصفح*، لا بصمة *الشبكة/IP*.
101
-
102
- المتطلبات: pip install camoufox[geoip] playwright، ثم
103
- playwright install firefox (أو camoufox fetch لتنزيل الثنائي المعدَّل
104
- تلقائياً عند أول استخدام، ~150-300MB لمرة واحدة). بدون هذي الحزم، أوامر
105
- switch_engine إلى camoufox تفشل بأمان وتُبقي الجلسة على Chromium.
106
- """
107
-
108
- import asyncio
109
- import base64
110
- import hashlib
111
- import json
112
- import os
113
- import re
114
- import subprocess
115
- import threading
116
- import time
117
- import urllib.parse
118
- from typing import Optional
119
-
120
- from fastapi import FastAPI, WebSocket, WebSocketDisconnect, Query
121
- from fastapi.middleware.cors import CORSMiddleware
122
- from fastapi.responses import JSONResponse, HTMLResponse
123
- import uvicorn
124
-
125
- try:
126
- import websockets as ws_lib
127
- _WS_LIB_AVAILABLE = True
128
- except ImportError:
129
- _WS_LIB_AVAILABLE = False
130
- print("⚠️ websockets غير مثبّتة — pip install websockets (مطلوبة لهذا الإصدار)")
131
-
132
-
133
- # ════════════════════════════════════════════════════════════════
134
- # ── الإعدادات العامة ───────────────────────────────────────────
135
- # ════════════════════════════════════════════════════════════════
136
-
137
- # أقصى عدد جلسات متزامنة. رقم واقعي لسيرفر موارد محدودة (HF Free CPU
138
- # Basic: 2 vCPU/16GB مشتركة) — كل جلسة = عملية Chromium واحدة فقط الآن
139
- # (بدل Xvfb+متصفح سابقاً)، فالحمل الفعلي لكل مستخدم أخف من النصف تقريباً
140
- # مقارنة بالبنية القديمة، لكن نبقي رقماً متحفظاً بدل الافتراض المتفائل.
141
- MAX_SESSIONS = 40
142
-
143
- CDP_PORT_BASE = 9300
144
- SCREEN_W, SCREEN_H = 1280, 800
145
-
146
- _sessions_lock = threading.Lock()
147
- _cdp_port_pool_lock = threading.Lock()
148
- _used_ports: set = set()
149
-
150
-
151
- def _detect_chromium() -> str:
152
- """
153
- يكتشف أي متصفح متوفر على هذا السيرفر — يجرب كل الأسماء الشائعة (Chromium,
154
- Chrome, Chromium الرسمي بأشكاله المختلفة حسب توزيعة Linux)، مو اسم واحد بس.
155
- """
156
- return _pick_working_browser()
157
-
158
-
159
- # كل الأسماء الشائعة لثنائيات المتصفح على توزيعات Linux المختلفة (Debian/Ubuntu،
160
- # Alpine، RPM-based) — الذكاء الاصطناعي (عبر هذه الدالة) يجرب كل واحد بالترتيب
161
- # ويستخدم أول واحد يعمل فعلياً، بدل الاعتماد على اسم واحد قد لا يوجد على صورة
162
- # الحاوية المستخدمة.
163
- _BROWSER_CANDIDATES = [
164
- "chromium-browser", # Debian/Ubuntu
165
- "chromium", # Alpine/Arch/Fedora
166
- "google-chrome-stable", # Google Chrome الرسمي
167
- "google-chrome",
168
- "chromium-freeworld", # بعض توزيعات RPM
169
- "ungoogled-chromium", # نسخة خصوصية من Chromium
170
- "microsoft-edge-stable", # Edge (مبني على Chromium، يدعم نفس CDP)
171
- "brave-browser", # Brave (مبني على Chromium، يدعم نفس CDP)
172
- ]
173
-
174
-
175
- def _binary_exists(name: str) -> bool:
176
- r = subprocess.run(["which", name], capture_output=True, text=True)
177
- return r.returncode == 0 and bool(r.stdout.strip())
178
-
179
-
180
- def _test_browser_launch(binary: str, timeout: float = 6.0) -> bool:
181
- """
182
- اختبار حقيقي: يشغّل المتصفح فعلياً بوضع headless على منفذ CDP مؤقت
183
- ويتأكد أنه يستجيب — مو مجرد فحص "موجود بالمسار"، لأن أحياناً الثنائي
184
- موجود لكن مكسور (مكتبات ناقصة، إلخ).
185
- """
186
- test_port = CDP_PORT_BASE + 9999 # منفذ مخصص للاختبار فقط، لا يتعارض مع الجلسات
187
- try:
188
- subprocess.run(["pkill", "-9", "-f", f"[r]emote-debugging-port={test_port}"],
189
- capture_output=True, timeout=3)
190
- except Exception:
191
- pass
192
- try:
193
- proc = subprocess.Popen([
194
- binary, "--headless=new", f"--remote-debugging-port={test_port}",
195
- "--remote-debugging-address=127.0.0.1", "--disable-gpu", "--no-sandbox",
196
- "--disable-dev-shm-usage", "--no-first-run", "about:blank",
197
- ], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
198
- except Exception:
199
- return False
200
-
201
- ok = False
202
- deadline = time.time() + timeout
203
- try:
204
- import urllib.request
205
- while time.time() < deadline:
206
- try:
207
- with urllib.request.urlopen(f"http://127.0.0.1:{test_port}/json/version", timeout=1.0) as r:
208
- if r.status == 200:
209
- ok = True
210
- break
211
- except Exception:
212
- time.sleep(0.3)
213
- finally:
214
- try:
215
- proc.kill()
216
- proc.wait(timeout=3)
217
- except Exception:
218
- pass
219
- try:
220
- subprocess.run(["pkill", "-9", "-f", f"[r]emote-debugging-port={test_port}"],
221
- capture_output=True, timeout=3)
222
- except Exception:
223
- pass
224
- return ok
225
-
226
-
227
- def _pick_working_browser() -> str:
228
- """
229
- يجرب كل مرشحي المتصفح بالترتيب: أولاً يتأكد أن الثنائي موجود على القرص
230
- (سريع)، وإذا وجد، يختبره فعلياً بتشغيله والتأكد أنه يستجيب على CDP
231
- (اختبار حقيقي، لا افتراض). أول متصفح "حي" فعلاً يُعتمد لبقية عمر السيرفر.
232
- """
233
- found_but_untested = []
234
- for name in _BROWSER_CANDIDATES:
235
- if _binary_exists(name):
236
- found_but_untested.append(name)
237
-
238
- if not found_but_untested:
239
- print("❌ لا يوجد أي متصفح م��بّت على هذا السيرفر من بين المرشحين المعروفين:")
240
- print(f" {', '.join(_BROWSER_CANDIDATES)}")
241
- print(" ثبّت واحداً عبر: apt-get install chromium")
242
- return "chromium-browser" # افتراضي، حتى لو غير موجود، ليكون اسم واضح بالسجلات
243
-
244
- print(f"🔍 متصفحات موجودة على القرص: {', '.join(found_but_untested)} — يجري اختبار كل واحد فعلياً...")
245
- for name in found_but_untested:
246
- print(f" 🧪 اختبار {name} ...")
247
- if _test_browser_launch(name):
248
- print(f" ✅ {name} يعمل فعلياً — سيُعتمد لكل الجلسات")
249
- return name
250
- else:
251
- print(f" ❌ {name} موجود لكن فشل بالتشغيل الفعلي (مكتبات ناقصة أو ثنائي معطوب)")
252
-
253
- # كل شيء وُجد لكن فشل الاختبار الحي — استخدم أول موجود كخيار أخير مع تحذير واضح
254
- print(f"⚠️ كل المتصفحات الموجودة فشلت باختبار التشغيل الحي. سيُستخدم '{found_but_untested[0]}' "
255
- f"كخيار افتراضي أخير، لكن يُنصح بفحص تثبيت المتصفح على هذا السيرفر.")
256
- return found_but_untested[0]
257
-
258
-
259
- BROWSER_BIN = _detect_chromium()
260
-
261
-
262
- def _alloc_cdp_port() -> int:
263
- """يخصص منفذ CDP حر لمستخدم جديد."""
264
- with _cdp_port_pool_lock:
265
- p = CDP_PORT_BASE
266
- while p in _used_ports:
267
- p += 1
268
- _used_ports.add(p)
269
- return p
270
-
271
-
272
- def _release_cdp_port(port: int):
273
- with _cdp_port_pool_lock:
274
- _used_ports.discard(port)
275
-
276
-
277
- # ════════════════════════════════════════════════════════════════
278
- # ── Camoufox — محرك متصفح بديل مضاد للكشف (اختياري، بجانب Chromium) ──
279
- # ════════════════════════════════════════════════════════════════
280
- # لماذا محرك ثاني منفصل؟ Camoufox هو Firefox معدَّل من مستوى C++ (مو حقن
281
- # JavaScript قابل للكشف) يُخفي علامات الأتمتة (navigator.webdriver وغيرها)
282
- # ويولّد بصمة متصفح متّسقة وواقعية إحصائياً (نظام تشغيل، دقة شاشة، خطوط،
283
- # WebGL...) عبر مكتبة BrowserForge. هذا يقلل ظهور كابتشا المواقع المحمية
284
- # بشدة (Cloudflare, DataDome) بشكل ملحوظ — لكنه **ليس ضماناً مطلقاً** (حتى
285
- # موثّق Camoufox نفسه يذكر أن مواقع متقدمة قد تكتشفه أحياناً).
286
- #
287
- # الفرق الجوهري عن Chromium/CDP: واجهة Camoufox الرسمية هي Python+Playwright
288
- # (مو CDP خام)، فتحكمنا فيه يمر عبر Playwright API (page.mouse, page.keyboard,
289
- # page.screenshot) بدل رسائل CDP JSON المباشرة المستخدمة مع Chromium. لذلك
290
- # بنيناه كـ"محرك بديل" مستقل بجانب CDPSession، بنفس بروتوكول الأكشنات الخارجي
291
- # (screenshot/mouse_click/keyboard_type...) حتى لا يتأثر الفرونت إند إطلاقاً.
292
- #
293
- # التفعيل: تلقائي بالكامل — لا حاجة لأي إعداد. Camoufox حزمة بايثون عادية
294
- # (pip install camoufox[geoip] + playwright)، أول استخدام يُنزّل ثنائي
295
- # Firefox المعدَّل تلقائياً (~150-300MB مرة واحدة فقط، يُخزَّن ويُعاد استخدامه).
296
-
297
- try:
298
- from camoufox.async_api import AsyncCamoufox
299
- _CAMOUFOX_LIB_AVAILABLE = True
300
- except ImportError:
301
- _CAMOUFOX_LIB_AVAILABLE = False
302
- print("ℹ️ مكتبة camoufox غير مثبّتة — pip install camoufox playwright لتفعيل المحرك المضاد للكشف")
303
-
304
- CAMOUFOX_ENABLED = os.environ.get("CAMOUFOX_ENABLED", "1").strip() not in ("0", "false", "no")
305
-
306
-
307
- class CamoufoxSession:
308
- """
309
- جلسة Camoufox واحدة لكل مستخدم — بديل لـ CDPSession لكن مبني فوق
310
- Playwright بدل CDP خام. يوفر نفس نوع العمليات (screenshot, mouse,
311
- keyboard, navigate) بواجهة موحّدة (dict نتائج) لتُستهلك من نفس معالج
312
- الأكشنات (handle_action) دون تغيير بروتوكول الفرونت إند.
313
- """
314
-
315
- def __init__(self, user_id: str):
316
- self.user_id = user_id
317
- self._cm = None # AsyncCamoufox context manager instance
318
- self._browser = None # Playwright Browser
319
- self._context = None # Playwright BrowserContext
320
- self.page = None # Playwright Page الحالية
321
- self._mouse_x = SCREEN_W // 2
322
- self._mouse_y = SCREEN_H // 2
323
-
324
- @property
325
- def alive(self) -> bool:
326
- return self.page is not None and not self.page.is_closed()
327
-
328
- async def start(self) -> bool:
329
- if not _CAMOUFOX_LIB_AVAILABLE:
330
- print("[camoufox] ❌ المكتبة غير مثبَّتة على هذا السيرفر")
331
- return False
332
- try:
333
- profile = _profile_dir("camoufox_" + self.user_id)
334
- self._cm = AsyncCamoufox(
335
- headless=True, # Camoufox يدعم headless حقيقي بأمان (يُخفي علامات الكشف حتى في هذا الوضع)
336
- humanize=True, # حركة فأرة شبيهة بالبشر (منحنيات Bezier بدل خطوط مستقيمة)
337
- geoip=False, # لا نحتاج ضبط جغرافي تلقائي عبر بروكسي هنا
338
- persistent_context=True,
339
- user_data_dir=profile,
340
- window=(SCREEN_W, SCREEN_H),
341
- )
342
- self._context = await self._cm.__aenter__()
343
- # في persistent_context=True، الكائن المُعاد هو BrowserContext مباشرة
344
- pages = self._context.pages
345
- self.page = pages[0] if pages else await self._context.new_page()
346
- await self.page.set_viewport_size({"width": SCREEN_W, "height": SCREEN_H})
347
- print(f"[camoufox] ✅ جلسة جديدة لـ '{self.user_id}' جاهزة")
348
- return True
349
- except Exception as e:
350
- print(f"[camoufox] ❌ فشل بدء الجلسة: {e}")
351
- await self.close()
352
- return False
353
-
354
- async def close(self):
355
- try:
356
- if self._cm:
357
- await self._cm.__aexit__(None, None, None)
358
- except Exception:
359
- pass
360
- self._cm = None
361
- self._context = None
362
- self.page = None
363
-
364
- async def screenshot_b64(self) -> "str | None":
365
- if not self.alive:
366
- return None
367
- try:
368
- raw = await self.page.screenshot(type="jpeg", quality=75)
369
- return base64.b64encode(raw).decode()
370
- except Exception as e:
371
- print(f"[camoufox] ❌ فشل التقاط الشاشة: {e}")
372
- return None
373
-
374
- async def mouse_move(self, x: int, y: int):
375
- if self.alive:
376
- await self.page.mouse.move(x, y)
377
- self._mouse_x, self._mouse_y = x, y
378
-
379
- async def mouse_click(self, x: int, y: int, button: str = "left", double: bool = False):
380
- if not self.alive:
381
- return
382
- await self.page.mouse.move(x, y)
383
- if double:
384
- await self.page.mouse.dblclick(x, y, button=button)
385
- else:
386
- await self.page.mouse.click(x, y, button=button)
387
- self._mouse_x, self._mouse_y = x, y
388
-
389
- async def mouse_drag(self, x1: int, y1: int, x2: int, y2: int):
390
- if not self.alive:
391
- return
392
- await self.page.mouse.move(x1, y1)
393
- await self.page.mouse.down()
394
- await self.page.mouse.move(x2, y2, steps=10)
395
- await self.page.mouse.up()
396
- self._mouse_x, self._mouse_y = x2, y2
397
-
398
- async def scroll(self, x: int, y: int, delta_y: int):
399
- if not self.alive:
400
- return
401
- await self.page.mouse.move(x, y)
402
- await self.page.mouse.wheel(0, delta_y)
403
-
404
- async def type_text(self, text: str):
405
- if self.alive:
406
- await self.page.keyboard.type(text, delay=25) # تأخير خفيف بين الحروف — أكثر واقعية بشرياً
407
-
408
- async def key_press(self, key_name: str):
409
- if self.alive:
410
- await self.page.keyboard.press(key_name)
411
-
412
- async def hotkey(self, keys: list):
413
- if not self.alive:
414
- return
415
- combo = "+".join(keys)
416
- await self.page.keyboard.press(combo)
417
-
418
- async def navigate(self, url: str) -> bool:
419
- if not self.alive:
420
- return False
421
- try:
422
- await self.page.goto(url, timeout=20000, wait_until="domcontentloaded")
423
- return True
424
- except Exception as e:
425
- print(f"[camoufox] ⚠️ فشل التنقّل إلى {url}: {e}")
426
- return False
427
-
428
- async def go_back(self):
429
- if self.alive:
430
- try:
431
- await self.page.go_back(timeout=8000)
432
- except Exception:
433
- pass
434
-
435
- async def go_forward(self):
436
- if self.alive:
437
- try:
438
- await self.page.go_forward(timeout=8000)
439
- except Exception:
440
- pass
441
-
442
-
443
- # جلسات Camoufox منفصلة عن جلسات Chromium/CDP — مفتاحها user_id أيضاً، لكن
444
- # قاموس مستقل لأن محرك المستخدم قد يتبدّل بين الاثنين أثناء الجلسة نفسها.
445
- _camoufox_sessions: dict = {}
446
- _camoufox_lock = threading.Lock()
447
-
448
-
449
- async def get_camoufox_session(user_id: str) -> "CamoufoxSession | None":
450
- """يُرجع جلسة Camoufox م��جودة أو ينشئ واحدة جديدة عند الحاجة."""
451
- if not CAMOUFOX_ENABLED or not _CAMOUFOX_LIB_AVAILABLE:
452
- return None
453
- with _camoufox_lock:
454
- sess = _camoufox_sessions.get(user_id)
455
- if sess and sess.alive:
456
- return sess
457
- sess = CamoufoxSession(user_id)
458
- ok = await sess.start()
459
- if not ok:
460
- return None
461
- with _camoufox_lock:
462
- _camoufox_sessions[user_id] = sess
463
- return sess
464
-
465
-
466
- async def destroy_camoufox_session(user_id: str):
467
- with _camoufox_lock:
468
- sess = _camoufox_sessions.pop(user_id, None)
469
- if sess:
470
- await sess.close()
471
-
472
-
473
- # ════════════════════════════════════════════════════════════════
474
- # ── CDP Session — الاتصال المباشر بـ Chromium عبر DevTools Protocol ──
475
- # ════════════════════════════════════════════════════════════════
476
-
477
- class CDPSession:
478
- """
479
- اتصال WebSocket واحد بجلسة Chromium headless واحدة. كل الأوامر
480
- (screenshot, mouse, keyboard, navigate) تمر من هنا. اتصال واحد يُعاد
481
- استخدامه طوال حياة الجلسة بدل فتح اتصال جديد لكل أمر.
482
- """
483
-
484
- def __init__(self, port: int):
485
- self.port = port
486
- self._ws = None
487
- self._msg_id = 0
488
- self._pending: dict = {}
489
- self._recv_task: Optional[asyncio.Task] = None
490
- self._send_lock = asyncio.Lock()
491
- self._target_id = None
492
-
493
- async def connect(self, timeout: float = 6.0) -> bool:
494
- if not _WS_LIB_AVAILABLE:
495
- return False
496
- # جرّب عدة مرات لأن Chromium قد يحتاج لحظة بعد الإقلاع قبل فتح منفذ CDP
497
- deadline = time.time() + timeout
498
- tabs = None
499
- while time.time() < deadline:
500
- try:
501
- import urllib.request
502
- with urllib.request.urlopen(
503
- f"http://127.0.0.1:{self.port}/json/list", timeout=1.5
504
- ) as r:
505
- tabs = json.loads(r.read())
506
- break
507
- except Exception:
508
- await asyncio.sleep(0.25)
509
- if tabs is None:
510
- print(f"[CDP:{self.port}] ❌ Chromium لا يستجيب على منفذ CDP")
511
- return False
512
-
513
- ws_url = None
514
- for t in tabs:
515
- if t.get("type") == "page":
516
- ws_url = t.get("webSocketDebuggerUrl")
517
- self._target_id = t.get("id")
518
- break
519
- if not ws_url:
520
- print(f"[CDP:{self.port}] ❌ لا يوجد تبويب صفحة متاح")
521
- return False
522
-
523
- try:
524
- self._ws = await asyncio.wait_for(
525
- ws_lib.connect(ws_url, ping_interval=15, ping_timeout=10, max_size=64 * 1024 * 1024),
526
- timeout=timeout,
527
- )
528
- except Exception as e:
529
- print(f"[CDP:{self.port}] ❌ فشل اتصال WebSocket: {e}")
530
- return False
531
-
532
- self._recv_task = asyncio.create_task(self._recv_loop())
533
-
534
- # فعّل النطاقات المطلوبة
535
- await self.send("Page.enable", timeout=5.0)
536
- await self.send("Runtime.enable", timeout=5.0)
537
- await self.send("DOM.enable", timeout=5.0)
538
- # اضبط حجم الشاشة الافتراضي عبر Emulation (headless بدون نافذة فعلية،
539
- # هذا يحدد أبعاد الرندر الداخلي)
540
- await self.send("Emulation.setDeviceMetricsOverride", {
541
- "width": SCREEN_W, "height": SCREEN_H,
542
- "deviceScaleFactor": 1, "mobile": False,
543
- }, timeout=5.0)
544
- print(f"[CDP:{self.port}] ✅ متصل بجلسة Chromium")
545
- return True
546
-
547
- async def _recv_loop(self):
548
- try:
549
- async for raw in self._ws:
550
- try:
551
- msg = json.loads(raw)
552
- except Exception:
553
- continue
554
- mid = msg.get("id")
555
- if mid is not None and mid in self._pending:
556
- fut = self._pending.pop(mid)
557
- if not fut.done():
558
- fut.set_result(msg)
559
- except Exception:
560
- pass
561
- finally:
562
- for fut in self._pending.values():
563
- if not fut.done():
564
- fut.set_exception(ConnectionError("CDP disconnected"))
565
- self._pending.clear()
566
- self._ws = None
567
-
568
- async def send(self, method: str, params: dict = None, timeout: float = 10.0):
569
- if not self._ws:
570
- return None
571
- async with self._send_lock:
572
- self._msg_id += 1
573
- mid = self._msg_id
574
- fut = asyncio.get_event_loop().create_future()
575
- self._pending[mid] = fut
576
- try:
577
- await self._ws.send(json.dumps({"id": mid, "method": method, "params": params or {}}))
578
- return await asyncio.wait_for(fut, timeout=timeout)
579
- except Exception:
580
- self._pending.pop(mid, None)
581
- return None
582
-
583
- @property
584
- def alive(self) -> bool:
585
- return self._ws is not None
586
-
587
- async def close(self):
588
- if self._recv_task:
589
- self._recv_task.cancel()
590
- if self._ws:
591
- try:
592
- await self._ws.close()
593
- except Exception:
594
- pass
595
- self._ws = None
596
-
597
-
598
- # ════════════════════════════════════════════════════════════════
599
- # ── تشغيل/إيقاف عملية Chromium headless ────────────────────────
600
- # ════════════════════════════════════════════════════════════════
601
-
602
- def _profile_dir(user_id: str) -> str:
603
- safe = re.sub(r"[^a-zA-Z0-9_.-]", "_", user_id) or "anon"
604
- d = os.path.expanduser(f"~/.zai_chromium_profiles/{safe}")
605
- os.makedirs(d, exist_ok=True)
606
- return d
607
-
608
-
609
- def _launch_browser_process(binary: str, port: int, profile: str) -> "subprocess.Popen | None":
610
- cmd = [
611
- binary,
612
- "--headless=new", # الوضع الرسمي الحديث — لا حاجة لأي display
613
- f"--remote-debugging-port={port}",
614
- "--remote-debugging-address=127.0.0.1",
615
- "--disable-gpu",
616
- "--no-sandbox",
617
- "--disable-dev-shm-usage",
618
- "--disable-extensions",
619
- "--disable-notifications",
620
- "--disable-popup-blocking",
621
- "--disable-translate",
622
- "--disable-sync",
623
- "--disable-background-timer-throttling",
624
- "--disable-backgrounding-occluded-windows",
625
- "--disable-renderer-backgrounding",
626
- "--disable-features=Translate,BackForwardCache",
627
- "--no-first-run",
628
- "--no-default-browser-check",
629
- "--mute-audio",
630
- "--hide-scrollbars",
631
- f"--window-size={SCREEN_W},{SCREEN_H}",
632
- f"--user-data-dir={profile}",
633
- "--js-flags=--max-old-space-size=256", # سقف ذاكرة JS — يمنع تبويب ثقيل من استهلاك كل الرام
634
- "about:blank",
635
- ]
636
- try:
637
- proc = subprocess.Popen(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
638
- return proc
639
- except FileNotFoundError:
640
- return None
641
- except Exception as e:
642
- print(f"[chromium] ❌ فشل تشغيل {binary}: {e}")
643
- return None
644
-
645
-
646
- def _start_chromium(port: int, user_id: str) -> "subprocess.Popen | None":
647
- """
648
- يُشغّل متصفحاً بوضع headless=new على منفذ CDP مخصص. لا Xvfb، لا DISPLAY،
649
- لا نافذة — الرندر بالكامل داخلي (in-process) لمحرك المتصفح نفسه.
650
-
651
- ذكاء إضافي: لو المتصفح الحالي (BROWSER_BIN) فشل بالإقلاع فعلياً وقت التشغيل
652
- الحقيقي (مو وقت الفحص الأولي)، يجرّب بقية المتصفحات المرشحة تلقائياً بدل
653
- الفشل الكامل، ويحدّث BROWSER_BIN للمتصفح اللي نجح ليُستخدم مباشرة بالجلسات
654
- القادمة (بدون إعادة تجربة كل المتصفحات الفاشلة من جديد كل مرة).
655
- """
656
- global BROWSER_BIN
657
- profile = _profile_dir(user_id)
658
- try:
659
- subprocess.run(["pkill", "-9", "-f", f"[r]emote-debugging-port={port}"],
660
- capture_output=True, timeout=3)
661
- time.sleep(0.2)
662
- except Exception:
663
- pass
664
-
665
- proc = _launch_browser_process(BROWSER_BIN, port, profile)
666
- if proc is not None:
667
- print(f"[chromium] 🚀 بدأ '{BROWSER_BIN}' (PID {proc.pid}) على منفذ CDP {port} — headless=new")
668
- return proc
669
-
670
- print(f"[chromium] ⚠️ فشل '{BROWSER_BIN}' فعلياً — أجرب بقية المتصفحات المعروفة تلقائياً...")
671
- for alt in _BROWSER_CANDIDATES:
672
- if alt == BROWSER_BIN or not _binary_exists(alt):
673
- continue
674
- proc = _launch_browser_process(alt, port, profile)
675
- if proc is not None:
676
- print(f"[chromium] ✅ نجح البديل '{alt}' — سيُعتمد لبقية الجلسات من الآن")
677
- BROWSER_BIN = alt
678
- return proc
679
-
680
- print(f"[chromium] ❌ فشلت كل المتصفحات المتاحة على هذا السيرفر")
681
- return None
682
-
683
-
684
- def _kill_chromium(proc: "subprocess.Popen | None", port: int):
685
- if proc:
686
- try:
687
- proc.kill()
688
- proc.wait(timeout=3)
689
- except Exception:
690
- pass
691
- try:
692
- subprocess.run(["pkill", "-9", "-f", f"[r]emote-debugging-port={port}"],
693
- capture_output=True, timeout=3)
694
- except Exception:
695
- pass
696
-
697
-
698
- # ════════════════════════════════════════════════════════════════
699
- # ── إدارة الجلسات (مستخدم → CDPSession + Chromium process) ─────
700
- # ════════════════════════════════════════════════════════════════
701
-
702
- # user_id → {
703
- # "port": int, "proc": Popen, "cdp": CDPSession|None,
704
- # "active_ws": WebSocket|None, "created": float,
705
- # "consecutive_failures": int, "last_frame_hash": str,
706
- # "last_mouse_x": int, "last_mouse_y": int,
707
- # }
708
- _sessions: dict = {}
709
-
710
-
711
- async def get_or_create_session(user_id: str, ws: WebSocket) -> dict:
712
- with _sessions_lock:
713
- sess = _sessions.get(user_id)
714
- if sess:
715
- sess["active_ws"] = ws
716
- print(f"[session] 🔁 إعادة اتصال '{user_id}' على منفذ {sess['port']}")
717
- return sess
718
-
719
- if len(_sessions) >= MAX_SESSIONS:
720
- # أعد استخدام أقدم جلسة غير متصلة بدل رفض المستخدم الجديد
721
- idle = [(uid, s) for uid, s in _sessions.items() if not s.get("active_ws")]
722
- if idle:
723
- oldest_uid = min(idle, key=lambda t: t[1]["created"])[0]
724
- old = _sessions.pop(oldest_uid)
725
- _kill_chromium(old.get("proc"), old["port"])
726
- _release_cdp_port(old["port"])
727
- print(f"[session] ♻️ أُزيلت جلسة خاملة قديمة '{oldest_uid}' لإفساح المجال")
728
-
729
- port = _alloc_cdp_port()
730
- sess = {
731
- "user_id": user_id,
732
- "port": port,
733
- "proc": None,
734
- "cdp": None,
735
- "active_ws": ws,
736
- "created": time.time(),
737
- "consecutive_failures": 0,
738
- "last_frame_hash": "",
739
- "last_mouse_x": SCREEN_W // 2,
740
- "last_mouse_y": SCREEN_H // 2,
741
- "shot_lock": asyncio.Lock(),
742
- "engine": "chromium", # "chromium" (افتراضي، عبر CDP) أو "camoufox" (مضاد للكشف، عبر Playwright)
743
- }
744
- _sessions[user_id] = sess
745
- print(f"[session] ✅ مستخدم جديد '{user_id}' → منفذ CDP {port}")
746
- return sess
747
-
748
-
749
- async def ensure_browser_running(sess: dict) -> bool:
750
- """يتأكد أن Chromium + اتصال CDP يعملان لهذه الجلسة. يُشغّلهما إذا لزم."""
751
- if sess.get("cdp") and sess["cdp"].alive:
752
- return True
753
-
754
- if not sess.get("proc") or sess["proc"].poll() is not None:
755
- proc = await asyncio.to_thread(_start_chromium, sess["port"], sess["user_id"])
756
- sess["proc"] = proc
757
- if proc is None:
758
- return False
759
-
760
- cdp = CDPSession(sess["port"])
761
- ok = await cdp.connect(timeout=8.0)
762
- if ok:
763
- sess["cdp"] = cdp
764
- return True
765
- return False
766
-
767
-
768
- async def reset_session(user_id: str) -> bool:
769
- """يُعيد تشغيل Chromium بالكامل لهذا المستخدم — الإصلاح الشامل الوحيد المطلوب الآن،
770
- بما أنه لا يوجد Xvfb أو ملفات جلسة X منفصلة يجب تنظيفها."""
771
- with _sessions_lock:
772
- sess = _sessions.get(user_id)
773
- if not sess:
774
- return False
775
- proc, port = sess.get("proc"), sess["port"]
776
- old_cdp = sess.get("cdp")
777
-
778
- if old_cdp:
779
- await old_cdp.close()
780
- await asyncio.to_thread(_kill_chromium, proc, port)
781
-
782
- new_proc = await asyncio.to_thread(_start_chromium, port, user_id)
783
- new_cdp = CDPSession(port)
784
- ok = await new_cdp.connect(timeout=8.0) if new_proc else False
785
-
786
- with _sessions_lock:
787
- if user_id in _sessions:
788
- _sessions[user_id]["proc"] = new_proc
789
- _sessions[user_id]["cdp"] = new_cdp if ok else None
790
- _sessions[user_id]["consecutive_failures"] = 0
791
- _sessions[user_id]["last_frame_hash"] = ""
792
- print(f"[reset] {'✅' if ok else '❌'} إعادة ضبط '{user_id}' على منفذ {port}")
793
- return ok
794
-
795
-
796
- async def destroy_session_ws(user_id: str, ws: WebSocket):
797
- """عند انقطاع WebSocket — نُبقي Chromium شغالاً (الجلسة محفوظة) وفقط نزيل الاتصال."""
798
- with _sessions_lock:
799
- sess = _sessions.get(user_id)
800
- if sess and sess.get("active_ws") is ws:
801
- sess["active_ws"] = None
802
- print(f"[session] 📴 '{user_id}' قطع الاتصال (الجلسة محفوظة)")
803
-
804
-
805
- async def destroy_session_full(user_id: str):
806
- with _sessions_lock:
807
- sess = _sessions.pop(user_id, None)
808
- if sess:
809
- if sess.get("cdp"):
810
- await sess["cdp"].close()
811
- await asyncio.to_thread(_kill_chromium, sess.get("proc"), sess["port"])
812
- _release_cdp_port(sess["port"])
813
- await destroy_camoufox_session(user_id)
814
-
815
-
816
- # ════════════════════════════════════════════════════════════════
817
- # ── لقطة الشاشة — عبر CDP مباشرة (بدون subprocess خارجي) ────────
818
- # ════════════════════════════════════════════════════════════════
819
-
820
- async def cdp_screenshot(sess: dict, quality: int = 75) -> "tuple[str, int, int] | None":
821
- """
822
- يلتقط لقطة شاشة عبر Page.captureScreenshot — أمر CDP واحد يرجع JPEG
823
- base64 جاهز مباشرة من محرك الرندر الداخلي لـ Chromium. لا يوجد X server
824
- يمكن أن "يتجمد"، لا حاجة لفحص "هل الصورة سوداء"، ولا عملية subprocess
825
- خارجية (import/xwd) قد تفشل بسبب أدوات مفقودة على السيرفر.
826
- يُعيد (base64_jpeg, width, height) أو None عند الفشل.
827
- """
828
- cdp = sess.get("cdp")
829
- if not cdp or not cdp.alive:
830
- return None
831
- result = await cdp.send("Page.captureScreenshot", {
832
- "format": "jpeg", "quality": quality, "fromSurface": True, "captureBeyondViewport": False,
833
- }, timeout=8.0)
834
- if not result:
835
- return None
836
- data = result.get("result", {}).get("data")
837
- if not data:
838
- return None
839
- return data, SCREEN_W, SCREEN_H
840
-
841
-
842
- def _draw_mouse_marker_on_jpeg(b64_jpeg: str, mx: int, my: int) -> str:
843
- """يرسم علامة صغيرة لموقع الفأرة فوق الصورة (مطلوبة بصرياً للذكاء الاصطناعي
844
- ليرى أين المؤشر). العملية خفيفة (رسم فقط، بدون resize) فتُبقي زمن كل لقطة منخفضاً."""
845
- try:
846
- from PIL import Image, ImageDraw
847
- import io as _io
848
- raw = base64.b64decode(b64_jpeg)
849
- img = Image.open(_io.BytesIO(raw)).convert("RGB")
850
- draw = ImageDraw.Draw(img)
851
- r = 9
852
- draw.ellipse([(mx - r, my - r), (mx + r, my + r)], outline=(255, 60, 60), width=2)
853
- draw.line([(mx - 14, my), (mx + 14, my)], fill=(255, 60, 60), width=1)
854
- draw.line([(mx, my - 14), (mx, my + 14)], fill=(255, 60, 60), width=1)
855
- buf = _io.BytesIO()
856
- img.save(buf, format="JPEG", quality=80, optimize=True)
857
- return base64.b64encode(buf.getvalue()).decode()
858
- except Exception:
859
- return b64_jpeg # لو فشل الرسم لأي سبب، أعد الصورة الأصلية بدل الفشل الكامل
860
-
861
-
862
- def _grid_variant(b64_jpeg: str, grid_step: int, color: tuple, label_every: int) -> str:
863
- """
864
- ينتج نسخة من الصورة مع شبكة إحداثيات مرسومة فوقها — تساعد الذكاء الاصطناعي
865
- على تحديد إحداثيات دقيقة للنقر. نفس فكرة v13 لكن مبنية فوق JPEG الجاهز من
866
- CDP مباشرة بدل إعادة الرسم من raw pixels.
867
- """
868
- try:
869
- from PIL import Image, ImageDraw
870
- import io as _io
871
- raw = base64.b64decode(b64_jpeg)
872
- img = Image.open(_io.BytesIO(raw)).convert("RGB")
873
- draw = ImageDraw.Draw(img, "RGBA")
874
- w, h = img.size
875
- major = (*color, 130)
876
- minor = (*color, 40)
877
- x = grid_step
878
- while x < w:
879
- is_major = x % label_every == 0
880
- draw.line([(x, 0), (x, h)], fill=major if is_major else minor, width=1)
881
- if is_major:
882
- draw.rectangle([(x + 1, 2), (x + 34, 15)], fill=(0, 0, 0, 175))
883
- draw.text((x + 2, 3), str(x), fill=color)
884
- x += grid_step
885
- y = grid_step
886
- while y < h:
887
- is_major = y % label_every == 0
888
- draw.line([(0, y), (w, y)], fill=major if is_major else minor, width=1)
889
- if is_major:
890
- draw.rectangle([(2, y + 1), (38, y + 14)], fill=(0, 0, 0, 175))
891
- draw.text((3, y + 2), str(y), fill=color)
892
- y += grid_step
893
- final = img.convert("RGB")
894
- buf = _io.BytesIO()
895
- final.save(buf, format="JPEG", quality=78, optimize=True)
896
- return base64.b64encode(buf.getvalue()).decode()
897
- except Exception:
898
- return b64_jpeg
899
-
900
-
901
- async def capture_full(sess: dict, quality: int = 75) -> dict:
902
- """
903
- يلتقط لقطة واحدة وينتج منها: نسخة نظيفة + نسخة بعلامة الفأرة + شبكتان
904
- إحداثيات (عادية ودقيقة) — بنفس تنسيق حقول الرد الذي تتوقعه الواجهة الأمامية
905
- (data, data_grid, data_grid2, data_grid3, width, height, mouse_x, mouse_y).
906
-
907
- يعمل مع كلا المحركين حسب sess["engine"]:
908
- "chromium" (افتراضي) → عبر CDP مباشرة (cdp_screenshot)
909
- "camoufox" → عبر Playwright screenshot (أبطأ قليلاً لكن مضاد للكشف)
910
- """
911
- if sess.get("engine") == "camoufox":
912
- cam = await get_camoufox_session(sess["user_id"])
913
- if not cam:
914
- return {"data": "", "data_grid": "", "data_grid2": "", "data_grid3": "",
915
- "width": SCREEN_W, "height": SCREEN_H,
916
- "mouse_x": sess.get("last_mouse_x", 0), "mouse_y": sess.get("last_mouse_y", 0),
917
- "is_placeholder": True}
918
- raw_b64 = await cam.screenshot_b64()
919
- if not raw_b64:
920
- return {"data": "", "data_grid": "", "data_grid2": "", "data_grid3": "",
921
- "width": SCREEN_W, "height": SCREEN_H,
922
- "mouse_x": sess.get("last_mouse_x", 0), "mouse_y": sess.get("last_mouse_y", 0),
923
- "is_placeholder": True}
924
- w, h = SCREEN_W, SCREEN_H
925
- mx, my = sess.get("last_mouse_x", w // 2), sess.get("last_mouse_y", h // 2)
926
-
927
- def _build_cam():
928
- clean = _draw_mouse_marker_on_jpeg(raw_b64, mx, my)
929
- grid1 = _grid_variant(clean, 50, (0, 255, 180), 100)
930
- grid2 = _grid_variant(clean, 20, (255, 60, 60), 60)
931
- return clean, grid1, grid2
932
-
933
- clean, grid1, grid2 = await asyncio.to_thread(_build_cam)
934
- return {"data": clean, "data_grid": grid1, "data_grid2": grid2, "data_grid3": grid2,
935
- "width": w, "height": h, "mouse_x": mx, "mouse_y": my, "is_placeholder": False}
936
-
937
- shot = await cdp_screenshot(sess, quality)
938
- if not shot:
939
- return {"data": "", "data_grid": "", "data_grid2": "", "data_grid3": "",
940
- "width": SCREEN_W, "height": SCREEN_H,
941
- "mouse_x": sess.get("last_mouse_x", 0), "mouse_y": sess.get("last_mouse_y", 0),
942
- "is_placeholder": True}
943
-
944
- raw_b64, w, h = shot
945
- mx, my = sess.get("last_mouse_x", w // 2), sess.get("last_mouse_y", h // 2)
946
-
947
- def _build():
948
- clean = _draw_mouse_marker_on_jpeg(raw_b64, mx, my)
949
- grid1 = _grid_variant(clean, 50, (0, 255, 180), 100)
950
- grid2 = _grid_variant(clean, 20, (255, 60, 60), 60)
951
- return clean, grid1, grid2
952
-
953
- clean, grid1, grid2 = await asyncio.to_thread(_build)
954
- return {
955
- "data": clean, "data_grid": grid1, "data_grid2": grid2, "data_grid3": grid2,
956
- "width": w, "height": h, "mouse_x": mx, "mouse_y": my,
957
- "is_placeholder": False,
958
- }
959
-
960
-
961
- def _frame_hash(data: str) -> str:
962
- return hashlib.md5(data.encode()).hexdigest()
963
-
964
-
965
- # ════════════════════════════════════════════════════════════════
966
- # ── فأرة/كيبورد — عبر CDP Input domain (بدون xdotool/X server) ──
967
- # ════════════════════════════════════════════════════════════════
968
-
969
- async def cdp_mouse_move(sess: dict, x: int, y: int):
970
- cdp = sess.get("cdp")
971
- if not cdp or not cdp.alive:
972
- return
973
- await cdp.send("Input.dispatchMouseEvent", {
974
- "type": "mouseMoved", "x": x, "y": y,
975
- }, timeout=4.0)
976
- sess["last_mouse_x"], sess["last_mouse_y"] = x, y
977
-
978
-
979
- async def cdp_mouse_click(sess: dict, x: int, y: int, button: str = "left", double: bool = False):
980
- cdp = sess.get("cdp")
981
- if not cdp or not cdp.alive:
982
- return
983
- await cdp_mouse_move(sess, x, y)
984
- click_count = 2 if double else 1
985
- await cdp.send("Input.dispatchMouseEvent", {
986
- "type": "mousePressed", "x": x, "y": y, "button": button, "clickCount": click_count,
987
- }, timeout=4.0)
988
- await asyncio.sleep(0.04)
989
- await cdp.send("Input.dispatchMouseEvent", {
990
- "type": "mouseReleased", "x": x, "y": y, "button": button, "clickCount": click_count,
991
- }, timeout=4.0)
992
-
993
-
994
- async def cdp_mouse_drag(sess: dict, x1: int, y1: int, x2: int, y2: int, steps: int = 8):
995
- cdp = sess.get("cdp")
996
- if not cdp or not cdp.alive:
997
- return
998
- await cdp_mouse_move(sess, x1, y1)
999
- await cdp.send("Input.dispatchMouseEvent", {
1000
- "type": "mousePressed", "x": x1, "y": y1, "button": "left", "clickCount": 1,
1001
- }, timeout=4.0)
1002
- for i in range(1, steps + 1):
1003
- ix = x1 + (x2 - x1) * i // steps
1004
- iy = y1 + (y2 - y1) * i // steps
1005
- await cdp.send("Input.dispatchMouseEvent", {
1006
- "type": "mouseMoved", "x": ix, "y": iy, "button": "left",
1007
- }, timeout=3.0)
1008
- await asyncio.sleep(0.02)
1009
- await cdp.send("Input.dispatchMouseEvent", {
1010
- "type": "mouseReleased", "x": x2, "y": y2, "button": "left", "clickCount": 1,
1011
- }, timeout=4.0)
1012
- sess["last_mouse_x"], sess["last_mouse_y"] = x2, y2
1013
-
1014
-
1015
- async def cdp_scroll(sess: dict, x: int, y: int, delta_y: int):
1016
- cdp = sess.get("cdp")
1017
- if not cdp or not cdp.alive:
1018
- return
1019
- await cdp.send("Input.dispatchMouseEvent", {
1020
- "type": "mouseWheel", "x": x, "y": y, "deltaX": 0, "deltaY": delta_y,
1021
- }, timeout=4.0)
1022
-
1023
-
1024
- # خريطة أسماء مفاتيح شائعة → أكواد CDP (windowsVirtualKeyCode + key)
1025
- _KEY_MAP = {
1026
- "Return": (13, "Enter"), "Enter": (13, "Enter"),
1027
- "Tab": (9, "Tab"), "Escape": (27, "Escape"), "BackSpace": (8, "Backspace"),
1028
- "Delete": (46, "Delete"), "Left": (37, "ArrowLeft"), "Right": (39, "ArrowRight"),
1029
- "Up": (38, "ArrowUp"), "Down": (40, "ArrowDown"), "Home": (36, "Home"), "End": (35, "End"),
1030
- "space": (32, " "), "F5": (116, "F5"),
1031
- }
1032
-
1033
-
1034
- async def cdp_key_press(sess: dict, key_name: str):
1035
- cdp = sess.get("cdp")
1036
- if not cdp or not cdp.alive:
1037
- return
1038
- code, key = _KEY_MAP.get(key_name, (0, key_name))
1039
- params = {"type": "keyDown", "key": key}
1040
- if code:
1041
- params["windowsVirtualKeyCode"] = code
1042
- params["nativeVirtualKeyCode"] = code
1043
- await cdp.send("Input.dispatchKeyEvent", params, timeout=4.0)
1044
- params["type"] = "keyUp"
1045
- await cdp.send("Input.dispatchKeyEvent", params, timeout=4.0)
1046
-
1047
-
1048
- async def cdp_hotkey(sess: dict, keys: list):
1049
- """اختصار متعدد المفاتيح مثل ['ctrl','l'] أو ['alt','Left']."""
1050
- cdp = sess.get("cdp")
1051
- if not cdp or not cdp.alive:
1052
- return
1053
- modifiers = 0
1054
- mod_map = {"alt": 1, "ctrl": 2, "control": 2, "meta": 4, "shift": 8}
1055
- plain_keys = []
1056
- for k in keys:
1057
- kl = k.lower()
1058
- if kl in mod_map:
1059
- modifiers |= mod_map[kl]
1060
- else:
1061
- plain_keys.append(k)
1062
- for k in plain_keys:
1063
- code, key = _KEY_MAP.get(k, (ord(k[0].upper()) if len(k) == 1 else 0, k))
1064
- await cdp.send("Input.dispatchKeyEvent", {
1065
- "type": "rawKeyDown", "key": key, "modifiers": modifiers,
1066
- "windowsVirtualKeyCode": code, "nativeVirtualKeyCode": code,
1067
- }, timeout=4.0)
1068
- await cdp.send("Input.dispatchKeyEvent", {
1069
- "type": "keyUp", "key": key, "modifiers": modifiers,
1070
- "windowsVirtualKeyCode": code, "nativeVirtualKeyCode": code,
1071
- }, timeout=4.0)
1072
-
1073
-
1074
- async def cdp_type_text(sess: dict, text: str):
1075
- """
1076
- يكتب نصاً عبر Input.insertText — يدعم كل اللغات (عربي/إنجليزي/فرنسي)
1077
- بشكل أصلي عبر CDP نفسه، بدون حاجة لـ xclip أو حيلة clipboard+paste
1078
- التي كانت ضرورية سابقاً بسبب قيود xdotool مع النصوص غير اللاتينية.
1079
- """
1080
- cdp = sess.get("cdp")
1081
- if not cdp or not cdp.alive:
1082
- return
1083
- await cdp.send("Input.insertText", {"text": text}, timeout=6.0)
1084
-
1085
-
1086
- async def cdp_navigate(sess: dict, url: str) -> bool:
1087
- cdp = sess.get("cdp")
1088
- if not cdp or not cdp.alive:
1089
- return False
1090
- result = await cdp.send("Page.navigate", {"url": url}, timeout=15.0)
1091
- return bool(result and "error" not in result.get("result", {}))
1092
-
1093
-
1094
- async def cdp_clipboard_write(sess: dict, text: str):
1095
- """ينسخ نصاً لحافظة afterward-paste داخلية عبر متغيّر JS بسيط (بديل خفيف
1096
- لـ xclip، لأنه لا يوجد X server هنا أصلاً تُبنى عليه حافظة نظام حقيقية)."""
1097
- cdp = sess.get("cdp")
1098
- if not cdp or not cdp.alive:
1099
- return
1100
- js = f"window.__zclip = {json.dumps(text)};"
1101
- await cdp.send("Runtime.evaluate", {"expression": js}, timeout=4.0)
1102
-
1103
-
1104
- async def cdp_clipboard_read(sess: dict) -> str:
1105
- cdp = sess.get("cdp")
1106
- if not cdp or not cdp.alive:
1107
- return ""
1108
- result = await cdp.send("Runtime.evaluate", {
1109
- "expression": "window.__zclip || ''", "returnByValue": True,
1110
- }, timeout=4.0)
1111
- if not result:
1112
- return ""
1113
- return result.get("result", {}).get("result", {}).get("value", "") or ""
1114
-
1115
-
1116
- async def cdp_get_screen_info(sess: dict) -> dict:
1117
- return {"width": SCREEN_W, "height": SCREEN_H,
1118
- "mouse_x": sess.get("last_mouse_x", 0), "mouse_y": sess.get("last_mouse_y", 0)}
1119
-
1120
-
1121
- # ════════════════════════════════════════════════════════════════
1122
- # ── SafeSearch — نفس منطق v13 محفوظاً كما هو (يعمل بشكل جيد) ────
1123
- # ════════════════════════════════════════════════════════════════
1124
-
1125
- _BING_RE = re.compile(r"https?://(?:www\.)?bing\.com[^\s'\"]*")
1126
- _DDG_RE = re.compile(r"https?://(?:www\.)?duckduckgo\.com[^\s'\"]*")
1127
- _GOOG_RE = re.compile(r"https?://(?:www\.)?google\.[a-z.]+[^\s'\"]*")
1128
-
1129
-
1130
- def _safe_search(text: str) -> str:
1131
- def _bing(m):
1132
- u = m.group(0)
1133
- return re.sub(r"adlt=\w+", "adlt=strict", u) if "adlt=" in u else u + ("&" if "?" in u else "?") + "adlt=strict"
1134
-
1135
- def _ddg(m):
1136
- u = m.group(0)
1137
- return re.sub(r"kp=\d", "kp=1", u) if "kp=" in u else u + ("&" if "?" in u else "?") + "kp=1"
1138
-
1139
- def _goog(m):
1140
- u = m.group(0)
1141
- return re.sub(r"safe=\w+", "safe=strict", u) if "safe=" in u else u + ("&" if "?" in u else "?") + "safe=strict"
1142
-
1143
- return _GOOG_RE.sub(_goog, _DDG_RE.sub(_ddg, _BING_RE.sub(_bing, text)))
1144
-
1145
-
1146
- # ════════════════════════════════════════════════════════════════
1147
- # ── Terminal — تنفيذ أوامر bash (منفصل تماماً عن Chromium) ──────
1148
- # ════════════════════════════════════════════════════════════════
1149
-
1150
- _terminal_sem = asyncio.Semaphore(6)
1151
- _PKILL_RE = re.compile(r"\b(pkill|killall)\s+(-9\s+)?-f\s+(['\"]?)([a-zA-Z0-9_./-]+)\3")
1152
-
1153
-
1154
- def _sanitize_pkill(cmd: str) -> str:
1155
- def _fix(m):
1156
- tool, d9, _q, p = m.group(1), m.group(2) or "", m.group(3), m.group(4)
1157
- sp = f"[{p[0]}]{p[1:]}" if len(p) > 1 else p
1158
- return f"{tool} {d9}-f '{sp}'"
1159
- return _PKILL_RE.sub(_fix, cmd)
1160
-
1161
-
1162
- async def run_cmd(cmd: str, timeout: int = 60) -> dict:
1163
- cmd = _sanitize_pkill(_safe_search(cmd))
1164
- async with _terminal_sem:
1165
- env = {**os.environ, "PYTHONIOENCODING": "utf-8", "LANG": "en_US.UTF-8"}
1166
-
1167
- def _exec():
1168
- try:
1169
- r = subprocess.run(cmd, shell=True, capture_output=True, text=True,
1170
- timeout=timeout, env=env, executable="/bin/bash")
1171
- return {"stdout": r.stdout[-15000:], "stderr": r.stderr[-3000:], "returncode": r.returncode}
1172
- except subprocess.TimeoutExpired:
1173
- return {"stdout": "", "stderr": f"⏱️ Timeout {timeout}s", "returncode": -1}
1174
- except Exception as e:
1175
- return {"stdout": "", "stderr": str(e), "returncode": -1}
1176
-
1177
- return await asyncio.to_thread(_exec)
1178
-
1179
-
1180
- def _search_sources(query: str) -> list:
1181
- q = urllib.parse.quote_plus(query)
1182
- return [
1183
- {"name": "DuckDuckGo Instant",
1184
- "cmd": f"curl -s --max-time 15 'https://api.duckduckgo.com/?q={q}&format=json&no_html=1&skip_disambig=1' | python3 -c \"import sys,json;d=json.load(sys.stdin);a=d.get('AbstractText','');r=d.get('RelatedTopics',[]);print('ANS:',a or 'none');[print('-',x.get('Text','')[:200]) for x in r[:6] if isinstance(x,dict)]\""},
1185
- {"name": "Wikipedia EN",
1186
- "cmd": f"curl -s --max-time 12 'https://en.wikipedia.org/api/rest_v1/page/summary/{q}' | python3 -c \"import sys,json;d=json.load(sys.stdin);print(d.get('title','')+'\\n'+d.get('extract','')[:1200])\""},
1187
- {"name": "DuckDuckGo HTML",
1188
- "cmd": f"curl -sL --max-time 15 -H 'User-Agent: Mozilla/5.0' 'https://html.duckduckgo.com/html/?q={q}' | python3 -c \"import sys,re;h=sys.stdin.read();s=re.findall(r'class=.result__snippet[^>]*>(.*?)</a>',h,re.DOTALL);clean=lambda x:re.sub('<[^>]+>','',x).strip();[print(str(i+1)+'. '+clean(x)[:200]) for i,x in enumerate(s[:7])]\""},
1189
- {"name": "HackerNews",
1190
- "cmd": f"curl -s --max-time 12 'https://hn.algolia.com/api/v1/search?query={q}&hitsPerPage=6&tags=story' | python3 -c \"import sys,json;d=json.load(sys.stdin);[print(str(i+1)+'. '+h.get('title','')+' Pts:'+str(h.get('points',0))) for i,h in enumerate(d.get('hits',[])[:5])]\""},
1191
- {"name": "Reddit",
1192
- "cmd": f"curl -sL --max-time 12 -H 'Accept: application/json' 'https://www.reddit.com/search.json?q={q}&sort=new&limit=6' | python3 -c \"import sys,json;d=json.load(sys.stdin);[print(str(i+1)+'. '+p['data'].get('title','')[:160]) for i,p in enumerate(d.get('data',{{}}).get('children',[])[:5])]\""},
1193
- ]
1194
-
1195
-
1196
- def _result_empty(s: str) -> bool:
1197
- if not s or len(s.strip()) < 15:
1198
- return True
1199
- return "ans: none" in s.lower()
1200
-
1201
-
1202
- # ════════════════════════════════════════════════════════════════
1203
- # ── Brave Search API — قناة البحث الرسمية المصرَّح بها ──────────
1204
- # ════════════════════════════════════════════════════════════════
1205
- # على عكس زيارة duckduckgo.com/google.com كموقع فعلي عبر المتصفح (اللي يواجه
1206
- # كابتشا لأن هذي المحركات تكره الطلبات الآلية)، Brave Search API مصمم أصلاً
1207
- # ليُستخدم برمجياً — بدون كابتشا إطلاقاً، لأنه مرخّص لهذا الغرض تحديداً.
1208
- # هذا بالضبط أسلوب Manus: بحث نظيف عبر API/سطر أوامر يرجع نتائج نصية مباشرة،
1209
- # فتح متصفح فعلي يُحفظ فقط لما يحتاج المستخدم "تصفح موقع بعينه بصرياً".
1210
- #
1211
- # التفعيل: عيّن متغيّر البيئة BRAVE_API_KEY بمفتاحك من
1212
- # https://api-dashboard.search.brave.com (فيه tier مجاني — 2000 استعلام/شهر).
1213
-
1214
- BRAVE_API_KEY = os.environ.get("BRAVE_API_KEY", "").strip()
1215
- BRAVE_ENDPOINT = "https://api.search.brave.com/res/v1/web/search"
1216
-
1217
-
1218
- async def brave_search(query: str, count: int = 8) -> dict:
1219
- """
1220
- يستدعي Brave Search API مباشرة (بدون متصفح، بدون كابتشا). يُعيد نتائج
1221
- منسّقة نصياً بنفس شكل مخرجات run_cmd العادية، عشان تندمج بسلاسة مع بقية
1222
- منطق الترمنال والفرونت إند بدون أي تعديل إضافي مطلوب هناك.
1223
- """
1224
- if not BRAVE_API_KEY:
1225
- return {"stdout": "", "stderr": "BRAVE_API_KEY غير مُعرَّف — راجع الإعدادات", "returncode": -1}
1226
-
1227
- def _fetch():
1228
- import urllib.request
1229
- import urllib.error
1230
- url = f"{BRAVE_ENDPOINT}?q={urllib.parse.quote_plus(query)}&count={min(count, 20)}&safesearch=moderate"
1231
- req = urllib.request.Request(url, headers={
1232
- "Accept": "application/json",
1233
- "Accept-Encoding": "gzip",
1234
- "X-Subscription-Token": BRAVE_API_KEY,
1235
- })
1236
- try:
1237
- with urllib.request.urlopen(req, timeout=15) as r:
1238
- raw = r.read()
1239
- if r.info().get("Content-Encoding") == "gzip":
1240
- import gzip
1241
- raw = gzip.decompress(raw)
1242
- return json.loads(raw), None
1243
- except urllib.error.HTTPError as e:
1244
- body = e.read().decode(errors="ignore")[:300]
1245
- return None, f"HTTP {e.code}: {body}"
1246
- except Exception as e:
1247
- return None, str(e)
1248
-
1249
- data, err = await asyncio.to_thread(_fetch)
1250
- if err:
1251
- return {"stdout": "", "stderr": f"Brave Search error: {err}", "returncode": -1}
1252
-
1253
- lines = []
1254
- # الإجابة السريعة (infobox) إن وُجدت
1255
- infobox = data.get("infobox", {}) or {}
1256
- if infobox.get("long_desc") or infobox.get("description"):
1257
- lines.append("ANS: " + (infobox.get("long_desc") or infobox.get("description", ""))[:400])
1258
-
1259
- web_results = (data.get("web", {}) or {}).get("results", []) or []
1260
- for i, r in enumerate(web_results[:count], 1):
1261
- title = r.get("title", "")
1262
- desc = re.sub(r"<[^>]+>", "", r.get("description", ""))
1263
- url = r.get("url", "")
1264
- lines.append(f"{i}. {title}\n {desc[:220]}\n {url}")
1265
-
1266
- if not lines:
1267
- return {"stdout": "", "stderr": "لا توجد نتائج من Brave Search لهذا الاستعلام", "returncode": 0}
1268
-
1269
- return {"stdout": "\n".join(lines)[:15000], "stderr": "", "returncode": 0}
1270
-
1271
-
1272
- # نمط يلتقط أمر بحث "زائف" مخصص يُرسله الذكاء الاصطناعي عبر أداة terminal
1273
- # بصيغة بسيطة: search: نص الاستعلام (أو search "نص الاستعلام")
1274
- _SEARCH_CMD_RE = re.compile(r"^\s*search\s*:?\s*[\"']?(.+?)[\"']?\s*$", re.IGNORECASE)
1275
-
1276
-
1277
- async def run_cmd_smart(cmd: str, timeout: int = 60) -> dict:
1278
- # ── أولوية قصوى: أمر بحث صريح "search: ..." → Brave Search API مباشرة ──
1279
- m_search = _SEARCH_CMD_RE.match(cmd)
1280
- if m_search and "curl" not in cmd and "http" not in cmd:
1281
- query = m_search.group(1).strip()
1282
- if BRAVE_API_KEY:
1283
- res = await brave_search(query)
1284
- if res["returncode"] == 0 and not _result_empty(res["stdout"]):
1285
- return res
1286
- # فشل Brave (مفتاح خاطئ/حصة منتهية) → استمر بالخطة البديلة أدناه
1287
- # لا يوجد مفتاح Brave أو فشل الطلب → استخدم مصادر API المجانية الأخرى
1288
- return await _fallback_search_sources(query)
1289
-
1290
- res = await run_cmd(cmd, timeout)
1291
- if res["returncode"] == 0 and not _result_empty(res["stdout"]):
1292
- return res
1293
- is_search = "curl" in cmd and any(x in cmd for x in ["search", "duckduck", "bing", "google", "wikipedia", "reddit"])
1294
- if not is_search:
1295
- return res
1296
- m = re.search(r"[?&]q=([^&'\"\s]+)", cmd)
1297
- query = urllib.parse.unquote(m.group(1).replace("+", " ")).strip() if m else ""
1298
- if len(query) < 3:
1299
- return res
1300
- return await _fallback_search_sources(query, prior_result=res)
1301
-
1302
-
1303
- async def _fallback_search_sources(query: str, prior_result: dict = None) -> dict:
1304
- """يجرب Brave أولاً (لو متاح)، ثم مصادر API المجانية الأخرى (DuckDuckGo
1305
- Instant Answer, Wikipedia, HackerNews, Reddit) — كل هذي APIs رسمية
1306
- ومصرَّح باستخدامها آلياً، لا تحتاج فتح متصفح ولا تواجه كابتشا إطلاقاً."""
1307
- if BRAVE_API_KEY:
1308
- res = await brave_search(query)
1309
- if res["returncode"] == 0 and not _result_empty(res["stdout"]):
1310
- return res
1311
-
1312
- results = []
1313
- for src in _search_sources(query):
1314
- r2 = await run_cmd(src["cmd"], 20)
1315
- if not _result_empty(r2["stdout"]):
1316
- results.append(f"[{src['name']}]\n{r2['stdout']}")
1317
- if len(results) >= 2:
1318
- break
1319
- if results:
1320
- return {"stdout": "\n\n".join(results)[:15000], "stderr": "", "returncode": 0}
1321
- return prior_result or {"stdout": "", "stderr": "لم يُعثر على نتائج من أي مصدر", "returncode": -1}
1322
-
1323
-
1324
- # ════════════════════════════════════════════════════════════════
1325
- # ── FastAPI App ───────────────────────────────────────────────
1326
- # ════════════════════════════════════════════════════════════════
1327
-
1328
- app = FastAPI(title="Z-Computer-Mode v20 — Headless-Native")
1329
- app.add_middleware(CORSMiddleware, allow_origins=["*"], allow_credentials=True,
1330
- allow_methods=["*"], allow_headers=["*"])
1331
-
1332
-
1333
- @app.get("/", response_class=HTMLResponse)
1334
- async def root():
1335
- with _sessions_lock:
1336
- n = len(_sessions)
1337
- rows = "".join(
1338
- f"<tr><td>{uid[:30]}</td><td>{s['port']}</td>"
1339
- f"<td>{'🟢 متصل' if s.get('active_ws') else '⚫ غير متصل'}</td></tr>"
1340
- for uid, s in _sessions.items()
1341
- )
1342
- return f"""<!DOCTYPE html><html><head><meta charset="utf-8">
1343
- <title>Z Computer Mode v20</title>
1344
- <style>body{{background:#080808;color:#00d4aa;font-family:monospace;padding:40px}}
1345
- h1{{color:#4a90d9}}.ok{{color:#00ff88}}.info{{color:#888;font-size:13px}}
1346
- table{{border-collapse:collapse;width:100%}}td,th{{border:1px solid #333;padding:6px 10px;font-size:13px}}
1347
- th{{background:#1a1a2e;color:#4a90d9}}</style></head><body>
1348
- <h1>🖥️ THE Z AI — Computer Mode Server v20 (Headless-Native)</h1>
1349
- <p class="ok">✅ يعمل — بدون Xvfb، Chromium headless=new فقط</p>
1350
- <p>🌐 المتصفح المعتمد: <b>{BROWSER_BIN}</b></p>
1351
- <p>🔍 Brave Search API: <b>{'✅ مفعّل' if BRAVE_API_KEY else '❌ غير مُعرَّف (عيّن BRAVE_API_KEY)'}</b></p>
1352
- <p>🦊 Camoufox (مضاد للكشف): <b>{'✅ متاح — إرسال action: switch_engine للتفعيل' if _CAMOUFOX_LIB_AVAILABLE and CAMOUFOX_ENABLED else '❌ غير متاح'}</b></p>
1353
- <p>👥 الجلسات النشطة: <b>{n}</b> / {MAX_SESSIONS}</p>
1354
- <hr style="border-color:#333"><h3>👤 الجلسات</h3>
1355
- <table><tr><th>User ID</th><th>CDP Port</th><th>الحالة</th></tr>
1356
- {rows or '<tr><td colspan="3" style="text-align:center;color:#666">لا توجد جلسات</td></tr>'}
1357
- </table>
1358
- <hr style="border-color:#333">
1359
- <p class="info">Endpoints: /health · /ws?user_id=email (WebSocket)</p>
1360
- </body></html>"""
1361
-
1362
-
1363
- # ════════════════════════════════════════════════════════════════
1364
- # ── معالج الأوامر — بروتوكول مطابق 100% للواجهة الأمامية ────────
1365
- # ════════════════════════════════════════════════════════════════
1366
- # الأوامر المدعومة (كل ما ترسله index_plus_prompt_enhanced_v2-3.html فعلياً):
1367
- # screenshot, terminal, mouse_move, mouse_click, mouse_drag, keyboard_type,
1368
- # keyboard_hotkey, keyboard_press, scroll, clipboard_write, clipboard_read,
1369
- # paste, open_app, open_tab, close_tab, browser_back, browser_forward,
1370
- # browser_search, screen_info, reset_computer
1371
-
1372
- # عتبة أبسط بكثير من v13: بما أن لا يوجد X server منفصل يمكن أن "يتجمد" دون
1373
- # أن يتوقف Chromium نفسه، أي فشل التقاط الآن يعني عملياً أن Chromium توقف أو
1374
- # اتصال CDP انقطع — فشلة واحدة كافية للتأكد ومحاولة إعادة الاتصال مباشرة قبل
1375
- # اللجوء لإعادة تشغيل العملية بالكامل.
1376
- _RECONNECT_THRESHOLD = 1
1377
- _FULL_RESET_THRESHOLD = 3
1378
- _MAX_ROUNDS = 4
1379
-
1380
-
1381
- async def handle_action(ws: WebSocket, msg: dict, sess: dict):
1382
- action = msg.get("action", "")
1383
- data = msg.get("data", {})
1384
-
1385
- async def send(obj):
1386
- try:
1387
- await ws.send_text(json.dumps(obj, ensure_ascii=False))
1388
- except Exception:
1389
- pass
1390
-
1391
- async def do_screenshot(label: str = "", auto: bool = False):
1392
- """
1393
- يلتقط ويرسل لقطة شاشة، مع تعافي تلقائي بسيط:
1394
- فشلة 1 → أعد الاتصال بـ CDP فقط (Chromium غالباً حي، الاتصال فقط سقط)
1395
- فشلة 3 → أعد تشغيل Chromium بالكامل (reset_session)
1396
- بعد ذلك → أرسل computer_reset صراحة للعميل بدل الصمت
1397
- """
1398
- for _round in range(_MAX_ROUNDS):
1399
- ok_browser = await ensure_browser_running(sess)
1400
- if not ok_browser:
1401
- sess["consecutive_failures"] += 1
1402
- else:
1403
- async with sess["shot_lock"]:
1404
- result = await capture_full(sess, quality=75)
1405
- if result.get("data") and not result.get("is_placeholder"):
1406
- sess["consecutive_failures"] = 0
1407
- fh = _frame_hash(result["data"])
1408
- if not auto or fh != sess.get("last_frame_hash", ""):
1409
- sess["last_frame_hash"] = fh
1410
- await send({
1411
- "type": "screenshot",
1412
- "data": result["data"],
1413
- "data_grid": result.get("data_grid", ""),
1414
- "data_grid2": result.get("data_grid2", ""),
1415
- "data_grid3": result.get("data_grid3", ""),
1416
- "ts": int(time.time() * 1000),
1417
- "auto": auto, "label": label,
1418
- "screen_width": result["width"], "screen_height": result["height"],
1419
- "mouse_x": result["mouse_x"], "mouse_y": result["mouse_y"],
1420
- "has_grid": True,
1421
- })
1422
- return
1423
- sess["consecutive_failures"] += 1
1424
-
1425
- fails = sess["consecutive_failures"]
1426
- if fails >= _FULL_RESET_THRESHOLD:
1427
- await send({"type": "computer_reset",
1428
- "msg": "🔄 إعادة تشغيل تلقائية للكمبيوتر بعد فشل متكرر — لحظات ويعود طبيعياً",
1429
- "auto": True})
1430
- await reset_session(sess["user_id"])
1431
- await asyncio.sleep(1.0)
1432
- continue
1433
- elif fails >= _RECONNECT_THRESHOLD:
1434
- # أعد الاتصال بـ CDP فقط (أخف بكثير من إعادة تشغيل Chromium بالكامل)
1435
- sess["cdp"] = None
1436
- await asyncio.sleep(0.3)
1437
- continue
1438
- await asyncio.sleep(0.3)
1439
-
1440
- # استنفدنا كل المحاولات — أعلم العميل صراحة بدل الصمت الأبدي
1441
- await send({"type": "computer_reset",
1442
- "msg": "⚠️ استمرت مشكلة الالتقاط — الرجاء طلب لقطة شاشة جديدة",
1443
- "auto": True})
1444
-
1445
- def bg_shot(label: str = "", delay: float = 0.5):
1446
- async def _run():
1447
- await asyncio.sleep(delay)
1448
- await do_screenshot(label, auto=True)
1449
- asyncio.create_task(_run())
1450
-
1451
- # ── reset_computer ───────────────────────────────────────
1452
- if action == "reset_computer":
1453
- await send({"type": "ack", "action": "reset_computer", "status": "resetting"})
1454
- await reset_session(sess["user_id"])
1455
- await asyncio.sleep(1.0)
1456
- await do_screenshot("after reset")
1457
- await send({"type": "computer_reset", "msg": "✅ تم إعادة ضبط الكمبيوتر — الشاشة جديدة تماماً"})
1458
- return
1459
-
1460
- # ── screenshot ────────────────────────────────────────────
1461
- if action == "screenshot":
1462
- _task = asyncio.create_task(do_screenshot("explicit screenshot"))
1463
- def _on_done(t: asyncio.Task):
1464
- exc = t.exception() if not t.cancelled() else None
1465
- if exc:
1466
- print(f"[screenshot-task:{sess['user_id']}] ❌ {exc}")
1467
- _task.add_done_callback(_on_done)
1468
- return
1469
-
1470
- # ── terminal ─────────────────────────────────────────────
1471
- if action == "terminal":
1472
- cmd = data.get("cmd", "")
1473
- if not cmd:
1474
- await send({"type": "terminal_result", "stdout": "", "stderr": "no cmd", "returncode": -1})
1475
- return
1476
- res = await run_cmd_smart(cmd, int(data.get("timeout", 60)))
1477
- await send({"type": "terminal_result", "cmd": cmd, "stdout": res["stdout"],
1478
- "stderr": res.get("stderr", ""), "returncode": res["returncode"]})
1479
- return
1480
-
1481
- # ── يحتاج المتصفح شغالاً؟ تأكد أولاً لبقية الأوامر ──
1482
- engine = sess.get("engine", "chromium")
1483
- if engine == "chromium":
1484
- await ensure_browser_running(sess)
1485
- else:
1486
- cam = await get_camoufox_session(sess["user_id"])
1487
- if not cam:
1488
- # فشل بدء Camoufox (مكتبة غير مثبَّتة/فشل إقلاع) → ارجع تلقائياً لـ Chromium
1489
- print(f"[engine] ⚠️ فشل Camoufox لـ '{sess['user_id']}' — رجوع تلقائي لـ Chromium")
1490
- sess["engine"] = "chromium"
1491
- engine = "chromium"
1492
- await ensure_browser_running(sess)
1493
-
1494
- # ── switch_engine — تبديل محرك المتصفح للمستخدم (chromium ⇄ camoufox) ──
1495
- if action == "switch_engine":
1496
- target = data.get("engine", "chromium")
1497
- if target not in ("chromium", "camoufox"):
1498
- await send({"type": "error", "msg": f"Unknown engine: '{target}'"})
1499
- return
1500
- if target == "camoufox" and not _CAMOUFOX_LIB_AVAILABLE:
1501
- await send({"type": "error", "msg": "Camoufox غير مثبَّت على هذا السيرفر"})
1502
- return
1503
- sess["engine"] = target
1504
- sess["last_frame_hash"] = ""
1505
- await send({"type": "ack", "action": "switch_engine", "engine": target,
1506
- "msg": f"✅ تم التبديل لمحرك '{target}'"
1507
- + (" — متصفح مضاد للكشف، أبطأ قليلاً لكن يتجنب كابتشا المواقع المحمية بشدة"
1508
- if target == "camoufox" else " — المحرك الافتراضي السريع")})
1509
- bg_shot(f"after switch to {target}", delay=0.8)
1510
- return
1511
-
1512
- if action == "mouse_move":
1513
- x, y = int(data.get("x", 0)), int(data.get("y", 0))
1514
- if engine == "camoufox":
1515
- await cam.mouse_move(x, y)
1516
- else:
1517
- await cdp_mouse_move(sess, x, y)
1518
- await send({"type": "ack", "action": "mouse_move", "x": x, "y": y})
1519
-
1520
- elif action == "mouse_click":
1521
- x, y = int(data.get("x", 0)), int(data.get("y", 0))
1522
- btn = {"left": "left", "middle": "middle", "right": "right"}.get(data.get("button", "left"), "left")
1523
- double = bool(data.get("double", False))
1524
- if engine == "camoufox":
1525
- await cam.mouse_click(x, y, btn, double)
1526
- else:
1527
- await cdp_mouse_click(sess, x, y, btn, double)
1528
- await send({"type": "ack", "action": "mouse_click", "x": x, "y": y, "button": btn})
1529
- bg_shot("after click", delay=0.5)
1530
-
1531
- elif action == "mouse_drag":
1532
- x1, y1 = int(data.get("x1", 0)), int(data.get("y1", 0))
1533
- x2, y2 = int(data.get("x2", 0)), int(data.get("y2", 0))
1534
- if engine == "camoufox":
1535
- await cam.mouse_drag(x1, y1, x2, y2)
1536
- else:
1537
- await cdp_mouse_drag(sess, x1, y1, x2, y2)
1538
- await send({"type": "ack", "action": "mouse_drag"})
1539
- bg_shot("after drag", delay=0.4)
1540
-
1541
- elif action == "keyboard_type":
1542
- text = _safe_search(data.get("text", ""))
1543
- if text:
1544
- if engine == "camoufox":
1545
- await cam.type_text(text)
1546
- else:
1547
- await cdp_type_text(sess, text)
1548
- await send({"type": "ack", "action": "keyboard_type", "method": engine})
1549
-
1550
- elif action == "keyboard_hotkey":
1551
- keys = data.get("keys", [])
1552
- if keys:
1553
- if engine == "camoufox":
1554
- await cam.hotkey(keys)
1555
- else:
1556
- await cdp_hotkey(sess, keys)
1557
- await send({"type": "ack", "action": "keyboard_hotkey", "keys": keys})
1558
-
1559
- elif action == "keyboard_press":
1560
- key = data.get("key", "")
1561
- if key:
1562
- if engine == "camoufox":
1563
- await cam.key_press(key)
1564
- else:
1565
- await cdp_key_press(sess, key)
1566
- await send({"type": "ack", "action": "keyboard_press"})
1567
-
1568
- elif action == "scroll":
1569
- x, y = int(data.get("x", SCREEN_W // 2)), int(data.get("y", SCREEN_H // 2))
1570
- clicks = max(-5, min(5, int(data.get("clicks", 3))))
1571
- if engine == "camoufox":
1572
- await cam.scroll(x, y, delta_y=-clicks * 100)
1573
- else:
1574
- await cdp_scroll(sess, x, y, delta_y=-clicks * 100)
1575
- await send({"type": "ack", "action": "scroll", "clicks": clicks})
1576
-
1577
- elif action == "clipboard_write":
1578
- text = data.get("text", "")
1579
- if engine != "camoufox":
1580
- await cdp_clipboard_write(sess, text)
1581
- # في Camoufox، النسخ الفعلي يُحاكى عبر paste مباشرة (لا حاجة لتخزين منفصل)
1582
- await send({"type": "ack", "action": "clipboard_write", "length": len(text)})
1583
-
1584
- elif action == "clipboard_read":
1585
- text = await cdp_clipboard_read(sess) if engine != "camoufox" else ""
1586
- await send({"type": "clipboard_content", "text": text})
1587
-
1588
- elif action == "paste":
1589
- text = data.get("text", "")
1590
- if text:
1591
- if engine == "camoufox":
1592
- await cam.type_text(text)
1593
- else:
1594
- await cdp_clipboard_write(sess, text)
1595
- await cdp_type_text(sess, text)
1596
- await send({"type": "ack", "action": "paste"})
1597
-
1598
- elif action == "open_app":
1599
- # في هذه البنية Chromium/Camoufox هو "التطبيق" الوحيد؛ أي أمر يحوي
1600
- # firefox/chromium/chrome يُفهم كطلب فتح صفحة فارغة جديدة في ��فس المتصفح.
1601
- cmd = _safe_search(data.get("cmd", ""))
1602
- url_match = re.search(r"https?://\S+", cmd)
1603
- target_url = url_match.group(0) if url_match else "about:blank"
1604
- if engine == "camoufox":
1605
- await cam.navigate(target_url)
1606
- else:
1607
- await cdp_navigate(sess, target_url)
1608
- await send({"type": "ack", "action": "open_app", "cmd": cmd})
1609
- bg_shot("after open_app", delay=1.0)
1610
-
1611
- elif action == "open_tab":
1612
- url = _safe_search(data.get("url", "") or "about:blank")
1613
- if engine == "camoufox":
1614
- await cam.navigate(url)
1615
- else:
1616
- await cdp_navigate(sess, url)
1617
- await send({"type": "ack", "action": "open_tab", "url": url})
1618
- bg_shot("after open_tab", delay=1.2)
1619
-
1620
- elif action == "close_tab":
1621
- if engine == "camoufox":
1622
- await cam.navigate("about:blank")
1623
- else:
1624
- await cdp_navigate(sess, "about:blank")
1625
- await send({"type": "ack", "action": "close_tab"})
1626
- bg_shot("after close_tab", delay=0.4)
1627
-
1628
- elif action == "browser_back":
1629
- if engine == "camoufox":
1630
- await cam.go_back()
1631
- else:
1632
- cdp = sess.get("cdp")
1633
- if cdp and cdp.alive:
1634
- hist = await cdp.send("Page.getNavigationHistory", timeout=4.0)
1635
- if hist:
1636
- entries = hist.get("result", {}).get("entries", [])
1637
- idx = hist.get("result", {}).get("currentIndex", 0)
1638
- if idx > 0:
1639
- await cdp.send("Page.navigateToHistoryEntry", {"entryId": entries[idx - 1]["id"]}, timeout=5.0)
1640
- await send({"type": "ack", "action": "browser_back"})
1641
- bg_shot("after back", delay=0.6)
1642
-
1643
- elif action == "browser_forward":
1644
- if engine == "camoufox":
1645
- await cam.go_forward()
1646
- else:
1647
- cdp = sess.get("cdp")
1648
- if cdp and cdp.alive:
1649
- hist = await cdp.send("Page.getNavigationHistory", timeout=4.0)
1650
- if hist:
1651
- entries = hist.get("result", {}).get("entries", [])
1652
- idx = hist.get("result", {}).get("currentIndex", 0)
1653
- if idx < len(entries) - 1:
1654
- await cdp.send("Page.navigateToHistoryEntry", {"entryId": entries[idx + 1]["id"]}, timeout=5.0)
1655
- await send({"type": "ack", "action": "browser_forward"})
1656
- bg_shot("after forward", delay=0.6)
1657
-
1658
- elif action == "browser_search":
1659
- url = _safe_search(data.get("url", "") or data.get("query", ""))
1660
- if not re.match(r"^https?://", url):
1661
- url = "https://duckduckgo.com/?q=" + urllib.parse.quote_plus(url)
1662
- if engine == "camoufox":
1663
- await cam.navigate(url)
1664
- else:
1665
- await cdp_navigate(sess, url)
1666
- await send({"type": "ack", "action": "browser_search"})
1667
- bg_shot("after search", delay=1.0)
1668
-
1669
- elif action == "screen_info":
1670
- info = await cdp_get_screen_info(sess)
1671
- await send({"type": "screen_info", "width": info["width"], "height": info["height"],
1672
- "mouse_x": info["mouse_x"], "mouse_y": info["mouse_y"],
1673
- "browser": BROWSER_BIN if engine == "chromium" else "camoufox (Firefox anti-detect)",
1674
- "engine": engine})
1675
-
1676
- else:
1677
- await send({"type": "error", "msg": f"Unknown action: '{action}'"})
1678
-
1679
-
1680
- # ════════════════════════════════════════════════════════════════
1681
- # ── WebSocket Endpoint ────────────────────────────────────────
1682
- # ════════════════════════════════════════════════════════════════
1683
-
1684
- @app.websocket("/ws")
1685
- async def websocket_endpoint(ws: WebSocket, user_id: str = Query(default="anonymous")):
1686
- await ws.accept()
1687
- sess = await get_or_create_session(user_id, ws)
1688
- await ensure_browser_running(sess)
1689
-
1690
- async def _heartbeat():
1691
- while True:
1692
- await asyncio.sleep(20)
1693
- try:
1694
- await ws.send_text(json.dumps({"type": "ping", "ts": int(time.time() * 1000)}))
1695
- except Exception:
1696
- break
1697
-
1698
- hb_task = asyncio.create_task(_heartbeat())
1699
-
1700
- try:
1701
- info = await cdp_get_screen_info(sess)
1702
- await ws.send_text(json.dumps({
1703
- "type": "connected",
1704
- "screen_width": info["width"], "screen_height": info["height"],
1705
- "browser": BROWSER_BIN, "display": f"headless:{sess['port']}",
1706
- "user_id": user_id, "session_id": id(ws),
1707
- "msg": f"Z Computer Mode v20 | User: {user_id} | Port: {sess['port']} | "
1708
- f"Browser: {BROWSER_BIN} (headless=new) | Screen: {info['width']}x{info['height']}",
1709
- }, ensure_ascii=False))
1710
-
1711
- # لقطة شاشة أولية
1712
- result = await capture_full(sess, quality=72)
1713
- if result.get("data"):
1714
- await ws.send_text(json.dumps({
1715
- "type": "screenshot", "data": result["data"],
1716
- "data_grid": result.get("data_grid", ""), "data_grid2": result.get("data_grid2", ""),
1717
- "data_grid3": result.get("data_grid3", ""), "ts": int(time.time() * 1000),
1718
- "label": "Initial screen", "screen_width": result["width"], "screen_height": result["height"],
1719
- "mouse_x": result["mouse_x"], "mouse_y": result["mouse_y"], "has_grid": True,
1720
- }, ensure_ascii=False))
1721
- sess["last_frame_hash"] = _frame_hash(result["data"])
1722
- except Exception as e:
1723
- print(f"[ws:{user_id}] خطأ عند البدء: {e}")
1724
-
1725
- try:
1726
- while True:
1727
- raw = await ws.receive_text()
1728
- try:
1729
- msg = json.loads(raw)
1730
- if msg.get("type") == "pong":
1731
- continue
1732
- await handle_action(ws, msg, sess)
1733
- except json.JSONDecodeError:
1734
- pass
1735
- except WebSocketDisconnect:
1736
- pass
1737
- except Exception as e:
1738
- print(f"[ws:{user_id}] خطأ: {e}")
1739
- finally:
1740
- hb_task.cancel()
1741
- await destroy_session_ws(user_id, ws)
1742
-
1743
-
1744
- # ════════════════════════════════════════════════════════════════
1745
- # ── REST Endpoints ────────────────────────────────────────────
1746
- # ════════════════════════════════════════════════════════════════
1747
-
1748
- @app.get("/screenshot")
1749
- async def rest_screenshot(user_id: str = "anonymous"):
1750
- with _sessions_lock:
1751
- sess = _sessions.get(user_id)
1752
- if not sess:
1753
- return JSONResponse({"error": "no session for this user_id"}, status_code=404)
1754
- await ensure_browser_running(sess)
1755
- result = await capture_full(sess, quality=75)
1756
- return JSONResponse({
1757
- "image": result["data"], "image_grid": result.get("data_grid", ""),
1758
- "image_grid2": result.get("data_grid2", ""), "image_grid3": result.get("data_grid3", ""),
1759
- "ts": int(time.time() * 1000), "screen_width": result["width"], "screen_height": result["height"],
1760
- "mouse_x": result["mouse_x"], "mouse_y": result["mouse_y"], "has_grid": True,
1761
- "user_id": user_id,
1762
- })
1763
-
1764
-
1765
- @app.post("/terminal")
1766
- async def rest_terminal(body: dict):
1767
- return JSONResponse(await run_cmd_smart(body.get("cmd", ""), body.get("timeout", 60)))
1768
-
1769
-
1770
- @app.get("/health")
1771
- async def health():
1772
- with _sessions_lock:
1773
- n = len(_sessions)
1774
- users = [
1775
- {"user_id": uid, "cdp_port": s["port"], "connected": bool(s.get("active_ws")),
1776
- "browser_alive": bool(s.get("cdp") and s["cdp"].alive),
1777
- "engine": s.get("engine", "chromium")}
1778
- for uid, s in _sessions.items()
1779
- ]
1780
- return {"status": "ok", "version": "v20.1-headless-native+camoufox", "browser": BROWSER_BIN,
1781
- "brave_search_enabled": bool(BRAVE_API_KEY),
1782
- "camoufox_available": bool(_CAMOUFOX_LIB_AVAILABLE and CAMOUFOX_ENABLED),
1783
- "active_sessions": n, "max_sessions": MAX_SESSIONS, "users": users}
1784
-
1785
-
1786
- # ════════════════════════════════════════════════════════════════
1787
- # ── Background Cleanup ────────────────────────────────────────
1788
- # ════════════════════════════════════════════════════════════════
1789
-
1790
- async def _cleanup_idle_sessions():
1791
- """يُزيل جلسات المستخدمين غير النشطين (بدون اتصال WebSocket منذ أكثر من
1792
- ساعة) — يوقف Chromium الخاص بهم فعلياً لتحرير الذاكرة."""
1793
- while True:
1794
- await asyncio.sleep(1800)
1795
- now = time.time()
1796
- with _sessions_lock:
1797
- idle_uids = [uid for uid, s in _sessions.items()
1798
- if not s.get("active_ws") and now - s.get("created", now) > 3600]
1799
- for uid in idle_uids:
1800
- print(f"[cleanup] 🗑️ إزالة جلسة خاملة '{uid}'")
1801
- await destroy_session_full(uid)
1802
-
1803
-
1804
- @app.on_event("startup")
1805
- async def startup():
1806
- asyncio.create_task(_cleanup_idle_sessions())
1807
- print("✅ Z Computer Mode v20 جاهز — Headless-Native (بدون Xvfb)")
1808
- print(f" المتصفح المعتمد: {BROWSER_BIN} (--headless=new)")
1809
- print(f" مرشحو المتصفح المفحوصون: {', '.join(_BROWSER_CANDIDATES)}")
1810
- print(f" أقصى جلسات متزامنة: {MAX_SESSIONS}")
1811
- print(f" نطاق منافذ CDP: {CDP_PORT_BASE}+")
1812
- print(f" websockets lib: {'✅' if _WS_LIB_AVAILABLE else '❌ (pip install websockets)'}")
1813
- if BRAVE_API_KEY:
1814
- print(" 🔍 Brave Search API: ✅ مفعّل — البحث سيتم عبره أولاً (بدون كابتشا)")
1815
- else:
1816
- print(" 🔍 Brave Search API: ❌ غير مُعرَّف — عيّن BRAVE_API_KEY لتفعيله")
1817
- print(" (بدونه، البحث سيعتمد على DuckDuckGo/Wikipedia APIs المجانية كبديل)")
1818
- if _CAMOUFOX_LIB_AVAILABLE and CAMOUFOX_ENABLED:
1819
- print(" 🦊 Camoufox (متصفح مضاد للكشف): ✅ متاح — عبر action: switch_engine {engine: camoufox}")
1820
- else:
1821
- print(" 🦊 Camoufox: ❌ غير متاح — pip install camoufox playwright && playwright install firefox")
1822
- print(" Connect: wss://your-space.hf.space/ws?user_id=EMAIL")
1823
-
1824
-
1825
- if __name__ == "__main__":
1826
- port = int(os.environ.get("PORT", 7860))
1827
- uvicorn.run("app:app", host="0.0.0.0", port=port, log_level="info")
1828
-
1829
-
1830
-
1831
-
1832
-
1833
-
1834
-