From 09074a71fea06656579ff463d9a6d2278fd56571 Mon Sep 17 00:00:00 2001
From: impressionyang <impressionyang@outlook.com>
Date: Tue, 12 May 2026 16:00:52 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E7=AC=AC=E4=B8=89?=
 =?UTF-8?q?=E6=96=B9=E4=BE=9D=E8=B5=96=E9=83=A8=E7=BD=B2=E6=8C=87=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

详细说明各依赖库的下载来源、编译方法和验证步骤，
包含快速部署脚本。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 third_party/README.md | 165 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 165 insertions(+)
 create mode 100644 third_party/README.md

diff --git a/third_party/README.md b/third_party/README.md
new file mode 100644
index 0000000..de2eef7
--- /dev/null
+++ b/third_party/README.md
@@ -0,0 +1,165 @@
+# 第三方依赖部署指南
+
+本目录存放项目依赖库。部分库已由版本控制管理（header-only 库），部分需手动下载或编译。
+
+---
+
+## 目录结构
+
+```
+third_party/
+├── onnxruntime/      # ONNX Runtime (需手动下载)
+├── portaudio/        # PortAudio (需手动编译)
+├── dr_libs/          # 音频解码 (已纳入版本控制)
+│   ├── dr_wav.h
+│   ├── dr_mp3.h
+│   └── dr_flac.h
+└── nlohmann_json/    # JSON 解析 (已纳入版本控制)
+    └── json.hpp
+```
+
+---
+
+## 1. ONNX Runtime
+
+### 下载
+
+前往 GitHub Releases 页面下载 Linux x64 CPU 版本：
+https://github.com/microsoft/onnxruntime/releases
+
+以 v1.18.1 为例：
+```bash
+# 下载预编译的 Linux x64 CPU 包
+wget https://github.com/microsoft/onnxruntime/releases/download/v1.18.1/onnxruntime-linux-x64-1.18.1.tgz
+
+# 解压并重命名
+tar -xzf onnxruntime-linux-x64-1.18.1.tgz
+mv onnxruntime-linux-x64-1.18.1 third_party/onnxruntime
+```
+
+### 验证
+
+确认以下文件存在：
+```
+third_party/onnxruntime/
+├── include/
+│   ├── onnxruntime_c_api.h
+│   └── onnxruntime_cxx_api.h
+└── lib/
+    └── libonnxruntime.so
+```
+
+### 其他平台
+
+| 平台 | 下载地址 |
+|------|----------|
+| macOS (ARM64) | `onnxruntime-osx-arm64-<version>.tgz` |
+| macOS (x64) | `onnxruntime-osx-x64-<version>.tgz` |
+| Windows (x64) | `onnxruntime-win-x64-<version>.zip` |
+
+---
+
+## 2. PortAudio
+
+### 编译安装
+
+```bash
+cd third_party
+
+# 克隆源码
+git clone https://github.com/PortAudio/portaudio.git
+cd portaudio
+
+# 创建构建目录
+mkdir -p build && cd build
+
+# CMake 配置并编译
+cmake .. -DCMAKE_INSTALL_PREFIX=.. -DCMAKE_BUILD_TYPE=Release
+cmake --build . -j$(nproc)
+cmake --install .
+```
+
+### 验证
+
+确认以下文件存在：
+```
+third_party/portaudio/
+├── include/
+│   └── portaudio.h
+└── lib/
+    ├── libportaudio.so
+    └── libportaudio.a
+```
+
+### 替代方案（系统包）
+
+如果使用 Linux 包管理器，可直接安装：
+```bash
+# Debian/Ubuntu
+sudo apt install libportaudio2 libportaudiocpp0 portaudio19-dev
+
+# Fedora/RHEL
+sudo dnf install portaudio-devel
+```
+
+安装后 CMake 会自动从系统路径找到库文件。
+
+---
+
+## 3. dr_libs (已完成)
+
+单头文件音频解码库，已纳入版本控制，无需手动操作。
+
+源码地址：https://github.com/mackron/dr_libs
+
+---
+
+## 4. nlohmann/json (已完成)
+
+单头文件 JSON 库，已纳入版本控制，无需手动操作。
+
+源码地址：https://github.com/nlohmann/json
+
+---
+
+## 快速部署脚本 (Linux)
+
+```bash
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR"
+
+# 1. ONNX Runtime v1.18.1 Linux x64 CPU
+echo "=== 下载 ONNX Runtime ==="
+if [ ! -d "onnxruntime" ]; then
+    ONNX_VERSION="1.18.1"
+    wget -q "https://github.com/microsoft/onnxruntime/releases/download/v${ONNX_VERSION}/onnxruntime-linux-x64-${ONNX_VERSION}.tgz"
+    tar -xzf "onnxruntime-linux-x64-${ONNX_VERSION}.tgz"
+    mv "onnxruntime-linux-x64-${ONNX_VERSION}" onnxruntime
+    rm "onnxruntime-linux-x64-${ONNX_VERSION}.tgz"
+    echo "ONNX Runtime 已部署"
+else
+    echo "ONNX Runtime 已存在，跳过"
+fi
+
+# 2. PortAudio
+echo "=== 编译 PortAudio ==="
+if [ ! -d "portaudio/lib" ]; then
+    if [ ! -d "portaudio" ]; then
+        git clone https://github.com/PortAudio/portaudio.git
+    fi
+    cd portaudio
+    mkdir -p build && cd build
+    cmake .. -DCMAKE_INSTALL_PREFIX=.. -DCMAKE_BUILD_TYPE=Release
+    cmake --build . -j$(nproc)
+    cmake --install .
+    cd ../..
+    echo "PortAudio 已部署"
+else
+    echo "PortAudio 已存在，跳过"
+fi
+
+echo "=== 依赖部署完成 ==="
+```