@huicai/cli 0.5.1 → 2026.710.0

package/bin/huicai.js

@@ -3,6 +3,7 @@
 
 import readline from 'node:readline';
 import path from 'node:path';
+import { createRequire } from 'node:module';
 import { c } from '../src/colors.js';
 import { loadConfig, saveConfig, CONFIG_PATH, DEFAULT_MODEL } from '../src/config.js';
 import { listModels, getAgentPersona, fetchUsage, listPlatformSkills, getPlatformSkill, pushPlatformSkill } from '../src/api.js';
@@ -12,7 +13,9 @@ import { buildSystemPrompt } from '../src/context.js';
 import * as sessions from '../src/session.js';
 import { loadLocalSkills, skillDirs, writeSkillToDir, readSkillDirForPush } from '../src/skills.js';
 
-const VERSION = '0.5.1';
+// 版本从 package.json 读取（versionDisplay 年月日展示式，与 VSCode 扩展、IDEA 插件一致）；勿手改，用 scripts/next-version.cjs
+const _pkg = createRequire(import.meta.url)('../package.json');
+const VERSION = _pkg.versionDisplay || _pkg.version;
 
 function parse(argv) {
   const flags = {};
@@ -51,6 +54,9 @@ function parse(argv) {
       case '--agent':
         flags.agent = argv[++i];
         break;
+      case '--consult':
+        flags.consult = argv[++i];
+        break;
       case '--project':
         flags.project = true;
         break;
@@ -119,6 +125,7 @@ ${c.bold('huicai')} — 终端智能体，以 HuiCai_AI 平台为模型后端，
   huicai sessions [-a]       列出历史会话（-a 跨目录全部）
   huicai login               浏览器授权登录（内置平台地址，无需输入网关）
   huicai login --paste       无浏览器环境：手动粘贴 API 令牌
+  huicai logout              退出登录（清除本机保存的令牌）
   huicai models              列出可用模型
   huicai usage               查看 Token 用量窗口（5小时/7天，按会员等级）
   huicai skills              列出本地 + 平台技能（Agent Skills）
@@ -129,6 +136,7 @@ ${c.bold('huicai')} — 终端智能体，以 HuiCai_AI 平台为模型后端，
 选项:
   -m, --model <id>       指定模型（覆盖配置）
   --agent <id>           采用平台智能体人格（分享令牌或 agent-xxx）
+  --consult <ref>        混合模式：本机驱动模型 + 平台智能体/工作流/数字人(agent-/workflow-/datahuman-xxx)作咨询工具
   -c, --continue         继续最近一次会话（当前目录）
   -r, --resume           选择并恢复历史会话（当前目录）
   --base <url>           覆盖内置平台地址（自建 / 联调用）
@@ -145,7 +153,8 @@ ${c.bold('huicai')} — 终端智能体，以 HuiCai_AI 平台为模型后端，
   -v, --version          版本
 
 交互技巧:
-  /help 查看命令 · @文件路径 引用文件内容 · !命令 直通 shell（输出进上下文）
+  /help 查看命令 · @文件 引用文件（PDF/Word/Excel 等自动解析为文本、图片作为视觉输入） · !命令 直通 shell（输出进上下文）
+  模型 -m auto 或 /model auto：按账号自动选择可用模型（与 VSCode 扩展一致）
   自定义命令：.huicai/commands/<名>.md（$ARGUMENTS 为参数占位符）
   权限规则：.huicai/settings.json {"permissions":{"allow":["run_bash(git *)"]}}
 
@@ -217,6 +226,16 @@ function validateAuth(config) {
   return null;
 }
 
+/** Auto 模型解析：按当前账号选一个可用的「原始渠道模型」（优先内置默认；伪模型不适合本机工具循环）。 */
+async function resolveAutoModel(config) {
+  try {
+    const models = await listModels(config.baseUrl, config.apiKey);
+    const raw = models.map((m) => m.id).filter((id) => !/^(agent|workflow|datahuman)-/.test(id));
+    if (raw.length) return raw.includes(DEFAULT_MODEL) ? DEFAULT_MODEL : raw[0];
+  } catch { /* 网络失败：回退内置默认 */ }
+  return DEFAULT_MODEL;
+}
+
 async function cmdModels(config) {
   const problem = validateAuth(config);
   if (problem) {
@@ -411,6 +430,11 @@ async function main() {
     await login(flags);
     return;
   }
+  if (sub === 'logout') {
+    saveConfig({ apiKey: '' });
+    process.stdout.write(c.green('已退出登录（已清除本机保存的令牌）。') + '\n');
+    return;
+  }
 
   const config = loadConfig();
   if (flags.base) config.baseUrl = flags.base.replace(/\/+$/, '');
@@ -460,6 +484,19 @@ async function main() {
     }
   }
 
+  // --consult：混合模式——把平台伪模型作为 consult_platform 工具（本机原始驱动 + 平台编排咨询）
+  if (flags.consult) {
+    if (!/^(agent|workflow|datahuman)-/.test(flags.consult)) {
+      process.stderr.write(c.red('--consult 需平台伪模型 id：agent-xxx / workflow-xxx / datahuman-xxx（分享码见分享窗口）') + '\n');
+      process.exit(1);
+    }
+    config.consult = flags.consult;
+    try {
+      const p = await getAgentPersona(config.baseUrl, config.apiKey, flags.consult);
+      if (p?.name) config.consultLabel = p.name;
+    } catch { /* 忽略：用 ref 作展示名 */ }
+  }
+
   // 恢复会话：resume <id> 子命令 / -r 选择器 / -c 最近一次
   let resumeId = null;
   let positionalPrompt = positional;
@@ -486,12 +523,20 @@ async function main() {
     config.model = session.model; // 恢复会话默认沿用其模型（-m/--agent 可覆盖）
   }
 
+  // Auto 模型（与 VSCode 扩展一致）：model 为空/auto，或混合模式下 model 仍是伪模型时，解析为可用的原始驱动模型
+  if (!config.model || config.model === 'auto'
+    || (config.consult && /^(agent|workflow|datahuman)-/.test(config.model))) {
+    config.model = await resolveAutoModel(config);
+  }
   if (!config.model) {
     process.stderr.write(
       c.red('未设置模型。用 `huicai -m <模型>`、`huicai login` 设置，或先 `huicai models` 查看可用模型。') + '\n',
     );
     process.exit(1);
   }
+  if (config.consult) {
+    process.stdout.write(c.gray(`已启用混合模式：本机驱动 ${config.model} + 咨询平台 ${config.consultLabel || config.consult}`) + '\n');
+  }
 
   // 新会话：用当前 cwd/persona 构建系统提示词（--system-prompt 完全替换、--append-system-prompt 追加）
   if (!session) {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@huicai/cli",
-  "version": "0.5.1",
+  "version": "2026.710.0",
+  "versionDisplay": "2026.07.10",
   "description": "在终端运行的智能体 CLI：以 HuiCai_AI 平台的 OpenAI 兼容 /v1 为模型后端，在用户本机执行文件/命令工具。",
   "type": "module",
   "bin": {
@@ -19,13 +20,15 @@
     "start": "node bin/huicai.js",
     "check": "node --check bin/huicai.js",
     "test": "node --test --test-concurrency=1 test/*.test.mjs",
+    "version:next": "node scripts/next-version.cjs",
     "prepublishOnly": "node --check bin/huicai.js"
   },
   "keywords": [
     "cli",
     "agent",
     "ai",
-    "terminal",    "huicai",
+    "terminal",
+    "huicai",
     "openai-compatible",
     "coding-agent"
   ],
@@ -34,8 +37,7 @@
   "homepage": "https://github.com/SJHT-SDK/huicai-cli/tree/master#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/SJHT-SDK/huicai-cli.git/",
-    "directory": "huicai-cli"
+    "url": "https://github.com/SJHT-SDK/huicai-cli.git"
   },
   "bugs": {
     "url": "https://github.com/SJHT-SDK/huicai-cli/issues"

package/src/banner.js

@@ -0,0 +1,83 @@
+// 启动欢迎横幅：渐变 ASCII 字标 + 上下文信息 + 快捷提示（对标 Claude CLI 进入时的欢迎屏）。
+// 零依赖；真彩(COLORTERM=truecolor)时走 24-bit 青→紫渐变，仅 16 色时退化为青色，NO_COLOR/非 TTY 输出朴素字标。
+
+import { c, colorEnabled } from './colors.js';
+
+// 5 行块字（每字形 5 列宽，字间 1 空格）。
+const FONT = {
+  H: ['█   █', '█   █', '█████', '█   █', '█   █'],
+  U: ['█   █', '█   █', '█   █', '█   █', '█████'],
+  I: ['█████', '  █  ', '  █  ', '  █  ', '█████'],
+  C: ['█████', '█    ', '█    ', '█    ', '█████'],
+  A: ['█████', '█   █', '█████', '█   █', '█   █'],
+  ' ': ['     ', '     ', '     ', '     ', '     '],
+};
+
+function wordmark(word) {
+  const rows = ['', '', '', '', ''];
+  [...word].forEach((ch, idx) => {
+    const g = FONT[ch] || FONT[' '];
+    for (let r = 0; r < 5; r++) rows[r] += (idx ? ' ' : '') + g[r];
+  });
+  return rows;
+}
+
+const truecolor = colorEnabled && /truecolor|24bit/i.test(process.env.COLORTERM || '');
+const lerp = (a, b, t) => Math.round(a + (b - a) * t);
+
+// 按列做水平渐变；无真彩退化为青色；无色原样返回。
+function gradientRow(row, from, to) {
+  if (!colorEnabled) return row;
+  const chars = [...row];
+  const n = chars.length;
+  let out = '';
+  for (let i = 0; i < n; i++) {
+    const ch = chars[i];
+    if (ch === ' ') { out += ' '; continue; }
+    if (!truecolor) { out += `\x1b[36m${ch}`; continue; }
+    const t = n <= 1 ? 0 : i / (n - 1);
+    out += `\x1b[38;2;${lerp(from[0], to[0], t)};${lerp(from[1], to[1], t)};${lerp(from[2], to[2], t)}m${ch}`;
+  }
+  return out + '\x1b[0m';
+}
+
+const PAD = '  ';
+const FROM = [0, 229, 255];  // 青
+const TO = [168, 85, 247];   // 紫
+
+/**
+ * 生成欢迎横幅字符串（不含结尾换行）。
+ * @param {object} p
+ * @param {string} p.model 当前模型 / 平台目标
+ * @param {string} p.cwd 工作目录
+ * @param {string} [p.version] 版本展示串
+ * @param {boolean} [p.platform] 是否平台伪模型（agent-/workflow-/datahuman-）
+ * @param {boolean} [p.yolo] 是否已开自动放行
+ * @param {string} [p.consult] 混合模式咨询目标展示名
+ * @param {boolean} [p.ink] 是否 ink 富终端（附注一行）
+ */
+export function renderWelcome({ model, cwd, version, platform, yolo, consult, ink } = {}) {
+  const cols = process.stdout.columns || 60;
+  const sep = c.gray('─'.repeat(Math.min(Math.max(cols - 2, 24), 50)));
+  const L = [''];
+
+  if (colorEnabled) {
+    for (const row of wordmark('HUICAI')) L.push(PAD + gradientRow(row, FROM, TO));
+  } else {
+    L.push(PAD + 'H U I C A I');
+  }
+
+  L.push('');
+  L.push(PAD + c.bold('HuiCai AI') + c.gray(' · 终端智能体') + (version ? c.gray('  v' + version) : '')
+    + (ink ? c.gray('  · ink') : ''));
+  L.push(PAD + sep);
+  L.push(PAD + c.gray(platform ? '目标  ' : '模型  ') + c.cyan(model || c.gray('(未设置，/model 设置)'))
+    + (platform ? c.gray('  · 平台编排（无本机工具）') : ''));
+  L.push(PAD + c.gray('目录  ') + cwd);
+  if (consult) L.push(PAD + c.gray('咨询  ') + c.magenta(consult) + c.gray('  · 混合模式（本机工具 + 平台咨询）'));
+  if (yolo) L.push(PAD + c.yellow('⚠ 自动放行(yolo) 已开：写文件/执行命令不再逐次确认'));
+  L.push('');
+  L.push(PAD + c.magenta('✦ ') + c.gray('/help 命令 · @文件 引用 · !命令 直通 shell · Ctrl+C 中断'));
+
+  return L.join('\n');
+}

package/src/commands.js

@@ -7,8 +7,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { execSync } from 'node:child_process';
-import { saveConfig } from './config.js';
-import { listModels } from './api.js';
+import { saveConfig, DEFAULT_MODEL } from './config.js';
+import { listModels, fetchUsage } from './api.js';
 import { listSessions, relTime, turnCount } from './session.js';
 import { compactNow } from './compaction.js';
 import { loadAllowRules } from './settings.js';
@@ -42,15 +42,25 @@ const BUILTINS = [
     },
   },
   {
-    name: 'model', args: '[名称]', desc: '查看或切换模型（带参数切换并保存）',
-    run(ctx, arg) {
-      if (arg) {
-        ctx.config.model = arg;
-        saveConfig({ model: arg });
-        ctx.print('已切换模型：' + arg);
-      } else {
+    name: 'model', args: '[名称|auto]', desc: '查看或切换模型（auto=按账号自动选可用模型，与 VSCode 一致）',
+    async run(ctx, arg) {
+      if (!arg) {
         ctx.print('当前模型：' + (ctx.config.model || '(未设置)'));
+        return;
+      }
+      if (arg === 'auto') {
+        try {
+          const models = await listModels(ctx.config.baseUrl, ctx.config.apiKey);
+          const raw = models.map((m) => m.id).filter((id) => !/^(agent|workflow|datahuman)-/.test(id));
+          ctx.config.model = (raw.includes(DEFAULT_MODEL) ? DEFAULT_MODEL : raw[0]) || ctx.config.model;
+        } catch { /* 拉取失败保持现值 */ }
+        saveConfig({ model: 'auto' }); // 保存 auto 偏好（下次启动重新解析），本会话用已解析的具体模型
+        ctx.print('Auto 已选：' + ctx.config.model);
+        return;
       }
+      ctx.config.model = arg;
+      saveConfig({ model: arg });
+      ctx.print('已切换模型：' + arg);
     },
   },
   {
@@ -64,6 +74,53 @@ const BUILTINS = [
       }
     },
   },
+  {
+    name: 'usage', desc: '查看 Token 用量窗口（5小时/7天，按会员等级）',
+    async run(ctx) {
+      const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : 0);
+      const fmt = (used, limit) => {
+        used = num(used);
+        limit = num(limit);
+        if (limit < 0) return `${used.toLocaleString()} / 无限`;
+        if (limit === 0) return '该档未开放';
+        return `${used.toLocaleString()} / ${limit.toLocaleString()} (${Math.min(100, Math.round((used / limit) * 100))}%)`;
+      };
+      try {
+        const u = await fetchUsage(ctx.config.baseUrl, ctx.config.apiKey);
+        if (!u || (typeof u.used5h !== 'number' && typeof u.used7d !== 'number')) {
+          ctx.print('平台未返回用量数据（请确认平台已支持 /v1/usage）。');
+          return;
+        }
+        ctx.print(`Token 用量窗口\n  近 5 小时：${fmt(u.used5h, u.limit5h)}\n  近 7 天　：${fmt(u.used7d, u.limit7d)}`
+          + (!u.allowed && u.message ? '\n  ' + u.message : ''));
+      } catch (e) {
+        ctx.print('拉取用量失败：' + e.message);
+      }
+    },
+  },
+  {
+    name: 'login', desc: '重新登录（浏览器授权；无浏览器请退出后 huicai login --paste）',
+    async run(ctx) {
+      try {
+        const { deviceLogin } = await import('./device.js');
+        ctx.print('正在打开浏览器授权…');
+        const key = await deviceLogin(ctx.config.baseUrl);
+        ctx.config.apiKey = key;
+        saveConfig({ apiKey: key });
+        ctx.print('登录成功。');
+      } catch (e) {
+        ctx.print('登录未完成：' + e.message + '（可退出后用 huicai login --paste 粘贴令牌）');
+      }
+    },
+  },
+  {
+    name: 'logout', desc: '退出登录（清除本机保存的令牌）',
+    run(ctx) {
+      ctx.config.apiKey = '';
+      saveConfig({ apiKey: '' });
+      ctx.print('已退出登录。后续对话需重新 /login 或 huicai login。');
+    },
+  },
   {
     name: 'clear', desc: '开启新会话（旧会话仍可 --resume 恢复）',
     run() {
@@ -160,6 +217,15 @@ const BUILTINS = [
       ctx.print(ctx.cwd);
     },
   },
+  {
+    name: 'markdown', desc: '切换助手回复的 Markdown 渲染（TUI 富文本；关闭则显示原始文本，便于复制）',
+    run(ctx) {
+      const next = ctx.config.markdown === false; // 当前关→开，否则→关
+      ctx.config.markdown = next;
+      saveConfig({ markdown: next });
+      ctx.print('Markdown 渲染：' + (next ? '开（下一条回复起生效）' : '关（显示原始 Markdown 文本）'));
+    },
+  },
   {
     name: 'init', desc: '让智能体调研项目并生成/完善 HUICAI.md',
     run() {

package/src/config.js

@@ -43,6 +43,8 @@ export function loadConfig() {
     memoryEnabled: process.env.HUICAI_MEMORY === '0' ? false : file.memory !== false,
     // 思考过程流式展示：默认开；配置 showReasoning:false 或 HUICAI_REASONING=0 关闭
     showReasoning: process.env.HUICAI_REASONING === '0' ? false : file.showReasoning !== false,
+    // 助手回复 Markdown 渲染（TUI 富文本）：默认开；配置 markdown:false 或 HUICAI_MARKDOWN=0 关闭（显示原始文本）
+    markdown: process.env.HUICAI_MARKDOWN === '0' ? false : file.markdown !== false,
     // 客户端来源标识（对话落库审计用）：默认 cli；VSCode 扩展进程内置 HUICAI_CLIENT=vscode
     client: (process.env.HUICAI_CLIENT || 'cli').trim().toLowerCase(),
   };

package/src/consult.js

@@ -0,0 +1,65 @@
+// 混合模式（对应 VSCode 扩展的「平台伪模型 + 工作区」）：把平台智能体/工作流/数字人作为「咨询工具」
+// 暴露给本机智能体循环。本机用原始驱动模型 + 本地工具（读写文件/执行命令/子智能体…），遇到平台目标擅长的问题
+// 调用 consult_platform——由平台侧编排作答（服务端知识库 RAG / 工具 / 联网），再用本机工具把结论落地到项目。
+
+import { streamChat } from './api.js';
+
+const PSEUDO = /^(agent|workflow|datahuman)-/;
+
+/** 平台伪模型 id → 中文类别名。 */
+function kindOf(ref) {
+  if (ref.startsWith('workflow-')) return '工作流';
+  if (ref.startsWith('datahuman-')) return '业务数字人';
+  return '智能体';
+}
+
+/**
+ * 构造 consult_platform 工具；未配置或 ref 非平台伪模型时返回 null。
+ * @param {object} p
+ * @param {object} p.config 运行配置（读时取最新；含 baseUrl/apiKey/consult/consultLabel/client/sessionId）
+ */
+export function makeConsultTool({ config }) {
+  const ref = config && config.consult;
+  if (!ref || !PSEUDO.test(String(ref))) return null;
+  const kind = kindOf(String(ref));
+  const label = config.consultLabel || ref;
+
+  const spec = {
+    type: 'function',
+    function: {
+      name: 'consult_platform',
+      description:
+        `咨询平台${kind}「${label}」：由平台侧编排作答（带其服务端知识库 RAG / 工具 / 联网检索）。`
+        + `遇到它擅长领域的问题优先调用它获取权威答复，再用本机工具把结论落地到项目。可多次调用。`,
+      parameters: {
+        type: 'object',
+        properties: {
+          query: { type: 'string', description: '自然语言的咨询 / 查询 / 运行输入' },
+        },
+        required: ['query'],
+      },
+    },
+  };
+
+  const run = async (args) => {
+    const q = String((args && args.query) || '').trim();
+    if (!q) return '需要提供 query（要咨询平台的自然语言问题 / 输入）';
+    try {
+      // 走平台伪模型 → 服务端编排；client/sessionId 使这轮咨询也计入对话审计
+      const r = await streamChat({
+        baseUrl: config.baseUrl,
+        apiKey: config.apiKey,
+        model: ref,
+        messages: [{ role: 'user', content: q }],
+        client: config.client,
+        sessionId: config.sessionId,
+      }, {});
+      return r.content || '(平台无返回)';
+    } catch (e) {
+      if (e && e.name === 'AbortError') throw e;
+      return `平台调用失败：${e.message}`;
+    }
+  };
+
+  return { readOnly: true, spec, run };
+}

package/src/input.js

@@ -8,24 +8,43 @@ import path from 'node:path';
 import os from 'node:os';
 import { CONFIG_DIR } from './config.js';
 import { runBash } from './executors.js';
+import { extractDocument } from './api.js';
 
 const MAX_MENTIONS = 5;
 const MENTION_FILE_CHARS = 12_000;
 const HISTORY_PATH = path.join(CONFIG_DIR, 'history.json');
 const HISTORY_CAP = 1000;
 
+/** 图片扩展名 → 作为多模态 image_url 附加。 */
+const IMAGE_MIME = {
+  png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif',
+  webp: 'image/webp', bmp: 'image/bmp', svg: 'image/svg+xml',
+};
+/** 文档扩展名 → 经平台 /v1/files/extract 解析为纯文本（与 VSCode 扩展附件同源）。 */
+const DOC_EXT = new Set(['pdf', 'doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx', 'rtf', 'odt', 'ods', 'odp', 'csv']);
+const MAX_IMAGE_BYTES = 8 * 1024 * 1024;
+const MAX_DOC_BYTES = 20 * 1024 * 1024;
+
 /**
  * 展开消息中的 @文件/@目录 引用：原文保留，内容以引用块追加在末尾（模型可见全文）。
  * @returns {{text:string, mentions:string[]}}
  */
-export function expandAtMentions(text, cwd) {
+export async function expandAtMentions(text, cwd, config = null) {
   const re = /(^|[\s("'`（【,，:：])@([~A-Za-z0-9_./\\-]+)/g;
   const seen = new Set();
-  const blocks = [];
+  const candidates = [];
   let m;
-  while ((m = re.exec(text)) && seen.size < MAX_MENTIONS) {
+  while ((m = re.exec(text)) && candidates.length < MAX_MENTIONS) {
     const raw = m[2].replace(/[.,;:。，；]+$/, ''); // 去句尾标点
-    if (!raw || seen.has(raw)) continue;
+    if (raw && !seen.has(raw)) {
+      seen.add(raw);
+      candidates.push(raw);
+    }
+  }
+  const blocks = [];
+  const images = []; // 多模态图片附件 {label, dataUri}
+  const mentions = [];
+  for (const raw of candidates) {
     const abs = raw.startsWith('~') ? path.join(os.homedir(), raw.slice(1)) : path.resolve(cwd, raw);
     let st;
     try {
@@ -33,7 +52,7 @@ export function expandAtMentions(text, cwd) {
     } catch {
       continue; // 不存在的路径按普通文本处理
     }
-    seen.add(raw);
+    mentions.push(raw);
     if (st.isDirectory()) {
       try {
         const entries = fs.readdirSync(abs).slice(0, 100).join('\n');
@@ -43,6 +62,42 @@ export function expandAtMentions(text, cwd) {
       }
       continue;
     }
+    const ext = path.extname(abs).slice(1).toLowerCase();
+    // 图片：作为多模态 image_url 附加（需当前模型支持视觉，或走平台伪模型的服务端识图）
+    if (IMAGE_MIME[ext]) {
+      if (st.size > MAX_IMAGE_BYTES) {
+        blocks.push(`【图片 @${raw}】（超过 ${Math.round(MAX_IMAGE_BYTES / 1048576)}MB，未附加）`);
+      } else {
+        try {
+          const b64 = fs.readFileSync(abs).toString('base64');
+          images.push({ label: raw, dataUri: `data:${IMAGE_MIME[ext]};base64,${b64}` });
+          blocks.push(`【已附加图片 @${raw}】`);
+        } catch {
+          /* ignore */
+        }
+      }
+      continue;
+    }
+    // 文档（PDF/Word/Excel/PPT/RTF…）：经平台 /v1/files/extract 解析为纯文本
+    if (DOC_EXT.has(ext)) {
+      if (!config || !config.baseUrl || !config.apiKey) {
+        blocks.push(`【文档 @${raw}】（需登录后才能解析为文本）`);
+      } else if (st.size > MAX_DOC_BYTES) {
+        blocks.push(`【文档 @${raw}】（超过 ${Math.round(MAX_DOC_BYTES / 1048576)}MB，未解析）`);
+      } else {
+        try {
+          const b64 = fs.readFileSync(abs).toString('base64');
+          const r = await extractDocument(config.baseUrl, config.apiKey,
+            { filename: path.basename(abs), data: b64, maxChars: 60_000 });
+          const meta = `${r.pages ? r.pages + '页·' : ''}${r.chars ?? 0}字${r.truncated ? '·已截断' : ''}`;
+          blocks.push(`【引用文档 @${raw}（${meta}）】\n${r.text || '（空）'}`);
+        } catch (e) {
+          blocks.push(`【文档 @${raw}】（解析失败：${e.message}）`);
+        }
+      }
+      continue;
+    }
+    // 其余：文本文件展开，二进制跳过
     if (st.size > 512 * 1024) {
       blocks.push(`【引用文件 @${raw}】\n（文件过大：${Math.round(st.size / 1024)}KB，未展开；可让我用 read_file 分段读取）`);
       continue;
@@ -60,8 +115,8 @@ export function expandAtMentions(text, cwd) {
       /* ignore */
     }
   }
-  if (!blocks.length) return { text, mentions: [] };
-  return { text: text + '\n\n' + blocks.join('\n\n'), mentions: [...seen] };
+  const outText = blocks.length ? text + '\n\n' + blocks.join('\n\n') : text;
+  return { text: outText, mentions, images };
 }
 
 function isBinary(buf) {
@@ -70,6 +125,15 @@ function isBinary(buf) {
   return false;
 }
 
+/** 组装用户消息 content：有图片附件则用 OpenAI 多模态数组，否则纯文本字符串。 */
+export function buildUserContent(text, images) {
+  if (!images || !images.length) return text;
+  return [
+    { type: 'text', text },
+    ...images.map((i) => ({ type: 'image_url', image_url: { url: i.dataUri } })),
+  ];
+}
+
 /**
  * 执行 !命令 直通：在 cwd 下跑 shell 命令，返回展示文本与写入对话的记录文本。
  * @returns {Promise<{output:string, record:string}>}

package/src/repl.js

@@ -8,9 +8,11 @@ import { runTurn } from './agent.js';
 import { createSession, saveSession, turnCount } from './session.js';
 import { loadMcpTools, closeMcp } from './mcp.js';
 import { makeSubagentTool } from './subagent.js';
+import { makeConsultTool } from './consult.js';
 import { runSlash } from './commands.js';
-import { expandAtMentions, runBangCommand, loadHistory, appendHistory } from './input.js';
+import { expandAtMentions, buildUserContent, runBangCommand, loadHistory, appendHistory } from './input.js';
 import { makeSkillTools } from './skills.js';
+import { renderWelcome } from './banner.js';
 
 /** 汇集动态工具：本地技能（load_skill）+ 本地 MCP 工具 + dispatch_agent 子智能体。返回 {extraTools, clients}。 */
 export async function buildExtraTools(config, cwd) {
@@ -24,22 +26,21 @@ export async function buildExtraTools(config, cwd) {
   const extraTools = [...makeSkillTools(cwd), ...mcp.tools];
   const dispatch = makeSubagentTool({ config, cwd, extraTools: mcp.tools, depth: 0 });
   if (dispatch) extraTools.push(dispatch);
+  // 混合模式：配置了 --consult 平台伪模型时，暴露 consult_platform 工具（本机驱动 + 平台编排咨询）
+  const consult = makeConsultTool({ config });
+  if (consult) extraTools.push(consult);
   return { extraTools, clients: mcp.clients };
 }
 
-function banner(config, cwd, permissions) {
-  process.stdout.write(c.bold(c.magenta('\n  huicai')) + c.gray(' · 终端智能体') + '\n');
-  const platform = /^(agent|workflow|datahuman)-/.test(String(config.model || ''));
-  process.stdout.write(
-    c.gray(`  ${platform ? '目标' : '模型'} ${config.model || '(未设置, /model 设置)'}`
-      + `${platform ? ' · 平台编排（分享页同款对话，无本机工具）' : ''} · 目录 ${cwd}`) + '\n',
-  );
-  process.stdout.write(
-    c.gray(
-      `  ${permissions.isYolo() ? '⚠ 自动放行(yolo) 已开 · ' : ''}` +
-      '/help 命令 · @文件 引用 · !命令 直通 shell · Ctrl+C 中断本回合',
-    ) + '\n',
-  );
+function banner(config, cwd, permissions, version) {
+  process.stdout.write(renderWelcome({
+    model: config.model,
+    cwd,
+    version,
+    platform: /^(agent|workflow|datahuman)-/.test(String(config.model || '')),
+    yolo: permissions.isYolo(),
+    consult: config.consult ? (config.consultLabel || config.consult) : null,
+  }) + '\n');
 }
 
 export async function startRepl({ config, cwd, yolo, initialPrompt, session, version }) {
@@ -62,14 +63,15 @@ export async function startRepl({ config, cwd, yolo, initialPrompt, session, ver
     else process.stdout.write('\n' + c.gray('输入 /exit 退出。') + '\n');
   });
 
-  banner(config, cwd, permissions);
+  banner(config, cwd, permissions, version);
   echoResumed(session);
   const { extraTools, clients } = await buildExtraTools(config, cwd); // 连接 MCP（若已配置）
 
   const doTurn = async (text) => {
-    const { text: expanded, mentions } = expandAtMentions(text, cwd);
-    if (mentions.length) process.stdout.write(c.gray('  · 已展开引用：' + mentions.join('、')) + '\n');
-    ctx.session.messages.push({ role: 'user', content: expanded });
+    const { text: expanded, mentions, images } = await expandAtMentions(text, cwd, config);
+    if (mentions.length) process.stdout.write(c.gray('  · 已展开引用：' + mentions.join('、')
+      + (images.length ? `（含 ${images.length} 张图片）` : '')) + '\n');
+    ctx.session.messages.push({ role: 'user', content: buildUserContent(expanded, images) });
     currentAbort = new AbortController();
     if (!ctx.session.compaction) ctx.session.compaction = {};
     config.sessionId = ctx.session.id; // 对话落库审计：当前会话号（/clear 换新会话后随之更新）
@@ -169,8 +171,8 @@ export async function runOnce({ config, cwd, yolo, prompt, session, persist, out
   const json = outputFormat === 'json';
   const permissions = createPermissions({ yolo, ask: null, cwd });
   const { extraTools, clients } = await buildExtraTools(config, cwd);
-  const { text: expanded } = expandAtMentions(prompt, cwd);
-  session.messages.push({ role: 'user', content: expanded });
+  const { text: expanded, images } = await expandAtMentions(prompt, cwd, config);
+  session.messages.push({ role: 'user', content: buildUserContent(expanded, images) });
   if (!session.compaction) session.compaction = {};
   config.sessionId = session.id; // 对话落库审计：会话号
   const r = await runTurn({

package/src/tui/app.js

@@ -10,15 +10,17 @@
 //
 // 仅在 TTY 且已安装 ink 时启用；未安装时 bin 回退到零依赖 readline REPL。
 
-import React, { useState, useRef, useReducer, useEffect } from 'react';
+import React, { useState, useRef, useReducer, useEffect, useMemo } from 'react';
 import { render, Box, Text, Static, useInput, useApp } from 'ink';
 import { runTurn } from '../agent.js';
 import { toolLabel } from '../render.js';
+import { renderMarkdown, looksLikeMarkdown } from '../markdown.js';
+import { renderWelcome } from '../banner.js';
 import { createSession, saveSession } from '../session.js';
 import { buildExtraTools } from '../repl.js';
 import { closeMcp } from '../mcp.js';
 import { runSlash } from '../commands.js';
-import { expandAtMentions, runBangCommand, loadHistory, appendHistory } from '../input.js';
+import { expandAtMentions, buildUserContent, runBangCommand, loadHistory, appendHistory } from '../input.js';
 import { loadAllowRules, matchAllowRules, suggestRule, addProjectAllowRule, riskWarning } from '../settings.js';
 
 const h = React.createElement;
@@ -60,6 +62,10 @@ function App({ config, cwd, session: initialSession, extraTools, yolo, initialPr
   const draftRef = useRef('');
 
   const [, force] = useReducer((x) => x + 1, 0);
+  // 定稿记录（logRef）变更计数：ink <Static> 靠 items「引用变化」识别新项，就地 push 同一数组它不会刷新
+  // （会导致轮末助手回复无后续渲染触发而丢失）。故每次 addLog 自增 logVer，据此派生「全新数组引用」交给 Static。
+  const [logVer, bumpLog] = useReducer((x) => x + 1, 0);
+  const [staticKey, setStaticKey] = useState(0); // /clear 时自增以重挂 Static，复位其内部已渲染索引
   const [status, setStatus] = useState('idle'); // idle | busy
   const [inp, setInp] = useState({ text: '', cursor: 0 });
   const [pending, setPending] = useState(null);
@@ -71,11 +77,15 @@ function App({ config, cwd, session: initialSession, extraTools, yolo, initialPr
 
   const addLog = (kind, text) => {
     logRef.current.push({ id: idRef.current++, kind, text });
-    force();
+    bumpLog(); // 变更定稿记录 → 触发 Static 用新数组引用刷新（见 logVer 说明）
   };
   const flushLive = () => {
     if (liveRef.current) {
-      addLog('assistant', liveRef.current);
+      // 定稿时把助手正文渲染为 Markdown（ink <Text> 原样保留内嵌 ANSI）；流式期间仍显示原文，完成即定稿为富文本。
+      // 纯散文（无 Markdown 结构）直接留原文，避免无谓处理与边角改动。
+      const raw = liveRef.current;
+      const md = config.markdown !== false && looksLikeMarkdown(raw);
+      addLog('assistant', md ? renderMarkdown(raw) : raw);
       liveRef.current = '';
     }
   };
@@ -139,14 +149,15 @@ function App({ config, cwd, session: initialSession, extraTools, yolo, initialPr
   };
 
   const pullQueued = () => {
+    // runTurn 同步回调：排队消息按原文注入（@ 文档/图片的异步展开只在主输入路径做，队列消息保留 @ 路径原文，模型可再 read_file）
     const q = queueRef.current.shift();
     setQueueLen(queueRef.current.length);
-    if (q == null) return null;
-    return expandAtMentions(q, cwd).text;
+    return q == null ? null : q;
   };
 
   const runUserTurn = async (text) => {
-    sessionRef.current.messages.push({ role: 'user', content: expandAtMentions(text, cwd).text });
+    const { text: expanded, images } = await expandAtMentions(text, cwd, config);
+    sessionRef.current.messages.push({ role: 'user', content: buildUserContent(expanded, images) });
     setBusy(true);
     abortRef.current = new AbortController();
     if (!sessionRef.current.compaction) sessionRef.current.compaction = {};
@@ -203,6 +214,7 @@ function App({ config, cwd, session: initialSession, extraTools, yolo, initialPr
       setCtxTok(0);
       logRef.current = [];
       liveRef.current = '';
+      setStaticKey((k) => k + 1); // 重挂 Static：复位其内部已渲染索引，新会话记录从头正常渲染
       addLog('info', '已开启新会话（旧会话仍可 --resume 恢复）');
     }
     if (r.prompt) {
@@ -360,7 +372,9 @@ function App({ config, cwd, session: initialSession, extraTools, yolo, initialPr
   });
 
   // ---- 渲染 ----
-  const logItems = logRef.current;
+  // 每当定稿记录变更（logVer）派生一个全新数组引用，Static 才能识别并渲染新追加项；
+  // 流式增量只调 force()（logVer 不变）→ 此处返回同一引用，Static 不重复刷历史记录。
+  const logItems = useMemo(() => logRef.current.slice(), [logVer]);
   const cwdName = cwd.split('/').filter(Boolean).pop() || cwd;
   const before = inp.text.slice(0, inp.cursor);
   const at = inp.text[inp.cursor] ?? ' ';
@@ -370,7 +384,7 @@ function App({ config, cwd, session: initialSession, extraTools, yolo, initialPr
     Box,
     { flexDirection: 'column' },
     // 已定稿记录（Static：只渲染一次，天然滚动）
-    h(Static, { items: logItems }, (item) => h(LogLine, { key: item.id, item })),
+    h(Static, { key: staticKey, items: logItems }, (item) => h(LogLine, { key: item.id, item })),
     // 思考过程（reasoning，流式、不入定稿记录）
     thinkRef.current
       ? h(Box, null, h(Text, { color: 'gray', italic: true }, '✦ 思考 ' + thinkRef.current.replace(/\n/g, ' ').slice(-160)))
@@ -458,7 +472,15 @@ function LogLine({ item }) {
  * 启动 ink TUI。先（在 ink 接管屏幕前）连接 MCP 并打印连接信息，再进入全屏界面；退出后关闭 MCP。
  */
 export async function runInk({ config, cwd, session, yolo, initialPrompt, version }) {
-  process.stdout.write(`\n  huicai · 终端智能体（ink TUI） · ${config.model}\n`);
+  process.stdout.write(renderWelcome({
+    model: config.model,
+    cwd,
+    version,
+    platform: /^(agent|workflow|datahuman)-/.test(String(config.model || '')),
+    yolo,
+    consult: config.consult ? (config.consultLabel || config.consult) : null,
+    ink: true,
+  }) + '\n');
   const { extraTools, clients } = await buildExtraTools(config, cwd);
   const { waitUntilExit } = render(
     h(App, { config, cwd, session, extraTools, yolo, initialPrompt, version, onExit: () => closeMcp(clients) }),