jim800121chen
8cd5751ce3
依 R5 五輪決策把 visionA-local 從「Wails 內嵌 Next.js」重構為「Wails
本機伺服器控制台 + 瀏覽器 Web UI」模式（類比 Docker Desktop / Ollama）。
程式碼變動
- M8-1 砍 yt-dlp 全套（後端 resolver / URL handler / 前端 URL tab /
Makefile vendor / installer / bootstrap / CI workflow，-555 行）
- M8-2 砍 Mock 模式全套（driver/mock、mock_camera、Settings runtimeMode、
VISIONA_MOCK 環境變數，-528 行）
- M8-3 ffmpeg 從 GPL 切換到 LGPL 混合方案：Windows/Linux 用 BtbN 現成
LGPL binary，macOS 自 build minimal decoder-only 進 git
（vendor/ffmpeg/macos/ffmpeg 5.7MB + ffprobe 5.6MB，比 GPL 版省 85% 空間）
- M8-4 Wails Server Controller：state machine、log ring buffer 2000 行、
preferences.json atomic write、boot-id、Gin SkipPaths、shutdown 7+1 秒、
notify_*.go 三平台 OS 通知、watchServer 改 Error state 不 os.Exit
- M8-4b 啟動階段管線 R5-E：6 階段進度 event、20s soft / 60s hard timeout、
stage 5/6 skip 規則、sentinel file、RestartStartupSequence 5 步驟
- M8-5 Wails 控制台 vanilla HTML/JS/CSS（9 檔 ~2012 行）取代 M7-B splash：
state 視覺、log panel、startup progress panel、Stage 6 manual CTA
pulse、shutdown modal、Settings、Dark Mode、i18n 中英雙語
- M8-6 上傳影片副檔名擴充（mp4/avi/mov/mpeg/mpg）
- M8-7 Web UI Server Offline Overlay（role=alertdialog + focus trap +
wsEverConnected 容錯 + Page Visibility）
- M8-8 CORS middleware（127.0.0.1/localhost only + suffix attack 防護）+
ws/origin.go 獨立 WebSocket CheckOrigin 避 package cycle
- MAJ-4 server:shutdown-imminent WebSocket broadcast 機制
（/ws/system endpoint + notifyShutdownImminent helper）
- M8-9 Boot-ID + 瀏覽器 tab 自動重連（sessionStorage loop guard）
品質
- ~105+ 新 unit test + race detector (-count=2) 全綠
- 10 個 milestone 全部通過 Reviewer 審查
- 三方 v2 + v2.1 文件（PRD / Design Spec / TDD）+ 交叉互審紀錄
收錄在 .autoflow/
交付前待處理（M8-10）
- 重跑 make payload-macos 把舊 GPL 77MB binary 換成新 LGPL
- 三平台 end-to-end build 驗證
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
60 lines
1.8 KiB
Go
60 lines
1.8 KiB
Go
package config
|
||
|
||
import (
|
||
"flag"
|
||
"fmt"
|
||
)
|
||
|
||
// PythonMode 表示 Python runtime 選擇策略。
|
||
// M1 階段只保留欄位與 CLI flag，實際切換邏輯由後續 milestone 實作。
|
||
type PythonMode string
|
||
|
||
const (
|
||
PythonModeAuto PythonMode = "auto"
|
||
PythonModeBundled PythonMode = "bundled"
|
||
PythonModeSystem PythonMode = "system"
|
||
)
|
||
|
||
type Config struct {
|
||
Port int
|
||
Host string
|
||
LogLevel string
|
||
DevMode bool
|
||
DataDir string
|
||
ModelDir string
|
||
PythonMode PythonMode
|
||
PythonBin string // Python 可執行檔路徑（由 Wails 殼層傳入）
|
||
}
|
||
|
||
func Load() *Config {
|
||
cfg := &Config{}
|
||
var pythonMode string
|
||
|
||
flag.IntVar(&cfg.Port, "port", 3721, "Server port")
|
||
// 強制 localhost-only：即使使用者傳入其他 host，Load() 結束前會覆寫回 127.0.0.1
|
||
flag.StringVar(&cfg.Host, "host", "127.0.0.1", "Server host (forced to 127.0.0.1 for local-only use)")
|
||
flag.StringVar(&cfg.LogLevel, "log-level", "info", "Log level (debug/info/warn/error)")
|
||
flag.BoolVar(&cfg.DevMode, "dev", false, "Dev mode: disable embedded static file serving")
|
||
flag.StringVar(&cfg.DataDir, "data-dir", "", "Override data directory (default: <binary>/data)")
|
||
flag.StringVar(&cfg.ModelDir, "model-dir", "", "Override custom model directory (default: <data-dir>/custom-models)")
|
||
flag.StringVar(&pythonMode, "python-mode", "auto", "Python runtime strategy: auto|bundled|system (placeholder for M1)")
|
||
flag.StringVar(&cfg.PythonBin, "python", "", "Path to python executable (optional; provided by Wails shell)")
|
||
flag.Parse()
|
||
|
||
// 強制 localhost-only
|
||
cfg.Host = "127.0.0.1"
|
||
|
||
switch PythonMode(pythonMode) {
|
||
case PythonModeAuto, PythonModeBundled, PythonModeSystem:
|
||
cfg.PythonMode = PythonMode(pythonMode)
|
||
default:
|
||
cfg.PythonMode = PythonModeAuto
|
||
}
|
||
|
||
return cfg
|
||
}
|
||
|
||
func (c *Config) Addr() string {
|
||
return fmt.Sprintf("%s:%d", c.Host, c.Port)
|
||
}
|