✦ Darkoza

راهنمای عملی کاربران · نسخهٔ ۱٫۰ · ۱۱ نوامبر ۲۰۲۶

راهنمای کار با فایل‌ها در Darkoza؛ از پیوست تا تحلیل قابل‌بررسی

وقتی پاسخ باید بر اساس یک سند، گزارش، جدول متنی یا قطعه‌کد باشد، فایل را همراه با هدف دقیق بفرستید. این راهنما نشان می‌دهد در نسخهٔ فعلی Darkoza چه قالب‌هایی خوانده می‌شوند، چه محدودیت‌هایی وجود دارد، دقیقاً چه داده‌ای ارسال می‌شود و چطور نتیجه را با فایل اصلی تطبیق دهید.

زمان مطالعه: حدود ۷ دقیقهمخاطب: کاربران تازه‌وارد و فعلیآخرین بازبینی: ۱۱ نوامبر ۲۰۲۶

۱. چه فایل‌هایی در مسیر فعلی پشتیبانی می‌شوند؟

قابلیت پیوست فعلی، متن را از فایل استخراج می‌کند؛ بنابراین متن، کد، PDF دارای لایهٔ متنی و سند Word با قالب DOCX مناسب‌اند. پشتیبانی از یک پسوند به معنی پشتیبانی از هر نوع محتوای داخل آن فایل نیست؛ برای مثال تصویرِ جاسازی‌شده در سند یا PDF اسکن‌شده ممکن است متن قابل‌خواندن نداشته باشد.

نوع ورودینمونهٔ قالب‌هانکتهٔ مهم
متن و یادداشت.txt، .md، .markdown، .logبرای دستورالعمل، یادداشت، گزارش خطا و پیش‌نویس مناسب است.
دادهٔ متنی.csv، .tsv، .json، .jsonl، .xml، .yaml، .tomlساختار ستون‌ها، کلیدها، واحدها و معنی مقادیر را در پیام توضیح دهید.
کد و پیکربندی.py، .js، .ts، .html، .css، .sql و چند قالب متنی دیگرنسخهٔ زبان، محیط اجرا، خطای دیده‌شده و رفتار مورد انتظار را نیز بنویسید.
سند و گزارشPDF متنی و Word با قالب .docxPDF باید متن قابل‌استخراج داشته باشد؛ تصویر اسکن‌شده به‌صورت خودکار OCR نمی‌شود.

در حال حاضر فایل‌های صفحه‌گستردهٔ .xlsx، تصویر، صوت، ویدئو و PDF فاقد متن قابل‌استخراج در این مسیر پشتیبانی نمی‌شوند. اگر داده در Excel یا برنامهٔ مشابه است، فقط برگه و ستون‌های لازم را به CSV یا TSV صادر کنید. برای فایل اسکن‌شده، ابتدا نسخهٔ متنیِ قابل‌جست‌وجو تهیه کنید؛ خروجی OCR را پیش از ارسال با اصل سند تطبیق دهید.

۲. سقف اندازه و متن را پیش از انتخاب فایل بشناسید

حداکثر ۸ فایل

هر پیام می‌تواند تا هشت فایل پیوست داشته باشد.

۱ مگابایت برای هر فایل

فایل باید بزرگ‌تر از صفر و حداکثر ۱ مگابایت باشد.

۱۰٬۰۰۰ نویسه برای هر فایل

از متن استخراج‌شدهٔ هر فایل حداکثر ده‌هزار نویسه وارد درخواست می‌شود.

۸۰٬۰۰۰ نویسه در مجموع

سقف مجموع متن استخراج‌شده از پیوست‌ها در یک پیام هشتاد‌هزار نویسه است.

این محدودیت‌ها مهم‌اند: متن هر فایل پس از استخراج به ۱۰هزار نویسهٔ نخست محدود می‌شود؛ بنابراین در یک گزارش طولانی، ممکن است بخش‌های بعدی اصلاً وارد درخواست نشوند. نباید فرض کنید تمام صفحات یا تمام متن سند به مدل رسیده است. برای بررسی دقیق، نسخه‌ای کوچک‌تر از بخش موردنیاز آماده کنید یا سند را به چند بخش معنادار تقسیم کنید و هر بار پرسش مشخصی بپرسید. تقسیم فایل باید طوری باشد که عنوان‌ها، تعریف‌ها و زمینهٔ لازم از بخش اصلی جدا نشوند.

