@coolkiller007/my-page-agent 0.1.13 → 0.1.15

package/dist/index.js

@@ -1,4 +1,4 @@
-(function() {	try {		if (typeof document != "undefined") {			var elementStyle = document.createElement("style");			elementStyle.appendChild(document.createTextNode("._wrapper_ur79v_1 {\n	position: fixed;\n	inset: 0;\n	z-index: 2147483641; /* 确保在所有元素之上，除了 Agent UI */\n	cursor: wait;\n	overflow: hidden;\n\n	display: none;\n}\n\n._wrapper_ur79v_1._visible_ur79v_11 {\n	display: block;\n}\n/* AI 光标样式 */\n._cursor_eh09s_2 {\n	position: absolute;\n	width: var(--cursor-size, 48px);\n	height: var(--cursor-size, 48px);\n	pointer-events: none;\n	z-index: 10000;\n}\n\n._cursorBorder_eh09s_10 {\n	position: absolute;\n	width: 100%;\n	height: 100%;\n	background: linear-gradient(45deg, rgb(57, 182, 255), rgb(189, 69, 251));\n	mask-image: url(\"data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%201024%201024'%20fill='none'%3e%3cpath%20d='M287.232%20128l514.752%20387.008L574.912%20576l149.376%20299.52-103.04%2051.392L472.32%20628.544l-185.856%20143.424z'%20stroke='%23000000'%20stroke-width='56'%20stroke-linejoin='miter'/%3e%3c/svg%3e\");\n	mask-size: 100% 100%;\n	mask-repeat: no-repeat;\n	margin-left: -16px;\n	margin-top: -7px;\n}\n\n._cursorFilling_eh09s_22 {\n	position: absolute;\n	width: 100%;\n	height: 100%;\n	background: url(\"data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%201024%201024'%3e%3cpath%20d='M287.232%20128l514.752%20387.008L574.912%20576l149.376%20299.52-103.04%2051.392L472.32%20628.544l-185.856%20143.424z'%20fill='%23ffffff'/%3e%3c/svg%3e\");\n	background-size: 100% 100%;\n	background-repeat: no-repeat;\n	margin-left: -16px;\n	margin-top: -7px;\n}\n\n._cursorRipple_eh09s_33 {\n	position: absolute;\n	width: 100%;\n	height: 100%;\n	pointer-events: none;\n	margin-left: -50%;\n	margin-top: -50%;\n\n	&::after {\n		content: '';\n		opacity: 0;\n		position: absolute;\n		inset: 0;\n		border: 4px solid rgba(57, 182, 255, 1);\n		border-radius: 50%;\n	}\n}\n\n._cursor_eh09s_2._clicking_eh09s_51 ._cursorRipple_eh09s_33::after {\n	animation: _cursor-ripple_eh09s_1 300ms ease-out forwards;\n}\n\n@keyframes _cursor-ripple_eh09s_1 {\n	0% {\n		transform: scale(0);\n		opacity: 1;\n	}\n	100% {\n		transform: scale(2);\n		opacity: 0;\n	}\n}\n._wrapper_h452n_1 {\n	position: fixed;\n	bottom: 100px;\n	left: 50%;\n	transform: translateX(-50%) translateY(20px);\n	opacity: 0;\n	z-index: 2147483642; /* 比 SimulatorMask 高一层 */\n	box-sizing: border-box;\n\n	/* 普通流布局：历史弹窗、面板依次纵向排列，靠子元素自身尺寸撑开，\n	 * 不再用 position:absolute + 手算偏移量拼位置（这套算法之前连续出过两次 bug：\n	 * 弹窗被状态条盖住、状态条运行态时下方角没跟着圆）。 */\n	display: flex;\n	flex-direction: column;\n	align-items: center;\n\n	* {\n		box-sizing: border-box;\n	}\n\n	/* 宽度取窗口 40%，用 clamp 防止超窄/超宽窗口下过小或过大 */\n	--width: clamp(280px, 40vw, 640px);\n	--height: 40px; /* 状态条高度 */\n	--input-height: 80px; /* 输入区高度 */\n	--border-radius: 16px;\n\n	--side-space: 12px; /* 控制栏两侧的间距 */\n	--history-width: calc(var(--width) - var(--side-space) * 2);\n\n	--color-1: rgb(57, 182, 255);\n	--color-2: rgb(189, 69, 251);\n	--color-3: rgb(255, 87, 51);\n	--color-4: rgb(255, 214, 0);\n\n	width: var(--width);\n\n	transition:\n		opacity 0.3s ease-in-out,\n		transform 0.3s ease-in-out;\n\n	/* 响应式设计 */\n	@media (max-width: 480px) {\n		width: calc(100vw - 40px);\n		--width: calc(100vw - 40px);\n	}\n}\n\n@keyframes _mask-running_h452n_1 {\n	from {\n		transform: translateX(-100%);\n	}\n	to {\n		transform: translateX(100%);\n	}\n}\n\n/* 状态条 + 输入区的面板容器；.background 光效挂在这一层，.panelInner 负责裁出圆角 */\n._panel_h452n_57 {\n	position: relative;\n	width: 100%;\n}\n\n._background_h452n_57 {\n	position: absolute;\n	inset: -2px;\n	border-radius: calc(var(--border-radius) + 4px);\n	filter: blur(4px);\n	overflow: hidden;\n	pointer-events: none;\n\n	&::before {\n		content: '';\n		pointer-events: none;\n		position: absolute;\n		width: 100%;\n		height: 100%;\n		left: 0;\n		top: 0;\n\n		background-image: linear-gradient(\n			to bottom left,\n			var(--color-1),\n			var(--color-2),\n			var(--color-1)\n		);\n		animation: _mask-running_h452n_1 2s linear infinite;\n	}\n	&::after {\n		content: '';\n		pointer-events: none;\n		position: absolute;\n		width: 100%;\n		height: 100%;\n		left: 0;\n		top: 0;\n\n		background-image: linear-gradient(\n			to bottom left,\n			var(--color-2),\n			var(--color-1),\n			var(--color-2)\n		);\n		animation: _mask-running_h452n_1 2s linear infinite;\n		animation-delay: 1s;\n	}\n}\n\n/* 面板可视区域：靠 overflow:hidden + border-radius 统一裁角，\n * header 单独存在（运行中输入区隐藏）或 header+输入区一起存在时，四角都自动是圆的，\n * 不用再像以前那样给 header 写一条\"输入区隐藏时补圆角\"的特判规则。 */\n._panelInner_h452n_57 {\n	position: relative;\n	display: flex;\n	flex-direction: column;\n	overflow: hidden;\n	border-radius: var(--border-radius);\n	border: 2px solid rgba(255, 255, 255, 0.4);\n	box-shadow:\n		0 0 5px 1px rgba(255, 255, 255, 0.3),\n		0 4px 20px rgba(0, 0, 0, 0.5);\n}\n\n/* 控制栏 */\n._header_h452n_124 {\n	display: flex;\n	align-items: center;\n	justify-content: space-between;\n	padding: 8px 12px;\n	user-select: none;\n\n	height: var(--height);\n	flex-shrink: 0; /* 防止 header 被压缩 */\n\n	cursor: pointer;\n\n	background: rgba(0, 0, 0, 0.5);\n	backdrop-filter: blur(10px);\n	background-clip: padding-box;\n\n	._statusSection_h452n_140 {\n		display: flex;\n		align-items: center;\n		gap: 8px;\n		flex: 1;\n		min-height: 24px; /* 确保垂直居中 */\n\n		._indicator_h452n_147 {\n			width: 6px;\n			height: 6px;\n			border-radius: 50%;\n			background: rgba(255, 255, 255, 0.5);\n			flex-shrink: 0;\n			animation: none; /* 默认无动画 */\n\n			/* 运行状态 - 有动画 */\n			&._thinking_h452n_156 {\n				background: rgb(57, 182, 255);\n				animation: _pulse_h452n_1 0.8s ease-in-out infinite;\n			}\n\n			&._tool_executing_h452n_161 {\n				background: rgb(189, 69, 251);\n				animation: _pulse_h452n_1 0.6s ease-in-out infinite;\n			}\n\n			&._retry_h452n_166 {\n				background: rgb(255, 214, 0);\n				animation: _retryPulse_h452n_1 1s ease-in-out infinite;\n			}\n\n			/* 静止状态 - 无动画 */\n			&._completed_h452n_172,\n			&._input_h452n_173,\n			&._output_h452n_174 {\n				background: rgb(34, 197, 94);\n				animation: none;\n			}\n\n			&._error_h452n_179 {\n				background: rgb(239, 68, 68);\n				animation: none;\n			}\n		}\n\n		._statusText_h452n_185 {\n			color: white;\n			font-size: 12px;\n			line-height: 1;\n			font-weight: 500;\n			transition: all 0.3s ease-in-out;\n			position: relative;\n			overflow: hidden;\n			display: flex;\n			align-items: center;\n			min-height: 24px; /* 确保垂直居中 */\n\n			&._fadeOut_h452n_197 {\n				animation: _statusTextFadeOut_h452n_1 0.3s ease forwards;\n			}\n\n			&._fadeIn_h452n_201 {\n				animation: _statusTextFadeIn_h452n_1 0.3s ease forwards;\n			}\n		}\n	}\n\n	._controls_h452n_207 {\n		display: flex;\n		align-items: center;\n		gap: 4px;\n\n		._controlButton_h452n_212 {\n			width: 24px;\n			height: 24px;\n			border: none;\n			border-radius: 4px;\n			background: rgba(255, 255, 255, 0.1);\n			color: white;\n			cursor: pointer;\n			display: flex;\n			align-items: center;\n			justify-content: center;\n			font-size: 12px;\n			line-height: 1;\n\n			&:hover {\n				background: rgba(255, 255, 255, 0.2);\n			}\n		}\n\n		._stopButton_h452n_231 {\n			background: rgba(239, 68, 68, 0.2);\n			color: rgb(255, 41, 41);\n			font-weight: 600;\n\n			&:hover {\n				background: rgba(239, 68, 68, 0.3);\n			}\n		}\n	}\n}\n\n@keyframes _statusTextFadeIn_h452n_1 {\n	0% {\n		opacity: 0;\n		transform: translateY(5px);\n	}\n	100% {\n		opacity: 1;\n		transform: translateY(0);\n	}\n}\n\n@keyframes _statusTextFadeOut_h452n_1 {\n	0% {\n		opacity: 1;\n		transform: translateY(0);\n	}\n	100% {\n		opacity: 0;\n		transform: translateY(-5px);\n	}\n}\n\n/* 历史记录弹窗：普通流里排在面板前面（视觉上在上方），默认收起为 0 高度，\n * 展开时靠 JS 量出的真实内容高度做 max-height 动画（不用固定封顶值），\n * 撑开多高、要不要出现，跟面板本身完全无关，不用再算\"面板一共多高、弹窗该挂在哪个 bottom 偏移\"。 */\n._historySectionWrapper_h452n_268 {\n	width: 100%;\n	overflow: hidden;\n	max-height: 0;\n	margin-bottom: 0;\n\n	background: rgba(2, 0, 20, 0.5);\n	backdrop-filter: blur(10px);\n\n	text-shadow: 0 0 1px rgba(0, 0, 0, 0.2);\n\n	border-radius: calc(var(--border-radius) + 4px);\n	border: 0 solid rgba(255, 255, 255, 0);\n	box-shadow: 0 4px 16px rgba(0, 0, 0, 0);\n\n	transition:\n		max-height 0.2s,\n		margin-bottom 0.2s,\n		border-width 0.2s,\n		border-color 0.2s,\n		box-shadow 0.2s;\n\n	._wrapper_h452n_1._expanded_h452n_290 & {\n		margin-bottom: 8px;\n		border-width: 2px;\n		border-color: rgba(255, 255, 255, 0.4);\n		box-shadow: 0 4px 16px rgba(0, 0, 0, 0.6);\n	}\n\n	._historySection_h452n_268 {\n		max-height: min(\n			500px,\n			calc(100vh - 200px - var(--height))\n		); /* 列表本身的滚动上限，跟展开/收起动画解耦 */\n		overflow-y: auto;\n		overscroll-behavior: contain;\n		scrollbar-width: none;\n		/* 底部留白用 padding 撑，不依赖最后一项 margin-bottom：\n		 * overflow:auto 容器会裁掉末尾子元素的 margin，导致最后一条记录贴底 */\n		padding: 8px;\n\n		._historyItem_h452n_309 {\n			/* backdrop-filter: blur(10px); */\n			padding: 8px 10px;\n			margin-bottom: 8px;\n			background: linear-gradient(135deg, rgba(255, 255, 255, 0.08), rgba(255, 255, 255, 0.03));\n			border-radius: 8px;\n			border-left: 2px solid rgba(57, 182, 255, 0.5);\n			font-size: 12px;\n			color: white;\n			/* color: black; */\n			line-height: 1.3;\n			position: relative;\n			overflow: hidden;\n\n			/* 微妙的内阴影 */\n			box-shadow:\n				0 1px 0 rgba(255, 255, 255, 0.1),\n				0 1px 3px rgba(0, 0, 0, 0.1);\n\n			&::before {\n				content: '';\n				position: absolute;\n				top: 0;\n				left: 0;\n				right: 0;\n				height: 1px;\n				background: linear-gradient(90deg, transparent, rgba(255, 255, 255, 0.2), transparent);\n			}\n\n			&:hover {\n				background: linear-gradient(135deg, rgba(255, 255, 255, 0.12), rgba(255, 255, 255, 0.06));\n				/* transform: translateY(-1px); */\n				box-shadow:\n					inset 0 1px 0 rgba(255, 255, 255, 0.15),\n					0 2px 4px rgba(0, 0, 0, 0.15);\n			}\n\n			&._completed_h452n_172,\n			&._input_h452n_173,\n			&._output_h452n_174 {\n				border-left-color: rgb(34, 197, 94);\n				background: linear-gradient(135deg, rgba(34, 197, 94, 0.1), rgba(34, 197, 94, 0.05));\n			}\n\n			&._error_h452n_179 {\n				border-left-color: rgb(239, 68, 68);\n				background: linear-gradient(135deg, rgba(239, 68, 68, 0.1), rgba(239, 68, 68, 0.05));\n			}\n\n			&._retry_h452n_166 {\n				border-left-color: rgb(255, 214, 0);\n				background: linear-gradient(135deg, rgba(255, 214, 0, 0.1), rgba(255, 214, 0, 0.05));\n			}\n\n			&._observation_h452n_363 {\n				border-left-color: rgb(147, 51, 234);\n				background: linear-gradient(135deg, rgba(147, 51, 234, 0.1), rgba(147, 51, 234, 0.05));\n			}\n\n			&._question_h452n_368 {\n				border-left-color: rgb(255, 159, 67);\n				background: linear-gradient(135deg, rgba(255, 159, 67, 0.15), rgba(255, 159, 67, 0.08));\n			}\n\n			/* 突出显示 done 成功结果 */\n			&._doneSuccess_h452n_374 {\n				background: linear-gradient(\n					135deg,\n					rgba(34, 197, 94, 0.25),\n					rgba(34, 197, 94, 0.15),\n					rgba(34, 197, 94, 0.08)\n				);\n				border: none;\n				border-left: 2px solid rgb(34, 197, 94);\n				box-shadow:\n					0 4px 12px rgba(34, 197, 94, 0.3),\n					inset 0 1px 0 rgba(255, 255, 255, 0.2),\n					0 0 20px rgba(34, 197, 94, 0.1);\n				font-weight: 600;\n				color: rgb(220, 252, 231);\n				padding: 10px 12px;\n				margin-bottom: 8px;\n				border-radius: 8px;\n				position: relative;\n				overflow: hidden;\n\n				&::before {\n					background: linear-gradient(90deg, transparent, rgba(34, 197, 94, 0.4), transparent);\n				}\n\n				&::after {\n					content: '';\n					position: absolute;\n					top: 0;\n					left: -100%;\n					width: 100%;\n					height: 100%;\n					background: linear-gradient(90deg, transparent, rgba(255, 255, 255, 0.1), transparent);\n					animation: _shimmer_h452n_1 2s ease-in-out infinite;\n				}\n\n				._historyContent_h452n_410 {\n					._statusIcon_h452n_411 {\n						font-size: 16px;\n						animation: _celebrate_h452n_1 0.8s ease-in-out;\n						filter: drop-shadow(0 2px 4px rgba(34, 197, 94, 0.5));\n					}\n				}\n			}\n\n			/* 突出显示 done 失败结果 */\n			&._doneError_h452n_420 {\n				background: linear-gradient(\n					135deg,\n					rgba(239, 68, 68, 0.25),\n					rgba(239, 68, 68, 0.15),\n					rgba(239, 68, 68, 0.08)\n				);\n				border: none;\n				border-left: 2px solid rgb(239, 68, 68);\n				box-shadow:\n					0 4px 12px rgba(239, 68, 68, 0.3),\n					inset 0 1px 0 rgba(255, 255, 255, 0.2),\n					0 0 20px rgba(239, 68, 68, 0.1);\n				font-weight: 600;\n				color: rgb(254, 226, 226);\n				padding: 10px 12px;\n				margin-bottom: 8px;\n				border-radius: 8px;\n				position: relative;\n				overflow: hidden;\n\n				&::before {\n					background: linear-gradient(90deg, transparent, rgba(239, 68, 68, 0.4), transparent);\n				}\n\n				._historyContent_h452n_410 {\n					._statusIcon_h452n_411 {\n						font-size: 16px;\n						filter: drop-shadow(0 2px 4px rgba(239, 68, 68, 0.5));\n					}\n				}\n			}\n\n			._historyContent_h452n_410 {\n				display: flex;\n				align-items: center;\n				gap: 8px;\n\n				word-break: break-all;\n				white-space: pre-wrap;\n\n				/* overflow-x: auto; */\n\n				._statusIcon_h452n_411 {\n					font-size: 12px;\n					flex-shrink: 0;\n					line-height: 1;\n					transition: all 0.3s ease;\n				}\n\n				._reflectionLines_h452n_470 {\n					display: flex;\n					flex-direction: column;\n					gap: 4px;\n				}\n			}\n\n			._historyMeta_h452n_477 {\n				font-size: 10px;\n				color: rgba(255, 255, 255, 0.6);\n				/* color: rgb(61, 61, 61); */\n				margin-top: 8px;\n				line-height: 1;\n			}\n		}\n	}\n}\n\n/* 动画关键帧 - 更快的闪烁 */\n@keyframes _pulse_h452n_1 {\n	0%,\n	100% {\n		opacity: 1;\n		transform: scale(1);\n	}\n	50% {\n		opacity: 0.4;\n		transform: scale(1.3);\n	}\n}\n\n/* 重试动画 - 旋转脉冲 */\n@keyframes _retryPulse_h452n_1 {\n	0%,\n	100% {\n		opacity: 1;\n		transform: scale(1) rotate(0deg);\n	}\n	25% {\n		opacity: 0.6;\n		transform: scale(1.2) rotate(90deg);\n	}\n	50% {\n		opacity: 0.8;\n		transform: scale(1.1) rotate(180deg);\n	}\n	75% {\n		opacity: 0.6;\n		transform: scale(1.2) rotate(270deg);\n	}\n}\n\n/* 庆祝动画 */\n@keyframes _celebrate_h452n_1 {\n	0%,\n	100% {\n		transform: scale(1);\n	}\n	25% {\n		transform: scale(1.2) rotate(-5deg);\n	}\n	75% {\n		transform: scale(1.2) rotate(5deg);\n	}\n}\n\n/* done 卡片的光泽效果 */\n@keyframes _shimmer_h452n_1 {\n	0% {\n		left: -100%;\n	}\n	100% {\n		left: 100%;\n	}\n}\n\n/* 输入区域样式 */\n._inputSectionWrapper_h452n_547 {\n	width: 100%;\n	margin: 0 auto;\n\n	overflow: hidden;\n	height: var(--input-height);\n\n	transition: height 0.2s;\n\n	/* 与 header 保持同色调，让面板看起来是一体的深色玻璃卡片 */\n	background: rgba(0, 0, 0, 0.4);\n	backdrop-filter: blur(10px);\n\n	border-bottom-left-radius: calc(var(--border-radius) + 4px);\n	border-bottom-right-radius: calc(var(--border-radius) + 4px);\n\n	&._hidden_h452n_563 {\n		height: 0;\n	}\n\n	._inputSection_h452n_547 {\n		display: flex;\n		align-items: center;\n		gap: 8px;\n		height: 100%;\n		padding: 8px; /* 与上方状态条 padding 保持一致 */\n\n		._taskInput_h452n_574 {\n			flex: 1;\n			height: 100%;\n			background: rgba(255, 255, 255, 0.08);\n			border: 1px solid rgba(255, 255, 255, 0.15);\n			border-radius: 12px;\n			padding: 8px 14px;\n			color: rgb(240, 240, 245);\n			font-family: inherit;\n			font-size: 14px;\n			line-height: 1.4;\n			outline: none;\n			resize: none;\n			overflow-y: auto;\n			transition: all 0.2s ease;\n\n			&::placeholder {\n				color: rgba(255, 255, 255, 0.45);\n			}\n\n			&:focus {\n				background: rgba(255, 255, 255, 0.14);\n				border-color: rgba(57, 182, 255, 0.6);\n				box-shadow: 0 0 0 2px rgba(57, 182, 255, 0.2);\n			}\n		}\n	}\n}\n/*$vite$:1*/"));			document.head.appendChild(elementStyle);		}	} catch (e) {		console.error("vite-plugin-css-injected-by-js", e);	}})();
+(function() {	try {		if (typeof document != "undefined") {			var elementStyle = document.createElement("style");			elementStyle.appendChild(document.createTextNode("._wrapper_ur79v_1 {\n	position: fixed;\n	inset: 0;\n	z-index: 2147483641; /* 确保在所有元素之上，除了 Agent UI */\n	cursor: wait;\n	overflow: hidden;\n\n	display: none;\n}\n\n._wrapper_ur79v_1._visible_ur79v_11 {\n	display: block;\n}\n/* AI 光标样式 */\n._cursor_eh09s_2 {\n	position: absolute;\n	width: var(--cursor-size, 48px);\n	height: var(--cursor-size, 48px);\n	pointer-events: none;\n	z-index: 10000;\n}\n\n._cursorBorder_eh09s_10 {\n	position: absolute;\n	width: 100%;\n	height: 100%;\n	background: linear-gradient(45deg, rgb(57, 182, 255), rgb(189, 69, 251));\n	mask-image: url(\"data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%201024%201024'%20fill='none'%3e%3cpath%20d='M287.232%20128l514.752%20387.008L574.912%20576l149.376%20299.52-103.04%2051.392L472.32%20628.544l-185.856%20143.424z'%20stroke='%23000000'%20stroke-width='56'%20stroke-linejoin='miter'/%3e%3c/svg%3e\");\n	mask-size: 100% 100%;\n	mask-repeat: no-repeat;\n	margin-left: -16px;\n	margin-top: -7px;\n}\n\n._cursorFilling_eh09s_22 {\n	position: absolute;\n	width: 100%;\n	height: 100%;\n	background: url(\"data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%201024%201024'%3e%3cpath%20d='M287.232%20128l514.752%20387.008L574.912%20576l149.376%20299.52-103.04%2051.392L472.32%20628.544l-185.856%20143.424z'%20fill='%23ffffff'/%3e%3c/svg%3e\");\n	background-size: 100% 100%;\n	background-repeat: no-repeat;\n	margin-left: -16px;\n	margin-top: -7px;\n}\n\n._cursorRipple_eh09s_33 {\n	position: absolute;\n	width: 100%;\n	height: 100%;\n	pointer-events: none;\n	margin-left: -50%;\n	margin-top: -50%;\n\n	&::after {\n		content: '';\n		opacity: 0;\n		position: absolute;\n		inset: 0;\n		border: 4px solid rgba(57, 182, 255, 1);\n		border-radius: 50%;\n	}\n}\n\n._cursor_eh09s_2._clicking_eh09s_51 ._cursorRipple_eh09s_33::after {\n	animation: _cursor-ripple_eh09s_1 300ms ease-out forwards;\n}\n\n@keyframes _cursor-ripple_eh09s_1 {\n	0% {\n		transform: scale(0);\n		opacity: 1;\n	}\n	100% {\n		transform: scale(2);\n		opacity: 0;\n	}\n}\n._wrapper_18lru_1 {\n	position: fixed;\n	bottom: 100px;\n	left: 50%;\n	transform: translateX(-50%) translateY(20px);\n	opacity: 0;\n	z-index: 2147483642; /* 比 SimulatorMask 高一层 */\n	box-sizing: border-box;\n\n	/* 普通流布局：历史弹窗、面板依次纵向排列，靠子元素自身尺寸撑开，\n	 * 不再用 position:absolute + 手算偏移量拼位置（这套算法之前连续出过两次 bug：\n	 * 弹窗被状态条盖住、状态条运行态时下方角没跟着圆）。 */\n	display: flex;\n	flex-direction: column;\n	align-items: center;\n\n	* {\n		box-sizing: border-box;\n	}\n\n	/* 宽度取窗口 40%，用 clamp 防止超窄/超宽窗口下过小或过大 */\n	--width: clamp(280px, 40vw, 640px);\n	--height: 40px; /* 状态条高度 */\n	--input-height: 80px; /* 输入区高度 */\n	--border-radius: 16px;\n\n	--side-space: 12px; /* 控制栏两侧的间距 */\n	--history-width: calc(var(--width) - var(--side-space) * 2);\n\n	--color-1: rgb(57, 182, 255);\n	--color-2: rgb(189, 69, 251);\n	--color-3: rgb(255, 87, 51);\n	--color-4: rgb(255, 214, 0);\n\n	width: var(--width);\n\n	transition:\n		opacity 0.3s ease-in-out,\n		transform 0.3s ease-in-out;\n\n	/* 响应式设计 */\n	@media (max-width: 480px) {\n		width: calc(100vw - 40px);\n		--width: calc(100vw - 40px);\n	}\n}\n\n@keyframes _mask-running_18lru_1 {\n	from {\n		transform: translateX(-100%);\n	}\n	to {\n		transform: translateX(100%);\n	}\n}\n\n/* 状态条 + 输入区的外层容器；.background 光效挂在这一层，.shellInner 负责裁出圆角 */\n._shell_18lru_57 {\n	position: relative;\n	width: 100%;\n}\n\n._background_18lru_57 {\n	position: absolute;\n	inset: -2px;\n	border-radius: calc(var(--border-radius) + 4px);\n	filter: blur(4px);\n	overflow: hidden;\n	pointer-events: none;\n\n	&::before {\n		content: '';\n		pointer-events: none;\n		position: absolute;\n		width: 100%;\n		height: 100%;\n		left: 0;\n		top: 0;\n\n		background-image: linear-gradient(\n			to bottom left,\n			var(--color-1),\n			var(--color-2),\n			var(--color-1)\n		);\n		animation: _mask-running_18lru_1 2s linear infinite;\n	}\n	&::after {\n		content: '';\n		pointer-events: none;\n		position: absolute;\n		width: 100%;\n		height: 100%;\n		left: 0;\n		top: 0;\n\n		background-image: linear-gradient(\n			to bottom left,\n			var(--color-2),\n			var(--color-1),\n			var(--color-2)\n		);\n		animation: _mask-running_18lru_1 2s linear infinite;\n		animation-delay: 1s;\n	}\n}\n\n/* 可视区域：靠 overflow:hidden + border-radius 统一裁角，\n * header 单独存在（运行中输入区隐藏）或 header+输入区一起存在时，四角都自动是圆的，\n * 不用再像以前那样给 header 写一条\"输入区隐藏时补圆角\"的特判规则。 */\n._shellInner_18lru_57 {\n	position: relative;\n	display: flex;\n	flex-direction: column;\n	overflow: hidden;\n	border-radius: var(--border-radius);\n	border: 2px solid rgba(255, 255, 255, 0.4);\n	box-shadow:\n		0 0 5px 1px rgba(255, 255, 255, 0.3),\n		0 4px 20px rgba(0, 0, 0, 0.5);\n}\n\n/* 控制栏 */\n._header_18lru_124 {\n	display: flex;\n	align-items: center;\n	justify-content: space-between;\n	padding: 8px 12px;\n	user-select: none;\n\n	height: var(--height);\n	flex-shrink: 0; /* 防止 header 被压缩 */\n\n	cursor: pointer;\n\n	background: rgba(0, 0, 0, 0.5);\n	backdrop-filter: blur(10px);\n	background-clip: padding-box;\n\n	._statusSection_18lru_140 {\n		display: flex;\n		align-items: center;\n		gap: 8px;\n		flex: 1;\n		min-height: 24px; /* 确保垂直居中 */\n\n		._indicator_18lru_147 {\n			width: 6px;\n			height: 6px;\n			border-radius: 50%;\n			background: rgba(255, 255, 255, 0.5);\n			flex-shrink: 0;\n			animation: none; /* 默认无动画 */\n\n			/* 运行状态 - 有动画 */\n			&._thinking_18lru_156 {\n				background: rgb(57, 182, 255);\n				animation: _pulse_18lru_1 0.8s ease-in-out infinite;\n			}\n\n			&._tool_executing_18lru_161 {\n				background: rgb(189, 69, 251);\n				animation: _pulse_18lru_1 0.6s ease-in-out infinite;\n			}\n\n			&._retry_18lru_166 {\n				background: rgb(255, 214, 0);\n				animation: _retryPulse_18lru_1 1s ease-in-out infinite;\n			}\n\n			/* 静止状态 - 无动画 */\n			&._completed_18lru_172,\n			&._input_18lru_173,\n			&._output_18lru_174 {\n				background: rgb(34, 197, 94);\n				animation: none;\n			}\n\n			&._error_18lru_179 {\n				background: rgb(239, 68, 68);\n				animation: none;\n			}\n		}\n\n		._statusText_18lru_185 {\n			color: white;\n			font-size: 12px;\n			line-height: 1;\n			font-weight: 500;\n			transition: all 0.3s ease-in-out;\n			position: relative;\n			overflow: hidden;\n			display: flex;\n			align-items: center;\n			min-height: 24px; /* 确保垂直居中 */\n\n			&._fadeOut_18lru_197 {\n				animation: _statusTextFadeOut_18lru_1 0.3s ease forwards;\n			}\n\n			&._fadeIn_18lru_201 {\n				animation: _statusTextFadeIn_18lru_1 0.3s ease forwards;\n			}\n		}\n	}\n\n	._controls_18lru_207 {\n		display: flex;\n		align-items: center;\n		gap: 4px;\n\n		._controlButton_18lru_212 {\n			width: 24px;\n			height: 24px;\n			border: none;\n			border-radius: 4px;\n			background: rgba(255, 255, 255, 0.1);\n			color: white;\n			cursor: pointer;\n			display: flex;\n			align-items: center;\n			justify-content: center;\n			font-size: 12px;\n			line-height: 1;\n\n			&:hover {\n				background: rgba(255, 255, 255, 0.2);\n			}\n		}\n\n		._stopButton_18lru_231 {\n			background: rgba(239, 68, 68, 0.2);\n			color: rgb(255, 41, 41);\n			font-weight: 600;\n\n			&:hover {\n				background: rgba(239, 68, 68, 0.3);\n			}\n		}\n	}\n}\n\n@keyframes _statusTextFadeIn_18lru_1 {\n	0% {\n		opacity: 0;\n		transform: translateY(5px);\n	}\n	100% {\n		opacity: 1;\n		transform: translateY(0);\n	}\n}\n\n@keyframes _statusTextFadeOut_18lru_1 {\n	0% {\n		opacity: 1;\n		transform: translateY(0);\n	}\n	100% {\n		opacity: 0;\n		transform: translateY(-5px);\n	}\n}\n\n/* 历史记录弹窗：普通流里排在面板前面（视觉上在上方），默认收起为 0 高度，\n * 展开时靠 JS 量出的真实内容高度做 max-height 动画（不用固定封顶值），\n * 撑开多高、要不要出现，跟面板本身完全无关，不用再算\"面板一共多高、弹窗该挂在哪个 bottom 偏移\"。 */\n._historySectionWrapper_18lru_268 {\n	width: 100%;\n	overflow: hidden;\n	max-height: 0;\n	margin-bottom: 0;\n\n	background: rgba(2, 0, 20, 0.5);\n	backdrop-filter: blur(10px);\n\n	text-shadow: 0 0 1px rgba(0, 0, 0, 0.2);\n\n	border-radius: calc(var(--border-radius) + 4px);\n	border: 0 solid rgba(255, 255, 255, 0);\n	box-shadow: 0 4px 16px rgba(0, 0, 0, 0);\n\n	transition:\n		max-height 0.2s,\n		margin-bottom 0.2s,\n		border-width 0.2s,\n		border-color 0.2s,\n		box-shadow 0.2s;\n\n	._wrapper_18lru_1._expanded_18lru_290 & {\n		margin-bottom: 8px;\n		border-width: 2px;\n		border-color: rgba(255, 255, 255, 0.4);\n		box-shadow: 0 4px 16px rgba(0, 0, 0, 0.6);\n	}\n\n	._historySection_18lru_268 {\n		max-height: min(\n			500px,\n			calc(100vh - 200px - var(--height))\n		); /* 列表本身的滚动上限，跟展开/收起动画解耦 */\n		overflow-y: auto;\n		overscroll-behavior: contain;\n		scrollbar-width: none;\n		/* 底部留白用 padding 撑，不依赖最后一项 margin-bottom：\n		 * overflow:auto 容器会裁掉末尾子元素的 margin，导致最后一条记录贴底 */\n		padding: 8px;\n\n		._historyItem_18lru_309 {\n			/* backdrop-filter: blur(10px); */\n			padding: 8px 10px;\n			margin-bottom: 8px;\n			background: linear-gradient(135deg, rgba(255, 255, 255, 0.08), rgba(255, 255, 255, 0.03));\n			border-radius: 8px;\n			border-left: 2px solid rgba(57, 182, 255, 0.5);\n			font-size: 12px;\n			color: white;\n			/* color: black; */\n			line-height: 1.3;\n			position: relative;\n			overflow: hidden;\n\n			/* 微妙的内阴影 */\n			box-shadow:\n				0 1px 0 rgba(255, 255, 255, 0.1),\n				0 1px 3px rgba(0, 0, 0, 0.1);\n\n			&::before {\n				content: '';\n				position: absolute;\n				top: 0;\n				left: 0;\n				right: 0;\n				height: 1px;\n				background: linear-gradient(90deg, transparent, rgba(255, 255, 255, 0.2), transparent);\n			}\n\n			&:hover {\n				background: linear-gradient(135deg, rgba(255, 255, 255, 0.12), rgba(255, 255, 255, 0.06));\n				/* transform: translateY(-1px); */\n				box-shadow:\n					inset 0 1px 0 rgba(255, 255, 255, 0.15),\n					0 2px 4px rgba(0, 0, 0, 0.15);\n			}\n\n			&._completed_18lru_172,\n			&._input_18lru_173,\n			&._output_18lru_174 {\n				border-left-color: rgb(34, 197, 94);\n				background: linear-gradient(135deg, rgba(34, 197, 94, 0.1), rgba(34, 197, 94, 0.05));\n			}\n\n			&._error_18lru_179 {\n				border-left-color: rgb(239, 68, 68);\n				background: linear-gradient(135deg, rgba(239, 68, 68, 0.1), rgba(239, 68, 68, 0.05));\n			}\n\n			&._retry_18lru_166 {\n				border-left-color: rgb(255, 214, 0);\n				background: linear-gradient(135deg, rgba(255, 214, 0, 0.1), rgba(255, 214, 0, 0.05));\n			}\n\n			&._observation_18lru_363 {\n				border-left-color: rgb(147, 51, 234);\n				background: linear-gradient(135deg, rgba(147, 51, 234, 0.1), rgba(147, 51, 234, 0.05));\n			}\n\n			&._question_18lru_368 {\n				border-left-color: rgb(255, 159, 67);\n				background: linear-gradient(135deg, rgba(255, 159, 67, 0.15), rgba(255, 159, 67, 0.08));\n			}\n\n			/* 突出显示 done 成功结果 */\n			&._doneSuccess_18lru_374 {\n				background: linear-gradient(\n					135deg,\n					rgba(34, 197, 94, 0.25),\n					rgba(34, 197, 94, 0.15),\n					rgba(34, 197, 94, 0.08)\n				);\n				border: none;\n				border-left: 2px solid rgb(34, 197, 94);\n				box-shadow:\n					0 4px 12px rgba(34, 197, 94, 0.3),\n					inset 0 1px 0 rgba(255, 255, 255, 0.2),\n					0 0 20px rgba(34, 197, 94, 0.1);\n				font-weight: 600;\n				color: rgb(220, 252, 231);\n				padding: 10px 12px;\n				margin-bottom: 8px;\n				border-radius: 8px;\n				position: relative;\n				overflow: hidden;\n\n				&::before {\n					background: linear-gradient(90deg, transparent, rgba(34, 197, 94, 0.4), transparent);\n				}\n\n				&::after {\n					content: '';\n					position: absolute;\n					top: 0;\n					left: -100%;\n					width: 100%;\n					height: 100%;\n					background: linear-gradient(90deg, transparent, rgba(255, 255, 255, 0.1), transparent);\n					animation: _shimmer_18lru_1 2s ease-in-out infinite;\n				}\n\n				._historyContent_18lru_410 {\n					._statusIcon_18lru_411 {\n						font-size: 16px;\n						animation: _celebrate_18lru_1 0.8s ease-in-out;\n						filter: drop-shadow(0 2px 4px rgba(34, 197, 94, 0.5));\n					}\n				}\n			}\n\n			/* 突出显示 done 失败结果 */\n			&._doneError_18lru_420 {\n				background: linear-gradient(\n					135deg,\n					rgba(239, 68, 68, 0.25),\n					rgba(239, 68, 68, 0.15),\n					rgba(239, 68, 68, 0.08)\n				);\n				border: none;\n				border-left: 2px solid rgb(239, 68, 68);\n				box-shadow:\n					0 4px 12px rgba(239, 68, 68, 0.3),\n					inset 0 1px 0 rgba(255, 255, 255, 0.2),\n					0 0 20px rgba(239, 68, 68, 0.1);\n				font-weight: 600;\n				color: rgb(254, 226, 226);\n				padding: 10px 12px;\n				margin-bottom: 8px;\n				border-radius: 8px;\n				position: relative;\n				overflow: hidden;\n\n				&::before {\n					background: linear-gradient(90deg, transparent, rgba(239, 68, 68, 0.4), transparent);\n				}\n\n				._historyContent_18lru_410 {\n					._statusIcon_18lru_411 {\n						font-size: 16px;\n						filter: drop-shadow(0 2px 4px rgba(239, 68, 68, 0.5));\n					}\n				}\n			}\n\n			._historyContent_18lru_410 {\n				display: flex;\n				align-items: center;\n				gap: 8px;\n\n				word-break: break-all;\n				white-space: pre-wrap;\n\n				/* overflow-x: auto; */\n\n				._statusIcon_18lru_411 {\n					font-size: 12px;\n					flex-shrink: 0;\n					line-height: 1;\n					transition: all 0.3s ease;\n				}\n\n				._reflectionLines_18lru_470 {\n					display: flex;\n					flex-direction: column;\n					gap: 4px;\n				}\n			}\n\n			._historyMeta_18lru_477 {\n				font-size: 10px;\n				color: rgba(255, 255, 255, 0.6);\n				/* color: rgb(61, 61, 61); */\n				margin-top: 8px;\n				line-height: 1;\n			}\n		}\n	}\n}\n\n/* 动画关键帧 - 更快的闪烁 */\n@keyframes _pulse_18lru_1 {\n	0%,\n	100% {\n		opacity: 1;\n		transform: scale(1);\n	}\n	50% {\n		opacity: 0.4;\n		transform: scale(1.3);\n	}\n}\n\n/* 重试动画 - 旋转脉冲 */\n@keyframes _retryPulse_18lru_1 {\n	0%,\n	100% {\n		opacity: 1;\n		transform: scale(1) rotate(0deg);\n	}\n	25% {\n		opacity: 0.6;\n		transform: scale(1.2) rotate(90deg);\n	}\n	50% {\n		opacity: 0.8;\n		transform: scale(1.1) rotate(180deg);\n	}\n	75% {\n		opacity: 0.6;\n		transform: scale(1.2) rotate(270deg);\n	}\n}\n\n/* 庆祝动画 */\n@keyframes _celebrate_18lru_1 {\n	0%,\n	100% {\n		transform: scale(1);\n	}\n	25% {\n		transform: scale(1.2) rotate(-5deg);\n	}\n	75% {\n		transform: scale(1.2) rotate(5deg);\n	}\n}\n\n/* done 卡片的光泽效果 */\n@keyframes _shimmer_18lru_1 {\n	0% {\n		left: -100%;\n	}\n	100% {\n		left: 100%;\n	}\n}\n\n/* 输入区域样式 */\n._inputSectionWrapper_18lru_547 {\n	width: 100%;\n	margin: 0 auto;\n\n	overflow: hidden;\n	height: var(--input-height);\n\n	transition: height 0.2s;\n\n	/* 与 header 保持同色调，让面板看起来是一体的深色玻璃卡片 */\n	background: rgba(0, 0, 0, 0.4);\n	backdrop-filter: blur(10px);\n\n	border-bottom-left-radius: calc(var(--border-radius) + 4px);\n	border-bottom-right-radius: calc(var(--border-radius) + 4px);\n\n	&._hidden_18lru_563 {\n		height: 0;\n	}\n\n	._inputSection_18lru_547 {\n		display: flex;\n		align-items: center;\n		gap: 8px;\n		height: 100%;\n		padding: 8px; /* 与上方状态条 padding 保持一致 */\n\n		._taskInput_18lru_574 {\n			flex: 1;\n			height: 100%;\n			background: rgba(255, 255, 255, 0.08);\n			border: 1px solid rgba(255, 255, 255, 0.15);\n			border-radius: 12px;\n			padding: 8px 14px;\n			color: rgb(240, 240, 245);\n			font-family: inherit;\n			font-size: 14px;\n			line-height: 1.4;\n			outline: none;\n			resize: none;\n			overflow-y: auto;\n			transition: all 0.2s ease;\n\n			&::placeholder {\n				color: rgba(255, 255, 255, 0.45);\n			}\n\n			&:focus {\n				background: rgba(255, 255, 255, 0.14);\n				border-color: rgba(57, 182, 255, 0.6);\n				box-shadow: 0 0 0 2px rgba(57, 182, 255, 0.2);\n			}\n		}\n	}\n}\n/*$vite$:1*/"));			document.head.appendChild(elementStyle);		}	} catch (e) {		console.error("vite-plugin-css-injected-by-js", e);	}})();
 import { Motion } from "ai-motion";
 import * as z from "zod/v4";
 //#region \0rolldown/runtime.js
