Vector DB MCP

Plojure

Plojure 是用于进行 Lisp、Python 和 x86_64 汇编实验的 playground。当前的 hybrid 分支还包含一条用于移植 FASM 示例的 macOS 路径。

macOS 上的目标工作流刻意保持简单：

fasm fasm/basic/fib.asm
./fasm/basic/fib

关键路径中没有 Docker 命令，也不会出现 exec format error，更不会让 Linux ELF 二进制伪装成 macOS 程序。

macOS FASM 设置

从 kroq86/fasm-mac 安装配套的 fasm shim：

git clone https://github.com/kroq86/fasm-mac
cd fasm-mac
./install.sh
export PATH="$HOME/.local/bin:$PATH"

安装的命令名为 fasm。

在 Apple Silicon 上，它会生成 x86_64 Mach-O 二进制，因此需要 Rosetta：

arch -x86_64 /usr/bin/true

如果失败：

softwareupdate --install-rosetta

独立示例

这些示例现在使用 fasm/core/platform.inc，而不再使用硬编码的 Linux 系统调用编号：

fasm fasm/basic/fib.asm
./fasm/basic/fib

fasm fasm/basic/arg.asm
./fasm/basic/arg fasm/basic/lol.txt

cd fasm/basic
fasm mycat.asm
./mycat

cd ../advanced/binary_search
fasm bin_s.asm
./bin_s

预期行为：

• fib.asm 输出斐波那契数值。
• arg.asm 输出作为 argv[1] 传入的文件。
• mycat.asm 输出 fasm/basic/lol.txt。
• bin_s.asm 输出找到的索引。

共享库示例

现在，简单的 C/Python 原生库示例可以在 macOS 上构建 .dylib 文件：

cd fasm/advanced/add
./run.sh

cd ../binary_search/wrapper
./run.sh

cd ../../oop_game
./build.sh

构建路径为：

fasm --emit=macho-obj add.asm add.o
clang -arch x86_64 -dynamiclib wrapper.c add.o -o mylib.dylib

在 Apple Silicon 上，Python ctypes 需要使用 x86_64/Rosetta Python 才能加载这些库。默认的 Homebrew Python 通常是 arm64，无法加载 x86_64 .dylib。

Vector DB

projects/vector-db 现在会在 Darwin 上查找 .dylib，在 Linux 上查找 .so。macOS 构建路径为：

cd projects/vector-db
fasm --emit=macho-obj assembly/dot_product.asm dot_product.o
clang -arch x86_64 -dynamiclib dot_product.o assembly/wrapper.c -o dot_product.dylib

如果无法加载原生库，Python 代码会在可用时沿用现有的回退行为。

尚未完成的事项

• fasm classic 本身仍没有上游风格的 format Mach-O 格式化器。
• 此移植不包含原生 arm64 汇编输出。
• Mach-O 对象转换器目前不支持 ELF 重定位。
• 协程有意留待后续处理，因为它们会手动切换栈，并跨越 Python 回调边界。
• 在 Apple Silicon 上，如果 Python 示例要加载 x86_64 .dylib 文件，就需要使用 x86_64 Python 运行时。

原始 Lisp 解释器

仓库还包含一个小型 Lisp 解释器：

python projects/lisp-interpreter/main.py projects/lisp-interpreter/program.lisp

它支持递归函数、lambda 表达式、算术运算、条件语句和函数调用。