WebClone Studio

Enterprise Web Architecture Extraction, Lossless Offline Mirroring & Reverse Engineering Workstation

Developed by Monolith Works | Published via MonarchDevLab

English Documentation • Türkçe Dokümantasyon

English Documentation

Executive Overview

WebClone Studio is an enterprise-grade desktop workstation designed for web architects, reverse engineers, security analysts, and senior frontend developers. Rather than merely downloading static assets like legacy crawlers, WebClone Studio operates as an autonomous digital reconstruction laboratory:

Complete Offline Mirroring: Crawls, resolves, and rewrites complex Single Page Applications (Next.js, Nuxt, Remix, Vite, Angular) and multi-page portals for 100% offline fidelity.
Reverse Engineering Decompilation: Reconstructs original development file trees from production source maps, extracts hydration states, outputs W3C design tokens and Tailwind v4 themes, and compiles OpenAPI 3.1 specifications from background network traffic.
Modular Code Generation: Synthesizes production-ready React 19 TSX components, exports self-contained single-file HTML deliverables, and generates Chromium-native MHTML snapshots.
Persistent Authenticated Crawling: Enables interactive browser login sessions with shared cookie vaults (persist:webclone), allowing seamless mirroring of authenticated SaaS consoles and behind-the-login dashboards.
Zero-Driver Embedded Runtime: Embeds Chromium offscreen rendering directly within Electron 33, eliminating any requirement for external browser binaries (Playwright, Puppeteer, Selenium).
Zero-OOM Ponytail Architecture: Streams raw HTML directly to disk and indexes URL mappings in $O(1)$ time, allowing massive enterprise crawls (10,000+ pages) without memory spikes or CPU locks.

Architecture & Engine Pipeline

The system is organized around a multi-stage cognitive extraction and reconstruction pipeline:

flowchart TD
    Target[Target Web Application] --> AuthCheck{Auth Required?}
    AuthCheck -- Yes --> AuthSession[Interactive Browser Window: persist:webclone Session]
    AuthCheck -- No --> Network[Chromium Network Engine & Stealth CDP]
    AuthSession --> Network

    Network --> Evasion[Anti-Bot Evasion & Fingerprint Sanitization]
    Evasion --> Render[Offscreen Chromium Render Loop]
    Render --> Scroll[Asynchronous Infinite Auto-Scroll]
    Scroll --> StateExplorer[Autonomous State-Space Explorer: Tabs & Accordions]
    StateExplorer --> ShadowDOM[Deep Shadow DOM Piercing: getInnerHTML]
    
    ShadowDOM --> CoreEngine[Crawler Engine & Asset Scheduler]
    
    CoreEngine --> DiskStream[Zero-OOM Disk-Streaming HTML Buffer]
    CoreEngine --> Dedup[Content-Addressed SHA-256 Asset Deduplication]
    CoreEngine --> ObfuscationBypass[JS Chunk Scanner: Web Fonts & Hidden Endpoints]
    
    CoreEngine --> ReverseLab[Reverse Engineering Lab]
    ReverseLab --> SourceMap[SourceMap Tree Reconstructor: site/_source-code/]
    ReverseLab --> Hydration[Hydration State Harvester: _meta/extracted-state.json]
    ReverseLab --> Tokens[Design Tokens & Tailwind v4: _meta/tailwind.config.js]
    ReverseLab --> AdaptiveEntities[Self-Healing Adaptive Entities: _meta/adaptive-entities.json]
    ReverseLab --> ApiSpec[OpenAPI 3.1 & TypeScript Generator: _meta/openapi.json]
    
    CoreEngine --> Rewriter[O 1 Indexed Offline URL Rewriter]
    Rewriter --> FetchShim[Client-Side Offline Fetch / XHR Mock Injection]
    
    Rewriter --> CodeGen[Component & Archive Generators]
    CodeGen --> ReactExport[React 19 TSX Components: _components/]
    CodeGen --> SingleFile[SingleFile Standalone HTML: _exports/index.standalone.html]
    CodeGen --> MhtmlExport[Native CDP MHTML Snapshot: _exports/index.mhtml]
    CodeGen --> Preview[Local 127.0.0.1 HTTP & Mock API Server]

Deep Technical Capabilities

1. Autonomous State-Space Explorer

Traditional scrapers only capture the initial DOM state, missing up to 70% of modern dynamic interfaces. WebClone Studio executes an autonomous interaction loop:

