需依次执行递归克隆仓库、初始化子模块、安装rust/python/cmake依赖、运行cargo build --release构建，并将生成的qwaked与qwakectl复制至path路径完成本地安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望获取QoderWake最新源码并完成本地手动构建，但尚未拉取官方仓库或遭遇编译依赖缺失、子模块初始化失败等问题，则可能是由于克隆方式不兼容、Git子模块未同步或构建环境未满足前置要求。以下是完成QoderWake源码编译的完整操作路径：
一、克隆QoderWake主仓库与子模块初始化
QoderWake源码采用主仓库+多级子模块结构，需确保完整拉取所有嵌套依赖，否则后续编译将因缺失头文件或工具链而中断。必须使用支持递归子模块的克隆命令，并验证各层级完整性。
1、在终端中执行完整克隆命令：git clone --recurse-submodules https://gitcode.com/gh_mirrors/qw/QoderWake.git
2、进入项目根目录：cd QoderWake
3、检查子模块状态，确认全部已检出：git submodule status
4、若存在未初始化子模块，手动更新：git submodule update --init --recursive
二、配置构建依赖与开发环境
QoderWake构建过程依赖Rust工具链、Python 3.9+运行时及CMake 3.16以上版本，缺少任一组件均会导致configure或build阶段报错。需逐项验证并安装缺失项。
1、安装Rust工具链（含cargo）：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2、启用Rust环境变量：source $HOME/.cargo/env
3、验证Rust版本：rustc --version && cargo --version
4、安装Python 3.9或更高版本：sudo apt install python3.9 python3.9-venv python3.9-dev（Ubuntu/Debian）
5、安装CMake最新稳定版：sudo apt install cmake，并确认版本≥3.16：cmake --version
三、执行源码构建与本地安装
构建脚本通过Cargo调用自定义构建逻辑，生成可执行二进制文件qwaked与CLI工具qwakectl。构建产物默认输出至target/release目录，需手动复制至系统PATH路径方可全局调用。
1、执行完整构建命令：cargo build --release --features full-build
2、等待编译完成，检查输出路径是否存在可执行文件：ls target/release/qwaked qwakectl
3、将二进制文件复制到用户本地bin目录：mkdir -p $HOME/bin && cp target/release/qwaked target/release/qwakectl $HOME/bin/
4、将$HOME/bin加入PATH环境变量：echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
5、验证安装结果：qwaked --version && qwakectl --version
四、处理常见子模块同步失败问题
当使用镜像站克隆时，.gitmodules中预设的HTTPS地址可能因认证权限不匹配导致子模块拉取失败。此时需强制替换为免密SSH协议地址，并配置对应Git主机密钥信任机制。
1、编辑子模块配置文件：vim .gitmodules
2、将所有https://gitlab.com/前缀批量替换为git@gitlab.com:：:%s/https:\/\/gitlab\.com\//git@gitlab.com:/g
3、将所有https://github.com/前缀替换为git@github.com:：:%s/https:\/\/github\.com\//git@github.com:/g
4、保存退出后重新初始化子模块：git submodule sync && git submodule update --init --recursive
5、若仍提示权限拒绝，需将对应平台（GitHub/GitLab）的SSH公钥添加至账户设置中。
