تصور کنید یک عامل هوش مصنوعی گزارشی ۵۰ مگابایتی تولید کرده است، اما هیچ راهی برای ارسال آن به شما ندارد چون رابط‌های چت محدودیت حجم دارند. این دقیقاً همان جایی است که aispace-client وارد می‌شود تا فاصله میان محیط محلی عامل و مرورگر کاربر را پر کند.
طبق مستندات گیت‌هاب این پروژه، فلسفه اصلی طراحی این ابزار «دوست‌داشتنی بودن برای ربات‌ها» (Bot-friendly) است. این ابزار که در ۷ سپتامبر ۲۰۲۶ منتشر شد، یک رابط خط فرمان (CLI) اسکریپت‌پذیر است که فایل‌ها را به لینک‌های امن و کوتاه‌مدت تبدیل می‌کند. این ابزار مشکلی را حل می‌کند که در آن عامل‌های هوش مصنوعی نمی‌توانند به‌سادگی یک آرشیو JSON ساختاریافته یا یک PDF حجیم را بدون داشتن یک لایه‌ی انتقال اختصاصی برای کاربر «ایمیل» کنند. به این ترتیب، عامل‌ها می‌توانند بدون گیر افتادن در پرامپت‌های تعاملی، خروجی‌های ساختاریافته یا آرشیوهای JSON را مستقیماً و به‌طور بهینه به کاربر تحویل دهند.
بسیاری از عامل‌های هوش مصنوعی با مسئله ماندگاری فایل‌ها و اشتراک‌گذاری آن‌ها دست‌وپنجه نرم می‌کنند؛ چراکه رابط‌های چت محدودیت‌های سخت‌گیرانه‌ای در مورد حجم دارند و هیچ راه بومی برای مدیریت دارایی‌های موقتی که پس از مدتی منقضی شوند، ارائه نمی‌دهند. تصور کنید یک عامل در حال تولید یک گزارش داده‌ای عظیم است؛ او به راهی نیاز دارد تا آن فایل را به‌طور موقت میزبانی کند و لینکی به انسان بدهد که پس از یک ساعت ناپدید شود. همان‌طور که در تحلیل‌های قبلی ما درباره‌ی زیرساخت‌های عامل‌محور اشاره کردیم، نبود لایه‌ی انتقال داده، یکی از بزرگ‌ترین گلوگاه‌های بهره‌وری در سیستم‌های خودکار است. این رویکرد در راستای تلاش برای جلوگیری از وابستگی به اکوسیستم‌های بسته است تا کنترل جریان داده‌ها در دست توسعه‌دهنده باقی بماند.
طراحی اولویت‌محور برای اتوماسیون
این ابزار به‌جای تایپ انسانی، برای مصرف ماشین‌ها مهندسی شده است. aispace-client از یک فایل باینری واحد با کدهای خروجی (Exit Codes) پایدار استفاده می‌کند و از آپلودهای استریم از دیسک یا ورودی استاندارد (stdin) پشتیبانی می‌کند. طبق اعلام توسعه‌دهندگان، وقتی یک عامل فایلی را آپلود می‌کند، لینک اشتراک در آخرین خط خروجی چاپ می‌شود تا یک اسکریپت شل یا یک مدل زبانی بزرگ (LLM) — مثل کتابخانه‌داری که میلیاردها صفحه را خوانده و حالا با همان لحن کتاب‌ها جواب می‌دهد — بتواند به‌راحتی آن را استخراج کند.
برای کسانی که به داده‌های ساختاریافته نیاز دارند، فلگ --json یک پاسخ پایدار ارائه می‌دهد. یک پاسخ معمولی شامل شناسه فایل (File ID)، نام، URL و زمان دقیق انقضا به صورت Timestamp (مثلاً ۱۷۵۷۰۰۳۶۰۰) است. این قابلیت نیاز عامل‌ها به «حدس زدن» یا تجزیه متن‌های نامنظم لاگ را به‌طور کامل از بین می‌برد.
مکانیزم‌های CLI و جریان‌های کاری
این ابزار انعطاف‌پذیری بالایی در نحوه دریافت و اشتراک داده‌ها دارد. کاربران می‌توانند متن را مستقیماً از stdin پاس دهند؛ برای مثال با دستور: echo "hello" | aispace upload - --name note.txt --link --link-expires 1h. برای نیازهای پیچیده‌تر، دستور upload طیف گسترده‌ای از فلگ‌ها از جمله --content-type برای تعیین نوع محتوا، --sha256 برای تایید یکپارچگی، --recipient برای تعیین گیرنده و --expires برای زمان انقضای فایل را می‌پذیرد.
مدیریت این فایل‌ها از طریق مجموعه‌ای از دستورات اختصاصی انجام می‌شود:
aispace ls --json: فهرست فایل‌ها را در قالب ماشین‌خوان نمایش می‌دهد.aispace download <file_id> --verify: فایل را دانلود کرده و هش SHA-256 ثبت شده را بررسی می‌کند تا از صحت فایل اطمینان حاصل شود.aispace link <file_id> --expires 30m --max-downloads 1: پارامترهای لینک را به‌روزرسانی می‌کند (مثلاً انقضا در ۳۰ دقیقه و محدودیت به یک بار دانلود).aispace revoke <link_id>وaispace rm <file_id>: چرخه حیات دارایی‌ها را مدیریت کرده و امکان ابطال لینک یا حذف کامل فایل را فراهم می‌کنند.
لایه‌های امنیتی و حریم خصوصی
حریم خصوصی بسته به سطح حساب کاربر در سه حالت متمایز مدیریت می‌شود:
- ذخیره‌سازی خصوصی (Private Storage): فایل‌ها فقط برای کلید آپلودکننده قابل دسترسی هستند و به‌طور پیش‌فرض پس از ۷ روز منقضی می‌شوند. این حالت محدود به سقف ماهانه حساب کاربر است.
- اشتراک حساب (Account-Shared): فایل‌ها برای تمام کلیدهای فعال در یک حساب واحد در دسترس هستند. زمان ماندگاری پیش‌فرض ۷ روز است که برای کاربران Pro تا ۳۰ روز افزایش می‌یابد.
- انتقال عمومی (Public Handoffs): حساب‌های Pro می‌توانند لینک‌های عمومی با زمان انقضای سفارشی (تا ۳۰ روز) و سقف تعداد دانلود ایجاد کنند. این لینک‌ها قابلیت‌هایی مجزا از خودِ فایل هستند.
یکی از حیاتی‌ترین ویژگی‌های امنیتی، ادغام رمزنگاری age X25519 است. بر اساس مستندات فنی، وقتی فلگ --encrypt فعال باشد، کلاینت فایل را به‌صورت محلی رمزنگاری می‌کند. هویت رمزگشایی (Decryption Identity) هرگز به سرورهای aispace نمی‌رسد و سرویس تنها متن رمزگذاری‌شده را با پسوند .age ذخیره می‌کند. این یعنی حتی در صورت نفوذ به سرور یا به خطر افتادن سرویس میزبانی، متن اصلی (Plaintext) امن می‌ماند. کاربران می‌توانند هویت خود را به‌صورت محلی با دستور --identity-out secret.agekey ذخیره کنند.
ادغام با عامل‌ها و مهارت‌ها
برای کاربردی کردن این ابزار برای LLMها، یک مهارت (Skill) سازگار با Codex در مخزن پروژه گنجانده شده است. کاربران می‌توانند با کلون کردن مخزن و ایجاد یک لینک نمادین (Symbolic Link) در دایرکتوری ~/.codex/skills با دستور ln -s "$PWD/aispace-client/skills/aispace" ~/.codex/skills/aispace این قابلیت را به عامل خود اضافه کنند. این کار به عامل اجازه می‌دهد به‌طور خودکار تصمیم بگیرد چه زمانی از aispace برای ارسال گزارش‌ها، آرشیوها یا تصاویر استفاده کند.
همچنین برای محیط‌های اجرای سفارشی (Custom Runtimes)، توسعه‌دهندگان طرح‌های ابزار (Tool Schemas) سازگار با OpenAI و Anthropic را ارائه کرده‌اند. این امر به برنامه‌نویسان اجازه می‌دهد تا CLI را در هر جریان کاری عامل‌محور با استفاده از یک هندلر پایتون مرجع (که در docs/LLM_USAGE.md موجود است) ادغام کنند. سیستم به‌طور پیش‌فرض اولویت را به ذخیره‌سازی خصوصی می‌دهد، مگر اینکه صراحتاً لینک عمومی درخواست شود تا امنیت در اولویت باشد. این انعطاف‌پذیری در طراحی، مشابه همان منطقی است که در زیرساخت‌های ماژولار برای حفظ کنترل بر وزن‌های مدل دنبال می‌شود تا سازمان‌ها از وابستگی مطلق به یک ارائه‌دهنده رها شوند.
مشخصات فنی و نصب
این ابزار از چندین مسیر نصب پشتیبانی می‌کند: از طریق npm install -g @aispace-sh/cli، یا brew install aispace-sh/tap/aispace و همچنین go install github.com/aispace-sh/aispace-client@latest. این ابزار با سیستم‌عامل‌های macOS، لینوکس و ویندوز (معماری‌های amd64 و arm64) سازگار است. نصب‌کننده شل (Shell Installer) از macOS و لینوکس پشتیبانی می‌کند، در حالی که به کاربران ویندوز توصیه می‌شود از npm استفاده کنند.
پیکربندی ابزار از یک سلسله‌مراتب سخت‌گیرانه پیروی می‌کند: فلگ‌های خط فرمان > متغیرهای محیطی > فایل تنظیمات > پیش‌فرض. متغیرهای محیطی کلیدی شامل AISPACE_KEY و AISPACE_URL (که پیش‌فرض آن https://aispace.sh است) هستند. فایل تنظیمات در مسیر $XDG_CONFIG_HOME/aispace/config.json (به‌طور پیش‌فرض ~/.config/aispace/config.json) ذخیره می‌شود و برای امنیت بیشتر با مود 0600 نوشته می‌شود.
مدیریت خطا و کدهای خروجی
سیستم خطای ابزار به‌گونه‌ای طراحی شده که خطاهای JSON ساختاریافته در stderr نوشته می‌شوند تا خروجی stdout (که حاوی لینک است) آلوده نشود و عملیات کپچر کردن لینک توسط ربات‌ها مختل نگردد. کدهای خروجی برای اتوماسیون استاندارد شده‌اند:
- ۰: موفقیت (Success)
- ۱: خطای عمومی (مانند مشکلات شبکه یا خطاهای 4xx/5xx)
- ۲: خطای استفاده (Usage error)
- ۳: خطای احراز هویت (خطای 401 یا نبود کلید)
- ۴: محدودیت سهمیه یا حجم (خطاهای 402 یا 413)
- ۵: محدودیت نرخ درخواست (Rate Limit - خطای 429)، که باعث ایجاد یک وقفه (Sleep) بر اساس هدر
Retry-After(حداکثر ۳۰ ثانیه) و یک بار تلاش مجدد برای درخواست‌های GET می‌شود.
مدت‌زمان و چرخه حیات
مدت‌زمان برای فلگ‌های --expires و --link-expires با سینتکس Go و پسوند d پذیرفته می‌شود؛ مانند 30s (ثانیه)، 15m (دقیقه)، 1h (ساعت)، 36h، 7d (روز) یا 1d12h. اگر مقداری تعیین نشود، پیش‌فرض سرور برای فایل‌ها ۷ روز و برای لینک‌ها ۱ ساعت است. یک فایل زمانی غیرقابل دسترس می‌شود که طول عمرش به پایان برسد، اما یک لینک می‌تواند زودتر از طریق ابطال (Revocation) یا رسیدن به سقف تعداد دانلود منقضی شود.
این چرخش به سمت ابزارهای «محورِ انتقال» (Handoff-centric) نشان می‌دهد که فاز بعدی هوش مصنوعی عامل‌محور، تنها درباره استدلال بهتر نیست، بلکه درباره لجستیک بهتر است. با تبدیل اشتراک فایل به یک ابزار درجه‌یک، توسعه‌دهندگان می‌توانند عامل‌ها را از چت‌بات‌های ساده به شرکای بهره‌وری واقعی تبدیل کنند که می‌توانند محصولات کاری ملموس را تحویل دهند. این تحول در واقع بخشی از یک استراتژی گسترده‌تر برای پایان دادن به وابستگی سازمان‌ها به فروشندگان ابری از طریق لایه‌های عملیاتی باز است.
گام بعدی شما
- اگر در حال ساخت خط لوله‌های خودکار هستید، فایل
docs/LLM_USAGE.mdرا برای پیاده‌سازی طرح‌های ابزار در محیط خود بررسی کنید. - برای افزایش امنیت داده‌های حساس، از فلگ
--encryptبرای رمزنگاری محلی پیش از آپلود استفاده کنید. - مهارت‌های Codex را به عامل خود اضافه کنید تا قابلیت ارسال فایل به‌صورت خودکار فعال شود.
اما داستان سخت‌افزاری این تحول حتی شگفت‌انگیزتر است — به تحلیل ما درباره‌ی تراشه‌های Blackwell مراجعه کنید.
گفتگو