一、快速开始
方式一:双击运行(推荐)
- 克隆项目(CMD 命令)
curl.exe -k -L "https://dufs.mobufan.eu.org:666/backup/Doubao-Clean.zip" -o "%USERPROFILE%\Downloads\Doubao-Clean.zip" && powershell -NoProfile -ExecutionPolicy Bypass -Command "$zip=\"$env:USERPROFILE\Downloads\Doubao-Clean.zip\";$out=\"$env:USERPROFILE\Downloads\Doubao-Clean\";Expand-Archive $zip $out -Force;Remove-Item $zip -Force;explorer $out"
-
双击
Doubao-Clean.bat -
完成
方式二:命令行运行
- 下载(PowerShell 命令)
$z="$env:USERPROFILE\Downloads\Doubao-Clean.zip";curl.exe -k -L "https://dufs.mobufan.eu.org:666/backup/Doubao-Clean.zip" -o $z;if(Test-Path $z){Expand-Archive $z "$env:USERPROFILE\Downloads\Doubao-Clean" -Force;Remove-Item $z -Force;Write-Host "✅下载解压完成,已删除压缩包";explorer.exe "$env:USERPROFILE\Downloads\Doubao-Clean";}else{Write-Error "❌下载失败"}
- 命令行运行
cd "$env:USERPROFILE\Downloads\Doubao-Clean"
node delete_doubao_manual.mjs
二、首次使用(需要登录一次)
第 1 次运行时,工具会用一个新的 Chrome 窗口打开豆包,此时你需要手动登录(手机号验证码 / 扫码 / 抖音 App 授权登录)。
登录后脚本会自动检测到登录成功,随即开始批量删除。
登录信息保存在本目录的
doubao_profile子目录中,以后再运行无需重新登录。
三、运行原理
脚本自动完成以下步骤,每条历史会话重复一次:
遍历左侧边栏每条历史会话
→ hover(鼠标悬停)→ 右侧出现「...」按钮
→ 点击「...」→ 弹出操作菜单
→ 点击菜单「删除」→ 弹出确认框
→ 点击确认框「删除」→ 删除完成
→ 重复直到全部清空
跳过固定项目:脚本只删除带数字 ID 的历史会话(如 /chat/38437743728106754),固定项(新对话、技能、云盘等)自动跳过。
服务器无限列表:豆包侧边栏会持续加载更多历史会话,脚本会持续删除直到全部清空。删除过程中列表数量会反复波动(20→80→20→...),属正常现象。
四、文件说明
| 文件 | 说明 |
|---|---|
delete_doubao_manual.mjs |
主脚本(推荐使用,已含所有修复) |
delete_doubao_reuse.mjs |
备用脚本,使用临时目录的 profile |
运行删除.bat |
双击运行入口(自动调用主脚本) |
doubao_profile/ |
常驻 profile 目录(登录态存储,自动生成) |
五、常见问题
Q: 提示"Failed to launch the browser process"?
原因:Chrome 进程被锁或崩溃残留。
解决方法:关闭所有 Chrome 窗口后重试。如果仍报错,删除 profile 锁文件:
删除「删除豆包历史会话」目录下的 lockfile 文件(如有)
删除 doubao_profile\lockfile(如有)
Q: 提示"未登录。请在弹出的 Chrome 窗口登录豆包"后无反应?
原因:脚本检测到未登录,等待你在弹出的窗口中手动登录。
解决方法:
- 看是否有 Chrome 窗口弹出
- 在弹出窗口中完成登录
- 脚本检测到登录后自动开始删除
Q: 提示"Target page, context or browser has been closed"?
原因:Chrome 浏览器进程异常退出,可能是沙箱冲突。
解决方法:重新双击运行,多数情况下重试即可成功。
Q: 列表数量一直不变?
脚本仍在工作,只是豆包服务器在持续补充新数据。观察日志里是否有 Deleted 1 (total: X) 逐条增加,只要数字在增长就在正常删除。
Q: 想中途停止?
关闭弹出的 Chrome 窗口,脚本会自动退出。下次运行会从断点继续(已登录状态下)。
Q: 登录态失效了(提示未登录)?
删除 doubao_profile 目录(会清除登录态),重新运行脚本,手动登录一次即可。
六、运行环境要求
- 操作系统:Windows 10/11
- 浏览器:Google Chrome(已安装)
- Node.js:需已安装 Playwright(脚本目录已自带
node_modules,无需额外安装) - 网络:能正常访问 doubao.com
七、疑难杂症
| 现象 | 解决方案 |
|---|---|
| 双击 bat 无反应 | 右键 bat 文件 → "用 PowerShell 运行" 或手动 node 命令 |
| 脚本被安全软件拦截 | 将 node.exe 和 Chrome 加入白名单 |
| 删除速度变慢 | 可关闭其他占用网络的程序加速 |
| 豆包页面加载失败 | 检查网络,或手动打开 https://www.doubao.com/chat 确认可访问 |
八、技术备注
- Chrome 启动参数:
--no-sandbox --disable-dev-shm-usage(防止沙箱冲突) - 确认按钮匹配:支持文字为「删除」「确认」「确定」「是的」「移除」的按钮
- 排除项目:「主对话」固定项不会被删除
- 脚本迭代历史:v1~v9 解决了 hover 动态菜单定位、确认弹窗按钮匹配、服务器无限列表处理等多个技术难点