@@ -22,22 +22,27 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region src/browser/utils/index.ts
+/** 判断值是否为 HTMLElement（type guard）。 */
 function isHTMLElement(el) {
 	return !!el && el.nodeType === 1;
 }
+/** 判断元素是否为 <input>（type guard）。 */
 function isInputElement(el) {
 	return el?.nodeType === 1 && el.tagName === "INPUT";
 }
+/** 判断元素是否为 <textarea>（type guard）。 */
 function isTextAreaElement(el) {
 	return el?.nodeType === 1 && el.tagName === "TEXTAREA";
 }
+/** 判断元素是否为 <select>（type guard）。 */
 function isSelectElement(el) {
 	return el?.nodeType === 1 && el.tagName === "SELECT";
 }
+/** 判断元素是否为 <a>（type guard）。 */
 function isAnchorElement(el) {
 	return el?.nodeType === 1 && el.tagName === "A";
 }
-/** Iframe offset for translating element coordinates to top-frame viewport. */
+/** 用于将元素坐标换算为顶层视口坐标的 iframe 偏移量。 */
 function getIframeOffset(element) {
 	const frame = element.ownerDocument.defaultView?.frameElement;
 	if (!frame) return {
@@ -51,19 +56,20 @@ function getIframeOffset(element) {
 	};
 }
 /**
-* Get native value setter from the element's own prototype (iframe-safe).
-* @note for React
+* 从元素自身的原型上获取原生 value setter（iframe 安全）。
+* @note 用于 React
 */
 function getNativeValueSetter(element) {
 	return Object.getOwnPropertyDescriptor(Object.getPrototypeOf(element), "value").set;
 }
+/** 等待指定的秒数。 */
 async function waitFor$1(seconds) {
 	await new Promise((resolve) => setTimeout(resolve, seconds * 1e3));
 }
 /**
-* Move the visual pointer to a position within an element.
-* @param x - x coordinate in the element's document viewport
-* @param y - y coordinate in the element's document viewport
+* 将视觉指针移动到元素内的某个位置。
+* @param x - 元素所属文档视口内的 x 坐标
+* @param y - 元素所属文档视口内的 y 坐标
 */
 async function movePointerToElement(element, x, y) {
 	const offset = getIframeOffset(element);
@@ -73,20 +79,23 @@ async function movePointerToElement(element, x, y) {
 	} }));
 	await waitFor$1(.3);
 }
