Wenn in der Forschung, beim Herunterladen, in der Strom-App oder bei der Installation etwas schiefgeht, packt strom error in eine einzige ZIP-Datei, was nötig ist, um zu erkennen, was geschehen ist. Nichts über die Menschen des Stammbaums kommt hinein, und strom sendet nichts: die Datei schickt ein Mensch selbst. Beschrieben wird die Forschung 1.30.0.
R13.1 Ein Befehl, eine Datei
strom error gibt aus, was der Bericht enthalten wird, fragt Bericht erstellen? und speichert die ZIP-Datei. Es sagt, wo die Datei liegt, wie groß sie ist und wohin sie zu schicken ist.
- Prüft der Code:
- die Datei kommt in den Ordner Downloads, sonst in den aktuellen Ordner; in einer Forschung ohne Ordner Downloads in den Benutzerordner, nie in die Forschung;
- der Bericht hat höchstens 2 MB: längere Protokolle werden gekürzt;
- der Befehl liest die Forschung nur, er schreibt nichts in sie;
- strom sendet nichts: „Per E-Mail an {adresse} zu senden, mit ein paar Worten dazu, was passiert ist. strom selbst sendet nichts; die Datei lässt sich vorher öffnen und durchsehen (README.txt sagt, was wo ist).“
- Bedienung: Terminal:
strom error; im Menü vonstrom: Einstellungen → Wartung → Ein Problem melden: eine ZIP-Datei zum Versenden (nichts über die Menschen des Stammbaums). - Gilt seit: Forschung 1.30.0
R13.2 Was der Bericht enthält und was nicht
| Bereich | Was darin ist |
|---|---|
| dieser Computer | Version und Kanal von strom, Node, git, System, Sprache, freier Platz |
| Einstellungen von strom | ohne Pfade und Anmeldungen |
strom doctor | alle Prüfungen |
| Agenten | welche installiert sind, ihre Versionen, das Standardmodell, die Hooks von strom |
| Konnektoren | Liste, Versionen, erlaubte Server, letzter Test (ohne Anmeldungen) |
| die Brücke zur Strom-App | Lauf, Version der App, letzte Synchronisation |
| die Forschung in Zahlen | Anzahlen, strom check, git, Downloads, Sitzungen (ohne Namen) |
| technische Protokolle | Protokolle von strom der letzten 7 Tage (Brücke, Aufräumen, Downloads) |
| Befehle | mit einem Fehler beendete Befehle, auch die aus dem Gespräch mit dem Agenten |
- Prüft der Code:
- Namen, Orte, Notizen, Abschriften, Bilder und E-Mails kommen nicht in den Bericht oder werden durch feste Codes ersetzt (zum Beispiel ‹a1b2c›): dasselbe Wort hat im ganzen Bericht denselben Code, sodass zu sehen ist, dass es um dasselbe geht, aber nicht, was es ist;
- Pfade mit dem Benutzernamen werden maskiert; Anmeldungen, Schlüssel und Token kommen nie hinein;
- Forschungen heißen im Bericht nur R1, R2…, nie nach ihrem Pfad;
- ein Bereich, der sich nicht lesen lässt, hat in der Ausgabe ✗ und den Fehler („nicht lesbar (…)“); der Bericht entsteht aus den übrigen;
- im ZIP sind README.txt (was wo ist) und report.json.
- Gilt seit: Forschung 1.30.0
R13.3 Welches Problem, welcher Befehl
--about fügt Einzelheiten eines Bereichs hinzu. Es lässt sich mehrmals angeben.
| Problem | Befehl |
|---|---|
| das Herunterladen hält an, schlägt fehl oder wartet lange | strom error --about fetch |
| Strom-App: Synchronisation, Brücke, der Stammbaum erscheint nicht | strom error --about sync |
Agent: ein Gespräch oder strom run ist schiefgegangen | strom error --about agent |
| Installation oder Aktualisierung von strom | strom error --about install |
| alles unter Windows | strom error --about windows |
| etwas anderes | strom error |
- Was ein Bereich hinzufügt: Downloads im Detail (jeder, sein Konnektor, Wartezeiten und Fehler); die Brücke im Detail (Synchronisationen, Schranken der App); Sitzungen des Agenten im Detail (Schritte und Exit-Codes); die Installation im Detail (PATH, Aktualisierungen, Sicherungen der Installation); Windows (Ausführungsrichtlinie von PowerShell, lange Pfade, OneDrive).
- Bedienung:
--since 2d|1w|12h|JJJJ-MM-TTbestimmt, wie weit die Protokolle zurückreichen (standardmäßig 7 Tage). - Gilt seit: Forschung 1.30.0
R13.4 Wo das Problem auftrat und was geschah
Der Bericht sagt, wo das Problem aufgetreten ist, und kann eine Beschreibung in den Worten des Menschen enthalten.
- Prüft der Code:
- ein Mensch am Terminal bekommt die Frage Wo ist das Problem aufgetreten?: in einem Gespräch mit einem Agenten, im Terminal, strom ohne Agenten, in der Strom-App, unbekannt; mit
--where chat|terminal|app|unknownwird nicht gefragt; - von einem Agenten ohne
--wheregestartet: der Ort bleibt „unbekannt“, und strom sagt dem Agenten, er solle den Menschen fragen und den Befehl erneut starten; --note "…"ist die Beschreibung des Problems in den Worten des Menschen, höchstens 2000 Zeichen; Namen aus der Forschung werden darin maskiert.- Ab Forschung 1.31.0: maskiert werden auch gebeugte Formen von Namen und Orten, die die Forschung kennt, bei denen sich der letzte oder die letzten zwei Buchstaben ändern („z Brna“ zu Brno, „v Praze“ zu Praha). Der Stamm hat mindestens 3 Buchstaben, und die Endung ist umso kürzer, je kürzer der Stamm ist; ein gewöhnliches Wort, das nur gleich beginnt, bleibt lesbar. Der ganze Bericht wird ebenso maskiert.
- ein Mensch am Terminal bekommt die Frage Wo ist das Problem aufgetreten?: in einem Gespräch mit einem Agenten, im Terminal, strom ohne Agenten, in der Strom-App, unbekannt; mit
- Bedienung:
strom error --where app --about sync,strom error --since 2d --note "das Herunterladen hielt mittendrin an". - Gilt seit: Forschung 1.30.0
R13.5 Daten von Personen nur mit Zustimmung
Liegt das Problem bei einer bestimmten Person, Familie oder einem Buch, lassen sich deren Daten hinzufügen. Nur auf ausdrücklichen Wunsch.
- Prüft der Code:
--with-datamit--person P…,--family F…oder--book B…fügt die Datei data.json hinzu: Namen, Angaben, Orte, Zitationen und wie sicher jede Angabe ist. Bilder, Notizen und Abschriften nicht;- ein Mensch am Terminal bekommt die Frage Dem Bericht hinzufügen?;
- ein Agent muss
--yes-dataangeben, und das nur nach einem ausdrücklichen „ja“ des Menschen im Gespräch; ohne es endet der Befehl mit dem Hinweis, dass die Zustimmung fehlt.
- Bedienung:
strom error --about fetch --with-data --book B0001. - Gilt seit: Forschung 1.30.0
R13.6 Eine beschädigte Forschung, das Strom-Archiv und außerhalb einer Forschung
- Prüft der Code:
- eine beschädigte Forschung wird nur gelesen; was sich nicht lesen lässt, hat in der Ausgabe ✗, und der Rest des Berichts entsteht;
- im Strom-Archiv hat der Bericht keine Agenten, keine Sitzungen und kein
--about agent; die Frage Wo ist das Problem aufgetreten? hat kein „in einem Gespräch mit einem Agenten“ und bietet statt „im Terminal, strom ohne Agenten“ im Terminal an; - außerhalb einer Forschung gestartet: der Bericht hat jede bekannte Forschung, nur in Zahlen und mit maskiertem Namen; mit einem Fehler beendete Befehle aus allen.
- Gilt seit: Forschung 1.30.0
R13.7 Der Agent und das Melden eines Problems
Der Agent kennt den Befehl. Sagt ein Mensch, dass er ein Problem mit strom hat, oder will er „einen Fehler schicken“, fragt der Agent, wo es aufgetreten ist (in diesem Gespräch, im Terminal ohne Agenten oder in der Strom-App), errät es nie und startet strom error --where … mit dem passenden --about und mit --note in den Worten des Menschen. Dann nennt er den Pfad zur Datei und die Adresse, die strom ausgegeben hat.
- Prüft der Code: Daten von Personen fügt der Agent nur mit
--yes-datahinzu, das er nur nach ausdrücklicher Zustimmung des Menschen angeben darf (R13.5). - Nur Methodik: der Agent schickt die Datei nie, öffnet sie nicht und überträgt ihren Inhalt nicht ins Gespräch.
- Gilt seit: Forschung 1.30.0