CLI 命令参考 - DuoDuo Code 文档

全局选项

duoduocode --version          # 版本
duoduocode --help             # 帮助
duoduocode --print-logs       # 输出日志
duoduocode --log-level DEBUG  # 指定日志级别
duoduocode --pure             # 纯净模式（不加载配置与插件）
duoduocode completion         # 生成 shell 补全脚本

一级子命令

命令	说明
`duoduocode [项目路径]`	默认命令，启动交互式界面（TUI）
`duoduocode run <消息>`	非交互执行，直接把结果输出到终端
`duoduocode serve`	启动服务端（HTTP API）
`duoduocode web`	启动 Web 界面
`duoduocode acp`	以 ACP 协议运行，供外部客户端接入
`duoduocode attach <url>`	连接到已运行的服务端
`duoduocode models [provider]`	列出可用模型
`duoduocode providers`	管理模型凭据（别名 `auth`）
`duoduocode agent`	管理 Agent
`duoduocode session`	管理会话
`duoduocode gear`	搜索与安装技能 / MCP
`duoduocode mcp`	管理 MCP 服务器
`duoduocode export [会话ID]`	导出会话
`duoduocode import <文件>`	导入会话
`duoduocode generate`	生成内容
`duoduocode stats`	查看用量统计
`duoduocode github`	GitHub 相关集成
`duoduocode pr <编号>`	处理 Pull Request
`duoduocode db`	数据库维护
`duoduocode debug`	诊断子命令集合
`duoduocode upgrade [版本]`	升级
`duoduocode uninstall`	卸载

默认命令（TUI）

不带子命令即启动交互式界面：

duoduocode                        # 在当前目录启动
duoduocode ~/code/my-project      # 直接打开指定项目
duoduocode --model ollama/qwen2.5-coder:7b   # 指定模型
duoduocode --continue             # 继续上一个会话
duoduocode --session <ID>         # 打开指定会话
duoduocode --fork                 # 从现有会话分叉
duoduocode --agent plan           # 指定 Agent 启动

详见 TUI 与快捷键。

非交互执行

duoduocode run "为 user service 补充单元测试"

适合放进脚本或 CI。输出直接打印到标准输出。

常用二级子命令

providers（凭据管理）

duoduocode providers list      # 列出 Provider 与当前生效的凭据
duoduocode providers login     # 交互式登录
duoduocode providers logout    # 清除凭据

agent

duoduocode agent list          # 列出所有 Agent
duoduocode agent create        # 交互式创建

session

duoduocode session list        # 列出会话
duoduocode session delete      # 删除会话

mcp

duoduocode mcp list            # 列出已配置的 MCP 服务器
duoduocode mcp add             # 添加
duoduocode mcp auth            # 认证
duoduocode mcp logout          # 登出
duoduocode mcp debug           # 诊断连接

gear（技能与 MCP 市场）

duoduocode gear search <关键词>
duoduocode gear list
duoduocode gear install <id>
duoduocode gear create

duoduocode db path             # 打印数据库路径
duoduocode db projects         # 列出项目
duoduocode db migrate          # 执行迁移

debug（诊断）

duoduocode debug config        # 打印最终生效的配置
duoduocode debug paths         # 打印各目录实际路径
duoduocode debug agent         # Agent 诊断
duoduocode debug file          # 文件相关诊断
duoduocode debug lsp           # LSP 诊断
duoduocode debug snapshot      # 快照诊断（track / patch / diff）
duoduocode debug skill         # 技能诊断
duoduocode debug rg            # ripgrep 诊断
duoduocode debug scrap         # 临时调试

服务端模式

duoduocode serve               # 启动 HTTP API 服务
duoduocode web                 # 启动 Web 界面
duoduocode attach http://localhost:4096   # 连接到已有服务

服务端可用 DUODUO_SERVER_USERNAME / DUODUO_SERVER_PASSWORD 启用基础认证。端口等参数在配置的 server 字段中设置。