Heuristic Safe Interaction: Scans the active DOM for unopened accordions, hidden FAQ panels, unselected tabs, and expandable menus ([role="tab"][aria-selected="false"], details:not([open]) > summary, [aria-expanded="false"], .accordion-header, .faq-question).
Destructive Action Isolation: Forms, submit buttons, delete/logout triggers, and external navigation links (<a>) are strictly filtered out to prevent state mutation or page divergence.
Micro-Debounced Clicks: Sequentially simulates native user click events with debounced intervals to allow CSS transitions and dynamic lazy-loaded contents to fully populate the DOM before snapshot capture.

2. Declarative Shadow DOM Piercing

Web components built with Stencil, Lit, or native Custom Elements encapsulate their DOM within Shadow Roots, leaving standard outerHTML dumps empty:

Chromium Native Serialization: Leverages element.getInnerHTML({ includeShadowRoots: true }) directly within Electron Chromium 130.
W3C Declarative Format: Serializes nested shadow trees into standard <template shadowrootmode="open"> elements, enabling any modern Chromium browser to render encapsulated components offline with zero JavaScript overhead.

3. Frontend Reverse Engineering Lab

SourceMap Virtual Tree Reconstructor: Scans all JS and CSS bundles for sourceMappingURL directives (relative, absolute, or data URIs). It resolves and decodes .map files, reconstructing the original developer file hierarchy inside site/_source-code/ (e.g. src/components/Button.tsx, src/hooks/useCart.ts).
Framework Hydration Harvester: Captures server-rendered hydration state containers including window.__NEXT_DATA__, window.__NUXT_DATA__, window.__INITIAL_STATE__, and Apollo/Redux preloaded caches, outputting a consolidated dataset into _meta/extracted-state.json.
Design Tokens & Tailwind v4 Theme: Aggregates :root CSS variables, active computed colors, typography scales, border radii, and box shadows. Generates ready-to-use W3C Design Tokens (_meta/design-tokens.json) and an idiomatic Tailwind CSS v4 @theme configuration (_meta/tailwind.config.js).

4. API Traffic Interception to OpenAPI 3.1 & TypeScript

CDP Network Hooking: Connects to Chrome DevTools Protocol (Network.enable) to capture all background asynchronous requests (XHR, Fetch, JSON responses).
OpenAPI 3.1 Contract Generation: Infers JSON schemas, request query parameters, and HTTP response statuses to compile a production-ready _meta/openapi.json (Swagger) contract.
TypeScript Type Definitions: Compiles strongly typed TypeScript interfaces for each endpoint into _meta/api-types.d.ts. Example output:

/**
 * Endpoint: GET /api/v1/products
 * Status: 200
 */
export interface GetApiV1ProductsResponse {
  products?: { id?: number; title?: string; price?: number; inStock?: boolean }[];
  totalCount?: number;
  page?: number;
}

5. React 19 Component Exporter

Converts cloned HTML pages into clean, modular React functional components (_components/Page_*.tsx).
Converts HTML attributes (class to className, for to htmlFor).
Translates inline style strings into valid TypeScript style objects (style="margin-top: 10px; z-index: 5;" -> style={{ marginTop: '10px', zIndex: 5 }}).
Translates SVG attributes to camelCase (stroke-width -> strokeWidth, fill-rule -> fillRule).
Formats self-closing tags (<img>, <input>, <br>, <hr>).

6. Dual Standalone Archive: SingleFile HTML & Native CDP MHTML

WebClone Studio delivers two complementary standalone archive formats:

SingleFile Portable HTML (_exports/index.standalone.html): Inlines stylesheets into <style> blocks, converts web fonts into Base64 Data URIs (url("data:font/woff2;base64,...")), and encodes all images and vector icons as inline Data URIs.
Native CDP MHTML Snapshot (_exports/index.mhtml): Calls Chromium DevTools Protocol Page.captureSnapshot({ format: 'mhtml' }) on the live rendered DOM. It produces an uncompressed MIME multipart HTML archive containing the exact render tree, canvas elements, and dynamically fetched sub-resources, viewable natively in Google Chrome, Microsoft Edge, and Opera with zero dependencies.

7. Persistent Auth Session for Authenticated Portals

Cloning password-protected web apps, SaaS dashboards, or sites protected by 2FA/CAPTCHA is handled natively:

Interactive Authentication Hub: The Clone Setup Wizard offers an interactive login window powered by a shared persist:webclone session partition.
Cookie & LocalStorage Synchronization: Users authenticate manually in the secure browser window; once closed, the engine harvests active session cookies, bearer tokens, and clearance tickets.
Dual-Engine Inheritance: Both the Chromium offscreen renderer (PageRenderer) and the multi-threaded HTTP downloader (AssetDownloader) inherit the session, enabling authenticated asset mirroring.

8. Client-Side Offline Fetch & XHR Mock Shim

Modern Single Page Applications break offline when JavaScript code triggers runtime fetch() or axios calls against external origin APIs:

