ما Kitesurf، مرورگر بدونوضعیت خود برای عاملهای هوش مصنوعی را که کاملاً روی Workers اجرا میشود، در اوت معرفی کردیم و در سپتامبر با پشتیبانی از WebMCP، APIهای تازه و سازگاری بهتر آن را بهروزرسانی کردیم. در هر دو مرحله بر تعهدمان به متنباز کردن آن تأکید کردیم تا توسعهدهندگان بتوانند در صورت تمایل، موتور مرورگر خودشان را روی حساب Cloudflare خودشان اجرا کنند.
این وعده اکنون محقق شده است. Kitesurf با مجوز Apache 2.0 روی GitHub متنباز شده است. میتوانید کد را بخوانید، بهصورت محلی اجرا کنید، تغییر دهید و نسخهٔ خودتان را روی Cloudflare Workers مستقر کنید.
مرورگری ساختهشده برای عاملها
Kitesurf کاملاً روی Cloudflare Workers اجرا میشود. این مرورگر HTML را تجزیه میکند، CSS را اعمال میکند، JavaScript صفحه را اجرا میکند و بدون نیاز به کانتینر مرورگر، اسکرینشات میسازد. از Chrome DevTools Protocol (CDP) پشتیبانی میکند، بنابراین میتوانید کلاینتهایی مانند Puppeteer را به آن متصل کنید.
هدف اصلی ما این است که به عاملهای هوش مصنوعی مرورگری سبک و کارآمد بدهیم؛ مرورگری که بتواند وبسایتها را بارگذاری کند، JavaScript را اجرا کند و با صفحهها تعامل داشته باشد، در حالی که نسبت به یک مرورگر کامل مانند Chromium پردازنده و حافظهٔ کمتری مصرف میکند و بهصورت درخواستی روی شبکهٔ جهانی Workers در Cloudflare مقیاس میگیرد.
برای آشنایی بیشتر با دلیل و شیوهٔ ساخت Kitesurf، اعلامیهٔ اولیهٔ ما و مستندات توسعهدهندگان Browser Run را بخوانید.
مخزن چه چیزهایی را در خود دارد؟
Kitesurf بر بستر پلتفرم توسعهدهندگان و APIهای Cloudflare و در کنار مجموعهای از بستههای متنباز Rust که به WebAssembly کامپایل شدهاند ساخته شده است:
Blitz تجزیهٔ HTML، DOM، چیدمان و ترسیم را فراهم میکند.
Stylo تجزیهٔ CSS، آبشاری و سبکهای محاسبهشده را فراهم میکند.
Boa JavaScript را داخل WebAssembly اجرا میکند (فقط بهعنوان آخرین راهحل، وقتی نمیتوانیم JavaScript را در Dynamic Workers اجرا کنیم).
کتابخانههای Linebender چیدمان متن و گرافیک دوبعدی را فراهم میکنند و Krilla خروجی PDF تولید میکند.
همین پروژهها ساخت Kitesurf را ممکن کردند. هر یک مجوز خودش را حفظ میکند؛ فایل NOTICE در مخزن، اعلامیههای شخص ثالث را مستند میکند.
Kitesurf سه بخش اصلی دارد: Engine نشستهای مرورگر و اتصال کلاینتها را مدیریت میکند، PageScript صفحه و JavaScript آن را اجرا میکند و PageRenderer نتیجه را ترسیم میکند.
همهٔ بستهها، یعنی Engine، هستهٔ Rust آن، لایههای سازگارساز DOM، رندرر و Kitesurf CLI، جداگانه در پوشههایی زیر پوشهٔ packages در مخزن قرار دارند؛ همانجا میتوانید ببینید این اجزا چگونه به هم وصل میشوند.
Kitesurf خودتان را اجرا کنید
برای اجرای محلی Kitesurf، ابتدا پیشنیازهای ساخت را که در مخزن آمده رعایت کنید، سپس مخزن را clone کنید، وابستگیها را نصب کنید و Engine را راه بیندازید:
git clone https://github.com/cloudflare/kitesurf.git
cd kitesurf
pnpm install --frozen-lockfile
pnpm run devساخت اول هستهٔ Rust و وابستگیهایش را کامپایل میکند، پس کمی زمان میبرد. ساختهای بعدی از کش ساخت استفاده میکنند. در پایان، wrangler یک سرور توسعهٔ محلی روی http://127.0.0.1:8787 راه میاندازد. همین نشانی را باز کنید تا صفحهای را در Chrome DevTools امتحان کنید، یا از آن بهصورت برنامهنویسی استفاده کنید.
میتوانید Puppeteer را با یک اسکریپت NodeJS به کار ببرید:
import puppeteer from "puppeteer-core";
const browser = await puppeteer.connect({
browserWSEndpoint: "ws://127.0.0.1:8787/devtools/browser",
});
try {
const page = await browser.newPage();
await page.goto("https://example.com/");
await page.screenshot({ path: "page.png" });
} finally {
await browser.disconnect();
}یا میتوانید چارچوب عامل هوش مصنوعی خود را به پورت محلی CDP وصل کنید (عاملها عاشق CDP هستند) و ببینید چطور کنترل کامل Kitesurf را در دست میگیرد.
روی حساب Cloudflare خود مستقر کنید
وقتی تغییرات و آزمایشهای محلی تمام شد، میتوانید Engine را روی حساب خودتان مستقر کنید و از آنجا بهجای APIهای مدیریتشدهٔ Browser Run که ارائه میدهیم از Kitesurf استفاده کنید. توجه کنید که طرح Workers Paid لازم است، چون Kitesurf از Dynamic Workers برای ساختن Workers جداگانه برای هر صفحه استفاده میکند.
از ریشهٔ مخزن:
pnpm run deployکمک کنید بهترش کنیم
مثل همهٔ پروژههای متنباز ما، Kitesurf در GitHub قرار دارد و از fork و مشارکت استقبال میکنیم. با این حال توجه داشته باشید که Kitesurf در حال توسعهٔ سنگین است و تمرکز ما بر سازگاری بیشتر موتور (روند تغییرات Web Platform Tests را ببینید)، پایداری و کارایی است.
اگر میخواهید مشارکت کنید، از راهنمای مشارکت شروع کنید. یک issue با بازتولید حداقلی یا رویکرد پیشنهادی باز کنید و پیش از ارسال pull request، تأیید یک نگهدارنده را بگیرید. اصلاحات متمرکز همراه با آزمون، شواهد روشن و دامنهٔ مشخص، بسیار آسانتر از بازنویسیهای بزرگ یا پاکسازیهای نامرتبط بررسی میشوند؛ اما همهٔ مشارکتها لازم نیست کد باشد: یک صفحهٔ کوچک که باگ رندر را بازتولید کند، یک گردشکار خودکارسازی که شکست میخورد، یا یک اصلاح روشن در مستندات میتواند ما را جلو ببرد.
منتظر بمانید
Kitesurf بهسرعت در حال تحول است. برای اطلاع از بهروزرسانیها، وبلاگ و changelog را دنبال کنید و صفحهٔ رسمی معرفی را برای آخرین اخبار دربارهٔ سازگاری با استانداردها در صفحهٔ Web Platform Tests و بنچمارکها زیر نظر داشته باشید.
و در Discord با تیم گفتوگو کنید. ما در حال ساختن مرورگری برای عاملها هستیم و خوشحال میشویم در بهتر کردن آن کمکمان کنید.