اگر پیام خطای اندازه یا قالب دریافت کردید، فایل را کوچک‌تر کنید، بخش غیرضروری را حذف کنید یا از قالب متنی پشتیبانی‌شده استفاده کنید. تغییر پسوند به‌تنهایی، قالب ناسازگار را به قالب پشتیبانی‌شده تبدیل نمی‌کند.

۳. فایل را اضافه کنید و پیش از ارسال بازبینی کنید

  1. از صفحهٔ اصلی Darkoza وارد گفت‌وگو شوید.
  2. روی آیکون افزودن فایل در کنار کادر پیام بزنید؛ یا فایل را در هر جای صفحه رها کنید.
  3. منتظر بمانید تا استخراج متن در مرورگر تمام شود. نام فایل‌ها و تعداد فایل و نویسهٔ آماده‌شده در نوار پیوست نمایش داده می‌شود.
  4. فایل‌های اشتباه یا غیرضروری را با دکمهٔ حذف کنار نام هر فایل بردارید. نام فایل‌ها را با موضوع درخواست تطبیق دهید.
  5. در کادر پیام بنویسید چه کاری باید روی هر فایل انجام شود؛ سپس فقط زمانی «ارسال» را بزنید که محتوای انتخاب‌شده را بررسی کرده‌اید.

۴. به‌جای «این فایل را بخوان»، یک کار روشن تعریف کنید

فایل به‌تنهایی هدف شما را مشخص نمی‌کند. بگویید دنبال تصمیم، خلاصه، مقایسه، استخراج داده، بازبینی یا عیب‌یابی هستید. اگر چند فایل دارید، نقش هرکدام را با نام فایل روشن کنید.

برای بررسی گزارش یا PDF

هدف من از بررسی این سند: [هدف یا تصمیم]

لطفاً:
۱) موضوع و ساختار سند را خلاصه کن.
۲) پنج نکتهٔ مهم را با اشاره به عنوان بخش یا عبارت کوتاهِ دقیق بیاور.
۳) واقعیت‌های صریح سند را از برداشت و پیشنهاد جدا کن.
۴) ابهام‌ها، تناقض‌ها و اطلاعاتی را که سند ارائه نمی‌کند مشخص کن.
۵) چیزی را که در متن قابل‌خواندن نیست حدس نزن.

برای مقایسهٔ دو یا چند سند

نقش فایل‌ها:
- file-a.docx: نسخهٔ قبلی
- file-b.docx: نسخهٔ جدید

تغییرها را در یک جدول مقایسه کن:
موضوع | وضعیت در نسخهٔ قبلی | وضعیت در نسخهٔ جدید | اثر احتمالی | مورد نیاز برای تأیید

تفاوت واقعی متن را از تفسیر خودت جدا کن.
اگر بخشی در یکی از فایل‌ها وجود ندارد، صریحاً بنویس «در متن ارسالی یافت نشد».

برای تحلیل CSV یا TSV

این فایل دادهٔ [موضوع] است.
معنی ستون‌ها: [تعریف ستون‌ها]
واحد اندازه‌گیری: [واحدها]
بازهٔ زمانی: [بازه، در صورت وجود]

ابتدا تعداد ردیف‌ها و ستون‌ها، مقادیر خالی، ردیف‌های تکراری و دامنهٔ تاریخ‌ها را بررسی کن.
سپس [پرسش مشخص] را پاسخ بده.
روش محاسبه، فرض‌ها و محدودیت داده را بنویس.
جمع‌ها و درصدهای مهم را با یک کنترل مستقل یا محاسبهٔ قابل‌بازتولید مشخص کن؛ مقدار ناموجود را حدس نزن.

برای بررسی کد و گزارش خطا

فایل کد و گزارش خطا را پیوست کرده‌ام.
رفتار مورد انتظار: [نتیجهٔ درست]
رفتار واقعی: [نتیجه یا متن خطا]
محیط و نسخه: [سیستم، زبان، ابزار]

