agens-studio 0.1.3 → 0.1.6

package/cli.js

@@ -469,9 +469,25 @@ async function mainMenu() {
   }
 }
 
+/**
+ * 检查 API 是否已配置，未配置时自动引导 setup wizard
+ * @returns {Promise<boolean>} true = 已配置可继续，false = 用户取消
+ */
+async function ensureApiConfigured() {
+  if (config.agens.image.apiKey) return true;
+  console.log(`\n${C.red}${C.bold}  ⚠ API Key 未配置，无法生成${C.reset}`);
+  console.log(`${C.gray}  请先配置 Agnes API Key 后重试${C.reset}\n`);
+  const go = await confirm('是否现在配置 API Key');
+  if (go) {
+    await setupWizard(false);
+  }
+  return false;
+}
+
 // ═══════════════════ [1] 文生图 ═══════════════════
 
 async function modeText2Image() {
+  if (!(await ensureApiConfigured())) return;
   console.log(`\n${C.bold}─────── 文生图 ───────${C.reset}`);
 
   const rawPrompt = await ask('描述你想生成的画面');
@@ -511,6 +527,7 @@ async function modeText2Image() {
 // ═══════════════════ [2] 图生图 ═══════════════════
 
 async function modeImage2Image() {
+  if (!(await ensureApiConfigured())) return;
   console.log(`\n${C.bold}─────── 图生图 ───────${C.reset}`);
   console.log(`${C.gray}输入参考图片的本地文件路径（支持拖拽文件到窗口）${C.reset}`);
 
@@ -598,6 +615,7 @@ async function callVisionDirect(dataUri) {
 // ═══════════════════ [3] 文生视频 ═══════════════════
 
 async function modeText2Video() {
+  if (!(await ensureApiConfigured())) return;
   console.log(`\n${C.bold}─────── 文生视频 ───────${C.reset}`);
 
   const rawPrompt = await ask('描述你想生成的视频场景');
@@ -644,6 +662,7 @@ async function modeText2Video() {
 // ═══════════════════ [4] 图生视频 ═══════════════════
 
 async function modeImage2Video() {
+  if (!(await ensureApiConfigured())) return;
   console.log(`\n${C.bold}─────── 图生视频 ───────${C.reset}`);
   console.log(`${C.gray}输入参考图片路径（支持拖拽）${C.reset}`);
 
@@ -696,6 +715,7 @@ async function modeImage2Video() {
 // ═══════════════════ [5] 多图生视频 ═══════════════════
 
 async function modeMulti2Video() {
+  if (!(await ensureApiConfigured())) return;
   console.log(`\n${C.bold}─────── 多图生视频 ───────${C.reset}`);
   console.log(`${C.gray}输入多张图片路径，生成过渡视频（2-5 张）${C.reset}`);
 
@@ -758,6 +778,7 @@ async function modeMulti2Video() {
 // ═══════════════════ [6] 关键帧动画 ═══════════════════
 
 async function modeKeyframe() {
+  if (!(await ensureApiConfigured())) return;
   console.log(`\n${C.bold}─────── 关键帧动画 ───────${C.reset}`);
   console.log(`${C.gray}至少输入首帧和尾帧图片（2-5 张关键帧）${C.reset}`);
 
@@ -840,59 +861,88 @@ async function menuAssets() {
     else if (c === '4') search = await ask('搜索关键词');
     else if (c !== '1') { console.log(`${C.red}无效选择${C.reset}`); continue; }
 
-    const { items, total } = await assetStore.listAssets({ type, search, pageSize: 20 });
+    const pageSize = 20;
+    let page = 1;
 
-    if (items.length === 0) {
-      console.log(`\n${C.gray}暂无素材${total > 0 ? `（共 ${total} 条，当前页为空）` : ''}${C.reset}`);
-      continue;
-    }
+    while (true) {
+      const { items, total } = await assetStore.listAssets({ type, search, page, pageSize });
+      const totalPages = Math.max(1, Math.ceil(total / pageSize));
+      const startIdx = (page - 1) * pageSize;
 
-    console.log(`\n${C.bold}共 ${total} 条素材：${C.reset}\n`);
-    items.forEach((a, i) => {
-      const icon = a.type === 'video' ? '🎬' : '🖼';
-      const prompt = (a.prompt || '').slice(0, 50);
-      const note = a.note ? ` | ${a.note}` : '';
-      console.log(`  ${C.cyan}${String(i + 1).padStart(2)}.${C.reset} ${icon} ${a.filename}`);
-      console.log(`       ${C.gray}${prompt}${note}${C.reset}`);
-      console.log(`       ${formatSize(a.size)} | ${fmtDate(a.createdAt)} | ${a.kept ? C.green + '保留' + C.reset : C.gray + '未保留' + C.reset}`);
-    });
+      if (items.length === 0) {
+        console.log(`\n${C.gray}暂无素材${total > 0 ? `（共 ${total} 条，当前页为空）` : ''}${C.reset}`);
+        break;
+      }
 
-    // 操作
-    console.log('');
-    const op = await ask('输入序号查看详情/操作，或回车返回');
-    if (!op) continue;
-    const idx = parseInt(op, 10) - 1;
-    if (isNaN(idx) || idx < 0 || idx >= items.length) { console.log(`${C.red}无效序号${C.reset}`); continue; }
+      console.log(`\n${C.bold}共 ${total} 条素材（第 ${page}/${totalPages} 页）：${C.reset}\n`);
+      items.forEach((a, i) => {
+        const globalIdx = startIdx + i + 1;
+        const icon = a.type === 'video' ? '🎬' : '🖼';
+        const prompt = (a.prompt || '').slice(0, 50);
+        const note = a.note ? ` | ${a.note}` : '';
+        console.log(`  ${C.cyan}${String(globalIdx).padStart(3)}.${C.reset} ${icon} ${a.filename}`);
+        console.log(`        ${C.gray}${prompt}${note}${C.reset}`);
+        console.log(`        ${formatSize(a.size)} | ${fmtDate(a.createdAt)} | ${a.kept ? C.green + '保留' + C.reset : C.gray + '未保留' + C.reset}`);
+      });
 
-    const asset = items[idx];
-    const absPath = path.join(config.dirs.root, asset.path);
-    console.log(`\n${C.bold}素材详情：${C.reset}`);
-    console.log(`  ID：${asset.id}`);
-    console.log(`  文件：${absPath}`);
-    console.log(`  提示词：${asset.prompt || '(无)'}`);
-    console.log(`  模式：${asset.mode || '(无)'}`);
-    console.log(`  大小：${formatSize(asset.size)}`);
-    console.log(`  创建：${fmtDate(asset.createdAt)}`);
-    console.log(`  保留：${asset.kept ? '是' : '否'}`);
-    if (asset.note) console.log(`  备注：${asset.note}`);
-
-    const action = await choose('操作', ['打开文件', '切换保留状态', '添加备注', '删除']);
-    if (action === 0) {
-      openFile(absPath);
-    } else if (action === 1) {
-      await assetStore.updateAsset(asset.id, { kept: !asset.kept });
-      console.log(`${C.green}已${asset.kept ? '取消保留' : '标记保留'}${C.reset}`);
-    } else if (action === 2) {
-      const note = await ask('输入备注');
-      if (note) {
-        await assetStore.updateAsset(asset.id, { note });
-        console.log(`${C.green}备注已保存${C.reset}`);
-      }
-    } else if (action === 3) {
-      if (await confirm(`确认删除 ${asset.filename}`)) {
-        await assetStore.deleteAsset(asset.id);
-        console.log(`${C.green}已删除${C.reset}`);
+      const navHints = [];
+      if (page < totalPages) navHints.push('n=下一页');
+      if (page > 1) navHints.push('p=上一页');
+      const navStr = navHints.length ? `（${navHints.join('，')}）` : '';
+
+      console.log('');
+      const op = await ask(`输入序号查看详情${navStr}，或回车返回`);
+      if (!op) break;
+
+      if (op.toLowerCase() === 'n' && page < totalPages) { page++; continue; }
+      if (op.toLowerCase() === 'p' && page > 1) { page--; continue; }
+
+      const num = parseInt(op, 10);
+      if (isNaN(num) || num < 1 || num > total) { console.log(`${C.red}无效序号（范围 1-${total}）${C.reset}`); continue; }
+
+      const targetPage = Math.ceil(num / pageSize);
+      const localIdx = num - (targetPage - 1) * pageSize - 1;
+      let asset;
+      if (targetPage === page) {
+        asset = items[localIdx];
+      } else {
+        const nextPageData = await assetStore.listAssets({ type, search, page: targetPage, pageSize });
+        asset = nextPageData.items[localIdx];
+        page = targetPage;
       }
+      if (asset) await showAssetDetail(asset);
+    }
+  }
+}
+
+async function showAssetDetail(asset) {
+  const absPath = path.join(config.dirs.root, asset.path);
+  console.log(`\n${C.bold}素材详情：${C.reset}`);
+  console.log(`  ID：${asset.id}`);
+  console.log(`  文件：${absPath}`);
+  console.log(`  提示词：${asset.prompt || '(无)'}`);
+  console.log(`  模式：${asset.mode || '(无)'}`);
+  console.log(`  大小：${formatSize(asset.size)}`);
+  console.log(`  创建：${fmtDate(asset.createdAt)}`);
+  console.log(`  保留：${asset.kept ? '是' : '否'}`);
+  if (asset.note) console.log(`  备注：${asset.note}`);
+
+  const action = await choose('操作', ['打开文件', '切换保留状态', '添加备注', '删除']);
+  if (action === 0) {
+    openFile(absPath);
+  } else if (action === 1) {
+    await assetStore.updateAsset(asset.id, { kept: !asset.kept });
+    console.log(`${C.green}已${asset.kept ? '取消保留' : '标记保留'}${C.reset}`);
+  } else if (action === 2) {
+    const note = await ask('输入备注');
+    if (note) {
+      await assetStore.updateAsset(asset.id, { note });
+      console.log(`${C.green}备注已保存${C.reset}`);
+    }
+  } else if (action === 3) {
+    if (await confirm(`确认删除 ${asset.filename}`)) {
+      await assetStore.deleteAsset(asset.id);
+      console.log(`${C.green}已删除${C.reset}`);
     }
   }
 }

package/config.js

@@ -132,7 +132,9 @@ export function saveUserConfig(cfg) {
  */
 export function readUserConfig() {
   try {
-    return JSON.parse(fs.readFileSync(USER_CONFIG_FILE, 'utf8'));
+    const data = JSON.parse(fs.readFileSync(USER_CONFIG_FILE, 'utf8'));
+    if (data && typeof data === 'object' && Object.keys(data).length > 0) return data;
+    return null;
   } catch {
     return null;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agens-studio",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Agens 创作工作台 —— AI 图片/视频生成 CLI + Web 工作台",
   "type": "module",
   "main": "server.js",

package/src/services/agensClient.js

@@ -76,7 +76,7 @@ async function localImageToString(localPath, asDataUri) {
 
 async function agnesFetch(url, opts, options) {
   const opts2 = options || {};
-  const retries = opts2.retries != null ? opts2.retries : 3;
+  const retries = opts2.retries != null ? opts2.retries : 5;
   const timeoutMs = opts2.timeoutMs != null ? opts2.timeoutMs : 120000;
   let lastErr;
   for (let attempt = 0; attempt <= retries; attempt++) {
@@ -87,8 +87,20 @@ async function agnesFetch(url, opts, options) {
       clearTimeout(timer);
       if ((res.status === 429 || res.status === 503) && attempt < retries) {
         const t = await res.text().catch(function () { return ''; });
-        console.log('[agnes] ' + res.status + ' busy, retry ' + (attempt + 1) + ' in 5s: ' + t.slice(0, 100));
-        await new Promise(function (r) { setTimeout(r, 5000); });
+        // 429 = 限频（1次/分钟），等 65 秒；503 = 服务忙，等 15 秒
+        const waitSec = res.status === 429 ? 65 : 15;
+        const reason = res.status === 429 ? '限频' : '服务忙';
+        console.log('[agnes] ' + res.status + ' ' + reason + '，' + waitSec + '秒后重试 (' + (attempt + 1) + '/' + retries + ')');
+        // 倒计时显示（仅 429 长等待时显示）
+        if (waitSec >= 30) {
+          for (let s = waitSec; s > 0; s--) {
+            process.stdout.write('\r  等待中... ' + s + '秒  ');
+            await new Promise(function (r) { setTimeout(r, 1000); });
+          }
+          process.stdout.write('\r' + ' '.repeat(40) + '\r');
+        } else {
+          await new Promise(function (r) { setTimeout(r, waitSec * 1000); });
+        }
         continue;
       }
       return res;