mirror of
https://github.com/infiniflow/ragflow.git
synced 2026-05-23 17:38:04 +08:00
## Problem
The Go server build pipeline (`build.sh` + CMake + CGO bindings) was
tested on Ubuntu only. On macOS arm64 with Homebrew it fails in five
orthogonal places. None of these require platform-specific code paths —
the same source builds on both Linux and Darwin after these fixes.
## Reproduction (before)
```
$ uname -a
Darwin … 25.4.0 arm64
$ brew install cmake pcre2 simde
$ bash build.sh
…
error: 'simde/x86/sse4.1.h' file not found
error: implicit instantiation of undefined template 'std::basic_istringstream<char>'
error: no matching function for call to 'Join'
…
clang: error: no such file or directory: '/usr/local/lib/libpcre2-8.a'
```
## Fix (5 small, orthogonal changes)
### 1. `internal/cpp/CMakeLists.txt` — find Homebrew + libpcre2-8
portably
- Detect Apple platforms via `if(APPLE)`, call `brew --prefix` once, add
`${HOMEBREW_PREFIX}/include` and `${HOMEBREW_PREFIX}/lib`. No effect on
Linux.
- Replace the literal `libpcre2-8.a` link token (which only the Linux
linker finds in `/usr/local/lib` by default) with
`find_library(PCRE2_LIB NAMES pcre2-8 REQUIRED)`. Works on
`/usr/lib/x86_64-linux-gnu` (Debian/Ubuntu), `/usr/local/lib` (Intel Mac
& legacy Linux), `/opt/homebrew/lib` (Apple Silicon).
### 2. `internal/cpp/wordnet_lemmatizer.cpp` +
`internal/cpp/rag_analyzer.cpp` — explicit `#include <sstream>`
libstdc++ (Linux) pulls `<sstream>` in transitively via `<fstream>`;
libc++ (Apple Clang) doesn't, so the existing `std::istringstream` /
`std::ostringstream` uses fail to compile on macOS. One-line include in
each file.
### 3. `internal/cpp/rag_analyzer.cpp` — `Join` template overload fix
`Join(tokens, start, tokens.size(), delim)` at line 146 passes `size_t`
to an `int` parameter. C++23 strict mode in Apple Clang refuses the
implicit narrowing and reports the 4-arg overload as a substitution
failure, leaving the call ambiguous between the 3-arg and 4-arg
templates. Fix: explicit `static_cast<int>(tokens.size())`. Behaviour
identical on libstdc++ — the narrowing was always intentional.
### 4. `internal/binding/rag_analyzer.go` — split darwin CGO LDFLAGS
The existing `#cgo darwin LDFLAGS: ... /usr/local/lib/libpcre2-8.a` only
matches Intel Macs. Apple Silicon Homebrew installs to `/opt/homebrew`.
Split into `darwin,arm64` and `darwin,amd64` build constraints with the
right absolute path on each.
### 5. `build.sh` — accept Homebrew path in the pcre2 sanity check
The sanity check looked at two Linux paths only and then fell through to
`sudo apt -y install libpcre2-dev` on failure. Added
`/opt/homebrew/lib/libpcre2-8.a`, and on Darwin failure now exits
cleanly with the right `brew install pcre2` hint instead of trying
`apt`.
## Verified
- `bash build.sh` now completes on macOS arm64 (Apple Silicon, brew 4.x,
cmake 4.x, Apple Clang 17, Go 1.25, pcre2 10.x, simde 0.8.x).
- Produced binaries: `bin/server_main`, `bin/admin_server`,
`bin/ragflow_cli`.
- `bin/server_main` boots, connects MySQL, runs migrations, loads the 64
model provider configs cleanly.
- Still builds on Linux — the CMake additions are inside an `if(APPLE)`
guard, the `find_library` call matches Linux paths too, the build.sh
check still tries `apt` when not on Darwin.
## Out of scope
The Go server itself currently fails at runtime when not pointing at
Elasticsearch (`Failed to initialize doc engine: failed to ping
Elasticsearch`), but that's the placeholder Infinity engine documented
in `internal/engine/README.md` — unrelated to this build patchset.
---
Happy to split this into smaller PRs if you'd prefer (one per file). The
five changes are independent.
173 lines
4.6 KiB
CMake
173 lines
4.6 KiB
CMake
cmake_minimum_required(VERSION 4.0)
|
|
project(rag_tokenizer)
|
|
|
|
set(CMAKE_CXX_STANDARD 23)
|
|
|
|
# macOS dependency discovery — Homebrew installs headers and libs under a
|
|
# prefix that is NOT on the compiler's default search path (Apple Silicon:
|
|
# /opt/homebrew, Intel: /usr/local). Linux is left completely untouched:
|
|
# the infinity_builder image already ships pcre2 + simde where the
|
|
# toolchain finds them, so adding paths there risks shadowing them.
|
|
if(APPLE)
|
|
execute_process(
|
|
COMMAND brew --prefix
|
|
OUTPUT_VARIABLE HOMEBREW_PREFIX
|
|
OUTPUT_STRIP_TRAILING_WHITESPACE
|
|
RESULT_VARIABLE BREW_RC
|
|
)
|
|
if(BREW_RC EQUAL 0 AND HOMEBREW_PREFIX)
|
|
message(STATUS "macOS detected; Homebrew prefix: ${HOMEBREW_PREFIX}")
|
|
include_directories(SYSTEM "${HOMEBREW_PREFIX}/include")
|
|
link_directories("${HOMEBREW_PREFIX}/lib")
|
|
endif()
|
|
endif()
|
|
|
|
# Resolve libpcre2-8.
|
|
# - Linux: keep upstream's bare `libpcre2-8.a` token verbatim. The linker
|
|
# resolves it from its own default search path, which the
|
|
# infinity_builder image populates. find_library() does NOT see that
|
|
# path (pcre2 is built from source there), so calling it here would
|
|
# break the CI build that worked before.
|
|
# - macOS: the bare token fails (libpcre2-8.a is under the Homebrew
|
|
# prefix, off the default path), so resolve the full path explicitly.
|
|
if(APPLE)
|
|
find_library(PCRE2_LIB NAMES pcre2-8 REQUIRED)
|
|
else()
|
|
set(PCRE2_LIB libpcre2-8.a)
|
|
endif()
|
|
message(STATUS "PCRE2 library: ${PCRE2_LIB}")
|
|
|
|
# Option to enable AddressSanitizer
|
|
option(ENABLE_ASAN "Enable AddressSanitizer" OFF)
|
|
|
|
if(ENABLE_ASAN)
|
|
message(STATUS "AddressSanitizer enabled")
|
|
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fsanitize=address -fno-omit-frame-pointer -g")
|
|
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fsanitize=address -fno-omit-frame-pointer -g")
|
|
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fsanitize=address")
|
|
set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -fsanitize=address")
|
|
endif()
|
|
|
|
file(GLOB_RECURSE
|
|
stemmer_src
|
|
CONFIGURE_DEPENDS
|
|
stemmer/*.cpp
|
|
stemmer/*.cc
|
|
stemmer/*.c
|
|
stemmer/*.h
|
|
)
|
|
|
|
file(GLOB_RECURSE
|
|
opencc_src
|
|
CONFIGURE_DEPENDS
|
|
opencc/*.cpp
|
|
opencc/*.cc
|
|
opencc/*.c
|
|
opencc/*.h
|
|
)
|
|
|
|
file(GLOB_RECURSE
|
|
util_src
|
|
CONFIGURE_DEPENDS
|
|
util/*.cpp
|
|
util/*.cc
|
|
util/*.c
|
|
util/*.h
|
|
)
|
|
|
|
file(GLOB_RECURSE
|
|
re2_src
|
|
CONFIGURE_DEPENDS
|
|
re2/*.cpp
|
|
re2/*.cc
|
|
re2/*.c
|
|
re2/*.h
|
|
)
|
|
|
|
file(GLOB_RECURSE
|
|
darts_src
|
|
CONFIGURE_DEPENDS
|
|
darts/*.h
|
|
)
|
|
|
|
file(GLOB
|
|
main_src
|
|
CONFIGURE_DEPENDS
|
|
*.cpp
|
|
*.cc
|
|
*.c
|
|
*.h
|
|
)
|
|
|
|
# Filter out C API files from main_src
|
|
list(FILTER main_src EXCLUDE REGEX "rag_analyzer_c_api")
|
|
|
|
add_executable(rag_tokenizer
|
|
main.cpp
|
|
rag_analyzer.cpp
|
|
rag_analyzer.h
|
|
dart_trie.h
|
|
darts_trie.cpp
|
|
wordnet_lemmatizer.cpp
|
|
wordnet_lemmatizer.h
|
|
string_utils.h
|
|
term.h
|
|
term.cpp
|
|
tokenizer.cpp
|
|
tokenizer.h
|
|
analyzer.h
|
|
${stemmer_src}
|
|
${opencc_src}
|
|
${util_src}
|
|
${darts_src}
|
|
${re2_src})
|
|
|
|
target_link_libraries(rag_tokenizer stdc++ m ${PCRE2_LIB})
|
|
target_include_directories(rag_tokenizer PUBLIC "${CMAKE_SOURCE_DIR}")
|
|
set_target_properties(rag_tokenizer PROPERTIES
|
|
CXX_STANDARD 20
|
|
CXX_STANDARD_REQUIRED ON
|
|
)
|
|
|
|
# Build C API static library for CGO
|
|
add_library(rag_tokenizer_c_api STATIC
|
|
rag_analyzer_c_api.cpp
|
|
rag_analyzer_c_api.h
|
|
rag_analyzer.cpp
|
|
rag_analyzer.h
|
|
dart_trie.h
|
|
darts_trie.cpp
|
|
wordnet_lemmatizer.cpp
|
|
wordnet_lemmatizer.h
|
|
string_utils.h
|
|
term.h
|
|
term.cpp
|
|
tokenizer.cpp
|
|
tokenizer.h
|
|
analyzer.h
|
|
${stemmer_src}
|
|
${opencc_src}
|
|
${util_src}
|
|
${darts_src}
|
|
${re2_src}
|
|
)
|
|
|
|
target_link_libraries(rag_tokenizer_c_api stdc++ libm.a ${PCRE2_LIB})
|
|
target_include_directories(rag_tokenizer_c_api PUBLIC "${CMAKE_SOURCE_DIR}")
|
|
set_target_properties(rag_tokenizer_c_api PROPERTIES
|
|
CXX_STANDARD 20
|
|
CXX_STANDARD_REQUIRED ON
|
|
)
|
|
|
|
# Test executable for C API
|
|
add_executable(rag_analyzer_c_test
|
|
rag_analyzer_c_test.cpp
|
|
)
|
|
|
|
target_link_libraries(rag_analyzer_c_test rag_tokenizer_c_api stdc++ libm.a ${PCRE2_LIB})
|
|
target_include_directories(rag_analyzer_c_test PUBLIC "${CMAKE_SOURCE_DIR}")
|
|
set_target_properties(rag_analyzer_c_test PROPERTIES
|
|
CXX_STANDARD 20
|
|
CXX_STANDARD_REQUIRED ON
|
|
)
|