Useimmat ongelmat 1DesignToolissa kaventuvat kouralliseen syitä — puuttuva tai kirjautumaton agentti, ajo, joka jumittuu, esikatselu, joka ei renderöidy, gate FAIL tai käytetty cap. Tämä sivu on ensimmäinen paikka katsoa jokaisen kohdalle.
Agentti ei ole pickerissä
Sovellus löytää tuetut CLI:t PATH:ltasi — samoin kuin terminaali.
- Onko se asennettu? Aja CLI nimensä mukaan terminaalissa
(
claude,codex…) — jos shell löytää sen, sovelluksen pitäisi myös. - Onko se kirjautunut? Picker näyttää kirjautumistilan; puuttuva kirjautuminen on CLI:n oma auth, ei sovelluksen. Kirjaudu CLI:n puolella ja avaa uudelleen.
- Onko se rosterissa? 16 tuettua CLI:tä on listattu Tuettujen koodausagenttien sivulla — CLI, joka ei ole listalla, ei voi liittyä.
Ajo jumittuu tai epäonnistuu
- Tarkista agentin kiintiö — turnit laskutetaan CLI:si tililtä; käytetty tai umpeutunut tili epäonnistaa ajon näkyvästi transcriptissa.
- Lue transcript — agentin oma tuloste on siellä; CLI-puolen virhe näkyy itseäänä, ei geneerisenä epäonnistumisena.
- Yritä kerran uudelleen — ohimenevä CLI-virhe laskeutuu joskus uudelleenyrityksellä. Virhe, joka jatkuu, kantaa syyn, jonka transcript nimeää.
Esikatselu ei renderöidy
- Esikatselu on default-deny — tiedostotyyppi, jota luokittelija ei tarjoile, renderöityy ei-minkäänä turvattomuuden sijaan. Tämä on turvallisuuspohja, ei bugi.
- Vanha worktree — codebase-projektissa esikatselu lukee
1design/<slug>-worktree'tä; jos haaran tila näyttää oudolta, tarkista branch barin diffi ennen kuin epäilet renderiä. - Päivitä paneeli — esikatselurailin reload-painike lukee kansion uudelleen; puoliksi kirjoitettu tiedosto selviää yleensä seuraavalla paintilla.
Gate FAIL ei selviä
- Fix at this width — FAIL-löydön korjauspainike lähettää juuri sen ongelman takaisin agentille yhden rivin briefinä; löydös nimeää leveyden ja elementin, joten korjaus on yleensä mekaaninen.
- Tarkista sillä leveydellä — löydös kertoo, mikä viewport rikkoi; katso tulosta siellä ennen kuin oletat säännön olevan väärä.
- Jotkin löydökset ovat tarkoituksellisia — tunnettu kompromissi voidaan hyväksyä; gate neuvoo, ei estä. Katso Design kit -gate.
Cap kieltää ajon
1design:limit:-kieltäytyminen nimeää käytetyn capin — turnit,
renderit, versiot, variantit tai design-systeemit Free-tasolla.
Settings → Usage näyttää mittarit kokonaan, ja version
arkistointi vapauttaa paikan ilman lisenssiä. Capit ovat
elinikäisiä laskureita; Pro poistaa ne. Katso
Free vs Pro.
Windowsissa: EISDIR-virheet (tunnettu ongelma)
Windowsin 1.7.0:ssa design kit -skriptit voivat epäonnistua
EISDIR-virheellä — mikä rikkoo Knowledgen, turnin jälkeiset
tarkistukset, videoviennin ja Build moden. Se on tunnettu bugi,
korjattu seuraavassa julkaisussa; macOS:ssä samat virtaukset eivät
ole vaikutuksen alaisia.
MCP-client ei yhdisty
- Tarkista access-paneeli — Settings → MCP access näyttää endpointin, tokenin ja sallittujen clienttien listan; hylätty client ei yleensä ole listalla.
- Tarkista token — paneelin token on se, mitä client lähettää; vanha tai väärä token kieltää yhteyden.
- Tarkista activity log — loki näyttää, mikä tavoitti palvelimen ja mikä ei.
Mistä katsoa ensin
- Transcript-paneeli — agentin tuloste, sana sanalta
- Branch bar — codebase-projektissa, mitä turn oikeasti muutti
- Settings → Usage — mikä mittari on käytetty
- Activity log — mitä MCP-client oikeasti teki
Vinkki: Transcript on ensimmäinen luku, aina — agentin oma tuloste on rehellinen versio siitä, mitä tapahtui, ja useimmat "sovellus rikkoutui" -tapaukset ovat todellisuudessa "CLI sanoi jotain, jonka UI käänsi liian pehmeästi".