frontend: add electron service bootstrap, preload and api client

FE-001: detect and launch the local mactfs-server, expose a narrow preload
bridge (token, service status, directory picker), and add a unified API
client that auto-attaches the Bearer token. Home becomes a bootstrap gate
with a retry entry. Update task board, FE-001 record and FRONTEND_SPEC.

Co-authored-by: Cursor <cursoragent@cursor.com>

mactfsui/app/lib/electron/bridge.ts

@@ -0,0 +1,88 @@
+import type { MactfsBridge, ServiceStatus } from "./types"
+
+const DEFAULT_BASE_URL = "http://127.0.0.1:38765"
+
+/**
+ * 获取 Electron 暴露的 window.mactfs 桥接对象，非 Electron 环境（含 SSR）返回 null。
+ */
+export function getBridge(): MactfsBridge | null {
+  if (typeof window === "undefined") {
+    return null
+  }
+  return window.mactfs ?? null
+}
+
+/**
+ * 判断当前是否运行在 Electron 桥接环境中。
+ */
+export function isElectron(): boolean {
+  return getBridge() != null
+}
+
+/**
+ * 获取本地 API 基础地址，非 Electron 环境回退到默认本地地址。
+ */
+export async function getApiBaseUrl(): Promise<string> {
+  const bridge = getBridge()
+  if (!bridge) {
+    return DEFAULT_BASE_URL
+  }
+  return bridge.getApiBaseUrl()
+}
+
+/**
+ * 获取本地服务 Bearer Token，非 Electron 环境返回 null。
+ */
+export async function getToken(): Promise<string | null> {
+  const bridge = getBridge()
+  if (!bridge) {
+    return null
+  }
+  return bridge.getToken()
+}
+
+/**
+ * 查询本地服务状态，非 Electron 环境返回未就绪状态并说明原因。
+ */
+export async function getServiceStatus(): Promise<ServiceStatus> {
+  const bridge = getBridge()
+  if (!bridge) {
+    return unavailableStatus()
+  }
+  return bridge.getServiceStatus()
+}
+
+/**
+ * 拉起并等待本地服务就绪，非 Electron 环境返回未就绪状态并说明原因。
+ */
+export async function startService(): Promise<ServiceStatus> {
+  const bridge = getBridge()
+  if (!bridge) {
+    return unavailableStatus()
+  }
+  return bridge.startService()
+}
+
+/**
+ * 打开系统目录选择器，非 Electron 环境返回 null。
+ */
+export async function selectDirectory(): Promise<string | null> {
+  const bridge = getBridge()
+  if (!bridge) {
+    return null
+  }
+  return bridge.selectDirectory()
+}
+
+/**
+ * 构造非 Electron 环境下的占位服务状态。
+ */
+function unavailableStatus(): ServiceStatus {
+  return {
+    running: false,
+    baseUrl: DEFAULT_BASE_URL,
+    tokenAvailable: false,
+    health: null,
+    error: "当前不在 Electron 桌面环境，无法访问本地服务",
+  }
+}