chore: initialize qiming workspace repository

qimingclaw/crates/agent-electron-client/docs/operations/MACOS-TAHOE-FIX.md

@@ -0,0 +1,62 @@
+# macOS 26 Tahoe 兼容性修复
+
+## 问题描述
+
+在 macOS 26 Tahoe 上，Electron 应用启动时崩溃：
+
+```
+Exception Type: EXC_BREAKPOINT (SIGTRAP)
+Thread 0 Crashed:: Dispatch queue: com.apple.main-thread
+0 Electron Framework  cxxbridge1$box$rust_png$ResultOfReader$drop
+1 Electron Framework  ElectronMain + 84
+```
+
+## 根本原因
+
+**macOS 26 Tahoe 上存在 Electron 兼容性问题：**
+
+- **崩溃位置**: `ElectronMain` 初始化阶段
+- **相关组件**: Chromium 的 Rust 组件（Fontations 字体后端、rust_png）
+- **触发时机**: 崩溃发生在 **任何应用代码执行之前**
+- **影响范围**: Electron 38+ 版本（Chrome 140+）
+
+## 解决方案
+
+在 `src/main/main.ts` 文件开头添加：
+
+```typescript
+import { app } from 'electron';
+
+// macOS 26 Tahoe 兼容性：禁用 Fontations 字体后端
+// 参考: https://github.com/electron/electron/issues/49522
+if (process.platform === 'darwin') {
+  app.commandLine.appendSwitch('disable-features', 'FontationsFontBackend');
+}
+```
+
+## 版本历史
+
+| 版本 | 修复内容 |
+|------|----------|
+| 0.4.4 | 降级到 Electron 37 (临时方案) |
+| **0.4.5** | 升级到 Electron 39 + 添加 workaround |
+
+## 验证方法
+
+打包后的应用进程参数中应包含：
+
+```
+--disable-features=FontationsFontBackend
+```
+
+```bash
+ps aux | grep -i "Qiming Agent" | grep -v grep
+```
+
+## 参考资料
+
+- [Electron Issue #49522](https://github.com/electron/electron/issues/49522)
+
+---
+
+*最后更新: 2026-02-25*