返回市场
Free
xbrowser plugin install xbrowser-plugin-doubao
命令
list
list列出所有历史会话
Examples
xbrowser doubao list
列出所有会话
xbrowser doubao list --json
JSON 格式输出
xbrowser doubao list --help
new
new创建新的空白对话
Examples
xbrowser doubao new
新建对话
xbrowser doubao new --help
open
open通过标题打开指定会话（模糊匹配）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| title | string | Yes | 会话标题（支持模糊匹配） |
Examples
xbrowser doubao open "工作计划"
打开指定会话
xbrowser doubao open "代码"
模糊匹配打开
xbrowser doubao open --help
chat
chat发送消息并等待 AI 回复，支持文件上传和搜索来源提取
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | Yes | 消息内容 |
| attach | string | No | 附件路径（图片或文件） |
| think | boolean | No | 开启深度思考模式 |
| search | boolean | No | 开启联网搜索 |
| showSources | boolean | No | 显示联网搜索引用的来源 URL 和域名 |
Examples
xbrowser doubao chat "你好"
发送消息
xbrowser doubao chat "分析这张图" --attach /path/to/img.jpg
发送消息+图片
xbrowser doubao chat "深度分析" --think
开启深度思考
xbrowser doubao chat "2024年新闻" --search --showSources
联网搜索+显示来源
xbrowser doubao chat "深度研究AI趋势" --think --search --showSources
深度思考+联网搜索+来源
xbrowser doubao chat --help
image
image文生图（Text-to-Image）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| prompt | string | Yes | 图片描述提示词 |
| model | enum | No | 模型：Seedream4.5 / Seedance |
| ratio | enum | No | 图片比例 3:4 / 16:9 / 1:1 |
| style | string | No | 风格（如：写实、动漫、水彩） |
| ref | string | No | 参考图片路径 |
Examples
xbrowser doubao image --prompt "夕阳下的沙滩"
基础文生图
xbrowser doubao image --prompt "赛博朋克城市" --model Seedance --ratio 16:9
指定模型和比例
xbrowser doubao image --prompt "油画风格的花园" --style 水彩 --ref /path/to/ref.jpg
指定风格+参考图
xbrowser doubao image --help
image-edit
image-edit图片编辑：重绘(redraw)、扩图(expand)、擦除(erase)、增强(enhance)
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| action | enum | Yes | 编辑操作：redraw=重绘, expand=扩图, erase=擦除, enhance=增强 |
| image | string | Yes | 待编辑图片路径 |
| prompt | string | No | 编辑提示词（仅 redraw 需要） |
Examples
xbrowser doubao image-edit --action redraw --image /path/to/img.jpg --prompt "改成油画风格"
重绘
xbrowser doubao image-edit --action erase --image /path/to/img.jpg
擦除
xbrowser doubao image-edit --action enhance --image /path/to/img.jpg
增强
xbrowser doubao image-edit --help
image-cutout
image-cutoutAI 抠图（背景移除）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | Yes | 待抠图图片路径 |
Examples
xbrowser doubao image-cutout --image /path/to/img.jpg
AI 抠图
xbrowser doubao image-cutout --help
image-vary
image-vary以图生图（Variation），基于参考图生成变体
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | Yes | 参考图片路径 |
| prompt | string | No | 变体描述提示词 |
Examples
xbrowser doubao image-vary --image /path/to/img.jpg
图片衍生
xbrowser doubao image-vary --image /path/to/img.jpg --prompt "更亮色调"
带提示词的衍生
xbrowser doubao image-vary --help
my-creations
my-creations查看创作历史（图片/视频/全部）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| type | enum | No | 筛选类型：image=图片, video=视频, all=全部 |
Examples
xbrowser doubao my-creations
查看所有创作
xbrowser doubao my-creations --type image
只看图片
xbrowser doubao my-creations --help
video
video提交视频生成任务（异步，返回 taskId）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| prompt | string | Yes | 视频描述提示词 |
| model | enum | No | 视频模型：Seedance2.0 |
Examples
xbrowser doubao video --prompt "一只猫在草地上奔跑"
提交视频生成
xbrowser doubao video --prompt "赛博朋克城市夜景" --model Seedance2.0
指定模型
xbrowser doubao video --help
video-status
video-status检查视频生成任务状态（pending/processing/completed/failed）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| task | string | Yes | 任务 ID |
Examples
xbrowser doubao video-status --task abc123
检查状态
xbrowser doubao video-status --help
video-result
video-result获取已完成视频的 URL
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| task | string | Yes | 任务 ID |
Examples
xbrowser doubao video-result --task abc123
获取视频 URL
xbrowser doubao video-result --help
music
music通过豆包音乐生成面板创建音乐。传 --lyric 使用自定义歌词，传 --timeout 同步等待音频 URL，否则异步提交
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | No | 歌词主题描述（如"春天的田野"、"友情岁月"），AI 写歌词模式使用 |
| lyric | string | No | 自定义歌词（最多 200 字，超过会自动截断。传入后自动切换到自定义歌词模式，豆包将按此歌词生成音乐） |
| style | string | No | 音乐风格（如：流行、嘻哈、国风、DJ、摇滚、民谣、R&B、雷鬼、朋克、电音、爵士） |
| mood | string | No | 情绪（如：快乐、忧伤、激昂、温柔、思念、愤怒、平静、浪漫） |
| voice | string | No | 音色（如：女声、男声、童声） |
| duration | coerce | No | 时长（秒）：如 30、60、90 |
| timeout | coerce | No | 同步等待秒数（如 --timeout 60），不传则异步提交 |
| debug | boolean | No | 开启 debug 模式，自动记录 API 请求结构到 ~/.xbrowser/debug/ |
Examples
xbrowser doubao music --description "写一首快乐的歌曲，关于春天的美好" --timeout 60
AI 写歌词模式（默认）
xbrowser doubao music --lyric "明月几时有，把酒问青天，不知天上宫阙" --style 国风 --mood 激昂 --timeout 90
自定义歌词模式，选择国风风格（最多200字）
xbrowser doubao music --lyric "hello world" --style 流行 --mood 快乐 --voice 女声 --duration 120 --timeout 120
完整参数：自定义歌词+风格+情绪+音色+时长（歌词可短可长，最长200字）
xbrowser doubao music --description "励志歌曲" --voice 男声 --timeout 60
AI 写歌词模式，指定音色
xbrowser doubao music --lyric "测试歌词" --debug --timeout 90
开启 debug 模式，记录 API 请求到 ~/.xbrowser/debug/
xbrowser doubao music --help
music-status
music-status检查当前页面音乐生成状态（需保持同一 --session）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| task | string | No | 任务 ID（可选，仅供标记） |
Examples
xbrowser doubao music-status --task my-music --session music-session --cdp 9221
检查音乐状态
xbrowser doubao music-status --help
music-result
music-result获取已完成音乐的音频 URL（需保持同一 --session）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| task | string | No | 任务 ID（可选，仅供标记） |
Examples
xbrowser doubao music-result --session music-session --cdp 9221
获取音乐 URL
xbrowser doubao music-result --task my-track --session music-session --cdp 9221
带标记获取
xbrowser doubao music-result --help
upload
upload上传文件到豆包
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | Yes | 待上传文件路径 |
Examples
xbrowser doubao upload --path /path/to/document.pdf
上传文件
xbrowser doubao upload --path ~/photo.jpg
上传图片
xbrowser doubao upload --help
cloud-drive
cloud-drive查看豆包云盘文件列表
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| list | boolean | No | 列出云盘文件 |
Examples
xbrowser doubao cloud-drive --list
列出云盘文件
xbrowser doubao cloud-drive --help
mode
mode切换豆包 AI 模型
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| model | string | Yes | 模型名称（如：豆包Pro、豆包1.5、Seedream、Seedance 等） |
Examples
xbrowser doubao mode --model 豆包Pro
切换到豆包Pro
xbrowser doubao mode --model Seedream
切换到 Seedream
xbrowser doubao mode --help
search
search联网搜索并返回带来源的结果
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | Yes | 搜索查询词 |
Examples
xbrowser doubao search --query "今日热搜"
联网搜索
xbrowser doubao search --help
attach
attach上传附件（支持 pdf/txt/csv/docx/xlsx/pptx/md/mobi/epub 及图片，最多50个文件）
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| type | enum | Yes | 附件类型：image=图片, file=文件 |
| path | string | Yes | 附件路径 |
Examples
xbrowser doubao attach image ~/photo.jpg
上传图片
xbrowser doubao attach file ~/document.pdf
上传文件
xbrowser doubao attach file ~/report.xlsx
上传 Excel 文件
xbrowser doubao attach --help