علت‌های محتمل را بر اساس شواهد رتبه‌بندی کن.
کوچک‌ترین اصلاح امن را پیشنهاد بده.
برای اصلاح، آزمون بازتولید خطا و آزمون پس از تغییر بنویس.
روشن بگو چه چیزی فقط پیشنهاد شده و چه چیزی واقعاً اجرا یا آزموده شده است.

این قالب‌ها نقطهٔ شروع‌اند، نه دستورهای اجباری. هرچه هدف، زمینه و معیار نتیجه روشن‌تر باشد، احتمال دریافت خروجی قابل‌استفاده بیشتر می‌شود.

۵. وقتی چند فایل می‌فرستید، رابطهٔ آن‌ها را توضیح دهید

اگر یک فایل داده و فایل دیگر راهنمای همان داده است، این رابطه را در پیام بنویسید. اگر چند نسخه از یک سند دارید، تاریخ یا ترتیب نسخه‌ها را مشخص کنید. اگر فایل‌ها مستقل‌اند، از Darkoza بخواهید هرکدام را جداگانه بررسی کند و بعد نتیجه‌ها را کنار هم بگذارد.

نمونهٔ درخواست برای چند فایل

فایل اول: دادهٔ اصلی
فایل دوم: تعریف ستون‌ها و واحدها
فایل سوم: گزارش قبلی

ابتدا هر فایل را جداگانه شناسایی کن.
بعد سازگاری نام ستون‌ها و واحدها را بررسی کن.
در پایان، نتیجه را با سه بخش ارائه بده:
۱) یافته‌های مستند در فایل‌ها
۲) اختلاف‌ها یا داده‌های ناسازگار
۳) سؤال‌هایی که پیش از تصمیم باید پاسخ داده شوند

از ترکیب داده‌هایی که تعریف یا واحد یکسان ندارند خودداری کن.

۶. پیش از ارسال، دادهٔ حساس را حذف یا ناشناس‌سازی کنید

فقط فایلی را پیوست کنید که مجاز به اشتراک‌گذاری آن هستید و واقعاً برای همان کار لازم است. گذرواژه، کلید خصوصی، توکن دسترسی، کد بازیابی، اطلاعات پرداخت و دادهٔ هویتی غیرضروری را حذف کنید. برای نمونه، نام و شمارهٔ مشتری را با شناسه‌ای ساختگی جایگزین کنید، مگر آنکه برای کار ضروری باشند.

  • به‌جای ارسال یک پوشه یا سند کامل، فقط بخش‌های مرتبط را انتخاب کنید.
  • برای داده‌های واقعی، اطلاعاتی را که هویت افراد را آشکار می‌کنند تا حد امکان ناشناس کنید.
  • پیش از زدن ارسال، نام فایل‌ها، متن پیام و فهرست پیوست‌ها را دوباره بررسی کنید.
  • اگر مجوز اشتراک‌گذاری سند را ندارید، آن را بارگذاری نکنید.

استخراج محلی در مرورگر به معنی محلی‌ماندن محتوای ارسالی نیست: پس از ارسال، متن استخراج‌شده برای پردازش به سرویس فرستاده می‌شود. جزئیات مربوط به پردازش داده را در سیاست حریم خصوصی Darkoza بخوانید.

۷. خروجی را با فایل اصلی تطبیق دهید

یک پاسخ روان لزوماً یک تحلیل دقیق نیست. پیش از استفاده از نتیجه، این موارد را کنترل کنید:

  1. پوشش: آیا فایل درست بررسی شده و محدودیت استخراج متن رعایت شده است؟ اگر سند طولانی است، بررسی کنید بخش موردنیاز در محدودهٔ متن ارسالی بوده باشد.
  2. شاهد: آیا هر ادعای مهم به عبارت، عنوان یا دادهٔ مشخصی از فایل وصل شده است؟ نقل‌قول را با اصل سند تطبیق دهید.
  3. محاسبه: مجموع‌ها، درصدها، تاریخ‌ها و واحدها را دوباره بررسی کنید؛ برای تصمیم مالی یا عملیاتی، یک کنترل مستقل انجام دهید.
  4. مرز نتیجه: کدام جمله واقعیت صریح فایل است، کدام استنباط است و کدام پیشنهاد؟ این سه را با هم یکی نگیرید.
  5. ناشناخته‌ها: اگر پاسخ از فایل قابل‌استخراج نیست، از دستیار بخواهید آن را «نامشخص» اعلام کند، نه اینکه جای خالی را با حدس پر کند.

