local-tool/: visionA-local desktop app
- M1: Wails shell + Go server + Next.js UI + Mock mode (macOS dmg ready)
- M2: i18n (zh-TW/en) + Settings 4-tab refactor
- M3: Embedded Python 3.12 runtime (python-build-standalone) + KneronPLUS wheels
- M4: Windows Inno Setup script (build on Windows runner)
- M5: Linux AppImage script + udev rule (build on Linux runner)
- M6: ffmpeg (GPL, pending legal review) + yt-dlp bundled
- Lifecycle: watchServer health check, fatal native dialog,
Wails IPC raise endpoint, stale process cleanup
.autoflow/: full PRD / Design Spec / Architecture / Testing docs
(4 rounds tri-party discussion + cross review)
.github/workflows/: macOS / Windows / Linux build CI
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
233 lines
6.4 KiB
Go
233 lines
6.4 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
"log"
|
|
"net"
|
|
"net/http"
|
|
"os"
|
|
"os/exec"
|
|
"os/signal"
|
|
"path/filepath"
|
|
"runtime"
|
|
"strings"
|
|
"syscall"
|
|
"time"
|
|
|
|
"visiona-local/server/internal/api"
|
|
"visiona-local/server/internal/api/handlers"
|
|
"visiona-local/server/internal/api/ws"
|
|
"visiona-local/server/internal/camera"
|
|
"visiona-local/server/internal/config"
|
|
"visiona-local/server/internal/deps"
|
|
"visiona-local/server/internal/device"
|
|
"visiona-local/server/internal/inference"
|
|
"visiona-local/server/internal/model"
|
|
pkglogger "visiona-local/server/pkg/logger"
|
|
"visiona-local/server/web"
|
|
)
|
|
|
|
var (
|
|
Version = "dev"
|
|
BuildTime = "unknown"
|
|
)
|
|
|
|
// baseDir returns the base directory for resolving data/ and scripts/ paths.
|
|
// In dev mode (go run), uses the working directory.
|
|
// In production (compiled binary), uses the binary's directory so the server
|
|
// works correctly regardless of the working directory.
|
|
func baseDir(devMode bool) string {
|
|
if devMode {
|
|
return "."
|
|
}
|
|
exe, err := os.Executable()
|
|
if err != nil {
|
|
return "."
|
|
}
|
|
return filepath.Dir(exe)
|
|
}
|
|
|
|
func main() {
|
|
cfg := config.Load()
|
|
|
|
logger := pkglogger.New(cfg.LogLevel)
|
|
|
|
logger.Info("Starting visionA-local Server %s (built: %s)", Version, BuildTime)
|
|
logger.Info("Mock mode: %v, Mock camera: %v, Dev mode: %v, Python mode: %s",
|
|
cfg.MockMode, cfg.MockCamera, cfg.DevMode, cfg.PythonMode)
|
|
|
|
// Check external dependencies
|
|
deps.PrintStartupReport(logger)
|
|
|
|
// Resolve base directory and data directory
|
|
base := baseDir(cfg.DevMode)
|
|
dataDir := cfg.DataDir
|
|
if dataDir == "" {
|
|
dataDir = filepath.Join(base, "data")
|
|
}
|
|
|
|
// Initialize model repository (built-in models from JSON)
|
|
modelRepo := model.NewRepository(filepath.Join(dataDir, "models.json"))
|
|
logger.Info("Loaded %d built-in models", modelRepo.Count())
|
|
|
|
// Initialize model store (custom uploaded models)
|
|
customModelDir := cfg.ModelDir
|
|
if customModelDir == "" {
|
|
customModelDir = filepath.Join(dataDir, "custom-models")
|
|
}
|
|
modelStore := model.NewModelStore(customModelDir)
|
|
customModels, err := modelStore.LoadCustomModels()
|
|
if err != nil {
|
|
logger.Warn("Failed to load custom models: %v", err)
|
|
}
|
|
for _, m := range customModels {
|
|
modelRepo.Add(m)
|
|
}
|
|
if len(customModels) > 0 {
|
|
logger.Info("Loaded %d custom models", len(customModels))
|
|
}
|
|
|
|
// Initialize WebSocket hub (before device manager so log broadcaster is ready)
|
|
wsHub := ws.NewHub()
|
|
go wsHub.Run()
|
|
|
|
// Initialize log broadcaster for real-time log streaming
|
|
logBroadcaster := pkglogger.NewBroadcaster(500, func(entry pkglogger.LogEntry) {
|
|
wsHub.BroadcastToRoom("server-logs", entry)
|
|
})
|
|
logger.SetBroadcaster(logBroadcaster)
|
|
|
|
// Initialize device manager
|
|
registry := device.NewRegistry()
|
|
deviceMgr := device.NewManager(registry, cfg.MockMode, cfg.MockDeviceCount, filepath.Join(base, "scripts", "kneron_bridge.py"))
|
|
deviceMgr.SetLogBroadcaster(logBroadcaster)
|
|
deviceMgr.Start()
|
|
|
|
// Initialize camera manager
|
|
cameraMgr := camera.NewManager(cfg.MockCamera)
|
|
|
|
// Initialize services
|
|
inferenceSvc := inference.NewService(deviceMgr)
|
|
|
|
// Determine static file system for embedded frontend
|
|
var staticFS http.FileSystem
|
|
if !cfg.DevMode {
|
|
staticFS = web.StaticFS()
|
|
logger.Info("Serving embedded frontend static files")
|
|
} else {
|
|
logger.Info("Dev mode: frontend static serving disabled (use Wails dev server)")
|
|
}
|
|
|
|
// Build HTTP server (needed for graceful shutdown and restart)
|
|
var httpServer *http.Server
|
|
restartRequested := make(chan struct{}, 1)
|
|
|
|
shutdownFn := func() {
|
|
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
|
|
defer cancel()
|
|
inferenceSvc.StopAll()
|
|
cameraMgr.Close()
|
|
if httpServer != nil {
|
|
_ = httpServer.Shutdown(ctx)
|
|
}
|
|
}
|
|
|
|
restartFn := func() {
|
|
// Signal the main goroutine to perform exec after server shutdown
|
|
select {
|
|
case restartRequested <- struct{}{}:
|
|
default:
|
|
}
|
|
shutdownFn()
|
|
}
|
|
|
|
// Create system handler with injected version and restart function
|
|
systemHandler := handlers.NewSystemHandler(Version, BuildTime, restartFn)
|
|
|
|
// Create router
|
|
r := api.NewRouter(modelRepo, modelStore, deviceMgr, cameraMgr, inferenceSvc, wsHub, staticFS, logBroadcaster, systemHandler)
|
|
|
|
// Configure HTTP server (bind to localhost only)
|
|
addr := cfg.Addr()
|
|
httpServer = &http.Server{
|
|
Addr: addr,
|
|
Handler: r,
|
|
}
|
|
|
|
// Handle OS signals for graceful shutdown
|
|
quit := make(chan os.Signal, 1)
|
|
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
|
|
go func() {
|
|
sig := <-quit
|
|
logger.Info("Received signal %v, shutting down gracefully...", sig)
|
|
shutdownFn()
|
|
os.Exit(0)
|
|
}()
|
|
|
|
// Kill existing process on the port if occupied
|
|
killExistingProcess(addr, logger)
|
|
|
|
// Start server
|
|
logger.Info("Server listening on %s", addr)
|
|
if err := httpServer.ListenAndServe(); err != nil && !errors.Is(err, http.ErrServerClosed) {
|
|
log.Fatalf("Failed to start server: %v", err)
|
|
}
|
|
|
|
// If restart was requested, exec the same binary to replace this process
|
|
select {
|
|
case <-restartRequested:
|
|
logger.Info("Performing self-restart via exec...")
|
|
exe, err := os.Executable()
|
|
if err != nil {
|
|
log.Fatalf("Failed to get executable path: %v", err)
|
|
}
|
|
exe, err = filepath.EvalSymlinks(exe)
|
|
if err != nil {
|
|
log.Fatalf("Failed to resolve executable symlinks: %v", err)
|
|
}
|
|
_ = syscall.Exec(exe, os.Args, os.Environ())
|
|
log.Fatalf("syscall.Exec failed")
|
|
default:
|
|
// Normal shutdown, just exit
|
|
}
|
|
}
|
|
|
|
// killExistingProcess checks if the port is already in use and kills the
|
|
// occupying process so the server can start cleanly.
|
|
func killExistingProcess(addr string, logger *pkglogger.Logger) {
|
|
// Extract port from addr (e.g. "127.0.0.1:3721" → "3721")
|
|
_, port, err := net.SplitHostPort(addr)
|
|
if err != nil {
|
|
return
|
|
}
|
|
|
|
// Quick check: try to listen — if it works, port is free
|
|
ln, err := net.Listen("tcp", addr)
|
|
if err == nil {
|
|
ln.Close()
|
|
return
|
|
}
|
|
|
|
// Port is occupied, find and kill the process
|
|
logger.Info("Port %s is in use, killing existing process...", port)
|
|
|
|
var cmd *exec.Cmd
|
|
if runtime.GOOS == "windows" {
|
|
cmd = exec.Command("cmd", "/C", fmt.Sprintf("for /f \"tokens=5\" %%a in ('netstat -ano ^| findstr :%s') do taskkill /F /PID %%a", port))
|
|
} else {
|
|
cmd = exec.Command("sh", "-c", fmt.Sprintf("lsof -ti:%s | xargs kill -9 2>/dev/null", port))
|
|
}
|
|
|
|
output, err := cmd.CombinedOutput()
|
|
if err != nil {
|
|
logger.Warn("Failed to kill process on port %s: %v (%s)", port, err, strings.TrimSpace(string(output)))
|
|
return
|
|
}
|
|
|
|
// Wait briefly for port to be released
|
|
time.Sleep(500 * time.Millisecond)
|
|
logger.Info("Previous process killed, port %s is now free", port)
|
|
}
|