SuperAPI AI 工具集

xpai-doubao-web

设计与创作

查看项目

更新于 10-15 22:15

技能介绍

用途:该技能用于复用浏览器登录 cookie,通过命令行调用豆包网页版生成图片或文本。

主要能力:提供 CLI 包装器,支持提示词文件、可选参考图、预设(preset)、多轮会话和 JSON 输出。入口脚本为 scripts/main.ts,模式分 image(默认)和 text,客户端与辅助代码位于 scripts/doubao-webapi/。

使用方式:脚本位于 scripts/ 子目录。示例命令: 生成图片:npx -y bun scripts/main.ts "Your prompt" 纯文本:npx -y bun scripts/main.ts --mode text --prompt "Summarize this article" 指定模型:--model doubao-default 输出图片文件:--image out.png 从文件读提示词:--promptfiles system.md content.md 参考图输入:--reference a.png 预设:--preset xiaohongshu_cover;--list-presets 可列出预设 多轮会话:--sessionId session-abc JSON 输出:--json 常用选项还有 --prompt/-p、--model/-m、--mode、--image、--reference/--ref、--list-sessions、--login、--cookie-path、--profile-dir。

认证与依赖:登录使用浏览器 cookie。--login 会打开可见浏览器窗口刷新并保存 cookie;生成默认无头运行,设 DOUBAO_WEB_HEADLESS=0 可显示浏览器;若已存在 cookie 文件则直接生成。--login 与图片生成需安装 Playwright 及其浏览器:npm i -D playwright 与 npx playwright install。支持 Chromium/Chrome/Edge,可用 DOUBAO_WEB_CHROME_PATH 覆盖浏览器路径,--profile-dir 作为 Playwright 用户数据目录。

首次使用前必须获得用户明确同意,因为该技能依赖逆向的网页行为,会访问并存储豆包网页 cookie。同意文件位置:macOS 为 ~/Library/Application Support/xpai-skills/doubao-web/consent.json,Linux 为 ~/.local/share/xpai-skills/doubao-web/consent.json,Windows 为 %APPDATA%\xpai-skills\doubao-web\consent.json,格式含 version、accepted、acceptedAt、disclaimerVersion。

其他配置:EXTEND.md 覆盖按项目级 .xpai-skills/xpai-doubao-web/EXTEND.md 优先、用户级 $HOME/.xpai-skills/xpai-doubao-web/EXTEND.md 次之;预设配置路径优先级为 DOUBAO_WEB_PRESETS_PATH、项目级 presets.json、用户级 presets.json。相关环境变量包括 DOUBAO_WEB_DATA_DIR、DOUBAO_WEB_COOKIE_PATH、DOUBAO_WEB_MAX_IMAGES、DOUBAO_WEB_LOGIN_URL、DOUBAO_WEB_COOKIE_DOMAIN、DOUBAO_WEB_INPUT_SELECTOR、DOUBAO_WEB_OUTPUT_SELECTOR、DOUBAO_WEB_CHROME_PROFILE_DIR、DOUBAO_WEB_CHROME_PATH 及 HTTP_PROXY/HTTPS_PROXY。会话文件存于数据目录 sessions/<id>.json,使用 --sessionId 时持久化 Playwright profile 保存在 profiles/<id>/。

限制:依赖豆包网页登录态与逆向实现,需用户同意并自行承担相关风险;收费、价格、平台与效果等资料暂未提供。