v0.7.25

- Fixed some shortcuts not working
- Reorganized menu display to improve aesthetics and responsiveness

Author: MayDay-wpf

.github/workflows/publish.yml

@@ -56,10 +56,8 @@ jobs:
 
             ### What's New
 
-            - Modify some incorrect prompt information
-            - Add secondary confirmation and quick delete to history record deletion
-            - Fix the bug of abnormal loading of history records when switching between welcome page and conversation page
-            - Add anti-status loss mechanism to sub-agent and team mode
+            - Fixed some shortcuts not working 
+            - Reorganized menu display to improve aesthetics and responsiveness
             
             ### Installation
             ```bash

package-lock.json

@@ -1,6 +1,6 @@
 {
 	"name": "snow-ai",
-	"version": "0.7.24",
+	"version": "0.7.25",
 	"description": "Agentic coding in your terminal",
 	"license": "MIT",
 	"bin": {
@@ -12,7 +12,11 @@
 		"ai",
 		"assistant",
 		"bot",
-		"terminal"
+		"terminal",
+		"ai coding",
+		"agentic",
+		"snow",
+		"snow cli"
 	],
 	"author": "Mufasa",
 	"repository": {

package.json

@@ -644,21 +644,20 @@ const Startup = ({
 			// Store for cleanup
 			(global as any).__deps = deps;
 
-			// Check for updates with timeout
-			const updateCheckPromise = VERSION
-				? checkForUpdates(VERSION)
-				: Promise.resolve();
-
-			// Race between update check and 3-second timeout
-			await Promise.race([
-				updateCheckPromise,
-				new Promise(resolve => setTimeout(resolve, 3000)),
-			]);
-
+			// Render the app immediately once dependencies are ready.
+			// The update check runs in the background to avoid blocking startup
+			// when the network is slow/unreachable. WelcomeScreen subscribes to
+			// onUpdateNotice and will render the notification UI once a result
+			// is available.
 			if (mounted) {
 				setAppComponent(() => deps.App);
 				setAppReady(true);
 			}
+
+			// Fire-and-forget update check — never block app entry on network IO.
+			if (VERSION) {
+				void checkForUpdates(VERSION);
+			}
 		};
 
 		init();
@@ -856,3 +855,8 @@ const mainInk = render(
 		patchConsole: true,
 	},
 );
+
+// Expose the Ink render handle so non-component code (e.g. the in-app
+// "Update Now" action in WelcomeScreen) can unmount Ink before handing the
+// terminal over to a child process such as `npm i -g snow-ai`.
+(global as any).__mainInk = mainInk;

source/cli.tsx

@@ -38,6 +38,9 @@ export const en: TranslationKeys = {
 		updateNoticeLatest: 'Latest',
 		updateNoticeRun: 'Run',
 		updateNoticeGithub: 'GitHub',
+		updateNow: 'Update Now',
+		updateNowInfo:
+			'Exit the CLI and run "npm i -g snow-ai" to upgrade to the latest version',
 		exit: 'Exit',
 		exitInfo: 'Exit the application',
 	},

source/i18n/lang/en.ts

@@ -35,6 +35,8 @@ export const zhTW: TranslationKeys = {
 		updateNoticeLatest: '最新版本',
 		updateNoticeRun: '更新指令',
 		updateNoticeGithub: '專案網址',
+		updateNow: '立即更新',
+		updateNowInfo: '退出 CLI 並執行 "npm i -g snow-ai" 升級到最新版本',
 		exit: '退出',
 		exitInfo: '退出應用程式',
 	},

source/i18n/lang/zh-TW.ts

@@ -35,6 +35,8 @@ export const zh: TranslationKeys = {
 		updateNoticeLatest: '最新版本',
 		updateNoticeRun: '更新命令',
 		updateNoticeGithub: '项目地址',
+		updateNow: '立即更新',
+		updateNowInfo: '退出 CLI 并执行 "npm i -g snow-ai" 升级到最新版本',
 		exit: '退出',
 		exitInfo: '退出应用程序',
 	},

source/i18n/lang/zh.ts

@@ -35,6 +35,8 @@ export type TranslationKeys = {
 		updateNoticeLatest: string;
 		updateNoticeRun: string;
 		updateNoticeGithub: string;
+		updateNow: string;
+		updateNowInfo: string;
 		exit: string;
 		exitInfo: string;
 	};

source/i18n/types.ts

@@ -83,43 +83,70 @@ export default function ChatHeader({
 	);
 }
 
+// 将 LOGO 字符串按可见字符数遮罩：未显示的可见字符替换为空格，换行保留，
+// 用于在保持布局稳定（行数/列宽不变）的前提下做"逐字显现"动画。
+// 当 revealChars 未传入或 >= 可见字符总数时，直接返回原始字符串。
+function maskRevealedChars(full: string, revealChars?: number): string {
+	if (revealChars === undefined) return full;
+	let visibleTotal = 0;
+	for (const ch of full) {
+		if (ch !== '\n') visibleTotal++;
+	}
+	if (revealChars >= visibleTotal) return full;
+	let result = '';
+	let revealed = 0;
+	for (const ch of full) {
+		if (ch === '\n') {
+			result += ch;
+		} else if (revealed < revealChars) {
+			result += ch;
+			revealed++;
+		} else {
+			result += ' ';
+		}
+	}
+	return result;
+}
+
 // Responsive ASCII art logo component for simple mode
 export function ChatHeaderLogo({
 	terminalWidth,
 	logoGradient,
 	hideCompact = false,
+	revealChars,
 }: {
 	terminalWidth: number;
 	logoGradient: [string, string, string];
 	// 当为 true 时，宽度过窄（< 20）不再回退到最小 LOGO，而是直接不渲染。
 	// 用于 WelcomeScreen 这种"位置紧张时宁可隐藏也不要降级展示"的场景。
 	hideCompact?: boolean;
+	// 控制 LOGO 已显示的可见字符数（不计换行）。未传入则始终完整显示。
+	// 用于 WelcomeScreen 入场时的一次性逐字符出现动画。
+	revealChars?: number;
 }) {
 	if (terminalWidth >= 30) {
 		// Full version: SNOW CLI with thin style (width >= 30)
+		const fullLogo = `╔═╗╔╗╔╔═╗╦ ╦  ╔═╗╦  ╦
+╚═╗║║║║ ║║║║  ║  ║  ║
+╚═╝╝╚╝╚═╝╚╩╝  ╚═╝╩═╝╩`;
 		return (
 			<Box flexDirection="column" marginBottom={0}>
 				<Gradient colors={logoGradient}>
-					<Text>
-						{`╔═╗╔╗╔╔═╗╦ ╦  ╔═╗╦  ╦
-╚═╗║║║║ ║║║║  ║  ║  ║
-╚═╝╝╚╝╚═╝╚╩╝  ╚═╝╩═╝╩`}
-					</Text>
+					<Text>{maskRevealedChars(fullLogo, revealChars)}</Text>
 				</Gradient>
 			</Box>
 		);
 	}
 
 	if (terminalWidth >= 20) {
 		// Medium version: SNOW only (width 20-29)
+		const mediumLogo = `╔═╗╔╗╔╔═╗╦ ╦
+╚═╗║║║║ ║║║║
+╚═╝╝╚╝╚═╝╚╩╝`;
 		return (
 			<Box flexDirection="column" marginBottom={0}>
 				<Gradient colors={logoGradient}>
-					<Text>
-						{`╔═╗╔╗╔╔═╗╦ ╦
-╚═╗║║║║ ║║║║
-╚═╝╝╚╝╚═╝╚╩╝`}
-					</Text>
+					<Text>{maskRevealedChars(mediumLogo, revealChars)}</Text>
 				</Gradient>
 			</Box>
 		);

source/ui/components/special/ChatHeader.tsx

@@ -17,6 +17,7 @@ import {getUpdateNotice, onUpdateNotice} from '../../utils/ui/updateNotice.js';
 import {useTheme} from '../contexts/ThemeContext.js';
 import UpdateNotice from '../components/common/UpdateNotice.js';
 import {useTerminalTitle} from '../../hooks/ui/useTerminalTitle.js';
+import {runUpdateAndExit} from '../../utils/core/runUpdate.js';
 
 // Lazy load all configuration screens for better startup performance
 const ConfigScreen = React.lazy(() => import('./ConfigScreen.js'));
@@ -46,6 +47,16 @@ const ThemeSettingsScreen = React.lazy(
 const HooksConfigScreen = React.lazy(() => import('./HooksConfigScreen.js'));
 const MCPConfigScreen = React.lazy(() => import('./MCPConfigScreen.js'));
 
+// 模块级标志：保证 SNOW CLI LOGO 的逐字符出现动画在整个进程生命周期内只播放一次。
+// 任何后续的重渲染（菜单切换返回、终端 resize 触发的 remount 等）都直接显示完整 LOGO，
+// 不会再次触发动画。
+let hasPlayedLogoRevealAnimation = false;
+// LOGO 完整版可见字符总数（3 行 × 21 字符 = 63），用作 reveal 的上限。
+// 中等版（36）小于该值，所以同一个 totalChars 也能让中等版提前完成动画。
+const LOGO_REVEAL_MAX_CHARS = 63;
+// 每个字符出现的间隔时间（毫秒），决定动画的整体速度。
+const LOGO_REVEAL_INTERVAL_MS = 10;
+
 type Props = {
 	version?: string;
 	onMenuSelect?: (value: string) => void;
@@ -85,6 +96,32 @@ export default function WelcomeScreen({
 	const {columns: terminalWidth} = useTerminalSize();
 	const {stdout} = useStdout();
 	const isInitialMount = useRef(true);
+
+	// LOGO 逐字符出现动画：
+	// - revealChars === undefined 表示动画已结束（或本次进程之前已播放过），完整显示。
+	// - 数字值表示当前可见的字符数，会从 0 递增到 LOGO_REVEAL_MAX_CHARS。
+	// 使用模块级 hasPlayedLogoRevealAnimation 保证只在首次进入时播放一次。
+	const [logoRevealChars, setLogoRevealChars] = useState<number | undefined>(
+		() => (hasPlayedLogoRevealAnimation ? undefined : 0),
+	);
+	useEffect(() => {
+		if (hasPlayedLogoRevealAnimation) return;
+		const interval = setInterval(() => {
+			setLogoRevealChars(prev => {
+				if (prev === undefined) return undefined;
+				const next = prev + 1;
+				if (next >= LOGO_REVEAL_MAX_CHARS) {
+					clearInterval(interval);
+					hasPlayedLogoRevealAnimation = true;
+					// 切换为 undefined 让 ChatHeaderLogo 直接渲染完整字符串，
+					// 后续重渲染不再走遮罩逻辑。
+					return undefined;
+				}
+				return next;
+			});
+		}, LOGO_REVEAL_INTERVAL_MS);
+		return () => clearInterval(interval);
+	}, []);
 	// 当终端宽度变化触发清屏时，先渲染为 null 一帧，把 ink/log-update 内部
 	// "上一帧"缓存重置为空字符串；下一帧再切回 false 恢复完整内容，
 	// 使新内容必然作为差异被完整写出，避免清屏后画面丢失。
@@ -113,6 +150,8 @@ export default function WelcomeScreen({
 		return unsubscribe;
 	}, []);
 
+	const hasUpdate = !!updateNotice;
+
 	const menuOptions = useMemo(
 		() => [
 			{
@@ -182,14 +221,27 @@ export default function WelcomeScreen({
 				value: 'theme',
 				infoText: t.welcome.themeSettingsInfo,
 			},
+			...(hasUpdate
+				? [
+						{
+							label: `${t.welcome.updateNow}${
+								updateNotice ? ` (v${updateNotice.latestVersion})` : ''
+							}`,
+							value: 'update-now',
+							color: '#FFD700',
+							infoText: t.welcome.updateNowInfo,
+							clearTerminal: true,
+						},
+				  ]
+				: []),
 			{
 				label: t.welcome.exit,
 				value: 'exit',
 				color: 'rgb(232, 131, 136)',
 				infoText: t.welcome.exitInfo,
 			},
 		],
-		[t],
+		[t, hasUpdate, updateNotice],
 	);
 
 	const [remountKey, setRemountKey] = useState(0);
@@ -250,6 +302,11 @@ export default function WelcomeScreen({
 				setInlineView('language-settings');
 			} else if (value === 'theme') {
 				setInlineView('theme-settings');
+			} else if (value === 'update-now') {
+				// Hand the terminal over to npm: unmount Ink and exec the update.
+				// runUpdateAndExit() does not return — the process exits when
+				// the npm child finishes.
+				runUpdateAndExit();
 			} else {
 				// Pass through to parent for other actions (chat, exit, etc.)
 				onMenuSelect?.(value);
@@ -335,6 +392,11 @@ export default function WelcomeScreen({
 	// 否则 ChatHeaderLogo 在 hideCompact 模式下会返回 null，留下一个空的右半区——
 	// 此时直接把整个圆角框让给 Menu 占满，不再做左右拆分。
 	const showLogoPane = logoColumnWidth >= 20;
+	// 当右侧 LOGO 走"完整最大版"分支（terminalWidth >= 30，对应这里 logoColumnWidth >= 30）
+	// 且存在更新提示时：把更新提示从顶部移到右侧 LOGO 下方，LOGO 区改为顶端对齐让 LOGO 上移，
+	// 这样在宽终端下能更紧凑地利用右半区的垂直空间。
+	const isFullLogoPane = showLogoPane && logoColumnWidth >= 30;
+	const showUpdateNoticeInLogoPane = isFullLogoPane && !!updateNotice;
 
 	// 调整终端宽度后清屏的中间帧：渲染为 null，强制 log-update 把上一帧缓存
 	// 重置为空字符串，下一帧的真实内容才能作为完整新内容被写出。
@@ -344,7 +406,7 @@ export default function WelcomeScreen({
 
 	return (
 		<Box flexDirection="column" width={terminalWidth} key={remountKey}>
-			{inlineView === 'menu' && updateNotice && (
+			{inlineView === 'menu' && updateNotice && !showUpdateNoticeInLogoPane && (
 				<UpdateNotice
 					currentVersion={updateNotice.currentVersion}
 					latestVersion={updateNotice.latestVersion}
@@ -389,21 +451,34 @@ export default function WelcomeScreen({
 									</Box>
 									<Box
 										flexDirection="column"
-										justifyContent="center"
+										justifyContent={
+											showUpdateNoticeInLogoPane ? 'flex-start' : 'center'
+										}
 										alignItems="center"
 										paddingX={2}
+										paddingY={showUpdateNoticeInLogoPane ? 1 : 0}
 										flexGrow={1}
 									>
 										<ChatHeaderLogo
 											terminalWidth={logoColumnWidth}
 											logoGradient={theme.colors.logoGradient}
 											hideCompact
+											revealChars={logoRevealChars}
 										/>
 										<Box marginTop={1}>
 											<Text color="gray" dimColor>
 												v{version} • {t.welcome.subtitle}
 											</Text>
 										</Box>
+										{showUpdateNoticeInLogoPane && updateNotice && (
+											<Box marginTop={1}>
+												<UpdateNotice
+													currentVersion={updateNotice.currentVersion}
+													latestVersion={updateNotice.latestVersion}
+													terminalWidth={logoColumnWidth}
+												/>
+											</Box>
+										)}
 									</Box>
 								</>
 							) : (