[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83851":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":17,"compositeScore":18,"rankGlobal":8,"rankLanguage":8,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":20,"hasPages":22,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":24,"readmeContent":25,"aiSummary":8,"trendingCount":14,"starSnapshotCount":14,"syncStatus":15,"lastSyncTime":26,"discoverSource":27},83851,"amazon-image-studio","Ali-Aria\u002Famazon-image-studio","Ali-Aria",null,"TypeScript",68,38,51,1,0,2,16,13,4.77,"MIT License",false,"main",true,[],"2026-06-12 02:04:35","# 亚马逊图片工作台\n\n亚马逊图片工作台是一个面向 Amazon Listing 的产品图片策划与生成工作台，基于 [CookSleep\u002Fgpt_image_playground](https:\u002F\u002Fgithub.com\u002FCookSleep\u002Fgpt_image_playground) 修改。\n\n它适合用来把产品标题、五点描述、卖点文案和参考图，整理成 Amazon Listing 图片或 A+ Content 图片策划，并逐张生成图片。\n\n项目仓库：[Ali-Aria\u002Famazon-image-studio](https:\u002F\u002Fgithub.com\u002FAli-Aria\u002Famazon-image-studio)\n\n## 更新日志\n\n按自然周（周一至周日）整理，最新一周在最上方。每个周块可展开查看本周推送内容，提交号用于回溯具体改动。\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>2026-06-08 至 2026-06-14\u003C\u002Fstrong> - DeepSeek 策划兼容与部署提示\u003C\u002Fsummary>\n\n- AI 策划检测到 `https:\u002F\u002Fapi.deepseek.com` 时自动跳过参考图，仅发送纯文本 Chat Completions 请求，避免 DeepSeek 官方接口因 `image_url` 报错。\n- 补充 DeepSeek 策划配置说明，明确官方 Chat Completions 当前不接收参考图。\n- 补充 Vercel 体验版调用 HTTP API 的 HTTPS 安全策略提示。\n- 提交：`8927ad1`、`8a42d09`。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>2026-06-01 至 2026-06-07\u003C\u002Fstrong> - OpenRouter、参考图压缩与策划体验\u003C\u002Fsummary>\n\n- OpenRouter 生图改走 Chat Completions 图片生成，修复普通 Images API 路径下的 404。\n- OpenRouter 请求补齐 `image_config.aspect_ratio` 和 `image_config.image_size`，A+ 非 1:1 图片会映射到最接近的支持比例，减少实际输出回落到 1024 级别。\n- 视觉风格改为内置预设风格图，附图和 A+ 生成时会作为隐藏参考图参与最终生图。\n- 参考图请求前会压缩、控尺寸并校验负载，修复大参考图导致的 413。\n- 普通生图限制为 Images API，OpenRouter 图片模型保留兼容入口，避免误用不支持生图的配置。\n- README 增加在线体验说明，Windows 启动脚本会在启动前自动检查并安装依赖。\n- 优化 Amazon Planner 引导、API 默认配置、图片编辑流程、A+ 策划规则、风格控制和合规提示。\n- 提交：`dd63338`、`9cdecd0`、`dc5e54d`、`031069d`、`56be7df`、`bff26ca`、`7d13774`、`ed43bf5`、`73c70f4`。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>2026-05-25 至 2026-05-31\u003C\u002Fstrong> - Amazon 策划工作流、知识规则与本地化\u003C\u002Fsummary>\n\n- 大幅更新 Amazon Planner 工作流，强化 Listing 图片和 A+ 图片的策划、选择和生成流程。\n- 调整图片默认参数、历史记录字段、任务展示和分类继承逻辑。\n- 更新 dev proxy、mock image API、接口兼容测试和参数兼容逻辑。\n- 内置 Amazon 图片规范、附图策划逻辑和 A+ 尺寸知识文档。\n- 策划接口会引用内置知识规则，提高 Listing \u002F A+ 策划稳定性。\n- 项目名称统一调整为“亚马逊图片工作台”，同步页面标题、PWA manifest、启动脚本和界面文案。\n- README 增加更完整的本地安装、启动和交付说明，历史记录搜索栏增加清理能力。\n- 优化 Amazon Planner 工作流说明、Listing 图片策划模板、复制逻辑和相关测试。\n- 提交：`a85312c`、`7c231bf`、`899532d`、`5cc09c4`、`0c8b9ec`、`d1de756`、`81a3fbd`、`3778620`。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>2026-05-18 至 2026-05-24\u003C\u002Fstrong> - 项目初始化、部署配置与 A+ 模板\u003C\u002Fsummary>\n\n- 完成项目初始化，包含前端应用、图片生成、图片编辑、历史记录、设置页、PWA、代理和部署基础配置。\n- 配置 GitHub Pages 工作流，并支持 main 分支推送后部署。\n- 更新部署文档、安装路径说明和项目 GitHub 链接。\n- 完善 README 使用说明。\n- 优化 A+ Planner 模板、模块文案和任务历史展示。\n- 默认关闭流式输出，降低默认配置复杂度。\n- 提交：`ab63d9b`、`78ef9ea`、`3826fbc`、`ae118af`、`94c5cca`、`d929bdc`、`5860ddd`、`93f9585`、`f9198cb`。\n\n\u003C\u002Fdetails>\n\n## 在线体验\n\n- 体验地址：[https:\u002F\u002Fali-aria.github.io\u002Famazon-image-studio\u002F](https:\u002F\u002Fali-aria.github.io\u002Famazon-image-studio\u002F)\n- 在线体验不会内置 API Key；生成图片和 AI 策划都需要在右上角设置中填写你自己的 OpenAI 或兼容接口 Key。\n- API Key 保存在当前浏览器本地，不会提交到仓库；如果线上页面加载异常，也可以按下面的“启动项目”在本地运行。\n- 💡 提示：若需调用非 HTTPS 的内网或本地 HTTP API，请使用 GitHub Pages 版本或自行部署，Vercel 部署的体验版绑定的 .dev 域名因安全策略通常要求接口必须为 HTTPS。\n\n## 核心功能\n\n- AI 策划 `Main + PT01-PT06`：粘贴标题、五点描述或产品说明后，生成 7 张图片的逐张策划和英文生图提示词。\n- AI 策划 A+ 图片：支持 `大图版 \u002F Standard \u002F Premium` 三套 A+ 模块编排，并生成逐模块英文生图提示词。\n- 参考图上传：支持上传产品实拍图、包装图、结构图，生成时会作为参考图一起发送。\n- 逐张生成：在右侧选择 `MAIN`、`PT01`、`A+L01`、`A+S01`、`A+P01` 等图片位后，当前 Prompt Preview 会切换到对应提示词。\n- Amazon 合规提示：主图白底、商品占比、禁用 Amazon\u002FPrime\u002F价格\u002F评价\u002FBest Seller 等风险元素。\n- 支持 2K \u002F 4K 输出；Listing 图默认方图，A+ 图按模块比例生成高清图，并显示 Seller Central 上传建议尺寸。\n- A+ 小方块模块支持单独输出标题\u002F正文文案，和图片内文字分开，避免把长文案画进 220x220 图片里。\n- 支持 OpenAI \u002F OpenAI 兼容图片接口，以及独立的 AI 策划 Chat Completions \u002F Responses API 配置。\n- 历史记录支持按商品、来源、形状筛选；从历史记录复用或编辑 Listing \u002F A+ 图片时，新任务会继承原商品分类。\n- 保留原项目的参考图、遮罩编辑、历史记录、批量下载、本地 IndexedDB 存储等能力。\n\n## 环境要求\n\n推荐在 Windows 上使用。\n\n需要先安装：\n\n- Node.js 20 LTS 或更新版本\n- npm\n\n安装完成后，可以在 PowerShell 或命令行中检查：\n\n```powershell\nnode --version\nnpm --version\n```\n\n## 首次安装\n\n首次安装只需要做一次。下面两种方式二选一即可；如果已经让 AI 工具完成安装并启动，就不要再重复执行手动安装。\n\n### 方式一：Codex \u002F Claude Code \u002F OpenClaw 安装并启动\n\n如果你要把项目发给别人使用，最简单的方式是直接发 GitHub 仓库链接：\n\n```text\nhttps:\u002F\u002Fgithub.com\u002FAli-Aria\u002Famazon-image-studio\n```\n\n对方可以在 Codex、Claude Code、Claw Code 或其它 AI 编程工具里粘贴下面这段话：\n\n```text\n请把这个 GitHub 项目安装到我的本地电脑并启动：\nhttps:\u002F\u002Fgithub.com\u002FAli-Aria\u002Famazon-image-studio\n\n要求：\n1. 先确认本机已经安装 Node.js 20 LTS 或更新版本和 npm。\n2. 如果本地还没有项目，就 clone 仓库；如果已经下载 ZIP 或源码文件夹，直接进入现有项目目录，不要重复下载。\n3. 在项目目录运行 npm ci 安装依赖。\n4. 如果我是 Windows 用户，优先检查仓库里的 start-amazon-image-studio.bat，能用的话帮我用它启动项目；停止时可以用 stop-amazon-image-studio.bat。\n5. 如果不使用 bat 脚本，就运行 npm run dev 启动项目。\n6. 告诉我浏览器应该打开哪个本地地址。\n```\n\n如果 AI 工具不会自动执行命令，也可以让它按下面“方式二：手动安装（通用）”和“启动项目”里的命令一步一步带你操作。Windows 用户可以优先双击 `start-amazon-image-studio.bat` 启动；脚本会在首次启动或依赖变更后自动安装依赖，停止时双击 `stop-amazon-image-studio.bat`。项目启动后，每个使用者都需要在页面右上角设置里填写自己的 API Key；不要把你的 API Key 发给别人。\n\n### 方式二：手动安装（通用）\n\n先把仓库下载到本地：\n\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002FAli-Aria\u002Famazon-image-studio.git\ncd amazon-image-studio\n```\n\n如果你已经下载了 ZIP 或复制了源码文件夹，直接在终端进入你自己的项目目录即可。\n\n安装依赖：\n\n```powershell\nnpm ci\n```\n\n依赖只需要安装一次。以后日常使用直接看下面的“启动项目”。\n\n## 启动项目\n\n### 方式一：手动启动（通用）\n\n在项目目录中执行：\n\n```powershell\nnpm run dev\n```\n\n然后打开终端中显示的本地地址，通常是：\n\n```text\nhttp:\u002F\u002F127.0.0.1:5173\u002F\n```\n\n停止时，在运行开发服务的终端中按 `Ctrl + C`。\n\n### 方式二：双击启动（Windows 可选）\n\n仓库根目录包含 Windows 便捷脚本：\n\n```text\nstart-amazon-image-studio.bat\n```\n\n双击后会启动本地开发服务，并自动打开浏览器：\n\n```text\nhttp:\u002F\u002F127.0.0.1:5173\u002F\n```\n\n如果服务已经在运行，脚本会直接打开浏览器。\n\n首次双击或 `package-lock.json` 发生变化后，脚本会先运行 `npm ci` 安装依赖；依赖安装成功后才会启动项目。如果电脑还没有安装 Node.js 20 LTS 或更新版本，脚本会提示先安装 Node.js。\n\n## 停止项目\n\n手动启动时，在终端中按 `Ctrl + C` 即可停止。\n\n如果使用 Windows 双击脚本启动，也可以双击：\n\n```text\nstop-amazon-image-studio.bat\n```\n\n脚本会停止当前项目对应的本地开发服务。如果 5173 端口被其它程序占用，脚本不会强行关闭无关进程。\n\n## API 配置\n\n打开页面后，点击右上角设置图标，进入 API 配置。\n\n建议准备两个配置：\n\n### 1. 生图配置\n\n用于真正生成图片。\n\n- 服务商：OpenAI 或 OpenAI 兼容接口\n- API 接口：`Images API (\u002Fv1\u002Fimages)`\n- 模型：`gpt-image-2`\n- API Key：填写你自己的 Key\n\nOpenRouter 生图模型不提供 OpenAI `\u002Fimages\u002Fgenerations` 路径，应用会自动把 `https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1` 的生图请求转到 `\u002Fchat\u002Fcompletions` 并发送 `modalities`。OpenRouter 示例：API URL 填 `https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1`，模型填支持图片输出的模型，例如 `google\u002Fgemini-2.5-flash-image`；API 接口选择 `Images API` 或 `Chat Completions` 都可以。遮罩编辑仍需使用支持 `\u002Fimages\u002Fedits` 的接口。\n\n### 2. AI 策划配置\n\n用于根据 Listing 生成 `Main + PT01-PT06` 或 A+ 模块图片策划。\n\n- 服务商：OpenAI\n- API 接口：`Chat Completions (\u002Fchat\u002Fcompletions)`；OpenAI 官方也可继续使用 `Responses API (\u002Fv1\u002Fresponses)`\n- 模型：文本\u002F多模态模型，例如 DeepSeek 使用 `deepseek-v4-flash`\n- API Key：填写你自己的 Key\n\nDeepSeek 示例：API URL 填 `https:\u002F\u002Fapi.deepseek.com`，API 接口选择 `Chat Completions (\u002Fchat\u002Fcompletions)`，模型填 `deepseek-v4-flash`。当前 DeepSeek 官方 Chat Completions 接口只接收文本内容，本项目检测到该地址时会自动跳过参考图，仅用 Listing 文本做 AI 策划。\n\n在设置页中，把“AI 策划配置”选择为这个 Chat Completions 配置。这样生图和策划不需要来回切换接口类型。\n\nAI 策划提示词已内置精炼版亚马逊图片知识库规则，包括 Listing 主图\u002F附图规范、A+ 模块尺寸、移动端可读性和合规禁用项。原始知识库 Markdown 保存在 `docs\u002Fknowledge\u002F` 作为规则来源备查，运行时不会把整篇原文发送给模型。\n\n## 使用流程\n\n1. 启动项目并打开页面。\n2. 在设置中配置生图 API 和 AI 策划 API。\n3. 在 Amazon 面板顶部选择 `Listing 图` 或 `A+ 图`。\n4. 如果选择 `A+ 图`，默认使用 `大图版`，也可以切换为 `Standard` 或 `Premium` 编排。\n5. 在策划输入框中粘贴产品标题、五点描述、产品说明或品牌说明。\n6. 在“参考图”区域上传产品实拍图、包装图或结构图。\n7. 点击 `AI策划` 或 `AI策划A+`，生成逐张方案。\n8. 在右侧选择要生成的图片位，例如 `MAIN`、`PT01`、`A+L01`、`A+S01` 或 `A+P01`。\n9. 检查 Prompt Preview，必要时调整左侧商品信息。\n10. 点击“填入”把当前提示词填到底部输入栏，或点击“提交生成”直接开始生成。\n11. 生成完一张后，继续选择下一张图片位逐张生成。\n\n## A+ 图片说明\n\n大图版 A+ 当前默认编排，也是 A+ 图片策划的默认选项：\n\n- `A+L01` Header Banner：上传建议 `970x300`\n- `A+L02-A+L05` Single Image：上传建议 `970x600`\n\nStandard A+ 编排：\n\n- `A+S01` Header Banner：上传建议 `970x300`\n- `A+S02-A+S04` Single Image：上传建议 `970x600`\n- `A+S05-A+S08` Highlight Tile：上传建议 `220x220`\n\nPremium A+ 当前默认编排：\n\n- `A+P01` Hero Banner：上传建议 `1464x600`\n- `A+P02-A+P04` Feature Image：上传建议 `970x600`\n- `A+P05-A+P06` Brand Story：上传建议 `463x625`\n\nA+ 生图会按模块比例请求 2K \u002F 4K 高清画布，页面中会同时显示“生成尺寸”和“上传建议尺寸”。`Highlight Tile` 会额外生成可复制的 A+ 标题\u002F正文文案；这些外部文案不会写入图片生成 Prompt。当前版本不自动裁切、压缩到 2 MB，也不默认生成 Logo 图或对比图。\n\n## 安全说明\n\n- 不要把你的 API Key 提交到 GitHub。\n- 不要把包含 API Key 的配置截图发给别人。\n- 本项目的 API Key 保存在你自己浏览器的本地存储中。\n- 每个使用者应填写自己的 API Key，并自行承担 API 调用费用。\n- 如果你要把项目发给别人，请确认仓库中没有 `.env`、私钥、真实 API Key 或个人数据。\n\n## 常见问题\n\n### 启动后打不开页面\n\n确认是否已经安装依赖：\n\n```powershell\nnpm ci\n```\n\n然后重新运行：\n\n```powershell\nnpm run dev\n```\n\nWindows 用户也可以重新双击 `start-amazon-image-studio.bat`。\n\n### 5173 端口被占用\n\n如果是手动启动，先在终端中按 `Ctrl + C`。如果是 Windows 脚本启动，可以双击：\n\n```text\nstop-amazon-image-studio.bat\n```\n\n如果仍然提示被占用，说明 5173 可能被其它程序使用，需要先关闭对应程序，或改用 Vite 输出的其它端口。\n\n### AI 策划失败\n\n检查“AI 策划配置”是否使用了文本接口，并确认模型不是图片生成模型。DeepSeek 请使用 `Chat Completions (\u002Fchat\u002Fcompletions)`；当前 DeepSeek 官方接口不接收参考图，本项目会自动跳过参考图。部分图片中转接口只开放 `\u002Fv1\u002Fimages`，不支持聊天或 Responses 接口，这种情况下 AI 策划会失败。\n\n### 生图失败\n\n检查当前生图配置是否填写了正确的 API URL、API Key、模型和接口类型。生成图片建议使用 `Images API (\u002Fv1\u002Fimages)` + `gpt-image-2`。\n\n如果 OpenRouter 报 404，通常是旧版本请求到了 `\u002Fimages\u002Fgenerations`。请更新后使用 `https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1` 和带 `image` 输出能力的模型；OpenRouter 的图片生成实际走 `\u002Fchat\u002Fcompletions`。\n\n## 构建\n\n如果需要生成生产构建：\n\n```powershell\nnpm run build\n```\n\n构建产物在：\n\n```text\ndist\u002F\n```\n\n## 静态部署\n\n本项目是 Vite 单页应用，部署平台只需要安装依赖、运行构建命令，并把 `dist\u002F` 作为静态目录发布。\n\n推荐配置：\n\n```text\nInstall command: npm ci\nBuild command: npm run build\nOutput directory: dist\nNode.js version: 20\n```\n\n### GitHub Pages\n\n仓库已包含 GitHub Pages 工作流：\n\n```text\n.github\u002Fworkflows\u002Fdeploy.yml\n```\n\n使用步骤：\n\n1. 进入 GitHub 仓库的 `Settings -> Pages`。\n2. `Build and deployment` 的 `Source` 选择 `GitHub Actions`。\n3. 推送到 `main` 后会自动构建并部署。也可以在 `Actions` 页面手动运行 `Deploy to GitHub Pages`，或推送 `v*` 格式的 tag，例如 `v0.1.0`。\n\n项目的 Vite `base` 已设置为 `.\u002F`，可以部署在 `https:\u002F\u002F\u003Cusername>.github.io\u002Famazon-image-studio\u002F` 这类子路径下。\n\n当前仓库的 GitHub Pages 体验地址：\n\n```text\nhttps:\u002F\u002Fali-aria.github.io\u002Famazon-image-studio\u002F\n```\n\n### Cloudflare Pages\n\n连接 GitHub 仓库后，按以下方式配置：\n\n```text\nFramework preset: Vite\nBuild command: npm run build\nBuild output directory: dist\nNode.js version: 20\n```\n\n如果使用 Cloudflare Workers 静态资源部署，也可以使用仓库中的 `wrangler.jsonc`，先执行：\n\n```powershell\nnpm run build\n```\n\n再按你的 Cloudflare 账号配置运行 Wrangler 部署。\n\n### Vercel\n\n当前仓库的 `vercel.json` 里关闭了 Git 自动部署：\n\n```json\n{\n  \"git\": {\n    \"deploymentEnabled\": false\n  }\n}\n```\n\n如果要让 Vercel 在每次 push 后自动部署，请删除这段配置，或把 `deploymentEnabled` 改为 `true`。如果继续保留它，可以使用 `.github\u002Fworkflows\u002Fvercel-tag-deploy.yml` 中的 Deploy Hook 方式，并在 GitHub Secrets 里配置 `VERCEL_DEPLOY_HOOK`。\n\n## 许可与来源\n\n本项目基于 MIT 许可的 [GPT Image Playground](https:\u002F\u002Fgithub.com\u002FCookSleep\u002Fgpt_image_playground) 修改，原作者为 CookSleep。\n\n请保留应用内“关于”页中的原项目署名与 MIT 许可声明。\n","2026-06-11 04:11:38","CREATED_QUERY"]