How ningzestudio/logshare works
LogShare is a game-server log sharing and intelligent diagnosis platform. Its primary flow accepts and filters uploaded logs, stores them behind shareable IDs, and handles asynchronous deobfuscation and security review; users can then request AI diagnosis streamed over SSE. The diagnosis agent can use log-focused tools, web search, GitHub and local RAG, with trace and quality governance exposed to administrators. Edges are limited to relationships stated in the README or visible in indexed excerpts; unsampled controller and queue details are not inferred.
Main entry points: LogAgent.php LogAgent engine · Log.php Log service · RagSearch.php RAG retrieval · LogController.php Log upload API
Components 28
Upload and sharing
- Log upload API
app/Controller/LogController.php - Redaction filters
app/Filter - Log service
app/Log.php - Log metadata
app/Data/MetadataEntry.php - Delete token
app/Data/Token.php - Storage backends
app/Storage - Log retrieval API
app/Controller/RawController.php
Async processing
- Event queue
app/Queue/EventQueue.php - Queue consumers
app/Process/EventQueueConsumer.php - Event handlers
app/Queue/Handler
AI diagnosis
- AI analysis API
app/Controller/AIController.php - Analysis queue
app/Ai/AnalysisQueue.php - LogAgent engine
app/Agent/LogAgent.php - Agent tools
app/Agent/Tool - AI client
app/Client/AIClient.php - SSE streaming
app/Sse - Trace records
app/Agent/AnalysisRecordManager.php
Knowledge retrieval
- RAG API
app/Controller/RagController.php - RAG management
app/Rag/RagManager.php - RAG retrieval
app/Rag/RagSearch.php - Retrieval metrics
app/Rag/RetrievalMetrics.php
Platform services
- Redis client
app/Client/RedisClient.php - Redis cache
app/Cache/RedisCache.php - Configuration
app/Config.php - Security service
app/System/SecurityService.php - AI metrics
app/System/AiMetricsService.php - System logging
app/Syslog.php
Other components
- API client
Connections 27
- API client → Log upload API: uploads logs
README.md - Log upload API → Redaction filters: redacts files
README.md - Log upload API → Log service: stores logs
README.md - Log service → Storage backends: reads and writes
app/Log.php - Log service → Log metadata: uses metadata
app/Log.php - Log service → Delete token: uses tokens
app/Log.php - API client → Log retrieval API: requests logs
README.md - Log service → Event queue: enqueues events
README.md - Queue consumers → Event queue: consumes events
README.md - Queue consumers → Event handlers: dispatches events
README.md - API client → AI analysis API: requests diagnosis
README.md - AI analysis API → Analysis queue: submits analysis
- Analysis queue → LogAgent engine: runs analysis
app/Ai/AnalysisQueue.php - LogAgent engine → Agent tools: dispatches tools
README.md - LogAgent engine → AI client: queries model
README.md - LogAgent engine → RAG retrieval: retrieves context
README.md - LogAgent engine → SSE streaming: streams results
README.md - LogAgent engine → Trace records: archives traces
README.md - API client → RAG API: queries knowledge
README.md - RAG API → RAG retrieval: searches index
app/Controller/RagController.php - RAG management → RAG retrieval: builds index
app/Rag/RagManager.php - RAG retrieval → Retrieval metrics: records metrics
app/Rag/RagSearch.php - Redis cache → Redis client: uses connection
app/Cache/RedisCache.php - Trace records → Redis client: stores records
app/Agent/AnalysisRecordManager.php - Configuration → Security service: loads service
app/Config.php - AI metrics → Analysis queue: tracks jobs
app/System/AiMetricsService.php - System logging → Redis client: writes recent logs
app/Syslog.php