+/** 触发一次模拟光标点击动画。 */
 async function clickPointer() {
 	window.dispatchEvent(new CustomEvent("PageAgent::ClickPointer"));
 }
+/** 开启遮罩穿透，鼠标事件不再被遮罩拦截。 */
 async function enablePassThrough() {
 	window.dispatchEvent(new CustomEvent("PageAgent::EnablePassThrough"));
 }
+/** 关闭遮罩穿透，遮罩重新拦截鼠标事件。 */
 async function disablePassThrough() {
 	window.dispatchEvent(new CustomEvent("PageAgent::DisablePassThrough"));
 }
 //#endregion
 //#region src/browser/actions.ts
 /**
-* Get the HTMLElement by index from a selectorMap.
-* @private Internal method, subject to change at any time.
+* 根据索引从 selectorMap 中获取对应的 HTMLElement。
+* @private 内部方法，随时可能变更。
 */
 function getElementByIndex(selectorMap, index) {
 	const interactiveNode = selectorMap.get(index);
@@ -97,6 +106,9 @@ function getElementByIndex(selectorMap, index) {
 	return element;
 }
 var lastClickedElement = null;
+/**
+* 触发上次点击元素的失焦相关事件（pointerout/pointerleave/mouseout/mouseleave/blur）并清空记录。
+*/
 function blurLastClickedElement() {
 	if (lastClickedElement) {
 		lastClickedElement.dispatchEvent(new PointerEvent("pointerout", { bubbles: true }));
@@ -108,11 +120,11 @@ function blurLastClickedElement() {
 	}
 }
 /**
-* Simulate a full click following W3C Pointer Events + UI Events spec order:
+* 模拟一次完整的点击，遵循 W3C Pointer Events + UI Events 规范顺序：
 * pointerover/enter → mouseover/enter → pointerdown → mousedown → [focus] →
 * pointerup → mouseup → click
 *
-* @private Internal method, subject to change at any time.
+* @private 内部方法，随时可能变更。
 */
 async function clickElement(element) {
 	blurLastClickedElement();
@@ -164,7 +176,8 @@ async function clickElement(element) {
 	await waitFor$1(.1);
 }
 /**
-* @private Internal method, subject to change at any time.
+* 向输入类元素（input / textarea / contenteditable）输入文本，并触发相应的输入事件。
+* @private 内部方法，随时可能变更。
 */
 async function inputTextElement(element, text) {
 	const isContentEditable = element.isContentEditable;
@@ -214,8 +227,9 @@ async function inputTextElement(element, text) {
 	blurLastClickedElement();
 }
 /**
-* @todo browser-use version is very complex and supports menu tags, need to follow up
-* @private Internal method, subject to change at any time.
+* 在下拉选择框（select）中按文本匹配并选中对应选项，然后触发 change 事件。
+* @todo browser-use 版本非常复杂且支持菜单标签，需要跟进
+* @private 内部方法，随时可能变更。
 */
 async function selectOptionElement(selectElement, optionText) {
 	if (!isSelectElement(selectElement)) throw new Error("Element is not a select element");
@@ -226,7 +240,8 @@ async function selectOptionElement(selectElement, optionText) {
 	await waitFor$1(.05);
 }
 /**
-* @private Internal method, subject to change at any time.
+* 将元素滚动到可视区域内；优先使用原生 scrollIntoViewIfNeeded，不支持时回退为 scrollIntoView。
+* @private 内部方法，随时可能变更。
 */
 async function scrollIntoViewIfNeeded(element) {
 	const el = element;
@@ -237,6 +252,12 @@ async function scrollIntoViewIfNeeded(element) {
 		inline: "nearest"
 	});
 }
+/**
+* 垂直滚动页面或指定元素容器。
+* @param scroll_amount - 滚动像素数（正数向下，负数向上）
+* @param element - 可选；若传入，则优先滚动该元素及其祖先中最近的可纵向滚动容器，否则滚动页面
+* @returns 滚动结果的描述消息
+*/
 async function scrollVertically(scroll_amount, element) {
 	if (element) {
 		const targetElement = element;
@@ -310,6 +331,12 @@ async function scrollVertically(scroll_amount, element) {
 		return `✅ ${warningMsg} Scrolled container (${el.tagName}) by ${scrolled}px.`;
 	}
 }
+/**
+* 水平滚动页面或指定元素容器。
+* @param scroll_amount - 滚动像素数（正数向右，负数向左）
+* @param element - 可选；若传入，则优先滚动该元素及其祖先中最近的可横向滚动容器，否则滚动页面
+* @returns 滚动结果的描述消息
+*/
 async function scrollHorizontally(scroll_amount, element) {
 	if (element) {
 		const targetElement = element;
@@ -1426,13 +1453,13 @@ var dom_tree_default = (args = {
 //#endregion
 //#region src/browser/dom/index.ts
 /**
-* Viewport expansion for DOM tree extraction.
-* -1 means full page (no viewport restriction)
-* 0 means viewport only
-* positive values expand the viewport by that many pixels
+* DOM 树提取时的视口扩展。
+* -1 表示整页（不受视口限制）
+* 0 表示仅视口
+* 正数表示在视口基础上额外扩展的像素数
 *
-* @note Since isTopElement depends on elementFromPoint,
-* it returns null when out of viewport, this feature has no practical use, only differ between -1 and 0
+* @note 由于 isTopElement 依赖 elementFromPoint，
+*       当元素在视口外时会返回 null，该特性实际用处不大，仅在 -1 和 0 之间有区别
 */
 var DEFAULT_VIEWPORT_EXPANSION = -1;
 function resolveViewportExpansion(viewportExpansion) {
@@ -1780,13 +1807,13 @@ function patchReact(_browserController) {
 	for (const element of reactRootElements) element.setAttribute("data-page-agent-not-interactive", "true");
 }
 /**
-* @todo (Heavy, might have false negatives) Interaction detection, if element width/height equals body offsetWidth/Height, consider it root element and non-interactive (React often attaches many events to root elements, causing false positives)
+* @todo （较重，可能有漏判）交互检测：如果元素宽高等于 body 的 offsetWidth/Height，则视为根元素并标记为不可交互（React 经常把大量事件绑定在根元素上，导致误判为可交互）
 */
 //#endregion
 //#region src/browser/visual/checkDarkMode.ts
 /**
-* A comprehensive function to determine if the page is currently in a dark theme.
-* Heuristic check. Only work for common patterns. Return false by default.
+* 判断页面当前是否处于深色主题的综合函数。
+* 启发式检测，只覆盖常见模式，默认返回 false。
 */
 function isPageDark() {
 	try {
@@ -1803,7 +1830,7 @@ function isPageDark() {
 	}
 }
 /**
-* Checks for common dark mode CSS classes on the html or body elements.
+* 检查 html 或 body 元素上常见的深色模式 CSS 类名。
 */
 function hasDarkModeClass() {
 	const DEFAULT_DARK_MODE_CLASSES = [
@@ -1819,7 +1846,7 @@ function hasDarkModeClass() {
 	return false;
 }
 /**
-* Some UI frameworks use data attributes to indicate theme
+* 某些 UI 框架使用 data 属性来表示主题
 */
 function hasDarkModeDataAttribute() {
 	const htmlElement = document.documentElement;
@@ -1837,8 +1864,8 @@ function hasDarkModeDataAttribute() {
 	return false;
 }
 /**
-* Checks the CSS `color-scheme` property and `<meta name="color-scheme">` tag.
-* Only "dark"/"only dark" counts as dark; "light dark" is ambiguous and ignored.
+* 检查 CSS 的 `color-scheme` 属性和 `<meta name="color-scheme">` 标签。
+* 只有 "dark"/"only dark" 才视为深色；"light dark" 存在歧义，忽略。
 */
 function isColorSchemeDark() {
 	const metaContent = document.querySelector("meta[name=\"color-scheme\"]")?.content.toLowerCase();
@@ -1847,7 +1874,7 @@ function isColorSchemeDark() {
 	return colorScheme === "dark" || colorScheme === "only dark";
 }
 /**
-* Checks the background color of the body element to determine if the page is dark.
+* 检查 body 元素的背景色以判断页面是否为深色。
 */
 function isBackgroundDark() {
 	const htmlStyle = window.getComputedStyle(document.documentElement);
@@ -1859,18 +1886,18 @@ function isBackgroundDark() {
 	return false;
 }
 /**
-* Checks if the text color on the body is light, which implies a dark background.
+* 检查 body 上的文字颜色是否为浅色，浅色文字通常意味着深色背景。
 */
 function isTextColorLight() {
-	/** Luminance (0-255) above which body text is considered light */
+	/** 亮度（0-255）超过该值时认为 body 文字为浅色 */
 	const LIGHT_TEXT_LUMINANCE = 200;
 	const luminance = getLuminance(window.getComputedStyle(document.body || document.documentElement).color);
 	return luminance !== null && luminance > LIGHT_TEXT_LUMINANCE;
 }
 /**
-* Checks the background color of major layout elements (#app, #root, etc.).
-* Many SPAs render into a container that may have its own dark background while
-* <body> remains transparent.
+* 检查主要布局元素（#app、#root 等）的背景色。
+* 很多 SPA 会把内容渲染到某个容器中，该容器可能有自己的深色背景，
+* 而 <body> 仍然是透明的。
 */
 function isMainContentBackgroundDark() {
 	const { innerWidth: vw, innerHeight: vh } = window;
@@ -1889,8 +1916,8 @@ function isMainContentBackgroundDark() {
 	return false;
 }
 /**
-* Parses an RGB or RGBA color string and returns an object with r, g, b properties.
-* @param {string} colorString - e.g., "rgb(34, 34, 34)" or "rgba(0, 0, 0, 0.5)"
+* 解析 RGB 或 RGBA 颜色字符串，返回包含 r、g、b 属性的对象。
+* @param {string} colorString - 例如 "rgb(34, 34, 34)" 或 "rgba(0, 0, 0, 0.5)"
 * @returns {{r: number, g: number, b: number}|null}
 */
 function parseRgbColor(colorString) {
@@ -1903,9 +1930,9 @@ function parseRgbColor(colorString) {
 	};
 }
 /**
-* Calculates the perceived luminance (0-255) of a CSS color string.
-* @param {string} colorString - e.g., "rgb(50, 50, 50)" or "rgba(0, 0, 0, 0.5)"
-* @returns {number|null} - The luminance, or null if the color is transparent or unparseable.
+* 计算 CSS 颜色字符串的感知亮度（0-255）。
+* @param {string} colorString - 例如 "rgb(50, 50, 50)" 或 "rgba(0, 0, 0, 0.5)"
+* @returns {number|null} - 亮度值，若颜色为透明或无法解析则返回 null。
 */
 function getLuminance(colorString) {
 	if (!colorString || colorString === "transparent" || colorString.startsWith("rgba(0, 0, 0, 0)")) return null;
@@ -1914,9 +1941,9 @@ function getLuminance(colorString) {
 	return .299 * rgb.r + .587 * rgb.g + .114 * rgb.b;
 }
 /**
-* Determines if a color is "dark" based on its calculated luminance.
-* @param {string} colorString - The CSS color string (e.g., "rgb(50, 50, 50)").
-* @param {number} threshold - A value between 0 and 255. Colors with luminance below this will be considered dark. Default is 128.
+* 根据计算出的亮度判断颜色是否为“深色”。
+* @param {string} colorString - CSS 颜色字符串（例如 "rgb(50, 50, 50)"）。
+* @param {number} threshold - 0 到 255 之间的值。亮度低于该值的颜色视为深色。默认为 128。
 */
 function isColorDark(colorString, threshold = 128) {
 	const luminance = getLuminance(colorString);
@@ -1970,6 +1997,9 @@ var init_SimulatorMask = __esmMin((() => {
 		#currentCursorY = 0;
 		#targetCursorX = 0;
 		#targetCursorY = 0;
+		/**
+		* 构造函数：初始化遮罩 DOM、创建 ai-motion 动效、拦截底层事件，并注册全局事件监听。
+		*/
 		constructor() {
 			super();
 			this.wrapper.id = "page-agent-runtime_simulator-mask";
@@ -2048,6 +2078,7 @@ var init_SimulatorMask = __esmMin((() => {
 				window.removeEventListener("PageAgent::DisablePassThrough", disablePassThroughListener);
 			});
 		}
+		/** 创建模拟光标的 DOM 结构（包含波纹、填充层、边框层）。 */
 		#createCursor() {
 			this.#cursor.className = cursor_module_default.cursor;
 			const rippleContainer = document.createElement("div");
@@ -2061,6 +2092,7 @@ var init_SimulatorMask = __esmMin((() => {
 			this.#cursor.appendChild(borderLayer);
 			this.wrapper.appendChild(this.#cursor);
 		}
+		/** 每帧将光标向目标位置移动 20% 距离，实现平滑跟随动画。 */
 		#moveCursorToTarget() {
 			if (this.#disposed) return;
 			const newX = this.#currentCursorX + (this.#targetCursorX - this.#currentCursorX) * .2;
@@ -2079,17 +2111,24 @@ var init_SimulatorMask = __esmMin((() => {
 			}
 			requestAnimationFrame(() => this.#moveCursorToTarget());
 		}
+		/**
+		* 设置光标的目标坐标（由外部通过事件触发调用）。
+		* @param x - 目标 X 坐标
+		* @param y - 目标 Y 坐标
+		*/
 		setCursorPosition(x, y) {
 			if (this.#disposed) return;
 			this.#targetCursorX = x;
 			this.#targetCursorY = y;
 		}
+		/** 触发一次光标点击动画（通过重放 clicking class 实现）。 */
 		triggerClickAnimation() {
 			if (this.#disposed) return;
 			this.#cursor.classList.remove(cursor_module_default.clicking);
 			this.#cursor.offsetHeight;
 			this.#cursor.classList.add(cursor_module_default.clicking);
 		}
+		/** 显示遮罩及模拟光标。 */
 		show() {
 			if (this.shown || this.#disposed) return;
 			this.shown = true;
@@ -2103,6 +2142,7 @@ var init_SimulatorMask = __esmMin((() => {
 			this.#cursor.style.left = `${this.#currentCursorX}px`;
 			this.#cursor.style.top = `${this.#currentCursorY}px`;
 		}
+		/** 隐藏遮罩及模拟光标。 */
 		hide() {
 			if (!this.shown || this.#disposed) return;
 			this.shown = false;
@@ -2113,6 +2153,7 @@ var init_SimulatorMask = __esmMin((() => {
 				this.wrapper.classList.remove(SimulatorMask_module_default.visible);
 			}, 800);
 		}
+		/** 销毁遮罩：释放动效、移除 DOM 并触发 dispose 事件。 */
 		dispose() {
 			this.#disposed = true;
 			this.motion?.dispose();
@@ -2124,44 +2165,46 @@ var init_SimulatorMask = __esmMin((() => {
 //#endregion
 //#region src/browser/BrowserController.ts
 /**
-* Copyright (C) 2025 Alibaba Group Holding Limited
-* All rights reserved.
+* 版权所有 (C) 2025 Alibaba Group Holding Limited
+* 保留所有权利。
 *
-* BrowserController - Manages DOM operations and element interactions.
-* Designed to be independent of LLM and can be tested in unit tests.
-* All public methods are async for potential remote calling support.
+* BrowserController - 管理 DOM 操作和元素交互。
+* 设计上独立于 LLM，可在单元测试中直接测试。
+* 所有公开方法均为异步，以支持潜在的远程调用。
 */
 /**
-* BrowserController manages DOM state and element interactions.
-* It provides async methods for all DOM operations, keeping state isolated.
+* BrowserController 管理 DOM 状态和元素交互。
+* 它为所有 DOM 操作提供异步方法，并保持状态隔离。
 *
 * @lifecycle
-* - beforeUpdate: Emitted before the DOM tree is updated.
-* - afterUpdate: Emitted after the DOM tree is updated.
+* - beforeUpdate: 在 DOM 树更新之前触发。
+* - afterUpdate: 在 DOM 树更新之后触发。
 */
 var BrowserController = class extends EventTarget {
 	config;
-	/** Corresponds to eval_page in browser-use */
+	/** 对应 browser-use 中的 eval_page */
 	flatTree = null;
 	/**
-	* All highlighted index-mapped interactive elements
-	* Corresponds to DOMState.selector_map in browser-use
+	* 所有已索引的高亮交互元素
+	* 对应 browser-use 中的 DOMState.selector_map
 	*/
 	selectorMap = /* @__PURE__ */ new Map();
-	/** Index -> element text description mapping */
+	/** 索引 -> 元素文本描述映射 */
 	elementTextMap = /* @__PURE__ */ new Map();
 	/**
-	* Simplified HTML for LLM consumption.
-	* Corresponds to clickable_elements_to_string in browser-use
+	* 供 LLM 消费的简化 HTML。
+	* 对应 browser-use 中的 clickable_elements_to_string
 	*/
 	simplifiedHTML = "<EMPTY>";
-	/** last time the tree was updated */
+	/** 树最后一次更新的时间 */
 	lastTimeUpdate = 0;
-	/** Whether the tree has been indexed at least once */
+	/** 树是否至少被索引过一次 */
 	isIndexed = false;
-	/** Visual mask overlay for blocking user interaction during automation */
+	/** 用于在自动化期间阻止用户交互的视觉遮罩层 */
 	mask = null;
+	/** mask 异步初始化完成的 Promise，用于在调用前等待初始化完成 */
 	maskReady = null;
+	/** 是否已释放资源 */
 	disposed = false;
 	constructor(config = {}) {
 		super();
@@ -2170,7 +2213,7 @@ var BrowserController = class extends EventTarget {
 		if (config.enableMask) this.initMask();
 	}
 	/**
-	* Initialize mask asynchronously (dynamic import to avoid CSS loading in Node)
+	* 异步初始化遮罩层（动态导入以避免在 Node 中加载 CSS）
 	*/
 	initMask() {
 		if (this.disposed || this.maskReady !== null) return;
@@ -2186,20 +2229,20 @@ var BrowserController = class extends EventTarget {
 		})();
 	}
 	/**
-	* Get current page URL
+	* 获取当前页面 URL
 	*/
 	async getCurrentUrl() {
 		return window.location.href;
 	}
 	/**
-	* Get last tree update timestamp
+	* 获取树最后一次更新的时间戳
 	*/
 	async getLastUpdateTime() {
 		return this.lastTimeUpdate;
 	}
 	/**
-	* Get structured browser state for LLM consumption.
-	* Automatically calls updateTree() to refresh the DOM state.
+	* 获取供 LLM 消费的结构化浏览器状态。
+	* 自动调用 updateTree() 刷新 DOM 状态。
 	*/
 	async getBrowserState() {
 		const url = window.location.href;
@@ -2217,9 +2260,9 @@ var BrowserController = class extends EventTarget {
 		};
 	}
 	/**
-	* Update DOM tree, returns simplified HTML for LLM.
-	* This is the main method to refresh the page state.
-	* Automatically bypasses mask during DOM extraction if enabled.
+	* 更新 DOM 树，返回供 LLM 使用的简化 HTML。
+	* 这是刷新页面状态的主要方法。
+	* 若已启用遮罩，DOM 提取期间会自动绕过遮罩。
 	*/
 	async updateTree() {
 		this.dispatchEvent(new Event("beforeUpdate"));
@@ -2242,21 +2285,21 @@ var BrowserController = class extends EventTarget {
 		return this.simplifiedHTML;
 	}
 	/**
-	* Clean up all element highlights
+	* 清理所有元素高亮
 	*/
 	async cleanUpHighlights() {
 		console.log("[BrowserController] cleanUpHighlights");
 		cleanUpHighlights();
 	}
 	/**
-	* Ensure the tree has been indexed before any index-based operation.
-	* Throws if updateTree() hasn't been called yet.
+	* 在任何基于索引的操作之前确保树已被索引。
+	* 若尚未调用 updateTree() 则抛出异常。
 	*/
 	assertIndexed() {
 		if (!this.isIndexed) throw new Error("DOM tree not indexed yet. Can not perform actions on elements.");
 	}
 	/**
-	* Click element by index
+	* 根据索引点击元素
 	*/
 	async clickElement(index) {
 		try {
@@ -2280,7 +2323,7 @@ var BrowserController = class extends EventTarget {
 		}
 	}
 	/**
-	* Input text into element by index
+	* 根据索引向元素输入文本
 	*/
 	async inputText(index, text) {
 		try {
@@ -2300,7 +2343,7 @@ var BrowserController = class extends EventTarget {
 		}
 	}
 	/**
-	* Select dropdown option by index and option text
+	* 根据索引和选项文本在下拉框中选中选项
 	*/
 	async selectOption(index, optionText) {
 		try {
@@ -2320,7 +2363,7 @@ var BrowserController = class extends EventTarget {
 		}
 	}
 	/**
-	* Scroll vertically
+	* 垂直滚动
 	*/
 	async scroll(options) {
 		try {
@@ -2338,7 +2381,7 @@ var BrowserController = class extends EventTarget {
 		}
 	}
 	/**
-	* Scroll horizontally
+	* 水平滚动
 	*/
 	async scrollHorizontally(options) {
 		try {
@@ -2356,9 +2399,8 @@ var BrowserController = class extends EventTarget {
 		}
 	}
 	/**
-	* Execute arbitrary JavaScript on the page.
-	* The optional `signal` is exposed to the script scope so cooperative code
-	* can abort promptly when the task is stopped.
+	* 在页面上执行任意 JavaScript。
+	* 可选的 `signal` 会暴露到脚本作用域中，使协作代码能在任务被中止时及时退出。
 	*/
 	async executeJavascript(script, signal) {
 		try {
@@ -2374,8 +2416,8 @@ var BrowserController = class extends EventTarget {
 		}
 	}
 	/**
-	* Show the visual mask overlay.
-	* Only works after mask is setup.
+	* 显示视觉遮罩层。
+	* 仅在遮罩初始化完成后可用。
 	*/
 	async showMask() {
 		if (this.disposed) return;
@@ -2384,8 +2426,8 @@ var BrowserController = class extends EventTarget {
 		this.mask?.show();
 	}
 	/**
-	* Hide the visual mask overlay.
-	* Only works after mask is setup.
+	* 隐藏视觉遮罩层。
+	* 仅在遮罩初始化完成后可用。
 	*/
 	async hideMask() {
 		if (this.disposed) return;
@@ -2394,7 +2436,7 @@ var BrowserController = class extends EventTarget {
 		this.mask?.hide();
 	}
 	/**
-	* Dispose and clean up resources
+	* 释放资源并清理
 	*/
 	dispose() {
 		if (this.disposed) return;
@@ -2421,6 +2463,7 @@ var BrowserController = class extends EventTarget {
 		if (errors.length > 1) throw new AggregateError(errors, "BrowserController disposal failed");
 	}
 };
+/** 语言包集合：键为语言代码，值为对应翻译表 */
 var locales = {
 	"en-US": { ui: {
 		ready: "Ready",
@@ -2525,81 +2568,85 @@ var I18n = class {
 		if (params) return this.interpolate(value, params);
 		return value;
 	}
+	/** 根据点分路径从翻译对象中取值 */
 	getNestedValue(obj, path) {
 		return path.split(".").reduce((current, key) => current?.[key], obj);
 	}
+	/** 将模板中的 {{key}} 占位符替换为参数值 */
 	interpolate(template, params) {
 		return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
 			return params[key] != null ? params[key].toString() : match;
 		});
 	}
+	/** 获取当前语言代码 */
 	getLanguage() {
 		return this.language;
 	}
 };
 //#endregion
 //#region src/ui/utils.ts
+/** 截断字符串，超过最大长度时以省略号结尾 */
 function truncate$1(text, maxLength) {
 	if (text.length > maxLength) return text.substring(0, maxLength) + "...";
 	return text;
 }
 /**
-* Escape HTML special characters to prevent XSS and rendering issues
+* 转义 HTML 特殊字符，防止 XSS 及渲染问题
 */
 function escapeHtml(text) {
 	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
 }
 var UI_module_default = {
-	wrapper: "_wrapper_h452n_1",
-	panel: "_panel_h452n_57",
-	background: "_background_h452n_57",
-	"mask-running": "_mask-running_h452n_1",
-	panelInner: "_panelInner_h452n_57",
-	header: "_header_h452n_124",
-	pulse: "_pulse_h452n_1",
-	retryPulse: "_retryPulse_h452n_1",
-	statusTextFadeOut: "_statusTextFadeOut_h452n_1",
-	statusTextFadeIn: "_statusTextFadeIn_h452n_1",
-	statusSection: "_statusSection_h452n_140",
-	indicator: "_indicator_h452n_147",
-	thinking: "_thinking_h452n_156",
-	tool_executing: "_tool_executing_h452n_161",
-	retry: "_retry_h452n_166",
-	completed: "_completed_h452n_172",
-	input: "_input_h452n_173",
-	output: "_output_h452n_174",
-	error: "_error_h452n_179",
-	statusText: "_statusText_h452n_185",
-	fadeOut: "_fadeOut_h452n_197",
-	fadeIn: "_fadeIn_h452n_201",
-	controls: "_controls_h452n_207",
-	controlButton: "_controlButton_h452n_212",
-	stopButton: "_stopButton_h452n_231",
-	historySectionWrapper: "_historySectionWrapper_h452n_268",
-	shimmer: "_shimmer_h452n_1",
-	celebrate: "_celebrate_h452n_1",
-	expanded: "_expanded_h452n_290",
-	historySection: "_historySection_h452n_268",
-	historyItem: "_historyItem_h452n_309",
-	observation: "_observation_h452n_363",
-	question: "_question_h452n_368",
-	doneSuccess: "_doneSuccess_h452n_374",
-	historyContent: "_historyContent_h452n_410",
-	statusIcon: "_statusIcon_h452n_411",
-	doneError: "_doneError_h452n_420",
-	reflectionLines: "_reflectionLines_h452n_470",
-	historyMeta: "_historyMeta_h452n_477",
-	inputSectionWrapper: "_inputSectionWrapper_h452n_547",
-	hidden: "_hidden_h452n_563",
-	inputSection: "_inputSection_h452n_547",
-	taskInput: "_taskInput_h452n_574"
+	wrapper: "_wrapper_18lru_1",
+	shell: "_shell_18lru_57",
+	background: "_background_18lru_57",
+	"mask-running": "_mask-running_18lru_1",
+	shellInner: "_shellInner_18lru_57",
+	header: "_header_18lru_124",
+	pulse: "_pulse_18lru_1",
+	retryPulse: "_retryPulse_18lru_1",
+	statusTextFadeOut: "_statusTextFadeOut_18lru_1",
+	statusTextFadeIn: "_statusTextFadeIn_18lru_1",
+	statusSection: "_statusSection_18lru_140",
+	indicator: "_indicator_18lru_147",
+	thinking: "_thinking_18lru_156",
+	tool_executing: "_tool_executing_18lru_161",
+	retry: "_retry_18lru_166",
+	completed: "_completed_18lru_172",
+	input: "_input_18lru_173",
+	output: "_output_18lru_174",
+	error: "_error_18lru_179",
+	statusText: "_statusText_18lru_185",
+	fadeOut: "_fadeOut_18lru_197",
+	fadeIn: "_fadeIn_18lru_201",
+	controls: "_controls_18lru_207",
+	controlButton: "_controlButton_18lru_212",
+	stopButton: "_stopButton_18lru_231",
+	historySectionWrapper: "_historySectionWrapper_18lru_268",
+	shimmer: "_shimmer_18lru_1",
+	celebrate: "_celebrate_18lru_1",
+	expanded: "_expanded_18lru_290",
+	historySection: "_historySection_18lru_268",
+	historyItem: "_historyItem_18lru_309",
+	observation: "_observation_18lru_363",
+	question: "_question_18lru_368",
+	doneSuccess: "_doneSuccess_18lru_374",
+	historyContent: "_historyContent_18lru_410",
+	statusIcon: "_statusIcon_18lru_411",
+	doneError: "_doneError_18lru_420",
+	reflectionLines: "_reflectionLines_18lru_470",
+	historyMeta: "_historyMeta_18lru_477",
+	inputSectionWrapper: "_inputSectionWrapper_18lru_547",
+	hidden: "_hidden_18lru_563",
+	inputSection: "_inputSection_18lru_547",
+	taskInput: "_taskInput_18lru_574"
 };
 //#endregion
 //#region src/ui/cards.ts
 /**
-* Card HTML generation utilities for UI
+* UI 的卡片 HTML 生成工具
 */
-/** Create a single history card */
+/** 创建单条历史卡片 */
 function createCard({ icon, content, meta, type }) {
 	const typeClass = type ? UI_module_default[type] : "";
 	const contentHtml = Array.isArray(content) ? `<div class="${UI_module_default.reflectionLines}">${content.map((line) => `<span>${escapeHtml(line)}</span>`).join("")}</div>` : `<span>${escapeHtml(content)}</span>`;
@@ -2613,7 +2660,7 @@ function createCard({ icon, content, meta, type }) {
 		</div>
 	`;
 }
-/** Create reflection lines from reflection object */
+/** 从反思对象生成反思行 */
 function createReflectionLines(reflection) {
 	const lines = [];
 	if (reflection.evaluation_previous_goal) lines.push(`🔍 ${reflection.evaluation_previous_goal}`);
@@ -2624,14 +2671,14 @@ function createReflectionLines(reflection) {
 //#endregion
 //#region src/ui/UI.ts
 /**
-* Agent control UI
+* Agent 控制 UI
 *
-* Architecture:
-* - History list: renders directly from agent.history (historical events)
-* - Header bar: shows activity events (transient state) and agent status
+* 架构：
+* - 历史列表：直接从 agent.history 渲染（历史事件）
+* - 头部栏：展示活动事件（瞬时状态）和 agent 状态
 *
-* This separation ensures data consistency - history is the single source of truth
-* for what has been done, while activity shows what is happening now.
+* 这种分离保证了数据一致性 - 历史是已完成内容的唯一数据源，
+* 而活动状态展示的是当前正在发生的事情。
 */
 var UI = class {
 	#wrapper;
@@ -2662,13 +2709,14 @@ var UI = class {
 	#onActivity = (e) => this.#handleActivity(e.detail);
 	#onAgentDispose = () => this.dispose();
 	#askUserCallback = (question, options) => this.#askUser(question, options?.signal);
+	/** 获取 UI 的根容器元素 */
 	get wrapper() {
 		return this.#wrapper;
 	}
 	/**
-	* Create a UI bound to an agent
-	* @param agent - Agent instance that implements UIAdapter
-	* @param config - Optional UI configuration
+	* 创建绑定到某个 agent 的 UI
+	* @param agent - 实现 UIAdapter 的 Agent 实例
+	* @param config - 可选的 UI 配置
 	*/
 	constructor(agent, config = {}) {
 		this.#agent = agent;
@@ -2693,7 +2741,7 @@ var UI = class {
 		this.#showInputArea();
 		this.hide();
 	}
-	/** Handle agent status change */
+	/** 处理 agent 状态变化 */
 	#handleStatusChange() {
 		const status = this.#agent.status;
 		const failed = status === "completed" && this.#agent.lastResult?.success === false;
@@ -2708,19 +2756,20 @@ var UI = class {
 		if (status === "running") {
 			this.show();
 			this.#hideInputArea();
+			if (!this.#isExpanded) this.#expand();
 		}
 		if (status === "completed" || status === "error" || status === "stopped") {
 			if (!this.#isExpanded) this.#expand();
 			if (this.#shouldShowInputArea()) this.#showInputArea();
 		}
 	}
-	/** Handle agent history change - re-render history list from agent.history */
+	/** 处理 agent 历史变化 - 根据 agent.history 重新渲染历史列表 */
 	#handleHistoryChange() {
 		this.#renderHistory();
 	}
 	/**
-	* Handle agent activity - transient state for immediate UI feedback
-	* Activity events are NOT persisted in history, only used for header bar updates
+	* 处理 agent 活动 - 用于即时 UI 反馈的瞬时状态
+	* 活动事件不会持久化到历史中，仅用于头部栏更新
 	*/
 	#handleActivity(activity) {
 		switch (activity.type) {
@@ -2745,9 +2794,9 @@ var UI = class {
 		}
 	}
 	/**
-	* Ask for user input (internal, called by agent via onAskUser).
-	* Rejects when `signal` aborts (task stopped or disposed), cleaning up the
-	* question card and pending state so the agent loop can settle.
+	* 请求用户输入（内部方法，由 agent 通过 onAskUser 调用）。
+	* 当 `signal` 中止（任务被停止或销毁）时拒绝该请求，
+	* 并清理问题卡片和挂起状态，以便 agent 循环能够收尾。
 	*/
 	#askUser(question, signal) {
 		if (this.#disposed) return Promise.reject(this.#createAbortError());
@@ -2777,9 +2826,11 @@ var UI = class {
 			}
 		});
 	}
+	/** 创建标准的中止异常（AbortError） */
 	#createAbortError() {
 		return new DOMException("The operation was aborted.", "AbortError");
 	}
+	/** 清空用户回答相关状态并移除临时卡片 */
 	#clearQuestionState() {
 		if (this.#userAnswerSignal && this.#userAnswerAbortHandler) this.#userAnswerSignal.removeEventListener("abort", this.#userAnswerAbortHandler);
 		this.#userAnswerSignal = null;
@@ -2789,30 +2840,34 @@ var UI = class {
 		this.#isWaitingForUserAnswer = false;
 		this.#removeTempCards();
 	}
+	/** 拒绝挂起的用户问题（存在待回答问题时） */
 	#rejectPendingQuestion() {
 		const reject = this.#userAnswerRejecter;
 		if (!reject) return;
 		this.#clearQuestionState();
 		reject(this.#createAbortError());
 	}
-	/** Remove temporary question cards (only direct children for safety) */
+	/** 移除临时问题卡片（为安全起见仅移除直接子节点） */
 	#removeTempCards() {
 		Array.from(this.#historySection.children).forEach((child) => {
 			if (child.getAttribute("data-temp-card") === "true") child.remove();
 		});
 		this.#syncHistoryHeight();
 	}
+	/** 显示 UI（淡入 + 平移效果） */
 	show() {
 		this.wrapper.style.display = "block";
 		this.wrapper.offsetHeight;
 		this.wrapper.style.opacity = "1";
 		this.wrapper.style.transform = "translateX(-50%) translateY(0)";
 	}
+	/** 隐藏 UI（淡出 + 下移效果） */
 	hide() {
 		this.wrapper.style.opacity = "0";
 		this.wrapper.style.transform = "translateX(-50%) translateY(20px)";
 		this.wrapper.style.display = "none";
 	}
+	/** 重置 UI 状态（拒绝挂起问题、清空状态文本、收起历史并显示输入框） */
 	reset() {
 		this.#rejectPendingQuestion();
 		this.#statusText.textContent = this.#i18n.t("ui.ready");
@@ -2821,14 +2876,16 @@ var UI = class {
 		this.#collapse();
 		this.#showInputArea();
 	}
+	/** 展开历史弹窗（公开方法） */
 	expand() {
 		this.#expand();
 	}
+	/** 收起历史弹窗（公开方法） */
 	collapse() {
 		this.#collapse();
 	}
 	/**
-	* Dispose UI and clean up event listeners
+	* 销毁 UI 并清理事件监听器
 	*/
 	dispose() {
 		if (this.#disposed) return;
@@ -2845,6 +2902,7 @@ var UI = class {
 		this.#timers.clear();
 		this.wrapper.remove();
 	}
+	/** 根据工具名称和参数生成"正在执行"提示文本 */
 	#getToolExecutingText(toolName, args) {
 		const a = args;
 		switch (toolName) {
@@ -2859,14 +2917,14 @@ var UI = class {
 		}
 	}
 	/**
-	* Action button handler: stop when running, close (dispose) when idle
+	* 动作按钮处理：运行中则停止，空闲则关闭（销毁）
 	*/
 	#handleActionButton() {
 		if (this.#agent.status === "running") this.#agent.stop();
 		else this.#agent.dispose();
 	}
 	/**
-	* Submit task
+	* 提交任务
 	*/
 	#submitTask() {
 		const input = this.#taskInput.value.trim();
@@ -2880,7 +2938,7 @@ var UI = class {
 		});
 	}
 	/**
-	* Handle user answer
+	* 处理用户回答
 	*/
 	#handleUserAnswer(input) {
 		this.#removeTempCards();
@@ -2889,7 +2947,7 @@ var UI = class {
 		resolve?.(input);
 	}
 	/**
-	* Show input area
+	* 显示输入区域
 	*/
 	#showInputArea(placeholder) {
 		this.#taskInput.value = "";
@@ -2900,13 +2958,13 @@ var UI = class {
 		}, 100);
 	}
 	/**
-	* Hide input area
+	* 隐藏输入区域
 	*/
 	#hideInputArea() {
 		this.#inputSection.classList.add(UI_module_default.hidden);
 	}
 	/**
-	* Check if input area should be shown
+	* 检查是否应显示输入区域
 	*/
 	#shouldShowInputArea() {
 		if (this.#isWaitingForUserAnswer) return true;
@@ -2915,6 +2973,7 @@ var UI = class {
 		if (status === "completed" || status === "error" || status === "stopped") return this.#config.promptForNextTask ?? true;
 		return false;
 	}
+	/** 创建 UI 根元素并挂载到 body，返回根容器 */
 	#createWrapper() {
 		const taskInputMaxLength = 1e3;
 		const wrapper = document.createElement("div");
@@ -2933,9 +2992,9 @@ var UI = class {
 					</div>
 				</div>
 			</div>
-			<div class="${UI_module_default.panel}">
+			<div class="${UI_module_default.shell}">
 				<div class="${UI_module_default.background}"></div>
-				<div class="${UI_module_default.panelInner}">
+				<div class="${UI_module_default.shellInner}">
 					<div class="${UI_module_default.header}">
 						<div class="${UI_module_default.statusSection}">
 							<div class="${UI_module_default.indicator} ${UI_module_default.thinking}"></div>
@@ -2965,6 +3024,7 @@ var UI = class {
 		document.body.appendChild(wrapper);
 		return wrapper;
 	}
+	/** 绑定所有 DOM 事件监听器（头部点击、展开按钮、动作按钮、回车提交等） */
 	#setupEventListeners() {
 		this.wrapper.querySelector(`.${UI_module_default.header}`).addEventListener("click", (e) => {
 			if (e.target.closest(`.${UI_module_default.controlButton}`)) return;
@@ -2989,17 +3049,18 @@ var UI = class {
 			e.stopPropagation();
 		});
 	}
+	/** 在展开/收起状态之间切换 */
 	#toggle() {
 		if (this.#isExpanded) this.#collapse();
 		else this.#expand();
 	}
 	/**
-	* Expand the history popup.
+	* 展开历史弹窗。
 	*
-	* `max-height` is measured in JS (not animated to a fixed CSS cap) so the
-	* transition distance always matches the real content height — otherwise
-	* expand/collapse feel like different speeds (expand reaches its real
-	* height early and idles, collapse animates the full cap every time).
+	* `max-height` 由 JS 测量（而非动画到固定的 CSS 上限），因此
+	* 过渡距离始终匹配真实内容高度 — 否则展开/收起会给人
+	* 速度不一致的感觉（展开会提前达到真实高度并停滞，
+	* 而收起每次都按完整上限做动画）。
 	*/
 	#expand() {
 		this.#isExpanded = true;
@@ -3007,19 +3068,20 @@ var UI = class {
 		this.#expandButton.textContent = "▲";
 		this.#syncHistoryHeight();
 	}
+	/** 收起历史弹窗 */
 	#collapse() {
 		this.#isExpanded = false;
 		this.wrapper.classList.remove(UI_module_default.expanded);
 		this.#expandButton.textContent = "▼";
 		this.#historySectionWrapper.style.maxHeight = "0px";
 	}
-	/** Sync the history popup's max-height to its current (already capped) content height */
+	/** 将历史弹窗的 max-height 同步为当前（已封顶的）内容高度 */
 	#syncHistoryHeight() {
 		if (!this.#isExpanded) return;
 		this.#historySectionWrapper.style.maxHeight = `${this.#historySectionWrapper.scrollHeight}px`;
 	}
 	/**
-	* Start periodic header update loop
+	* 启动周期性的头部更新循环
 	*/
 	#startHeaderUpdateLoop() {
 		this.#headerUpdateTimer = setInterval(() => {
@@ -3027,7 +3089,7 @@ var UI = class {
 		}, 450);
 	}
 	/**
-	* Stop periodic header update loop
+	* 停止周期性的头部更新循环
 	*/
 	#stopHeaderUpdateLoop() {
 		if (this.#headerUpdateTimer) {
@@ -3035,6 +3097,7 @@ var UI = class {
 			this.#headerUpdateTimer = null;
 		}
 	}
+	/** 设置一个受控延时定时器（销毁后自动忽略回调） */
 	#setTimer(callback, delay) {
 		const timer = setTimeout(() => {
 			this.#timers.delete(timer);
@@ -3043,7 +3106,7 @@ var UI = class {
 		this.#timers.add(timer);
 	}
 	/**
-	* Check if header needs update and trigger animation if not currently animating
+	* 检查头部是否需要更新，若当前未在动画中则触发动画
 	*/
 	#checkAndUpdateHeader() {
 		if (!this.#pendingHeaderText || this.#isAnimating) return;
@@ -3056,7 +3119,7 @@ var UI = class {
 		this.#animateTextChange(textToShow);
 	}
 	/**
-	* Animate text change with fade out/in effect
+	* 以淡出/淡入效果动画切换文本
 	*/
 	#animateTextChange(newText) {
 		this.#isAnimating = true;
@@ -3071,35 +3134,37 @@ var UI = class {
 			}, 300);
 		}, 150);
 	}
+	/** 更新状态指示器的样式类 */
 	#updateStatusIndicator(type) {
 		const variant = type === "running" ? "thinking" : type === "executing" ? "tool_executing" : type === "retrying" ? "retry" : type;
 		this.#indicator.className = UI_module_default.indicator;
 		if (variant !== "idle" && variant !== "stopped") this.#indicator.classList.add(UI_module_default[variant]);
 	}
+	/** 将历史区域滚动到底部 */
 	#scrollToBottom() {
 		this.#setTimer(() => {
 			this.#historySection.scrollTop = this.#historySection.scrollHeight;
 		}, 0);
 	}
 	/**
-	* Render history directly from agent.history
+	* 直接从 agent.history 渲染历史
 	*
-	* Renders:
-	* 1. Task (first item, from agent.task)
-	* 2. Reflection cards (evaluation, memory, next_goal)
-	* 3. Tool execution with output
-	* 4. Observations
+	* 渲染内容：
+	* 1. 任务卡片（每个 task_start 事件对应一张，history 跨任务持久保留，因此可展示历次任务）
+	* 2. 反思卡片（评估、记忆、下一步目标）
+	* 3. 工具执行及输出
+	* 4. 观察
 	*/
 	#renderHistory() {
 		const items = [];
-		const task = this.#agent.task;
-		if (task) items.push(this.#createTaskCard(task));
 		const history = this.#agent.history;
+		if (history.length === 0 && this.#agent.task) items.push(this.#createTaskCard(this.#agent.task));
 		for (const event of history) items.push(...this.#createHistoryCards(event));
 		this.#historySection.innerHTML = items.join("");
 		this.#scrollToBottom();
 		this.#syncHistoryHeight();
 	}
+	/** 生成任务卡片 HTML */
 	#createTaskCard(task) {
 		return createCard({
 			icon: "🎯",
@@ -3107,11 +3172,13 @@ var UI = class {
 			type: "input"
 		});
 	}
-	/** Create cards for a history event */
+	/** 为一条历史事件生成卡片 */
 	#createHistoryCards(event) {
 		const cards = [];
 		const meta = event.type === "step" && event.stepIndex !== void 0 ? this.#i18n.t("ui.step", { number: (event.stepIndex + 1).toString() }) : void 0;
-		if (event.type === "step") {
+		if (event.type === "task_start") {
+			if (event.task) cards.push(this.#createTaskCard(event.task));
+		} else if (event.type === "step") {
 			if (event.reflection) {
 				const lines = createReflectionLines(event.reflection);
 				if (lines.length > 0) cards.push(createCard({
@@ -3150,7 +3217,7 @@ var UI = class {
 		}));
 		return cards;
 	}
-	/** Create cards for an action */
+	/** 为一个动作生成卡片 */
 	#createActionCards(action, meta) {
 		const cards = [];
 		if (action.name === "done") {
@@ -3197,7 +3264,7 @@ var UI = class {
 //#endregion
 //#region src/llm/errors.ts
 /**
-* Error types and error handling for LLM invocations.
+* LLM 调用相关的错误类型与错误处理。
 */
 var InvokeErrorTypes = {
 	NETWORK_ERROR: "network_error",
@@ -3250,19 +3317,30 @@ var colorCodes = {
 	red: 31,
 	yellow: 33
 };
-/** Format text with standard ANSI terminal color escape sequences. */
+/**
+* 使用标准 ANSI 终端颜色转义序列格式化文本。
+* 给文本添加标准的 ANSI 终端颜色转义序列，使文本在终端中以指定颜色显示。
+* @param text 需要上色的原始文本
+* @param color 终端颜色名称
+* @param bold 是否加粗显示，默认 false
+* @returns 带 ANSI 颜色转义序列的文本
+*/
 function formatTerminalText(text, color, bold = false) {
 	return `${bold ? "\x1B[1m" : ""}\u001B[${colorCodes[color]}m${text}\u001B[0m`;
 }
 //#endregion
 //#region src/llm/utils.ts
 /**
-* Utility functions for LLM integration
+* LLM 集成的工具函数
 */
 var debug = console.debug.bind(console, formatTerminalText("[LLM]", "gray"));
 /**
-* Convert Zod schema to OpenAI tool format
-* Uses Zod 4 native z.toJSONSchema()
+* 将 Zod schema 转换为 OpenAI 工具格式
+* 使用 Zod 4 原生 z.toJSONSchema()
+*
+* @param name - 工具名称
+* @param tool - 工具定义
+* @returns OpenAI 格式的工具定义
 */
 function zodToOpenAITool(name, tool) {
 	return {
@@ -3275,17 +3353,21 @@ function zodToOpenAITool(name, tool) {
 	};
 }
 /**
-* Patch model specific parameters. Only patches known models.
+* 为特定模型打补丁。仅修补已知的模型。
 *
 * @purpose
-* - Reconcile the differences in the parameter schema each model accepts.
-* - Disable thinking/reasoning, or lower it to the minimum where a full disable is impossible.
-* - Minimize returned tokens.
-* - Raise temperature for known smaller models to improve auto-recovery odds.
-* @note Honor temperature if explicitly set by the user
+* - 调和各模型所接受的参数 schema 之间的差异。
+* - 禁用思考/推理，或在无法完全禁用时将其降到最低。
+* - 尽量减少返回的 token。
+* - 对已知的较小模型提高 temperature，以提升自动恢复的几率。
+* @note 若用户显式设置了 temperature 则尊重该设置
 *
-* @todo Need vendor-specific patches.
-* Local and 3rd-party hosted models may have different schema.
+* @todo 需要针对不同厂商的补丁。
+* 本地托管和第三方托管的模型可能有不同的 schema。
+*
+* @param body - 请求体对象（会就地修改）
+* @param baseURL - 模型服务的基础 URL，用于识别 provider
+* @returns 修改后的请求体对象
 */
 function modelPatch(body, baseURL) {
 	const model = body.model || "";
@@ -3402,19 +3484,25 @@ function modelPatch(body, baseURL) {
 	return body;
 }
 /**
-* check if a given model ID fits a specific model name
+* 检查给定的模型 ID 是否符合某个具体模型名称
 *
 * @note
-* Different model providers may use different model IDs for the same model.
-* For example, openai's `gpt-5.2` may called:
+* 不同的模型服务商可能对同一模型使用不同的模型 ID。
+* 例如，OpenAI 的 `gpt-5.2` 可能被命名为：
 *
 * - `gpt-5.2-version`
 * - `gpt-5_2-date`
 * - `GPT-52-version-date`
 * - `openai/gpt-5.2-chat`
 *
-* They should be treated as the same model.
-* Normalize them to `gpt-52`
+* 它们应被视为同一模型。
+* 将其归一化为 `gpt-52`
+*/
+/**
+* 归一化模型名称，将不同厂商对同一模型的命名统一为同一形式（如 `gpt-5.2` -> `gpt52`）
+*
+* @param modelName - 原始模型名称
+* @returns 归一化后的模型名称（小写、去掉前缀与特殊字符）
 */
 function normalizeModelName(modelName) {
 	let normalizedName = modelName.toLowerCase();
@@ -3423,6 +3511,12 @@ function normalizeModelName(modelName) {
 	normalizedName = normalizedName.replace(/\./g, "");
 	return normalizedName;
 }
+/**
+* 根据 baseURL 判断服务提供商（目前仅识别 openrouter）
+*
+* @param baseURL - 模型服务的基础 URL
+* @returns 'openrouter' 或 undefined
+*/
 function getProvider(baseURL) {
 	if (!baseURL) return void 0;
 	try {
@@ -3435,10 +3529,10 @@ function getProvider(baseURL) {
 //#endregion
 //#region src/llm/OpenAICompatibleClient.ts
 /**
-* OpenAI Client implementation
+* OpenAI 客户端实现
 */
 /**
-* Client for OpenAI compatible APIs
+* 兼容 OpenAI 的 API 客户端
 */
 var OpenAICompatibleClient = class {
 	config;
@@ -3447,6 +3541,16 @@ var OpenAICompatibleClient = class {
 		this.config = config;
 		this.fetch = config.customFetch;
 	}
+	/**
+	* 调用 LLM 接口并执行模型请求的工具
+	* 流程：转换工具定义 -> 构建并转换请求体 -> 调用 API -> 处理 HTTP 错误 -> 解析并校验响应 -> 执行工具
+	*
+	* @param messages - 对话消息列表
+	* @param tools - 可用工具集合
+	* @param abortSignal - 中止信号，用于取消请求
+	* @param options - 可选的调用选项
+	* @returns 工具调用结果
+	*/
 	async invoke(messages, tools, abortSignal, options) {
 		abortSignal?.throwIfAborted();
 		const openaiTools = Object.entries(tools).map(([name, t]) => zodToOpenAITool(name, t));
@@ -3564,7 +3668,7 @@ var OpenAICompatibleClient = class {
 //#endregion
 //#region src/llm/LLM.ts
 /**
-* LLM module
+* LLM 模块
 */
 var LLM = class extends EventTarget {
 	config;
@@ -3575,9 +3679,9 @@ var LLM = class extends EventTarget {
 		this.client = new OpenAICompatibleClient(this.config);
 	}
 	/**
-	* - call llm api *once*
-	* - invoke tool call *once*
-	* - return the result of the tool
+	* - 调用一次 LLM API
+	* - 调用一次工具
+	* - 返回工具执行结果
 	*/
 	async invoke(messages, tools, abortSignal, options) {
 		return await withRetry(async () => this.client.invoke(messages, tools, abortSignal, options), {
@@ -3593,7 +3697,7 @@ var LLM = class extends EventTarget {
 	}
 };
 /**
-* Retry a function until it succeeds or reaches the maximum number of retries.
+* 重试某个函数，直到成功或达到最大重试次数。
 */
 async function withRetry(fn, settings) {
 	let attempt = 0;
@@ -3609,6 +3713,12 @@ async function withRetry(fn, settings) {
 		await new Promise((resolve) => setTimeout(resolve, 100));
 	}
 }
+/**
+* 解析并校验 LLM 配置，填充默认值后返回完整配置
+*
+* @param config - 用户传入的 LLM 配置
+* @returns 解析后的完整配置
+*/
 function parseLLMConfig(config) {
 	if (!config.baseURL || !config.model) throw new Error("[PageAgent] LLM configuration required. Please provide: baseURL, model. See: https://alibaba.github.io/page-agent/docs/features/models");
 	if (config.temperature !== void 0) console.warn("[PageAgent] LLMConfig.temperature is deprecated and will be removed in a future version. Use transformRequestBody to set it only for models you have verified accept it.");
@@ -3630,16 +3740,16 @@ var system_prompt_default = "You are an AI agent designed to operate in an itera
 //#region src/agent/utils/autoFixer.ts
 var log = console.log.bind(console, formatTerminalText("[autoFixer]", "yellow"));
 /**
-* Normalize LLM response and fix common format issues.
+* 规范化 LLM 响应并修复常见的格式问题。
 *
-* Handles:
-* - No tool_calls but JSON in message.content (fallback)
-* - Model returns action name as tool call instead of AgentOutput
-* - Arguments wrapped as double JSON string
-* - Nested function call format
-* - Missing action field (fallback to wait)
-* - Primitive action input for single-field tools (e.g. `{"click_element_by_index": 2}`)
-* - etc.
+* 处理：
+* - 没有 tool_calls 但 message.content 中含 JSON（回退）
+* - 模型将动作名作为工具调用返回而非 AgentOutput
+* - 参数被双重 JSON 字符串化
+* - 嵌套的函数调用格式
+* - 缺少 action 字段（回退为 wait）
+* - 单字段工具的原始动作输入（如 `{"click_element_by_index": 2}`）
+* - 等等
 */
 function normalizeResponse(response, tools) {
 	let resolvedArguments;
@@ -3698,11 +3808,11 @@ function normalizeResponse(response, tools) {
 	};
 }
 /**
-* Validate action against tool schemas. Provides clear error messages
-* instead of letting the union schema produce unreadable errors.
+* 根据工具 schema 校验动作。提供清晰的错误信息，
+* 而不是让联合 schema 产生难以阅读的错误。
 *
-* Also coerces primitive inputs for single-field tools:
-* e.g. `{"click_element_by_index": 2}` → `{"click_element_by_index": {"index": 2}}`
+* 同时为单字段工具强制转换原始输入：
+* 如 `{"click_element_by_index": 2}` → `{"click_element_by_index": {"index": 2}}`
 */
 function validateAction(action, tools) {
 	if (typeof action !== "object" || action === null) return action;
@@ -3727,7 +3837,7 @@ function validateAction(action, tools) {
 	return { [toolName]: result.data };
 }
 /**
-* Safely parse JSON, return original input if not json.
+* 安全解析 JSON，如果不是 JSON 则返回原始输入。
 */
 function safeJsonParse(input) {
 	if (typeof input === "string") try {
@@ -3738,9 +3848,9 @@ function safeJsonParse(input) {
 	return input;
 }
 /**
-* Extract and parse JSON from a string.
-* - Treat content between the first `{` and the last `}` as JSON.
-* - Try to parse that content as JSON and return the parsed value (object/array/primitive) if successful, otherwise return null.
+* 从字符串中提取并解析 JSON。
+* - 将第一个 `{` 与最后一个 `}` 之间的内容视为 JSON。
+* - 尝试将该内容解析为 JSON 并返回解析后的值（对象/数组/原始值），成功则返回，否则返回 null。
 */
 function retrieveJsonFromString(str) {
 	try {
@@ -3754,8 +3864,8 @@ function retrieveJsonFromString(str) {
 //#endregion
 //#region src/agent/utils/index.ts
 /**
-* Wait for `seconds`. If a `signal` is provided, the wait is cancellable:
-* aborting rejects with the signal's reason (an `AbortError`).
+* 等待 `seconds` 秒。若提供了 `signal`，则等待可被取消：
+* 中止时会以 signal 的 reason（一个 `AbortError`）reject。
 */
 async function waitFor(seconds, signal) {
 	if (!signal) {
@@ -3795,8 +3905,8 @@ var _global = globalThis;
 if (!_global.__PAGE_AGENT_IDS__) _global.__PAGE_AGENT_IDS__ = [];
 var ids = _global.__PAGE_AGENT_IDS__;
 /**
-* Generate a random ID.
-* @note Unique within this window.
+* 生成一个随机 ID。
+* @note 在当前窗口内唯一。
 */
 function uid() {
 	const id = randomID(ids);
@@ -3804,7 +3914,7 @@ function uid() {
 	return id;
 }
 var llmsTxtCache = /* @__PURE__ */ new Map();
-/** Fetch /llms.txt for a URL's origin. Cached per origin, `null` = tried and not found. */
+/** 获取某个 URL 源的 /llms.txt。按源缓存，`null` 表示已尝试过但未找到。 */
 async function fetchLlmsTxt(url) {
 	let origin;
 	try {
@@ -3834,10 +3944,10 @@ async function fetchLlmsTxt(url) {
 	return result;
 }
 /**
-* Simple assertion function that throws an error if the condition is falsy
-* @param condition - The condition to assert
-* @param message - Optional error message
-* @throws Error if condition is falsy
+* 简单的断言函数：条件为假时抛出错误
+* @param condition - 要断言的条件
+* @param message - 可选的错误信息
+* @throws 条件为假时抛出错误
 */
 function assert(condition, message, silent) {
 	if (!condition) {
@@ -3847,7 +3957,7 @@ function assert(condition, message, silent) {
 	}
 }
 /**
-* Suppress errors from a function.
+* 抑制函数产生的错误。
 */
 async function suppress(fn) {
 	try {
@@ -3860,15 +3970,16 @@ async function suppress(fn) {
 //#endregion
 //#region src/agent/tools/index.ts
 /**
-* Internal tools for PageAgent.
-* @note Adapted from browser-use
+* PageAgent 的内部工具。
+* @note 改编自 browser-use
 */
+/** 创建一个工具定义（直接透传 options） */
 function tool(options) {
 	return options;
 }
 /**
-* Internal tools for PageAgent.
-* Note: Using any to allow different parameter types for each tool
+* PageAgent 的内部工具。
+* 注：使用 any 以允许每个工具拥有不同的参数类型
 */
 var tools = /* @__PURE__ */ new Map();
 tools.set("done", tool({
@@ -3929,7 +4040,7 @@ tools.set("select_dropdown_option", tool({
 	}
 }));
 /**
-* @note Reference from browser-use
+* @note 参考自 browser-use
 */
 tools.set("scroll", tool({
 	description: "Scroll vertically. Without index: scrolls the document. With index: scrolls the container at that index (or its nearest scrollable ancestor). Use index of a data-scrollable element to scroll a specific area.",
@@ -3947,7 +4058,7 @@ tools.set("scroll", tool({
 	}
 }));
 /**
-* @todo Tables need a dedicated parser to extract structured data. This tool is useless.
+* @todo 表格需要专门的解析器来提取结构化数据。这个工具有点鸡肋。
 */
 tools.set("scroll_horizontally", tool({
 	description: "Scroll horizontally. Without index: scrolls the document. With index: scrolls the container at that index (or its nearest scrollable ancestor). Use index of a data-scrollable element to scroll a specific area.",
@@ -3972,81 +4083,92 @@ tools.set("execute_javascript", tool({
 //#endregion
 //#region src/agent/AgentRuntime.ts
 /**
-* AI agent for browser automation.
+* 用于浏览器自动化的 AI 智能体。
 *
 * @remarks
-* ## Re-act Agent Loop
-* - step
-*    - observe (gather information about current environment and context)
-*    - think (LLM calling)
-*      - reflection (evaluate history, generate memory, short-term planning)
-*      - action (give the action to approach the next goal)
-*    - act (execute the action)
-* - loop
+* ## 反应式 Agent 循环
+* - 步骤
+*    - 观察（收集当前环境与上下文信息）
+*    - 思考（调用 LLM）
+*      - 反思（评估历史、生成记忆、短期规划）
+*      - 行动（给出接近下一个目标的动作）
+*    - 执行（执行动作）
+* - 循环
 *
-* ## Event System
-* - `statuschange` - Agent status transitions (idle → running → completed/error/stopped)
-* - `historychange` - History events updated (persistent, part of agent memory)
-* - `activity` - Real-time activity feedback (transient, for UI only)
-* - `dispose` - Agent cleanup triggered
+* ## 事件系统
+* - `statuschange` - Agent 状态变更（idle → running → completed/error/stopped）
+* - `historychange` - 历史事件更新（持久化，属于 Agent 记忆的一部分）
+* - `activity` - 实时活动反馈（瞬态，仅用于 UI）
+* - `dispose` - 触发 Agent 清理
 *
-* ## Information Streams
-* 1. **History Events** (`history` array)
-*    - Persistent event stream that forms agent's memory
-*    - Included in LLM context across steps
-*    - Types: steps, observations, user takeovers, llm errors
+* ## 信息流
+* 1. **历史事件**（`history` 数组）
+*    - 构成 Agent 记忆的持久事件流
+*    - 跨步骤包含在 LLM 上下文中
+*    - 类型：步骤、观察、用户接管、LLM 错误
 *
-* 2. **Activity Events** (via `activity` event)
-*    - Transient UI feedback during task execution
-*    - NOT included in LLM context
-*    - Types: thinking, executing, executed, retrying, error
+* 2. **活动事件**（通过 `activity` 事件）
+*    - 任务执行期间的瞬时 UI 反馈
+*    - 不包含在 LLM 上下文中
+*    - 类型：thinking、executing、executed、retrying、error
 */
 var AgentRuntime = class extends EventTarget {
+	/** Agent 唯一 ID */
 	id = uid();
+	/** 合并后的 Agent 配置（含最大步数上限） */
 	config;
+	/** 内部工具集合（按工具名索引） */
 	tools;
-	/** BrowserController for DOM operations */
+	/** 用于 DOM 操作的 BrowserController */
 	browserController;
+	/** 当前任务描述 */
 	task = "";
+	/** 当前任务 ID */
 	taskId = "";
-	/** History events */
+	/** 历史事件 */
 	history = [];
-	/** Whether this agent has been disposed */
+	/** 该 Agent 是否已被销毁 */
 	disposed = false;
 	/**
-	* Called when the agent needs to ask the user questions.
-	* If unset, the `ask_user` tool will be disabled.
-	* Implementations should reject the promise when `signal` aborts.
+	* 当 Agent 需要向用户提问时调用。
+	* 若未设置，`ask_user` 工具将被禁用。
+	* 实现应在 `signal` 中止时 reject 该 Promise。
 	* @example onAskUser: (q) => window.prompt(q) || ''
 	*/
 	onAskUser;
+	/** 当前 Agent 状态 */
 	#status = "idle";
+	/** LLM 实例（负责模型调用） */
 	#llm;
 	/**
-	* Task cancellation primitive: its signal reaches the LLM fetch, tools
-	* (via `ctx.signal`) and async callbacks. Aborted only by `stop`/`dispose`
-	* (during a task) or task setup, always WITHOUT a reason so `signal.reason`
-	* stays a standard `AbortError`.
+	* 任务取消原语：其 signal 会传递给 LLM fetch、工具（通过 `ctx.signal`）和异步回调。
+	* 仅由 `stop`/`dispose`（任务进行中）或任务初始化时中止，且始终不带 reason，
+	* 这样 `signal.reason` 保持为标准的 `AbortError`。
 	*/
 	#abortController = new AbortController();
+	/** 本轮任务收集的观察消息（暂存，稍后统一写入历史） */
 	#observations = [];
-	/** Resolves when the current run has fully settled. Awaited by `stop()`. */
+	/** 当前任务在 history 数组中的起始下标（用于跨任务保留历史时，把 prompt/循环检测限定在当前任务范围内） */
+	#taskHistoryStart = 0;
+	/** 当前一次运行完全结束时 resolve。由 `stop()` 等待。 */
 	#running = Promise.resolve();
 	#lastResult = null;
-	/** internal states during a single task execution */
+	/** 单次任务执行期间的内部状态 */
 	#states = {
-		/** Accumulated wait time in seconds */
+		/** 累计等待时间（秒） */
 		totalWaitTime: 0,
-		/** For detecting navigation */
+		/** 用于检测页面导航 */
 		lastURL: "",
-		/** Browser state */
+		/** 浏览器状态 */
 		browserState: null
 	};
+	/** 构造函数：初始化配置、LLM、工具集，并注册重试事件监听与注入自定义工具 */
 	constructor(config) {
 		super();
 		this.config = {
 			...config,
-			maxSteps: config.maxSteps ?? 40
+			maxSteps: config.maxSteps ?? 40,
+			historyWindow: config.historyWindow ?? 5
 		};
 		this.#llm = new LLM(this.config);
 		this.tools = new Map(tools);
@@ -4080,31 +4202,35 @@ var AgentRuntime = class extends EventTarget {
 		}
 		if (!this.config.experimentalScriptExecutionTool) this.tools.delete("execute_javascript");
 	}
-	/** Get current agent status */
+	/** 获取当前 Agent 状态 */
 	get status() {
 		return this.#status;
 	}
-	/** Result of the most recent run, or `null` before the first run completes. */
+	/** 最近一次运行的结果，首次运行完成前为 `null`。 */
 	get lastResult() {
 		return this.#lastResult;
 	}
-	/** Emit statuschange event */
+	/** 当前任务自身的历史事件（不含之前任务留下的记录），用于 prompt 拼装、循环检测等按任务隔离的场景 */
+	get #currentTaskHistory() {
+		return this.history.slice(this.#taskHistoryStart);
+	}
+	/** 触发 statuschange 事件 */
 	#emitStatusChange() {
 		this.dispatchEvent(new Event("statuschange"));
 	}
-	/** Emit historychange event */
+	/** 触发 historychange 事件 */
 	#emitHistoryChange(pushHistoricalEvent) {
 		if (pushHistoricalEvent) this.history.push(pushHistoricalEvent);
 		this.dispatchEvent(new Event("historychange"));
 	}
 	/**
-	* Emit activity event - for transient UI feedback
-	* @param activity - Current agent activity
+	* 触发 activity 事件 - 用于瞬态的 UI 反馈
+	* @param activity - 当前的 Agent 活动
 	*/
 	#emitActivity(activity) {
 		this.dispatchEvent(new CustomEvent("activity", { detail: activity }));
 	}
-	/** Update status and emit event */
+	/** 更新状态并触发事件 */
 	#setStatus(status) {
 		if (this.#status !== status) {
 			this.#status = status;
@@ -4112,17 +4238,17 @@ var AgentRuntime = class extends EventTarget {
 		}
 	}
 	/**
-	* Push an observation message to the history event stream.
-	* This will be visible in <agent_history> and remain persistent in memory across steps.
+	* 向历史事件流推送一条观察消息。
+	* 它会出现在 <agent_history> 中，并在跨步骤的记忆中保持持久。
 	* @experimental @internal
-	* @note history change will be emitted before next step starts
+	* @note 历史变更会在下一步开始前触发
 	*/
 	pushObservation(content) {
 		this.#observations.push(content);
 	}
 	/**
-	* Stop the current task and wait until the run has fully settled (including lifecycle hooks).
-	* @note never await .stop() in a lifecycle hook.
+	* 停止当前任务，并等待运行完全结束（包括生命周期钩子）。
+	* @note 切勿在生命周期钩子中 await .stop()。
 	*/
 	async stop() {
 		if (this.#status !== "running") return;
@@ -4130,8 +4256,8 @@ var AgentRuntime = class extends EventTarget {
 		await this.#running;
 	}
 	/**
-	* external errors (pre-checks/config/hooks) will threw;
-	* agent errors will be caught and added to history, and return a failed result
+	* 外部错误（前置检查/配置/钩子）会直接抛出；
+	* Agent 内部错误会被捕获并加入历史，同时返回失败结果
 	*/
 	async execute(task) {
 		if (this.disposed) throw new Error("PageAgent has been disposed. Create a new instance.");
@@ -4139,7 +4265,11 @@ var AgentRuntime = class extends EventTarget {
 		if (!task) throw new Error("Task is required");
 		this.task = task;
 		this.taskId = uid();
-		this.history = [];
+		this.#taskHistoryStart = this.history.length;
+		this.#emitHistoryChange({
+			type: "task_start",
+			task
+		});
 		this.#observations = [];
 		this.#states = {
 			totalWaitTime: 0,
@@ -4180,7 +4310,7 @@ var AgentRuntime = class extends EventTarget {
 					taskResult = {
 						success: false,
 						data: message,
-						history: this.history
+						history: this.#currentTaskHistory
 					};
 					this.#lastResult = taskResult;
 					finalStatus = "error";
@@ -4238,7 +4368,7 @@ var AgentRuntime = class extends EventTarget {
 						taskResult = {
 							success,
 							data,
-							history: this.history
+							history: this.#currentTaskHistory
 						};
 						this.#lastResult = taskResult;
 						finalStatus = "completed";
@@ -4260,14 +4390,14 @@ var AgentRuntime = class extends EventTarget {
 					taskResult = {
 						success: false,
 						data: message,
-						history: this.history
+						history: this.#currentTaskHistory
 					};
 					this.#lastResult = taskResult;
 					finalStatus = isAbortError ? "stopped" : "error";
 					break;
 				} finally {
 					console.groupEnd();
-					await onAfterStep?.(this, this.history);
+					await onAfterStep?.(this, this.#currentTaskHistory);
 				}
 				step++;
 			}
@@ -4289,13 +4419,13 @@ var AgentRuntime = class extends EventTarget {
 		}
 	}
 	/**
-	* Merge all tools into a single MacroTool with the following input:
+	* 将所有工具合并为单个 MacroTool，其输入如下：
 	* - thinking: string
 	* - evaluation_previous_goal: string
 	* - memory: string
 	* - next_goal: string
 	* - action: { toolName: toolInput }
-	* where action must be selected from tools defined in this.tools
+	* 其中 action 必须从 this.tools 中定义的工具中选择
 	*/
 	#packMacroTool() {
 		const tools = this.tools;
@@ -4354,7 +4484,7 @@ var AgentRuntime = class extends EventTarget {
 		};
 	}
 	/**
-	* Get system prompt, dynamically replace language settings based on configured language
+	* 获取系统提示词，根据配置的语言动态替换语言设置
 	*/
 	#getSystemPrompt() {
 		if (this.config.customSystemPrompt) return this.config.customSystemPrompt;
@@ -4362,7 +4492,7 @@ var AgentRuntime = class extends EventTarget {
 		return system_prompt_default.replace(/Default working language: \*\*.*?\*\*/, `Default working language: **${targetLanguage}**`);
 	}
 	/**
-	* Get instructions from config
+	* 从配置中获取指令
 	*/
 	async #getInstructions() {
 		const { instructions, experimentalLlmsTxt } = this.config;
@@ -4384,12 +4514,12 @@ var AgentRuntime = class extends EventTarget {
 		return result;
 	}
 	/**
-	* Generate system observations before each step
-	* @todo console error
+	* 在每一步之前生成系统观察
+	* @todo 控制台错误
 	*/
 	async #handleObservations(step) {
 		if (this.#states.totalWaitTime >= 3) this.pushObservation(`You have waited ${this.#states.totalWaitTime} seconds accumulatively. DO NOT wait any longer unless you have a good reason.`);
-		const recentSteps = this.history.filter((e) => e.type === "step").slice(-3);
+		const recentSteps = this.#currentTaskHistory.filter((e) => e.type === "step").slice(-3);
 		if (recentSteps.length === 3) {
 			const isSameAction = (a, b) => a.action.name === b.action.name && JSON.stringify(a.action.input) === JSON.stringify(b.action.input);
 			if (isSameAction(recentSteps[0], recentSteps[1]) && isSameAction(recentSteps[1], recentSteps[2])) this.pushObservation(`⚠️ Loop detected: you repeated the exact same action ("${recentSteps[0].action.name}" with identical input) 3 times in a row with no new result. STOP repeating it. If the target genuinely does not exist (e.g. search returns empty), report this explicitly and call \`done\`, or try a clearly different action/strategy instead.`);
@@ -4415,11 +4545,15 @@ var AgentRuntime = class extends EventTarget {
 			this.#emitHistoryChange();
 		}
 	}
+	/**
+	* 组装发给 LLM 的完整用户提示词（含指令、Agent 状态、历史、浏览器状态）
+	*/
 	async #assembleUserPrompt() {
 		const browserState = this.#states.browserState;
 		let prompt = "";
 		prompt += await this.#getInstructions();
-		const stepCount = this.history.filter((e) => e.type === "step").length;
+		const currentTaskHistory = this.#currentTaskHistory;
+		const stepCount = currentTaskHistory.filter((e) => e.type === "step").length;
 		prompt += "<agent_state>\n";
 		prompt += "<user_request>\n";
 		prompt += `${this.task}\n`;
@@ -4429,10 +4563,10 @@ var AgentRuntime = class extends EventTarget {
 		prompt += `Current time: ${(/* @__PURE__ */ new Date()).toLocaleString()}\n`;
 		prompt += "</step_info>\n";
 		prompt += "</agent_state>\n\n";
-		const windowStart = Math.max(0, stepCount - 5);
+		const windowStart = Math.max(0, stepCount - this.config.historyWindow);
 		prompt += "<agent_history>\n";
 		let stepIndex = 0;
-		for (const event of this.history) if (event.type === "step") {
+		for (const event of currentTaskHistory) if (event.type === "step") {
 			stepIndex++;
 			if (stepIndex <= windowStart) {
 				prompt += `<step_${stepIndex}>Action: ${event.action.name} — Next Goal: ${event.reflection.next_goal}</step_${stepIndex}>\n`;
@@ -4457,6 +4591,7 @@ var AgentRuntime = class extends EventTarget {
 		prompt += "</browser_state>\n\n";
 		return prompt;
 	}
+	/** 销毁 Agent：中止任务、释放浏览器控制器，并触发 dispose 事件（一次性） */
 	dispose() {
 		if (this.disposed) return;
 		this.disposed = true;
@@ -4479,8 +4614,13 @@ var AgentRuntime = class extends EventTarget {
 };
 //#endregion
 //#region src/agent/MyPageAgent.ts
+/**
+* 完整页面智能体：组合了 AgentRuntime、BrowserController 与 UI
+*/
 var MyPageAgent = class extends AgentRuntime {
+	/** UI 实例（用于用户交互与反馈） */
 	ui;
+	/** 构造函数：创建浏览器控制器、父类运行时与 UI 实例 */
 	constructor(config) {
 		const browserController = new BrowserController({
 			...config,
@@ -4499,6 +4639,11 @@ var MyPageAgent = class extends AgentRuntime {
 };
 //#endregion
 //#region src/index.ts
+/**
+* 创建智能体实例的快捷函数，内部直接实例化 MyPageAgent。
+* @param config 智能体的配置对象
+* @returns 创建好的 MyPageAgent 实例
+*/
 function createAgent(config) {
 	return new MyPageAgent(config);
 }