[BUG]: v0.1.5 Fails to Launch on Apple Silicon (arm64) due to numpy ImportError #267
Description
🐛 Bug description [Please make everyone to understand it]
The application fails to launch after a clean installation of v0.1.5 on an Apple Silicon (M1 Pro) Mac. The main application window opens but remains blank or stuck on a loading screen, and the application is unresponsive.
The backend debug log clearly indicates that the backend process crashes immediately upon startup. The crash is caused by a fatal ImportError related to the numpy library. The specific error message is Error importing numpy: you should not try to import numpy from its source directory....
This strongly suggests a critical issue with how the Python dependencies, particularly numpy, were packaged within the arm64 version of the application for release. The issue appears to be internal to the application's bundled environment.
🧑💻 Step to reproduce
在一台搭载 Apple Silicon 芯片 (如 M1, M2, M3) 的 Mac 上操作。
我之前的版本是 0.1.3 (可正常运行)。
下载官方发布的 MineContext-0.1.5.dmg 文件。
双击打开 .dmg 文件，将 MineContext.app 拖拽到“应用程序”文件夹中，选择“替换”(Replace) 以覆盖旧版本。
从“应用程序”文件夹中启动 MineContext。
应用随即卡在空白加载界面，无法使用。
查看位于 ~/Library/Logs/MineContext/backend-debug.log 的日志文件，可以看到与 numpy 相关的 ImportError。
👾 Expected result
应用应该能成功启动，主界面能够正常显示并可以进行操作。
🚑 Any additional information
=== VIKINGDB Backend Debug Log ===
Started: 2025-11-17T05:22:36.312Z
Platform: darwin
Architecture: arm64
Node version: v22.18.0
Electron version: 37.3.0
Process execPath: /Applications/MineContext.app/Contents/MacOS/MineContext
Process cwd: /
__dirname: /Applications/MineContext.app/Contents/Resources/app.asar/out/main
Resources path: /Applications/MineContext.app/Contents/Resources
Is packaged: true
Actually dev: false
[2025-11-17T05:22:36.313Z] Initial backend startup...
[2025-11-17T05:22:36.328Z] Found available port: 1733
[2025-11-17T05:22:36.329Z] Starting backend with command: /Applications/MineContext.app/Contents/Resources/backend/main start --port 1733 --config config/config.yaml, Working dir: /Applications/MineContext.app/Contents/Resources/backend, Environment: CONTEXT_PATH=/Users/kunqian/Library/Application Support/MineContext
[2025-11-17T05:22:36.330Z] Backend server started
[2025-11-17T05:22:36.682Z] Health check attempt 1/20 - checking http://1227.0.0.1:1733/api/health
[2025-11-17T05:22:36.689Z] Health check request error: connect ECONNREFUSED 127.0.0.1:1733
[2025-11-17T05:22:36.689Z] ❌ Health check attempt 1 failed: connect ECONNREFUSED 127.0.0.1:1733 (code: ECONNREFUSED)
[2025-11-17T05:22:36.689Z] Retrying in 20000ms...
[2025-11-17T05:22:57.539Z] STDERR: Traceback (most recent call last):
File "cli.py", line 23, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/server/api.py", line 17, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/server/routes/content_generation.py", line 16, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/server/opencontext.py", line 23, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/server/component_initializer.py", line 26, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/context_processing/init.py", line 10, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/context_processing/merger/init.py", line 12, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/context_processing/merger/context_merger.py", line 23, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/context_processing/processor/init.py", line 14, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/context_processing/processor/document_processor.py", line 20, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/context_processing/chunker/init.py", line 9, in
File "pyimod02_importers.py", line 457, in exec_module
File "opencontext/context_processing/chunker/chunkers.py", line 20, in
File "pyimod02_importers.py", line 457, in exec_module
File "pandas/init.py", line 19, in
ImportError: Unable to import required dependencies:
numpy: Error importing numpy: you should not try to import numpy from
its source directory; please exit the numpy source tree, and relaunch
your python interpreter from there.
[PYI-45419:ERROR] Failed to execute script 'cli' due to unhandled exception!
[2025-11-17T05:22:57.770Z] Backend process exited with code 1
[2025-11-17T05:22:57.770Z] Backend status changed from starting to stopped
[2025-11-17T05:22:57.770Z] Backend status changed from stopped to error
[2025-11-17T05:22:57.770Z] Failed to start backend: Backend process exited with code 1
[2025-11-17T05:22:57.770Z] ❌ Backend initialization failed: Backend process exited with code 1
🛠️ MineContext Version
0.1.5
💻 Platform Details
操作系统 (Operating System): macOS Monterey
版本 (Version): 12.6
硬件详情 (Additional Details): MacBook Pro with Apple M1 Pro chip (arm64 architecture)