1DesignTool की ज़्यादातर समस्याएँ मुट्ठी भर कारणों तक सीमित होती हैं — गायब या साइन-आउट एजेंट, अटका हुआ रन, रेंडर न होने वाला प्रीव्यू, gate FAIL, या खत्म हुई cap. यह पेज हर एक के लिए पहली देखने की जगह है.
एजेंट picker में नहीं है
ऐप आपके PATH पर सपोर्टेड CLI ढूँढता है — वैसे ही जैसे टर्मिनल ढूँढता है.
- क्या वह इंस्टॉल है? टर्मिनल में CLI को नाम से चलाएँ (
claude,codex…) — अगर शेल उसे ढूँढ लेता है, तो ऐप को भी चाहिए. - क्या वह साइन-इन है? picker साइन-इन state दिखाता है; गायब साइन-इन CLI का अपना auth है, ऐप का नहीं. CLI की तरफ़ साइन इन करें और ऐप फिर खोलें.
- क्या वह रोस्टर पर है? 16 सपोर्टेड CLI सपोर्टेड कोडिंग एजेंट पर सूचीबद्ध हैं — सूची से बाहर का CLI प्लग नहीं हो सकता.
रन अटकता या फ़ेल होता है
- एजेंट का कोटा जाँचें — टर्न आपके CLI के अकाउंट पर बिल होते हैं; खत्म या लैप्स अकाउंट रन को ट्रांसक्रिप्ट में दिखते हुए फ़ेल करता है.
- ट्रांसक्रिप्ट पढ़ें — एजेंट का अपना आउटपुट वहीं है; CLI-साइड एरर अपने रूप में दिखता है, जेनरिक फ़ेल्योर के रूप में नहीं.
- एक बार retry करें — क्षणिक CLI फ़ेल्योर कभी-कभी retry पर पास हो जाता है. जो फ़ेल्योर बना रहे उसका कारण ट्रांसक्रिप्ट नाम देता है.
प्रीव्यू रेंडर नहीं होता
- प्रीव्यू default-deny है — जो फ़ाइल टाइप classifier परोसता नहीं वह अनसेफ़ होने के बजाय कुछ भी रेंडर नहीं करता. यह सेफ़्टी फ़्लोर है, बग नहीं.
- पुराना worktree — codebase प्रोजेक्ट पर प्रीव्यू
1design/<slug>worktree पढ़ता है; अगर ब्रांच state अजीब लगे, तो रेंडर पर शक करने से पहले ब्रांच बार का diff रिव्यू करें. - पैनल रिफ़्रेश करें — प्रीव्यू रेल का रीलोड बटन फ़ोल्डर फिर से पढ़ता है; आधी-लिखी फ़ाइल आमतौर पर अगले paint पर ठीक हो जाती है.
gate FAIL साफ़ नहीं होता
- इसी width पर फ़िक्स करें — FAIL फ़ाइंडिंग का फ़िक्स बटन ठीक उसी इश्यू को एक-लाइन ब्रीफ़ के तौर पर एजेंट को वापस भेजता है; फ़ाइंडिंग width और एलिमेंट नाम देती है, तो फ़िक्स आमतौर पर मैकेनिकल है.
- उसी width पर जाँचें — फ़ाइंडिंग बताती है कि कौन-सा viewport टूटा; नियम गलत मानने से पहले वहाँ नतीजा देखें.
- कुछ फ़ाइंडिंग जानबूझकर हैं — ज्ञात trade-off स्वीकार किया जा सकता है; gate सलाह देता है, ब्लॉक नहीं करता. देखें design-kit gate.
cap रन रोकती है
1design:limit: refusal खत्म हुई cap नाम देती है — free टियर पर टर्न, रेंडर,
versions, variants या डिज़ाइन सिस्टम. Settings → Usage मीटर पूरे दिखाता
है, और version आर्काइव करना बिना लाइसेंस के स्लॉट खाली करता है. cap लाइफ़टाइम
काउंटर हैं; Pro उन्हें हटाता है. देखें
Free बनाम Pro.
Windows पर: EISDIR एरर (ज्ञात इश्यू)
Windows पर 1.7.0 में design kit स्क्रिप्ट EISDIR से फ़ेल हो सकती हैं —
जिससे Knowledge, टर्न के बाद की जाँच, वीडियो एक्सपोर्ट और Build मोड टूट
जाते हैं. यह ज्ञात बग है, अगले रिलीज़ में ठीक; macOS पर वही फ़्लो
अप्रभावित हैं.
MCP क्लाइंट कनेक्ट नहीं होता
- एक्सेस पैनल जाँचें — Settings → MCP access एंडपॉइंट, टोकन और अनुमत-क्लाइंट सूची दिखाता है; अस्वीकृत क्लाइंट आमतौर पर सूची में नहीं होता.
- टोकन जाँचें — पैनल का टोकन ही क्लाइंट भेजता है; पुराना या ग़लत टोकन कनेक्शन अस्वीकार करता है.
- एक्टिविटी लॉग जाँचें — लॉग दिखाता है कि सर्वर तक क्या पहुँचा और क्या नहीं.
पहले कहाँ देखें
- ट्रांसक्रिप्ट पैनल — एजेंट का आउटपुट, हरफ़-ब-हरफ़
- ब्रांच बार — codebase प्रोजेक्ट पर, टर्न ने असल में क्या बदला
- Settings → Usage — कौन-सा मीटर खत्म है
- एक्टिविटी लॉग — MCP क्लाइंट ने असल में क्या किया
टिप: ट्रांसक्रिप्ट हमेशा पहली रीड है — एजेंट का अपना आउटपुट ही जो हुआ उसका ईमानदार वर्ज़न है, और ज़्यादातर "ऐप टूटा" केस असल में "CLI ने कुछ कहा जिसे UI ने बहुत नरमी से ट्रांसलेट किया" होते हैं.