@ai-agent-tools/picgen 0.1.0-alpha.8 → 0.1.0-alpha.9

package/README.md

@@ -54,8 +54,8 @@ npx -y skills add ai-agent-tools/picgen --skill picgen -g -y --copy
 picgen skill install codex
 picgen update check
 picgen doctor --json
-picgen create --dry-run "一张产品发布会主视觉"
-picgen create --yes "一张产品发布会主视觉"
+picgen create --dry-run --preset fast-draft "一张简洁的 PicGen 测试图"
+picgen create --yes --preset fast-draft "一张简洁的 PicGen 测试图"
 picgen create --dry-run --provider gemini_official --reference ./reference.png "基于参考图生成一张品牌海报"
 picgen create --yes --provider gemini_official --reference ./reference.png "基于参考图生成一张品牌海报"
 picgen provider list

package/dist/cli.js

@@ -1054,7 +1054,7 @@ import { homedir as homedir2 } from "os";
 
 // src/version.ts
 var PACKAGE_NAME = "@ai-agent-tools/picgen";
-var VERSION = "0.1.0-alpha.8";
+var VERSION = "0.1.0-alpha.9";
 
 // src/commands/update.ts
 var UPDATE_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
@@ -1331,8 +1331,8 @@ function describeEnvValue(name, value, source, path) {
   };
 }
 function maskSecret(value) {
-  if (value.length <= 8) return "*".repeat(value.length);
-  return `${value.slice(0, 4)}...${value.slice(-4)}`;
+  if (value.length <= 11) return "*".repeat(value.length);
+  return `${value.slice(0, 7)}...${value.slice(-4)}`;
 }
 
 // src/commands/key.ts
@@ -1784,10 +1784,10 @@ function formatQuickstart() {
     "  picgen doctor --json",
     "",
     "Preview before spending quota:",
-    '  picgen create --dry-run "\u4E00\u5F20\u6781\u7B80\u79D1\u6280\u611F\u4EA7\u54C1\u6D77\u62A5"',
+    '  picgen create --dry-run --preset fast-draft "\u4E00\u5F20\u7B80\u6D01\u7684 PicGen \u6D4B\u8BD5\u56FE"',
     "",
     "Generate after confirmation:",
-    '  picgen create --yes "\u4E00\u5F20\u6781\u7B80\u79D1\u6280\u611F\u4EA7\u54C1\u6D77\u62A5"',
+    '  picgen create --yes --preset fast-draft "\u4E00\u5F20\u7B80\u6D01\u7684 PicGen \u6D4B\u8BD5\u56FE"',
     "",
     "Use a reference image:",
     '  picgen create --dry-run --reference ./reference.png "\u57FA\u4E8E\u53C2\u8003\u56FE\u751F\u6210\u4E00\u5F20\u54C1\u724C\u6D77\u62A5"',

package/docs/release-alpha.md

@@ -94,7 +94,7 @@ picgen update check
 Always start with dry-run:
 
 ```bash
-picgen create --dry-run "一张极简科技感产品海报"
+picgen create --dry-run --preset fast-draft "一张简洁的 PicGen 测试图"
 ```
 
 Dry-run does not call providers and does not spend quota.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-agent-tools/picgen",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0-alpha.9",
   "description": "A lightweight image generation connector for AI agents.",
   "type": "module",
   "bin": {

package/skills/picgen/SKILL.md

@@ -103,6 +103,36 @@ Use Gemini providers for reference-image generation in Alpha. The OpenAI-compati
 
 PicGen routes by provider capabilities. When reference images are provided, agents may omit `--provider` and let PicGen select a provider that supports `reference-image`, unless the user explicitly requested a provider.
 
+## First Smoke Test
+
+After configuring a provider, run the first test generation with a low-cost, fast, one-image plan. Do not use `poster`, `product-shot`, `social-cover`, premium modes, large sizes, or multi-image presets for initial verification.
+
+For Gemini providers, prefer the flash image model for the first test:
+
+```bash
+picgen create --dry-run --provider gemini_proxy --preset fast-draft --model gemini-3.1-flash-image-preview "一张简洁的 PicGen 测试图，白色背景，少量蓝绿色科技感点缀"
+picgen create --yes --provider gemini_proxy --preset fast-draft --model gemini-3.1-flash-image-preview "一张简洁的 PicGen 测试图，白色背景，少量蓝绿色科技感点缀"
+```
+
+For OpenAI-compatible providers:
+
+```bash
+picgen create --dry-run --provider openai_proxy --preset fast-draft "一张简洁的 PicGen 测试图，白色背景，少量蓝绿色科技感点缀"
+picgen create --yes --provider openai_proxy --preset fast-draft "一张简洁的 PicGen 测试图，白色背景，少量蓝绿色科技感点缀"
+```
+
+Present the dry-run preview and ask for confirmation before the real generation unless the user explicitly asked to generate immediately. The first smoke test should generate one image.
+
+## After Provider Success
+
+After one provider is configured and the first smoke test succeeds, tell the user the provider is ready and ask whether they want to add another channel as a fallback. Example:
+
+```text
+Gemini 渠道已经配置并测试成功。你还可以继续添加另一个渠道作为备用，例如 OpenAI-compatible。要继续添加吗？
+```
+
+If the user says yes, repeat provider setup and smoke testing for the next channel. If the user says no, stop setup and tell them PicGen is ready to use.
+
 ## Preferences and Overrides
 
 Treat `picgen create` flags as one-off overrides. They must not change user preferences:
@@ -157,14 +187,14 @@ Explicit:
 Confirmation:
 
 ```text
-我可以用 PicGen 基于当前方案生成一版主视觉。要我现在生成吗？默认用 poster 预设，出 2 张。
+我可以先用 PicGen 做一次轻量测试生成，默认只出 1 张，确认工具和渠道都可用。要我现在开始吗？
 ```
 
 Generation preview:
 
 ```text
 生成预览：
-我将使用 OpenAI 官方渠道生成 2 张发布会海报，比例 3:4，保存到本地。
+我将使用当前渠道生成 1 张轻量测试图，保存到本地。
 
 确认后开始生成。
 ```