Client-Side Mock Injection: During HTML rewriting, WebClone Studio injects an XSS-sanitized runtime shim (window.fetch interceptor) right alongside the offline Service Worker bypass.
Zero-Latency Mock Resolution: When cloned client scripts query endpoints recorded in _meta/api-endpoints.json, the browser intercepts the request and instantly responds with the recorded JSON payload, keeping interactive search, filtering, and tab navigation working without an active internet connection.

9. Zero-OOM Disk-Streaming Pipeline & SHA-256 Deduplication

Immediate Disk-Streaming: Rather than buffering gigabytes of raw HTML across hundreds of pages in process memory, pages are immediately written to disk upon retrieval. The rewrite queue stores lightweight pointers ({ url, localPath }), slashing heap memory consumption by over 90%.
Content-Addressed SHA-256 Deduplication: Assets under 15MB are hashed via SHA-256. Duplicate vendor scripts, logos, or icon sets hosted across divergent URLs are deduplicated to a single physical disk file, with all local references transparently linked.

10. O(1) Local URL Rewriter

Indexed Map Resolution: Replaces $O(N)$ sequential map scans with an indexed hash lookup that resolves exact, query-stripped, hash-stripped, and trailing-slash URL variations in $O(1)$ constant time.
Zero-Lock Finalization: Thousands of internal resource references across massive crawls finalize in seconds without stalling CPU cores.

11. JavaScript Obfuscation Bypass

Heuristic AST and regex parser scans minified production JS chunks (Webpack, Vite, Rollup).
Extracts dynamic asset paths, vendor CDN URLs, and hidden web font endpoints that are never linked directly in HTML or CSS.
Automatically pushes discovered assets into the download scheduler queue.

12. Embedded 127.0.0.1 Micro-Preview & Mock Server

Bundles a built-in Node.js HTTP server configured with path-traversal guards and MIME type negotiation.
Serves cloned projects locally over http://127.0.0.1:<port> to eliminate browser file:/// security and CORS errors.
Offline API Mock Fallback: When the cloned frontend makes an AJAX request that has no static file on disk, the server falls back to _meta/api-endpoints.json to respond with the recorded JSON payload.

13. Ultra-Stealth CDP Anti-Bot Evasion & Clearance Bridge

Prototype-clean descriptor masking for navigator.webdriver, window.chrome (runtime/app/csi), navigator.permissions.query, and realistic WebGL GPU virtualization (NVIDIA RTX / Intel Iris).
Injects micro-jitter into Canvas and AudioContext buffers to invalidate deterministic bot fingerprint tracking without corrupting media assets.
Clearance Bridge: Harvests active cf_clearance, __cf_bm, and session cookies directly from Electron's Chromium session and synchronizes them into AssetDownloader's HTTP/2 connection pool.
Automated WAF Escalation: Automatically promotes failed static downloads (403/503 Turnstile / Challenge pages) to the Ultra-Stealth Chromium renderer and re-syncs clearance tokens in real time.

14. Self-Healing Adaptive Semantic Extractor

Analyzes heavily obfuscated and minified DOM structures (Tailwind arbitrary hashes, CSS Modules, compiled styled-components) using structural density heuristics rather than volatile CSS class names.
Discovers primary content containers, recurring product/article cards, and pagination/infinite load triggers.
Generates _meta/adaptive-entities.json containing structured entities (title, link, image, price/badge, description).

15. GitHub Releases Auto-Update Hub

