diff --git a/packages/ui/certd-client/src/App.vue b/packages/ui/certd-client/src/App.vue
index 9197921d9..d8f9367f4 100644
--- a/packages/ui/certd-client/src/App.vue
+++ b/packages/ui/certd-client/src/App.vue
@@ -3,6 +3,7 @@
     <FsFormProvider>
       <contextHolder />
       <router-view />
+      <MaxKBChat ref="chatBox" />
     </FsFormProvider>
   </AConfigProvider>
 </template>
@@ -10,7 +11,7 @@
 <script lang="ts" setup>
 import zhCN from "ant-design-vue/es/locale/zh_CN";
 import enUS from "ant-design-vue/es/locale/en_US";
-import { computed, provide, ref } from "vue";
+import { computed, onMounted, provide, ref } from "vue";
 import "dayjs/locale/zh-cn";
 import "dayjs/locale/en";
 import dayjs from "dayjs";
@@ -19,6 +20,8 @@ import { useAntdDesignTokens } from "/@/vben/hooks";
 import { theme } from "ant-design-vue";
 import AConfigProvider from "ant-design-vue/es/config-provider";
 import { Modal } from "ant-design-vue";
+import MaxKBChat from "/@/components/ai/index.vue";
+import { util } from "/@/utils";
 
 defineOptions({
   name: "App",
@@ -69,4 +72,10 @@ const tokenTheme = computed(() => {
 // pageStore.init();
 // const settingStore = useSettingStore();
 // settingStore.init();
+
+const chatBox = ref();
+onMounted(async () => {
+  // await util.sleep(5000);
+  // await chatBox.value.openChat({ q: "hello" });
+});
 </script>
diff --git a/packages/ui/certd-client/src/components/ai/index.vue b/packages/ui/certd-client/src/components/ai/index.vue
new file mode 100644
index 000000000..dc9020dec
--- /dev/null
+++ b/packages/ui/certd-client/src/components/ai/index.vue
@@ -0,0 +1,307 @@
+<template>
+  <div id="maxkb">
+    <!-- 引导层 -->
+    <div v-if="showGuide" class="maxkb-mask">
+      <div class="maxkb-content" :style="contentStyle"></div>
+    </div>
+
+    <div v-if="showGuide" class="maxkb-tips" :style="tipsStyle">
+      <div class="" @click="closeGuide">
+        <!-- 关闭图标 -->
+        <svg style="vertical-align: middle; overflow: hidden" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none">
+          <path
+            d="M9.95317 8.73169L15.5511 3.13376C15.7138 2.97104 15.9776 2.97104 16.1403 3.13376L16.7296 3.72301C16.8923 3.88573 16.8923 4.14955 16.7296 4.31227L11.1317 9.9102L16.7296 15.5081C16.8923 15.6708 16.8923 15.9347 16.7296 16.0974L16.1403 16.6866C15.9776 16.8494 15.7138 16.8494 15.5511 16.6866L9.95317 11.0887L4.35524 16.6866C4.19252 16.8494 3.9287 16.8494 3.76598 16.6866L3.17673 16.0974C3.01401 15.9347 3.01401 15.6708 3.17673 15.5081L8.77465 9.9102L3.17673 4.31227C3.01401 4.14955 3.01401 3.88573 3.17673 3.72301L3.76598 3.13376C3.9287 2.97104 4.19252 2.97104 4.35524 3.13376L9.95317 8.73169Z"
+            fill="#ffffff"
+          ></path>
+        </svg>
+      </div>
+      <div class="maxkb-title">🌟 遇见问题，不再有障碍！</div>
+      <p>你好，我是你的智能小助手。<br />点我，开启高效解答模式，让问题变成过去式。</p>
+      <div class="maxkb-button">
+        <button @click="closeGuide">我知道了</button>
+      </div>
+      <span class="maxkb-arrow"></span>
+    </div>
+
+    <!-- 聊天按钮 -->
+    <div v-show="!chatVisible" class="maxkb-chat-button" :style="buttonPosition" @click="toggleChat">
+      <img src="https://maxkb.handfree.work/ui/MaxKB.gif" />
+    </div>
+
+    <!-- 聊天窗口 -->
+    <div id="maxkb-chat-container" :class="{ 'maxkb-enlarge': isFullscreen }" :style="containerStyle">
+      <iframe id="maxkb-chat" allow="microphone" :src="chatUrl"></iframe>
+      <div class="maxkb-operate">
+        <div class="viewport" :class="{ 'maxkb-viewportnone': !isFullscreen }" @click="toggleFullscreen">
+          <!-- 缩小图标 -->
+          <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none">
+            <path
+              d="M7.507 11.6645C7.73712 11.6645 7.94545 11.7578 8.09625 11.9086C8.24706 12.0594 8.34033 12.2677 8.34033 12.4978V16.7976C8.34033 17.0277 8.15378 17.2143 7.92366 17.2143H7.09033C6.86021 17.2143 6.67366 17.0277 6.67366 16.7976V14.5812L3.41075 17.843C3.24803 18.0057 2.98421 18.0057 2.82149 17.843L2.23224 17.2537C2.06952 17.091 2.06952 16.8272 2.23224 16.6645L5.56668 13.3311H3.19634C2.96622 13.3311 2.77967 13.1446 2.77967 12.9145V12.0811C2.77967 11.851 2.96622 11.6645 3.19634 11.6645H7.507ZM16.5991 2.1572C16.7619 1.99448 17.0257 1.99448 17.1884 2.1572L17.7777 2.74645C17.9404 2.90917 17.9404 3.17299 17.7777 3.33571L14.4432 6.66904H16.8136C17.0437 6.66904 17.2302 6.85559 17.2302 7.08571V7.91904C17.2302 8.14916 17.0437 8.33571 16.8136 8.33571H12.5029C12.2728 8.33571 12.0644 8.24243 11.9136 8.09163C11.7628 7.94082 11.6696 7.73249 11.6696 7.50237V3.20257C11.6696 2.97245 11.8561 2.7859 12.0862 2.7859H12.9196C13.1497 2.7859 13.3362 2.97245 13.3362 3.20257V5.419L16.5991 2.1572Z"
+              fill="rgb(100, 106, 115)"
+            />
+          </svg>
+        </div>
+        <div class="maxkb-openviewport" :class="{ 'maxkb-viewportnone': isFullscreen }" @click="toggleFullscreen">
+          <!-- 放大图标 -->
+          <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none">
+            <path
+              d="M7.15209 11.5968C7.31481 11.4341 7.57862 11.4341 7.74134 11.5968L8.3306 12.186C8.49332 12.3487 8.49332 12.6126 8.3306 12.7753L4.99615 16.1086H7.3665C7.59662 16.1086 7.78316 16.2952 7.78316 16.5253V17.3586C7.78316 17.5887 7.59662 17.7753 7.3665 17.7753H3.05584C2.82572 17.7753 2.61738 17.682 2.46658 17.5312C2.31578 17.3804 2.2225 17.1721 2.2225 16.9419V12.6421C2.2225 12.412 2.40905 12.2255 2.63917 12.2255H3.4725C3.70262 12.2255 3.88917 12.412 3.88917 12.6421V14.8586L7.15209 11.5968ZM16.937 2.22217C17.1671 2.22217 17.3754 2.31544 17.5262 2.46625C17.677 2.61705 17.7703 2.82538 17.7703 3.0555V7.35531C17.7703 7.58543 17.5837 7.77198 17.3536 7.77198H16.5203C16.2902 7.77198 16.1036 7.58543 16.1036 7.35531V5.13888L12.8407 8.40068C12.678 8.5634 12.4142 8.5634 12.2515 8.40068L11.6622 7.81142C11.4995 7.64871 11.4995 7.38489 11.6622 7.22217L14.9966 3.88883H12.6263C12.3962 3.88883 12.2096 3.70229 12.2096 3.47217V2.63883C12.2096 2.40872 12.3962 2.22217 12.6263 2.22217H16.937Z"
+              fill="rgb(100, 106, 115)"
+            />
+          </svg>
+        </div>
+        <div class="maxkb-chat-close" @click="toggleChat">
+          <!-- 关闭图标 -->
+          <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none">
+            <path
+              d="M9.95317 8.73169L15.5511 3.13376C15.7138 2.97104 15.9776 2.97104 16.1403 3.13376L16.7296 3.72301C16.8923 3.88573 16.8923 4.14955 16.7296 4.31227L11.1317 9.9102L16.7296 15.5081C16.8923 15.6708 16.8923 15.9347 16.7296 16.0974L16.1403 16.6866C15.9776 16.8494 15.7138 16.8494 15.5511 16.6866L9.95317 11.0887L4.35524 16.6866C4.19252 16.8494 3.9287 16.8494 3.76598 16.6866L3.17673 16.0974C3.01401 15.9347 3.01401 15.6708 3.17673 15.5081L8.77465 9.9102L3.17673 4.31227C3.01401 4.14955 3.01401 3.88573 3.17673 3.72301L3.76598 3.13376C3.9287 2.97104 4.19252 2.97104 4.35524 3.13376L9.95317 8.73169Z"
+              fill="rgb(100, 106, 115)"
+            />
+          </svg>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, onMounted, ref } from "vue";
+defineOptions({
+  name: "MaxKBChat",
+});
+const props = defineProps<{
+  url?: string;
+  showGuideOnInit?: boolean;
+}>();
+
+// 响应式状态
+const showGuide = ref(false);
+const chatVisible = ref(false);
+const isFullscreen = ref(false);
+const buttonPos = ref({ x: 16, y: 30 });
+const buttonSize = ref({ width: 64, height: 64 });
+
+// 计算属性
+const chatUrl = computed(() => {
+  return props.url || "https://maxkb.handfree.work/ui/chat/326a8651825e8a02?mode=embed";
+});
+
+const contentStyle = computed(() => ({
+  width: `${buttonSize.value.width}px`,
+  height: `${buttonSize.value.height}px`,
+}));
+
+const tipsStyle = computed(() => ({
+  marginRight: `${Math.min(buttonSize.value.width, 500) - 64}px`,
+}));
+
+const containerStyle = computed(() => ({
+  display: chatVisible.value ? "block" : "none",
+  right: `${buttonPos.value.x}px`,
+  bottom: `${buttonPos.value.y}px`,
+}));
+
+// 方法
+const closeGuide = () => {
+  showGuide.value = false;
+  localStorage.setItem("maxkbMaskTip", "true");
+};
+
+const toggleChat = () => {
+  chatVisible.value = !chatVisible.value;
+};
+
+const toggleFullscreen = () => {
+  isFullscreen.value = !isFullscreen.value;
+};
+
+// 初始化
+onMounted(() => {
+  if (props.showGuideOnInit && !localStorage.getItem("maxkbMaskTip")) {
+    showGuide.value = true;
+  }
+});
+
+async function openChat(req: { q: string }) {
+  showGuide.value = true;
+
+  const iframeId = "maxkb-chat";
+
+  const iframe = document.getElementById(iframeId) as HTMLIFrameElement | null;
+  if (!iframe) {
+    throw new Error("iframe not found");
+    return;
+  }
+  iframe.contentWindow?.postMessage(req, "*");
+}
+
+defineExpose({
+  openChat,
+});
+</script>
+
+<style scoped>
+/* 这里放置所有样式（保持原有样式不变） */
+/* 注意将原样式中的 #maxkb 选择器改为 #maxkb-container */
+/* 示例： */
+/* 其他样式保持原样... */
+/* 放大 */
+#maxkb .maxkb-enlarge {
+  width: 50% !important;
+  height: 100% !important;
+  bottom: 0 !important;
+  right: 0 !important;
+}
+@media only screen and (max-width: 768px) {
+  #maxkb .maxkb-enlarge {
+    width: 100% !important;
+    height: 100% !important;
+    right: 0 !important;
+    bottom: 0 !important;
+  }
+}
+
+/* 引导 */
+
+#maxkb .maxkb-mask {
+  position: fixed;
+  z-index: 10001;
+  background-color: transparent;
+  height: 100%;
+  width: 100%;
+  top: 0;
+  left: 0;
+}
+#maxkb .maxkb-mask .maxkb-content {
+  width: 64px;
+  height: 64px;
+  box-shadow: 1px 1px 1px 9999px rgba(0, 0, 0, 0.6);
+  position: absolute;
+  right: 0px;
+  bottom: 30px;
+  z-index: 10001;
+}
+#maxkb .maxkb-tips {
+  position: fixed;
+  right: calc(0px + 75px);
+  bottom: calc(30px + 0px);
+  padding: 22px 24px 24px;
+  border-radius: 6px;
+  color: #ffffff;
+  font-size: 14px;
+  background: #3370ff;
+  z-index: 10001;
+}
+#maxkb .maxkb-tips .maxkb-arrow {
+  position: absolute;
+  background: #3370ff;
+  width: 10px;
+  height: 10px;
+  pointer-events: none;
+  transform: rotate(45deg);
+  box-sizing: border-box;
+  /* left  */
+  right: -5px;
+  bottom: 33px;
+  border-left-color: transparent;
+  border-bottom-color: transparent;
+}
+#maxkb .maxkb-tips .maxkb-title {
+  font-size: 20px;
+  font-weight: 500;
+  margin-bottom: 8px;
+}
+#maxkb .maxkb-tips .maxkb-button {
+  text-align: right;
+  margin-top: 24px;
+}
+#maxkb .maxkb-tips .maxkb-button button {
+  border-radius: 4px;
+  background: #fff;
+  padding: 3px 12px;
+  color: #3370ff;
+  cursor: pointer;
+  outline: none;
+  border: none;
+}
+#maxkb .maxkb-tips .maxkb-button button::after {
+  border: none;
+}
+#maxkb .maxkb-tips . {
+  position: absolute;
+  right: 20px;
+  top: 20px;
+  cursor: pointer;
+}
+#maxkb-chat-container {
+  width: 450px;
+  height: 600px;
+  display: none;
+}
+@media only screen and (max-width: 768px) {
+  #maxkb-chat-container {
+    width: 100%;
+    height: 70%;
+    right: 0 !important;
+  }
+}
+
+#maxkb .maxkb-chat-button {
+  position: fixed;
+  right: 0px;
+  bottom: 30px;
+  cursor: pointer;
+  z-index: 10000;
+}
+#maxkb #maxkb-chat-container {
+  z-index: 10000;
+  position: relative;
+  border-radius: 8px;
+  border: 1px solid #ffffff;
+  background: linear-gradient(188deg, rgba(235, 241, 255, 0.2) 39.6%, rgba(231, 249, 255, 0.2) 94.3%), #eff0f1;
+  box-shadow: 0px 4px 8px 0px rgba(31, 35, 41, 0.1);
+  position: fixed;
+  bottom: 16px;
+  right: 16px;
+  overflow: hidden;
+}
+
+#maxkb #maxkb-chat-container .maxkb-operate {
+  top: 18px;
+  right: 15px;
+  position: absolute;
+  display: flex;
+  align-items: center;
+  line-height: 18px;
+}
+#maxkb #maxkb-chat-container .maxkb-operate .maxkb-chat-close {
+  margin-left: 15px;
+  cursor: pointer;
+}
+#maxkb #maxkb-chat-container .maxkb-operate .maxkb-openviewport {
+  cursor: pointer;
+}
+#maxkb #maxkb-chat-container .maxkb-operate .maxkb-closeviewport {
+  cursor: pointer;
+}
+#maxkb #maxkb-chat-container .maxkb-viewportnone {
+  display: none;
+}
+#maxkb #maxkb-chat-container #maxkb-chat {
+  height: 100%;
+  width: 100%;
+  border: none;
+}
+#maxkb #maxkb-chat-container {
+  animation: appear 0.4s ease-in-out;
+}
+@keyframes appear {
+  from {
+    height: 0;
+  }
+
+  to {
+    height: 600px;
+  }
+}
+</style>
diff --git a/packages/ui/certd-client/src/components/index.ts b/packages/ui/certd-client/src/components/index.ts
index 4698b26d3..ed9ea3e2b 100644
--- a/packages/ui/certd-client/src/components/index.ts
+++ b/packages/ui/certd-client/src/components/index.ts
@@ -19,6 +19,7 @@ export default {
       "CodeEditor",
       defineAsyncComponent(() => import("./code-editor/index.vue"))
     );
+
     app.component("PiContainer", PiContainer);
     app.component("TextEditable", TextEditable);
     app.component("FileInput", FileInput);