منصوبے کے بارے میں

Cloudflare Computer ایک پیش نظارہ مرحلے کا اوپن سورس پروجیکٹ ہے (MIT لائسنس) جو سافٹ ویئر ایجنٹس کو ایک پائیدار 'کمپیوٹر' فراہم کرتا ہے: ایک ورچوئل فائل سسٹم جس کی مستند حالت Cloudflare Durable Object کے اندر SQLite میں محفوظ ہوتی ہے، نیز workspace.runtime کے ذریعے ایک واحد پلگ ایبل ایگزیکیوشن سطح پیش کی جاتی ہے۔ آج تین ایگزیکیوشن بیک اینڈز فراہم کیے گئے ہیں۔ کنٹینر بیک اینڈ SQLite حالت کو ایک سینڈ باکس کنٹینر میں حقیقی FUSE ماؤنٹ کے طور پر پیش کرتا ہے: computerd نامی سینڈ باکس سائیڈ ڈیمن حالت کو فائل سسٹم کے طور پر ماؤنٹ کرتا ہے اور تبدیلیوں کو capnweb RPC چینل پر واپس ہم آہنگ کرتا ہے، جو حقیقی بائنریز اور حقیقی نیٹ ورک رسائی کے ساتھ مکمل لینکس یوزر لینڈ فراہم کرتا ہے۔ آئسولیٹ شیل بیک اینڈ Dynamic Worker کے اندر صرف bash چلاتا ہے اور Workers RPC پر مستند Workspace تک پہنچتا ہے، اس لیے کوئی دوسرا اسٹور یا ہم آہنگی کا چکر نہیں ہوتا۔ آئسولیٹ JavaScript بیک اینڈ ایک تازہ Dynamic Worker میں ساختی ان پٹ اور نتائج، پائیدار رشتہ دار امپورٹس، ترتیب شدہ لائبریریز، Workspace پر مبنی node:fs/promises، اور قابل اعتماد ws:git اور ws:artifacts ماڈیولز کے ساتھ ECMAScript ماڈیول کا جائزہ لیتا ہے۔ ایک Workspace مستحکم IDs کے تحت متعدد بیک اینڈز رجسٹر کر سکتا ہے۔ workspace.runtime.exec(source, { backend }) واحد ایگزیکیوشن انٹری پوائنٹ ہے، اور منتخب بیک اینڈ اس بات کا تعین کرتا ہے کہ سورس شیل کمانڈ ہے یا ES ماڈیول۔ بیک اینڈز پہلے استعمال پر سست طریقے سے جڑتے ہیں، اور ایک Workspace بغیر کسی بیک اینڈ کے بھی بنایا جا سکتا ہے، جو فائل سسٹم کو خود مختار طور پر ظاہر کرتا ہے۔ پروجیکٹ واضح طور پر PREVIEW ONLY کے طور پر نشان زد ہے: APIs غیر مستحکم ہیں، ڈیزائن تبدیلی کے تابع ہے، اور یہ پروڈکشن استعمال کے لیے موزوں نہیں ہے۔ docs/ کے تحت تفصیلات آگے کی جانب دیکھتی ہیں اور انہیں آج کے کوڈ کی وضاحت کے بجائے ارادے کے طور پر پڑھا جانا چاہیے۔ ریپوزٹری ایک چھوٹا مونو ریپو ہے۔ پیکجز میں @cloudflare/dofs (Durable Object SQLite پر مبنی ورچوئل فائل سسٹم، ہم آہنگی پروٹوکول بلڈنگ بلاکس، اور Node کے لیے @platformatic/vfs فراہم کنندہ)، @cloudflare/computer-rpc (capnweb وائر ٹائپس اور مشترکہ سرور/کلائنٹ مددگار)، @cloudflare/computerd (FUSE ماؤنٹ کے ساتھ HTTP/WebSocket RPC ڈیمن جو سینڈ باکس کنٹینر کے اندر چلتا ہے)، اور @cloudflare/computer (Durable Objects کے ذریعے استعمال ہونے والا اعلیٰ سطحی پیکج) شامل ہیں۔ ایک نجی Docker امیج سیاق و سباق پہلے سے تیار شدہ computerd linux-x64 بائنری فراہم کرتا ہے، جس میں npm پیکج کے بجائے امیج ریلیز آرٹیفیکٹ کے طور پر کام کرتی ہے۔ examples ڈائریکٹری میں قابل عمل Workers شامل ہیں جو عوامی سطح کو ظاہر کرتے ہیں: ایک کنٹینر مثال جس میں write/read/exec HTTP اینڈ پوائنٹس ہیں؛ worker-shell اور worker-javascript مختلف قسمیں جنہیں کنٹینر کی ضرورت نہیں؛ ایک egress مثال جو بیک اینڈز پر کوئی، تمام، اور حسب ضرورت egress پالیسیاں دکھاتی ہے؛ ایک MCP مثال جو پائیدار Workspace، Worker شیل، اور مکمل لینکس کنٹینر کے ذریعے Code Mode کوڈ ٹول ظاہر کرتی ہے؛ ایک rlm مثال جہاں تیار کردہ JavaScript Workspace سے طویل سیاق و سباق پڑھتا ہے، محدود ماڈل Workers کو کال کرتا ہے، اور ان کے ساختی نتائج کو کوڈ کے ساتھ کم کرتا ہے؛ think اور think-compare-runtimes مثالیں جہاں @cloudflare/think چیٹ ایجنٹ اپنی ورکنگ ڈائریکٹری کے طور پر Workspace استعمال کرتا ہے، بشمول ایک ویب UI جو ایک ہی ایجنٹ ٹاسک کو کنٹینر اور Worker رن ٹائمز پر ساتھ ساتھ چلاتا ہے؛ ایک مرحلہ وار ٹیوٹوریل جو مارک ڈاؤن رسیپی کارڈ لکھتا ہے اور PDF تیار کرنے کے لیے کنٹینر میں pandoc چلاتا ہے؛ ایک artifacts مثال جو Workspace میں Worker پروجیکٹ تیار کرتی ہے اور اسے کلون کے لیے تیار ریپو کے طور پر Cloudflare Artifacts پر شائع کرتی ہے؛ اور ایک assets مثال جو Workers AI کے ساتھ پرامپٹ کو تصویر میں بدلتی ہے اور قابل اشتراک لنک واپس کرتی ہے۔ ریپوزٹری docs/19_performance.md میں فائل سسٹم بینچ مارکس شائع کرتی ہے، جہاں پروجیکٹ بیان کرتا ہے کہ computerd کا FUSE ماؤنٹ میٹا ڈیٹا پر بھاری کام میں حقیقی ڈسک کو پیچھے چھوڑ دیتا ہے اور بڑے ترتیب وار I/O پر پیچھے رہ جاتا ہے، جس میں تولیدی ہدایات اور موازنہ شامل ہیں۔ تعاون صرف بگ رپورٹس، فکس تجاویز، فیچر درخواستوں، اور ڈیزائن تجاویز تک محدود ہے جو issues اور discussions کے ذریعے دی جاتی ہیں؛ غیر درخواست شدہ پل ریکویسٹ قبول نہیں کی جاتیں۔ مثال Env اقسام ریپو میں کمٹ کرنے کے بجائے wrangler types کے ساتھ تیار کی جاتی ہیں۔