123

.gitignore

@@ -0,0 +1,19 @@
+target/
+.idea/
+*.iml
+*.ipr
+*.iws
+.project
+.classpath
+.settings/
+.vscode/
+*.log
+logs/
+*.class
+.DS_Store
+Thumbs.db
+node_modules/
+dist/
+.env
+.env.local
+.cursor

huimv-employment/app/.env.development

@@ -1,2 +1,2 @@
 # 开发环境 API 地址
-VUE_APP_BASE_API=http://192.168.1.6:8080/api/v1/mp
+VUE_APP_BASE_API=http://115.238.57.190:5200/api/v1/mp

huimv-employment/app/api/conversation.js

@@ -0,0 +1,83 @@
+import { AI_AGENT_ID } from '@/common/config.js'
+import { get, post } from '@/utils/request.js'
+import { streamSseRequest } from '@/utils/sse-stream.js'
+
+/**
+ * 查询当前用户的 AI 对话会话列表
+ * @param {{
+ *   status?: 'active' | 'archived',
+ *   chatType?: string,
+ *   enterpriseId?: number
+ * }} params
+ */
+export function listConversations(params = {}, options = {}) {
+	return get('/conversations', params, options)
+}
+
+/**
+ * 新建 AI 对话会话
+ * @param {{
+ *   title?: string,
+ *   chatType?: string,
+ *   conversationNo?: string,
+ *   enterpriseId?: number
+ * }} data
+ * @returns {Promise<{
+ *   id: number,
+ *   conversationNo: string,
+ *   enterpriseId: number,
+ *   title?: string,
+ *   chatType: string,
+ *   status: string,
+ *   lastMessageAt?: string,
+ *   createTime?: string
+ * }>}
+ */
+export function createConversation(data = {}, options = {}) {
+	return post('/conversations', data, options)
+}
+
+/**
+ * 查询会话消息列表（按 create_time 正序分页，page=1 为最早消息）
+ * @param {number} conversationId
+ * @param {{ page?: number, size?: number }} params
+ */
+export function listConversationMessages(conversationId, params = {}, options = {}) {
+	return get(`/conversations/${conversationId}/messages`, params, options)
+}
+
+/**
+ * 会话内 AI 对话（SSE 流式 + 服务端落库）
+ * @param {{
+ *   conversationId: number,
+ *   message: string,
+ *   agentId?: string,
+ *   onDelta?: (text: string) => void,
+ *   onDone?: () => void,
+ *   onError?: (err: Error) => void
+ * }} options
+ * @returns {() => void} abort
+ */
+export function streamConversationChat(options = {}) {
+	const {
+		conversationId,
+		message,
+		agentId = AI_AGENT_ID,
+		onDelta,
+		onDone,
+		onError
+	} = options
+
+	return streamSseRequest({
+		url: `/conversations/${conversationId}/chat`,
+		data: { message },
+		header: {
+			'X-Agent-Id': agentId
+		},
+		onChunk: (delta) => {
+			if (onDelta) onDelta(delta)
+		},
+		onDone,
+		onError
+	})
+}

huimv-employment/app/common/config.js

@@ -1,5 +1,5 @@
 /** 开发环境兜底地址（HBuilderX 编译时可能未注入 .env） */
-const DEV_BASE_API = 'http://192.168.1.6:8080/api/v1/mp'
+const DEV_BASE_API = 'http://115.238.57.190:5200/api/v1/mp'
 
 /** API 基础路径，优先 .env，开发环境兜底 */
 export const BASE_API =
@@ -11,3 +11,6 @@ export const TOKEN_KEY = 'fe_token'
 
 /** 后端统一响应成功码 */
 export const SUCCESS_CODE = 200
+
+/** 智能体 ID，对应请求头 X-Agent-Id */
+export const AI_AGENT_ID = process.env.VUE_APP_AI_AGENT_ID || 'default'

huimv-employment/app/common/fe.scss

