knowmind 0.3.6 → 0.3.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,119 +1,119 @@
1
- # -*- coding: utf-8 -*-
2
- """Startet den knowmind-MCP-Server unter Windows ohne Konsolenfenster.
3
-
4
- WARUM (10.08.2026, Johann): „Mein Fenster öffnet sich noch immer, wenn knowmind
5
- gecalled wird. Viele werden es deshalb deinstallieren." — und nachgeschoben:
6
- „Du kannst währenddessen auch nicht tippen. Sehr nervig." Das Fenster stiehlt
7
- den Tastaturfokus, es ist also kein Schönheitsfehler, sondern eine Unterbrechung
8
- mitten im Satz.
9
-
10
- Ein MCP-Server wird als `node …/knowmind.js mcp` gestartet. `node.exe` ist ein
11
- Konsolenprogramm; hat der startende KI-Client keine eigene Konsole — Desktop-
12
- Anwendung, IDE-Erweiterung —, gibt Windows dem Kind ein eigenes Fenster. Bei
13
- jedem Werkzeugaufruf blitzt es auf. Ein Gedächtnis, das bei jeder Nutzung den
14
- Fokus klaut, fliegt wieder runter, egal wie gut es ist.
15
-
16
- `node.exe` hat kein fensterloses Gegenstück. `pythonw.exe` ist ein GUI-Programm
17
- und öffnet selbst keins — es gibt node eine versteckte Konsole.
18
-
19
- WARUM DURCHREICHEN STATT VERERBEN: Die naheliegende Fassung startet node ohne
20
- stdin/stdout-Umleitung, damit es die Handles des Elternprozesses erbt. Unter
21
- `pythonw.exe` schlägt das fehl — als GUI-Programm hat es keine verlässlichen
22
- Standard-Handles, node erbt ins Leere und die Antwort kommt nie beim Client an
23
- (gemessen 10.08.2026: initialize blieb unbeantwortet). Deshalb werden die
24
- Datenströme über Pipes geführt und in beide Richtungen durchgepumpt. Roh, ohne
25
- Zeilenpufferung — MCP-Nachrichten dürfen nicht verzögert oder zerschnitten
26
- werden.
27
-
28
- Aufruf: pythonw.exe mcp-starter.py <befehl> [argumente]
29
- z. B. … mcp-starter.py npx -y knowmind mcp
30
- oder … mcp-starter.py node C:/…/knowmind.js mcp
31
- """
32
- import shutil
33
- import subprocess
34
- import sys
35
- import threading
36
-
37
-
38
-
39
- def pumpe(quelle, ziel) -> None:
40
- """Schiebt Bytes weiter, sobald sie da sind, und schliesst am Ende sauber."""
41
- try:
42
- while True:
43
- brocken = quelle.read(1)
44
- if not brocken:
45
- break
46
- ziel.write(brocken)
47
- ziel.flush()
48
- except Exception: # noqa: BLE001 — Abbruch beim Beenden ist normal
49
- pass
50
- finally:
51
- try:
52
- ziel.close()
53
- except Exception: # noqa: BLE001
54
- pass
55
-
56
-
57
- def _ohne_fenster():
58
- """Startet node in einer versteckten Konsole statt ganz ohne.
59
-
60
- `CREATE_NO_WINDOW` allein nimmt dem Prozess die Konsole — und ein Kind,
61
- dessen Eltern keine hat, legt sich eine neue an, die sichtbar ist. Am
62
- 02.09.2026 blitzte deshalb bei jedem Aufruf ein Fenster auf; gemessen
63
- wurde: konsolenlos einmal Blitz in drei Läufen, versteckte Konsole
64
- keinmal.
65
-
66
- `CREATE_NEW_CONSOLE` mit `SW_HIDE` gibt dem Prozess eine eigene, aber
67
- unsichtbare Konsole, die seine Kinder erben.
68
- """
69
- if sys.platform != "win32":
70
- return {}
71
- info = subprocess.STARTUPINFO()
72
- info.dwFlags |= subprocess.STARTF_USESHOWWINDOW
73
- info.wShowWindow = subprocess.SW_HIDE
74
- return {"startupinfo": info,
75
- "creationflags": subprocess.CREATE_NEW_CONSOLE}
76
-
77
-
78
- def main() -> int:
79
- if len(sys.argv) < 2:
80
- sys.stderr.write("Aufruf: mcp-starter.py <knowmind.js> [args...]\n")
81
- return 2
82
-
83
- # Erstes Argument ist der zu startende Befehl (node, npx, …), Rest sind
84
- # dessen Argumente. Unter Windows liegt npx als .cmd vor; subprocess findet
85
- # es nur über den vollen Pfad, deshalb erst auflösen.
86
- befehl = list(sys.argv[1:])
87
- aufgeloest = shutil.which(befehl[0])
88
- if aufgeloest:
89
- befehl[0] = aufgeloest
90
-
91
- try:
92
- prozess = subprocess.Popen(
93
- befehl,
94
- stdin=subprocess.PIPE,
95
- stdout=subprocess.PIPE,
96
- stderr=sys.stderr,
97
- bufsize=0,
98
- **_ohne_fenster(),
99
- )
100
- except FileNotFoundError:
101
- sys.stderr.write(f"node nicht gefunden: {node}\n")
102
- return 127
103
-
104
- faeden = [
105
- threading.Thread(target=pumpe, args=(sys.stdin.buffer, prozess.stdin), daemon=True),
106
- threading.Thread(target=pumpe, args=(prozess.stdout, sys.stdout.buffer), daemon=True),
107
- ]
108
- for f in faeden:
109
- f.start()
110
-
111
- try:
112
- return prozess.wait()
113
- except KeyboardInterrupt:
114
- prozess.terminate()
115
- return 0
116
-
117
-
118
- if __name__ == "__main__":
119
- raise SystemExit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """Startet den knowmind-MCP-Server unter Windows ohne Konsolenfenster.
3
+
4
+ WARUM (10.08.2026, Johann): „Mein Fenster öffnet sich noch immer, wenn knowmind
5
+ gecalled wird. Viele werden es deshalb deinstallieren." — und nachgeschoben:
6
+ „Du kannst währenddessen auch nicht tippen. Sehr nervig." Das Fenster stiehlt
7
+ den Tastaturfokus, es ist also kein Schönheitsfehler, sondern eine Unterbrechung
8
+ mitten im Satz.
9
+
10
+ Ein MCP-Server wird als `node …/knowmind.js mcp` gestartet. `node.exe` ist ein
11
+ Konsolenprogramm; hat der startende KI-Client keine eigene Konsole — Desktop-
12
+ Anwendung, IDE-Erweiterung —, gibt Windows dem Kind ein eigenes Fenster. Bei
13
+ jedem Werkzeugaufruf blitzt es auf. Ein Gedächtnis, das bei jeder Nutzung den
14
+ Fokus klaut, fliegt wieder runter, egal wie gut es ist.
15
+
16
+ `node.exe` hat kein fensterloses Gegenstück. `pythonw.exe` ist ein GUI-Programm
17
+ und öffnet selbst keins — es gibt node eine versteckte Konsole.
18
+
19
+ WARUM DURCHREICHEN STATT VERERBEN: Die naheliegende Fassung startet node ohne
20
+ stdin/stdout-Umleitung, damit es die Handles des Elternprozesses erbt. Unter
21
+ `pythonw.exe` schlägt das fehl — als GUI-Programm hat es keine verlässlichen
22
+ Standard-Handles, node erbt ins Leere und die Antwort kommt nie beim Client an
23
+ (gemessen 10.08.2026: initialize blieb unbeantwortet). Deshalb werden die
24
+ Datenströme über Pipes geführt und in beide Richtungen durchgepumpt. Roh, ohne
25
+ Zeilenpufferung — MCP-Nachrichten dürfen nicht verzögert oder zerschnitten
26
+ werden.
27
+
28
+ Aufruf: pythonw.exe mcp-starter.py <befehl> [argumente]
29
+ z. B. … mcp-starter.py npx -y knowmind mcp
30
+ oder … mcp-starter.py node C:/…/knowmind.js mcp
31
+ """
32
+ import shutil
33
+ import subprocess
34
+ import sys
35
+ import threading
36
+
37
+
38
+
39
+ def pumpe(quelle, ziel) -> None:
40
+ """Schiebt Bytes weiter, sobald sie da sind, und schliesst am Ende sauber."""
41
+ try:
42
+ while True:
43
+ brocken = quelle.read(1)
44
+ if not brocken:
45
+ break
46
+ ziel.write(brocken)
47
+ ziel.flush()
48
+ except Exception: # noqa: BLE001 — Abbruch beim Beenden ist normal
49
+ pass
50
+ finally:
51
+ try:
52
+ ziel.close()
53
+ except Exception: # noqa: BLE001
54
+ pass
55
+
56
+
57
+ def _ohne_fenster():
58
+ """Startet node in einer versteckten Konsole statt ganz ohne.
59
+
60
+ `CREATE_NO_WINDOW` allein nimmt dem Prozess die Konsole — und ein Kind,
61
+ dessen Eltern keine hat, legt sich eine neue an, die sichtbar ist. Am
62
+ 02.09.2026 blitzte deshalb bei jedem Aufruf ein Fenster auf; gemessen
63
+ wurde: konsolenlos einmal Blitz in drei Läufen, versteckte Konsole
64
+ keinmal.
65
+
66
+ `CREATE_NEW_CONSOLE` mit `SW_HIDE` gibt dem Prozess eine eigene, aber
67
+ unsichtbare Konsole, die seine Kinder erben.
68
+ """
69
+ if sys.platform != "win32":
70
+ return {}
71
+ info = subprocess.STARTUPINFO()
72
+ info.dwFlags |= subprocess.STARTF_USESHOWWINDOW
73
+ info.wShowWindow = subprocess.SW_HIDE
74
+ return {"startupinfo": info,
75
+ "creationflags": subprocess.CREATE_NEW_CONSOLE}
76
+
77
+
78
+ def main() -> int:
79
+ if len(sys.argv) < 2:
80
+ sys.stderr.write("Aufruf: mcp-starter.py <knowmind.js> [args...]\n")
81
+ return 2
82
+
83
+ # Erstes Argument ist der zu startende Befehl (node, npx, …), Rest sind
84
+ # dessen Argumente. Unter Windows liegt npx als .cmd vor; subprocess findet
85
+ # es nur über den vollen Pfad, deshalb erst auflösen.
86
+ befehl = list(sys.argv[1:])
87
+ aufgeloest = shutil.which(befehl[0])
88
+ if aufgeloest:
89
+ befehl[0] = aufgeloest
90
+
91
+ try:
92
+ prozess = subprocess.Popen(
93
+ befehl,
94
+ stdin=subprocess.PIPE,
95
+ stdout=subprocess.PIPE,
96
+ stderr=sys.stderr,
97
+ bufsize=0,
98
+ **_ohne_fenster(),
99
+ )
100
+ except FileNotFoundError:
101
+ sys.stderr.write(f"node nicht gefunden: {node}\n")
102
+ return 127
103
+
104
+ faeden = [
105
+ threading.Thread(target=pumpe, args=(sys.stdin.buffer, prozess.stdin), daemon=True),
106
+ threading.Thread(target=pumpe, args=(prozess.stdout, sys.stdout.buffer), daemon=True),
107
+ ]
108
+ for f in faeden:
109
+ f.start()
110
+
111
+ try:
112
+ return prozess.wait()
113
+ except KeyboardInterrupt:
114
+ prozess.terminate()
115
+ return 0
116
+
117
+
118
+ if __name__ == "__main__":
119
+ raise SystemExit(main())