autodoubao: Instructions file for Codex

AutoDoubao project instructions

Durable context

• This repository implements a local MCP bridge shared by Codex, Hermes Agent, and LobsterAI. It uses the user's logged-in Doubao web session and does not call a paid image-generation API.
• Read docs/AUTODOUBAO_IMPLEMENTATION_ZH.md before changing browser automation, image acquisition, client configuration, or troubleshooting behavior.
• The verified extension architecture is version 0.2.0: reliable composer submission in extension/content.js, followed by CDP Network interception in extension/background.js and extraction of image_ori_raw / image_raw URLs.
• Never revert normal image acquisition to DOM <img> scraping. DOM width/height attributes and src/srcset can represent a 384x216 preview even when the requested and original image is 2848x1600.
• Do not try to derive an original URL by removing ImageX query parameters or editing signed URLs.

Using the MCP

• MCP URL: http://127.0.0.1:8878/mcp.
• Call doubao_status first. Require both browser_connected and doubao_page_ready before generating.
• Call doubao_generate once, retain its job_id, and poll doubao_job_status every 3-5 seconds. Do not enqueue duplicates while waiting.
• On completion, inspect the returned absolute image path, verify actual pixel dimensions, and visually assess the asset before placing it into a game.
• If an image is unsuitable, describe observable defects and make a targeted new prompt. Do not silently retry login, captcha, quota, rate-limit, or attention_required states.
• output_subdir is relative to the configured output root. Copy an accepted asset into another project only when that action is within the user's request.

Browser constraints

• The extension requires Chrome's debugger permission and attaches only during an active job. Do not open DevTools on the controlled Doubao tab during a job.
• The user signs in manually. Never store credentials, clear cookies, bypass quotas, or attempt to solve security verification.
• Signed original-image URLs should be downloaded immediately; do not persist them as durable artifacts.
• If Doubao changes, diagnose the failing layer first: MCP, WebSocket, page readiness, prompt submission, generation, network parsing, download, or file handoff. Do not bump the extension version until a tested behavior change exists.