从源码运行

本章面向开发者和自行构建的使用者。已有安装包时先看安装客户端，日常配置见模型供应商。

以下应用命令在源码仓库 deepseek-code 目录运行；文档站命令在 deepseek-code-docs 目录运行。

准备开发环境

Windows 开发建议准备：

• Node.js 22 LTS 与 npm。本次文档环境使用 Node.js 22.23.2。
• 当前稳定版 Rust MSVC 工具链，通过 rustup 安装。具体兼容性以当前锁文件的编译结果为准。
• Visual Studio Build Tools：C++ 桌面开发工具与 Windows SDK。
• Microsoft Edge WebView2 Runtime，供 Tauri 窗口使用。
• Git for Windows，包含 Git Bash；部分工具执行依赖它。

先检查工具能否使用：

node --version
npm.cmd --version
rustc --version
cargo --version
git --version

本文 Windows 命令使用 npm.cmd，避免 PowerShell 的脚本执行策略拦截 npm.ps1，无需修改系统执行策略。

Linux 构建

Linux（以 Debian 12 为例）需要 Node.js 22+、Rust 稳定版，以及 Tauri 2 的系统开发库：

sudo apt install pkg-config libwebkit2gtk-4.1-dev libgtk-3-dev libsoup-3.0-dev \
  libjavascriptcoregtk-4.1-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev \
  libasound2-dev libxdo-dev libdbus-1-dev

libdbus-1-dev 不能省：窗口运行时和安全存储都依赖 D-Bus，缺少时编译停在 libdbus-sys 的构建脚本（pkg-config 找不到 dbus-1）。

开发调试时用下面的 npm run tauri -- dev。要得到可以独立运行的 dcd，按构建 release 版本构建。

没有 root 权限时，可以用 apt-get download 下载上述 -dev 包及其依赖的 -dev 包，解压到用户目录并设置 PKG_CONFIG_PATH、PKG_CONFIG_SYSROOT_DIR 和 RUSTFLAGS="-L ..."，方法与 CLI 的无 root 构建相同；libsoup-3.0 还需要 libsysprof-4-dev 提供的 sysprof-capture-4。前提是对应的运行库已经安装。共享的 CARGO_HOME（如 /usr/local/cargo）对当前用户只读时，改用自己的目录，同样见 CLI 文档。

构建 release 版本

以下命令在 Windows 和 Linux 上相同（Windows PowerShell 中把 npm 写成 npm.cmd）。Cargo 输出在仓库根目录的 target/ 下。

方式一：构建脚本（推荐）

npm ci
npm run build:desktop     # 只构建 Desktop：dcd 和安装包
npm run build:all         # 同时构建 CLI（dcl）和 Desktop

产物复制到 artifacts/<版本>-release-<时间>/：desktop/dcd（Windows 为 dcd.exe）、desktop/bundle/ 下的安装包（Windows 为 .msi/.exe，Linux 为 .deb/.rpm/.AppImage），以及记录版本和平台的 build.json。其他参数：

参数	作用
--no-bundle	只构建可执行文件，不打安装包，例如 npm run build:desktop -- --no-bundle
--debug	构建 debug 版本
--check	只运行 cargo check，不构建

这个脚本内部调用 tauri build，会先执行 npm run build 构建前端。

方式二：Tauri CLI

npm ci
npm run tauri -- build

可执行文件在 target/release/dcd，安装包在 target/release/bundle/。scripts/release.ps1（Windows 发版：打 tag 并构建）也是用这种方式构建的。

方式三：直接用 Cargo

只需要可执行文件、不需要安装包时，可以直接用 Cargo 构建 release 版本：

npm ci
npm run build    # 先构建前端 dist/，它会被打包进 dcd
cargo build --locked --release -p deepseek-code-desktop --features tauri/custom-protocol

产物为 target/release/dcd（Windows 为 target\release\dcd.exe）。

不要漏掉 --features tauri/custom-protocol

Tauri 只有在启用 custom-protocol 特性时才使用打包进程序的前端；tauri build 会自动加上它，直接用 Cargo 时要自己加。只运行 cargo build --locked --release -p deepseek-code-desktop 也能编译成功，但得到的是开发模式的程序：窗口会去加载 http://127.0.0.1:5200 的 Vite 开发服务，没有运行 npm run dev 时窗口是空白的。

不加 --release 时得到 debug 版本 target/debug/dcd，同样需要 --features tauri/custom-protocol 才能脱离开发服务运行。

启动完整桌面开发环境

cd D:\code\deepseek-code
npm.cmd ci
npm.cmd run tauri dev

首次编译 Rust 可能较慢。Tauri 会根据 src-tauri/tauri.conf.json 自动启动 Vite，随后启动桌面窗口和 Rust Bridge。不要同时在另一终端重复运行前端开发服务，否则会占用 5200。

预期看到：

• Vite 页面地址 http://127.0.0.1:5200。
• Tauri 桌面窗口。
• Rust 终端出现 Bridge 启动记录，默认端口 30085。

Bridge 默认端口不可用时会尝试 30086 至 30089，以启动日志为准。

只启动前端

npm.cmd run dev

浏览器访问 http://127.0.0.1:5200。适合调样式和布局，但此命令不会启动 Rust。需要业务接口时，请保持桌面后端运行，并按浏览器调试指南处理鉴权。

可选：启动 Node 网关

仅当要使用对应网关功能时，在另一终端运行：

cd D:\code\deepseek-code\api-proxy
npm.cmd install
npm.cmd run dev

服务端口为 30090。代码读取 JWT_SECRET、KIE_API_URL、KIE_API_KEY 以及 GitHub OAuth 相关环境变量；按实际使用的服务配置。JWT_SECRET 未配置时会临时生成，重启可能使原有令牌失效。better-sqlite3 安装失败时检查 Node 版本及本机构建工具。

这只是本地开发入口，不代表网关已完成生产部署配置。

启动文档站

cd D:\code\deepseek-code-docs
npm.cmd ci
npm.cmd run dev

访问 http://127.0.0.1:5174，修改 Markdown 后页面自动更新。这个步骤不启动应用或模型服务。

停止服务

在各自的启动终端按 Ctrl+C。停止后再启动，能避免遗留进程占用端口；不要直接结束不明来源的进程。