WPF + FastAPI 前置服务自动拉起
适用于 .NET (net8.0-windows) WPF 桌面程序需要本地 Python 后端（数据获取/指标/HTTP 接口）的场景，
典型如量化工具（akshare 行情）。核心是让 C# 在 App.OnStartup 自动确保 Python 服务存活，
无需用户手动开终端。
何时用
- 用户要求"项目要有前置 Python 服务""确保 akshare 已安装""对齐 StockGuard 的 Python 服务"。
- WPF 需要本地 HTTP(JSON) 与 Python 通信，且不想每次手动
start_api.bat。
架构铁则
- Python 只做数据获取/指标/HTTP 接口，绝不写资金/仓位/风控。
- C# 做 UI/DB/仓位/回测/通知。
- 两端本地 HTTP+JSON 通信（建议监听
127.0.0.1:8001，避开常用 8000 以便多项目并存）。
文件结构
<ProjectRoot>/
GuCeWorkshop.Api/ # Python 后端目录（名字随意，但要能被 C# 定位）
main.py # FastAPI app，__main__ 里 uvicorn.run(..., port=8001)
requirements.txt # fastapi>=0.110 / uvicorn[standard]>=0.27 / akshare>=1.12
start_api.bat # 可手动启动（自动建 .venv 装依赖）
PythonServiceLauncher.cs # C# 静态类，自动拉起服务
App.xaml.cs # OnStartup 调用 EnsureRunningAsync()
Python 端要点（main.py）
import akshare as ak用try/except包裹，置_AKSHARE_OK；未装时服务仍能启动，相关接口返回 503 并提示pip install akshare。- 行情优先东财
ak.stock_zh_a_hist(timeout=15.0)，失败降级新浪ak.stock_zh_a_daily（重试 1 次）。 - 全局
socket.setdefaulttimeout(30)防单只挂起。 - 股票列表加 5 分钟 TTL 缓存（
ak.stock_info_a_code_name()）。 - 批量接口用
ThreadPoolExecutor(max_workers=8)定义为普通def（FastAPI 自动入线程池）。 - 健康检查
GET /api/health返回{ok, service, version, akshare}。
C# 端要点（PythonServiceLauncher.cs）
照搬以下流程（PreparePythonAsync 是关键）：
- 探测健康：
HttpClient.GetAsync("http://127.0.0.1:8001/api/health")成功则跳过。 - 定位 Api 目录：从
AppContext.BaseDirectory向上查找含main.py的GuCeWorkshop.Api目录。 - 选解释器：
- 优先apiDir/.venv/Scripts/python.exe且能import fastapi,uvicorn,akshare→ 直接用；
- 否则where python/where python3/where py解析系统 Python（TryResolveFromPath用cmd /c where <cmd>读首行）；
- 系统 Python 已能 import 三者 → 直接用；否则建.venv并python -m pip install -r requirements.txt。 - 启动：
Process.Start(python, "-m uvicorn main:app --host 127.0.0.1 --port 8001")，重定向 stdout/stderr 到日志。 - 轮询就绪：每 500ms 探 health，最长 30s；超时仅记日志不阻断 UI。
- 回收：
AppDomain.CurrentDomain.ProcessExit += StopIfOwned；静态_ownedProcess退出时Kill()。
CanImportAsync 检测依赖：
var arg = new StringBuilder("-c \"");
foreach (var m in modules) arg.Append($"import {m};");
arg.Append("\"");
return await RunCommandAsync(python, arg.ToString(), null, 15000, silent: true);
App.xaml.cs 接入
protected override void OnStartup(StartupEventArgs e)
{
base.OnStartup(e);
// 设计器不运行 App，无需 DesignMode 包裹；OnStartup 仅运行时调用
Task.Run(() => PythonServiceLauncher.EnsureRunningAsync()).GetAwaiter().GetResult();
}
注意：DesignerProperties.GetIsInDesignMode(this) 中 this(Application) 不是 DependencyObject 会编译报错；
且 WPF 设计器预览不实例化 App，故 OnStartup 里不必做设计模式判断。若强行判断，用
DesignerProperties.GetIsInDesignMode(new DependencyObject()) 或干脆省略。
编译与验证
dotnet build -c Release须 0 警告 0 错误（可空标注：解释器/目录变量用string?，RunCommandAsync的workingDir参数用string?）。python -m py_compile GuCeWorkshop.Api/main.py校验语法。- 运行：本机有 Python+akshare 时启动即秒过；首次无依赖会自动建
.venv安装（较慢，约 1–3 分钟）。
避坑
Process.Start(psi)!在 lambda 内访问proc用proc!消可空警告。where解析失败时返回 null，调用方用string.IsNullOrEmpty判定，不要直接当路径用。RunCommandAsync用CancellationTokenSource(timeoutMs)超时Kill子进程并TrySetResult(false)。- 端口务必与同类项目错开（如 StockGuard 用 8000，本服务用 8001），避免用户同时跑两个项目冲突。
