Sådan rapporterer du et dårligt udsnit nyttigt
En nyttig rapport forklarer hvad der fejlede, hvor det fejlede, og hvordan man genskaber det. Start med symptomet, kildeformat og mål, browser- og udvidelsesversion, inputmetode, og om first-run-modelsetup var færdigt.
Send ikke automatisk en privat original. Prøv først at genskabe problemet med en harmløs erstatning eller et tæt beskåret, redigeret eksempel. En supportrapport behøver sjældent en persons identitet, dokumenttekst, lokation eller et komplet klientasset.
Beslut først, om det er et kvalitetsproblem eller en fejl
“Dårlig udskæring” kan betyde flere forskellige ting:
- billedet ville ikke åbne;
- behandlingen er aldrig startet;
- behandlingen gik ned eller gik i stå;
- emnemasken fjernede en vigtig del;
- baggrunden forblev omkring emnet;
- hår, pels, glas eller tynde genstande brækkede fra hinanden;
- en glorie dukkede først op efter eksport;
- Kopiering mislykkedes, mens download virkede;
- resultatet så rigtigt ud i editoren, men forkert i en anden applikation.
Navngiv kategorien i første sætning. “Håndtaget forsvandt efter behandling” giver støtte et udgangspunkt. “Det virker ikke” gør ikke.
Hvis behandlingen er fuldført, og kun kanten har brug for en lille korrektion, kan det være en normal forfiningssag snarere end en softwarefejl. Inkluder, hvad det automatiske resultat gjorde, før du brugte Tilføj eller Slet børster.
Optag den korteste gengivelsessti
Skriv trinnene, som om en anden person skal følge dem på en ren installation:
- Åbn udvidelsen fra værktøjslinjen.
- Drop en lokal JPG med dimensionerne 2400 × 1600.
- Vent på, at behandlingen er færdig.
- Undersøg mellemrummet inde i objektets håndtag.
- Download PNG.
- Bemærk, at hullet er udfyldt i både forhåndsvisning og eksport.
Brug kun de nødvendige trin for at nå symptomet. Nævn alternativer, der ændrer resultatet, såsom “den samme fil virker, når den er gemt som PNG” eller “Download virker, men kopiering gør det ikke.”
Ved et problem med sidebillede skal du inkludere, om fejlen kun sker via højrekliksruten, og om det virker lokalt at gemme det samme billede. Nogle websteder leverer billeder på måder, der forhindrer sidearbejdsgangen i at læse dem; at beviser adskiller leveringsrestriktioner fra modelkvalitet.
Inkluder miljødetaljer, der kan ændre adfærd
En kompakt miljøblok er nok:
- udvidelsesversion;
- browserversion;
- operativsystem;
- omtrentlig enhedshukommelse, hvis behandlingen går ned på store filer;
- om modeloverførslen var afsluttet;
- Kildeformat, pixeldimensioner og omtrentlig filstørrelse;
- input rute: vælg, slip, indsæt eller sidebillede;
- output rute: Download PNG eller kopi;
- om problemet gentager sig efter genåbning af editoren.
Undgå at sende en komplet systemopgørelse. Hardware-serienumre, kontonavne, netværksadresser, lister over installerede apps og ikke-relateret browserhistorik tilføjer normalt risiko uden at hjælpe med at reproducere en kantfejl.
Beskriv billedet geometrisk
Når du ikke kan dele kilden, beskriv de visuelle forhold:
- mørkt, krøllet hår mod en mørk væg;
- gennemsigtig glaskant på en lys baggrund;
- smalle cykeleger, der krydser en tekstureret gade;
- bleg produktkant mod en råhvid baggrund;
- blød gulvskygge, der rører ved motivet;
- Skærmbillede i lav opløsning med kompressionsblokke;
- motiv delvist beskåret ved rammekanten.
Nævn, hvor fejlen vises: øverste venstre kant, lukket mellemrum, kontaktskygge, semi-transparent område eller en-pixel-kant omkring eksporten. Dette ordforråd er mere brugbart end at sige, at modellen “ikke forstod billedet.”
Brug en sikker erstatning, når det er muligt
Prøv at genskabe det samme visuelle problem med et objekt, du kan dele. Hvis et kundeprodukt mangler et håndtag, skal du fotografere et almindeligt krus mod en lignende baggrund. Hvis private hårdetaljer svigter, skal du bruge en paryk, børste, garn eller plante med en lignende kantstruktur.
En erstatning er kun nyttig, hvis den gengiver symptomet. Angiv klart, at det er en reproduktion, ikke originalen. Inkluder både succes- og fiaskoforhold:
- fejler ved lav kontrast, virker på høj kontrast;
- fejler over en vis billedstørrelse, virker efter ændring af størrelse;
- fejler gennem side-billede handling, virker fra gemt fil;
- Preview er korrekt, eksporteret PNG viser en udkant i en navngivet lokal fremviser.
Den sammenligning afslører ofte mere end originalen alene.
Hvis du skal dele et billede, skal du minimere det
Indhent ejerens tilladelse og følg enhver klient- eller arbejdspladspolitik først. Fjern derefter alt, hvad undersøgelsen ikke behøver:
- Dupliker filen, så originalen forbliver urørt.
- Beskær tæt omkring den svigtende kant.
- Fjern metadata, hvis din godkendte arbejdsgang kræver det.
- Rediger navne, skærmbilleder, adresser, ansigter og identifikationsmærker uden for det relevante område.
- Bekræft redigeringen i den faktiske eksporterede kopi.
- Del kun via den udpegede feedbackrute.
At male sort over tekst kan være utilstrækkeligt, hvis dokumentformatet bevarer lag eller skjult indhold. En fladtrykt, stramt beskåret rasterkopi er normalt nemmere at ræsonnere om, men følg din organisations regler.
Indsend aldrig identitetsdokumenter, intime billeder, børns fotos, lægejournaler, legitimationsoplysninger eller fortrolige beviser for blot at forbedre en fejlrapport.
Optag før og efter uden overdeling
For en rapport af kantkvalitet kan en tæt beskæring af tre tilstande hjælpe:
- kildekant;
- automatisk maskeresultat;
- ønsket resultat efter manuel forfining.
Hold afgrøden stor nok til at vise lokal kontrast og tekstur, men lille nok til at fjerne identitet og kontekst. Mærk hver stat. Hvis skærmbilleder inkluderer browserfaner, bogmærker, meddelelser, filnavne eller kontoavatarer, skal du skære dem ud, før du sender.
Når problemet vedrører eksport, skal du inspicere PNG’en mod både en lys og mørk lokal baggrund. En bleg glorie kan forsvinde på hvidt, mens den forbliver tydelig på mørkegrå. Sig, om defekten findes i editorens forhåndsvisning, den eksporterede fil eller kun destinationsapplikationen.
Rapporter timing og frekvens ærligt
Nyttig timing er omtrentlig: “behandlingen hænger i mere end to minutter efter fremskridtsindikatoren starter” eller “fejlen er umiddelbart efter valg af filen.” Rapporter ikke et præcist benchmark fra en distraheret løbetur.
Tilstandsfrekvens:
- hvert forsøg med denne sikre prøve;
- to ud af fem forsøg;
- én gang, ikke gengivet efter genstart;
- kun ved første lancering;
- begyndte efter en udvidelsesopdatering.
En engangsbegivenhed er stadig vigtig, men at mærke den nøjagtigt holder efterforskningen fokuseret.
Hvad skal man ikke inkludere
Udelad:
- adgangskoder, tokens eller kontolegitimationsoplysninger;
- komplette browserlogfiler, du ikke har gennemgået;
- ikke-relaterede personlige filer;
- det originale private billede, når en sikker afgrøde gengiver problemet;
- antagelser om serverupload kun baseret på at se netværksaktivitet;
- aggressive påstande om årsagen uden beviser.
Beskriv først observationerne. “Medarbejderfejlen vises efter 40 sekunder på denne 30-megapixel fil” er bevis. “Serveren afviste mit billede” er spekulationer, især når udskæringsstien er designet til at køre lokalt.
En rapportskabelon
Brug denne kompakte struktur:
Opsummering: Én sætning, der navngiver det mislykkede objekt eller scene. Forventet: Hvad skal forblive gennemsigtigt, uigennemsigtigt, kopieret eller downloadet. Observeret: Hvad skete der faktisk, og hvor det vises. Trin: Den korteste nummererede gengivelse. Miljø: Versioner, system, modelopsætningstilstand, kildeformat og dimensioner. Frekvens: Hver gang, intermitterende eller én gang. Sikker prøve: Vedhæftet reproduktion, beskåret eksempel eller “kan ikke dele”. Løsning: Ændr størrelse, re-eksportér, brug lokal fil, finjuster manuelt eller ingen.
Brug udvidelsesfeedbackflowet, hvis din installerede build giver en. Ellers behold rapportteksten, så du kan indsætte den i den aktuelle supportrute uden at genopbygge beviserne fra hukommelsen.
Gør rapporten nyttig og privatlivsbevidst
Den stærkeste rapport er ikke den med flest data. Det er den med det mindste reproducerbare eksempel og den klareste grænse mellem observation og gæt.
For øjeblikkelige rettelser, tjek Fejlfinding. Før du vedhæfter en prøve, skal du bruge vanerne i Sikker testbilledevaner. Gode rapporter forbedrer udskæringskvaliteten uden at gøre privat indhold til unødvendigt supportmateriale.