Built-in update service queries the official GitHub Releases API (https://api.github.com/repos/MonarchDevLab/WebClone-Studio/releases/latest).
In-app Settings page displays current version, latest release notes, total download counters, and direct download links for Windows Setup, Portable, and MSI installers.

Workstation Benchmark & Comparison

Feature / Capability	WebClone Studio	HTTrack	SingleFile	Cyotek WebCopy	Raw Puppeteer Scripts
Interactive Auth Session Vault	Built-in (`persist:webclone`)	No	No	No	Manual script required
Native CDP MHTML Snapshot	Built-in (`_exports/`)	No	No	No	Manual script required
Offline Fetch Mock Shim	Built-in (`UrlRewriter`)	No	No	No	No
Zero-OOM Disk-Streaming	Built-in ($O(1)$ RAM)	Partial	No	Partial	Manual file streams
Shadow DOM Piercing	Full (Native CDP)	No	Partial	No	Manual script required
Autonomous State Explorer	Built-in	No	No	No	Manual script required
Ultra-Stealth WAF Evasion	Built-in (CDP + Bridge)	No	No	No	Plugin required
Self-Healing Adaptive Extractor	Built-in (`_meta/`)	No	No	No	No
SourceMap Reconstruction	Automatic	No	No	No	No
OpenAPI 3.1 & TS Generator	Built-in	No	No	No	No
React 19 Component Export	Automatic	No	No	No	No
Hydration State Recovery	Built-in	No	No	No	No
Tailwind v4 Token Generator	Built-in	No	No	No	No
Offline Mock API Server	127.0.0.1 Built-in	No	No	No	External server needed
Single-File Standalone Export	Yes (`_exports/`)	No	Yes	No	Manual inlining
External Driver Dependency	Zero (Embedded)	None	None	None	Heavy (Chromium/Node)
Distribution Formats	Setup, Portable, MSI	Setup	Extension	Setup	CLI script only

Distribution Formats & Installation

WebClone Studio releases provide three Windows x64 distribution packages:

dist/
├── WebClone-Studio-Setup-1.2.0.exe    # NSIS installer with desktop shortcuts and uninstaller (~77.3 MB)
├── WebClone-Studio-Portable.exe       # Standalone portable executable. Zero installation (~76.9 MB)
└── WebClone-Studio-1.2.0.msi          # Microsoft Windows Installer for enterprise GPO deployment (~87.5 MB)

Portable Edition: Download WebClone-Studio-Portable.exe, place it in any folder or USB drive, and double-click to run. Requires no administrative privileges.
Setup Installer: Run WebClone-Studio-Setup-1.2.0.exe for standard Windows installation with Start Menu and Desktop shortcuts.
MSI Package: Suitable for enterprise system administrators deploying across domain networks via Microsoft Intune or Group Policy.

Developer Setup & Build Commands

# Clone repository
git clone https://github.com/MonarchDevLab/WebClone-Studio.git
cd WebClone-Studio

# Install production and development dependencies
npm install

# Run desktop app in development mode with HMR
npm run dev

# Run strict TypeScript type verification
npm run typecheck

# Run unit and integration tests
npm test

# Build production bundles
npm run build

# Package portable Windows binary only
npm run build:portable

# Package NSIS setup installer only
npm run build:setup

# Package MSI Windows Installer only
npm run build:msi

# Package all Windows targets simultaneously (Setup, Portable, MSI)
npm run build:all

Türkçe Dokümantasyon

Genel Bakış

WebClone Studio, web mimarları, tersine mühendislik uzmanları, güvenlik araştırmacıları ve kıdemli frontend geliştiricileri için sıfırdan inşa edilmiş kurumsal düzeyde bir masaüstü çalışma istasyonudur. Geleneksel klonlama yazılımlarının aksine, modern web uygulamalarını yalnızca indirmez; onları eksiksiz bir dijital rekonstrüksiyon sürecinden geçirir:

Kayıpsız Çevrimdışı Klonlama: Modern SPA (Next.js, Nuxt, Remix, Vite, Angular) ve geleneksel çok sayfalı portalları %100 çevrimdışı sadakatle yerel dosya sistemine aktarır.
Tersine Mühendislik ve Dekompilasyon: Canlı sitelerdeki kaynak haritalarından (source maps) orijinal kaynak kod ağacını (site/_source-code/) kurtarır; hydration durumlarını, W3C tasarım tokenlarını ve ağ trafiğinden OpenAPI 3.1 spesifikasyonunu üretir.
Modüler Kod Üretimi: Klonlanan sayfaları temiz React 19 TSX bileşenlerine dönüştürür, dağıtılabilir tek parça bağımsız HTML çıktıları ve Chromium yerleşik MHTML arşivleri oluşturur.
Kilitli ve Yetkilendirilmiş Sayfa Klonlama: Paylaşımlı oturum kasası (persist:webclone) ile etkileşimli giriş pencereleri açar; login arkasındaki SaaS panellerini ve üyelik sayfalarını yetkilendirilmiş olarak klonlar.
Sıfır Harici Sürücü Bağımlılığı: Electron 33'ün yerleşik offscreen Chromium motorunu kullanır. Playwright, Puppeteer veya harici WebDriver kurulumu gerektirmez.
Sıfır-OOM Ponytail Mimarisi: Ham HTML sayfalarını bellekte tutmadan doğrudan diske akıtır ve URL haritasını $O(1)$ sürede çözer; 10.000+ sayfalık kurumsal sitelerde bile RAM taşması veya CPU kilitlenmesi yaşanmaz.

Mimari ve Motor Boru Hattı

Sistem, çok aşamalı otonom bir analiz ve çıkarma boru hattı üzerine kuruludur:

flowchart TD
    Hedef[Hedef Web Uygulaması] --> AuthKontrol{Giriş Gerekli mi?}
    AuthKontrol -- Evet --> AuthPencere[Etkileşimli Tarayıcı: persist:webclone Oturumu]
    AuthKontrol -- Hayır --> AgMotoru[Chromium Ağ Motoru & Stealth CDP]
    AuthPencere --> AgMotoru

    AgMotoru --> Atlatma[Anti-Bot Atlatma & Parmak İzi Temizliği]
    Atlatma --> RenderMotoru[Offscreen Chromium Render Döngüsü]
    RenderMotoru --> OtoKaydirma[Asenkron Sonsuz Kaydırma: Infinite Scroll]
    OtoKaydirma --> DurumGezgini[Otonom Durum Gezgini: Sekmeler & Akordeonlar]
    DurumGezgini --> ShadowDelme[Derin Shadow DOM Delme: getInnerHTML]
    
    ShadowDelme --> Cekirdek[Klonlama Motoru & Zamanlayıcı]
    
    Cekirdek --> DiskAkisi[Sıfır-OOM Disk-Stream HTML Tamponu]
    Cekirdek --> Tekillestirme[İçerik-Adresli SHA-256 Varlık Tekilleştirme]
    Cekirdek --> Obfuscation[JS Chunk Analizi: Web Fontları & Gizli Yollar]
    
    Cekirdek --> Lab[Tersine Mühendislik Laboratuvarı]
    Lab --> SourceMap[Kaynak Kod Ağacı: site/_source-code/]
    Lab --> Hydration[Hydration Durumu: _meta/extracted-state.json]
    Lab --> Tokens[Tasarım Tokenları & Tailwind v4: _meta/tailwind.config.js]
    Lab --> AdaptifVarlik[Self-Healing Adaptif Varlıklar: _meta/adaptive-entities.json]
    Lab --> ApiSozlesme[OpenAPI 3.1 & TypeScript: _meta/openapi.json]
    
    Cekirdek --> Rewriter[O 1 İndeksli Çevrimdışı URL Dönüştürücü]
    Rewriter --> FetchMock[İstemci Tarafı Çevrimdışı Fetch Mock Enjeksiyonu]
    
    Rewriter --> Ureticiler[Bileşen ve Arşiv Üreticileri]
    Ureticiler --> ReactBilesen[React 19 TSX Bileşenleri: _components/]
    Ureticiler --> TekDosya[Bağımsız Tek Dosya HTML: _exports/index.standalone.html]
    Ureticiler --> MhtmlArsiv[Yerleşik CDP MHTML Arşivi: _exports/index.mhtml]
    Ureticiler --> Onizleme[Yerleşik 127.0.0.1 HTTP & Mock API Sunucusu]

Derinlemesine Teknik Yetenekler

1. Otonom Durum Gezgini (State Explorer)

Geleneksel tarayıcılar sayfanın yalnızca ilk halini dondurur ve gizli akordeonların, sekmelerin veya dinamik menülerin %70'ini kaçırır. WebClone Studio otonom etkileşim döngüsüyle bu sorunu çözer:

Güvenli Seçici Analizi: Sayfadaki kapalı akordeonları, seçilmemiş sekmeleri ve katlanmış blokları otomatik haritalandırır ([role="tab"][aria-selected="false"], details:not([open]) > summary, [aria-expanded="false"], .accordion-header, .faq-question).
Tehlikeli Eylemlerin İzolasyonu: Formlar, gönderim (submit) butonları, oturum kapatma ve harici yönlendirme linkleri (<a>) filtre dışı tutulur; böylece oturum ve sayfa bütünlüğü korunur.
Debounce Destekli Simülasyon: Tıklama olayları sıralı ve gecikmeli olarak tetiklenerek CSS animasyonlarının ve dinamik içeriklerin DOM'a tam yerleşmesi sağlanır.

2. Declarative Shadow DOM Delme

Modern web bileşenleri (Web Components, Lit, Stencil) içeriklerini Shadow Root içine hapsederek standart DOM kopyalamasını engeller:

Chromium Seviyesinde Ayrıştırma: Electron Chromium 130 motorunun getInnerHTML({ includeShadowRoots: true }) kabiliyeti devreye sokulur.
W3C Declarative Standart Formatı: Gizli shadow ağaçları <template shadowrootmode="open"> etiketlerine dönüştürülerek kaydedilir. Bu sayede tüm Chromium tarayıcılar bileşenleri hiçbir harici JavaScript çalışmasa bile çevrimdışı render edebilir.

3. Tersine Mühendislik ve Dekompilasyon Laboratuvarı

SourceMap Kaynak Kod Ağacı Kurtarma: JS ve CSS paketlerindeki sourceMappingURL direktiflerini izler. .map dosyalarını çözerek projenin geliştirme aşamasındaki orijinal klasör hiyerarşisini site/_source-code/ altında birebir oluşturur (örn. src/components/Navbar.tsx, src/hooks/useCart.ts).
Framework Hydration Durum Toplama: SSR/SPA sayfalarında bulunan window.__NEXT_DATA__, window.__NUXT_DATA__, window.__INITIAL_STATE__ ve Redux/Apollo önbelleklerini ayıklayıp tek bir _meta/extracted-state.json dosyasında birleştirir.
Tasarım Sistemi & Tailwind v4 Teması: Canlı stillerdeki :root CSS değişkenlerini, hesaplanmış renk skalalarını ve font ailelerini çıkarır. W3C Design Tokens standart dosyasını (_meta/design-tokens.json) ve kullanıma hazır Tailwind CSS v4 @theme yapılandırmasını (_meta/tailwind.config.js) üretir.

4. Ağ Trafiğinden OpenAPI 3.1 ve TypeScript Üretimi

CDP Ağ Yakalama: Chrome DevTools Protocol (Network.enable) üzerinden arka planda gerçekleşen tüm dinamik XHR, Fetch ve JSON isteklerini kaydeder.
OpenAPI 3.1 Sözleşmesi: İstek parametrelerini ve yanıt gövdelerini JSON şema analizinden geçirerek eksiksiz bir _meta/openapi.json (Swagger) spesifikasyonu oluşturur.
TypeScript Model Üretimi: Her uç nokta için tip güvenli TypeScript interface yapıları derler (_meta/api-types.d.ts). Örnek çıktı:

/**
 * Endpoint: GET /api/v1/products
 * Status: 200
 */
export interface GetApiV1ProductsResponse {
  products?: { id?: number; title?: string; price?: number; inStock?: boolean }[];
  totalCount?: number;
  page?: number;
}

5. React 19 Fonksiyonel Bileşen İhracı

Klonlanan HTML sayfalarını modern, tipli React fonksiyonel bileşenlerine (_components/Page_*.tsx) çevirir.
class -> className, for -> htmlFor nitelik dönüşümlerini uygular.
Satır içi stil metinlerini (style="color: red; margin-top: 8px;") React stil nesnelerine (style={{ color: 'red', marginTop: '8px' }}) dönüştürür.
SVG niteliklerini camelCase formatına çevirir (stroke-width -> strokeWidth).
Kapanmayan etiketleri (<img>, <input>, <br>) JSX standartlarına uygun şekilde kapatır.

6. Çift Bağımsız Arşiv: SingleFile HTML ve Native CDP MHTML

WebClone Studio iki farklı bağımsız arşivleme seçeneği üretir:

SingleFile Taşınabilir HTML (_exports/index.standalone.html): CSS stillerini <style> içine gömer, web fontlarını (.woff2, .ttf) ve görselleri Base64 Data URI formatına çevirir; e-posta veya mesajlaşma yoluyla tek dosyada paylaşım sağlar.
Yerleşik CDP MHTML Arşivi (_exports/index.mhtml): Chromium CDP motorunun Page.captureSnapshot({ format: 'mhtml' }) komutunu çalıştırarak sayfanın aktif halini, tüm Canvas ve dinamik varlıklarıyla birlikte Chrome/Edge üzerinde sıfır kayıpla açılan saf MHTML arşivine dönüştürür.

7. Kilitli İçerikler İçin Kalıcı Oturum Açma (persist:webclone)

Giriş formu, iki faktörlü doğrulama (2FA) veya CAPTCHA arkasındaki portalları klonlamak için:

Etkileşimli Oturum Penceresi: Klonlama Kurulum Sihirbazı içinden tek tıkla açılan izole persist:webclone tarayıcı penceresinde kullanıcı güvenle oturum açar.
Otomatik Çerez Devri: Pencere kapatıldığında toplanan oturum çerezleri hem dinamik Chromium render motoruna (PageRenderer) hem de yüksek hızlı indirme motoruna (AssetDownloader) aktarılır.
Korumalı Panel Klonlama: SaaS yönetim panelleri, intranet portalları ve üye alanları eksiksiz yetkiyle yerel diske aktarılır.

8. İstemci Tarafı Çevrimdışı Fetch ve XHR Mock Yakalayıcısı

Modern SPA sitelerinde JavaScript kodunun çalışma zamanında attığı dinamik fetch() ve axios çağrıları çevrimdışı ortamda çökmeye yol açar:

XSS Korumalı Mock Enjeksiyonu: HTML yeniden yazılırken sayfa başlığına Service Worker bypass betiğiyle birlikte hafif bir window.fetch yakalayıcısı eklenir.
Sıfır Gecikmeli Mock Yanıtı: Klonlanan sayfa _meta/api-endpoints.json içinde önceden kaydedilmiş bir adrese istek attığında yerel mock yanıtı 0ms gecikmeyle döner; böylece filtreleme, arama ve sekmeler internet olmadan da çalışır.

9. Sıfır-OOM Bellek Akışı ve SHA-256 İçerik Tekilleştirmesi

Doğrudan Diske Akış: İndirilen ham HTML sayfaları RAM'de biriktirilmeden anında diske yazılır; kuyrukta yalnızca dosya işaretçileri ({ url, localPath }) tutularak bellek tüketimi %90'dan fazla azaltılır.
İçerik-Adresli SHA-256 Tekilleştirmesi: 15MB altındaki statik dosyalar SHA-256 özetinden geçirilir. Farklı URL'lerdeki aynı görsel ve font dosyaları diskte tek bir kopya olarak tutulur, gereksiz disk şişmesi engellenir.

10. O(1) Sabit Zamanlı Yerel URL Dönüştürücü

İndeksli Harita Çözümlemesi: $O(N)$ taranan döngüler kaldırılarak tam eşleşme, parametresiz ve son slash toleranslı URL aramaları $O(1)$ sabit zamanlı Map erişimiyle gerçekleştirilir.
Hızlı Dönüştürme: Binlerce sayfalık projelerde CPU kilidi oluşmaz, bağlantı dönüştürme işlemi saniyeler içinde tamamlanır.

11. JavaScript Obfuscation Bypass (Gizli Varlık Çıkarımı)

Minify edilmiş JS chunk'larını (Webpack, Vite, Rollup) statik regex ve AST desenleriyle analiz eder.
HTML veya CSS dosyalarında açıkça belirtilmeyen gizli web fontlarını, arka plan görsellerini ve dinamik asset yollarını keşfederek indirme kuyruğuna otomatik dahil eder.

12. Yerleşik 127.0.0.1 Önizleme ve Çevrimdışı Mock Sunucusu

Güvenli yol denetimine (path-traversal protection) ve dinamik MIME eşlemesine sahip yerleşik Node.js HTTP sunucusu barındırır.
Klonlanan projeleri yerel porttan sunarak tarayıcı file:/// güvenlik engellerini ve CORS hatalarını ortadan kaldırır.
Çevrimdışı Dinamik API Yanıtı: Sayfa üzerinde yapılan bir API çağrısı yerel diskte statik bir dosya bulamazsa, sunucu otomatik olarak _meta/api-endpoints.json veritabanından yakalanan yanıtı döner.

13. Ultra-Stealth CDP Anti-Bot Kalkanı ve Clearance Köprüsü

navigator.webdriver (prototype-clean), window.chrome (runtime/app/csi), navigator.permissions.query ve gerçekçi WebGL GPU (NVIDIA RTX / Intel Iris) donanım simülasyonu.
Canvas ve AudioContext parmak izi takip mekanizmalarını bozmak için görsel/işitsel veriyi bozmayan mikro-gürültü enjeksiyonu.
Clearance Köprüsü: Chromium oturumundaki cf_clearance, __cf_bm ve yetkilendirme çerezlerini toplayarak AssetDownloader'ın HTTP/2 başlıklarına aktarır; alt varlıkların Cloudflare 403 engeline takılmadan indirilmesini sağlar.
Otomatik WAF Eskalasyonu: Statik indirmede 403/503 Cloudflare/WAF meydan okuması (Turnstile, challenge-running) tespit edildiğinde işi kesintiye uğratmaz; otomatik Ultra-Stealth Chromium motoruna eskalasyon yaparak çerezleri yeniler ve indirmeyi sürdürür.

14. Self-Healing Adaptif Semantik İçerik Çıkarıcı

Obfuscate/hash sınıflı (Tailwind, CSS Modules) karmaşık DOM ağaçlarında sınıf isimlerine bağımlı kalmadan metin yoğunluğu ve kardeş düğüm benzerliği heuristiğiyle ana içerik bloğunu, ürün/makale kartlarını ve sayfalama tetikleyicilerini çıkarır.
Klonlama çıktısına _meta/adaptive-entities.json dosyasını ekler.

15. GitHub Releases Güncelleme Merkezi

Uygulama içi Ayarlar menüsünden resmi GitHub API'sini sorgulayarak yeni sürüm kontrolü yapar.
Canlı indirme sayaçlarını, sürüm notlarını ve Setup, Portable ve MSI formatlarındaki yükleme paketlerinin doğrudan indirme butonlarını sunar.

Karşılaştırma ve Başarım Tablosu

Özellik / Yetenek	WebClone Studio	HTTrack	SingleFile	Cyotek WebCopy	Saf Puppeteer Kodları
Kalıcı Oturum Açma Kasası	Yerleşik (`persist:webclone`)	Yok	Yok	Yok	Manuel betik gerektirir
Yerleşik CDP MHTML Arşivi	Yerleşik (`_exports/`)	Yok	Yok	Yok	Manuel betik gerektirir
Çevrimdışı Fetch Mock Shim	Yerleşik (`UrlRewriter`)	Yok	Yok	Yok	Yok
Sıfır-OOM Bellek Akışı	Yerleşik ($O(1)$ RAM)	Kısmi	Yok	Kısmi	Manuel dosya akışı
Shadow DOM Delme	Tam (Native CDP)	Yok	Kısmi	Yok	Manuel betik gerektirir
Otonom Durum Gezgini	Yerleşik	Yok	Yok	Yok	Manuel betik gerektirir
Ultra-Stealth WAF Kalkanı	Yerleşik (CDP + Bridge)	Yok	Yok	Yok	Eklenti gerekir
Self-Healing Adaptif Çıkarıcı	Yerleşik (`_meta/`)	Yok	Yok	Yok	Yok
SourceMap Kaynak Kurtarma	Otomatik	Yok	Yok	Yok	Yok
OpenAPI 3.1 & TS Üretimi	Yerleşik	Yok	Yok	Yok	Yok
React 19 Bileşen İhracı	Otomatik	Yok	Yok	Yok	Yok
Hydration Durum Toplama	Yerleşik	Yok	Yok	Yok	Yok
Tailwind v4 Token Üretimi	Yerleşik	Yok	Yok	Yok	Yok
Çevrimdışı Mock Sunucusu	127.0.0.1 Yerleşik	Yok	Yok	Yok	Harici sunucu gerekir
Tek Dosya Bağımsız Çıktı	Var (`_exports/`)	Yok	Var	Yok	Manuel Base64 kodlama
Harici Sürücü İhtiyacı	Sıfır (Yerleşik)	Yok	Yok	Yok	Yüksek (Chromium/Node)
Dağıtım Paketleri	Setup, Portable, MSI	Setup	Tarayıcı Eklentisi	Setup	Yalnızca CLI betiği

Kurulum ve Paket Seçenekleri

WebClone Studio sürümleri üç farklı Windows x64 kurulum seçeneğiyle dağıtılır:

dist/
├── WebClone-Studio-Setup-1.2.0.exe    # Masaüstü ve başlat menüsü kısayollarını içeren NSIS kurulumu (~77.3 MB)
├── WebClone-Studio-Portable.exe       # Kurulum gerektirmeyen tek parça bağımsız çalıştırılabilir dosya (~76.9 MB)
└── WebClone-Studio-1.2.0.msi          # Kurumsal ağlar ve GPO dağıtımı için Microsoft Windows Installer (~87.5 MB)

Portable Sürüm: WebClone-Studio-Portable.exe dosyasını indirin, dilediğiniz bir klasöre veya USB belleğe koyarak doğrudan çalıştırın. Yönetici yetkisi gerektirmez.
Setup Kurulumu: WebClone-Studio-Setup-1.2.0.exe dosyasını çalıştırarak standart Windows kurulumunu tamamlayın.
MSI Paketi: Kurumsal sistem yöneticileri için Active Directory, Microsoft Intune veya Grup İlkesi (GPO) üzerinden toplu dağıtıma uygundur.

Geliştirici Kılavuzu ve Komutlar

# Depoyu yerel ortama çekin
git clone https://github.com/MonarchDevLab/WebClone-Studio.git
cd WebClone-Studio

# Bağımlılıkları kurun
npm install

# HMR destekli geliştirici modunda başlatın
npm run dev

# Katı TypeScript tip denetimini çalıştırın
npm run typecheck

# Birim ve entegrasyon testlerini çalıştırın
npm test

# Üretim derlemesini tamamlayın
npm run build

# Sadece Portable Windows .exe paketini üretin
npm run build:portable

# Sadece NSIS Setup .exe kurulum paketini üretin
npm run build:setup

# Sadece MSI kurulum paketini üretin
npm run build:msi

# Tüm Windows kurulum paketlerini aynı anda derleyin (Setup, Portable, MSI)
npm run build:all

Telif Hakları ve Mülkiyet

Bu yazılım ve tüm mimari mülkiyet hakları istisnasız Monolith Works kuruluşuna aittir.
Açık kaynak ve resmi dağıtım kanalı: MonarchDevLab.

Lisans: MIT License.

Name		Name	Last commit message	Last commit date
.agents/rules		.agents/rules
docs		docs
resources		resources
src		src
tests/main		tests/main
.gitignore		.gitignore
README.md		README.md
electron-builder.yml		electron-builder.yml
electron.vite.config.ts		electron.vite.config.ts
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation