# Start 首次启动常规设置补漏

状态：已实现，未验证；复用既有 Start 包，不新增孤立任务。

## 具体修复

桌面依据 `freecad-source/src/Mod/Start/Gui/GeneralSettingsWidget.cpp`：首次启动页面中的 Language、Unit System、Navigation Style 会立即写入 General、Units.UserSchema 和 View.NavigationStyle，并与 ThemeSelector 一起作用。Web 原先只有 `StartPreferencesEditor` 的后置偏好页，`StartLaunchPanel` 首次启动区只有 Theme、ShowExamples、CustomFolder 和 closeStart，导致首次设置入口漏掉三项常规设置；并且 UserSchema 数值被当成 String 发给参数桥。

本轮复用并集中修复：

- `web/src/start-preferences.tsx` 新增 `readStartGeneral`、`saveStartGeneral` 和 `FirstStartGeneralSettings`，从已有 PartBox 参数所有者读取并立即保存 Language、UserSchema、NavigationStyle、Theme；UserSchema 使用原生 Int 类型，保存失败保留错误提示和可恢复当前值。
- `applyStartTheme` 统一写入 `data-theme`、`color-scheme`，并广播 `freecad-theme-changed`；既有后置 General settings 复用同一个控件和原生桥，不再保留两份行为不同的实现。
- `web/src/start-launch-panel.tsx` 的 First start setup 挂载同一 General settings 控件，保留原有 FirstStart2024、ShowExamples、CustomFolder、closeStart、Done、Reload、Dismiss 生命周期；主题不再只写 localStorage，而由共享控件实时应用。

参数路径与桌面语义：

- `User parameter:BaseApp/Preferences/General/Language`
- `User parameter:BaseApp/Preferences/Units/UserSchema`（Int）
- `User parameter:BaseApp/Preferences/View/NavigationStyle`
- Web shell theme via `document.documentElement.dataset.theme` and `colorScheme`

## 复用与边界

复用 `startParameters`、`requestOwnerParameters`、`navigationStyles`、PartBox/DocumentProbe 参数持久化和现有 StartPreferencesEditor；不新建文档、不改变 Start 文件打开/新建/示例/自定义目录流程，不改 OCCT 或 Three.js。

语言选择写入原生 General 参数，并广播设置刷新事件；当前仓库没有独立 Web 翻译目录/运行时 locale loader，本轮保留已有静态 shell 文案机制，未虚构桌面 Qt 的即时翻译能力。后续若加入实际 locale loader，应复用该事件和参数 owner，而不是重新添加第二套首次启动页面。

## 构建

- 修改：`web/src/start-preferences.tsx`、`web/src/start-launch-panel.tsx`。
- 必要前端构建：`python3 tools/build_web_frontend.py`。
- 日志：`docs/current/start-first-start-general-settings-20260923/build.log`，退出码 0，built in 1.64s。
- 未运行测试、类型检查、浏览器、截图、烟测或验收；没有原生源码变化，无原生构建。

处理模块 | 对标项 | 源码落点 | 路由入口 | OCCT 边界 | 状态 | 结论
--- | --- | --- | --- | --- | --- | ---
Start | 首次启动语言/单位/导航/主题 | start-launch-panel.tsx；start-preferences.tsx | Start_Start → FirstStartGeneralSettings → requestOwnerParameters | 仅原生偏好，无几何算法 | 已补漏（未验证） | 保留