تصور کنید یک عامل هوش مصنوعی گزارشی جامع در قالب HTML برای شما می‌نویسد، اما شما باید دقایقی را صرف آپلود دستی آن در یک میزبان وب کنید تا دیگران آن را ببینند. Pagecast که در ۱۸ ژوئن ۲۰۲۶ منتشر شد، این اصطکاک را حذف می‌کند و اجازه می‌دهد دست‌ساخته‌های محلی را مستقیماً از ترمینال یا محیط کدنویسی به آدرس‌های قابل اشتراک در Cloudflare Pages تبدیل کنید. اپلیکیشن زنده این ابزار در آدرس https://pagecasthq.pages.dev/ در دسترس است.
برای بسیاری از توسعه‌دهندگان، جریان کاری فعلی برای محتوای «عامل‌محور» پراکنده است. یک عامل (Agent) — مانند دستیاری هوشمند که می‌تواند به‌طور مستقل وظایف را پیش ببرد — فایلی را در دیسک محلی شما می‌سازد و شما باید تصمیم بگیرید چگونه آن را بدون راه-اندازی یک خط لوله پیچیده CI/CD به اشتراک بگذارید. Pagecast با ایجاد یک لایه انتزاعی سبک روی زیرساخت کلادفلر، یک پوشه محلی را تنها با یک دستور به یک سایت زنده تبدیل می‌کند. این رویکرد یادآور تلاش‌های مشابه برای ساده‌سازی خروجی‌های هوش مصنوعی است، مانند راهکار Stacktree برای انتشار خصوصی که گسست میان تولید محتوا توسط عامل‌ها و نمایش آن را کاهش می‌دهد.
همان‌طور که در تحلیل‌های پیشین ما درباره‌ی اکوسیستم ابزارهای توسعه‌ی عامل‌محور اشاره کردیم، سرعت تبدیل «فکر» مدل به «محصول» قابل مشاهده، کلید بهره‌وری در عصر جدید است.
زمینه‌ها و موارد کاربرد
این ابزار به‌ویژه به عنوان یک ابزار انتشار «ابتدا-محلی» (local-first) برای گزارش‌های تولیدشده توسط عامل‌ها و پروژه‌های وب استاتیک کوچک طراحی شده است. طبق مستندات پروژه، Pagecast برای طیف متنوعی از خروجی‌های فنی ایده‌آل است:
- گزارش‌ها: شامل گزارش‌های HTML، داشبوردها، خروجی‌های پوشش کد (coverage output) and گزارش‌های تخصصی Lighthouse یا Playwright.
- مستندات: طرح‌های Markdown، پیشنهادهای فنی (proposals)، یادداشت‌های انتشار (release notes)، خلاصه‌ها و مستندات عمومی.
- مینی‌اپ‌ها: پروژه‌های وب استاتیکی که از پوشه‌های ساخت (build folders) مانند
dist،build،outیاpublicخروجی می‌گیرند. - جریان‌های کاری عامل‌ها: روتین‌های کدنویسی عامل‌هایی که باید قبل از انتشار نهایی یک اثر (artifact)، از کاربر انسانی تأییدیه بگیرند.
البته این ابزار برای هر کاری نیست و برای تمام حجم‌های کاری مناسب نیست. Pagecast برای پیش‌نویس‌های خصوصی، یادداشت‌های سریع (scratch notes) یا اپلیکیشن‌هایی که نیاز به اجرای کد در سمت سرور دارند (مانند سرویس‌های Python، Ruby یا Node) مناسب نیست و نمی‌تواند بک‌اند فعال را پشتیبانی کند. این سرویس‌ها تنها در صورتی سازگار هستند که ابتدا دارایی‌های استاتیک (static assets) خود را استخراج کرده و خروجی بگیرند.
سازوکار فنی
Pagecast یک ابزار محلی است که به Node.js نسخه ۲۰ یا جدیدتر نیاز دارد. این ابزار از npx برای اجرا در یک دستور استفاده می‌کند و داده‌های محلی و تنظیمات را در پوشه .pagecast/ در دیسک جاری شما ذخیره می‌کند. برای اطمینان از اینکه آنچه شما محلی می‌بینید دقیقاً همان چیزی است که مخاطب می‌بیند، از یک ساختار سرور دوگانه استفاده می‌کند:
- رابط کاربری مدیریت (پورت ۴۱۷۳): یک داشبورد مبتنی بر React برای مدیریت نسخه‌های منتشرشده، تغییر نام لینک‌ها و ابطال URLها. این رابط کاربری از پوشه
web/بهpublic/بیلد شده و در بسته نرم‌افزاری گنجانده شده است. - سرور پیش‌نمایش (پورت ۴۱۷۴): سروری اختصاصی که ساختار URLهای Cloudflare Pages (مانند
/p/<slug>/) را شبیه‌سازی می‌کند تا پیش‌نمایش دقیقی از استقرار ارائه دهد. مسیر ریشه (root) این سرور خطای ۴۰۴ برمی‌گرداند و نقطه اتصال/healthzمنحصراً برای بررسی وضعیت فعال بودن سرور استفاده می‌شود.
جریان‌های استقرار
به نقل از مستندات گیت‌هاب Amal-David، این ابزار سه مسیر اصلی برای انتشار دارد. برای شروع، کاربران می‌توانند حساب خود را از طریق OAuth محدودشده Wrangler (با دسترسی‌های account:read، user:read و pages:write) با کلیک روی «Connect Cloudflare» در رابط کاربری، یا از طریق ترمینال با دستور npx pagecast pages setup --project pagecast متصل کنند:
۱. انتشار تک‌فایل: شما می‌توانید یک فایل HTML یا Markdown خاص را با دستور npx pagecast publish "/absolute/path/report.html" --json ارسال کنید. این کار یک لینک توکن‌دار منحصربه‌فرد ایجاد می‌کند.
۲. اسنپ‌شات پروژه‌های استاتیک: با بیلد کردن یک پروژه (مثلاً npm run build) و سپس انتشار فایل ورودی ایجاد شده (مثلاً npx pagecast publish "$(pwd)/dist/index.html" --json)، Pagecast دارایی‌های هم‌تراز (sibling assets) را از پوشه build برداشته و یک اسنپ‌شات قابل اشتراک می‌سازد.
۳. استقرار کامل سایت: این ابزار دستورات خام Wrangler را بسته‌بندی می‌کند و به کاربران اجازه می‌دهد کل دایرکتوری‌ها را در یک پروژه نام‌گذاری‌شده از طریق دستور npx pagecast pages deploy "$(pwd)/dist" --project pagecasthq --json مستقر کنند. این روش با ساده‌سازی مشخصات پروژه و شاخه (branch) هدف، دستورات پیچیده دستی Wrangler را جایگزین می‌کند.
برای اتوماسیون، کاربران می‌توانند با استفاده از یک توکن API محدودشده کلادفلر با دسترسی «Account > Cloudflare Pages > Edit» که از طریق متغیرهای محیطی CLOUDFLARE_API_TOKEN و CLOUDFLARE_ACCOUNT_ID پاس داده می‌شود، رابط کاربری OAuth را دور بزنند.
ادغام با عامل‌ها و مرورگر
Pagecast فراتر از یک CLI، به‌طور خاص برای عصر هوش مصنوعی عامل‌محور (Agentic AI) ساخته شده است. این ابزار شامل یک مهارت بومی Codex و یک مهارت قابل انتقال برای Claude Code است که به یک مدل زبانی بزرگ (LLM) — شبیه کتابخانه‌داری که میلیاردها صفحه را خوانده و حالا با همان لحن جواب می‌دهد — اجازه می‌دهد پس از تأیید صریح کاربر، پیشنهاد انتشار اثر نهایی را بدهد.
- ادغام Codex: کاربران می‌توانند پوشه
.codex/skills/publish-reportرا به مسیر~/.codex/skills/کپی کنند و از عامل بخواهند: «از $publish-report برای انتشار /path/report.md استفاده کن». - Claude Code: ادغام از طریق دستور
/plugin marketplace add Amal- Adding-David/pagecastانجام می‌شود که قلاب تشخیص گزارش (report-detection hook) و مهارت قابل انتقال را نصب می‌کند.
برای بسته کردن کامل این چرخه، ابزار شامل یک افزونه کروم است. وقتی یک عامل فایلی را ذخیره می‌کند و شما آن را به صورت file:///.../report.html باز می‌کنید، افزونه دکمه «Publish to Pagecast» را اضافه می‌کند. این دکمه فایل محلی را از طریق نقطه اتصال POST /api/publish-local { path } به سرور Pagecast در حال اجرا می‌فرستد (که CORS را تنها برای مبدا chrome-extension:// باز می‌کند) و سپس عملیات آپلود کلادفلر را مدیریت می‌کند.
جزئیات و ویژگی‌های مدیریتی
قابلیت‌های مدیریت:
- افزودن محتوا: کاربران می‌توانند فایل‌های
.html،.htm،.mdو.markdownرا از طریق مسیرهای مطلق یا URLهایfile:///و همچنین پوشه‌های استاتیک قابل استقرار اضافه کنند. - ساخت (Building): پشتیبانی از افزودن پوشه‌های منبع با دستورات بیلد صریح و تعیین دایرکتوری خروجی.
- سازماندهی: کاربران می‌توانند برای تغییر ترتیب گزارش‌ها، فایل‌ها را به‌صورت کشیدن و رها کردن (drag-and-drop) جابه‌جا کنند.
- کنترل چرخه حیات: قابلیت انتشار URLهای قابل اشتراک، ابطال نسخه‌های خاص یا ابطال تمامی نسخه‌های یک گزارش. توکن‌های ابطال شده پس از اتمام بازنشر، خطای ۴۰۴ برمی‌گردانند.
- مدیریت URL: لینک‌ها قابل تغییر نام هستند و سیستم به‌طور خودکار لینک‌های قدیمی را به مسیر جدید هدایت (redirect) می‌کند.
- همگام‌سازی: کاربران می‌توانند یک صفحه را در جای خود مجدداً همگام‌سازی کنند یا برای گزارش‌های مبتنی بر مسیر، همگام‌سازی خودکار (auto-sync) را فعال کنند.
- ویرایش درون‌برنامه‌ای: کدهای HTML را می‌توان مستقیماً در اپلیکیشن ویرایش کرد بدون اینکه فایل منبع اصلی بازنویسی شود.
معماری فنی:
- چیدمان پروژه: پوشه
src/شامل CLI و سرور Node است، در حالی کهweb/شامل سورس Vite + React است. پوشه‌هایplugin/و.codex/میزبان ادغام‌های عامل-محور هستند. - توسعه: رابط کاربری React با استفاده از Vite روی پورت ۵۱۷۳ توسعه یافته و درخواست‌ها را به سرور محلی در پورت ۴۱۷۳ پروکسی می‌کند.
- تأییدیه: کدبیس شامل یک مجموعه کامل تست Node در پوشه
test/و یک مجموعه تأییدیه برای نسخه‌های انتشار یافته است.
امنیت و مدیریت
با توجه به اینکه URLهای عمومی می‌توانند یک ریسک (liability) باشند، رابط مدیریت اجازه ابطال توکن‌های نسخه‌های خاص یا تمام نسخه‌های یک گزارش را می‌دهد. برای امنیت بیشتر، ابزار رابط مدیریت را تنها به 127.0.0.1 متصل (bind) می‌کند تا پیش‌نمایش‌های پیش‌نویس محلی بمانند و تنها محتوایی که صراحتاً منتشر شده به وب برسد. مسیرهای عمومی گزارش‌ها به‌گونه‌ای طراحی شده‌اند که درخواست‌های Traversal دایرکتوری (دسترسی به پوشه‌های والد) را رد کنند تا از نشت تصادفی داده‌ها جلوگیری شود.
گزارش‌های مبتنی بر مسیر و اسنپ‌شات‌ها، دارایی‌های هم‌تراز غیرپنهان (non-hidden) را از پوشه گزارش شامل می‌شوند؛ این یعنی هر فایلی در آن پوشه اگر ارجاع داده شود یا حدس زده شود، می‌تواند عمومی شود. با این حال، ریشه Pages برای جلوگیری از خزش دایرکتوری (directory crawling)، لیست گزارش‌ها را منتشر نمی‌کند.
این تغییر در تجربه توسعه‌دهنده به این معناست که «اثر» دیگر یک فایل ایستا روی هارد نیست، بلکه یک URL زنده است. با کاهش هزینه انتشار به تقریباً صفر، Pagecast اشتراک‌گذاری نتایج میانی تولیدشده توسط هوش مصنوعی را تشویق می‌کند.
برای توسعه‌دهندگان، این ابزار بدهی فنی (technical debt) مدیریت ده‌ها سایت استاتیک کوچک را حذف می‌کند. این ابزار Cloudflare Pages را به یک دفترچه طراحی (sketchbook) عظیم و سازمان‌یافته برای آزمایشات AI تبدیل می‌کند. شما دیگر مجبور نیستید بین یک فایل محلی خصوصی و یک فرآیند استقرار رسمی انتخاب کنید؛ بلکه یک فضای میانی برای تکرار سریع (rapid iteration) دارید.
برای شروع، شما به یک حساب کلادفلر و یک ترمینال با npx نیاز دارید. می‌توانید با اجرای npx pagecast pages setup --project pagecast و اتصال حساب خود از طریق OAuth محدودشده، تنظیمات را آغاز کنید. Pagecast تحت لایسنس MIT منتشر شده است.
گام بعدی شما
- اگر از Claude Code استفاده می‌کنید، پلاگین Pagecast را نصب کنید تا خروجی‌های کدنویسی را فوراً به لینک تبدیل کنید.
- برای گزارش‌های تکرارپذیر، از متغیرهای محیطی
CLOUDFLARE_API_TOKENاستفاده کنید تا فرآیند انتشار را کاملاً خودکار کنید. - افزونه کروم را نصب کنید تا فایل‌های محلی تولیدی توسط AI را با یک کلیک منتشر کنید.
اما اثر این ابزار بر نحوه تعامل ما با مستندات زنده حتی عمیق‌تر است؛ برای درک لایه‌های زیرساختی این تحول، تحلیل ما درباره معماری رایانش لبه را بخوانید.
گفتگو