@bolloon/bolloon-agent 0.1.32 → 0.1.33

package/dist/web/server.js

@@ -11,6 +11,7 @@ import { initMinimax, getMinimax } from '../constraints/index.js';
 import { createAgentSession } from '../agents/pi-sdk.js';
 import { llmConfigStore } from '../llm/config-store.js';
 import { videoConfigStore } from '../llm/video-config-store.js';
+import { audioConfigStore } from '../llm/audio-config-store.js';
 import { irohTransport } from '../network/iroh-transport.js';
 import { createAgentDelegateApp } from './agent-delegate-server.js';
 import { createIrohDelegateTransport } from './iroh-delegate-transport.js';
@@ -327,6 +328,114 @@ function isSharedWith(ch, peerPublicKey) {
     const shared = Array.isArray(ch.shared_with_peers) ? ch.shared_with_peers : [];
     return shared.includes(peerPublicKey);
 }
+/**
+ * v3 新增: 解析 LLM 回复里的 @-mentions, 把消息发到目标 channel.
+ *
+ * 语法: "@渠道名 消息内容" — 渠道名匹配 local channels by name, 或 remote channels by name.
+ * - 本地 channel: 直接 push 到 session
+ * - 远端 channel: 通过 P2P RPC 转发到对端
+ *
+ * 返回: 解析到的 mention 列表, 供 SSE 广播
+ */
+async function routeMentionsInReply(originChannelId, replyText, localChannels, remoteChannels) {
+    const results = [];
+    // 解析: 匹配 @渠道名 后面跟一段文字 (到下一个 @ 或 行尾)
+    // 渠道名: 中文/英文/数字/下划线/连字符, 1-30 字符
+    const regex = /@([一-龥A-Za-z0-9_\-]{1,30})\s+([^\n@]+?)(?=(?:\s*@[一-龥A-Za-z0-9_\-]{1,30}\s)|$)/g;
+    const matches = [...replyText.matchAll(regex)];
+    if (matches.length === 0)
+        return results;
+    // 找当前 channel 的 name (用于日志)
+    let originChannelName = originChannelId;
+    try {
+        const chs = await loadChannels();
+        const oc = chs.find(c => c.id === originChannelId);
+        if (oc)
+            originChannelName = oc.name;
+    }
+    catch { }
+    console.log(`[v3-cross] (${originChannelName}) 解析到 ${matches.length} 个 @-mention`);
+    for (const m of matches) {
+        const targetName = m[1].trim();
+        const text = m[2].trim();
+        if (!text)
+            continue;
+        // 优先本地 (本地 channel 不能有 ownerPublicKey)
+        const localTarget = localChannels.find(c => c.name === targetName);
+        const remoteTarget = !localTarget ? remoteChannels.find(c => c.name === targetName) : null;
+        if (localTarget) {
+            // 本地: 直接 push 到 session
+            try {
+                const existing = await loadSession(localTarget.id, 'default');
+                const session = existing || {
+                    channelId: localTarget.id, sessionId: 'default', messages: [], lastUpdated: new Date().toISOString()
+                };
+                session.messages.push({
+                    id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+                    type: 'ai',
+                    content: text,
+                    timestamp: new Date().toISOString(),
+                    source: 'ai-mention', // v3: 标记是其他 channel 的 AI @-mention 进来的
+                    originChannelId, // 谁 @ 过来的
+                    originChannelName // 渠道名 (方便显示)
+                });
+                session.lastUpdated = new Date().toISOString();
+                await saveSession(session);
+                console.log(`[v3-cross] (${originChannelName}) @${targetName} → 本地 channel ${localTarget.id}, 存了 ${text.length} chars`);
+                // 推 SSE 让本地 UI 知道有 AI 跨渠道消息
+                broadcast({
+                    type: 'cross-mention-received',
+                    originChannelId, originChannelName,
+                    targetChannelId: localTarget.id, targetChannelName: localTarget.name,
+                    text, source: 'ai-mention'
+                }, 'broadcast');
+                results.push({ targetName, targetId: localTarget.id, source: 'local', text, status: 'sent' });
+            }
+            catch (err) {
+                console.error(`[v3-cross] @${targetName} 本地存失败:`, err.message);
+                results.push({ targetName, targetId: localTarget.id, source: 'local', text, status: 'failed' });
+            }
+        }
+        else if (remoteTarget) {
+            // 远端: 通过 P2P RPC 转发
+            const ownerPk = remoteTarget._ownerPublicKey;
+            if (!v3P2PRef) {
+                console.warn(`[v3-cross] P2PDirect 未启动, 跳过远端 @${targetName}`);
+                results.push({ targetName, targetId: remoteTarget.id, source: 'remote', text, status: 'failed' });
+                continue;
+            }
+            try {
+                const rpc = JSON.stringify({
+                    v: 3, op: 'agent.cross.post',
+                    payload: {
+                        targetChannelId: remoteTarget.id,
+                        targetChannelName: remoteTarget.name,
+                        originChannelId,
+                        originChannelName,
+                        text,
+                        fromPublicKey: v3P2PRef.getPublicKey()
+                    }
+                });
+                const ok = v3P2PRef.sendTo(ownerPk, rpc);
+                if (ok) {
+                    console.log(`[v3-cross] (${originChannelName}) @${targetName} → 远端 peer ${ownerPk.substring(0, 12)}... (channelId=${remoteTarget.id})`);
+                    results.push({ targetName, targetId: remoteTarget.id, source: 'remote', text, status: 'sent' });
+                }
+                else {
+                    results.push({ targetName, targetId: remoteTarget.id, source: 'remote', text, status: 'failed' });
+                }
+            }
+            catch (err) {
+                console.error(`[v3-cross] @${targetName} 远端 RPC 失败:`, err.message);
+                results.push({ targetName, targetId: remoteTarget.id, source: 'remote', text, status: 'failed' });
+            }
+        }
+        else {
+            console.warn(`[v3-cross] @${targetName} 找不到匹配 channel (本地 ${localChannels.length} 个, 远端 ${remoteChannels.length} 个)`);
+        }
+    }
+    return results;
+}
 /**
  * v3: 处理 Hyperswarm 通道收到的 v3 RPC 消息
  * 设计: 用 HyperswarmCommunicator (DHT topic 自动发现) 取代 iroh 直接 connect
@@ -436,11 +545,13 @@ async function handleV3P2PMessage(parsed, conn, comm) {
                     id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
                     type: 'user',
                     content: text,
-                    timestamp: new Date().toISOString()
+                    timestamp: new Date().toISOString(),
+                    source: 'remote', // v3: 标记远端访客
+                    fromPublicKey: senderKey // v3: 记录对方 publicKey
                 });
                 session.lastUpdated = new Date().toISOString();
                 await saveSession(session);
-                console.log(`[v3] (${channelId}) 存 user 消息 (${text.length} chars) 到 A 的 session`);
+                console.log(`[v3] (${channelId}) 存 user 消息 (${text.length} chars) 到 A 的 session (来自 ${senderKey.substring(0, 12)}...)`);
             }
             catch (saveErr) {
                 console.warn(`[v3] 存 user 消息失败 (不影响 chat):`, saveErr.message);
@@ -466,7 +577,30 @@ async function handleV3P2PMessage(parsed, conn, comm) {
             // 2. 跑 LLM (复用 Phase 1 的 buildJudgmentHint — 注入 channel 的 judgment)
             const { getMinimax } = await import('../constraints/index.js');
             const llm = getMinimax();
-            const fullPrompt = `${judgmentHint}${text}`;
+            // v3 新增: 在 prompt 头部标记"这是远端访客", 让 AI 知道对方不是自己 owner
+            const visitorHint = `[系统上下文] 消息来源: 远端访客 (P2P 连接, publicKey=${senderKey.substring(0, 12)}...). 对方不是你 owner, 是通过 P2P 网络访问你这个 channel 的合作者. 称呼对方时可用 "远端访客" / "朋友" / "合作者", 不要叫 "主人".\n\n`;
+            // v3 新增: 也注入 channel 目录给 LLM (B 的 channel 也可以 @-mention 其他)
+            let dirHint = '';
+            const localChannels = (await loadChannels()).filter(c => c.id !== channelId);
+            const remoteChannels = [];
+            for (const [peerPk, list] of remoteChannelCache.entries()) {
+                if (peerPk === senderKey)
+                    continue; // 跳过发起方
+                for (const ch of list) {
+                    remoteChannels.push({ ...ch, _ownerPublicKey: peerPk });
+                }
+            }
+            if (localChannels.length > 0 || remoteChannels.length > 0) {
+                dirHint += '[系统上下文] 可用渠道 (你可以用 @渠道名 消息内容 给它们发消息):\n';
+                for (const c of localChannels) {
+                    dirHint += `  - [本地] @${c.name} (id=${c.id})\n`;
+                }
+                for (const c of remoteChannels) {
+                    dirHint += `  - [远端, owner=${(c._ownerPublicKey || '').substring(0, 8)}…] @${c.name} (id=${c.id})\n`;
+                }
+                dirHint += '语法: 在回复中写 "@渠道名 我要说的话" 即可. 消息会持久化到目标 channel 的 session.\n\n';
+            }
+            const fullPrompt = `${visitorHint}${dirHint}${judgmentHint}${text}`;
             let fullResponse = '';
             // v3 新增: 流式 token 节流推给 B — 让 B 看到过程
             let lastFlushAt = 0;
@@ -589,6 +723,53 @@ async function handleV3P2PMessage(parsed, conn, comm) {
         }
         return;
     }
+    // v3 新增: 收到远端发来的 @-mention 跨渠道消息, 存到本地 target channel
+    if (op === 'agent.cross.post') {
+        const { targetChannelId, targetChannelName, originChannelId, originChannelName, text, fromPublicKey } = parsed.payload || {};
+        if (!targetChannelId || !text) {
+            console.warn(`[v3-cross] agent.cross.post 缺少 targetChannelId/text`);
+            return;
+        }
+        try {
+            // 找 channel — 必须存在于本节点
+            const channels = await loadChannels();
+            const ch = channels.find(c => c.id === targetChannelId);
+            if (!ch) {
+                console.warn(`[v3-cross] agent.cross.post: 本节点无 channel ${targetChannelId}, 忽略`);
+                return;
+            }
+            // 存到 session — 这是一条来自其他节点的 LLM @-mention
+            const existing = await loadSession(targetChannelId, 'default');
+            const session = existing || {
+                channelId: targetChannelId, sessionId: 'default', messages: [], lastUpdated: new Date().toISOString()
+            };
+            session.messages.push({
+                id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+                type: 'ai',
+                content: text,
+                timestamp: new Date().toISOString(),
+                source: 'ai-mention-remote', // v3: 来自其他节点的 AI @-mention
+                originChannelId, // 哪个 channel 触发的
+                originChannelName,
+                fromPublicKey // 哪个节点来的
+            });
+            session.lastUpdated = new Date().toISOString();
+            await saveSession(session);
+            console.log(`[v3-cross] 收到远端 @-mention: ${originChannelName} → 本地 ${targetChannelName} (${text.length} chars)`);
+            // 推 SSE 让本地 UI 知道有跨渠道消息到达
+            broadcast({
+                type: 'cross-mention-received',
+                originChannelId, originChannelName,
+                targetChannelId, targetChannelName: ch.name,
+                text, source: 'ai-mention-remote',
+                fromPublicKey
+            }, 'broadcast');
+        }
+        catch (err) {
+            console.error(`[v3-cross] 处理 agent.cross.post 失败:`, err.message);
+        }
+        return;
+    }
     console.log(`[v3] 收到未知 op: ${op}`);
 }
 async function buildJudgmentHint(channel, channelIdForLog) {
@@ -1059,6 +1240,8 @@ export async function createWebServer(port = 3000, options = {}) {
             let contextHint = '';
             if (realChannelDid)
                 contextHint += `[系统上下文] 当前频道名称: ${realChannelName}, 你的真实 DID: ${realChannelDid}\n`;
+            // v3 新增: 标识发送方 — 让 AI 分清内部 owner vs 远端访客
+            contextHint += `[系统上下文] 消息来源: 本地 (channel 内部 owner / 此机器上的用户). 称呼对方时用 "你" 或 "主人" 即可.\n`;
             if (boundWalletAddress) {
                 contextHint += `[系统上下文] 已绑定的加密钱包地址: ${boundWalletAddress}。当用户授权或启用自动工具调用时, 可使用该地址发起链上操作。\n`;
             }
@@ -1073,15 +1256,38 @@ export async function createWebServer(port = 3000, options = {}) {
             const judgmentHint = await buildJudgmentHint(channelForJudgment, channelId);
             if (judgmentHint)
                 contextHint += judgmentHint;
+            // v3 新增: 注入"可用渠道"目录, 让 LLM 知道可以 @-mention 哪些 channel
+            // - 本地 channels (除了自己)
+            // - 远端 channels (remoteChannelCache 缓存的)
+            const localChannels = (await loadChannels()).filter(c => c.id !== channelId);
+            const remoteChannels = [];
+            for (const [peerPk, list] of remoteChannelCache.entries()) {
+                for (const ch of list) {
+                    remoteChannels.push({ ...ch, _ownerPublicKey: peerPk });
+                }
+            }
+            if (localChannels.length > 0 || remoteChannels.length > 0) {
+                contextHint += '[系统上下文] 可用渠道 (你可以用 @渠道名 消息内容 给它们发消息):\n';
+                for (const c of localChannels) {
+                    contextHint += `  - [本地] @${c.name} (id=${c.id})\n`;
+                }
+                for (const c of remoteChannels) {
+                    contextHint += `  - [远端, owner=${(c._ownerPublicKey || '').substring(0, 8)}…] @${c.name} (id=${c.id})\n`;
+                }
+                contextHint += '语法: 当你想给其他渠道发消息, 在回复中写 "@渠道名 我要说的话" 即可. 消息会持久化到目标 channel 的 session, 你之后能看到"自己"在那里说的话.\n\n';
+            }
             if (contextHint)
                 contextHint += '\n';
             fullResponse = await agent.promptStream(contextHint + text, streamCallback);
+            // v3 新增: 解析 LLM 回复里的 @-mentions, 转发到目标 channel
+            await routeMentionsInReply(channelId, fullResponse, localChannels, remoteChannels);
             broadcast({ type: 'ai', content: fullResponse }, channelId);
             const existingSession = await loadSession(channelId, currentSessionId);
             const session = existingSession || { channelId, sessionId: currentSessionId, messages: [], lastUpdated: new Date().toISOString() };
             session.sessionId = currentSessionId;
-            session.messages.push({ id: crypto.randomUUID(), type: 'user', content: text, timestamp: new Date().toISOString() });
-            session.messages.push({ id: crypto.randomUUID(), type: 'ai', content: fullResponse, timestamp: new Date().toISOString() });
+            // v3: 加 source 标记 (local = 内部 owner, remote = 远端访客)
+            session.messages.push({ id: crypto.randomUUID(), type: 'user', content: text, timestamp: new Date().toISOString(), source: 'local' });
+            session.messages.push({ id: crypto.randomUUID(), type: 'ai', content: fullResponse, timestamp: new Date().toISOString(), source: 'local' });
             session.lastUpdated = new Date().toISOString();
             await saveSession(session);
             const channels = await loadChannels();
@@ -1953,6 +2159,11 @@ export async function createWebServer(port = 3000, options = {}) {
             if (!provider || !config) {
                 return res.status(400).json({ error: 'provider and config required' });
             }
+            // 如果前端发的是掩码（***xxx），从当前配置里取真实 key
+            const currentConfig = await llmConfigStore.getProvider(provider);
+            if (currentConfig && config.apiKey && config.apiKey.startsWith('***')) {
+                config.apiKey = currentConfig.apiKey;
+            }
             await llmConfigStore.updateProvider(provider, config);
             // 如果是活跃供应商，重新初始化 Pi SDK
             const currentActive = await llmConfigStore.getActiveProvider();
@@ -2065,6 +2276,59 @@ export async function createWebServer(port = 3000, options = {}) {
             res.status(500).json({ error: err.message });
         }
     });
+    // ==================== 音频生成配置 (TTS / Music) ====================
+    // 获取音频配置
+    app.get('/api/audio-config', async (req, res) => {
+        try {
+            const config = await audioConfigStore.getConfig();
+            const providerInfo = audioConfigStore.getAllProviderInfo();
+            const masked = Object.fromEntries(Object.entries(config.providers).map(([key, val]) => [
+                key,
+                { ...val, apiKey: val.apiKey ? '***' + val.apiKey.slice(-4) : '' }
+            ]));
+            res.json({
+                activeProvider: config.activeProvider,
+                providers: masked,
+                providerInfo
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 更新音频供应商配置
+    app.post('/api/audio-config', async (req, res) => {
+        try {
+            const { provider, config } = req.body;
+            if (!provider || !config) {
+                return res.status(400).json({ error: 'provider and config required' });
+            }
+            // 掩码回写真实 key
+            const currentConfig = await audioConfigStore.getProvider(provider);
+            if (currentConfig && config.apiKey && config.apiKey.startsWith('***')) {
+                config.apiKey = currentConfig.apiKey;
+            }
+            await audioConfigStore.updateProvider(provider, config);
+            res.json({ ok: true });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // 测试音频供应商连接
+    app.post('/api/audio-test', async (req, res) => {
+        try {
+            const { provider } = req.body;
+            if (!provider) {
+                return res.status(400).json({ error: 'provider required' });
+            }
+            const result = await audioConfigStore.testProvider(provider);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     // 统一 AI 解析入口：CLI / 接收方节点 调这里完成 LLM + judgment + harness
     // 入参: { text, mimeType, fileName, fromNodeId, source }
     // 出参: { summary, qualityScore, judgmentId?, gateArtifact? }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli.js",

package/src/agents/pi-sdk.ts

@@ -1178,6 +1178,7 @@ ${toolDefs}
       const reply = response.reply.trim();
 
       console.log(`[PiAgent] LLM 回复长度: ${reply.length}, 内容预览: "${reply.substring(0, 80)}..."`);
+      console.log(`[PiAgent] LLM 完整回复:\n${reply}`);
 
       // 通知前端：收到 LLM 回复
       if (onStream) {
@@ -1450,7 +1451,14 @@ Workspace root folder: ${this.cwd}
     const marker = '<final gen>';
     const markerIndex = content.indexOf(marker);
     if (markerIndex !== -1) {
-      content = content.substring(markerIndex + marker.length).trim();
+      const after = content.substring(markerIndex + marker.length).trim();
+      // v3 修复: 如果 <final gen> 之后是空, fallback 用 marker 之前的内容 (去掉 marker)
+      // 否则 LLM 写了 <final gen> 在末尾时, 用户看到空回复 + error
+      if (after) {
+        content = after;
+      } else {
+        content = content.substring(0, markerIndex).trim();
+      }
     }
     // 移除任何 tool call 标记
     let cleaned = content

package/src/llm/audio-config-store.ts

@@ -222,9 +222,14 @@ class AudioConfigStore {
         return { success: true, latency };
       } else {
         const errorText = await response.text().catch(() => 'Unknown error');
+        const hint = response.status === 401
+          ? '（请确认是 MiniMax 的 API Key）'
+          : response.status === 404
+          ? '（端点不存在 — 请检查 baseUrl）'
+          : '';
         return {
           success: false,
-          error: `HTTP ${response.status}: ${errorText.substring(0, 200)}`,
+          error: `HTTP ${response.status}: ${errorText.substring(0, 500)}${hint ? ' ' + hint : ''}`,
           latency
         };
       }

package/src/llm/config-store.ts

@@ -77,7 +77,7 @@ export const DEFAULT_PROVIDER_CONFIGS: Record<ModelProvider, ProviderConfig> = {
     enabled: false,
     apiKey: '',
     baseUrl: 'https://api.minimaxi.com/v1',
-    model: 'MiniMax-M2',
+    model: 'MiniMax-M3',
     temperature: 0.7,
     maxTokens: 4096,
     requiresApiKey: true
@@ -129,17 +129,22 @@ export const DEFAULT_PROVIDER_CONFIGS: Record<ModelProvider, ProviderConfig> = {
   }
 };
 
-export const PROVIDER_INFO: Record<ModelProvider, { name: string; description: string; requiresApiKey: boolean }> = {
-  openai: { name: 'OpenAI', description: 'GPT-4, GPT-3.5 等模型', requiresApiKey: true },
-  anthropic: { name: 'Anthropic', description: 'Claude 3.5 系列模型', requiresApiKey: true },
+export const PROVIDER_INFO: Record<ModelProvider, { name: string; description: string; requiresApiKey: boolean; models?: string[] }> = {
+  openai: { name: 'OpenAI', description: 'GPT-4, GPT-3.5 等模型', requiresApiKey: true, models: ['gpt-4', 'gpt-4o', 'gpt-4o-mini', 'gpt-4-turbo', 'gpt-3.5-turbo'] },
+  anthropic: { name: 'Anthropic', description: 'Claude 3.5 系列模型', requiresApiKey: true, models: ['claude-3-5-sonnet-20241022', 'claude-3-5-haiku-20241022', 'claude-3-opus-20240229'] },
   openrouter: { name: 'OpenRouter', description: '聚合多个 AI 供应商', requiresApiKey: true },
-  gemini: { name: 'Google Gemini', description: 'Gemini 系列模型', requiresApiKey: true },
+  gemini: { name: 'Google Gemini', description: 'Gemini 系列模型', requiresApiKey: true, models: ['gemini-2.0-flash', 'gemini-1.5-pro', 'gemini-1.5-flash'] },
   ollama: { name: 'Ollama', description: '本地 LLM 运行框架', requiresApiKey: false },
-  minimax: { name: 'MiniMax', description: '国产大模型服务', requiresApiKey: true },
-  deepseek: { name: 'DeepSeek', description: '深度求索大模型', requiresApiKey: true },
-  kimi: { name: 'Kimi (月之暗面)', description: 'Moonshot 长上下文模型', requiresApiKey: true },
-  glm: { name: 'GLM (智谱)', description: '智谱 ChatGLM 系列模型', requiresApiKey: true },
-  qwen: { name: 'Qwen (通义千问)', description: '阿里云通义千问系列', requiresApiKey: true },
+  minimax: {
+    name: 'MiniMax',
+    description: '国产大模型服务',
+    requiresApiKey: true,
+    models: ['MiniMax-M3', 'MiniMax-M2.7', 'MiniMax-M2', 'MiniMax-M2.1-highspeed', 'MiniMax-M2.7-highspeed']
+  },
+  deepseek: { name: 'DeepSeek', description: '深度求索大模型', requiresApiKey: true, models: ['deepseek-chat', 'deepseek-reasoner'] },
+  kimi: { name: 'Kimi (月之暗面)', description: 'Moonshot 长上下文模型', requiresApiKey: true, models: ['moonshot-v1-8k', 'moonshot-v1-32k', 'moonshot-v1-128k'] },
+  glm: { name: 'GLM (智谱)', description: '智谱 ChatGLM 系列模型', requiresApiKey: true, models: ['glm-4-flash', 'glm-4', 'glm-4-plus', 'glm-4-air', 'glm-4-airx'] },
+  qwen: { name: 'Qwen (通义千问)', description: '阿里云通义千问系列', requiresApiKey: true, models: ['qwen-plus', 'qwen-max', 'qwen-turbo', 'qwen-long'] },
   local: { name: '本地模型', description: '本地部署的模型服务', requiresApiKey: false }
 };
 
@@ -323,7 +328,12 @@ class LLMConfigStore {
         return { success: true, latency };
       } else {
         const errorText = await response.text().catch(() => 'Unknown error');
-        return { success: false, error: `HTTP ${response.status}: ${errorText.substring(0, 100)}`, latency };
+        const hint = response.status === 401
+          ? '（API Key 无效或不匹配该供应商 — 请检查是否复制完整、有无多余空格）'
+          : response.status === 404
+          ? '（端点不存在 — 请检查 baseUrl）'
+          : '';
+        return { success: false, error: `HTTP ${response.status}: ${errorText.substring(0, 500)}${hint ? ' ' + hint : ''}`, latency };
       }
     } catch (error: any) {
       return { success: false, error: error.message || 'Connection failed', latency: Date.now() - startTime };

package/src/llm/pi-ai.ts

@@ -176,7 +176,7 @@ export class PiAIModel {
       ollama: this.config.model || 'llama3.2',
       openrouter: this.config.model || 'anthropic/claude-3.5-sonnet',
       gemini: this.config.model || 'gemini-2.0-flash',
-      minimax: this.config.model || process.env.MINIMAX_MODEL || 'MiniMax-M2.7',
+      minimax: this.config.model || process.env.MINIMAX_MODEL || 'MiniMax-M3',
       deepseek: this.config.model || process.env.DEEPSEEK_MODEL || 'deepseek-chat',
       kimi: this.config.model || process.env.KIMI_MODEL || process.env.MOONSHOT_MODEL || 'moonshot-v1-8k',
       glm: this.config.model || process.env.GLM_MODEL || process.env.ZHIPU_MODEL || 'glm-4-flash',
@@ -482,7 +482,7 @@ function detectModel(provider: ModelProvider): string {
     ollama: 'llama3.2',
     openrouter: 'anthropic/claude-3.5-sonnet',
     gemini: 'gemini-2.0-flash',
-    minimax: 'MiniMax-M2.7',
+    minimax: 'MiniMax-M3',
     deepseek: 'deepseek-chat',
     kimi: 'moonshot-v1-8k',
     glm: 'glm-4-flash',

package/src/llm/video-config-store.ts

@@ -232,9 +232,15 @@ class VideoConfigStore {
         return { success: true, latency };
       } else {
         const errorText = await response.text().catch(() => 'Unknown error');
+        // 401 通常是 key 错误，给出针对性提示
+        const hint = response.status === 401
+          ? '（请确认是火山方舟 ARK 的 API Key，不是 MiniMax / 其他平台）'
+          : response.status === 404
+          ? '（端点不存在 — 火山方舟可能没有 /models，请检查 baseUrl）'
+          : '';
         return {
           success: false,
-          error: `HTTP ${response.status}: ${errorText.substring(0, 200)}`,
+          error: `HTTP ${response.status}: ${errorText.substring(0, 500)}${hint ? ' ' + hint : ''}`,
           latency
         };
       }

package/src/web/api-config.html

@@ -92,7 +92,8 @@
 
           <div class="form-group">
             <label>模型</label>
-            <input type="text" id="modelInput" placeholder="如 gpt-4">
+            <input type="text" id="modelInput" placeholder="如 gpt-4" list="modelSuggestList">
+            <datalist id="modelSuggestList"></datalist>
             <p class="form-hint" id="modelHint"></p>
           </div>
 
@@ -358,6 +359,17 @@
       document.getElementById('baseUrlInput').value = p.baseUrl || '';
       document.getElementById('modelInput').value = p.model || '';
 
+      // 填充模型下拉建议（仅 LLM 类型有 providerInfo.models）
+      const datalist = document.getElementById('modelSuggestList');
+      datalist.innerHTML = '';
+      if (type === 'llm' && i.models && Array.isArray(i.models)) {
+        for (const m of i.models) {
+          const opt = document.createElement('option');
+          opt.value = m;
+          datalist.appendChild(opt);
+        }
+      }
+
       // 视频/音频/LLM 专用字段显隐
       const isVideo = type === 'video';
       const isAudio = type === 'audio';