feat(engine): add engine management and config editor

- Add engine.go for proxy engine lifecycle management
- Add ConfigEditor component for runtime configuration
This commit is contained in:
Finessse
2025-12-28 00:05:35 +07:00
parent bb562e3d36
commit 2e7b68922a
2 changed files with 310 additions and 0 deletions
+197
View File
@@ -0,0 +1,197 @@
//go:build windows
package main
import (
"context"
"errors"
"fmt"
"sync"
"time"
"github.com/router-for-me/CLIProxyAPI/v6/internal/config"
"github.com/router-for-me/CLIProxyAPI/v6/internal/desktopctl"
"github.com/router-for-me/CLIProxyAPI/v6/sdk/cliproxy"
log "github.com/sirupsen/logrus"
)
// EmbeddedEngine runs the proxy service in-process within the tray application.
// It provides thread-safe methods for starting, stopping, and querying the service status.
type EmbeddedEngine struct {
mu sync.Mutex
// running indicates whether the service is currently active.
running bool
// port is the port number the service is listening on.
port int
// configPath stores the path to the configuration file.
configPath string
// lastError holds the most recent error encountered during operation.
lastError error
// startedAt records when the service was started.
startedAt time.Time
// cancel is the function to cancel the service context.
cancel context.CancelFunc
// wg waits for the service goroutine to complete.
wg sync.WaitGroup
}
// NewEmbeddedEngine creates a new EmbeddedEngine instance.
func NewEmbeddedEngine() *EmbeddedEngine {
return &EmbeddedEngine{}
}
// Start builds and runs the proxy service in a background goroutine.
// It returns an error if the service is already running or if building the service fails.
func (e *EmbeddedEngine) Start(cfg *config.Config, configPath, password string) error {
e.mu.Lock()
defer e.mu.Unlock()
if e.running {
return errors.New("engine is already running")
}
if cfg == nil {
return errors.New("configuration is required")
}
if configPath == "" {
return errors.New("configuration path is required")
}
// Build the service using the SDK builder pattern
builder := cliproxy.NewBuilder().
WithConfig(cfg).
WithConfigPath(configPath).
WithLocalManagementPassword(password)
service, err := builder.Build()
if err != nil {
e.lastError = fmt.Errorf("failed to build proxy service: %w", err)
return e.lastError
}
// Create a cancelable context for the service
ctx, cancel := context.WithCancel(context.Background())
e.cancel = cancel
// Track state
e.running = true
e.port = cfg.Port
e.configPath = configPath
e.lastError = nil
e.startedAt = time.Now()
log.Infof("starting embedded proxy engine on port %d", e.port)
// Run the service in a goroutine
e.wg.Add(1)
go func() {
defer e.wg.Done()
defer func() {
e.mu.Lock()
e.running = false
e.cancel = nil
e.mu.Unlock()
log.Info("embedded proxy engine stopped")
}()
err := service.Run(ctx)
if err != nil && !errors.Is(err, context.Canceled) {
e.mu.Lock()
e.lastError = fmt.Errorf("proxy service exited with error: %w", err)
e.mu.Unlock()
log.Errorf("embedded proxy engine error: %v", err)
}
}()
return nil
}
// Stop cancels the running service and waits for it to shut down.
// It returns an error if the service is not running.
func (e *EmbeddedEngine) Stop() error {
e.mu.Lock()
if !e.running {
e.mu.Unlock()
return errors.New("engine is not running")
}
if e.cancel != nil {
log.Info("stopping embedded proxy engine...")
e.cancel()
}
e.mu.Unlock()
// Wait for the goroutine to complete
e.wg.Wait()
return nil
}
// Restart stops the running service (if any) and starts it again with the new configuration.
func (e *EmbeddedEngine) Restart(cfg *config.Config, configPath, password string) error {
// Stop if running (ignore error if not running)
if e.IsRunning() {
if err := e.Stop(); err != nil {
log.Warnf("error stopping engine during restart: %v", err)
}
}
// Start with new configuration
return e.Start(cfg, configPath, password)
}
// Status returns the current status of the embedded engine.
// The returned status is compatible with desktopctl.Status for UI integration.
func (e *EmbeddedEngine) Status() desktopctl.Status {
e.mu.Lock()
defer e.mu.Unlock()
status := desktopctl.Status{
Running: e.running,
Managed: true, // Embedded engine is always managed by the tray
Port: e.port,
ConfigPath: e.configPath,
StartedAt: e.startedAt,
}
if e.running && e.port > 0 {
status.BaseURL = fmt.Sprintf("http://127.0.0.1:%d", e.port)
}
if e.lastError != nil {
status.LastError = e.lastError.Error()
}
return status
}
// IsRunning returns whether the engine is currently running.
func (e *EmbeddedEngine) IsRunning() bool {
e.mu.Lock()
defer e.mu.Unlock()
return e.running
}
// LastError returns the most recent error encountered, or nil if none.
func (e *EmbeddedEngine) LastError() error {
e.mu.Lock()
defer e.mu.Unlock()
return e.lastError
}
// Port returns the port number the engine is configured to listen on.
func (e *EmbeddedEngine) Port() int {
e.mu.Lock()
defer e.mu.Unlock()
return e.port
}
@@ -0,0 +1,113 @@
import { useState, useEffect } from 'react'
import { useProxyContext, EngineOfflineError } from '@/hooks/useProxyContext'
import { Card, CardContent, CardHeader, CardTitle, CardDescription } from '@/components/ui/card'
import { Button } from '@/components/ui/button'
import { Save, RotateCcw, Loader2, FileCode } from 'lucide-react'
export function ConfigEditor() {
const { mgmtFetch, showToast, status, isMgmtLoading } = useProxyContext()
const [configYaml, setConfigYaml] = useState('')
const [isSaving, setIsSaving] = useState(false)
const isRunning = status?.running ?? false
const fetchConfig = async () => {
try {
const data = await mgmtFetch('/v0/management/config.yaml')
setConfigYaml(typeof data === 'string' ? data : JSON.stringify(data, null, 2))
} catch (e) {
if (!(e instanceof EngineOfflineError)) {
showToast(e instanceof Error ? e.message : String(e), 'error')
}
}
}
const saveConfig = async () => {
setIsSaving(true)
try {
await mgmtFetch('/v0/management/config.yaml', {
method: 'PUT',
headers: { 'Content-Type': 'application/yaml' },
body: configYaml,
})
showToast('Configuration saved successfully', 'success')
} catch (e) {
showToast(e instanceof Error ? e.message : String(e), 'error')
} finally {
setIsSaving(false)
}
}
useEffect(() => {
if (isRunning) {
fetchConfig()
}
}, [isRunning])
return (
<Card className="backdrop-blur-sm bg-card/60 border-border/50 shadow-xl overflow-hidden">
<CardHeader className="pb-4 border-b border-border/50 bg-gradient-to-r from-purple-500/5 to-transparent">
<div className="flex items-center justify-between">
<div className="flex items-center gap-3">
<div className="h-10 w-10 rounded-xl bg-purple-500/10 flex items-center justify-center">
<FileCode className="h-5 w-5 text-purple-500" />
</div>
<div>
<CardTitle className="text-lg">Config Editor</CardTitle>
<CardDescription>Edit config.yaml directly</CardDescription>
</div>
</div>
<div className="flex items-center gap-2">
<Button
size="sm"
variant="outline"
onClick={fetchConfig}
disabled={!isRunning || isMgmtLoading}
className="gap-1.5 text-xs"
>
<RotateCcw className="h-3.5 w-3.5" />
Reset
</Button>
<Button
size="sm"
onClick={saveConfig}
disabled={!isRunning || isSaving || isMgmtLoading}
className="gap-1.5 text-xs bg-purple-600 hover:bg-purple-700 text-white"
>
{isSaving ? <Loader2 className="h-3.5 w-3.5 animate-spin" /> : <Save className="h-3.5 w-3.5" />}
Save Changes
</Button>
</div>
</div>
</CardHeader>
<CardContent className="p-0">
{!isRunning ? (
<div className="py-12 text-center text-muted-foreground">
<p className="text-sm uppercase tracking-widest font-mono">⚠️ Engine Offline</p>
<p className="text-xs mt-1">Start the proxy engine to edit configuration</p>
</div>
) : (
<div className="relative">
<textarea
value={configYaml}
onChange={(e) => setConfigYaml(e.target.value)}
spellCheck={false}
className="w-full h-[500px] p-6 bg-[var(--bg-void)] text-[var(--text-primary)] font-mono text-sm resize-none focus:outline-none selection:bg-purple-500/30"
style={{
fontFamily: '"JetBrains Mono", "Fira Code", monospace',
lineHeight: '1.6',
}}
/>
{/* Decorative grid background for the editor */}
<div
className="absolute inset-0 pointer-events-none opacity-[0.03]"
style={{
backgroundImage: `linear-gradient(var(--border-subtle) 1px, transparent 1px), linear-gradient(90deg, var(--border-subtle) 1px, transparent 1px)`,
backgroundSize: '20px 20px'
}}
/>
</div>
)}
</CardContent>
</Card>
)
}