[1244] 修复goldfish的动态链接问题 (#4438)

Author: da-liii

TeXmacs/plugins/goldfish/goldfish/goldfish/repl.scm

@@ -7,7 +7,7 @@
     (liii base)
     (scheme char)
   ) ;import
-  (export goldfish-welcome goldfish-repl is-sicp-mode?)
+  (export goldfish-welcome goldfish-repl)
   (begin
 
     (define (goldfish-welcome)

devel/1244.md

@@ -0,0 +1,65 @@
+# [1244] 修复 macOS 上 goldfish 动态链接 Homebrew OpenSSL
+
+## 相关文档
+
+- [dddd.md](dddd.md)
+- [2092.md](2092.md) - goldfish 内置 libcurl/openssl3 的前置任务
+
+## 任务相关的代码文件
+
+- `xmake/requires.lua` - 本任务唯一改动文件
+
+## 背景与根因
+
+### 现象
+
+macOS 上构建出的 goldfish 二进制动态链接了 Homebrew 的 OpenSSL：
+
+```
+$ otool -L TeXmacs/plugins/goldfish/bin/goldfish
+    /opt/homebrew/opt/openssl@3/lib/libssl.3.dylib
+    /opt/homebrew/opt/openssl@3/lib/libcrypto.3.dylib
+    ...
+```
+
+未安装 Homebrew openssl@3 的用户机器上，dyld 找不到这两个 dylib，
+goldfish 直接启动失败，Scheme 会话/LLM 等依赖 goldfish 的功能全部不可用。
+
+### 根因
+
+2092 之后 macOS 的 libcurl TLS 后端为 `openssl3`，但 `add_requires` 未限制
+其来源，xmake 默认优先解析系统包；装了 Homebrew openssl@3 的机器上
+pkg-config 能找到它，于是 `openssl3` 被解析为**系统动态库**而非 xmake
+源码静态构建，最终链进 goldfish 的 install name 指向
+`/opt/homebrew/opt/openssl@3/lib/`。
+
+Linux 不受此问题影响（发行版 OpenSSL 3 属系统标配），Windows 走
+SChannel 不依赖 OpenSSL，故修复限定 macOS。
+
+## 修改
+
+`xmake/requires.lua`：macOS 下用 `add_requireconfs` 强制 libcurl 依赖链上
+的 `openssl3` 以源码静态构建（`system = false`），不再解析 Homebrew
+系统包：
+
+```lua
+if is_plat("macosx") then
+    add_requireconfs("libcurl.openssl3", {system = false, override = true})
+    add_requireconfs("cpr.libcurl.openssl3", {system = false, override = true})
+end
+```
+
+## 如何测试
+
+```bash
+# 重新配置并重建 goldfish（openssl3/libcurl 会以源码静态重建）
+xmake f -c --yes && xmake b -y goldfish-bin
+
+# 检查链接库：不得出现 /opt/homebrew 下的 libssl/libcrypto
+otool -L TeXmacs/plugins/goldfish/bin/goldfish
+# 预期仅剩 /usr/lib/libz.1.dylib、/System/Library/Frameworks/*、
+# /usr/lib/libc++.1.dylib、/usr/lib/libSystem.B.dylib 等系统库
+
+# 功能验证：HTTPS 请求返回 200
+TeXmacs/plugins/goldfish/bin/goldfish -e '(import (liii http)) (let ((r (http-get "https://liiistem.cn/"))) (display (number->string (r (quote status-code)))))'
+```

xmake/requires.lua

@@ -30,6 +30,13 @@ end
 if not is_plat("wasm") then
     add_requires("libcurl", {system=false})
 end
+-- macOS：openssl3 默认会被 xmake 解析为 Homebrew 系统包（pkg-config 命中
+-- brew 的 openssl@3），goldfish 因此动态链接 /opt/homebrew 下的
+-- libssl/libcrypto.dylib，未装 brew 的用户机器无法启动。强制源码静态构建。
+if is_plat("macosx") then
+    add_requireconfs("libcurl.openssl3", {system = false, override = true})
+    add_requireconfs("cpr.libcurl.openssl3", {system = false, override = true})
+end
 if not is_plat("wasm") then
     -- cpr 默认 ssl=false，会导致 goldfish 的 libcurl 完全无法发起 HTTPS 请求
     -- （LLM 等 HTTPS 接口全部报 HTTP状态码为0），必须显式开启 ssl