1DesignTool میں اکثر مسائل چند وجوہ تک آ جاتے ہیں — غائب یا سائن آؤٹ ایجنٹ، اٹکنے والا رن، نہ رینڈر ہونے والا پریویو، گیٹ FAIL، یا ختم شدہ cap۔ یہ صفحہ ہر ایک کے لیے پہلی جگہ ہے۔
ایجنٹ picker میں نہیں ہے
ایپ آپ کے PATH پر سپورٹ شدہ CLIs ڈھونڈتی ہے — وہی طریقہ جو ٹرمینل کا ہے۔
- کیا یہ انسٹال ہے؟ ٹرمینل میں CLI کو نام سے چلائیں (
claude،codex…) — اگر شیل اسے پائے تو ایپ کو بھی پانا چاہیے۔ - کیا یہ سائن اِن ہے؟ picker سائن اِن state دکھاتی ہے؛ غائب سائن اِن CLI کی اپنی auth ہے، ایپ کی نہیں۔ CLI کی طرف سائن اِن کریں اور دوبارہ کھولیں۔
- کیا یہ فہرست میں ہے؟ 16 سپورٹ شدہ CLIs فہرست ہیں سپورٹ شدہ کوڈنگ ایجنٹس پر — جو CLI فہرست میں نہیں وہ plug نہیں ہو سکتی۔
رن اٹکتا یا ناکام ہوتا ہے
- ایجنٹ کا quota چیک کریں — ٹرنز آپ کے CLI کے اکاؤنٹ پر بل ہوتے ہیں؛ ختم یا لکھی ہوئی اکاؤنٹ رن کو ٹرانسکرپٹ میں واضح طور پر ناکام کرتی ہے۔
- ٹرانسکرپٹ پڑھیں — ایجنٹ کا اپنا آؤٹ پٹ وہاں ہے؛ CLI سائیڈ کی خرابی خود کے طور پر دکھتی ہے، عام ناکامی کی طرح نہیں۔
- ایک بار دوبارہ کوشش کریں — عارضی CLI ناکامی کبھی retry پر اتر آتی ہے۔ جو ناکامی باقی رہے اس کی وجہ ٹرانسکرپٹ نام لیتی ہے۔
پریویو رینڈر نہیں ہوتا
- پریویو default-deny ہے — وہ فائل قسم جو classifier serve نہیں کرتا محفوظ نہ ہونے کے بجائے کچھ نہیں دکھاتی۔ یہ حفاظتی فرش ہے، بگ نہیں۔
- پرانا worktree — کوڈبیس پروجیکٹ پر پریویو
1design/<slug>worktree پڑھتا ہے؛ اگر برانچ state عجیب لگے تو رینڈر پر شک کرنے سے پہلے برانچ بار کا diff review کریں۔ - پینل ریفریش کریں — پریویو ریل کا reload بٹن فولڈر دوبارہ پڑھتا ہے؛ ادھوری لکھی فائل عموماً اگلے paint پر صاف ہو جاتی ہے۔
گیٹ FAIL صاف نہیں ہوتا
- اسی چوڑائی پر درست کریں — FAIL finding کا fix بٹن بالکل وہی مسئلہ بطور ایک سطری بریف ایجنٹ کو واپس بھیجتا ہے؛ finding چوڑائی اور عنصر کا نام لیتی ہے، اس لیے درستی عموماً mechanical ہے۔
- اسی چوڑائی پر چیک کریں — finding بتاتی ہے کون سا viewport ٹوٹا؛ اصول غلط ماننے سے پہلے وہاں نتیجہ دیکھیں۔
- کچھ findings جان بوجھ کر ہیں — معلوم trade-off قبول کیا جا سکتا ہے؛ گیٹ مشورہ دیتی ہے، روکتی نہیں۔ دیکھیں design kit گیٹ۔
cap رن سے انکار کرتی ہے
1design:limit: انکار ختم شدہ cap کا نام لیتی ہے — free ٹئیر پر ٹرنز،
رینڈرز، ورژنز، ویرینٹس یا ڈیزائن سسٹمز۔ Settings → Usage میٹرز پورے
دکھاتی ہے، اور ورژن آرکائیو کرنا بغیر لائسنس کے سلاٹ کھولتا ہے۔ caps لائف ٹائم
کاؤنٹرز ہیں؛ Pro انہیں ہٹا دیتا ہے۔ دیکھیں
Free بمقابلہ Pro۔
Windows پر: EISDIR خرابیاں (معلوم مسئلہ)
Windows پر 1.7.0 میں design kit اسکرپٹس EISDIR کے ساتھ ناکام ہو سکتی ہیں —
جس سے Knowledge، ٹرن کے بعد کی جانچ، ویڈیو ایکسپورٹ اور Build mode ٹوٹ
جاتے ہیں۔ یہ معلوم بگ ہے، اگلے ریلیز میں درست؛ macOS پر وہی فلوز متاثر
نہیں ہوتے۔
MCP کلائنٹ جوڑ نہیں ہوتا
- access پینل چیک کریں — Settings → MCP access endpoint، ٹوکن اور اجازت شدہ کلائنٹ فہرست دکھاتا ہے؛ مسترد کلائنٹ عموماً فہرست میں نہیں ہوتا۔
- ٹوکن چیک کریں — پینل کا ٹوکن وہی ہے جو کلائنٹ بھیجتا ہے؛ پرانا یا غلط ٹوکن کنکشن مسترد کرتا ہے۔
- activity log چیک کریں — log دکھاتا ہے کیا سرور تک پہنچا اور کیا نہیں۔
پہلے کہاں دیکھیں
- Transcript پینل — ایجنٹ کا آؤٹ پٹ، لفظ بہ لفظ
- Branch بار — کوڈبیس پروجیکٹ پر، ٹرن نے اصل میں کیا بدلا
- Settings → Usage — کون سا میٹر ختم ہے
- Activity log — MCP کلائنٹ نے اصل میں کیا کیا
مشورہ: ٹرانسکرپٹ ہمیشہ پہلا پڑھ ہے — ایجنٹ کا اپنا آؤٹ پٹ اس کا دیانت دار ورژن ہے کہ کیا ہوا، اور اکثر "ایپ ٹوٹ گئی" واقعے اصل میں "CLI نے کچھ کہا جسے UI نے بہت نرمی سے ترجمہ کیا" ہوتے ہیں۔