برای تصمیم‌های حقوقی، مالی، پزشکی، امنیتی یا پرریسک، خروجی را جایگزین سند اصلی، متخصص مسئول یا کنترل مستقل نکنید. راهنمای عمومیِ استفادهٔ امن و مؤثر از دستیار هوش مصنوعی نیز همین مرز میان پیشنهاد و نتیجهٔ تأییدشده را توضیح می‌دهد.

۸. اگر فایل خوانده نشد یا نتیجه ناقص بود

نشانهعلت محتملاقدام پیشنهادی
نوع فایل پذیرفته نمی‌شودپسوند یا قالب در مسیر فعلی پشتیبانی نمی‌شود.فایل را به قالب متنی پشتیبانی‌شده تبدیل کنید؛ برای صفحه‌گسترده از CSV یا TSV استفاده کنید.
PDF متن قابل‌خواندن نداردسند ممکن است اسکن تصویری باشد یا لایهٔ متنی نداشته باشد.نسخهٔ متنیِ قابل‌جست‌وجو تهیه کنید و متن استخراج‌شده را با اصل سند تطبیق دهید.
اندازهٔ فایل بیش از حد استفایل بزرگ‌تر از ۱ مگابایت است.بخش یا صفحات لازم را جدا کنید و نسخهٔ کوچک‌تر بسازید.
پاسخ بخش‌هایی از فایل را نادیده می‌گیردمتن استخراج‌شده ممکن است از سقف ۱۰هزار نویسه برای هر فایل یا ۸۰هزار نویسهٔ مجموع عبور کرده باشد.فایل را به بخش‌های معنادار تقسیم کنید و هر بخش را با پرسش مشخص بفرستید.
پاسخ دربارهٔ فایل مبهم استنقش فایل، واحد داده یا هدف تحلیل مشخص نبوده است.نام فایل، نقش آن، معنی ستون‌ها و معیار خروجی را در پیام توضیح دهید.

پرسش‌های رایج

آیا می‌توانم چند فایل را در یک پیام بفرستم؟

بله؛ در رابط فعلی حداکثر هشت فایل پذیرفته می‌شود. مجموع متن استخراج‌شده از پیوست‌ها نیز نباید از ۸۰هزار نویسه بیشتر شود.

آیا Darkoza فایل Excel با پسوند XLSX را مستقیم می‌خواند؟

خیر. برگهٔ موردنیاز را از برنامهٔ صفحه‌گسترده به CSV یا TSV صادر کنید و همان فایل متنی را بفرستید.

آیا PDF اسکن‌شده یا تصویر را می‌توانم پیوست کنم؟

این مسیر OCR یا تحلیل مستقیم تصویر ندارد. PDF باید متن قابل‌استخراج داشته باشد؛ تصویر، صوت و ویدئو نیز در این مسیر پشتیبانی نمی‌شوند.

آیا متن فایل قبل از زدن دکمهٔ ارسال فرستاده می‌شود؟

خیر. استخراج در مرورگر انجام می‌شود و متن فایل فقط همراه پیامِ ارسالی به سرویس می‌رسد. پس از ارسال، محتوای استخراج‌شده را دادهٔ به‌اشتراک‌گذاشته‌شده در نظر بگیرید.

اگر کل فایل در محدودهٔ استخراج قرار نگیرد چه کنم؟

بخش مرتبط را جدا کنید یا فایل را به چند بخش معنادار تقسیم کنید. برای هر بخش، هدف و زمینهٔ کافی بنویسید تا تحلیل از متن ناقص یا جداافتاده نتیجه‌گیری نکند.

یک فایل کوچک را با یک پرسش مشخص امتحان کنید

از یک سند غیرحساس و کوتاه شروع کنید. ابتدا بخواهید محتوای قابل‌خواندن و محدودیت‌های آن را شناسایی کند؛ سپس یک سؤال دقیق بپرسید و پاسخ را با فایل اصلی بسنجید.