安装与升级 - DuoDuo Code 文档

桌面应用

桌面端基于 Tauri 构建，产物为原生安装包。

平台	产物格式
Windows	`nsis`（安装向导 `.exe`）
macOS	`dmg`、`app`
Linux	`deb`、`rpm`

桌面端内置自动更新，更新源为 https://www.dd322.cn/update/code/{{target}}-{{arch}}/latest.json，启动时会检查新版本。

桌面端安装包与 CLI 的二进制下载正在接入中，请前往下载页获取最新状态。

命令行（CLI）

支持的平台与架构

安装脚本支持的组合如下，其他组合会直接报错退出：

操作系统	架构
Linux	`x64`
macOS	`x64`、`arm64`
Windows	`x64`

安装

macOS / Linux（curl 通道）

curl -fsSL https://www.dd322.cn/update/code/cli/cli | bash

默认安装到 $HOME/.duoduo/bin，安装脚本会自动创建该目录。

脚本支持的环境变量：

VERSION=0.1.0 curl -fsSL https://www.dd322.cn/update/code/cli/cli | bash   # 指定版本
DUODUO_BIN_DIR=/usr/local/bin curl -fsSL https://www.dd322.cn/update/code/cli/cli | bash  # 自定义安装目录

包管理器通道

目前官方仅维护 Homebrew Tap 与上方 自有服务器二进制（curl / cli.ps1） 两种安装通道，其余包管理器暂未发布，请勿使用。

brew install duoduo-ai/tap/duoduocode   # macOS / Linux（推荐，始终最新）

⚠️ 注意：duoduocode 不是 npm / pnpm / yarn / bun 上的包，无法用 npm install -g duoduocode 等命令安装；也未发布到 Scoop / Chocolatey（scoop install duoduocode、choco install duoduocode 均不存在）。Windows 请使用 PowerShell 安装脚本（cli.ps1）；无 Homebrew 的 Linux 可使用上方的 curl 安装脚本。

升级

duoduocode upgrade              # 升级到最新版
duoduocode upgrade 0.1.0        # 升级到指定版本

指定升级通道（--method / -m）：

duoduocode upgrade --method brew    # Homebrew Tap
duoduocode upgrade --method curl    # 自有服务器二进制

不指定时，DuoDuoCode 会检测你当初的安装方式并自动选择通道。版本信息分别查询 Homebrew Tap 与自有服务器。

卸载

duoduocode uninstall

环境要求

桌面端：Windows 需 WebView2 运行时（安装包已内置 WebView2Loader.dll）。
CLI：无额外运行时依赖，为独立二进制。
若需使用本地模型，请自行安装并启动对应推理框架（见模型与 Provider）。

目录结构

DuoDuoCode 按 XDG 规范存放数据：

用途	Linux	macOS	Windows
配置	`$XDG_CONFIG_HOME/duoduocode/`（回退 `~/.config/duoduocode/`）	`~/Library/Application Support/duoduocode/`	`%APPDATA%\duoduocode\`
数据	`~/.local/share/duoduocode/`	`~/Library/Application Support/duoduocode/`	`%LOCALAPPDATA%\duoduocode\`

数据目录下包含全局数据库 duoduo.db、认证凭据 auth.json、各项目的会话库与快照仓库。

开发模式（duoduocode 以 dev 通道运行）使用 duoduocode-dev 目录，与正式版互不干扰。