@@ -267,6 +267,9 @@ page {
 	align-items: flex-start;
 	gap: 20rpx;
 	margin-bottom: 32rpx;
+	width: 100%;
+	max-width: 100%;
+	box-sizing: border-box;
 }
 
 .fe-chat-msg--user {
@@ -274,7 +277,7 @@ page {
 }
 
 .fe-chat-bubble {
-	flex: 1;
+	flex: 1 1 0;
 	min-width: 0;
 	max-width: calc(100% - 88rpx);
 	padding: 24rpx 32rpx;
@@ -282,6 +285,17 @@ page {
 	font-size: 28rpx;
 	line-height: 1.6;
 	box-sizing: border-box;
+	overflow: hidden;
+}
+
+.fe-chat-bubble__text {
+	display: block;
+	width: 100%;
+	max-width: 100%;
+	word-wrap: break-word;
+	word-break: break-word;
+	white-space: pre-wrap;
+	box-sizing: border-box;
 }
 
 .fe-chat-msg--ai .fe-chat-bubble {
@@ -482,6 +496,40 @@ page {
 	height: 14rpx;
 	border-radius: 50%;
 	background: $fe-primary-light;
+	animation: fe-thinking-bounce 1.4s infinite ease-in-out both;
+}
+
+.fe-thinking-dots__dot:nth-child(2) {
+	animation-delay: 0.16s;
+}
+
+.fe-thinking-dots__dot:nth-child(3) {
+	animation-delay: 0.32s;
+}
+
+.fe-thinking-dots--inline {
+	display: flex;
+	align-items: center;
+	gap: 10rpx;
+	min-height: 40rpx;
+	padding: 0;
+	background: transparent;
+	border: none;
+	border-radius: 0;
+}
+
+@keyframes fe-thinking-bounce {
+	0%,
+	80%,
+	100% {
+		transform: scale(0.55);
+		opacity: 0.35;
+	}
+
+	40% {
+		transform: scale(1);
+		opacity: 1;
+	}
 }
 
 /* ===== INPUT BAR ===== */

huimv-employment/app/components/chat/FeCostSheet.vue

@@ -41,10 +41,10 @@
 										<text>{{ plan.icon }}</text>
 										<text>{{ plan.title }}</text>
 									</view>
-									<view class="fe-cost-card__toggle" @tap.stop="toggleExpand(plan.id)">
+									<view class="fe-cost-card__toggle" @tap.stop="toggleExpandByIndex(planIndex)">
 										<view
 											class="fe-cost-card__chevron"
-											:class="{ 'fe-cost-card__chevron--up': isExpanded(plan.id) }"
+											:class="{ 'fe-cost-card__chevron--up': isExpandedByIndex(planIndex) }"
 										/>
 									</view>
 								</view>
@@ -53,21 +53,33 @@
 									<text class="fe-info-row__label">人均成本</text>
 									<text class="fe-info-row__value">{{ plan.avgCost }}</text>
 								</view>
-								<block v-if="isExpanded(plan.id)">
-									<view v-for="(row, i) in plan.rows" :key="'r-' + i" class="fe-info-row">
+								<view v-if="isExpandedByIndex(planIndex)" class="fe-cost-card__detail">
+									<view
+										v-for="(row, rowIdx) in plan.rows"
+										:key="rowIdx"
+										class="fe-info-row"
+									>
 										<text class="fe-info-row__label">{{ row.label }}</text>
 										<text class="fe-info-row__value">{{ row.value }}</text>
 									</view>
 									<view v-if="plan.breakdown" class="fe-cost-card__breakdown">
-										<view v-for="(row, i) in plan.breakdown" :key="'b-' + i" class="fe-info-row">
+										<view
+											v-for="(row, bdIdx) in plan.breakdown"
+											:key="bdIdx"
+											class="fe-info-row"
+										>
 											<text class="fe-info-row__label">{{ row.label }}</text>
 											<text class="fe-info-row__value">{{ row.value }}</text>
 										</view>
 									</view>
 									<view v-if="plan.compliance" class="fe-compliance">
-										<text v-for="(badge, i) in plan.compliance" :key="'c-' + i" class="fe-compliance-badge">✓ {{ badge }}</text>
+										<text
+											v-for="(badge, cmIdx) in plan.compliance"
+											:key="cmIdx"
+											class="fe-compliance-badge"
+										>✓ {{ badge }}</text>
 									</view>
-								</block>
+								</view>
 							</view>
 
 							<view class="fe-cost-card fe-cost-card--muted">
@@ -135,7 +147,14 @@ export default {
 			if (this.expandedPlans[id] === undefined) return true
 			return !!this.expandedPlans[id]
 		},
-		toggleExpand(id) {
+		isExpandedByIndex(index) {
+			const plan = this.plans[index]
+			return plan ? this.isExpanded(plan.id) : true
+		},
+		toggleExpandByIndex(index) {
+			const plan = this.plans[index]
+			if (!plan) return
+			const id = plan.id
 			this.$set(this.expandedPlans, id, !this.expandedPlans[id])
 		}
 	}
@@ -227,6 +246,10 @@ export default {
 	padding-top: 16rpx;
 }
 
+.fe-cost-card__detail {
+	width: 100%;
+}
+
 .fe-cost-card--muted {
 	opacity: 0.65;
 	margin-bottom: 0;

huimv-employment/app/components/home/EnterpriseHome.vue

@@ -2,19 +2,19 @@
 	<view class="chat-page">
 		<view class="chat-header">
 			<view class="chat-header__row">
-				<view class="fe-nav-btn" @tap="openSidebar">
+				<view class="fe-nav-btn guide-target guide-target--sidebar" @tap="openSidebar">
 					<text class="fe-nav-icon">☰</text>
 				</view>
 				<text class="chat-header__title">智能用工助手</text>
 				<view class="chat-header__actions">
-					<view class="fe-nav-btn" @tap="newChat">
+					<view class="fe-nav-btn guide-target guide-target--new-chat" @tap="newChat">
 						<text class="fe-nav-icon fe-nav-icon--plus">+</text>
 					</view>
-					<view class="fe-nav-btn" @tap="openDrawer('message')">
+					<view class="fe-nav-btn guide-target guide-target--message" @tap="openDrawer('message')">
 						<text class="fe-nav-icon">🔔</text>
 						<view class="fe-nav-badge">2</view>
 					</view>
-					<view class="fe-nav-avatar" @tap="openDrawer('profile')">{{ user.avatarText }}</view>
+					<view class="fe-nav-avatar guide-target guide-target--avatar" @tap="openDrawer('profile')">{{ user.avatarText }}</view>
 				</view>
 			</view>
 		</view>
@@ -26,16 +26,24 @@
 				<view class="sidebar-head__add" @tap="newChat">＋</view>
 			</view>
 			<scroll-view scroll-y class="sidebar-list" :show-scrollbar="false">
-				<view
-					v-for="s in sessions"
-					:key="s.id"
-					class="fe-sidebar-item"
-					:class="{ 'fe-sidebar-item--active': currentSession === s.id }"
-					@tap="switchSession(s.id)"
-				>
-					<view class="fe-sidebar-item__title">{{ s.title }}</view>
-					<view class="fe-sidebar-item__time">{{ s.time }}</view>
+				<view v-if="sessionsLoading" class="sidebar-status">
+					<text class="sidebar-status__text">加载中...</text>
 				</view>
+				<view v-else-if="!sessions.length" class="sidebar-status sidebar-status--action" @tap="newChat">
+					<text class="sidebar-status__text sidebar-status__text--action">开启新对话</text>
+				</view>
+				<block v-else>
+					<view
+						v-for="(s, sessionIdx) in sessions"
+						:key="s.conversationNo"
+						class="fe-sidebar-item"
+						:class="{ 'fe-sidebar-item--active': currentSession === s.conversationNo }"
+						@tap="switchSessionByIndex(sessionIdx)"
+					>
+						<view class="fe-sidebar-item__title">{{ s.title }}</view>
+						<view class="fe-sidebar-item__time">{{ s.time }}</view>
+					</view>
+				</block>
 			</scroll-view>
 		</view>
 
@@ -43,18 +51,45 @@
 		<scroll-view
 			class="chat-area"
 			scroll-y
+			:scroll-top="scrollTop"
 			:scroll-into-view="scrollIntoView"
+			:scroll-with-animation="scrollWithAnimation"
 			:show-scrollbar="false"
 			:enhanced="true"
+			:upper-threshold="80"
 			@scroll="onChatScroll"
+			@scrolltoupper="onChatScrollToUpper"
 		>
 			<view class="chat-area__inner">
-				<block v-for="(msg, idx) in messages" :key="idx">
+				<view v-if="showNewChatEmpty" class="chat-empty">
+					<view class="chat-empty__icon">💬</view>
+					<text class="chat-empty__title">{{ newChatGreeting }}</text>
+					<view class="chat-empty__btn" @tap="newChat">开启新对话</view>
+				</view>
+				<block v-else>
+				<view v-if="messagesLoading" class="chat-status">
+					<text class="chat-status__text">加载消息中...</text>
+				</view>
+				<block v-else>
+				<view v-if="messagesLoadingMore" class="chat-status chat-status--top">
+					<text class="chat-status__text">加载历史消息...</text>
+				</view>
+				<view v-else-if="!hasMoreHistory && hasMessageHistory" class="chat-status chat-status--top">
+					<text class="chat-status__text chat-status__text--muted">没有更多消息了</text>
+				</view>
+				<view v-for="(msg, idx) in messages" :key="msg.msgKey" class="chat-msg-wrap">
 					<!-- Plain text -->
 					<view v-if="msg.type === 'text'" class="fe-chat-msg" :class="'fe-chat-msg--' + msg.role" :id="'msg-' + idx">
 						<view v-if="msg.role === 'ai'" class="fe-chat-avatar fe-chat-avatar--ai">AI</view>
 						<view v-if="msg.role === 'user'" class="fe-chat-avatar fe-chat-avatar--user">{{ user.avatarText }}</view>
-						<view class="fe-chat-bubble"><text>{{ msg.content }}</text></view>
+						<view class="fe-chat-bubble">
+							<view v-if="msg.streaming && !msg.content" class="fe-thinking-dots fe-thinking-dots--inline">
+								<view class="fe-thinking-dots__dot" />
+								<view class="fe-thinking-dots__dot" />
+								<view class="fe-thinking-dots__dot" />
+							</view>
+							<text v-else class="fe-chat-bubble__text" user-select>{{ msg.content }}</text>
+						</view>
 					</view>
 
 					<!-- Report card -->
@@ -143,16 +178,10 @@
 							</view>
 						</view>
 					</view>
-				</block>
-
-				<view v-if="thinking" class="fe-chat-msg fe-chat-msg--ai">
-					<view class="fe-chat-avatar fe-chat-avatar--ai">AI</view>
-					<view class="fe-thinking-dots">
-						<view class="fe-thinking-dots__dot" />
-						<view class="fe-thinking-dots__dot" />
-						<view class="fe-thinking-dots__dot" />
-					</view>
 				</view>
+				<view id="chat-bottom-anchor" class="chat-bottom-anchor" />
+				</block>
+				</block>
 			</view>
 		</scroll-view>
 
@@ -160,7 +189,7 @@
 
 		<!-- Footer: Quick Actions + Input -->
 		<view class="chat-footer">
-			<view class="fe-quick-actions fe-quick-actions--dock">
+			<view class="fe-quick-actions fe-quick-actions--dock guide-target guide-target--quick-bar">
 				<view class="fe-quick-action" @tap="triggerAI('发布需求')">
 					<view class="fe-quick-action__icon" style="background:#FEF3C7;">➕</view>
 					<text class="fe-quick-action__label">发布需求</text>
@@ -281,10 +310,21 @@ import FeReportSheet from '@/components/chat/FeReportSheet.vue'
 import FeReportFloat from '@/components/chat/FeReportFloat.vue'
 import FeBatchQrModal from '@/components/chat/FeBatchQrModal.vue'
 import store from '@/common/store.js'
-import { CHAT_SESSIONS, CHAT_DATA, MESSAGES, showToast } from '@/common/chat-data.js'
+import { MESSAGES, showToast } from '@/common/chat-data.js'
+import { listConversations, createConversation, streamConversationChat, listConversationMessages } from '@/api/conversation.js'
+import {
+	getNewChatGreeting,
+	mapConversationItem,
+	mapConversationMessage,
+	calcLastMessagePage,
+	CONVERSATION_MESSAGE_PAGE_SIZE
+} from '@/utils/conversation.js'
 
 export default {
 	name: 'EnterpriseHome',
+	options: {
+		styleIsolation: 'shared'
+	},
 	props: {
 		active: { type: Boolean, default: true }
 	},
@@ -302,20 +342,34 @@ export default {
 		return {
 			user: {},
 			enterprise: {},
-			sessions: CHAT_SESSIONS,
-			currentSession: 'employment',
+			sessions: [],
+			sessionsLoading: false,
+			creatingSession: false,
+			currentSession: '',
+			currentConversationId: null,
 			messages: [],
+			messagesLoading: false,
+			messagesLoadingMore: false,
+			historyPage: 1,
+			hasMoreHistory: false,
+			hasMessageHistory: false,
+			messagePageSize: CONVERSATION_MESSAGE_PAGE_SIZE,
 			inputText: '',
 			canSend: false,
-			thinking: false,
+			chatStreaming: false,
+			abortChat: null,
+			scrollTop: 0,
 			scrollIntoView: '',
+			scrollWithAnimation: true,
+			stickToBottom: true,
 			sidebarOpen: false,
 			activeSheet: '',
 			activeDrawer: '',
 			modal: '',
 			inbox: MESSAGES,
 			reportCardVisible: true,
-			reportObserver: null
+			reportObserver: null,
+			_localMsgSeq: 0
 		}
 	},
 	computed: {
@@ -328,6 +382,12 @@ export default {
 		showReportFloat() {
 			return this.hasReportMessage && !this.reportCardVisible
 		},
+		showNewChatEmpty() {
+			return !this.sessionsLoading && !this.currentSession && !this.sessions.length
+		},
+		newChatGreeting() {
+			return getNewChatGreeting()
+		},
 		sheetElevated() {
 			return this.modal === 'qr' && this.activeSheet === 'progress'
 		}
@@ -349,44 +409,285 @@ export default {
 	},
 	beforeDestroy() {
 		this.disconnectReportObserver()
+		this.stopChatStream()
+		if (this._scrollTimer) clearTimeout(this._scrollTimer)
 	},
 	methods: {
 		toast: showToast,
-		initHome() {
+		async initHome() {
 			const s = store.getState()
 			this.user = s.user
 			this.enterprise = s.enterprise
-			if (!this.messages.length) {
-				this.loadSession('employment')
+			await this.fetchSessions({ autoLoad: true })
+		},
+		async fetchSessions(options = {}) {
+			const { autoLoad = false, showError = false } = options
+			this.sessionsLoading = true
+			try {
+				const list = await listConversations({ status: 'active' }, { showError })
+				this.sessions = (list || []).map(mapConversationItem)
+				if (autoLoad) {
+					if (this.sessions.length) {
+						const current = this.sessions.find((item) => item.conversationNo === this.currentSession)
+						const target = current || this.sessions[0]
+						await this.loadSession(target.conversationNo, target.chatType)
+					} else if (!this.currentSession) {
+						this.messages = []
+					}
+				}
+			} catch (e) {
+				if (autoLoad && !this.currentSession) {
+					this.messages = []
+				}
+			} finally {
+				this.sessionsLoading = false
 			}
 		},
-		loadSession(id) {
-			this.currentSession = id
-			this.messages = JSON.parse(JSON.stringify(CHAT_DATA[id] || []))
+		buildWelcomeMessages() {
+			return [{
+				type: 'text',
+				role: 'ai',
+				content: getNewChatGreeting(),
+				msgKey: this.nextLocalMsgKey()
+			}]
+		},
+		nextLocalMsgKey() {
+			this._localMsgSeq += 1
+			return -this._localMsgSeq
+		},
+		resetMessagePagination() {
+			this.historyPage = 1
+			this.hasMoreHistory = false
+			this.hasMessageHistory = false
+			this.messagesLoading = false
+			this.messagesLoadingMore = false
+		},
+		async loadSession(conversationNo, chatType) {
+			this.abortChatStream()
+			this.currentSession = conversationNo
+			const session = this.sessions.find((item) => item.conversationNo === conversationNo)
+			this.currentConversationId = session ? session.id : null
+			this.resetMessagePagination()
+			this.messages = []
 			this.reportCardVisible = true
-			this.scrollBottom()
+			await this.fetchLatestMessages({ scrollBottom: true })
 			this.$nextTick(() => {
 				this.setupReportObserver()
 				setTimeout(() => this.checkReportVisibility(), 120)
 			})
 		},
-		switchSession(id) {
+		async fetchLatestMessages(options = {}) {
+			const { scrollBottom = false } = options
+			if (!this.currentConversationId) {
+				this.messages = this.buildWelcomeMessages()
+				return
+			}
+
+			this.messagesLoading = true
+			try {
+				const probe = await listConversationMessages(
+					this.currentConversationId,
+					{ page: 1, size: this.messagePageSize },
+					{ showError: true }
+				)
+				const total = probe.total || 0
+				if (!total) {
+					this.messages = this.buildWelcomeMessages()
+					this.hasMoreHistory = false
+					this.hasMessageHistory = false
+					return
+				}
+
+				const lastPage = calcLastMessagePage(total, this.messagePageSize)
+				let pageData = probe
+				if (lastPage > 1) {
+					pageData = await listConversationMessages(
+						this.currentConversationId,
+						{ page: lastPage, size: this.messagePageSize },
+						{ showError: true }
+					)
+				}
+
+				this.historyPage = lastPage
+				this.hasMoreHistory = lastPage > 1
+				this.hasMessageHistory = true
+				this.messages = (pageData.items || []).map(mapConversationMessage)
+				if (scrollBottom) {
+					this.stickToBottom = true
+					this.ensureChatBottom()
+				}
+			} catch (e) {
+				this.messages = this.buildWelcomeMessages()
+				this.hasMoreHistory = false
+				this.hasMessageHistory = false
+			} finally {
+				this.messagesLoading = false
+			}
+		},
+		measureChatContentHeight() {
+			return new Promise((resolve) => {
+				const query = uni.createSelectorQuery().in(this)
+				query.select('.chat-area__inner').boundingClientRect()
+				query.exec((res) => {
+					resolve((res[0] && res[0].height) || 0)
+				})
+			})
+		},
+		restoreScrollAfterPrepend(beforeHeight, beforeTop) {
+			return new Promise((resolve) => {
+				this.$nextTick(() => {
+					setTimeout(async () => {
+						const afterHeight = await this.measureChatContentHeight()
+						const delta = afterHeight - beforeHeight
+						this._programmaticScroll = true
+						this.scrollWithAnimation = false
+						this._scrollBump = (this._scrollBump || 0) + 1
+						this.scrollTop = Math.max(0, beforeTop + delta) + this._scrollBump
+						setTimeout(() => {
+							this._programmaticScroll = false
+							resolve()
+						}, 60)
+					}, 50)
+				})
+			})
+		},
+		async loadMoreHistory() {
+			if (
+				!this.hasMoreHistory ||
+				this.messagesLoadingMore ||
+				this.messagesLoading ||
+				this.chatStreaming ||
+				!this.currentConversationId
+			) {
+				return
+			}
+
+			const olderPage = this.historyPage - 1
+			if (olderPage < 1) {
+				this.hasMoreHistory = false
+				return
+			}
+
+			this.messagesLoadingMore = true
+			try {
+				const beforeHeight = await this.measureChatContentHeight()
+				const beforeTop = this._lastScrollTop || 0
+				const pageData = await listConversationMessages(
+					this.currentConversationId,
+					{ page: olderPage, size: this.messagePageSize },
+					{ showError: false }
+				)
+				const older = (pageData.items || []).map(mapConversationMessage)
+				if (!older.length) {
+					this.hasMoreHistory = false
+					return
+				}
+
+				this.messages = [...older, ...this.messages]
+				this.historyPage = olderPage
+				this.hasMoreHistory = olderPage > 1
+				await this.restoreScrollAfterPrepend(beforeHeight, beforeTop)
+			} catch (e) {
+				// 错误提示由 request.js 统一处理
+			} finally {
+				this.messagesLoadingMore = false
+			}
+		},
+		onChatScrollToUpper() {
+			this.loadMoreHistory()
+		},
+		switchSession(conversationNo) {
+			if (this.currentSession === conversationNo) {
+				this.sidebarOpen = false
+				return
+			}
 			this.sidebarOpen = false
-			this.loadSession(id)
+			const session = this.sessions.find((item) => item.conversationNo === conversationNo)
+			this.loadSession(conversationNo, session && session.chatType)
+		},
+		switchSessionByIndex(index) {
+			const session = this.sessions[index]
+			if (!session) return
+			this.switchSession(session.conversationNo)
 		},
-		newChat() {
+		async newChat() {
+			if (this.creatingSession) return
+			this.creatingSession = true
 			this.sidebarOpen = false
-			this.loadSession('employment')
-			this.toast('已开启新对话')
+			try {
+				const created = await createConversation({
+					chatType: 'employment',
+					title: '新对话'
+				})
+				const item = mapConversationItem(created)
+				this.sessions = [
+					item,
+					...this.sessions.filter((session) => session.conversationNo !== item.conversationNo)
+				]
+				this.loadSession(item.conversationNo, item.chatType)
+				this.toast('已开启新对话')
+			} catch (e) {
+				// 错误提示由 request.js 统一处理
+			} finally {
+				this.creatingSession = false
+			}
 		},
-		scrollBottom() {
-			this.$nextTick(() => {
-				const last = this.messages.length - 1
-				if (last >= 0) this.scrollIntoView = 'msg-' + last
+		scrollBottom(animated = true, force = false) {
+			if (!force && !this.stickToBottom && !this.chatStreaming) return
+			if (this._scrollTimer) clearTimeout(this._scrollTimer)
+			this._scrollTimer = setTimeout(() => {
+				this._scrollTimer = null
+				this.scrollWithAnimation = !!animated
+				this._programmaticScroll = true
+				this._scrollBump = (this._scrollBump || 0) + 1
+				this.scrollTop = 100000 + this._scrollBump
+				setTimeout(() => {
+					this._programmaticScroll = false
+				}, animated ? 300 : 60)
 				setTimeout(() => this.checkReportVisibility(), 120)
+			}, animated ? 40 : 0)
+		},
+		scrollToBottomAnchor() {
+			this.scrollIntoView = ''
+			this.$nextTick(() => {
+				this.scrollIntoView = 'chat-bottom-anchor'
+			})
+		},
+		ensureChatBottom() {
+			this.stickToBottom = true
+			const scroll = () => {
+				this.scrollBottom(false, true)
+				this.scrollToBottomAnchor()
+			}
+			this.$nextTick(() => {
+				scroll()
+				setTimeout(scroll, 60)
+				setTimeout(scroll, 180)
+				setTimeout(scroll, 360)
 			})
 		},
-		onChatScroll() {
+		onChatScroll(e) {
+			const detail = e.detail || {}
+			this._lastScrollTop = detail.scrollTop || 0
+			if (this._programmaticScroll) {
+				this.checkReportVisibility()
+				return
+			}
+			const gap = (detail.scrollHeight || 0) - (detail.scrollTop || 0) - (detail.clientHeight || 0)
+			if (this.chatStreaming) {
+				// 流式输出时内容可能突增，仅当明显上滑才取消贴底
+				if (gap > 280) this.stickToBottom = false
+			} else {
+				this.stickToBottom = gap < 120
+			}
+			if (
+				!this.chatStreaming &&
+				!this.messagesLoading &&
+				!this.messagesLoadingMore &&
+				this._lastScrollTop <= 20
+			) {
+				this.loadMoreHistory()
+			}
 			this.checkReportVisibility()
 		},
 		setupReportObserver() {
@@ -426,32 +727,81 @@ export default {
 			this.openSheet('report')
 		},
 		onInput() {
-			this.canSend = this.inputText.trim().length > 0
+			this.canSend = this.inputText.trim().length > 0 && !this.chatStreaming
+		},
+		stopChatStream() {
+			if (this.abortChat) {
+				this.abortChat()
+				this.abortChat = null
+			}
+			this.chatStreaming = false
+		},
+		abortChatStream() {
+			if (this.abortChat) {
+				this.abortChat()
+				this.abortChat = null
+			}
 		},
 		sendMsg() {
 			const text = this.inputText.trim()
-			if (!text) return
-			this.messages.push({ type: 'text', role: 'user', content: text })
+			if (!text || this.chatStreaming) return
+			if (!this.currentConversationId) {
+				this.toast('请先开启新对话')
+				return
+			}
+
+			this.abortChatStream()
+			this.stickToBottom = true
+			this.messages.push({ type: 'text', role: 'user', content: text, msgKey: this.nextLocalMsgKey() })
+			const aiIdx = this.messages.length
+			this.messages.push({
+				type: 'text',
+				role: 'ai',
+				content: '',
+				streaming: true,
+				msgKey: this.nextLocalMsgKey()
+			})
 			this.inputText = ''
 			this.canSend = false
-			this.thinking = true
+			this.chatStreaming = true
 			this.scrollBottom()
-			setTimeout(() => {
-				this.thinking = false
-				if (/招|搬运|临时工/.test(text)) {
-					this.messages.push({ type: 'text', role: 'ai', content: '好的，已为您分析需求。正在生成用工草稿...' })
-					this.scrollBottom()
-					setTimeout(() => {
-						this.messages.push({ type: 'draft', role: 'ai' })
-						this.scrollBottom()
-					}, 600)
-				} else {
-					this.messages.push({ type: 'text', role: 'ai', content: '我理解您的问题，我可以帮您：发布用工需求、测算成本、查看进度、管理订单。请告诉我您具体想做什么？' })
-					this.scrollBottom()
+
+			this.abortChat = streamConversationChat({
+				conversationId: this.currentConversationId,
+				message: text,
+				onDelta: (delta) => {
+					const current = this.messages[aiIdx].content || ''
+					this.$set(this.messages[aiIdx], 'content', current + delta)
+					const force = (delta && delta.length > 80)
+					this.scrollBottom(false, force)
+					if (force) {
+						this.$nextTick(() => this.scrollBottom(false, true))
+					}
+				},
+				onDone: () => {
+					this.$set(this.messages[aiIdx], 'streaming', false)
+					if (!this.messages[aiIdx].content) {
+						this.$set(this.messages[aiIdx], 'content', '暂无回复，请稍后重试')
+					}
+					this.ensureChatBottom()
+					this.stopChatStream()
+					this.fetchSessions({ showError: false })
+				},
+				onError: (err) => {
+					this.$set(this.messages[aiIdx], 'streaming', false)
+					const message = (err && err.message) || '对话失败，请稍后重试'
+					if (!this.messages[aiIdx].content) {
+						this.$set(this.messages[aiIdx], 'content', message)
+					} else {
+						this.toast(message)
+					}
+					this.ensureChatBottom()
+					this.stopChatStream()
 				}
-			}, 1200)
+			})
 		},
 		triggerAI(text) {
+			if (this.chatStreaming) return
 			this.inputText = text
 			this.canSend = true
 			this.sendMsg()
@@ -464,6 +814,7 @@ export default {
 			this.activeSheet = ''
 			this.activeDrawer = ''
 			this.sidebarOpen = true
+			this.fetchSessions()
 		},
 		openSheet(name) {
 			this.closeAll()
@@ -606,6 +957,35 @@ export default {
 
 .chat-area__inner {
 	padding: 32rpx;
+	padding-bottom: 48rpx;
+}
+
+.chat-msg-wrap {
+	width: 100%;
+}
+
+.chat-status {
+	display: flex;
+	justify-content: center;
+	padding: 24rpx 0 8rpx;
+}
+
+.chat-status--top {
+	padding: 8rpx 0 24rpx;
+}
+
+.chat-status__text {
+	font-size: 24rpx;
+	color: $fe-gray-500;
+}
+
+.chat-status__text--muted {
+	color: $fe-gray-400;
+}
+
+.chat-bottom-anchor {
+	height: 2rpx;
+	width: 100%;
 }
 
 .sidebar-head {
@@ -636,4 +1016,64 @@ export default {
 .sidebar-list {
 	height: calc(100% - 120rpx);
 }
+
+.sidebar-status {
+	padding: 48rpx 28rpx;
+	text-align: center;
+}
+
+.sidebar-status__text {
+	font-size: 26rpx;
+	color: $fe-gray-500;
+}
+
+.sidebar-status--action {
+	cursor: pointer;
+}
+
+.sidebar-status__text--action {
+	color: $fe-primary;
+	font-weight: 600;
+}
+
+.chat-empty {
+	min-height: 100%;
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	justify-content: center;
+	padding: 80rpx 48rpx;
+	text-align: center;
+	box-sizing: border-box;
+}
+
+.chat-empty__icon {
+	width: 120rpx;
+	height: 120rpx;
+	border-radius: 50%;
+	background: $fe-primary-bg;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	font-size: 56rpx;
+	margin-bottom: 32rpx;
+}
+
+.chat-empty__title {
+	font-size: 36rpx;
+	font-weight: 700;
+	color: $fe-foreground;
+	margin-bottom: 48rpx;
+	line-height: 1.5;
+	max-width: 520rpx;
+}
+
+.chat-empty__btn {
+	padding: 24rpx 64rpx;
+	border-radius: $fe-radius-full;
+	background: $fe-primary;
+	color: #fff;
+	font-size: 30rpx;
+	font-weight: 600;
+}
 </style>

huimv-employment/app/mixins/enterprise-home-guide.js

@@ -0,0 +1,132 @@
+import store from '@/common/store.js'
+
+import {
+
+	buildNoviceGuidanceSteps,
+
+	isEnterpriseHomeGuideDone,
+
+	NOVICE_GUIDANCE_BASE_CONFIG,
+
+	resolveGuideUserKey,
+
+	setEnterpriseHomeGuideDone
+
+} from '@/utils/home-guide.js'
+
+
+
+export default {
+
+	data() {
+
+		return {
+
+			homeGuideBaseConfig: NOVICE_GUIDANCE_BASE_CONFIG,
+
+			homeGuideSteps: buildNoviceGuidanceSteps()
+
+		}
+
+	},
+
+	methods: {
+
+		getEnterpriseHomeContext() {
+
+			const ref = this.$refs.enterpriseHome
+
+			if (Array.isArray(ref)) return ref[0] || null
+
+			return ref || null
+
+		},
+
+		buildGuideRuntimeConfig() {
+
+			const context = this.getEnterpriseHomeContext()
+
+			const steps = buildNoviceGuidanceSteps().map((step) => ({
+
+				...step,
+
+				context: () => context
+
+			}))
+
+			return { steps, baseConfig: this.homeGuideBaseConfig }
+
+		},
+
+		onHomeGuideEnded() {
+
+			const state = store.getState()
+
+			setEnterpriseHomeGuideDone(resolveGuideUserKey(state.user, state.enterprise))
+
+		},
+
+		startHomeGuide() {
+
+			const guide = this.$refs.noviceGuidance
+
+			const context = this.getEnterpriseHomeContext()
+
+			if (!guide || !context || typeof guide.start !== 'function') return false
+
+
+
+			const { steps, baseConfig } = this.buildGuideRuntimeConfig()
+
+			if (typeof guide.setConfig === 'function') {
+
+				guide.setConfig(steps, baseConfig)
+
+			}
+
+
+
+			setTimeout(() => guide.start(), 80)
+
+			return true
+
+		},
+
+		scheduleHomeGuide() {
+
+			if (this.viewRole !== 'enterprise') return
+
+			const state = store.getState()
+
+			const guideUserKey = resolveGuideUserKey(state.user, state.enterprise)
+
+			if (isEnterpriseHomeGuideDone(guideUserKey)) return
+
+
+
+			const tryStart = (attempt = 0) => {
+
+				if (this.viewRole !== 'enterprise' || !this.ready) return
+
+				if (!this.startHomeGuide() && attempt < 15) {
+
+					setTimeout(() => tryStart(attempt + 1), 150)
+
+				}
+
+			}
+
+
+
+			this.$nextTick(() => {
+
+				setTimeout(() => tryStart(), 300)
+
+			})
+
+		}
+
+	}
+
+}
+

huimv-employment/app/pages/index/index.vue

@@ -1,172 +1,390 @@
 <template>
-	<view class="index-page">
-		<view v-if="booting" class="index-boot">
-			<view class="index-boot__spinner" />
-			<text class="index-boot__text">加载中...</text>
-		</view>
 
-		<view v-else-if="needRegister" class="index-blank" />
+	<view class="index-root">
 
-		<view v-else-if="ready" class="index-home">
-			<EnterpriseHome v-if="viewRole === 'enterprise'" :active="true" />
-			<WorkerHome v-else :active="true" />
-		</view>
+		<view class="index-page">
+
+			<view v-if="booting" class="index-boot">
+
+				<view class="index-boot__spinner" />
+
+				<text class="index-boot__text">加载中...</text>
 
-		<view
-			class="fe-modal-overlay"
-			:class="{ 'fe-modal-overlay--active': registerModalVisible }"
-		/>
-		<view class="fe-modal" :class="{ 'fe-modal--active': registerModalVisible }">
-			<view class="fe-modal-body">
-				<view class="fe-modal-icon fe-modal-icon--warn">!</view>
-				<view class="fe-modal-title">{{ registerModalTitle }}</view>
-				<view class="fe-modal-desc">完成登记后即可使用全部功能</view>
 			</view>
-			<view class="fe-modal-footer">
-				<view class="fe-modal-btn fe-modal-btn--confirm index-register-btn" @tap="goRegister">去登记</view>
+
+
+
+			<view v-else-if="needRegister" class="index-blank" />
+
+
+
+			<view v-else-if="ready" class="index-home">
+
+				<EnterpriseHome
+
+					v-if="viewRole === 'enterprise'"
+
+					ref="enterpriseHome"
+
+					:active="true"
+
+				/>
+
+				<WorkerHome v-else :active="true" />
+
 			</view>
+
+
+
+			<view
+
+				class="fe-modal-overlay"
+
+				:class="{ 'fe-modal-overlay--active': registerModalVisible }"
+
+			/>
+
+			<view class="fe-modal" :class="{ 'fe-modal--active': registerModalVisible }">
+
+				<view class="fe-modal-body">
+
+					<view class="fe-modal-icon fe-modal-icon--warn">!</view>
+
+					<view class="fe-modal-title">{{ registerModalTitle }}</view>
+
+					<view class="fe-modal-desc">完成登记后即可使用全部功能</view>
+
+				</view>
+
+				<view class="fe-modal-footer">
+
+					<view class="fe-modal-btn fe-modal-btn--confirm index-register-btn" @tap="goRegister">去登记</view>
+
+				</view>
+
+			</view>
+
 		</view>
+
+
+
+		<hz-novice-guidance
+
+			v-if="ready && viewRole === 'enterprise'"
+
+			ref="noviceGuidance"
+
+			:base-config="homeGuideBaseConfig"
+
+			:steps="homeGuideSteps"
+
+			@finished="onHomeGuideEnded"
+
+			@skiped="onHomeGuideEnded"
+
+		/>
+
 	</view>
+
 </template>
 
+
+
 <script>
+
 import EnterpriseHome from '@/components/home/EnterpriseHome.vue'
+
 import WorkerHome from '@/components/home/WorkerHome.vue'
+
 import store from '@/common/store.js'
+
 import { getToken } from '@/utils/request.js'
 
+import enterpriseHomeGuide from '@/mixins/enterprise-home-guide.js'
+
+
+
 export default {
+
 	components: { EnterpriseHome, WorkerHome },
+
+	mixins: [enterpriseHomeGuide],
+
 	data() {
+
 		return {
+
 			booting: true,
+
 			ready: false,
+
 			needRegister: false,
+
 			registerModalVisible: false,
+
 			viewRole: 'enterprise'
+
 		}
+
 	},
+
 	computed: {
+
 		registerModalTitle() {
+
 			return this.viewRole === 'worker' ? '暂未临时工登记' : '暂未企业登记'
+
 		}
+
 	},
+
 	onShow() {
+
 		if (this.ready) return
+
 		if (this.needRegister) {
+
 			this.registerModalVisible = true
+
 			return
+
 		}
+
 		this.bootstrap()
+
 	},
+
 	methods: {
+
 		goLogin() {
+
 			uni.reLaunch({ url: '/pages/auth/login' })
+
 		},
+
 		goRegister() {
+
 			this.registerModalVisible = false
+
 			const url = this.viewRole === 'worker'
+
 				? '/pages/worker/register'
+
 				: '/pages/enterprise/register'
+
 			uni.navigateTo({ url })
+
 		},
+
 		resolveViewRole(info) {
+
 			return info && info.userType === 'worker' ? 'worker' : 'enterprise'
+
 		},
+
 		async bootstrap() {
+
 			this.booting = true
+
 			this.ready = false
+
 			this.needRegister = false
+
 			this.registerModalVisible = false
 
+
+
 			const token = getToken()
+
 			if (!token) {
+
 				this.goLogin()
+
 				return
+
 			}
 
+
+
 			try {
+
 				const info = await store.syncProfile({ showError: false })
+
 				store.state.loggedIn = true
+
 				store.persist()
 
+
+
 				this.viewRole = this.resolveViewRole(info)
 
+
+
 				if (!info || !info.registered) {
+
 					this.needRegister = true
+
 					this.registerModalVisible = true
+
 					return
+
 				}
 
+
+
 				this.ready = true
+
+				this.scheduleHomeGuide()
+
 			} catch (e) {
+
 				store.logout()
+
 				this.goLogin()
+
 			} finally {
+
 				this.booting = false
+
 			}
+
 		}
+
 	}
+
 }
+
 </script>
 
+
+
 <style lang="scss" scoped>
+
+.index-root {
+
+	width: 100%;
+
+	height: 100vh;
+
+}
+
+
+
 .index-page {
+
 	display: flex;
+
 	flex-direction: column;
+
 	height: 100vh;
+
 	overflow: hidden;
+
 	background: $fe-bg;
+
 	box-sizing: border-box;
+
 }
 
+
+
 .index-boot,
+
 .index-blank {
+
 	flex: 1;
+
 	height: 100%;
+
 	background: $fe-surface;
+
 }
 
+
+
 .index-boot {
+
 	display: flex;
+
 	flex-direction: column;
+
 	align-items: center;
+
 	justify-content: center;
+
 	gap: 24rpx;
+
 }
 
+
+
 .index-boot__spinner {
+
 	width: 56rpx;
+
 	height: 56rpx;
+
 	border: 4rpx solid $fe-gray-200;
+
 	border-top-color: $fe-primary;
+
 	border-radius: 50%;
+
 	animation: index-spin 0.8s linear infinite;
+
 }
 
+
+
 .index-boot__text {
+
 	font-size: 28rpx;
+
 	color: $fe-gray-500;
+
 }
 
+
+
 .index-home {
+
 	flex: 1;
+
 	height: 100%;
+
 	overflow: hidden;
+
 }
 
+
+
 .index-register-btn {
+
 	flex: 1;
+
 }
 
+
+
 .fe-modal-icon--warn {
+
 	background: $fe-warning-light;
+
 	color: $fe-warning;
+
 }
 
+
+
 @keyframes index-spin {
+
 	to {
+
 		transform: rotate(360deg);
+
 	}
+
 }
+
 </style>
+

huimv-employment/app/uni_modules/hz-novice-guidance/changelog.md

@@ -0,0 +1,13 @@
+## 1.0.3（2026-03-11）
+- feat：`baseConfig`和`steps`新增`tipContentMaxHeight`配置，用于控制提示框中内容的最大高度，当内容超过最大高度时，内容可滚动查看，防止内容过高超出屏幕
+- fix：修复提示框高度在特殊情况下计算不准确，导致显示异常
+## 1.0.2（2025-12-26）
+- feat：新增  `skipStep` 方法，可跳转任意步骤
+- feat：新增  `setConfig` 方法，由于小程序不能通过组件参数传递函数，当配置中有函数时，调用该方法进行传递配置
+- feat：`baseConfig`新增`beforeNext`、`beforeSkip`、`beforeFinished`配置，用于拦截【下一步】【跳过】【完成】，且可自定义行为
+- feat：`steps`新增`beforeNext`配置，用于拦截【下一步】，且可自定义行为
+- fix：修复提示框在右侧不显示的问题
+## 1.0.1（2025-08-15）
+文档描述修改
+## 1.0.0（2025-08-14）
+操作引导组件

huimv-employment/app/uni_modules/hz-novice-guidance/components/hz-novice-guidance/hz-novice-guidance.vue

@@ -0,0 +1,507 @@
+<template>
+	<view class="guid-full-screen-mask" @touchmove.prevent.stop v-if="showGuide">
+		<view class="element-highlight-container" :style="[highlightStyle]"></view>
+		<view class="step-tips-arrow-container" :style="[tipsArrowPositionStyle]"
+			:class="stepTipsShow ? '' : 'step-tips-hide'">
+			<slot name="arrow" :scope="currentEleConfig" v-if="customArrow">
+			</slot>
+			<view class="step-tips-arrow" :style="[tipsArrowStyle]" v-else></view>
+		</view>
+		<view class="step-tips" :class="stepTipsShow ? '' : 'step-tips-hide'" :style="[tipsWidthStyle,tipsStyle]">
+			<scroll-view class="step-tips-content" :style="[tipsContentStyle]" scroll-y>
+				<slot name="tips" :scope="currentStepExportInfo">
+					<view>
+						<rich-text :nodes="currentEleConfig.tips || ''"></rich-text>
+					</view>
+				</slot>
+			</scroll-view>
+			<slot name="btns" v-if="!isOuterBtn" :scope="currentStepExportInfo">
+				<view class="step-tips-bottom">
+					<view v-if="showSkip" class="step-tips-jump" :style="[skipStyle]" @click="beforeSkip">{{
+						skipText
+					}}</view>
+					<view class="step-tips-btn" :style="[nextStyle]" @click="beforeNext">{{ nextText }}</view>
+				</view>
+			</slot>
+		</view>
+		<view class="step-tips-btn-outer-container" v-if="isOuterBtn" :class="stepTipsShow ? '' : 'step-tips-hide'"
+			:style="[outerBtnStyle]">
+			<slot name="btns" :scope="currentStepExportInfo">
+				<view class="step-tips-btn-outer">
+					<view v-if="showSkip" class="step-tips-btn-outer-jump" :style="[skipStyle]" @click="beforeSkip">{{
+            skipText
+          }}</view>
+					<view class="step-tips-btn-outer-next" :style="[nextStyle]" @click="beforeNext">{{
+            nextText
+          }}</view>
+				</view>
+			</slot>
+		</view>
+	</view>
+</template>
+<!--
+  新手引导组件
+-->
+<script>
+	import useArrow from './mixins/useArrow.js'
+	import useGetDomInfo from './mixins/useGetDomInfo.js'
+	import useOuterBtn from './mixins/useOuterBtn.js'
+	import useStepTips from './mixins/useStepTips.js'
+	import useGuard from './mixins/useGuard.js'
+	export default {
+		mixins: [useGetDomInfo, useArrow, useOuterBtn, useStepTips, useGuard],
+		props: {
+			// 总体配置
+			baseConfig: {
+				type: Object,
+				default: () => ({})
+			},
+			// 步骤信息
+			steps: {
+				type: Array,
+				default: () => []
+			},
+		},
+		data() {
+			return {
+				// 系统信息
+				systemInfo: uni.getSystemInfoSync(),
+				// 引导组件实例
+				instance: null,
+				// 是否显示引导
+				showGuide: false,
+				// 当前步骤
+				currentStep: -1,
+				// 当前步骤元素信息
+				currentEleInfo: null,
+				// 实际渲染后的元素信息
+				currentEleAfterRenderInfo: null,
+				// 提示框展示位置
+				tipsPosition: '',
+				// 显示步骤提示弹框
+				stepTipsShow: false,
+				
+				//存储临时配置，用于更改配置
+				tempBaseConfig: null,
+				// 步骤列表
+				stepList: null
+			}
+		},
+		computed: {
+			// 合并后的总体配置
+			realBaseConfig() {
+				return {
+					scrollTime: 100,
+					customArrow: false,
+					autoRotateArrow: true,
+					showSkip: true,
+					tipMaxWidth: '70vw',
+					...(this.tempBaseConfig || {}),
+				}
+			},
+			// 当前步骤元素配置
+			currentEleConfig() {
+				return this.stepList[this.currentStep] || {}
+			},
+			// 高亮元素样式
+			highlightStyle() {
+				if (!this.currentEleInfo) return {}
+				const {
+					top,
+					left,
+					width,
+					height
+				} = this.currentEleInfo
+				const {
+					style,
+					offset
+				} = this.currentEleConfig
+
+				return {
+					'--bgcolor': 'rgba(0, 0, 0, 0.5)',
+					...(this.realBaseConfig?.highligthStyle || {}),
+					...(style || {}),
+					top: top + (offset?.top || 0) + 'px',
+					left: left + (offset?.left || 0) + 'px',
+					width: width + 'px',
+					height: height + 'px',
+				}
+			},
+			// 高亮元素信息
+			highlightElementInfo() {
+				const _highlightStyle = this.highlightStyle
+				const needFields = ['top', 'left', 'width', 'height']
+				const info = {}
+				for (const field of needFields) {
+					info[field] = _highlightStyle[field] ? parseFloat(_highlightStyle[field].split('px')[0]) : 0
+				}
+				return info
+			},
+			// 提示框最大宽度
+			tipsWidthStyle() {
+				return {
+					'--max-width': this.realBaseConfig.tipMaxWidth || '70vw'
+				}
+			},
+			// 提示框内容样式（最大高度）
+			tipsContentStyle() {
+				if (!this.tipsPosition) return {};
+				
+				const { top, height } = this.highlightElementInfo || {}
+				const { tipContentMaxHeight } = this.realBaseConfig || {}
+				const { tipContentMaxHeight: currentTipContentMaxHeight } = this.currentEleConfig || {}
+				const defaultMaxHeight = this.tipsPosition == 'bottom' 
+					? `calc(100vh - ${top || 0}px - ${height || 0}px - 30rpx - 60px)`
+					: `calc(${top || 0}px - 30rpx - 60px)`
+				const maxHeight = currentTipContentMaxHeight || tipContentMaxHeight || defaultMaxHeight
+				
+				return {
+					'max-height': maxHeight
+				}
+			},
+			// 当前步骤暴露出去的信息
+			currentStepExportInfo() { 
+				return {
+          currentEle: this.currentEleConfig,
+          highlightEle: this.highlightElementInfo,
+          tipsEle: this.tipsElementInfo,
+          outerBtnEle: this.outerBtnDomInfo,
+          tipsPosition:this.tipsPosition,
+          currentStep:this.currentStep,
+        }
+			}
+		},
+		watch: {
+			steps: {
+				handler(val) {
+					this.stepList = val || []
+				},
+				immediate: true
+			},
+			baseConfig: {
+				handler(val) {
+					this.tempBaseConfig = val || {}
+				},
+				immediate: true
+			}
+		},
+		created() {
+			this.instance = this
+			this.systemInfo = uni.getSystemInfoSync()
+		},
+		methods: {
+			// 设置配置，主要用于小程序参数中不能直接传递函数的问题
+			setConfig(steps, baseConfig = {}) {
+				this.stepList = steps || []
+				this.tempBaseConfig = baseConfig || {}
+			},
+			// 获取配置
+			getBaseConfigByKey(key, isBoolean = false) {
+				const val = this.currentEleConfig?.[key]
+				if (!isBoolean) {
+					return val || this.realBaseConfig?.[key] || false
+				}
+				if (typeof val != 'undefined' && typeof val != null) {
+					return val
+				}
+				return this.realBaseConfig?.[key] || false
+			},
+			// 延迟
+			sleep(time) {
+				return new Promise((resolve) => {
+					setTimeout(() => {
+						resolve(null)
+					}, time)
+				})
+			},
+			// 获取步骤元素信息
+			async getHighlightElementInfo(step = 0) {
+				if (!this.stepList[step]) return null
+				const {
+					el
+				} = this.stepList[step]
+				let info = await this.getDomInfo(el, this.getContext(this.stepList[step], this.instance), true)
+				return info
+			},
+			// 检查高亮元素是否全部在可视区域内，如果不在，则进行页面滚动
+			async checkHighlightElementInScreen() {
+				const scrollTime = this.realBaseConfig.scrollTime
+				let info = await this.getHighlightElementInfo(this.currentStep)
+				// 窗口高度，h5 取屏幕高度，其他取窗口高度
+				let wHeight = this.systemInfo.windowHeight
+				// #ifdef H5
+				wHeight = this.systemInfo.screenHeight
+				// #endif
+				const {
+					top,
+					bottom,
+					scrollTop
+				} = info
+
+				let isScroll = false
+				const gutter = 20
+				if (top - scrollTop < 0) {
+					uni.pageScrollTo({
+						scrollTop: top - scrollTop - gutter,
+						duration: scrollTime
+					})
+					isScroll = true
+				} else if (bottom > wHeight) {
+					uni.pageScrollTo({
+						scrollTop: bottom - wHeight + scrollTop + gutter,
+						duration: scrollTime
+					})
+					isScroll = true
+				}
+				if (isScroll) {
+					await this.sleep(scrollTime * 1.5)
+					info = await this.getHighlightElementInfo(this.currentStep)
+				}
+				this.currentEleInfo = info
+			},
+			// 判断提示框展示位置（上/下）
+			async checkTipsPosition() {
+				const res = await this.getDomInfo('.element-highlight-container', this.instance)
+				this.currentEleAfterRenderInfo = res
+				if (res.top + res.height / 2 > this.systemInfo.screenHeight / 2) {
+					this.tipsPosition = 'top'
+				} else {
+					this.tipsPosition = 'bottom'
+				}
+			},
+			// 计算各元素信息
+			async calcElementsInfo() {
+				await this.sleep(300)
+				this.checkTipsPosition()
+				await this.getTipsDomInfo()
+				this.customArrow && this.getArrowDomInfo()
+				this.isOuterBtn && this.getOuterBtnDomInfo()
+				this.stepTipsShow = true
+			},
+			// 检查下一步
+			checkStep(currentStep) {
+				const step = currentStep < this.stepList.length - 1 ? currentStep : -1
+				if (step == -1) {
+					this.beforeFinished()
+					return step
+				}
+				return step
+			}, 
+			// 下一步
+			async next() {
+				const step = this.checkStep(this.currentStep)
+				if(step == -1) return;
+				this.stepChange(step + 1)
+				await this.checkHighlightElementInScreen()
+				this.calcElementsInfo()
+			},
+			// 跳转步骤
+			skipStep(stepIndex = undefined, config = {}) {
+				// 不传或传空，默认为当前步骤的下一步
+				if(stepIndex === '' || stepIndex == null || typeof stepIndex == 'undefined'){
+					stepIndex = this.currentStep + 1
+				}
+				let formatStepIndex = Number(stepIndex)
+				if(isNaN(formatStepIndex)) {
+					console.error(`请传入正确的步骤索引：${stepIndex}`)
+					return
+				}
+				formatStepIndex = formatStepIndex >= 0 ? formatStepIndex : -1
+				if(formatStepIndex == -1) {
+					console.error(`步骤索引应大于等于0：${stepIndex}`)
+					return
+				}
+				
+				const {globalBeforeNextDisabled, beforeNextHandleDisabled} = config || {}
+				// 下一步函数
+				const next = () => {
+					if(this.checkStep(formatStepIndex) == -1) return;
+					this.start(formatStepIndex)
+				}
+				// 执行全局守卫函数
+				const handleStepBeforeNext = () => {
+					this.handleStepBeforeNext({
+						to: this.stepList[formatStepIndex] || null,
+						next: next,
+					}, next)
+				}
+				// 执行当前步骤守卫函数
+				const handleBeforeNext = () => {
+					this.beforeNext({
+						to: this.stepList[formatStepIndex] || null,
+						next: next,
+					}, next)
+				}
+				
+				// 不执行前置守卫
+				if (globalBeforeNextDisabled && beforeNextHandleDisabled) {
+					next()
+				} else if (globalBeforeNextDisabled && !beforeNextHandleDisabled) {
+					// 不执行全局前置守卫，执行当前步骤前置守卫
+					handleStepBeforeNext()
+				} else if (!globalBeforeNextDisabled && beforeNextHandleDisabled) {
+					// 执行全局前置守卫，不执行当前步骤前置守卫
+					handleBeforeNext()
+				} else {
+					// 都执行
+					this.handleStepBeforeNext({
+						to: this.stepList[formatStepIndex] || null,
+						next: handleBeforeNext,
+					}, handleBeforeNext)
+				}
+			},
+			// 完成引导
+			finish() {
+				this.beforeFinished()
+			},
+			handleFinished() {
+				this.showGuide = false
+				this.reset()
+				this.$emit('finished')
+			},
+			// 跳过
+			skip() {
+				this.beforeFinished()
+			},
+			handleSkip() {
+				this.showGuide = false
+				this.reset()
+				this.$emit('skiped')
+			},
+			// 步骤改变
+			stepChange(step = 0) {
+				this.stepTipsShow = false
+				this.currentStep = step
+				this.$emit('next', step, this.currentStepExportInfo)
+				// this.afterNext()
+			},
+			// 开始引导
+			async start(step = 0) {
+				this.showGuide = true
+				this.stepChange(step)
+				await this.checkHighlightElementInScreen()
+				this.calcElementsInfo()
+			},
+			// 重置
+			reset() {
+				this.currentStep = 0
+				this.stepTipsShow = false
+				this.currentEleInfo = undefined
+				this.currentEleAfterRenderInfo = undefined
+			}
+		}
+	}
+</script>
+
+
+<style scoped lang="scss">
+	.guid-full-screen-mask {
+		position: fixed;
+		top: 0;
+		left: 0;
+		width: 100vw;
+		height: 100vh;
+		z-index: 999999;
+		animation: fadeIn 0.3s;
+
+		.element-highlight-container {
+			position: absolute;
+			box-shadow: 0px 0px 0px 5000px var(--bgcolor);
+			border-radius: 16rpx;
+			box-sizing: content-box;
+			transition: all 0.3s;
+		}
+	}
+
+	.step-tips-arrow-container {
+		position: absolute;
+		z-index: 10000;
+		top: 0;
+		left: 100vw;
+
+		// transition: opacity 0.3s;
+		.step-tips-arrow {
+			height: 0;
+			width: 0;
+			border-right: var(--arrow-width) solid transparent;
+			border-left: var(--arrow-width) solid transparent;
+		}
+	}
+
+	.step-tips {
+		background: #fff;
+		// min-width: 50px;
+		max-width: var(--max-width);
+		animation: fadeIn 0.3s;
+		// box-shadow: 0px 2px 9px 0px rgba(0, 0, 0, 0.1);
+		position: absolute;
+		top: 0;
+		left: -100vw;
+		z-index: 10001;
+		padding: 15rpx 20rpx;
+		font-size: 28rpx;
+		border-radius: 12rpx;
+		box-sizing: border-box;
+
+		// transition: opacity 0.3s;
+		.step-tips-bottom {
+			font-size: 26rpx;
+			margin-top: 24rpx;
+			display: flex;
+			justify-content: flex-end;
+			align-items: center;
+
+			.step-tips-jump {
+				margin-right: 24rpx;
+			}
+
+			.step-tips-btn {
+				padding: 8rpx 20rpx;
+				background: #1cbbb4;
+				color: #fff;
+				border-radius: 8rpx;
+				text-align: center;
+			}
+		}
+	}
+
+	.step-tips-hide {
+		opacity: 0 !important;
+	}
+
+	.step-tips-btn-outer-container {
+		position: absolute;
+
+		.step-tips-btn-outer {
+			font-size: 26rpx;
+			display: flex;
+			justify-content: flex-end;
+			align-items: center;
+		}
+
+		.step-tips-btn-outer-jump {
+			color: #fff;
+			margin-right: 24rpx;
+		}
+
+		.step-tips-btn-outer-next {
+			font-size: 28rpx;
+			min-width: 210rpx;
+			padding: 16rpx 24rpx;
+			background: #1cbbb4;
+			color: #fff;
+			border-radius: 8rpx;
+			text-align: center;
+		}
+	}
+
+	@keyframes fadeIn {
+		0% {
+			opacity: 0;
+		}
+
+		100% {
+			opacity: 1;
+		}
+	}
+</style>

huimv-employment/app/uni_modules/hz-novice-guidance/components/hz-novice-guidance/mixins/useArrow.js

@@ -0,0 +1,106 @@
+/**
+ * 箭头样式计算
+ * */
+export default {
+	data() {
+		return {
+			// 箭头元素信息
+			arrowDomInfo:null
+		}
+	},
+	computed: {
+		// 是否自定义箭头
+		customArrow() {
+			return this.getBaseConfigByKey('customArrow', true)
+		},
+		// 是否根据提示框显示位置自动旋转箭头
+		autoRotateArrow() {
+			return this.getBaseConfigByKey('autoRotateArrow', true)
+		},
+		// 箭头位置信息样式
+		tipsArrowPositionStyle() {
+			if (!this.currentEleAfterRenderInfo) return {}
+			const {
+				top,
+				left,
+				width,
+				height
+			} = this.currentEleAfterRenderInfo
+			const arrowWidth = this.arrowStyleInfo?.width || 0
+			const arrowHeight = this.arrowStyleInfo?.height || 0
+			const arrowTop = this.tipsPosition == 'top' ? 0 - arrowHeight : height
+			const positionStyle = {
+				top: top + arrowTop + 'px',
+				left: left + width / 2 - arrowWidth / 2 + 'px',
+			}
+			// 如果是自定义箭头，且允许箭头自动旋转，则弹窗在上方时，将箭头旋转180°
+			if (this.customArrow && this.autoRotateArrow && this.tipsPosition == 'top') {
+				positionStyle.transform = 'rotate(180deg)'
+			}
+			return positionStyle
+		},
+		// 箭头样式配置
+		arrowStyleConfig() {
+			return {
+				arrowStyle: {
+					...(this.realBaseConfig?.arrowStyle || {}),
+					...(this.currentEleConfig?.arrowStyle || {}),
+				}
+			}
+		},
+		// 箭头样式
+		tipsArrowStyle() {
+			// 如果是自定义箭头样式，则不使用默认箭头样式
+			if (this.customArrow) {
+				return {}
+			}
+			const {
+				arrowStyle
+			} = this.arrowStyleConfig
+			const {
+				width,
+				height
+			} = this.arrowStyleInfo
+			const arrowColor = arrowStyle?.color ? arrowStyle.color : '#fff'
+			const border = {
+				[this.tipsPosition == 'top' ?
+					'borderTop' :
+					'borderBottom'
+				]: `${height}px solid ${arrowColor}`,
+			}
+			
+			const _arrowStyle = {...arrowStyle}
+			delete _arrowStyle.width
+			delete _arrowStyle.height
+			
+			return {
+				...(_arrowStyle || {}),
+				...border,
+				'--arrow-width': width / 2 + 'px',
+				'--arrow-height': height + 'px',
+				'--arrow-color': arrowColor,
+			}
+		},
+		// 箭头信息
+		arrowStyleInfo() {
+			if (this.customArrow) {
+				return this.arrowDomInfo
+			}
+
+			const {
+				arrowStyle
+			} = this.arrowStyleConfig
+			return {
+				width: arrowStyle?.width ? parseFloat(arrowStyle.width) : 18,
+				height: arrowStyle?.height ? parseFloat(arrowStyle.height) : 12,
+			}
+		}
+	},
+	methods:{
+		// 获取箭头元素信息
+		async getArrowDomInfo(){
+			const res = await this.getDomInfo('.step-tips-arrow-container', this.instance)
+			this.arrowDomInfo= res
+		}
+	}
+}

huimv-employment/app/uni_modules/hz-novice-guidance/components/hz-novice-guidance/mixins/useGetDomInfo.js

@@ -0,0 +1,117 @@
+/**
+ * 获取元素信息
+ * */
+export default {
+	data() {
+		return {}
+	},
+
+	methods:{
+		// 获取元素信息
+		getDomInfo(selector, context = null, pageScroll = false) {
+			return new Promise(async (resolve, reject) => {
+				let scrollTop = 0
+				// #ifndef WEB
+				const query = uni.createSelectorQuery().in(context)
+				query
+					.select(selector)
+					.boundingClientRect(async (res) => {
+						if (pageScroll) {
+							scrollTop = await this.getPageScroll(context)
+						}
+						resolve(Object.assign(res || {}, {
+							scrollTop
+						}))
+					})
+					.exec()
+				// #endif
+				// #ifdef WEB
+				const elementQuery = document.querySelector(selector)
+				const elementRect = elementQuery.getBoundingClientRect()
+				if (pageScroll) {
+					scrollTop = await this.getPageScroll(context)
+				}
+				resolve(Object.assign(elementRect, {
+					scrollTop
+				}))
+				// #endif
+			})
+		},
+		// 获取context
+		getContext(eleConfig, instance) {
+			// #ifdef WEB
+			return null
+			// #endif
+			let context = null
+			if (typeof eleConfig.context === 'function') {
+				context = eleConfig.context()
+			} else if (Array.isArray(eleConfig.context) && eleConfig.context.length) {
+				// #ifdef VUE2
+				context = this.getChildComponentContextInVue2(eleConfig, instance)
+				// #endif
+				// #ifdef VUE3
+				context = this.getChildComponentContextInVue3(eleConfig, instance)
+				// #endif
+			} else {
+				// #ifdef MP-ALIPAY
+				context = eleConfig.context || instance.$parent.ctx
+				// #endif
+				// #ifndef MP-ALIPAY
+				context = eleConfig.context || instance.$parent
+				// #endif
+			}
+			// 如果是组件，可通过组件ref值的 $ 获取组件实例
+			// if (eleConfig.isComponent) {
+			// 	context = context?.$ || null
+			// }
+			return context
+		},
+		// vue2 环境获取子组件实例
+		getChildComponentContextInVue2(eleConfig, instance){
+			let parent = instance.$parent
+			eleConfig.context.forEach((item) => {
+				parent = parent.$refs[item]
+			})
+			return parent
+		},
+		// #ifdef VUE3
+		// vue3 环境获取子组件实例
+		getChildComponentContextInVue3(eleConfig, instance){
+			// #ifndef MP-ALIPAY
+			return this.getChildComponentContextInVue2(eleConfig, instance)
+			// #endif
+
+			// #ifdef MP-ALIPAY
+			let parent = instance.$parent
+			eleConfig.context.forEach((item) => {
+				parent = parent.$children.find((child) => {
+					return child.$attrs['hz-ref-name'] == item
+				})
+			})
+			return parent
+			// #endif
+		},
+		// #endif
+		// 获取页面滚动高度
+		getPageScroll(context = null) {
+			return new Promise((resolve, reject) => {
+				// #ifndef H5
+				const query = uni.createSelectorQuery().in(context)
+				query.selectViewport().scrollOffset((res) => {
+					resolve(res.scrollTop)
+				}).exec()
+				// #endif
+				// #ifdef H5
+				let scrollTop = document.documentElement.scrollTop
+				// 这里判断是否存在页面标题，如果存在，scrollTop 需要减去标题高度
+				const pageHeaderQuery = document.querySelector('.uni-page-head')
+				if (pageHeaderQuery) {
+					const pageHeaderRect = pageHeaderQuery?.getBoundingClientRect()
+					scrollTop += pageHeaderRect.height
+				}
+				resolve(scrollTop)
+				// #endif
+			})
+		}
+	}
+}

huimv-employment/app/uni_modules/hz-novice-guidance/components/hz-novice-guidance/mixins/useGuard.js

@@ -0,0 +1,132 @@
+/*
+	步骤守卫
+*/
+
+export default {
+	computed: {
+		// 全局前置步骤守卫
+		golbalBeforeNext() {
+			const conf = this.realBaseConfig
+			return typeof conf.beforeNext == 'function' ? conf.beforeNext : null
+		},
+		// 全局后置步骤守卫
+		golbalAfterNext() {
+			const conf = this.realBaseConfig
+			return typeof conf.afterNext == 'function' ? conf.afterNext : null
+		},
+		// 当前步骤前置步骤守卫
+		stepBeforeNext() {
+			const conf = this.currentEleConfig
+			return typeof conf.beforeNext == 'function' ? conf.beforeNext : null
+		},
+		// 当前步骤后置步骤守卫
+		stepAfterNext() {
+			const conf = this.currentEleConfig
+			return typeof conf.afterNext == 'function' ? conf.afterNext : null
+		}
+	},
+	methods:{
+		// 进入步骤，步骤已改变，但还未渲染完成
+		enterStep() {
+			
+		},
+		// 离开步骤，步骤改变前，
+		leaveStep() {
+			
+		},
+		// 全局步骤守卫（前置）
+		beforeNext(customParams = {}, callback = null) {
+			const params = {
+				to: this.stepList[this.currentStep + 1] || null,
+				from: this.currentEleConfig,
+				next: this.handleStepBeforeNext,
+				skipStep: this.skipStep,
+				index:this.currentStep,
+				...customParams
+			}
+			if (this.golbalBeforeNext) {
+				this.golbalBeforeNext(params)
+				return
+			}
+			if (typeof callback == 'function') return callback();
+			this.handleStepBeforeNext()
+		},
+		// 执行步骤守卫（前置）
+		handleStepBeforeNext(customParams = {}, callback = null) {
+			const params = {
+				to: this.stepList[this.currentStep + 1] || null,
+				from: this.currentEleConfig,
+				next: this.next,
+				skipStep: this.skipStep,
+				index: this.currentStep,
+				...customParams
+			}
+			if (this.stepBeforeNext) {
+				this.stepBeforeNext(params)
+				return
+			}
+			if (typeof callback == 'function') return callback();
+			this.next()
+		},
+		// 全局步骤守卫（后置）
+		afterNext(customParams = {}, callback = null) {
+			const params = {
+				to: this.currentEleConfig,
+				from: this.stepList[this.currentStep - 1] || null,
+				index: this.currentStep,
+				skipStep: this.skipStep,
+				...customParams 
+			}
+			if (this.golbalAfterNext) {
+				this.golbalAfterNext(params)
+			}
+			if (typeof callback == 'function') return callback();
+			this.handleStepAfterNext()
+		},
+		// 执行步骤守卫（后置）
+		handleStepAfterNext(customParams = {}) {
+			const params = {
+				to: this.stepList[this.currentStep + 1] || null,
+				from: this.currentEleConfig,
+				index:this.currentStep,
+				skipStep: this.skipStep,
+				...customParams
+			}
+			if (this.stepAfterNext) {
+				this.stepAfterNext(params)
+			}
+		},
+		// 完成引导守卫
+		beforeFinished(customParams = {}, callback = null) {
+			const realBaseConfig = this.realBaseConfig
+			if(typeof realBaseConfig.beforeFinished == "function") {
+				realBaseConfig.beforeFinished({
+					finish: this.handleFinished,
+					index:this.currentStep, 
+					from: this.currentEleConfig,
+					skipStep: this.skipStep,
+					...customParams
+				})
+				return
+			}
+			if (typeof callback == 'function') return callback();
+			this.handleFinished()
+		},
+		// 跳过守卫
+		beforeSkip(customParams = {}, callback = null) {
+			const realBaseConfig = this.realBaseConfig
+			if(typeof realBaseConfig.beforeSkip == "function") {
+				realBaseConfig.beforeSkip({
+					skip: this.handleSkip, 
+					index:this.currentStep, 
+					from: this.currentEleConfig,
+					skipStep: this.skipStep,
+					...customParams
+				})
+				return
+			}
+			if (typeof callback == 'function') return callback();
+			this.handleSkip()
+		}
+	}
+}

huimv-employment/app/uni_modules/hz-novice-guidance/components/hz-novice-guidance/mixins/useOuterBtn.js

@@ -0,0 +1,100 @@
+/**
+ * 步骤提示框计算
+ * */
+export default {
+	data() {
+		return {
+			// 外部按钮元素信息
+			outerBtnDomInfo: null,
+		}
+	},
+	computed: {
+		// 是否外部按钮
+		isOuterBtn() {
+			return this.getBaseConfigByKey('outerBtn', true)
+		},
+		// 外部按钮样式
+		outerBtnStyle() {
+			if (!this.isOuterBtn || !this.outerBtnDomInfo || !this.tipsElementInfo) return {}
+			const {
+				top,
+				left,
+				width,
+				height
+			} = this.tipsElementInfo
+			const _outerBtnDomInfo = this.outerBtnDomInfo
+			// 距提示框的上下间距
+			const gutter = 20
+			// 外部按钮top值
+			let bTop = 0
+			if (this.tipsPosition == 'top') {
+				bTop = top - gutter - _outerBtnDomInfo.height
+			} else {
+				bTop = top + gutter + height
+			}
+
+			// 检查边界情况
+			const check = (type = 'left') => {
+				// 高亮元素中间位置到屏幕右侧的距离
+				const rightDistance = this.systemInfo.windowWidth - left - width / 2
+				// 高亮元素中间位置到屏幕左侧的距离
+				const leftDistance = this.systemInfo.windowWidth - left - width / 2
+				if (type == 'left') {
+					// 检查提示框放再左侧时，位置是否合适
+					return (
+						_outerBtnDomInfo.width > width / 2 && rightDistance > _outerBtnDomInfo.width - width / 2
+					)
+				} else if (type == 'center') {
+					// 检查提示框放再中间时，位置是否合适
+					return (
+						rightDistance > _outerBtnDomInfo.width / 2 && leftDistance > _outerBtnDomInfo.width / 2
+					)
+				} else if (type == 'right') {
+					// 检查提示框放再右侧时，位置是否合适
+					return (
+						_outerBtnDomInfo.width > width / 2 && leftDistance > _outerBtnDomInfo.width - width / 2
+					)
+				}
+			}
+			// 获取left值
+			const getTipsLeft = (type = 'left') => {
+				if (type == 'left') {
+					return left
+				} else if (type == 'center') {
+					return left + width / 2 - _outerBtnDomInfo.width / 2
+				} else if (type == 'right') {
+					return left + width - _outerBtnDomInfo.width
+				}
+			}
+			// 检查提示框位置，寻找最合适的位置
+			const checkTipsPosition = (p = ['left', 'center', 'right']) => {
+				let align = ''
+				for (let i = 0; i < p.length; i++) {
+					if (check(p[i])) {
+						align = p[i]
+						break
+					}
+				}
+				return align
+			}
+
+			// 外部按钮left值
+			let bLeft = getTipsLeft(checkTipsPosition(['center', 'left', 'right']))
+			if (this.realBaseConfig.customOuterBtn) {
+				bLeft = 0
+			}
+			return {
+				top: bTop + 'px',
+				left: bLeft + 'px',
+			}
+		}
+	},
+	methods: {
+		// 获取外部按钮元素信息
+		async getOuterBtnDomInfo() {
+			const res = await this.getDomInfo('.step-tips-btn-outer-container', this.instance)
+			this.outerBtnDomInfo = res
+		},
+
+	}
+}

huimv-employment/app/uni_modules/hz-novice-guidance/components/hz-novice-guidance/mixins/useStepTips.js

@@ -0,0 +1,138 @@
+/**
+ * 步骤提示框计算
+ * */
+export default {
+	data() {
+		return {
+			// 提示框元素信息
+			tipsDomInfo: null,
+		}
+	},
+	computed: {
+		// 是否展示【跳过】按钮
+		showSkip() {
+			return this.getBaseConfigByKey('showSkip', true)
+		},
+		// 提示框样式
+		tipsStyle() {
+			if (!this.stepTipsShow || !this.tipsDomInfo || !this.currentEleAfterRenderInfo) return {
+				top: 0,
+				left: '-100vw'
+			}
+			const {
+				top,
+				left,
+				width,
+				height
+			} = this.currentEleAfterRenderInfo
+
+			const _tipsDomInfo = this.tipsDomInfo
+			const {
+				baseAlign = 'left', tipStyle
+			} = this.currentEleConfig
+			const arrowHeight = this.arrowStyleInfo?.height || 0
+			const arrowWidth = this.arrowStyleInfo?.width || 0
+			const tipsTop = this.tipsPosition == 'top' ? top - arrowHeight - _tipsDomInfo.height : top + height + arrowHeight
+			let tipsLeft = left
+
+			// 检查边界情况
+			const check = (type = 'left') => {
+				// 高亮元素中间位置到屏幕右侧的距离
+				const rightDistance = this.systemInfo.windowWidth - left - width / 2
+				// 高亮元素中间位置到屏幕左侧的距离
+				const leftDistance = left + width / 2
+				if (type == 'left') {
+					// 检查提示框放再左侧时，位置是否合适
+					return _tipsDomInfo.width > width / 2 + arrowWidth / 2 && rightDistance > _tipsDomInfo.width - width / 2
+				} else if (type == 'center') {
+					// 检查提示框放再中间时，位置是否合适
+					return rightDistance > _tipsDomInfo.width / 2 && leftDistance > _tipsDomInfo.width / 2
+				} else if (type == 'right') {
+					// 检查提示框放再右侧时，位置是否合适
+					return _tipsDomInfo.width > width / 2 + arrowWidth / 2 && leftDistance > _tipsDomInfo.width - width / 2
+				}
+			}
+			// 获取left值
+			const getTipsLeft = (type = 'left') => {
+				if (type == 'left') {
+					return left
+				} else if (type == 'center') {
+					return left + width / 2 - _tipsDomInfo.width / 2
+				} else if (type == 'right') {
+					return left + width - _tipsDomInfo.width
+				}
+			}
+
+			// 检查提示框位置，寻找最合适的位置
+			const checkTipsPosition = (p = ['left', 'center', 'right']) => {
+				let align = ''
+				for (let i = 0; i < p.length; i++) {
+					if (check(p[i])) {
+						align = p[i]
+						break
+					}
+				}
+				return align
+			}
+
+			if (baseAlign === 'left') {
+				tipsLeft = getTipsLeft(checkTipsPosition(['left', 'center', 'right']))
+			} else if (baseAlign === 'center') {
+				tipsLeft = getTipsLeft(checkTipsPosition(['center', 'left', 'right']))
+			} else if (baseAlign === 'right') {
+				tipsLeft = getTipsLeft(checkTipsPosition(['right', 'center', 'left']))
+			}
+			
+			return {
+				...(tipStyle || this.realBaseConfig.tipStyle || {}),
+				top: tipsTop + 'px',
+				left: tipsLeft + 'px',
+			}
+		},
+		// 提示框元素信息
+		tipsElementInfo() {
+			const _tipsStyle = this.tipsStyle
+			const _tipsDomInfo = this.tipsDomInfo
+			const needFields = ['top', 'left']
+			const info = {
+				width: _tipsDomInfo?.width || 0,
+				height: _tipsDomInfo?.height || 0,
+			}
+			for (const field of needFields) {
+				info[field] = _tipsStyle[field] ? parseFloat(_tipsStyle[field].split('px')[0]) : 0
+			}
+			return info
+		},
+		// 【下一步】按钮文字
+		nextText() {
+			const baseNext = this.getBaseConfigByKey('next') || '下一步'
+			return this.currentStep == this.stepList.length - 1 ?
+				this.currentEleConfig?.next || '完成' :
+				baseNext
+		},
+		// 【下一步】按钮样式
+		nextStyle() {
+			return this.getBaseConfigByKey('nextStyle') || {}
+		},
+		// 【【跳过】按钮文字
+		skipText() {
+			return this.getBaseConfigByKey('skip') || '跳过'
+		},
+		// 【跳过】按钮样式
+		skipStyle() {
+			return this.getBaseConfigByKey('skipStyle') || {}
+		},
+	},
+	methods: {
+		// 获取提示框元素信息
+		getTipsDomInfo() {
+			return new Promise((resolve) => {
+				setTimeout(async ()=>{
+					const res = await this.getDomInfo('.step-tips', this.instance)
+					this.tipsDomInfo = res
+					resolve()
+				}, 50)
+			})
+		},
+	}
+}

huimv-employment/app/uni_modules/hz-novice-guidance/package.json

@@ -0,0 +1,105 @@
+{
+	"id": "hz-novice-guidance",
+	"displayName": "操作引导组件",
+	"version": "1.0.3",
+	"description": "一个操作引导组件，支持 vue2 和 vue3，组件灵活，配置丰富。",
+	"keywords": [
+        "引导组件",
+        "步骤组件",
+        "新手引导"
+    ],
+	"repository": "",
+	"engines": {
+		"HBuilderX": "^3.1.0",
+		"uni-app": "^4.51",
+		"uni-app-x": ""
+	},
+	"dcloudext": {
+		"type": "component-vue",
+		"sale": {
+			"regular": {
+				"price": "0.00"
+			},
+			"sourcecode": {
+				"price": "0.00"
+			}
+		},
+		"contact": {
+			"qq": "835011968"
+		},
+		"declaration": {
+			"ads": "无",
+			"data": "无",
+			"permissions": "无"
+		},
+		"npmurl": "",
+		"darkmode": "x",
+		"i18n": "x",
+		"widescreen": "x"
+	},
+	"uni_modules": {
+		"dependencies": [],
+		"encrypt": [],
+		"platforms": {
+			"cloud": {
+				"tcb": "x",
+				"aliyun": "x",
+				"alipay": "x"
+			},
+			"client": {
+				"uni-app": {
+					"vue": {
+                        "vue2": {
+                        },
+                        "vue3": {
+                        }
+					},
+					"web": {
+                        "safari": {
+                        },
+                        "chrome": {
+                        }
+					},
+					"app": {
+						"vue": "-",
+						"nvue": "-",
+						"android": "-",
+						"ios": "-",
+						"harmony": "-"
+					},
+					"mp": {
+                        "weixin": {
+                        },
+                        "alipay": {
+                        },
+						"toutiao": "-",
+						"baidu": "-",
+						"kuaishou": "-",
+						"jd": "-",
+						"harmony": "-",
+						"qq": "-",
+						"lark": "-"
+					},
+					"quickapp": {
+						"huawei": "-",
+						"union": "-"
+					}
+				},
+				"uni-app-x": {
+					"web": {
+						"safari": "-",
+						"chrome": "-"
+					},
+					"app": {
+						"android": "-",
+						"ios": "-",
+						"harmony": "-"
+					},
+					"mp": {
+						"weixin": "-"
+					}
+				}
+			}
+		}
+	}
+}

huimv-employment/app/uni_modules/hz-novice-guidance/readme.md

@@ -0,0 +1,448 @@
+# hz-novice-guidance 引导组件
+
+一个操作引导组件，支持`vue2`和`vue3`，组件灵活，配置丰富。目前已测试了`h5`、`微信小程序`、`支付宝小程序`，其他平台可自行尝试。
+
+## 功能概述
+
+- ✅通过配置自定义步骤
+- ✅支持配置到子组件、孙组件
+- ✅支持自定义箭头
+- ✅支持自定义功能按钮
+- ✅支持拦截【下一步】【完成】【跳过】，并自定义行为
+
+## 配置项
+
+### 组件参数
+| 配置项 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| baseConfig | Object | {} | 步骤配置，具体配置见下方 |
+| steps | Array | [] | 步骤配置，具体配置见下方 |
+
+### baseConfig 配置项
+| 配置项 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| highligthStyle | Object | - | 高亮框自定义样式，可通过设置 --bgcolor 修改遮罩背景颜色 |
+| tipMaxWidth | String | - | 提示框最大宽度，默认 '70vw' |
+| tipStyle | Object | - | 提示框自定义样式 |
+| arrowStyle | Object | - | 步骤提示箭头样式 |
+| outerBtn | Boolean | false | 【跳过】【下一步】按钮是否在提示框内显示，为 true 时显示在提示框外 |
+| customOuterBtn | Boolean | false | 是否自定义按钮，当 outerBtn=true 时生效，为 true 时，包裹按钮的父级元素的 left 值会变成 0，方便进行定位|
+| next | String | '下一步' | 下一步按钮文字，当为最后一步时，会显示 '完成'，如需修改，可在steps中最后一步设置next值 |
+| nextStyle | Object | - | 下一步按钮样式 |
+| skip | String | '跳过' | 跳过按钮文字 |
+| skipStyle | Object | - | 跳过按钮样式 |
+| showSkip | Boolean | true | 是否显示跳过按钮 |
+| customArrow | Boolean | false | 是否自定义箭头 |
+| autoRotateArrow | Boolean | true | 箭头是否自动旋转 |
+| tipContentMaxHeight | String | '' | 提示内容最大高度，当提示内容大于该值时，可进行滚动查看。默认自动计算，不会超出屏幕 |
+| beforeNext | Function | - | 全局步骤守卫，步骤改变前触发，可用于拦截跳转或自定义行为。 回调参数：({to, from, index, next, skipStep}) |
+| beforeSkip | Function | - | 跳过守卫，【跳过】前触发，可用于拦截跳过。 回调参数：({skip, index, from, skipStep}) |
+| beforeFinished | Function | - | 完成守卫，【完成】前触发，可用于拦截完成。 回调参数：({finish, index, from, skipStep }) |
+
+### steps 配置项
+| 配置项 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| el | String | '' | 元素选择器，支持类名、id、标签名 |
+| tips | String | '' | 提示内容 |
+| context | Array/Function | [] | 上下文,当元素在子组件中时，需要传入上下文，组件的 ref 值（从外到内依次传入组件的ref名称） |
+| style | Object | - | 当前步骤高亮框元素样式，会覆盖 highligthStyle |
+| offset | Object | {top: 0, left: 0} | 元素偏移信息，在当元素位置基础上进行偏移，单位为 px |
+| tipStyle | Object | - | 提示框自定义样式，该值会覆盖 baseConfig 中的 tipStyle |
+| arrowStyle | Object | - | 步骤提示箭头样式，width/height单位应为 px |
+| baseAlign | String | 'left' | 步骤提示提示框相对于高亮元素对齐方式（最终效果会根据提示框的宽度来确定对齐方式，只是这个值的优先级会更高），可选值有left、center、right |
+| next | String | '下一步' | 同 baseConfig 中的 next |
+| nextStyle | Object | - | 同 baseConfig 中的 nextStyle |
+| showSkip | Boolean | true | 同 baseConfig 中的 showSkip |
+| skip | String | '跳过' | 同 baseConfig 中的 skip |
+| skipStyle | Object | - | 同 baseConfig 中的 skipStyle |
+| customArrow | Boolean | false | 同 baseConfig 中的 customArrow |
+| autoRotateArrow | Boolean | true | 同 baseConfig 中的 autoRotateArrow |
+| tipContentMaxHeight | String | '' | 提示内容最大高度，当提示内容大于该值时，可进行滚动查看。默认自动计算，不会超出屏幕 |
+| beforeNext | Function | - | 步骤守卫，当前步骤改变前触发，可用于拦截跳转或自定义行为。 回调参数：({to, from, index, next, skipStep})。注：baseConfig 中的 beforeNext 也会触发且先于步骤中的 beforeNext|
+
+### 组件事件
+| 事件名 | 说明 | 回调参数 |
+| --- | --- | --- |
+| next | 点击下一步按钮时触发 | stepIndex: 当前步骤索引 |
+| finished | 点击跳过按钮时触发 | - |
+| skiped | 引导结束时触发 | - |
+
+### 组件方法
+| 方法名 | 说明 | 参数 |
+| --- | --- | --- |
+| start | 开始引导 | stepIndex: 步骤索引 |
+| next | 下一步 | - |
+| skip | 跳过 | - |
+| finish | 结束 | - |
+| skipStep | 跳转任意步骤 | (stepIndex: number, {globalBeforeNextDisabled: boolean, beforeNextHandleDisabled: boolean}) ：stepIndex-步骤索引 globalBeforeNextDisabled-跳转时是否禁用全局的beforeNext函数 beforeNextHandleDisabled-跳转时是否禁用当前步骤的beforeNext函数|
+| setConfig | 设置参数，由于小程序不能通过组件参数传递函数，当配置中有函数时，需调用该方法进行传递配置 | (steps, baseConfig) |
+
+### 插槽
+| 插槽名 | 说明 |
+| --- | --- |
+| tips | 自定义内容插槽 |
+| btns | 自定义操作按钮插槽 |
+| arrow | 自定义箭头插槽， customArrow 为 true 时生效 |
+
+## 使用示例
+这里介绍了一些基本使用，更详细的使用可下载`示例项目`查看。ps: 文档示例使用的是 vue3 版本，示例项目为 vue2 版本。
+### 1. 基本使用
+```vue
+<template>
+  <view class="demo-step guide-step1" style="background: #000;"></view>
+  <view class="demo-step guide-step2" style="background: #ff5500;"></view>
+  <view class="demo-step guide-step3" style="background: #1a6840;"></view>
+  <hz-novice-guidance ref="refNoviceGuidance" :steps="steps" @finished="finished" @next="handleNext" @skiped="skiped">
+	</hz-novice-guidance>
+</template>
+
+<script setup>
+const refNoviceGuidance = ref()
+const steps = [
+  {
+    el:'.guide-step1',
+    tips:'新手引导组件，使用 vue3 + ts 开发，这里是组件说明',
+  },
+  {
+    el:'.guide-step2',
+    tips:`内容由 <span style='color:#ff5500;'>rich-text</span> 组件渲染，所以支持简单的HTML标签`,
+  },
+  {
+    el:'.guide-step3',
+    next:'朕知道了，下一个',
+    nextStyle:{
+      background:'#ff5500'
+    },
+    skip:'朕会了，跳过',
+    skipStyle:{
+      color:'#ff5500'
+    },
+    tips:'自定义按钮样式及文字',
+  },
+]
+
+const finished = ()=>{
+  console.log('引导结束')
+}
+
+const handleNext = (stepIndex)=>{
+  console.log('点击下一步', stepIndex)
+}
+
+const skiped = ()=>{
+  console.log('点击跳过')
+}
+
+
+onMounted(() => {
+  // 小程序需添加 setTimeout 
+  setTimeout(() => {
+    refNoviceGuidance.value.start()
+  }, 0)
+})
+</script>
+
+<style>
+.demo-step {
+  width: 100%; 
+  height: 100px; 
+  margin-bottom: 20px;
+}
+</style>
+```
+
+### 2. 配置到子组件
+
+```vue
+<!-- 页面组件（vue3开发的支付宝小程序，组件需加上额外参数 hz-ref-name，且值和 ref 值一致）-->
+<template>
+	<father ref="refFather" hz-ref-name="refFather"></father>
+</template>
+
+<!--  father组件 -->
+<template>
+  <view class="father-container ">
+    <view>我是父组件</view>
+    <child ref="refChild" hz-ref-name="refChild">
+    </child>
+  </view>
+</template>
+
+<!-- child组件 -->
+<template>
+  <view class="child-container">
+    <view>
+      我是子组件
+    </view>
+    <grandson ref="refGrandson" hz-ref-name="refGrandson"></grandson>
+  </view>
+</template>
+
+<!-- grandson组件 -->
+<template>
+  <view class="grandson-container">
+    我是孙组件
+  </view>
+</template>
+
+<script setup>
+const steps = [
+  {
+    // 孙组件中元素类名
+    el: '.grandson-container',
+    tips: '孙组件，el 值为孙组件中的类名',
+    // 传数组，值为每层组件的 ref 名称
+    context: ['refFather', 'refChild', 'refGrandson'],
+  },
+  {
+    // 子组件中元素类名
+    el: '.child-container',
+    tips: '子组件',
+    // 传函数，返回子组件实例
+    context: ['refFather', 'refChild']
+  },
+]
+</script>
+```
+#### 支付宝小程序兼容性问题
+如果是`vue3`开发的`支付宝小程序`，则需在相关子组件上加上额外参数`hz-ref-name`，值和 ref 的一致，否则支付宝小程序不生效。
+### 3. 自定义提示框内容、样式
+```vue
+<template>
+	<hz-novice-guidance ref="refNoviceGuidance1" :baseConfig="baseConfig" :steps="steps">
+		<template #tips="{scope}">
+			<view class="custom-tips">
+				我是自定义的插槽内容。<br/>
+				这是配置的原内容：<rich-text :nodes="scope.currentEle.tips"></rich-text><br/>
+				<text style="color: red;">注意：通过 baseConfig 传给组件的 tipStyle 样式任然生效。</text>
+			</view>
+		</template>
+	</hz-novice-guidance>
+</template>
+
+<script setup>
+// 整体配置
+const baseConfig = {
+  highligthStyle:{
+    // 配置高亮框背景颜色
+    '--bgcolor': 'rgba(0, 0, 0, 0.8)',
+  },
+  // 提示内容样式
+  tipStyle:{
+    background: '#fecc11',
+    color:'#1a6840',
+  },
+  // 箭头样式
+  arrowStyle:{
+    color: '#fecc11',
+  }
+}
+
+const steps = [
+  {
+    el:'.guide-step6',
+    tips:`步骤传入 tipStyle 参数将覆盖 baseConfig 中的值`,
+    tipStyle:{
+      background: '#1a6840',
+      color:'#fff'
+    },
+    arrowStyle:{
+      color: '#1a6840',
+    },
+  },
+  {
+    el:'.guide-step4',
+    tips:`通过插槽 <span style='color:#ff5500;'>slot='tips'</span> 可完全自定义内容`,
+  },
+]
+</script>
+```
+### 4. 自定义箭头样式
+```vue
+<template>
+	<hz-novice-guidance ref="refNoviceGuidance" :baseConfig="baseConfig" :steps="steps" >
+		<template #arrow>
+			<view class="custom-arrow">
+				<view class="arrow"></view>
+				<view class="arrow-line"></view>
+				<view class="arrow-head"></view>
+			</view>
+		</template>
+	</hz-novice-guidance>
+</template>
+
+<script setup>
+// 整体配置
+const baseConfig = {
+  // 箭头样式
+  arrowStyle:{
+    color: '#fecc11',
+    width:36,
+    height:24,
+  }
+}
+
+const steps = [
+  {
+    el:'.guide-step13',
+    tips:`步骤参数中的 arrowStyle 会覆盖组件的 baseConfig 中的值`,
+    arrowStyle:{
+      color: '#ff5500',
+      width:12,
+      height:8,
+    }
+  },
+  {
+    el:'.guide-step5',
+    tips:`使用箭头插槽`,
+    customArrow:true
+  },
+  {
+    el:'.guide-step6',
+    tips:`不自动旋转箭头`,
+    autoRotateArrow:false,
+    customArrow:true
+  },
+]
+</script>
+```
+
+### 5. 自定义按钮样式
+##### 修改文字、样式
+```vue
+<template>
+	<hz-novice-guidance ref="refNoviceGuidance" :baseConfig="baseConfig" :steps="steps" ></hz-novice-guidance>
+</template>
+
+<script setup>
+// 整体配置
+const baseConfig = {
+  next:'next',
+  nextStyle:{
+    background: '#ff5500',
+  },
+  skip:'skip',
+  skipStyle:{
+    color: '#ff5500',
+  },
+}
+const steps = [
+  {
+    el:'.guide-step1',
+    tips:'通过参数或插槽控制按钮样式',
+    showSkip:false,
+  },
+  {
+    el:'.guide-step3',
+    tips:`可通过参数，控制按钮的文字、样式`,
+    next:'done'
+  },
+]
+</script>
+```
+
+##### 按钮展示在外部
+```vue
+<template>
+	<hz-novice-guidance ref="refNoviceGuidance" :baseConfig="baseConfig" :steps="steps" ></hz-novice-guidance>
+</template>
+
+<script setup>
+// 整体配置
+const baseConfig = {
+  outerBtn: true,
+}
+const steps = [
+  {
+    el:'.guide-step4',
+    tips:`按钮可显示在提示框外部`,
+  },
+]
+</script>
+```
+
+##### 使用插槽自定义按钮
+```vue
+<template>
+	<hz-novice-guidance ref="refNoviceGuidance" :baseConfig="baseConfig" :steps="steps" >
+		<template #btns="{scope}">
+			<view class="custom-btns-outertips">
+				<view class="skip-btn" @click="customSkip" v-if="scope.currentStep < steps3.length - 1">跳过</view>
+				<view class="next-btn" @click="customNext">{{scope.currentStep < steps3.length - 1 ? '下一步' : '完成'}}</view>
+			</view>
+		</template>
+	</hz-novice-guidance>
+</template>
+
+<script setup>
+// 整体配置
+const baseConfig = {
+  outerBtn: true,
+}
+const steps = [
+  {
+    el:'.guide-step5',
+    tips:`通过插槽 <span style='color:#ff5500;'>slot='btns'</span> 可完全自定义按钮`,
+  },
+  {
+    el:'.guide-step15',
+    tips:`通过调用组件的 next、skip、finished 方法控制引导流程`,
+  },
+]
+
+const customNext = () => {
+  refNoviceGuidance.value.next()
+}
+const customSkip = () => {
+  refNoviceGuidance.value.skip()
+}
+</script>
+```
+
+## 常见问题
+1. 目前只测试过h5、微信小程序、支付宝小程序，其他平台大家可自行测试。
+2. el 值应是唯一的，最好使用class选择器（如 `.guide-step1`）。
+3. 该组件暂不适用于高度过大的元素，可能会导致提示框显示不全。
+3. 小程序端，由于通过组件参数不能直接传递函数，当配置中有函数时，需调用组件 `setConfig` 方法进行传递配置。
+
+## 兼容性问题
+##### 1. 如果是`vue3`开发的`支付宝小程序`，且需配置到子组件时，则需在相关所有子组件上加上额外参数`hz-ref-name`，值和 ref 的一致，否则支付宝小程序不生效。
+```vue
+<template>
+<!-- 页面组件（vue3开发的支付宝小程序，组件需加上额外参数 hz-ref-name，且值和 ref 值一致）-->
+	<father ref="refFather" hz-ref-name="refFather"></father>
+</template>
+<!-- father组件 -->
+<template>
+  <view class="father-container ">
+    <view>我是父组件</view>
+    <child ref="refChild" hz-ref-name="refChild">
+    </child>
+  </view>
+</template>
+
+<script setup>
+const steps = [
+  {
+    el: '.child-container',
+    tips: '子组件',
+    context: ['refFather', 'refChild']
+  },
+]
+</script>
+```
+
+##### 2. 使用`vue3`开发并编译到`支付宝小程序`时，如果使用插槽且使用了插槽传值，会导致其他插槽的默认内容无法显示。该问题官方暂未修复。
+```vue
+<!-- 这种写法在 vue3 并编译到支付宝小程序，会导致提示内容不展示 -->
+<hz-novice-guidance>
+	<template #btns="{scope}"></template>
+</hz-novice-guidance>
+
+<!--  这种写法正常显示 -->
+<hz-novice-guidance>
+<template #btns></template>
+</hz-novice-guidance>
+
+```
+

huimv-employment/app/utils/conversation.js

@@ -0,0 +1,94 @@
+export const CHAT_TYPE_LABELS = {
+	employment: '用工需求咨询',
+	knowledge: '用工知识咨询',
+	order: '用工订单管理',
+	cost: '成本测算',
+	attendance: '现场考勤记录',
+	emergency: '紧急事件处理'
+}
+
+/** 会话消息分页默认每页条数 */
+export const CONVERSATION_MESSAGE_PAGE_SIZE = 30
+
+/**
+ * 根据总条数计算最后一页页码（接口按时间正序，最后一页为最新消息）
+ */
+export function calcLastMessagePage(total = 0, size = CONVERSATION_MESSAGE_PAGE_SIZE) {
+	if (!total || total <= 0) return 1
+	return Math.ceil(total / size)
+}
+
+/**
+ * 将接口消息映射为聊天气泡结构
+ */
+export function mapConversationMessage(item = {}) {
+	const role = item.role === 'user' ? 'user' : 'ai'
+	return {
+		id: item.id,
+		msgKey: item.id,
+		type: 'text',
+		role,
+		content: item.content || '',
+		contentType: item.contentType || 'text',
+		createTime: item.createTime
+	}
+}
+
+/**
+ * 开启新对话时的时段问候语
+ * @param {Date} [date]
+ */
+export function getNewChatGreeting(date = new Date()) {
+	const hour = date.getHours()
+	let period = '晚上'
+	if (hour >= 5 && hour < 11) {
+		period = '早上'
+	} else if (hour >= 11 && hour < 14) {
+		period = '中午'
+	} else if (hour >= 14 && hour < 18) {
+		period = '下午'
+	}
+	return `老板${period}好，有什么可以帮助您`
+}
+
+/**
+ * 格式化会话列表时间展示
+ * @param {string} value ISO 或 yyyy-MM-dd HH:mm:ss
+ */
+export function formatConversationTime(value) {
+	if (!value) return ''
+	const normalized = String(value).replace(' ', 'T')
+	const date = new Date(normalized)
+	if (Number.isNaN(date.getTime())) return ''
+
+	const now = new Date()
+	const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime()
+	const targetStart = new Date(date.getFullYear(), date.getMonth(), date.getDate()).getTime()
+	const diffDays = Math.floor((todayStart - targetStart) / 86400000)
+
+	const hh = String(date.getHours()).padStart(2, '0')
+	const mm = String(date.getMinutes()).padStart(2, '0')
+	const timeStr = `${hh}:${mm}`
+
+	if (diffDays === 0) return `今天 ${timeStr}`
+	if (diffDays === 1) return `昨天 ${timeStr}`
+	if (diffDays < 7) return `${diffDays}天前`
+	return `${date.getMonth() + 1}月${date.getDate()}日`
+}
+
+/**
+ * 将接口会话摘要映射为侧边栏展示结构
+ */
+export function mapConversationItem(item = {}) {
+	const chatType = item.chatType || 'employment'
+	return {
+		id: item.id,
+		conversationNo: item.conversationNo,
+		title: item.title || CHAT_TYPE_LABELS[chatType] || '新对话',
+		time: formatConversationTime(item.lastMessageAt || item.createTime),
+		chatType,
+		status: item.status,
+		lastMessageAt: item.lastMessageAt,
+		createTime: item.createTime
+	}
+}

huimv-employment/app/utils/home-guide.js

@@ -0,0 +1,117 @@
+/** 企业首页新手引导完成标记（本地存储，按用户区分） */
+export const ENTERPRISE_HOME_GUIDE_KEY = 'fe_enterprise_home_guide_v1'
+
+const GUIDE_STEP_META = [
+	{
+		el: '.guide-target--sidebar',
+		title: '对话列表',
+		desc: '点击左上角按钮，查看历史会话并在不同对话间切换。',
+		baseAlign: 'left'
+	},
+	{
+		el: '.guide-target--new-chat',
+		title: '新建会话',
+		desc: '点击「+」开启全新 AI 对话，发布用工需求从这里开始。',
+		baseAlign: 'right'
+	},
+	{
+		el: '.guide-target--message',
+		title: '消息待办',
+		desc: '查看待办事项、异常提醒和系统通知，重要事项不错过。',
+		baseAlign: 'right'
+	},
+	{
+		el: '.guide-target--avatar',
+		title: '个人中心',
+		desc: '进入企业管理中枢，查看企业信息、系统设置与帮助。',
+		baseAlign: 'right'
+	},
+	{
+		el: '.guide-target--quick-bar',
+		title: '快捷操作',
+		desc: '常用功能一键直达：发布需求、成本测算、进度总览、历史订单。',
+		baseAlign: 'center',
+		next: '开始使用'
+	}
+]
+
+function buildGuideTips(title, desc) {
+	return `<div style="font-weight:700;font-size:32rpx;margin-bottom:12rpx;">${title}</div><div style="line-height:1.7;color:#64748B;">${desc}</div>`
+}
+
+/** hz-novice-guidance 步骤配置（context 在启动时通过 setConfig 注入） */
+export function buildNoviceGuidanceSteps() {
+	return GUIDE_STEP_META.map((item) => ({
+		el: item.el,
+		tips: buildGuideTips(item.title, item.desc),
+		baseAlign: item.baseAlign || 'center',
+		...(item.next ? { next: item.next } : {})
+	}))
+}
+
+/** hz-novice-guidance 全局配置 */
+export const NOVICE_GUIDANCE_BASE_CONFIG = {
+	highligthStyle: {
+		'--bgcolor': 'rgba(0, 0, 0, 0.55)'
+	},
+	tipMaxWidth: '72vw',
+	next: '下一步',
+	skip: '跳过',
+	showSkip: true,
+	nextStyle: {
+		background: '#7C3AED',
+		borderRadius: '999rpx',
+		padding: '12rpx 32rpx'
+	},
+	skipStyle: {
+		color: '#64748B'
+	},
+	tipStyle: {
+		borderRadius: '28rpx',
+		padding: '32rpx 28rpx',
+		boxShadow: '0 20rpx 60rpx rgba(0, 0, 0, 0.2)'
+	}
+}
+
+function buildGuideKey(guideUserKey) {
+	return `${ENTERPRISE_HOME_GUIDE_KEY}_${guideUserKey}`
+}
+
+/** 用于本地引导标记的用户标识（优先 userId，否则手机号/企业 ID） */
+export function resolveGuideUserKey(user = {}, enterprise = {}) {
+	if (user.userId != null && user.userId !== '') return String(user.userId)
+	if (user.mobile) return `m_${user.mobile}`
+	if (enterprise.enterpriseId != null && enterprise.enterpriseId !== '') {
+		return `e_${enterprise.enterpriseId}`
+	}
+	return 'enterprise'
+}
+
+export function isEnterpriseHomeGuideDone(guideUserKey) {
+	if (!guideUserKey) return false
+	try {
+		if (uni.getStorageSync(buildGuideKey(guideUserKey))) return true
+		return !!uni.getStorageSync(ENTERPRISE_HOME_GUIDE_KEY)
+	} catch (e) {
+		return false
+	}
+}
+
+export function setEnterpriseHomeGuideDone(guideUserKey) {
+	if (!guideUserKey) return
+	try {
+		uni.setStorageSync(buildGuideKey(guideUserKey), '1')
+		uni.removeStorageSync(ENTERPRISE_HOME_GUIDE_KEY)
+	} catch (e) {}
+}
+
+/** 退出登录时清除，下次登录重新展示引导 */
+export function clearEnterpriseHomeGuide(user = {}, enterprise = {}) {
+	const guideUserKey = typeof user === 'string'
+		? user
+		: resolveGuideUserKey(user, enterprise)
+	try {
+		if (guideUserKey) uni.removeStorageSync(buildGuideKey(guideUserKey))
+		uni.removeStorageSync(ENTERPRISE_HOME_GUIDE_KEY)
+	} catch (e) {}
+}

huimv-employment/app/utils/sse-parse.js

@@ -0,0 +1,78 @@
+/**
+ * 解析智能体 SSE（data: {...}）行
+ */
+
+export function createSseLineBuffer() {
+	let pending = ''
+
+	return {
+		push(chunkText) {
+			if (!chunkText) return []
+			pending += chunkText
+			const lines = []
+			let pos = 0
+			while (true) {
+				const end = pending.indexOf('\n', pos)
+				if (end === -1) break
+				lines.push(pending.slice(pos, end))
+				pos = end + 1
+			}
+			pending = pending.slice(pos)
+			return lines
+		},
+		flushLine() {
+			if (!pending) return null
+			const line = pending
+			pending = ''
+			return line
+		}
+	}
+}
+
+export function parseConsoleChatSseLine(line) {
+	const trimmed = (line || '').trim()
+	if (!trimmed || trimmed.startsWith(':')) return null
+	if (!trimmed.startsWith('data:')) return null
+
+	const payload = trimmed.slice(5).trim()
+	if (!payload || payload === '[DONE]') {
+		return { done: true }
+	}
+
+	try {
+		return { data: JSON.parse(payload) }
+	} catch (e) {
+		return null
+	}
+}
+
+/**
+ * 从 SSE JSON 中提取 assistant 文本增量
+ */
+export function extractAssistantDelta(data) {
+	if (!data || typeof data !== 'object') return ''
+
+	if (data.error) {
+		const err = data.error
+		const msg = (typeof err === 'string' ? err : (err.message || err.msg)) || 'AI 服务异常'
+		throw new Error(msg)
+	}
+
+	const parts = []
+	const output = data.output
+	if (Array.isArray(output)) {
+		for (const item of output) {
+			if (!item || item.role !== 'assistant' || !Array.isArray(item.content)) continue
+			for (const block of item.content) {
+				if (block && block.type === 'text' && block.text) {
+					parts.push(block.text)
+				}
+			}
+		}
+	}
+
+	if (!parts.length && typeof data.text === 'string') parts.push(data.text)
+	if (!parts.length && typeof data.delta === 'string') parts.push(data.delta)
+
+	return parts.join('')
+}

huimv-employment/app/utils/sse-stream.js

@@ -0,0 +1,189 @@
+import { BASE_API } from '@/common/config.js'
+import { getToken } from '@/utils/request.js'
+import {
+	createSseLineBuffer,
+	parseConsoleChatSseLine,
+	extractAssistantDelta
+} from '@/utils/sse-parse.js'
+
+function buildUrl(url) {
+	if (/^https?:\/\//.test(url)) return url
+	const base = (BASE_API || '').replace(/\/$/, '')
+	if (!base) return ''
+	const path = url.startsWith('/') ? url : `/${url}`
+	return `${base}${path}`
+}
+
+function decodeChunk(data, decoder, stream) {
+	if (typeof data === 'string') return data
+	if (!(data instanceof ArrayBuffer)) return ''
+
+	if (decoder) {
+		return decoder.decode(data, { stream: !!stream })
+	}
+
+	const bytes = new Uint8Array(data)
+	let text = ''
+	for (let i = 0; i < bytes.length; i++) {
+		text += String.fromCharCode(bytes[i])
+	}
+	try {
+		return decodeURIComponent(escape(text))
+	} catch (e) {
+		return text
+	}
+}
+
+function getStreamFailMessage(err) {
+	const errMsg = (err && err.errMsg) || ''
+	if (!errMsg) return '网络连接失败，请稍后重试'
+	if (errMsg.includes('abort')) return '请求已取消'
+	if (errMsg.includes('timeout')) return '对话超时，请稍后重试'
+	if (errMsg.includes('url not in domain list')) {
+		return '请求域名未配置，请在开发者工具中关闭域名校验'
+	}
+	return '网络异常，请稍后重试'
+}
+
+function parseFallbackBody(res) {
+	if (!res || res.data == null) return ''
+	if (typeof res.data === 'string') return res.data
+	if (res.data instanceof ArrayBuffer) {
+		return decodeChunk(res.data, null, false)
+	}
+	if (typeof res.data === 'object' && typeof res.data.msg === 'string') {
+		throw new Error(res.data.msg)
+	}
+	return ''
+}
+
+/**
+ * 微信小程序兼容的 SSE 流式请求（uni.request + enableChunked + onChunkReceived）
+ * @returns {() => void} abort
+ */
+export function streamSseRequest(options = {}) {
+	const {
+		url,
+		data,
+		header = {},
+		auth = true,
+		timeout = 300000,
+		onChunk,
+		onDone,
+		onError
+	} = options
+
+	const fullUrl = buildUrl(url)
+	if (!fullUrl) {
+		const err = new Error('API 地址未配置')
+		if (onError) onError(err)
+		return () => {}
+	}
+
+	const headers = {
+		'Content-Type': 'application/json',
+		Accept: 'text/event-stream',
+		...header
+	}
+
+	if (auth) {
+		const token = getToken()
+		if (token) headers.Authorization = `Bearer ${token}`
+	}
+
+	let aborted = false
+	let finished = false
+	let chunkReceived = false
+	const decoder = typeof TextDecoder !== 'undefined' ? new TextDecoder('utf-8') : null
+	const lineBuffer = createSseLineBuffer()
+
+	const abort = () => {
+		aborted = true
+		if (requestTask && typeof requestTask.abort === 'function') {
+			requestTask.abort()
+		}
+	}
+
+	const finish = () => {
+		if (finished || aborted) return
+		finished = true
+		const lastLine = lineBuffer.flushLine()
+		if (lastLine) processLine(lastLine)
+		if (onDone) onDone()
+	}
+
+	const processLine = (line) => {
+		const parsed = parseConsoleChatSseLine(line)
+		if (!parsed) return
+		if (parsed.done) return
+		try {
+			const delta = extractAssistantDelta(parsed.data)
+			if (delta && onChunk) onChunk(delta, parsed.data)
+		} catch (e) {
+			aborted = true
+			if (requestTask && typeof requestTask.abort === 'function') {
+				requestTask.abort()
+			}
+			if (onError) onError(e)
+		}
+	}
+
+	const handleText = (text) => {
+		if (!text || aborted) return
+		const lines = lineBuffer.push(text)
+		for (const line of lines) {
+			processLine(line)
+		}
+	}
+
+	let requestTask = uni.request({
+		url: fullUrl,
+		method: 'POST',
+		header: headers,
+		data,
+		enableChunked: true,
+		timeout,
+		success(res) {
+			if (aborted) return
+
+			if (res.statusCode < 200 || res.statusCode >= 300) {
+				let message = '对话请求失败'
+				try {
+					const body = parseFallbackBody(res)
+					if (body) {
+						const json = JSON.parse(body)
+						message = json.msg || json.message || message
+					}
+				} catch (e) {
+					// ignore parse error
+				}
+				if (onError) onError(new Error(message))
+				return
+			}
+
+			if (!chunkReceived) {
+				try {
+					handleText(parseFallbackBody(res))
+				} catch (e) {
+					if (onError) onError(e)
+					return
+				}
+			}
+			finish()
+		},
+		fail(err) {
+			if (aborted) return
+			if (onError) onError(new Error(getStreamFailMessage(err)))
+		}
+	})
+
+	if (requestTask && typeof requestTask.onChunkReceived === 'function') {
+		requestTask.onChunkReceived((res) => {
+			if (aborted) return
+			chunkReceived = true
+			handleText(decodeChunk(res.data, decoder, true))
+		})
+	}
+
+	return abort
+}