KnowledgeHub Mobile Capture

„云飞随手记“ ist der mobile Schreibdienst und das OpenAI-Plugin-Paket. Er übernimmt Texte, Sprachtranskriptionen und Anhänge aus ChatGPT auf dem Mobilgerät und schreibt sie nach dem Prinzip nur hinzufügen, niemals überschreiben in das private GitHub-Repository KnowledgeHub des jeweiligen Benutzers.

Aktueller Stand: Der Code und die lokale Testbasis sind vorhanden; erst nach Abschluss des öffentlichen Deployments, der OAuth-Konfiguration und der Abnahme auf einem echten Mobilgerät kann der persönliche KnowledgeHub die Funktion „手机随手记“ als aktiviert markiert anzeigen.

Systemgrenze

flowchart LR
    A["手机 ChatGPT\n云飞随手记"] -->|"OAuth + MCP"| B["Mobile Capture 服务"]
    B -->|"仅创建新文件"| C["GitHub 私有 KnowledgeHub"]
    C -->|"git pull"| D["本地 KnowledgeHub"]
    D --> E["Obsidian"]
    D --> F["Codex"]

Der Dienst registriert genau ein Schreibwerkzeug: create_quick_capture. Der Pfad wird serverseitig generiert; der Client kann ihn nicht angeben:

00-Inbox/Human/Quick-Captures/YYYY/MM/<时间戳>-<随机标识>.md
10-Sources/Attachments/Quick-Captures/YYYY/MM/<capture-key>/<文件名>

Die erfassten Inhalte werden nicht als Befehle ausgeführt und nicht automatisch sortiert, archiviert oder in Aufgaben umgewandelt. Bei Erfolg müssen stored: true, der Pfad im Wissensrepository und der Git-Commit-SHA zurückgegeben werden.

Related MCP server: brain-mcp

Repository-Aufbau

• src/: MCP-HTTP-Dienst, OAuth-/API-Key-Verifikation, Create-only-Schreibzugriff auf GitHub.

• plugins/knowledgehub-mobile-capture/: installierbares Plugin-Manifest und der Mobile-Capture-Skill.

• test/: Tests für Pfadgrenzen, Anhangbegrenzungen, Create-only-Semantik und Fehlerfälle.

• docs/DEPLOYMENT.md: Schritte für das Produktions-Deployment auf dem Mobilgerät und die Verbindung.

• docs/ACCEPTANCE.md: Abnahme, die vor der Aktivierung abgeschlossen sein muss.

Lokale Entwicklungsvalidierung

Der lokale API-Key-Modus dient ausschließlich der Entwicklung und dem Debugging mit Codex und darf nicht als offizielle Authentifizierungslösung für ChatGPT auf dem Mobilgerät verwendet werden.

Copy-Item .env.example .env
# 编辑 .env 后，把变量导入当前终端
npm install
npm test
npm start

Health-Check: GET http://localhost:8787/health. MCP-Endpunkt: POST http://localhost:8787/mcp mit Header Authorization: Bearer <CAPTURE_API_KEY>.

Produktionsbereitstellung für Mobilgeräte

Im Produktionsmodus muss AUTH_MODE=oauth-jwt gesetzt, ein Identity-Anbieter verwendet werden, der MCP OAuth 2.1 unterstützt, und die Bereitstellung über öffentlich erreichbares HTTPS erfolgen. ChatGPT unterstützt keinen benutzerdefinierten API-Key als Ersatz für diesen Authentifizierungsablauf. Detaillierte Schritte finden Sie in der Bereitstellungsanleitung.

Offizielle OpenAI-Dokumentation:

• MCP-Authentifizierung für Plugins

• Plugins verbinden und testen

• Plugin-Architektur

Sicherheitsprinzipien

• GitHub-Token liegen ausschließlich in den Secrets der Deployment-Plattform; sie gelangen nicht in das Repository, Plugin oder den Chat.

• Das Token autorisiert ausschließlich Lese-/Schreibzugriff auf die Contents des adressierten privaten KnowledgeHub-Repositorys.

• Der Dienst bietet keine Werkzeuge zum Ändern, Verschieben, Überschreiben oder Löschen an.

• Im OAuth-Modus wird die Prüfung von Issuer, Audience, Zugriffsbereich und der Whitelist für die sub-Werte der Benutzer erzwungen.

• Anhänge sind standardmäßig auf höchstens 5 Stück, jeweils 10 MiB und insgesamt 20 MiB begrenzt; Text ist standardmäßig auf höchstens 1 MiB begrenzt.

• Bereits erstellte Anhänge werden nicht automatisch gelöscht, wenn der abschließende Speicherschritt fehlschlägt; die Quittung listet die Pfade auf, die manuell geprüft werden müssen.

Beziehung zu KnowledgeHub

• KnowledgeHub-Framework definiert den Vertrag.

• KnowledgeHub-Setup kümmert sich um die optionale Installation und das Onboarding.

• Dieses Repository stellt den mobilen Remote-Einstieg bereit; es speichert keine Benutzerdaten oder Zugangsdaten.

• Das eigene private KnowledgeHub des Benutzers ist die alleinige maßgebliche Datenquelle.

License

MIT