🔖 chore(release): v1.148.0 [skip ci]

## [Version 1.148.0](https://github.com/jaworldwideorg/OneJA-Bot/compare/v1.147.0...v1.148.0) <sup>Released on **2026-01-05**</sup> #### ♻ Code Refactoring - **redis**: Disable automatic deserialization in upstash provider. - **utils**: Remove unused geo server utilities. - **misc**: Refactor and fix model runtime initialize, refactor to remove access code, remove client db and refactor test. #### ✨ Features - **misc**: Add new provider Xiaomi MiMo, add work path for local system, update the sandbox export files & save files way. #### 🐛 Bug Fixes - **electron**: Correct next config codemod pattern matching. - **gtd**: Fix frozen object mutation in updateTodos. - **model-runtime**: Handle array content in anthropic assistant messages, handle incremental tool call chunks in Qwen stream, handle Qwen tool_calls without initial arguments. - **misc**: Add lost like button in discover detail page, Auto jump to group, filter empty assistant messages for Anthropic API, fix data inconsistency in ai provider config, fix editor modal when Markdown rendering off, fix file upload issue, fix tool call message content missing, restore window position safely, restore window resizable before hard reload in desktop onboarding, slove the old agents open profiles error problem, support thoughtSignature for openrouter, update CI bun version to v1.2.4, use configured embedding provider instead of hardcoded OpenAI, when the document filetype is agent/plan, not show the saveinto docs button. #### 💄 Styles - **misc**: Update i18n, update i18n, update i18n. <br/> <details> <summary><kbd>Improvements and Fixes</kbd></summary> #### Code refactoring * **redis**: Disable automatic deserialization in upstash provider, closes [#11210](https://github.com/jaworldwideorg/OneJA-Bot/issues/11210) ([eb5c76c](https://github.com/jaworldwideorg/OneJA-Bot/commit/eb5c76c)) * **utils**: Remove unused geo server utilities, closes [#11243](https://github.com/jaworldwideorg/OneJA-Bot/issues/11243) ([ee474cc](https://github.com/jaworldwideorg/OneJA-Bot/commit/ee474cc)) * **misc**: Refactor and fix model runtime initialize, closes [#11134](https://github.com/jaworldwideorg/OneJA-Bot/issues/11134) ([8078cb9](https://github.com/jaworldwideorg/OneJA-Bot/commit/8078cb9)) * **misc**: Refactor to remove access code, closes [#11120](https://github.com/jaworldwideorg/OneJA-Bot/issues/11120) ([0e9f98c](https://github.com/jaworldwideorg/OneJA-Bot/commit/0e9f98c)) * **misc**: Remove client db and refactor test, closes [#11123](https://github.com/jaworldwideorg/OneJA-Bot/issues/11123) ([bb2799d](https://github.com/jaworldwideorg/OneJA-Bot/commit/bb2799d)) #### What's improved * **misc**: Add new provider Xiaomi MiMo, closes [#10834](https://github.com/jaworldwideorg/OneJA-Bot/issues/10834) ([62f7858](https://github.com/jaworldwideorg/OneJA-Bot/commit/62f7858)) * **misc**: Add work path for local system, closes [#11128](https://github.com/jaworldwideorg/OneJA-Bot/issues/11128) ([d8deadd](https://github.com/jaworldwideorg/OneJA-Bot/commit/d8deadd)) * **misc**: Update the sandbox export files & save files way, closes [#11249](https://github.com/jaworldwideorg/OneJA-Bot/issues/11249) ([039b0a1](https://github.com/jaworldwideorg/OneJA-Bot/commit/039b0a1)) #### What's fixed * **electron**: Correct next config codemod pattern matching, closes [#11228](https://github.com/jaworldwideorg/OneJA-Bot/issues/11228) ([06cb019](https://github.com/jaworldwideorg/OneJA-Bot/commit/06cb019)) * **gtd**: Fix frozen object mutation in updateTodos, closes [#11184](https://github.com/jaworldwideorg/OneJA-Bot/issues/11184) ([4970794](https://github.com/jaworldwideorg/OneJA-Bot/commit/4970794)) * **model-runtime**: Handle array content in anthropic assistant messages, closes [#11206](https://github.com/jaworldwideorg/OneJA-Bot/issues/11206) ([b03845d](https://github.com/jaworldwideorg/OneJA-Bot/commit/b03845d)) * **model-runtime**: Handle incremental tool call chunks in Qwen stream, closes [#11219](https://github.com/jaworldwideorg/OneJA-Bot/issues/11219) ([03b9407](https://github.com/jaworldwideorg/OneJA-Bot/commit/03b9407)) * **model-runtime**: Handle Qwen tool_calls without initial arguments, closes [#11211](https://github.com/jaworldwideorg/OneJA-Bot/issues/11211) ([5321d91](https://github.com/jaworldwideorg/OneJA-Bot/commit/5321d91)) * **misc**: Add lost like button in discover detail page, closes [#11182](https://github.com/jaworldwideorg/OneJA-Bot/issues/11182) ([41215d4](https://github.com/jaworldwideorg/OneJA-Bot/commit/41215d4)) * **misc**: Auto jump to group, closes [#11187](https://github.com/jaworldwideorg/OneJA-Bot/issues/11187) ([e43578a](https://github.com/jaworldwideorg/OneJA-Bot/commit/e43578a)) * **misc**: Filter empty assistant messages for Anthropic API, closes [#11129](https://github.com/jaworldwideorg/OneJA-Bot/issues/11129) ([7af750b](https://github.com/jaworldwideorg/OneJA-Bot/commit/7af750b)) * **misc**: Fix data inconsistency in ai provider config, closes [#11198](https://github.com/jaworldwideorg/OneJA-Bot/issues/11198) ([f8346f2](https://github.com/jaworldwideorg/OneJA-Bot/commit/f8346f2)) * **misc**: Fix editor modal when Markdown rendering off, closes [#11251](https://github.com/jaworldwideorg/OneJA-Bot/issues/11251) ([eb86d3b](https://github.com/jaworldwideorg/OneJA-Bot/commit/eb86d3b)) * **misc**: Fix file upload issue, closes [#11122](https://github.com/jaworldwideorg/OneJA-Bot/issues/11122) ([1ae327a](https://github.com/jaworldwideorg/OneJA-Bot/commit/1ae327a)) * **misc**: Fix tool call message content missing, closes [#11116](https://github.com/jaworldwideorg/OneJA-Bot/issues/11116) ([885964e](https://github.com/jaworldwideorg/OneJA-Bot/commit/885964e)) * **misc**: Restore window position safely ([e0b555e](https://github.com/jaworldwideorg/OneJA-Bot/commit/e0b555e)) * **misc**: Restore window resizable before hard reload in desktop onboarding, closes [#11144](https://github.com/jaworldwideorg/OneJA-Bot/issues/11144) ([2516874](https://github.com/jaworldwideorg/OneJA-Bot/commit/2516874)) * **misc**: Slove the old agents open profiles error problem, closes [#11204](https://github.com/jaworldwideorg/OneJA-Bot/issues/11204) ([7d650b6](https://github.com/jaworldwideorg/OneJA-Bot/commit/7d650b6)) * **misc**: Support thoughtSignature for openrouter, closes [#11117](https://github.com/jaworldwideorg/OneJA-Bot/issues/11117) ([bf5d41e](https://github.com/jaworldwideorg/OneJA-Bot/commit/bf5d41e)) * **misc**: Update CI bun version to v1.2.4, closes [#11232](https://github.com/jaworldwideorg/OneJA-Bot/issues/11232) ([dd022d5](https://github.com/jaworldwideorg/OneJA-Bot/commit/dd022d5)) * **misc**: Use configured embedding provider instead of hardcoded OpenAI, closes [#11133](https://github.com/jaworldwideorg/OneJA-Bot/issues/11133) ([503c3eb](https://github.com/jaworldwideorg/OneJA-Bot/commit/503c3eb)) * **misc**: When the document filetype is agent/plan, not show the saveinto docs button, closes [#11227](https://github.com/jaworldwideorg/OneJA-Bot/issues/11227) ([3a22f32](https://github.com/jaworldwideorg/OneJA-Bot/commit/3a22f32)) #### Styles * **misc**: Update i18n, closes [#11213](https://github.com/jaworldwideorg/OneJA-Bot/issues/11213) ([00e0980](https://github.com/jaworldwideorg/OneJA-Bot/commit/00e0980)) * **misc**: Update i18n, closes [#11145](https://github.com/jaworldwideorg/OneJA-Bot/issues/11145) ([fdadef2](https://github.com/jaworldwideorg/OneJA-Bot/commit/fdadef2)) * **misc**: Update i18n, closes [#11115](https://github.com/jaworldwideorg/OneJA-Bot/issues/11115) ([072e0dd](https://github.com/jaworldwideorg/OneJA-Bot/commit/072e0dd)) </details> <div align="right"> [![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top) </div>
Merge remote-tracking branch 'upstream/next'
2026-06-15 12:10:16 +00:00 · 2026-01-05 10:28:13 +00:00 · 2026-01-05 11:07:05 +01:00 · 2026-01-05 18:04:50 +08:00 · 2026-01-05 18:03:25 +08:00 · 2026-01-05 09:10:51 +00:00
3518 changed files with 139349 additions and 106579 deletions
@@ -0,0 +1,959 @@
+# createStaticStyles 迁移指南
+
+## 📖 概述
+
+`createStaticStyles` 是 `antd-style` 提供的静态样式创建函数，相比 `createStyles`（hook 方案）具有零运行时开销的优势。样式在模块加载时计算一次，而不是每次组件渲染时计算。
+
+## 🎯 适用场景
+
+### ✅ 可以优化的场景
+
+1. **纯静态样式**：不依赖运行时动态值
+2. **使用标准 token**：所有 token 都在 `cssVar.json` 中有对应项
+3. **简单的条件逻辑**：可以通过静态样式拆分处理
+
+### ❌ 无法优化的场景
+
+1. **JS 计算函数**：`readableColor()`, `chroma()`, `mix()`, `calc()` 中使用 token 数值
+2. **复杂的动态 props**：需要运行时计算的复杂逻辑
+3. **动态 prefixCls**：需要运行时传入的类名前缀（但可以硬编码为 `'ant'`）
+
+## 🔄 基本转换步骤
+
+### 1. 样式文件转换
+
+**之前（createStyles）：**
+
+```typescript
+import { createStyles } from 'antd-style';
+
+export const useStyles = createStyles(({ css, token }) => {
+  return {
+    root: css`
+      color: ${token.colorText};
+      font-size: ${token.fontSize}px;
+    `,
+  };
+});
+```
+
+**之后（createStaticStyles）：**
+
+```typescript
+import { createStaticStyles } from 'antd-style';
+
+export const styles = createStaticStyles(({ css, cssVar }) => {
+  return {
+    root: css`
+      color: ${cssVar.colorText};
+      font-size: ${cssVar.fontSize};
+    `,
+  };
+});
+```
+
+### 2. 组件文件转换
+
+**之前：**
+
+```typescript
+import { useStyles } from './style';
+
+const Component = () => {
+  const { styles, cx } = useStyles();
+  return <div className={cx(styles.root, className)} />;
+};
+```
+
+**之后：**
+
+```typescript
+import { cx } from 'antd-style';
+import { styles } from './style';
+
+const Component = () => {
+  return <div className={cx(styles.root, className)} />;
+};
+```
+
+## 🛠️ 常见场景处理
+
+### 场景 1: Token 转换
+
+**规则：**
+
+- `token.xxx` → `cssVar.xxx`
+- 注意：`cssVar.fontSize` 已经包含 `px` 单位，不需要再加 `px`
+
+**示例：**
+
+```typescript
+// ❌ 错误
+font-size: ${cssVar.fontSize}px;  // cssVar.fontSize 已经是 "14px"
+
+// ✅ 正确
+font-size: ${cssVar.fontSize};     // 直接使用
+```
+
+**特殊情况 - calc ()：**
+
+```typescript
+// ❌ 错误
+calc(${token.fontSize}px * 2.5)
+
+// ✅ 正确
+calc(${cssVar.fontSize} * 2.5)    // cssVar.fontSize 已经包含单位
+```
+
+### 场景 2: 动态 Props → CSS 变量
+
+**适用：** 数值、字符串类型的 props
+
+**步骤：**
+
+1. 在样式文件中使用 CSS 变量（带默认值）
+2. 在组件中通过 `style` prop 设置 CSS 变量
+
+**示例：**
+
+**样式文件：**
+
+```typescript
+export const styles = createStaticStyles(({ css }) => {
+  return {
+    root: css`
+      width: var(--component-size, 24px);
+      height: var(--component-size, 24px);
+    `,
+  };
+});
+```
+
+**组件文件：**
+
+```typescript
+import { useMemo } from 'react';
+
+const Component = ({ size = 24, style, ...rest }) => {
+  const cssVariables = useMemo<Record<string, string>>(
+    () => ({
+      '--component-size': `${size}px`,
+    }),
+    [size],
+  );
+
+  return (
+    <div
+      className={styles.root}
+      style={{
+        ...cssVariables,
+        ...style,
+      }}
+      {...rest}
+    />
+  );
+};
+```
+
+**已优化示例：**
+
+- `Video`: `maxHeight`, `maxWidth`, `minHeight`, `minWidth`
+- `ScrollShadow`: `size`
+- `MaskShadow`: `size`
+- `ColorSwatches`: `size`
+- `Grid`: `rows`, `maxItemWidth`, `gap`
+- `Layout`: `headerHeight`
+- `Footer`: `contentMaxWidth`
+
+### 场景 3: 布尔值 Props → 静态样式拆分
+
+**适用：** 简单的布尔值 props（2-3 个）
+
+**步骤：**
+
+1. 创建所有可能的组合样式
+2. 运行时使用 `cx` 组合
+
+**示例：**
+
+**样式文件：**
+
+```typescript
+export const styles = createStaticStyles(({ css }) => {
+  return {
+    root: css`
+      /* base styles */
+    `,
+    root_closable_true: css`
+      /* closable styles */
+    `,
+    root_closable_false: css`
+      /* no closable styles */
+    `,
+    root_hasTitle_true: css`
+      /* has title styles */
+    `,
+    root_hasTitle_false: css`
+      /* no title styles */
+    `,
+  };
+});
+```
+
+**组件文件：**
+
+```typescript
+const Component = ({ closable, hasTitle }) => {
+  const className = cx(
+    styles.root,
+    styles[`root_closable_${!!closable}`],
+    styles[`root_hasTitle_${!!hasTitle}`],
+  );
+  return <div className={className} />;
+};
+```
+
+**已优化示例：**
+
+- `Alert`: `closable`, `hasTitle`, `showIcon` → 8 个组合（2×2×2）
+- `Image`: `alwaysShowActions` → 2 个样式
+- `StoryBook`: `noPadding` → 2 个样式
+
+### 场景 4: isDarkMode → 静态样式拆分
+
+**适用：** 依赖 `isDarkMode` 的条件样式
+
+**有两种处理方式：**
+
+#### 方式 A: 直接条件选择（简单场景）
+
+**步骤：**
+
+1. 创建 `Dark` 和 `Light` 两个静态样式
+2. 运行时根据 `theme.isDarkMode` 选择
+
+**示例：**
+
+**样式文件：**
+
+```typescript
+export const styles = createStaticStyles(({ css, cssVar }) => {
+  return {
+    rootDark: css`
+      background: ${cssVar.colorFillTertiary};
+      color: ${cssVar.colorTextLightSolid};
+    `,
+    rootLight: css`
+      background: ${cssVar.colorFillQuaternary};
+      color: ${cssVar.colorText};
+    `,
+  };
+});
+```
+
+**组件文件：**
+
+```typescript
+import { useThemeMode } from 'antd-style';
+
+const Component = () => {
+  const { isDarkMode } = useThemeMode();
+  return (
+    <div
+      className={cx(
+        isDarkMode ? styles.rootDark : styles.rootLight
+      )}
+    />
+  );
+};
+```
+
+#### 方式 B: 使用 cva 将 isDarkMode 作为 variant（推荐，适用于复杂场景）
+
+**步骤：**
+
+1. 创建 `Dark` 和 `Light` 两个静态样式
+2. 在 `cva` 中将 `isDarkMode` 作为 variant prop
+3. 运行时直接传入 `isDarkMode` 值
+
+**示例：**
+
+**样式文件：**
+
+```typescript
+import { createStaticStyles } from 'antd-style';
+import { cva } from 'class-variance-authority';
+
+export const styles = createStaticStyles(({ css, cssVar }) => {
+  return {
+    filledDark: css`
+      background: ${cssVar.colorFillTertiary};
+      color: ${cssVar.colorTextLightSolid};
+    `,
+    filledLight: css`
+      background: ${cssVar.colorFillQuaternary};
+      color: ${cssVar.colorText};
+    `,
+    outlined: css`
+      border: 1px solid ${cssVar.colorBorder};
+    `,
+    root: css`
+      /* base styles */
+    `,
+  };
+});
+
+export const variants = cva(styles.root, {
+  defaultVariants: {
+    isDarkMode: false,
+    variant: 'filled',
+  },
+  variants: {
+    isDarkMode: {
+      false: null,
+      true: null, // isDarkMode 本身不添加样式，通过 compoundVariants 组合
+    },
+    variant: {
+      filled: null, // variant 本身不添加样式，通过 compoundVariants 组合
+      outlined: styles.outlined,
+    },
+  },
+  compoundVariants: [
+    {
+      class: styles.filledDark,
+      isDarkMode: true,
+      variant: 'filled',
+    },
+    {
+      class: styles.filledLight,
+      isDarkMode: false,
+      variant: 'filled',
+    },
+  ],
+});
+```
+
+**组件文件：**
+
+```typescript
+import { useThemeMode } from 'antd-style';
+import { variants } from './style';
+
+const Component = ({ variant = 'filled' }) => {
+  const { isDarkMode } = useThemeMode();
+  return (
+    <div
+      className={variants({ isDarkMode, variant })}
+    />
+  );
+};
+```
+
+**优势：**
+
+- ✅ 不需要 `useMemo` 动态创建 variants
+- ✅ 更符合 `cva` 的设计理念
+- ✅ 代码更简洁，性能更好
+- ✅ 类型安全，IDE 自动补全
+
+**已优化示例：**
+
+- `TypewriterEffect`: `textDark` / `textLight`（方式 A）
+- `Collapse`: `filledDark` / `filledLight`（可优化为方式 B）
+- `Hotkey`: `inverseThemeDark` / `inverseThemeLight`（可优化为方式 B）
+- `GuideCard`: `filledDark` / `filledLight`（可优化为方式 B）
+- `GradientButton`: `buttonDark` / `buttonLight`（方式 A）
+
+### 场景 5: responsive → 静态 responsive
+
+**适用：** 使用响应式断点
+
+**步骤：**
+
+1. 导入静态 `responsive` from `antd-style`
+2. 使用 `responsive.sm` 替代 `responsive.mobile`
+3. 从 `createStyles` 参数中移除 `responsive`
+
+**示例：**
+
+**之前：**
+
+```typescript
+import { createStyles } from 'antd-style';
+
+export const useStyles = createStyles(({ css, responsive }) => ({
+  root: css`
+    ${responsive.mobile} {
+      padding: 12px;
+    }
+  `,
+}));
+```
+
+**之后：**
+
+```typescript
+import { createStaticStyles } from 'antd-style';
+import { responsive } from 'antd-style';
+
+export const styles = createStaticStyles(({ css }) => ({
+  root: css`
+    ${responsive.sm} {
+      padding: 12px;
+    }
+  `,
+}));
+```
+
+**注意：**
+
+- `responsive.mobile` → `responsive.sm`
+- 静态 `responsive` 提供：`xs`, `sm`, `md`, `lg`, `xl`, `xxl`
+
+**已优化示例：**
+
+- `Header`: `responsive.mobile` → `responsive.sm`
+- `FormModal`: `responsive.mobile` → `responsive.sm`
+- `Hero`: `responsive.mobile` → `responsive.sm`
+
+### 场景 6: stylish → lobeStaticStylish
+
+**适用：** 使用自定义 `stylish` 工具
+
+**步骤：**
+
+1. 导入 `lobeStaticStylish` from `@/styles`
+2. 替换 `stylish.xxx` → `lobeStaticStylish.xxx`
+
+**示例：**
+
+**之前：**
+
+```typescript
+import { createStyles } from 'antd-style';
+
+export const useStyles = createStyles(({ css, stylish }) => ({
+  root: css`
+    ${stylish.blur};
+    ${stylish.variantFilled};
+  `,
+}));
+```
+
+**之后：**
+
+```typescript
+import { createStaticStyles } from 'antd-style';
+
+import { lobeStaticStylish } from '@/styles';
+
+export const styles = createStaticStyles(({ css }) => ({
+  root: css`
+    ${lobeStaticStylish.blur};
+    ${lobeStaticStylish.variantFilled};
+  `,
+}));
+```
+
+**已优化示例：**
+
+- `Button`: `stylish.blur` → `lobeStaticStylish.blur`
+- `Hero`: `stylish.gradientAnimation` → `lobeStaticStylish.gradientAnimation`
+
+### 场景 7: prefixCls → 硬编码
+
+**适用：** 使用动态 `prefixCls` 参数
+
+**步骤：**
+
+1. 在文件顶部硬编码 `const prefixCls = 'ant'`
+2. 从 `createStyles` 参数中移除 `prefixCls`
+
+**示例：**
+
+**之前：**
+
+```typescript
+export const useStyles = createStyles(({ css }, prefixCls: string) => ({
+  root: css`
+    .${prefixCls}-button {
+      /* styles */
+    }
+  `,
+}));
+```
+
+**之后：**
+
+```typescript
+const prefixCls = 'ant';
+
+export const styles = createStaticStyles(({ css }) => ({
+  root: css`
+    .${prefixCls}-button {
+      /* styles */
+    }
+  `,
+}));
+```
+
+**已优化示例：**
+
+- `Alert`, `Collapse`, `FormModal`, `Image`, `Burger`, `DraggablePanel`, `DraggableSideNav`, `Toc`, `ColorSwatches`, `EmojiPicker`, `Form`, `awesome/Features`
+
+### 场景 8: readableColor () → Token 替换
+
+**适用：** 使用 `readableColor()` 计算对比色
+
+**规则：**
+
+- `readableColor(token.colorPrimary)` → `cssVar.colorTextLightSolid`（主色背景用白色文字）
+- `readableColor(token.colorTextQuaternary)` → `cssVar.colorText`（浅色背景用深色文字）
+
+**示例：**
+
+**之前：**
+
+```typescript
+import { readableColor } from 'polished';
+
+export const useStyles = createStyles(({ css, token }) => ({
+  checked: css`
+    background-color: ${token.colorPrimary};
+    color: ${readableColor(token.colorPrimary)};
+  `,
+}));
+```
+
+**之后：**
+
+```typescript
+export const styles = createStaticStyles(({ css, cssVar }) => ({
+  checked: css`
+    background-color: ${cssVar.colorPrimary};
+    color: ${cssVar.colorTextLightSolid};
+  `,
+}));
+```
+
+**已优化示例：**
+
+- `Checkbox`: `readableColor(token.colorPrimary)` → `cssVar.colorTextLightSolid`
+
+### 场景 9: rgba () → color-mix ()
+
+**适用：** 使用 `rgba()` 设置透明度
+
+**步骤：**
+
+1. 使用 CSS 原生的 `color-mix()` 函数
+2. 格式：`color-mix(in srgb, ${cssVar.xxx} alpha%, transparent)`
+
+**示例：**
+
+**之前：**
+
+```typescript
+import { rgba } from 'polished';
+
+export const useStyles = createStyles(({ css, token }) => ({
+  root: css`
+    background-color: ${rgba(token.colorBgLayout, 0.4)};
+  `,
+}));
+```
+
+**之后：**
+
+```typescript
+export const styles = createStaticStyles(({ css, cssVar }) => ({
+  root: css`
+    background-color: color-mix(in srgb, ${cssVar.colorBgLayout} 40%, transparent);
+  `,
+}));
+```
+
+**已优化示例：**
+
+- `Header`: `rgba(cssVar.colorBgLayout, 0.4)` → `color-mix(...)`
+- `FormModal`: `rgba(cssVar.colorBgContainer, 0)` → `color-mix(...)`
+
+### 场景 10: keyframes → css
+
+**适用：** 使用 `keyframes` 创建动画
+
+**步骤：**
+
+1. 在 `createStaticStyles` 外部定义 `keyframes`
+2. 在样式内部使用
+
+**示例：**
+
+**之前：**
+
+```typescript
+export const useStyles = createStyles(({ css, keyframes }) => {
+  const spin = keyframes`
+    from { transform: rotate(0deg); }
+    to { transform: rotate(360deg); }
+  `;
+  return {
+    icon: css`
+      animation: ${spin} 1s linear infinite;
+    `,
+  };
+});
+```
+
+**之后：**
+
+```typescript
+import { keyframes } from 'antd-style';
+
+const spin = keyframes`
+  from { transform: rotate(0deg); }
+  to { transform: rotate(360deg); }
+`;
+
+export const styles = createStaticStyles(({ css }) => ({
+  icon: css`
+    animation: ${spin} 1s linear infinite;
+  `,
+}));
+```
+
+**已优化示例：**
+
+- `Icon`: `keyframes` 动画
+- `Skeleton`: `keyframes` shimmer 动画
+
+## ⚠️ 反模式：避免使用 createVariants (isDarkMode)
+
+**不推荐的做法：**
+
+```typescript
+// ❌ 不推荐：在组件中动态创建 variants
+export const createVariants = (isDarkMode: boolean) =>
+  cva(styles.root, {
+    variants: {
+      variant: {
+        filled: isDarkMode ? styles.filledDark : styles.filledLight,
+      },
+    },
+  });
+
+// 组件中
+const variants = useMemo(() => createVariants(isDarkMode), [isDarkMode]);
+```
+
+**推荐的做法：**
+
+将 `isDarkMode` 作为 `cva` 的 variant prop（见场景 4 方式 B），这样：
+
+- ✅ 不需要 `useMemo` 动态创建
+- ✅ 更符合 `cva` 的设计理念
+- ✅ 代码更简洁，性能更好
+- ✅ 类型安全，IDE 自动补全
+
+```typescript
+// ✅ 推荐：将 isDarkMode 作为 variant prop
+export const variants = cva(styles.root, {
+  variants: {
+    isDarkMode: {
+      false: null,
+      true: null,
+    },
+    variant: {
+      filled: null,
+    },
+  },
+  compoundVariants: [
+    {
+      class: styles.filledDark,
+      isDarkMode: true,
+      variant: 'filled',
+    },
+    {
+      class: styles.filledLight,
+      isDarkMode: false,
+      variant: 'filled',
+    },
+  ],
+});
+
+// 组件中
+const { isDarkMode } = useThemeMode();
+const className = variants({ isDarkMode, variant: 'filled' });
+```
+
+## ⚠️ 无法优化的场景
+
+### 1. JS 计算函数
+
+**无法优化：**
+
+- `chroma()` - 颜色计算库
+- `readableColor()` - 需要运行时计算（但可以用 token 替代）
+- `mix()` - 颜色混合计算
+- `calc()` 中使用 token 数值进行复杂计算
+
+**示例：**
+
+```typescript
+// ❌ 无法优化
+const scale = chroma.bezier([token.colorText, backgroundColor]).scale().colors(6);
+```
+
+### 2. 复杂的动态 Props
+
+**无法优化：**
+
+- 需要复杂计算的 props
+- 对象 / 数组类型的 props
+- 函数类型的 props
+
+### 3. useTheme Hook
+
+**无法优化：**
+
+- 直接使用 `useTheme()` hook 获取运行时值
+- 例如：`awesome/Giscus/style.ts` 使用 `useTheme()` 获取主题值
+
+## 📋 迁移检查清单
+
+### 样式文件检查
+
+- [ ] `createStyles` → `createStaticStyles`
+- [ ] `token.xxx` → `cssVar.xxx`
+- [ ] 移除 `px` 后缀（`cssVar` 已包含单位）
+- [ ] `responsive.mobile` → `responsive.sm`（如果使用）
+- [ ] `stylish.xxx` → `lobeStaticStylish.xxx`（如果使用）
+- [ ] `rgba()` → `color-mix()`（如果使用）
+- [ ] `readableColor()` → token 替换（如果使用）
+- [ ] `prefixCls` 参数 → 硬编码 `const prefixCls = 'ant'`（如果使用）
+- [ ] `isDarkMode` → 静态样式拆分（如果使用）
+- [ ] 动态 props → CSS 变量（如果使用）
+
+### 组件文件检查
+
+- [ ] `useStyles()` → `import { styles } from './style'`
+- [ ] `import { cx } from 'antd-style'`（如果需要）
+- [ ] `import { useTheme } from 'antd-style'`（如果需要 `theme.isDarkMode`）
+- [ ] 动态 props → CSS 变量设置（如果使用）
+- [ ] `isDarkMode` 条件 → `theme.isDarkMode` 判断（如果使用）
+
+## 🎯 优化优先级
+
+### 高优先级（简单优化）
+
+1. ✅ 纯静态样式（无动态 props）
+2. ✅ `isDarkMode` 拆分
+3. ✅ `responsive.mobile` → `responsive.sm`
+4. ✅ `stylish` → `lobeStaticStylish`
+5. ✅ `readableColor()` → token 替换
+
+### 中优先级（需要转换）
+
+6. ✅ 简单的动态 props → CSS 变量（1-2 个）
+7. ✅ 布尔值 props → 静态样式拆分（2-3 个）
+
+### 低优先级（复杂优化）
+
+8. ⚠️ 多个动态 props → CSS 变量（3+ 个）
+9. ⚠️ 复杂的条件逻辑拆分
+
+## 📚 参考示例
+
+### 完整示例 1: 简单组件
+
+**样式文件：**
+
+```typescript
+import { createStaticStyles } from 'antd-style';
+
+export const styles = createStaticStyles(({ css, cssVar }) => ({
+  root: css`
+    padding: ${cssVar.padding};
+    color: ${cssVar.colorText};
+    border-radius: ${cssVar.borderRadius};
+  `,
+}));
+```
+
+**组件文件：**
+
+```typescript
+import { cx } from 'antd-style';
+import { styles } from './style';
+
+const Component = ({ className }) => {
+  return <div className={cx(styles.root, className)} />;
+};
+```
+
+### 完整示例 2: 带动态 Props
+
+**样式文件：**
+
+```typescript
+import { createStaticStyles } from 'antd-style';
+
+export const styles = createStaticStyles(({ css, cssVar }) => ({
+  root: css`
+    width: var(--component-size, 24px);
+    height: var(--component-size, 24px);
+    background: ${cssVar.colorBgContainer};
+  `,
+}));
+```
+
+**组件文件：**
+
+```typescript
+import { cx } from 'antd-style';
+import { useMemo } from 'react';
+import { styles } from './style';
+
+const Component = ({ size = 24, className, style, ...rest }) => {
+  const cssVariables = useMemo<Record<string, string>>(
+    () => ({
+      '--component-size': `${size}px`,
+    }),
+    [size],
+  );
+
+  return (
+    <div
+      className={cx(styles.root, className)}
+      style={{
+        ...cssVariables,
+        ...style,
+      }}
+      {...rest}
+    />
+  );
+};
+```
+
+### 完整示例 3: 带 isDarkMode
+
+**样式文件：**
+
+```typescript
+import { createStaticStyles } from 'antd-style';
+
+export const styles = createStaticStyles(({ css, cssVar }) => ({
+  rootDark: css`
+    background: ${cssVar.colorFillTertiary};
+    color: ${cssVar.colorTextLightSolid};
+  `,
+  rootLight: css`
+    background: ${cssVar.colorFillQuaternary};
+    color: ${cssVar.colorText};
+  `,
+}));
+```
+
+**组件文件：**
+
+```typescript
+import { cx, useTheme } from 'antd-style';
+import { styles } from './style';
+
+const Component = ({ className }) => {
+  const { theme } = useTheme();
+  return (
+    <div
+      className={cx(
+        theme.isDarkMode ? styles.rootDark : styles.rootLight,
+        className
+      )}
+    />
+  );
+};
+```
+
+## 🔍 验证步骤
+
+1. **类型检查：** `pnpm run type-check`
+2. **运行时测试：** 确保视觉效果一致
+3. **性能验证：** 检查样式计算是否在模块加载时完成
+
+## 📊 优化效果
+
+- ✅ **零运行时开销**：样式在模块加载时计算一次
+- ✅ **减少重新渲染**：组件不再依赖样式 hook
+- ✅ **更好的性能**：减少每次渲染的计算开销
+- ✅ **代码更简洁**：直接导入样式对象
+
+## 🔧 场景 11: useTheme () → useThemeMode () /cssVar
+
+**适用：** 组件中只使用 `theme.isDarkMode` 或其他 token 值
+
+**规则：**
+
+- 如果只使用 `theme.isDarkMode`，使用 `const { isDarkMode } = useThemeMode()` 替代
+- 如果使用其他 token（如 `theme.colorText`, `theme.borderRadius` 等），使用 `cssVar` 替代
+- `useThemeMode()` 比 `useTheme()` 更轻量，只返回 `isDarkMode` 值
+
+**示例：**
+
+**之前：**
+
+```typescript
+import { useTheme } from 'antd-style';
+
+const Component = () => {
+  const theme = useTheme();
+  return (
+    <div className={theme.isDarkMode ? styles.dark : styles.light}>
+      {theme.colorText}
+    </div>
+  );
+};
+```
+
+**之后：**
+
+```typescript
+import { cssVar, useThemeMode } from 'antd-style';
+
+const Component = () => {
+  const { isDarkMode } = useThemeMode();
+  return (
+    <div className={isDarkMode ? styles.dark : styles.light}>
+      {cssVar.colorText}
+    </div>
+  );
+};
+```
+
+**已优化示例：**
+
+- `AuroraBackground`, `Select`, `Input`, `Button`, `DatePicker`, `AutoComplete`, `InputNumber`, `InputPassword`, `InputOPT`, `TextArea`, `SpotlightCardItem`, `Spotlight`, `HotkeyInput` - 只使用 `isDarkMode` → `useThemeMode()`
+- `Image`, `GradientButton`, `Empty`, `FileTypeIcon`, `FormSubmitFooter`, `CodeEditor`, `LobeChat`, `Drawer`, `Modal`, `Avatar`, `AvatarGroup`, `SkeletonAvatar`, `SkeletonButton`, `SkeletonTags`, `Callout`, `LobeHub`, `GridBackground`, `FolderIcon`, `FileIcon`, `TokenTag`, `ChatSendButton`, `AvatarUploader` - 使用 token → `cssVar`
+
+**无法优化的文件（需要保留 `useTheme()`）：**
+
+- `useMermaid`, `useStreamMermaid`, `useHighlight`, `useStreamHighlight` - 需要完整的 theme 对象传给第三方库
+- `Alert`, `Tag`, `Menu`, `EmojiPicker` - 需要实际颜色值传给颜色计算函数
+- `SkeletonTitle`, `SkeletonTags` - 需要数值进行数学运算
+- `GridShowcase`, `GridBackground/demos` - 需要实际颜色值传给 `rgba()` 函数
+- `CustomFonts` - 需要实际字符串值进行字符串拼接
+- `Giscus/style.ts` - 需要实际颜色值传给 `readableColor()` 和 `rgba()` 函数（其他 token 已优化为 `cssVar`）
+
+**注意事项：**
+
+- `useThemeMode()` 只返回 `{ isDarkMode }`，不返回完整的 theme 对象
+- `cssVar` 的值是字符串（如 `"14px"`, `"#ffffff"`），可以直接在 JSX 中使用
+- 如果 token 需要用于数值计算（如 `Math.round(theme.fontSize * 1.5)`），需要保留 `useTheme()`
+
+## 🎉 总结
+
+`createStaticStyles` 迁移是一个渐进式的优化过程。对于简单的静态样式，可以直接转换；对于复杂的动态场景，需要根据具体情况选择合适的优化策略。关键是要理解每种场景的处理方式，并灵活运用 CSS 变量、静态样式拆分等技术。
+
+### useTheme () 优化总结
+
+- ✅ **使用 `useThemeMode()`**：当组件只使用 `theme.isDarkMode` 时
+- ✅ **使用 `cssVar`**：当组件使用其他 token 值（颜色、尺寸等）时
+- ⚠️ **保留 `useTheme()`**：当 token 需要用于数值计算或传给第三方库时
@@ -1,7 +1,7 @@
 const config = require('@lobehub/lint').eslint;

 config.root = true;
-config.extends.push('plugin:@next/next/recommended');
+config.extends.push('plugin:@next/next/recommended-legacy');

 config.rules['unicorn/no-negated-condition'] = 0;
 config.rules['unicorn/prefer-type-error'] = 0;
@@ -21,7 +21,7 @@ jobs:
          git config --global user.name "lobehubbot"
          git config --global user.email "i@lobehub.com"

-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          ref: ${{ github.event.pull_request.head.ref }}

@@ -0,0 +1,115 @@
+name: Bundle Analyzer
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  actions: write
+
+env:
+  NODE_VERSION: 24.11.1
+  BUN_VERSION: 1.2.23
+
+jobs:
+  bundle-analyzer:
+    name: Analyze Bundle Size
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Install dependencies
+        run: pnpm i
+
+      - name: Ensure lockfile exists
+        run: |
+          # Temporarily override .npmrc lockfile=false setting
+          # to generate pnpm-lock.yaml for reproducible builds
+          if [ ! -f "pnpm-lock.yaml" ]; then
+            echo "Generating pnpm-lock.yaml..."
+            # Create temporary .npmrc override
+            mv .npmrc .npmrc.bak
+            echo "lockfile=true" > .npmrc
+            cat .npmrc.bak >> .npmrc
+            pnpm i
+            mv .npmrc.bak .npmrc
+          fi
+
+      - name: Generate build secrets
+        id: generate-secret
+        run: echo "secret=$(openssl rand -base64 32)" >> $GITHUB_OUTPUT
+
+      - name: Build with bundle analyzer
+        run: bun run build:analyze || true
+        env:
+          NODE_OPTIONS: --max-old-space-size=8192
+          KEY_VAULTS_SECRET: ${{ secrets.KEY_VAULTS_SECRET || steps.generate-secret.outputs.secret }}
+
+      - name: Prepare analyzer reports
+        run: |
+          mkdir -p bundle-report
+          # Copy analyzer HTML reports if they exist
+          if [ -d ".next/analyze" ]; then
+            cp -r .next/analyze/* bundle-report/ || true
+          fi
+          # Also check if reports are in .vercel/output
+          if [ -d ".vercel/output/.next/analyze" ]; then
+            cp -r .vercel/output/.next/analyze/* bundle-report/ || true
+          fi
+          # Include pnpm lockfile for reproducible builds
+          if [ -f "pnpm-lock.yaml" ]; then
+            cp pnpm-lock.yaml bundle-report/pnpm-lock.yaml
+            echo "Copied pnpm-lock.yaml to bundle-report"
+          else
+            echo "Warning: pnpm-lock.yaml not found"
+          fi
+          # Create a summary with build metadata
+          echo "# Bundle Analysis Report" > bundle-report/README.md
+          echo "" >> bundle-report/README.md
+          echo "**Build Date:** $(date -u +"%Y-%m-%d %H:%M:%S UTC")" >> bundle-report/README.md
+          echo "**Commit:** ${{ github.sha }}" >> bundle-report/README.md
+          echo "**Branch:** ${{ github.ref_name }}" >> bundle-report/README.md
+          echo "" >> bundle-report/README.md
+          echo "## How to view" >> bundle-report/README.md
+          echo "" >> bundle-report/README.md
+          echo "1. Download the \`bundle-report\` artifact from this workflow run" >> bundle-report/README.md
+          echo "2. Extract the archive" >> bundle-report/README.md
+          echo "3. Open \`client.html\` and \`server.html\` in your browser" >> bundle-report/README.md
+          echo "" >> bundle-report/README.md
+          echo "## Files in this report" >> bundle-report/README.md
+          echo "" >> bundle-report/README.md
+          echo "- \`client.html\` - Client-side bundle analysis" >> bundle-report/README.md
+          echo "- \`server.html\` - Server-side bundle analysis" >> bundle-report/README.md
+          echo "- \`pnpm-lock.yaml\` - pnpm lockfile (for reproducible builds)" >> bundle-report/README.md
+
+      - name: Upload bundle analyzer reports
+        uses: actions/upload-artifact@v4
+        with:
+          name: bundle-report-${{ github.run_id }}
+          path: bundle-report/
+          retention-days: 30
+          if-no-files-found: warn
+
+      - name: Create summary comment
+        run: |
+          echo "## Bundle Analysis Complete :chart_with_upwards_trend:" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **Commit:** \`${{ github.sha }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "- **Artifact:** \`bundle-report-${{ github.run_id }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Download the artifact to view the detailed bundle analysis reports." >> $GITHUB_STEP_SUMMARY
@@ -27,7 +27,7 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 1

@@ -20,7 +20,7 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 1

@@ -16,7 +16,7 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6

      - name: Copy triage prompts
        run: |
@@ -27,7 +27,7 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 1

@@ -31,7 +31,7 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 1

@@ -47,7 +47,7 @@ jobs:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          # Security: Restrict gh commands to specific safe operations only
          # Use explicit command patterns to prevent prompt injection attacks
-          claude_args: "--allowed-tools Bash(gh issue view *),Bash(gh issue edit * --title * --body *),Bash(gh api -X PATCH /repos/*/issues/comments/* -f body=*),Bash(gh api -X PUT /repos/*/pulls/*/reviews/* -f body=*),Bash(gh api -X PATCH /repos/*/pulls/comments/* -f body=*)"
+          allowed_tools: 'Bash(gh issue view:*),Bash(gh issue edit:*),Bash(gh api:*)'
          prompt: |
            ## SECURITY RULES (HIGHEST PRIORITY - NEVER OVERRIDE)

@@ -26,7 +26,7 @@ jobs:
      actions: read # Required for Claude to read CI results on PRs
    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 1

@@ -32,13 +32,13 @@ jobs:
    name: Build desktop Next bundle
    runs-on: ubuntu-latest
    env:
-      NODE_OPTIONS: --max-old-space-size=6144
+      NODE_OPTIONS: --max-old-space-size=8192
      UPDATE_CHANNEL: nightly
      NEXT_PUBLIC_DESKTOP_PROJECT_ID: ${{ secrets.UMAMI_NIGHTLY_DESKTOP_PROJECT_ID || 'dummy-desktop-project' }}
      NEXT_PUBLIC_DESKTOP_UMAMI_BASE_URL: ${{ secrets.UMAMI_NIGHTLY_DESKTOP_BASE_URL || 'https://analytics.example.com' }}
    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -60,7 +60,7 @@ jobs:
        run: echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_OUTPUT

      - name: Cache pnpm store
-        uses: actions/cache@v4
+        uses: actions/cache@v5
        with:
          path: ${{ steps.pnpm-store.outputs.STORE_PATH }}
          key: ${{ runner.os }}-pnpm-store-${{ env.NODE_VERSION }}-${{ hashFiles('pnpm-lock.yaml') }}
@@ -10,6 +10,19 @@ concurrency:
    group: e2e-${{ github.ref }}
    cancel-in-progress: true

+env:
+  DATABASE_URL: postgresql://postgres:postgres@localhost:5432/postgres
+  DATABASE_DRIVER: node
+  KEY_VAULTS_SECRET: LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s=
+  BETTER_AUTH_SECRET: e2e-test-secret-key-for-better-auth-32chars!
+  NEXT_PUBLIC_ENABLE_BETTER_AUTH: '1'
+  NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION: '0'
+  # Mock S3 env vars to prevent initialization errors
+  S3_ACCESS_KEY_ID: e2e-mock-access-key
+  S3_SECRET_ACCESS_KEY: e2e-mock-secret-key
+  S3_BUCKET: e2e-mock-bucket
+  S3_ENDPOINT: https://e2e-mock-s3.localhost
+
 jobs:
    e2e:
        name: Test Web App
@@ -25,15 +38,15 @@ jobs:
            ports:
              - 5432:5432

-        timeout-minutes: 25
+        timeout-minutes: 30
        steps:
            - name: Checkout
-              uses: actions/checkout@v5
+              uses: actions/checkout@v6

            - name: Setup Bun
              uses: oven-sh/setup-bun@v2
              with:
-                  bun-version: 1.2.23
+                  bun-version: latest

            - name: Install dependencies (bun)
              run: bun install
@@ -41,12 +54,15 @@ jobs:
            - name: Install Playwright browsers (with system deps)
              run: bunx playwright install --with-deps chromium

-            - name: Run E2E tests
+            - name: Run database migrations
+              run: bun run db:migrate
+
+            - name: Build application
+              run: bun run build
              env:
-                  PORT: 3010
-                  DATABASE_URL: postgresql://postgres:postgres@localhost:5432/postgres
-                  DATABASE_DRIVER: node
-                  KEY_VAULTS_SECRET: LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s=
+                SKIP_LINT: '1'
+
+            - name: Run E2E tests
              run: bun run e2e

            - name: Upload Cucumber HTML report (on failure)
@@ -15,7 +15,7 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6

      - name: Setup Bun
        uses: oven-sh/setup-bun@v2
@@ -2,7 +2,7 @@ name: Lighthouse Badger

 env:
  TOKEN_NAME: 'GH_TOKEN'
-  REPO_BRANCH: 'lobehub/lobe-chat lighthouse'
+  REPO_BRANCH: 'jaworldwideorg/OneJA-Bot lighthouse'
  USER_NAME: 'lobehubbot'
  USER_EMAIL: 'i@lobehub.com'
  AUDIT_TYPE: 'both'
@@ -42,12 +42,12 @@ jobs:
          echo "BRANCH=$BRANCH" >> $GITHUB_ENV
        env:
          REPO_BRANCH: ${{ matrix.REPO_BRANCH || env.REPO_BRANCH }}
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          repository: ${{ env.REPOSITORY }}
          token: ${{ secrets[matrix.TOKEN_NAME] || secrets[env.TOKEN_NAME] }}
          ref: ${{ env.BRANCH }}
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          repository: 'myactionway/lighthouse-badges'
          path: temp_lighthouse_badges_nested
@@ -16,7 +16,7 @@ jobs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6

      - name: Lock closed issues after 7 days of inactivity
        uses: actions/github-script@v8
@@ -49,7 +49,7 @@ jobs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout base
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -62,13 +62,9 @@ jobs:

      - name: Install deps
        run: bun i
-        env:
-          NODE_OPTIONS: --max-old-space-size=6144

      - name: Lint
        run: bun run lint
-        env:
-          NODE_OPTIONS: --max-old-space-size=6144

  version:
    name: Determine version
@@ -76,7 +72,7 @@ jobs:
    outputs:
      version: ${{ steps.set_version.outputs.version }}
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -118,7 +114,7 @@ jobs:
      matrix:
        os: [macos-latest, macos-15-intel]
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -196,7 +192,7 @@ jobs:
    if: inputs.build_windows
    runs-on: windows-2025
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -249,7 +245,7 @@ jobs:
    if: inputs.build_linux
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -303,7 +299,7 @@ jobs:
    if: inputs.build_macos
    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6

      - name: Setup Node & Bun
        uses: ./.github/actions/setup-node-bun
@@ -25,7 +25,7 @@ jobs:
    runs-on: ubuntu-latest # 只在 ubuntu 上运行一次检查
    steps:
      - name: Checkout base
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -33,18 +33,18 @@ jobs:
        uses: ./.github/actions/setup-node-bun
        with:
          node-version: 24.11.1
-          bun-version: 1.2.23
+          bun-version: latest
          package-manager-cache: 'false'

      - name: Install deps
        run: bun i
        env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192

      - name: Lint
        run: bun run lint
        env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192

  version:
    name: Determine version
@@ -55,7 +55,7 @@ jobs:
      # 输出版本信息，供后续 job 使用
      version: ${{ steps.set_version.outputs.version }}
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -80,7 +80,7 @@ jobs:
          echo "📦 Release Version: ${version} (based on base version ${base_version})"

        env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192

      # 输出版本信息总结，方便在 GitHub Actions 界面查看
      - name: Version Summary
@@ -95,7 +95,7 @@ jobs:
      matrix:
        os: [macos-latest, macos-15-intel, windows-2025, ubuntu-latest]
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -218,13 +218,13 @@ jobs:
      contents: write
    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6

      - name: Setup Node & Bun
        uses: ./.github/actions/setup-node-bun
        with:
          node-version: 24.11.1
-          bun-version: 1.2.23
+          bun-version: latest
          package-manager-cache: 'false'

      # 下载所有平台的构建产物
@@ -274,7 +274,7 @@ jobs:
    outputs:
      artifact_path: ${{ steps.set_path.outputs.path }}
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -15,7 +15,8 @@ permissions:
  pull-requests: write

 env:
-  REGISTRY_IMAGE: lobehub/lobehub
+  REGISTRY_URL: jaworldwide.azurecr.io
+  REGISTRY_IMAGE: jaworldwide.azurecr.io/oneja/ai/bot-database
  PR_TAG_PREFIX: pr-

 jobs:
@@ -38,7 +39,7 @@ jobs:
          echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV

      - name: Checkout PR branch
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -68,8 +69,9 @@ jobs:
      - name: Docker login
        uses: docker/login-action@v3
        with:
-          username: ${{ secrets.DOCKER_REGISTRY_USER }}
-          password: ${{ secrets.DOCKER_REGISTRY_PASSWORD }}
+          registry: ${{ env.REGISTRY_URL }}
+          username: ${{ secrets.CONTAINER_REGISTRY_USER }}
+          password: ${{ secrets.CONTAINER_REGISTRY_PASSWORD }}

      - name: Build and export
        id: build
@@ -106,7 +108,7 @@ jobs:
    if: github.event.pull_request.head.repo.full_name == github.repository
    steps:
      - name: Checkout PR branch
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -142,8 +144,9 @@ jobs:
      - name: Docker login
        uses: docker/login-action@v3
        with:
-          username: ${{ secrets.DOCKER_REGISTRY_USER }}
-          password: ${{ secrets.DOCKER_REGISTRY_PASSWORD }}
+          registry: ${{ env.REGISTRY_URL }}
+          username: ${{ secrets.CONTAINER_REGISTRY_USER }}
+          password: ${{ secrets.CONTAINER_REGISTRY_PASSWORD }}

      - name: Create manifest list and push
        working-directory: /tmp/digests
@@ -19,7 +19,7 @@ jobs:
    runs-on: ubuntu-latest # 只在 ubuntu 上运行一次检查
    steps:
      - name: Checkout base
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -32,7 +32,7 @@ jobs:
      - name: Install bun
        uses: oven-sh/setup-bun@v2
        with:
-          bun-version: 1.2.23
+          bun-version: latest

      - name: Install deps
        run: bun i
@@ -48,7 +48,7 @@ jobs:
      version: ${{ steps.set_version.outputs.version }}
      is_pr_build: ${{ steps.set_version.outputs.is_pr_build }}
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -84,7 +84,7 @@ jobs:
      matrix:
        os: [macos-latest, macos-15-intel, windows-2025, ubuntu-latest]
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -205,7 +205,7 @@ jobs:
      contents: write
    steps:
      - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
@@ -216,7 +216,7 @@ jobs:
      - name: Install bun
        uses: oven-sh/setup-bun@v2
        with:
-          bun-version: 1.2.23
+          bun-version: latest

      # 下载所有平台的构建产物
      - name: Download artifacts
@@ -12,7 +12,9 @@ concurrency:
  cancel-in-progress: false

 env:
-  REGISTRY_IMAGE: lobehub/lobehub
+  REGISTRY_URL: jaworldwide.azurecr.io
+  REGISTRY_IMAGE: jaworldwide.azurecr.io/oneja/ai/bot-database
+  PR_TAG_PREFIX: pr-

 jobs:
  build:
@@ -33,7 +35,7 @@ jobs:
          echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV

      - name: Checkout base
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -52,8 +54,9 @@ jobs:
      - name: Docker login
        uses: docker/login-action@v3
        with:
-          username: ${{ secrets.DOCKER_REGISTRY_USER }}
-          password: ${{ secrets.DOCKER_REGISTRY_PASSWORD }}
+          registry: ${{ env.REGISTRY_URL }}
+          username: ${{ secrets.CONTAINER_REGISTRY_USER }}
+          password: ${{ secrets.CONTAINER_REGISTRY_PASSWORD }}

      - name: Get commit SHA
        if: github.ref == 'refs/heads/main'
@@ -93,7 +96,7 @@ jobs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout base
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
        with:
          fetch-depth: 0

@@ -119,8 +122,9 @@ jobs:
      - name: Docker login
        uses: docker/login-action@v3
        with:
-          username: ${{ secrets.DOCKER_REGISTRY_USER }}
-          password: ${{ secrets.DOCKER_REGISTRY_PASSWORD }}
+          registry: ${{ env.REGISTRY_URL }}
+          username: ${{ secrets.CONTAINER_REGISTRY_USER }}
+          password: ${{ secrets.CONTAINER_REGISTRY_PASSWORD }}

      - name: Create manifest list and push
        working-directory: /tmp/digests
@@ -28,7 +28,7 @@ jobs:
          - 5432:5432

    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
        with:
          token: ${{ secrets.GH_TOKEN }}

@@ -41,7 +41,7 @@ jobs:
      - name: Install bun
        uses: oven-sh/setup-bun@v2
        with:
-          bun-version: 1.2.23
+          bun-version: latest

      - name: Install deps
        run: bun i
@@ -13,7 +13,7 @@ jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6

      - name: Install bun
        uses: oven-sh/setup-bun@v2
@@ -17,7 +17,7 @@ jobs:
    if: ${{ github.event.repository.fork }}

    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6

      - name: Clean issue notice
        uses: actions-cool/issues-helper@v3
@@ -31,7 +31,7 @@ jobs:
        with:
          upstream_sync_repo: lobehub/lobe-chat
          upstream_sync_branch: next
-          target_sync_branch: next
+          target_sync_branch: main
          target_repo_token: ${{ secrets.GITHUB_TOKEN }} # automatically generated, no need to set
          test_mode: false

@@ -52,3 +52,12 @@ jobs:
            [lobechat]: https://github.com/lobehub/lobe-chat
            [tutorial-zh-CN]: https://lobehub.com/zh/docs/self-hosting/advanced/upstream-sync
            [tutorial-en-US]: https://lobehub.com/docs/self-hosting/advanced/upstream-sync
+
+      - name: Trigger Release Workflow
+        if: success() && steps.sync.outputs.has_new_commits == 'true'
+        run: |
+          curl -X POST \
+            -H "Authorization: token ${{ secrets.GH_TOKEN }}" \
+            -H "Accept: application/vnd.github.v3+json" \
+            https://api.github.com/repos/${{ github.repository }}/actions/workflows/release.yml/dispatches \
+            -d '{"ref":"main"}'
@@ -26,7 +26,7 @@ jobs:
    name: Test package ${{ matrix.package }}

    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
@@ -61,7 +61,7 @@ jobs:
    name: Test package ${{ matrix.package }}

    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
@@ -72,7 +72,7 @@ jobs:
      - name: Install bun
        uses: oven-sh/setup-bun@v2
        with:
-          bun-version: 1.2.23
+          bun-version: latest

      - name: Install deps
        run: bun i
@@ -94,7 +94,7 @@ jobs:
    runs-on: ubuntu-latest

    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
@@ -105,7 +105,7 @@ jobs:
      - name: Install bun
        uses: oven-sh/setup-bun@v2
        with:
-          bun-version: 1.2.23
+          bun-version: latest

      - name: Install deps
        run: bun i
@@ -126,7 +126,7 @@ jobs:
    runs-on: ubuntu-latest

    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
@@ -143,7 +143,7 @@ jobs:
        run: pnpm install
        working-directory: apps/desktop
        env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192

      - name: Typecheck Desktop
        run: pnpm type-check
@@ -173,11 +173,12 @@ jobs:
        options: >-
          --health-cmd pg_isready --health-interval 10s --health-timeout 5s  --health-retries 5

+
        ports:
          - 5432:5432

    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
@@ -0,0 +1,55 @@
+name: Verify Desktop Patch
+
+on:
+  push:
+    branches:
+      - main
+      - next
+      - dev
+    paths:
+      - 'scripts/electronWorkflow/**'
+      - 'src/libs/next/config/**'
+      - 'src/app/**'
+      - 'src/layout/**'
+      - 'src/components/mdx/**'
+      - 'src/features/DevPanel/**'
+      - 'src/server/translation.ts'
+  pull_request:
+    paths:
+      - 'scripts/electronWorkflow/**'
+      - 'src/libs/next/config/**'
+      - 'src/app/**'
+      - 'src/layout/**'
+      - 'src/components/mdx/**'
+      - 'src/features/DevPanel/**'
+      - 'src/server/translation.ts'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  NODE_VERSION: 24.11.1
+  BUN_VERSION: 1.2.23
+
+jobs:
+  verify:
+    name: Desktop patch smoke test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node & Bun
+        uses: ./.github/actions/setup-node-bun
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Install deps
+        run: bun i
+
+      - name: Verify desktop patch
+        run: bun scripts/electronWorkflow/modifiers/index.mts
@@ -1,2 +1,8 @@
-npm run type-check
-npx --no-install lint-staged
+# .husky/post-merge
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npm run type-check || echo "Type check failed, please fix issues!"
+npx --no-install lint-staged || echo "Lint-staged failed, but continuing merge..."
+
+exit 0
@@ -1,14 +1,14 @@
 const { defineConfig } = require('@lobehub/i18n-cli');

 module.exports = defineConfig({
-  entry: 'locales/zh-CN',
-  entryLocale: 'zh-CN',
+  entry: 'locales/en-US',
+  entryLocale: 'en-US',
  output: 'locales',
  outputLocales: [
    'ar',
    'bg-BG',
+    'zh-CN',
    'zh-TW',
-    'en-US',
    'ru-RU',
    'ja-JP',
    'ko-KR',
@@ -1,5 +1,10 @@
 const config = require('@lobehub/lint').semanticRelease;

+// Remove NPM publishing by excluding "@semantic-release/npm" plugin
+// Keep or add other plugins like GitHub Releases
+config.plugins = config.plugins.filter((plugin) => plugin !== '@semantic-release/npm');
+
+// Add GitHub only if required
 config.branches = [
  'main',
  {
@@ -15,4 +20,32 @@ config.plugins.push([
  },
 ]);

+// Override GitHub repository URL without modifying package.json
+// Make sure @semantic-release/github is present in the plugins
+if (!config.plugins.some(plugin => Array.isArray(plugin) ? plugin[0] === '@semantic-release/github' : plugin === '@semantic-release/github')) {
+  config.plugins.push([
+    '@semantic-release/github',
+    {
+      repositoryUrl: 'https://github.com/jaworldwideorg/OneJA-Bot.git'
+    }
+  ]);
+} else {
+  // Find and update the existing GitHub plugin configuration
+  config.plugins = config.plugins.map(plugin => {
+    if (Array.isArray(plugin) && plugin[0] === '@semantic-release/github') {
+      return [
+        '@semantic-release/github',
+        {
+          ...(plugin[1] || {}),
+          repositoryUrl: 'https://github.com/jaworldwideorg/OneJA-Bot.git'
+        }
+      ];
+    }
+    return plugin;
+  });
+}
+
+// Set repository URL in global config
+config.repositoryUrl = 'https://github.com/jaworldwideorg/OneJA-Bot.git';
+
 module.exports = config;
@@ -7,14 +7,16 @@
  "editor.formatOnSave": true,
  // don't show errors, but fix when save and git pre commit
  "eslint.rules.customizations": [
-    { "rule": "import/order", "severity": "off" },
-    { "rule": "prettier/prettier", "severity": "off" },
-    { "rule": "react/jsx-sort-props", "severity": "off" },
-    { "rule": "sort-keys-fix/sort-keys-fix", "severity": "off" },
-    { "rule": "simple-import-sort/exports", "severity": "off" },
-    { "rule": "typescript-sort-keys/interface", "severity": "off" }
+    // { "rule": "import/order", "severity": "off" },
+    // { "rule": "prettier/prettier", "severity": "off" },
+    // { "rule": "react/jsx-sort-props", "severity": "off" },
+    // { "rule": "sort-keys-fix/sort-keys-fix", "severity": "off" },
+    // { "rule": "simple-import-sort/exports", "severity": "off" },
+    // { "rule": "typescript-sort-keys/interface", "severity": "off" }
  ],
  "eslint.validate": [
+    // vscode eslint not 插件兼容性有问题
+    // "json",
    "javascript",
    "javascriptreact",
    "typescript",
@@ -24,9 +26,9 @@
  ],
  "npm.packageManager": "pnpm",
  "search.exclude": {
-    "**/node_modules": true,
+    "**/node_modules": true
    // useless to search this big folder
-    "locales": true
+    // "locales": true
  },
  "stylelint.validate": [
    "css",
@@ -39,58 +41,43 @@
    "**/app/**/[[]*[]]/[[]*[]]/page.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • page component",
    "**/app/**/[[]*[]]/page.tsx": "${dirname(1)}/${dirname} • page component",
    "**/app/**/page.tsx": "${dirname} • page component",
-
    "**/app/**/[[]*[]]/[[]*[]]/layout.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • page layout",
    "**/app/**/[[]*[]]/layout.tsx": "${dirname(1)}/${dirname} • page layout",
    "**/app/**/layout.tsx": "${dirname} • page layout",
-
    "**/app/**/[[]*[]]/[[]*[]]/default.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • slot default",
    "**/app/**/[[]*[]]/default.tsx": "${dirname(1)}/${dirname} • slot default",
    "**/app/**/default.tsx": "${dirname} • slot default",
-
    "**/app/**/[[]*[]]/[[]*[]]/error.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • error component",
    "**/app/**/[[]*[]]/error.tsx": "${dirname(1)}/${dirname} • error component",
    "**/app/**/error.tsx": "${dirname} • error component",
-
    "**/app/**/[[]*[]]/[[]*[]]/loading.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • loading component",
    "**/app/**/[[]*[]]/loading.tsx": "${dirname(1)}/${dirname} • loading component",
    "**/app/**/loading.tsx": "${dirname} • loading component",
-
    "**/src/**/route.ts": "${dirname(1)}/${dirname} • route",
    "**/src/**/index.tsx": "${dirname} • component",
-
    "**/packages/database/src/repositories/*/index.ts": "${dirname} • db repository",
    "**/packages/database/src/models/*.ts": "${filename} • db model",
    "**/packages/database/src/schemas/*.ts": "${filename} • db schema",
-
    "**/src/services/*.ts": "${filename} • service",
    "**/src/services/*/client.ts": "${dirname} • client service",
    "**/src/services/*/server.ts": "${dirname} • server service",
-
    "**/src/store/*/action.ts": "${dirname} • action",
    "**/src/store/*/slices/*/action.ts": "${dirname(2)}/${dirname} • action",
    "**/src/store/*/slices/*/actions/*.ts": "${dirname(1)}/${dirname}/${filename} • action",
-
    "**/src/store/*/initialState.ts": "${dirname} • state",
    "**/src/store/*/slices/*/initialState.ts": "${dirname(2)}/${dirname} • state",
-
    "**/src/store/*/selectors.ts": "${dirname} • selectors",
    "**/src/store/*/slices/*/selectors.ts": "${dirname(2)}/${dirname} • selectors",
-
    "**/src/store/*/reducer.ts": "${dirname} • reducer",
    "**/src/store/*/slices/*/reducer.ts": "${dirname(2)}/${dirname} • reducer",
-
    "**/src/config/modelProviders/*.ts": "${filename} • provider",
    "**/packages/model-bank/src/aiModels/*.ts": "${filename} • model",
    "**/packages/model-runtime/src/providers/*/index.ts": "${dirname} • runtime",
-
    "**/src/server/services/*/index.ts": "${dirname} • server/service",
    "**/src/server/routers/lambda/*.ts": "${filename} • lambda",
    "**/src/server/routers/async/*.ts": "${filename} • async",
    "**/src/server/routers/edge/*.ts": "${filename} • edge",
-
    "**/src/locales/default/*.ts": "${filename} • locale",
-
    "**/index.*": "${dirname}/${filename}.${extname}"
  }
 }
@@ -1,6 +1,6 @@
 # CLAUDE.md

-This document serves as a shared guideline for all team members when using Claude Code in this repository.
+This document serves as a shared guideline for all team members when using Claude Code in this opensource lobe-chat(also known as lobehub) repository.

 ## Tech Stack

@@ -14,7 +14,6 @@ read @.cursor/rules/project-structure.mdc

 ### Git Workflow

- The current release branch is `next` instead of `main` until v2.0.0 is officially released
 - use rebase for git pull
 - git commit message should prefix with gitmoji
 - git branch name format template: <type>/<feature-name>
@@ -74,13 +74,14 @@ ENV NEXT_PUBLIC_ANALYTICS_UMAMI="${NEXT_PUBLIC_ANALYTICS_UMAMI}" \
    NEXT_PUBLIC_UMAMI_WEBSITE_ID="${NEXT_PUBLIC_UMAMI_WEBSITE_ID}"

 # Node
-ENV NODE_OPTIONS="--max-old-space-size=6144"
+ENV NODE_OPTIONS="--max-old-space-size=8192"

 WORKDIR /app

 COPY package.json pnpm-workspace.yaml ./
 COPY .npmrc ./
 COPY packages ./packages
+COPY patches ./patches
 # bring in desktop workspace manifest so pnpm can resolve it
 COPY apps/desktop/src/main/package.json ./apps/desktop/src/main/package.json

@@ -165,12 +165,16 @@ const config = {
          CFBundleURLSchemes: [protocolScheme],
        },
      ],
+      NSAppleEventsUsageDescription:
+        'Application needs to control System Settings to help you grant Full Disk Access automatically.',
      NSCameraUsageDescription: "Application requests access to the device's camera.",
      NSDocumentsFolderUsageDescription:
        "Application requests access to the user's Documents folder.",
      NSDownloadsFolderUsageDescription:
        "Application requests access to the user's Downloads folder.",
      NSMicrophoneUsageDescription: "Application requests access to the device's microphone.",
+      NSScreenCaptureUsageDescription:
+        'Application requests access to record and analyze screen content for AI assistance.',
    },
    gatekeeperAssess: false,
    hardenedRuntime: hasAppleCertificate,
@@ -18,6 +18,7 @@
    "build:mac:local": "npm run build && UPDATE_CHANNEL=nightly electron-builder --mac --config electron-builder.js --publish never",
    "build:win": "npm run build && electron-builder --win --config electron-builder.js  --publish never",
    "dev": "electron-vite dev",
+    "dev:static": "cross-env DESKTOP_RENDERER_STATIC=1 npm run electron:dev",
    "electron:dev": "electron-vite dev",
    "electron:run-unpack": "electron .",
    "format": "prettier --write ",
@@ -57,11 +58,11 @@
    "@lobechat/file-loaders": "workspace:*",
    "@lobehub/i18n-cli": "^1.25.1",
    "@modelcontextprotocol/sdk": "^1.24.3",
+    "@t3-oss/env-core": "^0.13.8",
    "@types/async-retry": "^1.4.9",
    "@types/resolve": "^1.20.6",
    "@types/semver": "^7.7.1",
    "@types/set-cookie-parser": "^2.4.10",
-    "@t3-oss/env-core": "^0.13.8",
    "@typescript/native-preview": "7.0.0-dev.20251210.1",
    "async-retry": "^1.3.3",
    "consola": "^3.4.2",
@@ -104,4 +105,4 @@
      "electron-builder"
    ]
  }
-}
+}
@@ -31,5 +31,5 @@ export const STORE_DEFAULTS: ElectronMainStore = {
  networkProxy: defaultProxySettings,
  shortcuts: DEFAULT_SHORTCUTS_CONFIG,
  storagePath: appStorageDir,
-  themeMode: 'auto',
+  themeMode: 'system',
 };
@@ -96,6 +96,8 @@ export default class RemoteServerConfigCtr extends ControllerModule {
    const merged = this.normalizeConfig({ ...prev, ...config });
    storeManager.set('dataSyncConfig', merged);

+    this.broadcastRemoteServerConfigUpdated();
+
    return true;
  }

@@ -113,9 +115,16 @@ export default class RemoteServerConfigCtr extends ControllerModule {
    // Clear tokens (if any)
    await this.clearTokens();

+    this.broadcastRemoteServerConfigUpdated();
+
    return true;
  }

+  private broadcastRemoteServerConfigUpdated() {
+    logger.debug('Broadcasting remoteServerConfigUpdated event to all windows');
+    this.app.browserManager.broadcastToAllWindows('remoteServerConfigUpdated', undefined);
+  }
+
  /**
   * Encrypted tokens
   * Stored in memory for quick access, loaded from persistent storage on init.
@@ -1,11 +1,14 @@
 import { ElectronAppState, ThemeMode } from '@lobechat/electron-client-ipc';
-import { app, nativeTheme, shell, systemPreferences } from 'electron';
+import { app, dialog, nativeTheme, shell, systemPreferences } from 'electron';
 import { macOS } from 'electron-is';
+import { spawn } from 'node:child_process';
+import path from 'node:path';
 import process from 'node:process';

 import { createLogger } from '@/utils/logger';

 import { ControllerModule, IpcMethod } from './index';
+import fullDiskAccessAutoAddScript from './scripts/full-disk-access.applescript?raw';

 const logger = createLogger('controllers:SystemCtr');

@@ -35,8 +38,9 @@ export default class SystemController extends ControllerModule {
      isLinux: platform === 'linux',
      isMac: platform === 'darwin',
      isWindows: platform === 'win32',
+      locale: this.app.storeManager.get('locale', 'auto'),
+
      platform: platform as 'darwin' | 'win32' | 'linux',
-      systemAppearance: nativeTheme.shouldUseDarkColors ? 'dark' : 'light',
      userPath: {
        // User Paths (ensure keys match UserPathData / DesktopAppState interface)
        desktop: app.getPath('desktop'),
@@ -76,17 +80,114 @@ export default class SystemController extends ControllerModule {
  }

  @IpcMethod()
-  async requestScreenAccess(): Promise<void> {
-    if (!macOS()) return;
-    shell.openExternal(
+  async requestScreenAccess(): Promise<boolean> {
+    if (!macOS()) return true;
+
+    // IMPORTANT:
+    // On macOS, the app may NOT appear in "Screen Recording" list until it actually
+    // requests the permission once (TCC needs to register this app).
+    // So we try to proactively request it first, then open System Settings for manual toggle.
+    // 1) Best-effort: try Electron runtime API if available (not typed in Electron 38).
+    try {
+      const status = systemPreferences.getMediaAccessStatus('screen');
+      if (status !== 'granted') {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+        await (systemPreferences as any).askForMediaAccess?.('screen');
+      }
+    } catch (error) {
+      logger.warn('Failed to request screen recording access via systemPreferences', error);
+    }
+
+    // 2) Reliable trigger: run a one-shot getDisplayMedia in renderer to register TCC entry.
+    // This will show the OS capture picker; once the user selects/cancels, we stop tracks immediately.
+    try {
+      const status = systemPreferences.getMediaAccessStatus('screen');
+      if (status !== 'granted') {
+        const mainWindow = this.app.browserManager.getMainWindow()?.browserWindow;
+        if (mainWindow && !mainWindow.isDestroyed()) {
+          const script = `
+(() => {
+  const stop = (stream) => {
+    try { stream.getTracks().forEach((t) => t.stop()); } catch {}
+  };
+  return navigator.mediaDevices.getDisplayMedia({ video: true, audio: false })
+    .then((stream) => { stop(stream); return true; })
+    .catch(() => false);
+})()
+          `.trim();
+
+          await mainWindow.webContents.executeJavaScript(script, true);
+        }
+      }
+    } catch (error) {
+      logger.warn('Failed to request screen recording access via getDisplayMedia', error);
+    }
+
+    await shell.openExternal(
      'x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture',
    );
+
+    return systemPreferences.getMediaAccessStatus('screen') === 'granted';
  }

  @IpcMethod()
-  openFullDiskAccessSettings() {
+  openFullDiskAccessSettings(payload?: { autoAdd?: boolean }) {
    if (!macOS()) return;
-    shell.openExternal('x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles');
+    const { autoAdd = false } = payload || {};
+
+    // NOTE:
+    // - Full Disk Access cannot be requested programmatically like microphone/screen.
+    // - On macOS 13+ (Ventura), System Preferences is replaced by System Settings,
+    //   and deep links may differ. We try multiple known schemes for compatibility.
+    const candidates = [
+      // macOS 13+ (System Settings)
+      'com.apple.settings:Privacy&path=FullDiskAccess',
+      // Older macOS (System Preferences)
+      'x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles',
+    ];
+    if (autoAdd) this.tryAutoAddFullDiskAccess();
+
+    (async () => {
+      for (const url of candidates) {
+        try {
+          await shell.openExternal(url);
+          return;
+        } catch (error) {
+          logger.warn(`Failed to open Full Disk Access settings via ${url}`, error);
+        }
+      }
+    })();
+  }
+
+  /**
+   * Best-effort UI automation to add this app into Full Disk Access list.
+   *
+   * Limitations:
+   * - This uses AppleScript UI scripting (System Events) and may require the user to grant
+   *   additional "Automation" permission (to control System Settings).
+   * - UI structure differs across macOS versions/languages; we fall back silently.
+   */
+  private tryAutoAddFullDiskAccess() {
+    if (!macOS()) return;
+
+    const exePath = app.getPath('exe');
+    // /Applications/App.app/Contents/MacOS/App -> /Applications/App.app
+    const appBundlePath = path.resolve(path.dirname(exePath), '..', '..');
+
+    // Keep the script minimal and resilient; failure should not break onboarding flow.
+    const script = fullDiskAccessAutoAddScript.trim();
+
+    try {
+      const child = spawn('osascript', ['-e', script, appBundlePath], { env: process.env });
+      child.on('error', (error) => {
+        logger.warn('Full Disk Access auto-add (osascript) failed to start', error);
+      });
+      child.on('exit', (code) => {
+        logger.debug('Full Disk Access auto-add (osascript) exited', { code });
+      });
+    } catch (error) {
+      logger.warn('Full Disk Access auto-add failed', error);
+    }
  }

  @IpcMethod()
@@ -94,6 +195,37 @@ export default class SystemController extends ControllerModule {
    return shell.openExternal(url);
  }

+  /**
+   * Open native folder picker dialog
+   */
+  @IpcMethod()
+  async selectFolder(payload?: {
+    defaultPath?: string;
+    title?: string;
+  }): Promise<string | undefined> {
+    const mainWindow = this.app.browserManager.getMainWindow()?.browserWindow;
+
+    const result = await dialog.showOpenDialog(mainWindow!, {
+      defaultPath: payload?.defaultPath,
+      properties: ['openDirectory', 'createDirectory'],
+      title: payload?.title || 'Select Folder',
+    });
+
+    if (result.canceled || result.filePaths.length === 0) {
+      return undefined;
+    }
+
+    return result.filePaths[0];
+  }
+
+  /**
+   * Get the OS system locale
+   */
+  @IpcMethod()
+  getSystemLocale(): string {
+    return app.getLocale();
+  }
+
  /**
   * 更新应用语言设置
   */
@@ -126,9 +258,8 @@ export default class SystemController extends ControllerModule {
    return nativeTheme.themeSource;
  }

-  @IpcMethod()
-  async setSystemThemeMode(themeMode: ThemeMode) {
-    nativeTheme.themeSource = themeMode === 'auto' ? 'system' : themeMode;
+  private async setSystemThemeMode(themeMode: ThemeMode) {
+    nativeTheme.themeSource = themeMode;
  }

  /**
@@ -142,11 +273,6 @@ export default class SystemController extends ControllerModule {

    logger.info('Initializing system theme listener');

-    // Get initial system theme
-    const initialDarkMode = nativeTheme.shouldUseDarkColors;
-    const initialSystemTheme: ThemeMode = initialDarkMode ? 'dark' : 'light';
-    logger.info(`Initial system theme: ${initialSystemTheme}`);
-
    // Listen for system theme changes
    nativeTheme.on('updated', () => {
      const isDarkMode = nativeTheme.shouldUseDarkColors;
@@ -43,7 +43,12 @@ const mockStoreManager = {
  set: vi.fn(),
 };

+const mockBrowserManager = {
+  broadcastToAllWindows: vi.fn(),
+};
+
 const mockApp = {
+  browserManager: mockBrowserManager,
  storeManager: mockStoreManager,
 } as unknown as App;

@@ -44,6 +44,22 @@ vi.mock('@/utils/logger', () => ({
  }),
 }));

+const { spawnMock } = vi.hoisted(() => ({
+  spawnMock: vi.fn(() => {
+    const handlers = new Map<string, (...args: any[]) => void>();
+    return {
+      on: vi.fn((event: string, cb: (...args: any[]) => void) => {
+        handlers.set(event, cb);
+        return undefined;
+      }),
+    } as any;
+  }),
+}));
+
+vi.mock('node:child_process', () => ({
+  spawn: (...args: any[]) => spawnMock.call(null, ...args),
+}));
+
 // Mock electron
 vi.mock('electron', () => ({
  app: {
@@ -56,11 +72,14 @@ vi.mock('electron', () => ({
  nativeTheme: {
    on: vi.fn(),
    shouldUseDarkColors: false,
+    themeSource: 'system',
  },
  shell: {
    openExternal: vi.fn().mockResolvedValue(undefined),
  },
  systemPreferences: {
+    askForMediaAccess: vi.fn(async () => true),
+    getMediaAccessStatus: vi.fn(() => 'not-determined'),
    isTrustedAccessibilityClient: vi.fn(() => true),
  },
 }));
@@ -73,6 +92,14 @@ vi.mock('electron-is', () => ({
 // Mock browserManager
 const mockBrowserManager = {
  broadcastToAllWindows: vi.fn(),
+  getMainWindow: vi.fn(() => ({
+    browserWindow: {
+      isDestroyed: vi.fn(() => false),
+      webContents: {
+        executeJavaScript: vi.fn(async () => true),
+      },
+    },
+  })),
  handleAppThemeChange: vi.fn(),
 };

@@ -112,7 +139,6 @@ describe('SystemController', () => {
      expect(result).toMatchObject({
        arch: expect.any(String),
        platform: expect.any(String),
-        systemAppearance: 'light',
        userPath: {
          desktop: '/mock/path/desktop',
          documents: '/mock/path/documents',
@@ -125,18 +151,6 @@ describe('SystemController', () => {
        },
      });
    });
-
-    it('should return dark appearance when nativeTheme is dark', async () => {
-      const { nativeTheme } = await import('electron');
-      Object.defineProperty(nativeTheme, 'shouldUseDarkColors', { value: true });
-
-      const result = await invokeIpc('system.getAppState');
-
-      expect(result.systemAppearance).toBe('dark');
-
-      // Reset
-      Object.defineProperty(nativeTheme, 'shouldUseDarkColors', { value: false });
-    });
  });

  describe('accessibility', () => {
@@ -163,6 +177,68 @@ describe('SystemController', () => {
    });
  });

+  describe('screen recording', () => {
+    it('should request screen recording access and open System Settings on macOS', async () => {
+      const { shell, systemPreferences } = await import('electron');
+
+      const result = await invokeIpc('system.requestScreenAccess');
+
+      expect(systemPreferences.getMediaAccessStatus).toHaveBeenCalledWith('screen');
+      expect(systemPreferences.askForMediaAccess).toHaveBeenCalledWith('screen');
+      expect(mockBrowserManager.getMainWindow).toHaveBeenCalled();
+      expect(shell.openExternal).toHaveBeenCalledWith(
+        'x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture',
+      );
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should return true on non-macOS and not open settings', async () => {
+      const { macOS } = await import('electron-is');
+      const { shell, systemPreferences } = await import('electron');
+      vi.mocked(macOS).mockReturnValue(false);
+
+      const result = await invokeIpc('system.requestScreenAccess');
+
+      expect(result).toBe(true);
+      expect(systemPreferences.askForMediaAccess).not.toHaveBeenCalled();
+      expect(shell.openExternal).not.toHaveBeenCalled();
+
+      // Reset
+      vi.mocked(macOS).mockReturnValue(true);
+    });
+  });
+
+  describe('full disk access', () => {
+    it('should try to open Full Disk Access settings with fallbacks', async () => {
+      const { shell } = await import('electron');
+      vi.mocked(shell.openExternal)
+        .mockRejectedValueOnce(new Error('fail first'))
+        .mockResolvedValueOnce(undefined);
+
+      await invokeIpc('system.openFullDiskAccessSettings');
+
+      expect(shell.openExternal).toHaveBeenCalledWith(
+        'com.apple.settings:Privacy&path=FullDiskAccess',
+      );
+      expect(shell.openExternal).toHaveBeenCalledWith(
+        'x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles',
+      );
+    });
+
+    it('should spawn osascript when autoAdd is enabled', async () => {
+      const { shell } = await import('electron');
+      vi.mocked(shell.openExternal).mockResolvedValueOnce(undefined);
+
+      await invokeIpc('system.openFullDiskAccessSettings', { autoAdd: true });
+
+      expect(spawnMock).toHaveBeenCalledWith(
+        'osascript',
+        expect.arrayContaining(['-e', expect.any(String), expect.any(String)]),
+        expect.objectContaining({ env: expect.any(Object) }),
+      );
+    });
+  });
+
  describe('openExternalLink', () => {
    it('should open external link', async () => {
      const { shell } = await import('electron');
@@ -0,0 +1,85 @@
+on run argv
+  set appBundlePath to item 1 of argv
+
+  set settingsBundleIds to {"com.apple.SystemSettings", "com.apple.systempreferences"}
+
+  -- Bring System Settings/Preferences to front (Ventura+ / older). If it doesn't exist, ignore.
+  repeat with bundleId in settingsBundleIds
+    try
+      tell application id bundleId to activate
+      exit repeat
+    end try
+  end repeat
+
+  tell application "System Events"
+    set settingsProcess to missing value
+    repeat 30 times
+      repeat with bundleId in settingsBundleIds
+        try
+          if exists (first process whose bundle identifier is bundleId) then
+            set settingsProcess to first process whose bundle identifier is bundleId
+            exit repeat
+          end if
+        end try
+      end repeat
+
+      if settingsProcess is not missing value then exit repeat
+      delay 0.2
+    end repeat
+
+    if settingsProcess is missing value then return "no-settings-process"
+
+    tell settingsProcess
+      set frontmost to true
+
+      repeat 30 times
+        if exists window 1 then exit repeat
+        delay 0.2
+      end repeat
+      if not (exists window 1) then return "no-window"
+
+      -- Best-effort: find an "add" button in the front window and click it.
+      set clickedAdd to false
+      repeat 30 times
+        try
+          repeat with b in (buttons of window 1)
+            set bDesc to ""
+            set bName to ""
+            set bTitle to ""
+            try set bDesc to description of b end try
+            try set bName to name of b end try
+            try set bTitle to title of b end try
+
+            if (bDesc is "Add") or (bTitle is "Add") or (bName is "+") or (bTitle is "+") then
+              click b
+              set clickedAdd to true
+              exit repeat
+            end if
+          end repeat
+        end try
+
+        if clickedAdd is true then exit repeat
+        delay 0.2
+      end repeat
+
+      if clickedAdd is false then return "no-add-button"
+
+      -- Wait for open panel / sheet
+      repeat 30 times
+        if exists sheet 1 of window 1 then exit repeat
+        delay 0.2
+      end repeat
+      if not (exists sheet 1 of window 1) then return "no-sheet"
+
+      -- Open "Go to the folder" and input the app bundle path, then confirm.
+      keystroke "G" using {command down, shift down}
+      delay 0.3
+      keystroke appBundlePath
+      key code 36
+      delay 0.6
+      -- Confirm "Open" in the panel (Enter usually triggers default)
+      key code 36
+      return "ok"
+    end tell
+  end tell
+end run
@@ -1,24 +1,15 @@
-import {
-  DEFAULT_VARIANTS,
-  LOBE_LOCALE_COOKIE,
-  LOBE_THEME_APPEARANCE,
-  Locales,
-  RouteVariants,
-} from '@lobechat/desktop-bridge';
 import { ElectronIPCEventHandler, ElectronIPCServer } from '@lobechat/electron-server-ipc';
-import { app, protocol, session } from 'electron';
+import { app, nativeTheme, protocol } from 'electron';
 import installExtension, { REACT_DEVELOPER_TOOLS } from 'electron-devtools-installer';
 import { macOS, windows } from 'electron-is';
-import { pathExistsSync } from 'fs-extra';
 import os from 'node:os';
-import { extname, join } from 'node:path';
+import { join } from 'node:path';

 import { name } from '@/../../package.json';
-import { buildDir, nextExportDir } from '@/const/dir';
+import { buildDir } from '@/const/dir';
 import { isDev } from '@/const/env';
 import { ELECTRON_BE_PROTOCOL_SCHEME } from '@/const/protocol';
 import { IControlModule } from '@/controllers';
-import { getDesktopEnv } from '@/env';
 import { IServiceModule } from '@/services';
 import { getServerMethodMetadata } from '@/utils/ipc';
 import { createLogger } from '@/utils/logger';
@@ -27,7 +18,7 @@ import { BrowserManager } from './browser/BrowserManager';
 import { I18nManager } from './infrastructure/I18nManager';
 import { IoCContainer } from './infrastructure/IoCContainer';
 import { ProtocolManager } from './infrastructure/ProtocolManager';
-import { RendererProtocolManager } from './infrastructure/RendererProtocolManager';
+import { RendererUrlManager } from './infrastructure/RendererUrlManager';
 import { StaticFileServerManager } from './infrastructure/StaticFileServerManager';
 import { StoreManager } from './infrastructure/StoreManager';
 import { UpdaterManager } from './infrastructure/UpdaterManager';
@@ -45,11 +36,7 @@ type Class<T> = new (...args: any[]) => T;

 const importAll = (r: any) => Object.values(r).map((v: any) => v.default);

-const devDefaultRendererUrl = 'http://localhost:3015';
-
 export class App {
-  rendererLoadedUrl: string;
-
  browserManager: BrowserManager;
  menuManager: MenuManager;
  i18n: I18nManager;
@@ -59,12 +46,8 @@ export class App {
  trayManager: TrayManager;
  staticFileServerManager: StaticFileServerManager;
  protocolManager: ProtocolManager;
-  rendererProtocolManager: RendererProtocolManager;
+  rendererUrlManager: RendererUrlManager;
  chromeFlags: string[] = ['OverlayScrollbar', 'FluentOverlayScrollbar', 'FluentScrollbar'];
-  /**
-   * Escape hatch: allow testing static renderer in dev via env
-   */
-  private readonly rendererStaticOverride = getDesktopEnv().DESKTOP_RENDERER_STATIC;

  /**
   * whether app is in quiting
@@ -96,10 +79,7 @@ export class App {
    // Initialize store manager
    this.storeManager = new StoreManager(this);

-    this.rendererProtocolManager = new RendererProtocolManager({
-      nextExportDir,
-      resolveRendererFilePath: this.resolveRendererFilePath.bind(this),
-    });
+    this.rendererUrlManager = new RendererUrlManager();
    protocol.registerSchemesAsPrivileged([
      {
        privileges: {
@@ -111,12 +91,9 @@ export class App {
        },
        scheme: ELECTRON_BE_PROTOCOL_SCHEME,
      },
-      this.rendererProtocolManager.protocolScheme,
+      this.rendererUrlManager.protocolScheme,
    ]);

-    // Initialize rendererLoadedUrl from RendererProtocolManager
-    this.rendererLoadedUrl = this.rendererProtocolManager.getRendererUrl();
-
    // load controllers
    const controllers: IControlModule[] = importAll(
      import.meta.glob('@/controllers/*Ctr.ts', { eager: true }),
@@ -146,7 +123,7 @@ export class App {

    // Configure renderer loading strategy (dev server vs static export)
    // should register before app ready
-    this.configureRendererLoader();
+    this.rendererUrlManager.configureRendererLoader();

    // initialize protocol handlers
    this.protocolManager.initialize();
@@ -154,9 +131,34 @@ export class App {
    // 统一处理 before-quit 事件
    app.on('before-quit', this.handleBeforeQuit);

+    // Initialize theme mode from store
+    this.initializeThemeMode();
+
    logger.info('App initialization completed');
  }

+  /**
+   * Initialize nativeTheme.themeSource from stored themeMode preference
+   * This allows nativeTheme.shouldUseDarkColors to be used consistently everywhere
+   */
+  private initializeThemeMode() {
+    let themeMode = this.storeManager.get('themeMode');
+
+    // Migrate legacy 'auto' value to 'system' (nativeTheme.themeSource doesn't accept 'auto')
+    if (Object.is(themeMode, 'auto')) {
+      themeMode = 'system';
+      this.storeManager.set('themeMode', themeMode);
+      logger.info(`Migrated legacy theme mode 'auto' to 'system'`);
+    }
+
+    if (themeMode) {
+      nativeTheme.themeSource = themeMode;
+      logger.debug(
+        `Theme mode initialized to: ${themeMode} (themeSource: ${nativeTheme.themeSource})`,
+      );
+    }
+  }
+
  bootstrap = async () => {
    logger.info('Bootstrapping application');
    // make single instance
@@ -367,166 +369,11 @@ export class App {
    }
  };

-  private resolveExportFilePath(pathname: string) {
-    // Normalize by removing leading/trailing slashes so extname works as expected
-    const normalizedPath = decodeURIComponent(pathname).replace(/^\/+/, '').replace(/\/$/, '');
-
-    if (!normalizedPath) return join(nextExportDir, 'index.html');
-
-    const basePath = join(nextExportDir, normalizedPath);
-    const ext = extname(normalizedPath);
-
-    // If the request explicitly includes an extension (e.g. html, ico, txt),
-    // treat it as a direct asset without variant injection.
-    if (ext) {
-      return pathExistsSync(basePath) ? basePath : null;
-    }
-
-    const candidates = [`${basePath}.html`, join(basePath, 'index.html'), basePath];
-
-    for (const candidate of candidates) {
-      if (pathExistsSync(candidate)) return candidate;
-    }
-
-    const fallback404 = join(nextExportDir, '404.html');
-    if (pathExistsSync(fallback404)) return fallback404;
-
-    return null;
-  }
-
  /**
-   * Configure renderer loading strategy for dev/prod
-   */
-  private configureRendererLoader() {
-    if (isDev && !this.rendererStaticOverride) {
-      this.rendererLoadedUrl = devDefaultRendererUrl;
-      this.setupDevRenderer();
-      return;
-    }
-
-    if (isDev && this.rendererStaticOverride) {
-      logger.warn('Dev mode: DESKTOP_RENDERER_STATIC enabled, using static renderer handler');
-    }
-
-    this.setupProdRenderer();
-  }
-
-  /**
-   * Development: use Next dev server directly
-   */
-  private setupDevRenderer() {
-    logger.info('Development mode: renderer served from Next dev server, no protocol hook');
-  }
-
-  /**
-   * Production: serve static Next export assets
-   */
-  private setupProdRenderer() {
-    // Use the URL from RendererProtocolManager
-    this.rendererLoadedUrl = this.rendererProtocolManager.getRendererUrl();
-    this.rendererProtocolManager.registerHandler();
-  }
-
-  /**
-   * Resolve renderer file path in production by combining variant prefix and pathname.
-   * Falls back to default variant when cookies are missing or invalid.
-   */
-  private async resolveRendererFilePath(url: URL) {
-    const pathname = url.pathname;
-    const normalizedPathname = pathname.endsWith('/') ? pathname.slice(0, -1) : pathname;
-
-    // Static assets should be resolved from root (no variant prefix)
-    if (
-      pathname.startsWith('/_next/') ||
-      pathname.startsWith('/static/') ||
-      pathname === '/favicon.ico' ||
-      pathname === '/manifest.json'
-    ) {
-      return this.resolveExportFilePath(pathname);
-    }
-
-    // If the incoming path already contains an extension (like .html or .ico),
-    // treat it as a direct asset lookup to avoid double variant prefixes.
-    const extension = extname(normalizedPathname);
-    if (extension) {
-      const directPath = this.resolveExportFilePath(pathname);
-      if (directPath) return directPath;
-
-      // Next.js RSC payloads are emitted under variant folders (e.g. /en-US__0__light/__next._tree.txt),
-      // but the runtime may request them without the variant prefix. For missing .txt requests,
-      // retry resolution with variant injection.
-      if (extension === '.txt' && normalizedPathname.includes('__next.')) {
-        const variant = await this.getRouteVariantFromCookies();
-
-        return (
-          this.resolveExportFilePath(`/${variant}${pathname}`) ||
-          this.resolveExportFilePath(`/${this.defaultRouteVariant}${pathname}`) ||
-          null
-        );
-      }
-
-      return null;
-    }
-
-    const variant = await this.getRouteVariantFromCookies();
-    const variantPrefixedPath = `/${variant}${pathname}`;
-
-    // Try variant-specific path first, then default variant as fallback
-    return (
-      this.resolveExportFilePath(variantPrefixedPath) ||
-      this.resolveExportFilePath(`/${this.defaultRouteVariant}${pathname}`) ||
-      null
-    );
-  }
-
-  private readonly defaultRouteVariant = RouteVariants.serializeVariants(DEFAULT_VARIANTS);
-  private readonly localeCookieName = LOBE_LOCALE_COOKIE;
-  private readonly themeCookieName = LOBE_THEME_APPEARANCE;
-
-  /**
-   * Build variant string from Electron session cookies to match Next export structure.
-   * Desktop is always treated as non-mobile (0).
-   */
-  private async getRouteVariantFromCookies(): Promise<string> {
-    try {
-      const cookies = await session.defaultSession.cookies.get({
-        url: `${this.rendererLoadedUrl}/`,
-      });
-      const locale = cookies.find((c) => c.name === this.localeCookieName)?.value;
-      const themeCookie = cookies.find((c) => c.name === this.themeCookieName)?.value;
-
-      const serialized = RouteVariants.serializeVariants(
-        RouteVariants.createVariants({
-          isMobile: false,
-          locale: locale as Locales | undefined,
-          theme: themeCookie === 'dark' || themeCookie === 'light' ? themeCookie : undefined,
-        }),
-      );
-
-      return RouteVariants.serializeVariants(RouteVariants.deserializeVariants(serialized));
-    } catch (error) {
-      logger.warn('Failed to read route variant cookies, using default', error);
-      return this.defaultRouteVariant;
-    }
-  }
-
-  /**
-   * Build renderer URL with variant prefix injected into the path.
-   * In dev mode (without static override), Next.js dev server handles routing automatically.
-   * In prod or dev with static override, we need to inject variant to match export structure: /[variants]/path
+   * Build renderer URL for dev/prod.
   */
  async buildRendererUrl(path: string): Promise<string> {
-    // Ensure path starts with /
-    const cleanPath = path.startsWith('/') ? path : `/${path}`;
-
-    // In dev mode without static override, use dev server directly (no variant needed)
-    if (isDev && !this.rendererStaticOverride) {
-      return `${this.rendererLoadedUrl}${cleanPath}`;
-    }
-
-    // In prod or dev with static override, inject variant for static export structure
-    const variant = await this.getRouteVariantFromCookies();
-    return `${this.rendererLoadedUrl}/${variant}.html${cleanPath}`;
+    return this.rendererUrlManager.buildRendererUrl(path);
  }

  private initializeServerIpcEvents() {
@@ -561,4 +408,4 @@ export class App {
    // 执行清理操作
    this.staticFileServerManager.destroy();
  };
-}
+}
@@ -12,6 +12,7 @@ vi.mock('electron', () => ({
    getLocale: vi.fn(() => 'en-US'),
    getPath: vi.fn(() => '/mock/user/path'),
    requestSingleInstanceLock: vi.fn(() => true),
+    isReady: vi.fn(() => true),
    whenReady: vi.fn(() => Promise.resolve()),
    on: vi.fn(),
    commandLine: {
@@ -28,10 +29,11 @@ vi.mock('electron', () => ({
  },
  nativeTheme: {
    on: vi.fn(),
-    shouldUseDarkColors: false,
+    themeSource: 'system',
  },
  protocol: {
    registerSchemesAsPrivileged: vi.fn(),
+    handle: vi.fn(),
  },
  session: {
    defaultSession: {
@@ -83,6 +85,10 @@ vi.mock('@/const/env', () => ({
  isDev: false,
 }));

+vi.mock('@/env', () => ({
+  getDesktopEnv: vi.fn(() => ({ DESKTOP_RENDERER_STATIC: false })),
+}));
+
 vi.mock('@/const/dir', () => ({
  buildDir: '/mock/build',
  nextExportDir: '/mock/export/out',
@@ -190,46 +196,4 @@ describe('App', () => {
      expect(storagePath).toBe('/mock/storage/path');
    });
  });
-
-  describe('resolveRendererFilePath', () => {
-    it('should retry missing .txt requests with variant-prefixed lookup', async () => {
-      appInstance = new App();
-
-      // Avoid touching the electron session cookie code path in this unit test
-      (appInstance as any).getRouteVariantFromCookies = vi.fn(async () => 'en-US__0__light');
-
-      mockPathExistsSync.mockImplementation((p: string) => {
-        // root miss
-        if (p === '/mock/export/out/__next._tree.txt') return false;
-        // variant hit
-        if (p === '/mock/export/out/en-US__0__light/__next._tree.txt') return true;
-        return false;
-      });
-
-      const resolved = await (appInstance as any).resolveRendererFilePath(
-        new URL('app://next/__next._tree.txt'),
-      );
-
-      expect(resolved).toBe('/mock/export/out/en-US__0__light/__next._tree.txt');
-    });
-
-    it('should keep direct lookup for existing root .txt assets (no variant retry)', async () => {
-      appInstance = new App();
-
-      (appInstance as any).getRouteVariantFromCookies = vi.fn(async () => {
-        throw new Error('should not be called');
-      });
-
-      mockPathExistsSync.mockImplementation((p: string) => {
-        if (p === '/mock/export/out/en-US__0__light.txt') return true;
-        return false;
-      });
-
-      const resolved = await (appInstance as any).resolveRendererFilePath(
-        new URL('app://next/en-US__0__light.txt'),
-      );
-
-      expect(resolved).toBe('/mock/export/out/en-US__0__light.txt');
-    });
-  });
 });
@@ -42,6 +42,13 @@ export interface BrowserWindowOpts extends BrowserWindowConstructorOptions {
  width?: number;
 }

+interface WindowState {
+  height?: number;
+  width?: number;
+  x?: number;
+  y?: number;
+}
+
 export default class Browser {
  private app: App;
  private _browserWindow?: BrowserWindow;
@@ -78,11 +85,9 @@ export default class Browser {
  /**
   * Get platform-specific theme configuration for window creation
   */
-  private getPlatformThemeConfig(isDarkMode?: boolean): Record<string, any> {
-    const darkMode = isDarkMode ?? nativeTheme.shouldUseDarkColors;
-
+  private getPlatformThemeConfig(): Record<string, any> {
    if (isWindows) {
-      return this.getWindowsThemeConfig(darkMode);
+      return this.getWindowsThemeConfig(this.isDarkMode);
    }

    return {};
@@ -154,6 +159,46 @@ export default class Browser {
    this._browserWindow.setTitleBarOverlay(config.titleBarOverlay);
  }

+  private clampNumber(value: number, min: number, max: number) {
+    return Math.min(Math.max(value, min), max);
+  }
+
+  private resolveWindowState(
+    savedState: WindowState | undefined,
+    fallbackState: { height?: number; width?: number },
+  ): WindowState {
+    const width = savedState?.width ?? fallbackState.width;
+    const height = savedState?.height ?? fallbackState.height;
+    const resolvedState: WindowState = { height, width };
+
+    const hasPosition = Number.isFinite(savedState?.x) && Number.isFinite(savedState?.y);
+    if (!hasPosition) return resolvedState;
+
+    const x = savedState?.x as number;
+    const y = savedState?.y as number;
+
+    const targetDisplay = screen.getDisplayMatching({
+      height: height ?? 0,
+      width: width ?? 0,
+      x,
+      y,
+    });
+
+    const workArea = targetDisplay?.workArea ?? screen.getPrimaryDisplay().workArea;
+    const resolvedWidth = typeof width === 'number' ? Math.min(width, workArea.width) : width;
+    const resolvedHeight = typeof height === 'number' ? Math.min(height, workArea.height) : height;
+
+    const maxX = workArea.x + Math.max(0, workArea.width - (resolvedWidth ?? 0));
+    const maxY = workArea.y + Math.max(0, workArea.height - (resolvedHeight ?? 0));
+
+    return {
+      height: resolvedHeight,
+      width: resolvedWidth,
+      x: this.clampNumber(x, workArea.x, maxX),
+      y: this.clampNumber(y, workArea.y, maxY),
+    };
+  }
+
  private cleanupThemeListener(): void {
    if (this.themeListenerSetup) {
      // Note: nativeTheme listeners are global, consider using a centralized theme manager
@@ -164,24 +209,29 @@ export default class Browser {
  }

  private get isDarkMode() {
-    const themeMode = this.app.storeManager.get('themeMode');
-    if (themeMode === 'auto') return nativeTheme.shouldUseDarkColors;
-
-    return themeMode === 'dark';
+    return nativeTheme.shouldUseDarkColors;
  }

  loadUrl = async (path: string) => {
    const initUrl = await this.app.buildRendererUrl(path);

-    console.log('[Browser] initUrl', initUrl);
+    // Inject locale from store to help renderer boot with the correct language.
+    // Skip when set to auto to let the renderer detect locale normally.
+    const storedLocale = this.app.storeManager.get('locale', 'auto');
+    const urlWithLocale =
+      storedLocale && storedLocale !== 'auto'
+        ? `${initUrl}${initUrl.includes('?') ? '&' : '?'}lng=${storedLocale}`
+        : initUrl;
+
+    console.log('[Browser] initUrl', urlWithLocale);

    try {
-      logger.debug(`[${this.identifier}] Attempting to load URL: ${initUrl}`);
-      await this._browserWindow.loadURL(initUrl);
+      logger.debug(`[${this.identifier}] Attempting to load URL: ${urlWithLocale}`);
+      await this._browserWindow.loadURL(urlWithLocale);

-      logger.debug(`[${this.identifier}] Successfully loaded URL: ${initUrl}`);
+      logger.debug(`[${this.identifier}] Successfully loaded URL: ${urlWithLocale}`);
    } catch (error) {
-      logger.error(`[${this.identifier}] Failed to load URL (${initUrl}):`, error);
+      logger.error(`[${this.identifier}] Failed to load URL (${urlWithLocale}):`, error);

      // Try to load local error page
      try {
@@ -195,13 +245,13 @@ export default class Browser {

        // Set retry logic
        ipcMain.handle('retry-connection', async () => {
-          logger.info(`[${this.identifier}] Retry connection requested for: ${initUrl}`);
+          logger.info(`[${this.identifier}] Retry connection requested for: ${urlWithLocale}`);
          try {
-            await this._browserWindow?.loadURL(initUrl);
-            logger.info(`[${this.identifier}] Reconnection successful to ${initUrl}`);
+            await this._browserWindow?.loadURL(urlWithLocale);
+            logger.info(`[${this.identifier}] Reconnection successful to ${urlWithLocale}`);
            return { success: true };
          } catch (err) {
-            logger.error(`[${this.identifier}] Retry connection failed for ${initUrl}:`, err);
+            logger.error(`[${this.identifier}] Retry connection failed for ${urlWithLocale}:`, err);
            // Reload error page
            try {
              logger.info(`[${this.identifier}] Reloading error page after failed retry...`);
@@ -320,23 +370,26 @@ export default class Browser {

    // Load window state
    const savedState = this.app.storeManager.get(this.windowStateKey as any) as
-      | { height?: number; width?: number }
-      | undefined; // Keep type for now, but only use w/h
+      | WindowState
+      | undefined;
    logger.info(`Creating new BrowserWindow instance: ${this.identifier}`);
    logger.debug(`[${this.identifier}] Options for new window: ${JSON.stringify(this.options)}`);
    logger.debug(
-      `[${this.identifier}] Saved window state (only size used): ${JSON.stringify(savedState)}`,
+      `[${this.identifier}] Saved window state: ${JSON.stringify(savedState)}`,
    );

-    const isDarkMode = nativeTheme.shouldUseDarkColors;
+    const resolvedState = this.resolveWindowState(savedState, { height, width });
+    logger.debug(
+      `[${this.identifier}] Resolved window state: ${JSON.stringify(resolvedState)}`,
+    );

    const browserWindow = new BrowserWindow({
      ...res,
      autoHideMenuBar: true,
      backgroundColor: '#00000000',
-      darkTheme: isDarkMode,
+      darkTheme: this.isDarkMode,
      frame: false,
-      height: savedState?.height || height,
+      height: resolvedState.height,
      show: false,
      title,
      vibrancy: 'sidebar',
@@ -347,8 +400,10 @@ export default class Browser {
        preload: join(preloadDir, 'index.js'),
        sandbox: false,
      },
-      width: savedState?.width || width,
-      ...this.getPlatformThemeConfig(isDarkMode),
+      width: resolvedState.width,
+      x: resolvedState.x,
+      y: resolvedState.y,
+      ...this.getPlatformThemeConfig(),
    });

    this._browserWindow = browserWindow;
@@ -404,12 +459,17 @@ export default class Browser {
        logger.debug(`[${this.identifier}] App is quitting, allowing window to close naturally.`);
        // Save state before quitting
        try {
-          const { width, height } = browserWindow.getBounds(); // Get only width and height
-          const sizeState = { height, width };
+          const bounds = browserWindow.getBounds();
+          const sizeState = {
+            height: bounds.height,
+            width: bounds.width,
+            x: bounds.x,
+            y: bounds.y,
+          };
          logger.debug(
-            `[${this.identifier}] Saving window size on quit: ${JSON.stringify(sizeState)}`,
+            `[${this.identifier}] Saving window state on quit: ${JSON.stringify(sizeState)}`,
          );
-          this.app.storeManager.set(this.windowStateKey as any, sizeState); // Save only size
+          this.app.storeManager.set(this.windowStateKey as any, sizeState);
        } catch (error) {
          logger.error(`[${this.identifier}] Failed to save window state on quit:`, error);
        }
@@ -436,15 +496,20 @@ export default class Browser {
      } else {
        // Window is actually closing (not keepAlive)
        logger.debug(
-          `[${this.identifier}] keepAlive is false, allowing window to close. Saving size...`, // Updated log message
+          `[${this.identifier}] keepAlive is false, allowing window to close. Saving state...`,
        );
        try {
-          const { width, height } = browserWindow.getBounds(); // Get only width and height
-          const sizeState = { height, width };
+          const bounds = browserWindow.getBounds();
+          const sizeState = {
+            height: bounds.height,
+            width: bounds.width,
+            x: bounds.x,
+            y: bounds.y,
+          };
          logger.debug(
-            `[${this.identifier}] Saving window size on close: ${JSON.stringify(sizeState)}`,
+            `[${this.identifier}] Saving window state on close: ${JSON.stringify(sizeState)}`,
          );
-          this.app.storeManager.set(this.windowStateKey as any, sizeState); // Save only size
+          this.app.storeManager.set(this.windowStateKey as any, sizeState);
        } catch (error) {
          logger.error(`[${this.identifier}] Failed to save window state on close:`, error);
        }
@@ -53,11 +53,18 @@ const { mockBrowserWindow, mockNativeTheme, mockIpcMain, mockScreen, MockBrowser
        off: vi.fn(),
        on: vi.fn(),
        shouldUseDarkColors: false,
+        themeSource: 'system',
      },
      mockScreen: {
+        getDisplayMatching: vi.fn().mockReturnValue({
+          workArea: { height: 1080, width: 1920, x: 0, y: 0 },
+        }),
        getDisplayNearestPoint: vi.fn().mockReturnValue({
          workArea: { height: 1080, width: 1920, x: 0, y: 0 },
        }),
+        getPrimaryDisplay: vi.fn().mockReturnValue({
+          workArea: { height: 1080, width: 1920, x: 0, y: 0 },
+        }),
      },
    };
  });
@@ -239,6 +246,47 @@ describe('Browser', () => {
      );
    });

+    it('should restore window position from store and clamp within display', () => {
+      mockStoreManagerGet.mockImplementation((key: string) => {
+        if (key === 'windowSize_test-window') {
+          return { height: 700, width: 900, x: 1800, y: 900 };
+        }
+        return undefined;
+      });
+
+      new Browser(defaultOptions, mockApp);
+
+      expect(MockBrowserWindow).toHaveBeenCalledWith(
+        expect.objectContaining({
+          height: 700,
+          width: 900,
+          x: 1020,
+          y: 380,
+        }),
+      );
+    });
+
+    it('should clamp saved size when it exceeds current display bounds', () => {
+      mockScreen.getDisplayMatching.mockReturnValueOnce({
+        workArea: { height: 800, width: 1200, x: 0, y: 0 },
+      });
+      mockStoreManagerGet.mockImplementation((key: string) => {
+        if (key === 'windowSize_test-window') {
+          return { height: 1200, width: 2000, x: 0, y: 0 };
+        }
+        return undefined;
+      });
+
+      new Browser(defaultOptions, mockApp);
+
+      expect(MockBrowserWindow).toHaveBeenCalledWith(
+        expect.objectContaining({
+          height: 800,
+          width: 1200,
+        }),
+      );
+    });
+
    it('should use default size when no saved state', () => {
      mockStoreManagerGet.mockReturnValue(undefined);

@@ -272,7 +320,7 @@ describe('Browser', () => {

  describe('theme management', () => {
    describe('getPlatformThemeConfig', () => {
-      it('should return Windows dark theme config', () => {
+      it('should return Windows dark theme config when shouldUseDarkColors is true', () => {
        mockNativeTheme.shouldUseDarkColors = true;

        // Create browser with dark mode
@@ -289,7 +337,7 @@ describe('Browser', () => {
        );
      });

-      it('should return Windows light theme config', () => {
+      it('should return Windows light theme config when shouldUseDarkColors is false', () => {
        mockNativeTheme.shouldUseDarkColors = false;

        expect(MockBrowserWindow).toHaveBeenCalledWith(
@@ -334,11 +382,8 @@ describe('Browser', () => {
    });

    describe('isDarkMode', () => {
-      it('should return true when themeMode is dark', () => {
-        mockStoreManagerGet.mockImplementation((key: string) => {
-          if (key === 'themeMode') return 'dark';
-          return undefined;
-        });
+      it('should return true when shouldUseDarkColors is true', () => {
+        mockNativeTheme.shouldUseDarkColors = true;

        const darkBrowser = new Browser(defaultOptions, mockApp);
        // Access private getter through handleAppThemeChange which uses isDarkMode
@@ -348,18 +393,14 @@ describe('Browser', () => {
        expect(mockBrowserWindow.setBackgroundColor).toHaveBeenCalledWith('#1a1a1a');
      });

-      it('should use system theme when themeMode is auto', () => {
-        mockStoreManagerGet.mockImplementation((key: string) => {
-          if (key === 'themeMode') return 'auto';
-          return undefined;
-        });
-        mockNativeTheme.shouldUseDarkColors = true;
+      it('should return false when shouldUseDarkColors is false', () => {
+        mockNativeTheme.shouldUseDarkColors = false;

-        const autoBrowser = new Browser(defaultOptions, mockApp);
-        autoBrowser.handleAppThemeChange();
+        const lightBrowser = new Browser(defaultOptions, mockApp);
+        lightBrowser.handleAppThemeChange();
        vi.advanceTimersByTime(0);

-        expect(mockBrowserWindow.setBackgroundColor).toHaveBeenCalledWith('#1a1a1a');
+        expect(mockBrowserWindow.setBackgroundColor).toHaveBeenCalledWith('#ffffff');
      });
    });
  });
@@ -547,6 +588,8 @@ describe('Browser', () => {
      expect(mockStoreManagerSet).toHaveBeenCalledWith('windowSize_test-window', {
        height: 600,
        width: 800,
+        x: 0,
+        y: 0,
      });
      expect(mockEvent.preventDefault).not.toHaveBeenCalled();
    });
@@ -578,6 +621,8 @@ describe('Browser', () => {
      expect(mockStoreManagerSet).toHaveBeenCalledWith('windowSize_test-window', {
        height: 600,
        width: 800,
+        x: 0,
+        y: 0,
      });
    });
  });
@@ -1,5 +1,6 @@
-import type { Session } from 'electron';
+import { BrowserWindow, type Session } from 'electron';

+import { isDev } from '@/const/env';
 import { createLogger } from '@/utils/logger';

 interface BackendProxyProtocolManagerOptions {
@@ -30,6 +31,15 @@ export class BackendProxyProtocolManager {
  private readonly handledSessions = new WeakSet<Session>();
  private readonly logger = createLogger('core:BackendProxyProtocolManager');

+  private notifyAuthorizationRequired() {
+    const allWindows = BrowserWindow.getAllWindows();
+    for (const win of allWindows) {
+      if (!win.isDestroyed()) {
+        win.webContents.send('authorizationRequired');
+      }
+    }
+  }
+
  registerWithRemoteBaseUrl(
    session: Session,
    options: BackendProxyProtocolManagerRemoteBaseOptions,
@@ -85,7 +95,9 @@ export class BackendProxyProtocolManager {

        const headers = new Headers(request.headers);
        const token = await options.getAccessToken();
-        if (token) headers.set('Oidc-Auth', token);
+        if (token) {
+          headers.set('Oidc-Auth', token);
+        }

        // eslint-disable-next-line no-undef
        const requestInit: RequestInit & { duplex?: 'half' } = {
@@ -126,10 +138,18 @@ export class BackendProxyProtocolManager {
          responseHeaders.set('Access-Control-Allow-Credentials', 'true');
        }

+        if (isDev) {
+          responseHeaders.set('x-dev-oidc-auth', token);
+        }
+
        responseHeaders.set('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
        responseHeaders.set('Access-Control-Allow-Headers', '*');
        responseHeaders.set('X-Src-Url', rewrittenUrl);

+        if (!token && upstreamResponse.status === 401) {
+          this.notifyAuthorizationRequired();
+        }
+
        return new Response(upstreamResponse.body, {
          headers: responseHeaders,
          status: upstreamResponse.status,
@@ -175,6 +175,7 @@ export class I18nManager {
    try {
      logger.debug(`Loading namespace: ${lng}/${ns}`);
      const resources = await loadResources(lng, ns);
+
      this.i18n.addResourceBundle(lng, ns, resources, true, true);
      return true;
    } catch (error) {
@@ -0,0 +1,126 @@
+import { pathExistsSync } from 'fs-extra';
+import { extname, join } from 'node:path';
+
+import { nextExportDir } from '@/const/dir';
+import { isDev } from '@/const/env';
+import { getDesktopEnv } from '@/env';
+import { createLogger } from '@/utils/logger';
+
+import { RendererProtocolManager } from './RendererProtocolManager';
+
+const logger = createLogger('core:RendererUrlManager');
+const devDefaultRendererUrl = 'http://localhost:3015';
+
+export class RendererUrlManager {
+  private readonly rendererProtocolManager: RendererProtocolManager;
+  private readonly rendererStaticOverride = getDesktopEnv().DESKTOP_RENDERER_STATIC;
+  private rendererLoadedUrl: string;
+
+  constructor() {
+    this.rendererProtocolManager = new RendererProtocolManager({
+      nextExportDir,
+      resolveRendererFilePath: this.resolveRendererFilePath,
+    });
+
+    this.rendererLoadedUrl = this.rendererProtocolManager.getRendererUrl();
+  }
+
+  get protocolScheme() {
+    return this.rendererProtocolManager.protocolScheme;
+  }
+
+  /**
+   * Configure renderer loading strategy for dev/prod
+   */
+  configureRendererLoader() {
+    if (isDev && !this.rendererStaticOverride) {
+      this.rendererLoadedUrl = devDefaultRendererUrl;
+      this.setupDevRenderer();
+      return;
+    }
+
+    if (isDev && this.rendererStaticOverride) {
+      logger.warn('Dev mode: DESKTOP_RENDERER_STATIC enabled, using static renderer handler');
+    }
+
+    this.setupProdRenderer();
+  }
+
+  /**
+   * Build renderer URL for dev/prod.
+   */
+  buildRendererUrl(path: string): string {
+    const cleanPath = path.startsWith('/') ? path : `/${path}`;
+    return `${this.rendererLoadedUrl}${cleanPath}`;
+  }
+
+  /**
+   * Resolve renderer file path in production.
+   * Static assets map directly; app routes fall back to index.html.
+   */
+  resolveRendererFilePath = async (url: URL): Promise<string | null> => {
+    const pathname = url.pathname;
+    const normalizedPathname = pathname.endsWith('/') ? pathname.slice(0, -1) : pathname;
+
+    // Static assets should be resolved from root
+    if (
+      pathname.startsWith('/_next/') ||
+      pathname.startsWith('/static/') ||
+      pathname === '/favicon.ico' ||
+      pathname === '/manifest.json'
+    ) {
+      return this.resolveExportFilePath(pathname);
+    }
+
+    // If the incoming path already contains an extension (like .html or .ico),
+    // treat it as a direct asset lookup.
+    const extension = extname(normalizedPathname);
+    if (extension) {
+      return this.resolveExportFilePath(pathname);
+    }
+
+    return this.resolveExportFilePath('/');
+  };
+
+  private resolveExportFilePath(pathname: string) {
+    // Normalize by removing leading/trailing slashes so extname works as expected
+    const normalizedPath = decodeURIComponent(pathname).replace(/^\/+/, '').replace(/\/$/, '');
+
+    if (!normalizedPath) return join(nextExportDir, 'index.html');
+
+    const basePath = join(nextExportDir, normalizedPath);
+    const ext = extname(normalizedPath);
+
+    // If the request explicitly includes an extension (e.g. html, ico, txt),
+    // treat it as a direct asset.
+    if (ext) {
+      return pathExistsSync(basePath) ? basePath : null;
+    }
+
+    const candidates = [`${basePath}.html`, join(basePath, 'index.html'), basePath];
+
+    for (const candidate of candidates) {
+      if (pathExistsSync(candidate)) return candidate;
+    }
+
+    const fallback404 = join(nextExportDir, '404.html');
+    if (pathExistsSync(fallback404)) return fallback404;
+
+    return null;
+  }
+
+  /**
+   * Development: use Next dev server directly
+   */
+  private setupDevRenderer() {
+    logger.info('Development mode: renderer served from Next dev server, no protocol hook');
+  }
+
+  /**
+   * Production: serve static Next export assets
+   */
+  private setupProdRenderer() {
+    this.rendererLoadedUrl = this.rendererProtocolManager.getRendererUrl();
+    this.rendererProtocolManager.registerHandler();
+  }
+}
@@ -1,7 +1,7 @@
 import log from 'electron-log';
 import { autoUpdater } from 'electron-updater';

-import { isDev } from '@/const/env';
+import { isDev, isWindows } from '@/const/env';
 import { UPDATE_CHANNEL as channel, updaterConfig } from '@/modules/updater/configs';
 import { createLogger } from '@/utils/logger';

@@ -144,12 +144,16 @@ export class UpdaterManager {
    // Close all windows first to ensure clean exit
    logger.info('Closing all windows before update installation...');
    const { BrowserWindow, app } = require('electron');
-    const allWindows = BrowserWindow.getAllWindows();
-    allWindows.forEach((window) => {
-      if (!window.isDestroyed()) {
-        window.close();
-      }
-    });
+    // do not close windows and quit first
+    // on Windows, window-all-closed -> app.quit()` can terminate the process before the timer fires
+    if (!isWindows) {
+      const allWindows = BrowserWindow.getAllWindows();
+      allWindows.forEach((window) => {
+        if (!window.isDestroyed()) {
+          window.close();
+        }
+      });
+    }

    // Release single instance lock before quitting
    // This ensures the new instance can acquire the lock
@@ -21,6 +21,13 @@ const { mockProtocol, protocolHandlerRef } = vi.hoisted(() => {
  };
 });

+vi.mock('electron-is', () => ({
+  dev: vi.fn(() => false),
+  macOS: vi.fn(() => false),
+  windows: vi.fn(() => false),
+  linux: vi.fn(() => true),
+}));
+
 vi.mock('@/utils/logger', () => ({
  createLogger: () => ({
    debug: vi.fn(),
@@ -0,0 +1,72 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { RendererUrlManager } from '../RendererUrlManager';
+
+const mockPathExistsSync = vi.fn();
+
+vi.mock('electron', () => ({
+  app: {
+    isReady: vi.fn(() => true),
+    whenReady: vi.fn(() => Promise.resolve()),
+  },
+  protocol: {
+    handle: vi.fn(),
+  },
+}));
+
+vi.mock('fs-extra', () => ({
+  pathExistsSync: (...args: any[]) => mockPathExistsSync(...args),
+}));
+
+vi.mock('@/const/dir', () => ({
+  nextExportDir: '/mock/export/out',
+}));
+
+vi.mock('@/const/env', () => ({
+  isDev: false,
+}));
+
+vi.mock('@/env', () => ({
+  getDesktopEnv: vi.fn(() => ({ DESKTOP_RENDERER_STATIC: false })),
+}));
+
+vi.mock('@/utils/logger', () => ({
+  createLogger: () => ({
+    debug: vi.fn(),
+    info: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+  }),
+}));
+
+describe('RendererUrlManager', () => {
+  let manager: RendererUrlManager;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockPathExistsSync.mockReset();
+    manager = new RendererUrlManager();
+  });
+
+  describe('resolveRendererFilePath', () => {
+    it('should resolve asset requests directly', async () => {
+      mockPathExistsSync.mockImplementation(
+        (p: string) => p === '/mock/export/out/en-US__0__light.txt',
+      );
+
+      const resolved = await manager.resolveRendererFilePath(
+        new URL('app://next/en-US__0__light.txt'),
+      );
+
+      expect(resolved).toBe('/mock/export/out/en-US__0__light.txt');
+    });
+
+    it('should fall back to index.html for app routes', async () => {
+      mockPathExistsSync.mockImplementation((p: string) => p === '/mock/export/out/index.html');
+
+      const resolved = await manager.resolveRendererFilePath(new URL('app://next/settings'));
+
+      expect(resolved).toBe('/mock/export/out/index.html');
+    });
+  });
+});
@@ -57,7 +57,7 @@ export class TrayManager {
    logger.debug('初始化主托盘');
    return this.retrieveOrInitialize({
      iconPath: isMac
-        ? nativeTheme.shouldUseDarkColors
+        ? nativeTheme.shouldUseDarkColorsForSystemIntegratedUI
          ? 'tray-dark.png'
          : 'tray-light.png'
        : 'tray.png',
@@ -8,7 +8,7 @@ import { TrayManager } from '../TrayManager';
 // Mock electron modules
 vi.mock('electron', () => ({
  nativeTheme: {
-    shouldUseDarkColors: false,
+    shouldUseDarkColorsForSystemIntegratedUI: false,
  },
 }));

@@ -90,7 +90,7 @@ describe('TrayManager', () => {

  describe('initializeMainTray', () => {
    it('should create main tray with dark icon on macOS when dark mode is enabled', () => {
-      Object.defineProperty(nativeTheme, 'shouldUseDarkColors', {
+      Object.defineProperty(nativeTheme, 'shouldUseDarkColorsForSystemIntegratedUI', {
        value: true,
        writable: true,
        configurable: true,
@@ -110,7 +110,7 @@ describe('TrayManager', () => {
    });

    it('should create main tray with light icon on macOS when light mode is enabled', () => {
-      Object.defineProperty(nativeTheme, 'shouldUseDarkColors', {
+      Object.defineProperty(nativeTheme, 'shouldUseDarkColorsForSystemIntegratedUI', {
        value: false,
        writable: true,
        configurable: true,
@@ -76,7 +76,7 @@ export const getDesktopEnv = memoize(() =>
      MCP_TOOL_TIMEOUT: envNumber(60_000),

      // cloud server url (can be overridden for selfhost/dev)
-      OFFICIAL_CLOUD_SERVER: z.string().optional().default('https://lobechat.com'),
+      OFFICIAL_CLOUD_SERVER: z.string().optional().default('https://app.lobehub.com'),
    },
    clientPrefix: 'PUBLIC_',
    client: {},
@@ -22,7 +22,9 @@ export const loadResources = async (lng: string, ns: string) => {
  }

  try {
-    return await import(`@/../../resources/locales/${lng}/${ns}.json`);
+    const { default: content } = await import(`@/../../resources/locales/${lng}/${ns}.json`);
+
+    return content;
  } catch (error) {
    console.error(`无法加载翻译文件: ${lng} - ${ns}`, error);
    return {};
@@ -11,7 +11,7 @@ export interface ElectronMainStore {
  networkProxy: NetworkProxySettings;
  shortcuts: Record<string, string>;
  storagePath: string;
-  themeMode: 'dark' | 'light' | 'auto';
+  themeMode: 'dark' | 'light' | 'system';
 }

 export type StoreKey = keyof ElectronMainStore;
@@ -1,4 +1,280 @@
 [
+  {
+    "children": {},
+    "date": "2026-01-05",
+    "version": "2.0.0-next.217"
+  },
+  {
+    "children": {
+      "fixes": ["Restore window position safely."]
+    },
+    "date": "2026-01-05",
+    "version": "2.0.0-next.216"
+  },
+  {
+    "children": {
+      "fixes": [
+        "Update CI bun version to v1.2.4, when the document filetype is agent/plan, not show the saveinto docs button."
+      ]
+    },
+    "date": "2026-01-05",
+    "version": "2.0.0-next.215"
+  },
+  {
+    "children": {},
+    "date": "2026-01-05",
+    "version": "2.0.0-next.214"
+  },
+  {
+    "children": {
+      "improvements": ["Update i18n."]
+    },
+    "date": "2026-01-05",
+    "version": "2.0.0-next.213"
+  },
+  {
+    "children": {},
+    "date": "2026-01-05",
+    "version": "2.0.0-next.212"
+  },
+  {
+    "children": {
+      "fixes": ["Add lost like button in discover detail page."]
+    },
+    "date": "2026-01-05",
+    "version": "2.0.0-next.211"
+  },
+  {
+    "children": {},
+    "date": "2026-01-04",
+    "version": "2.0.0-next.210"
+  },
+  {
+    "children": {
+      "fixes": ["Use configured embedding provider instead of hardcoded OpenAI."]
+    },
+    "date": "2026-01-04",
+    "version": "2.0.0-next.209"
+  },
+  {
+    "children": {
+      "fixes": ["Auto jump to group."]
+    },
+    "date": "2026-01-04",
+    "version": "2.0.0-next.208"
+  },
+  {
+    "children": {
+      "fixes": ["Slove the old agents open profiles error problem."]
+    },
+    "date": "2026-01-04",
+    "version": "2.0.0-next.207"
+  },
+  {
+    "children": {
+      "fixes": ["Fix data inconsistency in ai provider config."]
+    },
+    "date": "2026-01-04",
+    "version": "2.0.0-next.206"
+  },
+  {
+    "children": {},
+    "date": "2026-01-04",
+    "version": "2.0.0-next.205"
+  },
+  {
+    "children": {
+      "features": ["Add new provider Xiaomi MiMo."]
+    },
+    "date": "2026-01-04",
+    "version": "2.0.0-next.204"
+  },
+  {
+    "children": {
+      "improvements": ["Update i18n."]
+    },
+    "date": "2026-01-04",
+    "version": "2.0.0-next.203"
+  },
+  {
+    "children": {
+      "improvements": ["Refactor and fix model runtime initialize."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.202"
+  },
+  {
+    "children": {
+      "fixes": ["Restore window resizable before hard reload in desktop onboarding."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.201"
+  },
+  {
+    "children": {
+      "features": ["Add work path for local system."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.200"
+  },
+  {
+    "children": {
+      "fixes": ["Filter empty assistant messages for Anthropic API."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.199"
+  },
+  {
+    "children": {
+      "fixes": ["Support thoughtSignature for openrouter."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.198"
+  },
+  {
+    "children": {
+      "improvements": ["Remove client db and refactor test."],
+      "fixes": ["Fix file upload issue."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.197"
+  },
+  {
+    "children": {
+      "improvements": ["Refactor to remove access code."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.196"
+  },
+  {
+    "children": {
+      "fixes": ["Fix tool call message content missing."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.195"
+  },
+  {
+    "children": {
+      "improvements": ["Update i18n."]
+    },
+    "date": "2026-01-03",
+    "version": "2.0.0-next.194"
+  },
+  {
+    "children": {},
+    "date": "2026-01-02",
+    "version": "2.0.0-next.193"
+  },
+  {
+    "children": {
+      "fixes": ["Fix model edit icon missing."]
+    },
+    "date": "2026-01-02",
+    "version": "2.0.0-next.192"
+  },
+  {
+    "children": {
+      "improvements": ["Refactor to remove meta in message."]
+    },
+    "date": "2026-01-02",
+    "version": "2.0.0-next.191"
+  },
+  {
+    "children": {
+      "improvements": ["Update i18n."]
+    },
+    "date": "2026-01-02",
+    "version": "2.0.0-next.190"
+  },
+  {
+    "children": {
+      "improvements": ["Migrate to new DropdownMenuV2 and showContextMenu API."]
+    },
+    "date": "2026-01-01",
+    "version": "2.0.0-next.189"
+  },
+  {
+    "children": {
+      "improvements": ["Improve tools UI and fix Google schema compatibility."]
+    },
+    "date": "2026-01-01",
+    "version": "2.0.0-next.188"
+  },
+  {
+    "children": {
+      "improvements": ["Add Gemini 3 Flash & Doubao Seed 1.8 models."]
+    },
+    "date": "2026-01-01",
+    "version": "2.0.0-next.187"
+  },
+  {
+    "children": {
+      "improvements": ["Refactor oidc env to auth env."]
+    },
+    "date": "2026-01-01",
+    "version": "2.0.0-next.186"
+  },
+  {
+    "children": {
+      "improvements": ["Update i18n."]
+    },
+    "date": "2026-01-01",
+    "version": "2.0.0-next.185"
+  },
+  {
+    "children": {
+      "improvements": ["Improve loading and local-system render."]
+    },
+    "date": "2026-01-01",
+    "version": "2.0.0-next.184"
+  },
+  {
+    "children": {},
+    "date": "2025-12-31",
+    "version": "2.0.0-next.183"
+  },
+  {
+    "children": {
+      "features": ["Brand new 2.0 ui for next."]
+    },
+    "date": "2025-12-31",
+    "version": "2.0.0-next.182"
+  },
+  {
+    "children": {
+      "improvements": [
+        "Improve ExecTask and task message UI, improve gtd tool inspector and todo list, improve page document tool inspector UI, improve RunCommand Inspector, rebranding chat ui, refactor UI in features, rerun i18n, setting style, support streaming and display ui for group mode, support tool streaming and title custom render, update i18n, Update i18n microcopy, update ui."
+      ],
+      "features": [
+        "Add a white waitlist in edge config env, add always show tools render in createPlan & createDoc tools, add batch tasks ui, add Bundle Analyzer workflow for detailed bundle size analysis, add business features support with new components and hooks, add business settings features with dynamic loading for Plans, Funds, Usage, Billing, and Referral tabs, add db and schema feature, add home page create group builder button, Add i18n UI locales and improve tool types, add like action in community detail, add memory implement, add subscription settings group with dynamic loading for Plans, Funds, Usage, Billing, and Referral tabs, add the market auth auto generate way, Add turbopack configuration support to CustomNextConfig, add user memory, agent builder, agent builder, agent builder and group builder, app ui page, brand new 2.0 ui for next, buildin some tools should save into docs, code-interpreter tool, code-interpreter tool, code-interpreter tool, desktop feature, enhance desktop onboarding with sign out and localization, enhance macOS desktop permissions and onboarding, enhance onboarding process by removing mode selection step and adding export functionality in advanced settings, file search feature, gtd create plan support streaming render, implement agent builder, implement builtin agents packages, implement memories package, implement Redis caching for presigned URLs in file proxy service, implement server data feature, include Subscription settings group in the Accordion component, Integrate bcryptjs for password verification in BetterAuth, integrate BrandingProviderCard and update Provider components for branding support, onboarding ui, page and knowledge base, rebranding total UI of app, refactor authentication handler to support dynamic loading of better-auth and next-auth, refactor desktop implement with brand new 2.0, rename codeinterpreter into lobe sandbox, server implement, support CMD K, support exec async sub agent task, support export and import topic JSON, support files upload in chat input, support notebook tool, support swr local cache, topic message swr cache, translate AI model descriptions to English, update agent builder ui, update create group chat use builder, update gtd tools( use editor & update metadata ), update user memory embedding model selection based on business features, user memory, user memory, user onboarding, when use usesend to create agent/group, the model should override by lobeAi, wrap ConversationArea and ModelSwitchPanel in TooltipGroup for enhanced UI."
+      ],
+      "fixes": [
+        "Agent profiles update, agent tools config set, editor placeholder, bump charts 3.0.4 to fix import es path, fix anthropic thinking budget, fix async task and improve tool style, fix default waitlist bug, fix delete agent group bug, Fix desktop test cases and refactor translations, Fix desktop test cases and refactor translations, fix gemini 3 model thinking issue, fix gemini 3 pro parallel tool use, fix gemini 3 thinking params, fix identity memory not working, fix supervisor flag, fix thread not working issue, fix when use branch topic,the branch index error problem, fixed the welcome card the create button not work, handle session invalidation on 401 error by logging out signed-in users, improve test infrastructure and mock configurations, locale resolve bug with ESM module loading, page agent editor, prevent redundant login redirect when already on auth pages, redis read json object, remove openapi pkg patch file, slove input editor on pause emit, slove swr mutate not work in Cache Provider, slove the group add member checkbox not work, slove the model select null problem, slove the mutate not work problem, slove when click agentbuilder should clean topic, slove when first call thread, not show ai chat message, support retry error message and fix continueGenerationMessage, update contextMenu in group tools message, update OFFICIAL_URL to app.lobehub.com, update PlanTag link paths for subscription settings, update test snapshots for model description changes, when use agentbuilder the topic id should use new & clear topic…."
+      ]
+    },
+    "date": "2025-12-31",
+    "version": "2.0.0-next.181"
+  },
+  {
+    "children": {},
+    "date": "2025-12-26",
+    "version": "2.0.0-next.180"
+  },
+  {
+    "children": {},
+    "date": "2025-12-25",
+    "version": "2.0.0-next.179"
+  },
+  {
+    "children": {},
+    "date": "2025-12-24",
+    "version": "2.0.0-next.178"
+  },
+  {
+    "children": {},
+    "date": "2025-12-24",
+    "version": "2.0.0-next.177"
+  },
  {
    "children": {
      "features": ["Mobile native better auth support."]
@@ -1210,6 +1486,80 @@
    "date": "2025-10-30",
    "version": "2.0.0-next.1"
  },
+  {
+    "children": {
+      "improvements": [
+        "Add Gemini 3 Flash & Doubao Seed 1.8 models, improve ExecTask and task message UI, improve gtd tool inspector and todo list, improve loading and local-system render, improve page document tool inspector UI, improve RunCommand Inspector, improve tools UI and fix Google schema compatibility, rebranding chat ui, refactor UI in features, rerun i18n, setting style, support streaming and display ui for group mode, support tool streaming and title custom render, update i18n, update i18n, update i18n, Update i18n microcopy, update ui."
+      ],
+      "features": [
+        "Add a white waitlist in edge config env, add always show tools render in createPlan & createDoc tools, add batch tasks ui, add Bundle Analyzer workflow for detailed bundle size analysis, add business features support with new components and hooks, add business settings features with dynamic loading for Plans, Funds, Usage, Billing, and Referral tabs, add db and schema feature, add home page create group builder button, Add i18n UI locales and improve tool types, add like action in community detail, add memory implement, add subscription settings group with dynamic loading for Plans, Funds, Usage, Billing, and Referral tabs, add the market auth auto generate way, Add turbopack configuration support to CustomNextConfig, add user memory, agent builder, agent builder, agent builder and group builder, app ui page, brand new 2.0 ui for next, brand new 2.0 ui for next, buildin some tools should save into docs, code-interpreter tool, code-interpreter tool, code-interpreter tool, desktop feature, enhance desktop onboarding with sign out and localization, enhance macOS desktop permissions and onboarding, enhance onboarding process by removing mode selection step and adding export functionality in advanced settings, file search feature, gtd create plan support streaming render, implement agent builder, implement builtin agents packages, implement memories package, implement Redis caching for presigned URLs in file proxy service, implement server data feature, include Subscription settings group in the Accordion component, Integrate bcryptjs for password verification in BetterAuth, integrate BrandingProviderCard and update Provider components for branding support, onboarding ui, page and knowledge base, rebranding total UI of app, refactor authentication handler to support dynamic loading of better-auth and next-auth, refactor desktop implement with brand new 2.0, rename codeinterpreter into lobe sandbox, server implement, support CMD K, support exec async sub agent task, support export and import topic JSON, support files upload in chat input, support notebook tool, support swr local cache, topic message swr cache, translate AI model descriptions to English, update agent builder ui, update create group chat use builder, update gtd tools( use editor & update metadata ), update user memory embedding model selection based on business features, user memory, user memory, user onboarding, when use usesend to create agent/group, the model should override by lobeAi, wrap ConversationArea and ModelSwitchPanel in TooltipGroup for enhanced UI."
+      ],
+      "fixes": [
+        "Agent profiles update, agent tools config set, editor placeholder, bump charts 3.0.4 to fix import es path, fix anthropic thinking budget, fix async task and improve tool style, fix default waitlist bug, fix delete agent group bug, Fix desktop test cases and refactor translations, Fix desktop test cases and refactor translations, fix gemini 3 model thinking issue, fix gemini 3 pro parallel tool use, fix gemini 3 thinking params, fix identity memory not working, fix model edit icon missing, fix supervisor flag, fix thread not working issue, fix when use branch topic,the branch index error problem, fixed the welcome card the create button not work, handle session invalidation on 401 error by logging out signed-in users, improve test infrastructure and mock configurations, locale resolve bug with ESM module loading, page agent editor, prevent redundant login redirect when already on auth pages, redis read json object, remove openapi pkg patch file, slove input editor on pause emit, slove swr mutate not work in Cache Provider, slove the group add member checkbox not work, slove the model select null problem, slove the mutate not work problem, slove when click agentbuilder should clean topic, slove when first call thread, not show ai chat message, support retry error message and fix continueGenerationMessage, update contextMenu in group tools message, update OFFICIAL_URL to app.lobehub.com, update PlanTag link paths for subscription settings, update test snapshots for model description changes, when use agentbuilder the topic id should use new & clear topic…."
+      ]
+    },
+    "date": "2026-01-02",
+    "version": "1.147.0"
+  },
+  {
+    "children": {
+      "improvements": ["Refactor database schema."],
+      "features": ["Mobile native better auth support."]
+    },
+    "date": "2025-12-29",
+    "version": "1.146.0"
+  },
+  {
+    "children": {
+      "fixes": [
+        "Request to gpt5 series should not with top_p, temperature when reasoning effort  is not none."
+      ],
+      "improvements": ["Update GPT-5.2 models, update i18n."]
+    },
+    "date": "2025-12-16",
+    "version": "1.145.1"
+  },
+  {
+    "children": {
+      "features": ["Add Replicate image provider."],
+      "fixes": ["Fix CVE errors, slove market oidc error."]
+    },
+    "date": "2025-12-12",
+    "version": "1.145.0"
+  },
+  {
+    "children": {},
+    "date": "2025-12-09",
+    "version": "1.144.2"
+  },
+  {
+    "children": {
+      "fixes": ["Add smooth scroll to top on 'More' button click in Title component."],
+      "improvements": ["Update link handling in PlanTag component to use react-router-dom."]
+    },
+    "date": "2025-12-08",
+    "version": "1.144.1"
+  },
+  {
+    "children": {
+      "features": ["Betterauth username signin, support klavis mcp connector."],
+      "fixes": ["Fix React CVE issue, limit check-user response surface."],
+      "improvements": ["Update Spark X1.5 model."]
+    },
+    "date": "2025-12-05",
+    "version": "1.144.0"
+  },
+  {
+    "children": {
+      "improvements": ["Unify retry logic to async-retry."],
+      "features": ["Optimize betterauth UX."],
+      "fixes": [
+        "Better-auth add apple sso icon and label, missing init user after user creation, remove apiMode param from Azure and Cloudflare provider requests, udpate discover detail tools get & more link, when desktop use contextMenu not work."
+      ]
+    },
+    "date": "2025-12-03",
+    "version": "1.143.0"
+  },
  {
    "children": {
      "features": ["2.0 next init."]
@@ -0,0 +1,40 @@
+# Proxy, if you need it
+# HTTP_PROXY=http://localhost:7890
+# HTTPS_PROXY=http://localhost:7890
+
+
+# Other environment variables, as needed. You can refer to the environment variables configuration for the client version, making sure not to have ACCESS_CODE.
+# OPENAI_API_KEY=sk-xxxx
+# OPENAI_PROXY_URL=https://api.openai.com/v1
+# OPENAI_MODEL_LIST=...
+
+
+# ===========================
+# ====== Preset config ======
+# ===========================
+# if no special requirements, no need to change
+LOBE_PORT=3010
+MINIO_PORT=9000
+APP_URL=http://localhost:3010
+AUTH_URL=http://localhost:3010/api/auth
+
+# Postgres related, which are the necessary environment variables for DB
+LOBE_DB_NAME=lobechat
+POSTGRES_PASSWORD=uWNZugjBqixf8dxC
+
+# MinIO S3 configuration
+MINIO_ROOT_USER=admin
+MINIO_ROOT_PASSWORD=YOUR_MINIO_PASSWORD
+LLM_VISION_IMAGE_USE_BASE64=1
+
+# Configure the bucket information of MinIO
+S3_PUBLIC_DOMAIN=http://localhost:9000
+S3_ENDPOINT=http://localhost:9000
+S3_ENABLE_PATH_STYLE=1
+S3_SET_ACL=0
+MINIO_LOBE_BUCKET=lobe
+
+#Configure for DB Mode
+NEXT_PUBLIC_SERVICE_MODE=server
+DATABASE_DRIVER=node
+NEXT_PUBLIC_ENABLE_NEXT_AUTH=1
@@ -0,0 +1,77 @@
+name: lobe-chat-development
+services:
+  postgresql:
+    image: pgvector/pgvector:pg17
+    container_name: lobe-postgres
+    ports:
+      - '5432:5432'
+    volumes:
+      - './data:/var/lib/postgresql/data'
+    environment:
+      - 'POSTGRES_DB=${LOBE_DB_NAME:-lobechat}'
+      - 'POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-postgres}'
+    env_file:
+      - ../../.env
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U postgres']
+      interval: 5s
+      timeout: 5s
+      retries: 5
+    restart: always
+    networks:
+      - lobe-network
+
+  minio:
+    image: minio/minio:RELEASE.2025-04-22T22-12-26Z
+    container_name: lobe-minio
+    ports:
+      - '${MINIO_PORT:-9000}:${MINIO_PORT:-9000}'
+      - '9001:9001'
+    networks:
+      - lobe-network
+    volumes:
+      - './s3_data:/etc/minio/data'
+    environment:
+      - 'MINIO_API_CORS_ALLOW_ORIGIN=*'
+    env_file:
+      - ../../.env
+    restart: always
+    entrypoint: >
+      /bin/sh -c "
+        minio server /etc/minio/data --address ':${MINIO_PORT:-9000}' --console-address ':9001' &
+        MINIO_PID=$$!
+        while ! curl -s http://localhost:${MINIO_PORT:-9000}/minio/health/live; do
+          echo 'Waiting for MinIO to start...'
+          sleep 1
+        done
+        sleep 5
+        mc alias set myminio http://localhost:${MINIO_PORT:-9000} ${MINIO_ROOT_USER} ${MINIO_ROOT_PASSWORD}
+        echo 'Creating bucket ${MINIO_LOBE_BUCKET:-lobe}'
+        mc mb myminio/${MINIO_LOBE_BUCKET:-lobe}
+        wait $$MINIO_PID
+      "
+
+  searxng:
+    image: searxng/searxng
+    container_name: lobe-searxng
+    ports:
+      - '8080:8080'
+    volumes:
+      - './searxng-settings.yml:/etc/searxng/settings.yml'
+    environment:
+      - 'SEARXNG_SETTINGS_FILE=/etc/searxng/settings.yml'
+    restart: always
+    networks:
+      - lobe-network
+    env_file:
+      - ../../.env
+
+volumes:
+  data:
+    driver: local
+  s3_data:
+    driver: local
+
+networks:
+  lobe-network:
+    driver: bridge
@@ -220,6 +220,56 @@ show_message() {
                ;;
            esac
        ;;
+        dev_dirs_exist)
+            case $LANGUAGE in
+                zh_CN)
+                    echo "检测到开发数据目录存在："
+                ;;
+                *)
+                    echo "Detected existing development data directories:"
+                ;;
+            esac
+        ;;
+        dev_dirs_delete_warning)
+            case $LANGUAGE in
+                zh_CN)
+                    echo "是否删除上述目录以继续？此操作将清空相关持久化数据。"
+                ;;
+                *)
+                    echo "Do you want to delete the directories above to continue? This will remove persisted data."
+                ;;
+            esac
+        ;;
+        dev_dirs_abort)
+            case $LANGUAGE in
+                zh_CN)
+                    echo "用户取消删除。无法继续进行开发环境初始化。"
+                ;;
+                *)
+                    echo "Deletion declined by user. Cannot proceed with development setup."
+                ;;
+            esac
+        ;;
+        dev_dirs_deleting)
+            case $LANGUAGE in
+                zh_CN)
+                    echo "正在删除目录："
+                ;;
+                *)
+                    echo "Deleting directories:"
+                ;;
+            esac
+        ;;
+        dev_dirs_deleted)
+            case $LANGUAGE in
+                zh_CN)
+                    echo "目录已删除。"
+                ;;
+                *)
+                    echo "Directories deleted."
+                ;;
+            esac
+        ;;
        tips_no_executable)
            case $LANGUAGE in
                zh_CN)
@@ -311,6 +361,7 @@ show_message() {
                    echo "(0) 域名模式（访问时无需指明端口），需要使用反向代理服务 LobeChat, MinIO, Casdoor ，并分别分配一个域名；"
                    echo "(1) 端口模式（访问时需要指明端口，如使用IP访问，或域名+端口访问），需要放开指定端口；"
                    echo "(2) 本地模式（仅供本地测试使用）"
+                    echo "(3) 开发模式（仅启动本地开发所需的基础服务，不包含 Casdoor；将 .env 复制到项目根目录）"
                    echo "如果你对这些内容疑惑，可以先选择使用本地模式进行部署，稍后根据文档指引再进行修改。"
                    echo "https://lobehub.com/docs/self-hosting/server-database/docker-compose"
                ;;
@@ -319,6 +370,7 @@ show_message() {
                    echo "(0) Domain mode (no need to specify the port when accessing), you need to use the reverse proxy service LobeChat, MinIO, Casdoor, and assign a domain name respectively;"
                    echo "(1) Port mode (need to specify the port when accessing, such as using IP access, or domain name + port access), you need to open the specified port;"
                    echo "(2) Local mode (for local testing only)"
+                    echo "(3) Development mode (start local dev infra only, no Casdoor; copy .env to project root)"
                    echo "If you are confused about these contents, you can choose to deploy in local mode first, and then modify according to the document guide later."
                    echo "https://lobehub.com/docs/self-hosting/server-database/docker-compose"
                ;;
@@ -378,31 +430,28 @@ download_file() {
 }

 print_centered() {
-    # Define colors
-    declare -A colors
-    colors=(
-        [black]="\e[30m"
-        [red]="\e[31m"
-        [green]="\e[32m"
-        [yellow]="\e[33m"
-        [blue]="\e[34m"
-        [magenta]="\e[35m"
-        [cyan]="\e[36m"
-        [white]="\e[37m"
-        [reset]="\e[0m"
-    )
-    local text="$1"                                   # Get input texts
-    local color="${2:-reset}"                         # Get color, default to reset
-    local term_width=$(tput cols)                     # Get terminal width
-    local text_length=${#text}                        # Get text length
-    local padding=$(((term_width - text_length) / 2)) # Get padding
-    # Check if the color is valid
-    if [[ -z "${colors[$color]}" ]]; then
-        echo "Invalid color specified. Available colors: ${!colors[@]}"
-        return 1
-    fi
-    # Print the text with padding
-    printf "%*s${colors[$color]}%s${colors[reset]}\n" $padding "" "$text"
+    # Map color name to ANSI code without associative arrays (macOS bash 3.2 compatible)
+    local text="$1"
+    local color="${2:-reset}"
+    local color_code
+    case "$color" in
+        black)   color_code="\e[30m" ;;
+        red)     color_code="\e[31m" ;;
+        green)   color_code="\e[32m" ;;
+        yellow)  color_code="\e[33m" ;;
+        blue)    color_code="\e[34m" ;;
+        magenta) color_code="\e[35m" ;;
+        cyan)    color_code="\e[36m" ;;
+        white)   color_code="\e[37m" ;;
+        reset|*) color_code="\e[0m" ;;
+    esac
+    # Determine terminal width (fallback to 80)
+    local term_width
+    term_width=$(tput cols 2>/dev/null || echo 80)
+    local text_length=${#text}
+    local padding=$(((term_width - text_length) / 2))
+    if [ $padding -lt 0 ]; then padding=0; fi
+    printf "%*s${color_code}%s\e[0m\n" $padding "" "$text"
 }

 # Usage:
@@ -420,7 +469,7 @@ ask() {
        description="$description "
    fi
    local result
-    
+
    if [ -n "$default" ]; then
        read -p "$prompt [${description}${default}]: " result
        result=${result:-$default}
@@ -475,17 +524,344 @@ if [ -z "$LANGUAGE" ]; then
    esac
 fi

+# ==========================
+# === Development Mode  ====
+# ==========================
+sync_dev_s3_env_from_minio() {
+    local SCRIPT_DIR
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    local PROJECT_ROOT
+    PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+    local DEST_ENV="$PROJECT_ROOT/.env"
+
+    if [ ! -f "$DEST_ENV" ]; then
+        return 0
+    fi
+
+    local MINIO_BUCKET MINIO_USER MINIO_PASS
+    MINIO_BUCKET=$(grep -E '^MINIO_LOBE_BUCKET=' "$DEST_ENV" | head -n1 | cut -d'=' -f2)
+    MINIO_USER=$(grep -E '^MINIO_ROOT_USER=' "$DEST_ENV" | head -n1 | cut -d'=' -f2)
+    MINIO_PASS=$(grep -E '^MINIO_ROOT_PASSWORD=' "$DEST_ENV" | head -n1 | cut -d'=' -f2)
+
+    # Defaults when missing
+    if [ -z "$MINIO_BUCKET" ]; then MINIO_BUCKET="lobe"; fi
+    if [ -z "$MINIO_USER" ]; then MINIO_USER="admin"; fi
+
+    if grep -q '^S3_BUCKET=' "$DEST_ENV"; then
+        sed "${SED_INPLACE_ARGS[@]}" "s#^S3_BUCKET=.*#S3_BUCKET=${MINIO_BUCKET}#" "$DEST_ENV"
+    else
+        echo "S3_BUCKET=${MINIO_BUCKET}" >> "$DEST_ENV"
+    fi
+    if grep -q '^S3_ACCESS_KEY=' "$DEST_ENV"; then
+        sed "${SED_INPLACE_ARGS[@]}" "s#^S3_ACCESS_KEY=.*#S3_ACCESS_KEY=${MINIO_USER}#" "$DEST_ENV"
+    else
+        echo "S3_ACCESS_KEY=${MINIO_USER}" >> "$DEST_ENV"
+    fi
+    if grep -q '^S3_ACCESS_KEY_ID=' "$DEST_ENV"; then
+        sed "${SED_INPLACE_ARGS[@]}" "s#^S3_ACCESS_KEY_ID=.*#S3_ACCESS_KEY_ID=${MINIO_USER}#" "$DEST_ENV"
+    else
+        echo "S3_ACCESS_KEY_ID=${MINIO_USER}" >> "$DEST_ENV"
+    fi
+    if grep -q '^S3_SECRET_ACCESS_KEY=' "$DEST_ENV"; then
+        sed "${SED_INPLACE_ARGS[@]}" "s#^S3_SECRET_ACCESS_KEY=.*#S3_SECRET_ACCESS_KEY=${MINIO_PASS}#" "$DEST_ENV"
+    else
+        echo "S3_SECRET_ACCESS_KEY=${MINIO_PASS}" >> "$DEST_ENV"
+    fi
+}
+
+section_setup_development_env() {
+    # Determine directories
+    local SCRIPT_DIR
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    local PROJECT_ROOT
+    PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+    echo "Setting up development environment (.env at project root)..."
+    local DEV_ENV_EXAMPLE="$SCRIPT_DIR/development/.env.example"
+    local DEST_ENV="$PROJECT_ROOT/.env"
+
+    if [ ! -f "$DEV_ENV_EXAMPLE" ]; then
+        echo "ERROR: Development .env.example not found at $DEV_ENV_EXAMPLE"
+        return 1
+    fi
+
+    local DO_COPY="y"
+    if [ -f "$DEST_ENV" ]; then
+        echo "A .env already exists at project root ($DEST_ENV). Overwrite?"
+        ask "(y/n)" "n"
+        DO_COPY="$ask_result"
+        if [[ "$DO_COPY" != "y" ]]; then
+            echo "Keeping existing .env at project root."
+        fi
+    fi
+
+    if [[ "$DO_COPY" == "y" ]]; then
+        cp "$DEV_ENV_EXAMPLE" "$DEST_ENV"
+        if [ $? -ne 0 ]; then
+            echo "ERROR: Failed to copy development .env to project root."
+            return 1
+        fi
+        echo "✔️  .env copied to project root: $DEST_ENV"
+    fi
+
+    # Sync S3 variables to concrete values from current MinIO settings
+    sync_dev_s3_env_from_minio
+}
+
+section_check_dev_data_dirs() {
+    # Check and optionally delete existing dev data directories (PostgreSQL and MinIO)
+    local SCRIPT_DIR
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    local DEV_DIR="$SCRIPT_DIR/development"
+    local DATA_DIR="$DEV_DIR/data"
+    local S3_DATA_DIR="$DEV_DIR/s3_data"
+
+    local existing_list=""
+    local -a dirs_to_remove
+
+    if [ -d "$DATA_DIR" ]; then
+        existing_list+=" data"
+        dirs_to_remove+=("$DATA_DIR")
+    fi
+    if [ -d "$S3_DATA_DIR" ]; then
+        existing_list+=" s3_data"
+        dirs_to_remove+=("$S3_DATA_DIR")
+    fi
+
+    # Nothing to do
+    if [ -z "$existing_list" ]; then
+        return 0
+    fi
+
+    # Inform user and ask for deletion
+    echo "$(show_message "dev_dirs_exist")$existing_list"
+    echo "$(show_message "dev_dirs_delete_warning")"
+    ask "(y/n)" "n"
+    if [[ "$ask_result" != "y" ]]; then
+        echo "$(show_message "dev_dirs_abort")"
+        return 1
+    fi
+
+    echo "$(show_message "dev_dirs_deleting")$existing_list"
+    # Delete only within DEV_DIR for safety
+    for d in "${dirs_to_remove[@]}"; do
+        case "$d" in
+            "$DEV_DIR"/*)
+                rm -rf -- "$d"
+                ;;
+            *)
+                echo "Skip unsafe path: $d"
+                ;;
+        esac
+    done
+    echo "$(show_message "dev_dirs_deleted")"
+}
+
+section_regenerate_secrets_dev() {
+    # Regenerate development secrets (MinIO, NextAuth, Key Vaults) and DATABASE_URL
+    if ! command -v openssl &> /dev/null ; then
+        echo "openssl" $(show_message "tips_no_executable")
+        return 1
+    fi
+    if ! command -v sed &> /dev/null ; then
+        echo "sed" $(show_message "tips_no_executable")
+        return 1
+    fi
+
+    generate_key() {
+        if [[ -z "$1" ]]; then
+            echo "Usage: generate_key <length>"
+            return 1
+        fi
+        echo $(openssl rand -hex $1 | tr -d '\n' | fold -w $1 | head -n 1)
+    }
+
+    generate_base64() {
+        if [[ -z "$1" ]]; then
+            echo "Usage: generate_base64 <bytes>"
+            return 1
+        fi
+        echo $(openssl rand -base64 $1 | tr -d '\n')
+    }
+
+    local SCRIPT_DIR
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    local PROJECT_ROOT
+    PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+    local DEST_ENV="$PROJECT_ROOT/.env"
+
+    if [ ! -f "$DEST_ENV" ]; then
+        echo "WARN: $DEST_ENV not found; skipping secret regeneration."
+        return 0
+    fi
+
+    echo $(show_message "security_secrect_regenerate")
+
+    # 1) MINIO_ROOT_PASSWORD (hex)
+    local MINIO_ROOT_PASSWORD
+    MINIO_ROOT_PASSWORD=$(generate_key 8)
+    if [ $? -ne 0 ] || [ -z "$MINIO_ROOT_PASSWORD" ]; then
+        echo $(show_message "security_secrect_regenerate_failed") "MINIO_ROOT_PASSWORD"
+        return 1
+    fi
+    if grep -q '^MINIO_ROOT_PASSWORD=' "$DEST_ENV"; then
+        sed "${SED_INPLACE_ARGS[@]}" "s#^MINIO_ROOT_PASSWORD=.*#MINIO_ROOT_PASSWORD=${MINIO_ROOT_PASSWORD}#" "$DEST_ENV"
+    else
+        echo "MINIO_ROOT_PASSWORD=${MINIO_ROOT_PASSWORD}" >> "$DEST_ENV"
+    fi
+
+    # 2) POSTGRES_PASSWORD (hex)
+    local POSTGRES_PASSWORD_NEW
+    POSTGRES_PASSWORD_NEW=$(generate_key 8)
+    if [ $? -ne 0 ] || [ -z "$POSTGRES_PASSWORD_NEW" ]; then
+        echo $(show_message "security_secrect_regenerate_failed") "POSTGRES_PASSWORD"
+    else
+        if grep -q '^POSTGRES_PASSWORD=' "$DEST_ENV"; then
+            sed "${SED_INPLACE_ARGS[@]}" "s#^POSTGRES_PASSWORD=.*#POSTGRES_PASSWORD=${POSTGRES_PASSWORD_NEW}#" "$DEST_ENV"
+        else
+            echo "POSTGRES_PASSWORD=${POSTGRES_PASSWORD_NEW}" >> "$DEST_ENV"
+        fi
+    fi
+
+    # 3) NEXT_AUTH_SECRET (base64 32)
+    local NEXT_AUTH_SECRET
+    NEXT_AUTH_SECRET=$(generate_base64 32)
+    if [ $? -ne 0 ] || [ -z "$NEXT_AUTH_SECRET" ]; then
+        echo $(show_message "security_secrect_regenerate_failed") "NEXT_AUTH_SECRET"
+    else
+        if grep -q '^NEXT_AUTH_SECRET=' "$DEST_ENV"; then
+            sed "${SED_INPLACE_ARGS[@]}" "s#^NEXT_AUTH_SECRET=.*#NEXT_AUTH_SECRET=${NEXT_AUTH_SECRET}#" "$DEST_ENV"
+        else
+            echo "NEXT_AUTH_SECRET=${NEXT_AUTH_SECRET}" >> "$DEST_ENV"
+        fi
+    fi
+
+    # 3) KEY_VAULTS_SECRET (base64 32)
+    local KEY_VAULTS_SECRET
+    KEY_VAULTS_SECRET=$(generate_base64 32)
+    if [ $? -ne 0 ] || [ -z "$KEY_VAULTS_SECRET" ]; then
+        echo $(show_message "security_secrect_regenerate_failed") "KEY_VAULTS_SECRET"
+    else
+        if grep -q '^KEY_VAULTS_SECRET=' "$DEST_ENV"; then
+            sed "${SED_INPLACE_ARGS[@]}" "s#^KEY_VAULTS_SECRET=.*#KEY_VAULTS_SECRET=${KEY_VAULTS_SECRET}#" "$DEST_ENV"
+        else
+            echo "KEY_VAULTS_SECRET=${KEY_VAULTS_SECRET}" >> "$DEST_ENV"
+        fi
+    fi
+
+    # 4) DATABASE_URL (postgres connection string)
+    local POSTGRES_PASSWORD_VAL
+    local LOBE_DB_NAME_VAL
+    POSTGRES_PASSWORD_VAL=$(grep -E '^POSTGRES_PASSWORD=' "$DEST_ENV" | head -n1 | cut -d'=' -f2)
+    LOBE_DB_NAME_VAL=$(grep -E '^LOBE_DB_NAME=' "$DEST_ENV" | head -n1 | cut -d'=' -f2)
+    if [ -z "$POSTGRES_PASSWORD_VAL" ]; then POSTGRES_PASSWORD_VAL="postgres"; fi
+    if [ -z "$LOBE_DB_NAME_VAL" ]; then LOBE_DB_NAME_VAL="lobechat"; fi
+    local DATABASE_URL
+    DATABASE_URL="postgres://postgres:${POSTGRES_PASSWORD_VAL}@localhost:5432/${LOBE_DB_NAME_VAL}"
+    if grep -q '^DATABASE_URL=' "$DEST_ENV"; then
+        sed "${SED_INPLACE_ARGS[@]}" "s#^DATABASE_URL=.*#DATABASE_URL=${DATABASE_URL}#" "$DEST_ENV"
+    else
+        echo "DATABASE_URL=${DATABASE_URL}" >> "$DEST_ENV"
+    fi
+
+    # Sync S3 variables to reflect updated MinIO creds
+    sync_dev_s3_env_from_minio
+}
+
+section_init_database_dev() {
+    if ! command -v docker &> /dev/null ; then
+        echo "docker" $(show_message "tips_no_executable")
+        return 1
+    fi
+    if ! docker compose &> /dev/null ; then
+        echo "docker compose" $(show_message "tips_no_executable")
+        return 1
+    fi
+    if ! docker stats --no-stream &> /dev/null ; then
+        echo $(show_message "tips_no_docker_permission")
+        return 1
+    fi
+
+    local SCRIPT_DIR
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    local PROJECT_ROOT
+    PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+    echo "Starting development infrastructure (PostgreSQL, MinIO, SearXNG)..."
+    docker compose --env-file "$PROJECT_ROOT/.env" -f "$SCRIPT_DIR/development/docker-compose.yml" pull
+    docker compose --env-file "$PROJECT_ROOT/.env" -f "$SCRIPT_DIR/development/docker-compose.yml" up --detach postgresql minio searxng
+    # give services a moment to start
+    sleep 5
+}
+
+section_display_dev_report() {
+    local SCRIPT_DIR
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    local PROJECT_ROOT
+    PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+    local DEST_ENV="$PROJECT_ROOT/.env"
+
+    # Defaults
+    local LOBE_PORT_VALUE=3210
+    local MINIO_PORT_VALUE=9000
+
+    if [ -f "$DEST_ENV" ]; then
+        local lp mp
+        lp=$(grep -E '^LOBE_PORT=' "$DEST_ENV" | head -n1 | cut -d'=' -f2)
+        mp=$(grep -E '^MINIO_PORT=' "$DEST_ENV" | head -n1 | cut -d'=' -f2)
+        if [ -n "$lp" ]; then LOBE_PORT_VALUE="$lp"; fi
+        if [ -n "$mp" ]; then MINIO_PORT_VALUE="$mp"; fi
+    fi
+
+    printf "\nDevelopment infrastructure started. Service endpoints:\n"
+    echo "- PostgreSQL: localhost:5432"
+    echo "- MinIO API:  http://localhost:${MINIO_PORT_VALUE} (Console: http://localhost:9001)"
+    echo "- SearXNG:    http://localhost:8080"
+
+    printf "\nYou can now run the app locally with:\n"
+    print_centered "pnpm db:migrate" "green"
+    print_centered "pnpm start:dev" "green"
+}
+
+# Prompt for deployment mode early to allow Development mode flow
+show_message "ask_deploy_mode"
+ask "(0,1,2,3)" "2"
+if [[ "$ask_result" == "3" ]]; then
+    # Development mode: copy .env to project root, optionally regenerate secrets/init DB, then report and exit
+    section_setup_development_env || exit 1
+
+    show_message "ask_regenerate_secrets"
+    ask "(y/n)" "y"
+    if [[ "$ask_result" == "y" ]]; then
+        section_regenerate_secrets_dev || true
+    fi
+
+    # Check if dev data directories exist and handle per user choice; abort if declined
+    section_check_dev_data_dirs || exit 1
+
+    show_message "ask_init_database"
+    ask "(y/n)" "y"
+    if [[ "$ask_result" == "y" ]]; then
+        section_init_database_dev || true
+    else
+        show_message "tips_init_database_failed"
+    fi
+
+    section_display_dev_report
+    exit 0
+fi
+
 section_download_files(){
    # Download files asynchronously
    if ! command -v wget &> /dev/null ; then
        echo "wget" $(show_message "tips_no_executable")
        exit 1
    fi
-    
+
    download_file "$SOURCE_URL/${FILES[0]}" "docker-compose.yml"
    download_file "$SOURCE_URL/${FILES[1]}" "init_data.json"
    download_file "$SOURCE_URL/${FILES[2]}" "searxng-settings.yml"
-    
+
    # Download .env.example with the specified language
    if [ "$LANGUAGE" = "zh_CN" ]; then
        download_file "$SOURCE_URL/${ENV_EXAMPLES[0]}" ".env"
@@ -522,13 +898,13 @@ section_configurate_host() {
            sed "${SED_INPLACE_ARGS[@]}" "s#http://#https://#" .env
        fi
    fi
-    
+
    # Check if sed is installed
    if ! command -v sed "${SED_INPLACE_ARGS[@]}" &> /dev/null ; then
        echo "sed" $(show_message "tips_no_executable")
        exit 1
    fi
-    
+
    # If user not specify host, try to get the server ip
    if [ -z "$HOST" ]; then
        HOST=$(hostname -I | awk '{print $1}')
@@ -537,8 +913,8 @@ section_configurate_host() {
            echo $(show_message "tips_private_ip_detected")
        fi
    fi
-    
-   
+
+
    case $DEPLOY_MODE in
        0)
            DEPLOY_MODE="domain"
@@ -573,7 +949,7 @@ section_configurate_host() {
            exit 1
        ;;
    esac
-    
+
    # lobe host
    sed "${SED_INPLACE_ARGS[@]}" "s#^APP_URL=.*#APP_URL=$PROTOCOL://$LOBE_HOST#" .env
    # auth related
@@ -583,15 +959,18 @@ section_configurate_host() {
    # s3 related
    sed "${SED_INPLACE_ARGS[@]}" "s#^S3_PUBLIC_DOMAIN=.*#S3_PUBLIC_DOMAIN=$PROTOCOL://$MINIO_HOST#" .env
    sed "${SED_INPLACE_ARGS[@]}" "s#^S3_ENDPOINT=.*#S3_ENDPOINT=$PROTOCOL://$MINIO_HOST#" .env
-    
+

    # Check if env modified success
    if [ $? -ne 0 ]; then
        echo $(show_message "host_regenerate_failed") "$HOST in \`.env\`"
    fi
 }
-show_message "ask_deploy_mode"
-ask "(0,1,2)" "2"
+
+if [ -z "$ask_result" ]; then
+    show_message "ask_deploy_mode"
+    ask "(0,1,2)" "2"
+fi
 if [[ "$ask_result" == "0" ]] || [[ "$ask_result" == "1" ]] || [[ "$ask_result" == "2" ]]; then
    section_configurate_host
 else
@@ -620,7 +999,7 @@ section_regenerate_secrets() {
        echo "head" $(show_message "tips_no_executable")
        exit 1
    fi
-    
+
    generate_key() {
        if [[ -z "$1" ]]; then
            echo "Usage: generate_key <length>"
@@ -628,13 +1007,13 @@ section_regenerate_secrets() {
        fi
        echo $(openssl rand -hex $1 | tr -d '\n' | fold -w $1 | head -n 1)
    }
-    
+
    if ! command -v sed &> /dev/null ; then
        echo "sed" $(show_message "tips_no_executable")
        exit 1
    fi
    echo $(show_message "security_secrect_regenerate")
-    
+
    # Generate CASDOOR_SECRET
    CASDOOR_SECRET=$(generate_key 32)
    if [ $? -ne 0 ]; then
@@ -651,7 +1030,7 @@ section_regenerate_secrets() {
            echo $(show_message "security_secrect_regenerate_failed") "AUTH_CASDOOR_SECRET in \`init_data.json\`"
        fi
    fi
-    
+
    # Generate Casdoor User
    CASDOOR_USER="admin"
    CASDOOR_PASSWORD=$(generate_key 10)
@@ -722,18 +1101,18 @@ if [[ "$ask_result" == "y" ]]; then
    if [ $? -ne 0 ]; then
        echo $(show_message "tips_init_database_failed")
    fi
-else 
+else
    show_message "tips_init_database_failed"
 fi

 section_display_configurated_report() {
    # Display configuration reports
    echo $(show_message "security_secrect_regenerate_report")
-    
+
    echo -e "LobeChat: \n  - URL: $PROTOCOL://$LOBE_HOST \n  - Username: user \n  - Password: ${CASDOOR_PASSWORD} "
    echo -e "Casdoor: \n  - URL: $PROTOCOL://$CASDOOR_HOST \n  - Username: admin \n  - Password: ${CASDOOR_PASSWORD}\n"
    echo -e "Minio: \n  - URL: $PROTOCOL://$MINIO_HOST \n  - Username: admin\n  - Password: ${MINIO_ROOT_PASSWORD}\n"
-    
+
    # if user run in domain mode, diplay reverse proxy configuration
    if [[ "$DEPLOY_MODE" == "domain" ]]; then
        echo $(show_message "tips_add_reverse_proxy")
@@ -72,6 +72,34 @@ bun run dev

 Now, you should be able to see the welcome page of LobeChat in your browser. For a detailed environment setup guide, please refer to [Development Environment Setup Guide](/docs/development/basic/setup-development).

+### Start local infrastructure with Docker Compose (Development mode)
+
+If you want to run LobeChat against a local database and object storage, we provide a Development mode that launches only the infrastructure you need (PostgreSQL, MinIO, and SearXNG) via Docker:
+
+```bash
+cd docker-compose
+bash ./setup.sh
+# When prompted, choose: (3) Development mode
+# The script will:
+# - copy a .env template to the project root (./.env)
+# - regenerate secrets if you accept the prompt
+# - start Postgres, MinIO and SearXNG
+```
+
+After the infrastructure is up, return to the project root and run:
+
+```bash
+pnpm install
+pnpm run db:migrate
+pnpm run dev
+```
+
+Notes:
+
+- The .env file is stored at the project root so pnpm scripts auto-load it.
+- Casdoor is not used in Development mode.
+- MinIO Console is available at [http://localhost:9001](http://localhost:9001) and SearXNG at [http://localhost:8080](http://localhost:8080).
+
 ## Code Style and Contribution Guide

 In the LobeChat project, we place great emphasis on the quality and consistency of the code. For this reason, we have established a series of code style standards and contribution processes to ensure that every developer can smoothly participate in the project. Here are the code style and contribution guidelines you need to follow as a developer.
@@ -44,12 +44,14 @@ Before connecting the desktop to your self-hosted instance, ensure that your sel

 #### OIDC Environment Variable Configuration

-You need to add the following two environment variables, `ENABLE_OIDC` and `OIDC_JWKS_KEY`, to your self-hosted instance. You can click the button below to generate them with one click:
+You need to add the following two environment variables, `ENABLE_OIDC` and `JWKS_KEY`, to your self-hosted instance. You can click the button below to generate them with one click:

 <OIDCJWKs />

 Add the generated JWK key to your environment variables.

+<Callout>If you have already configured `OIDC_JWKS_KEY`, no changes are needed. The system will automatically fall back to `OIDC_JWKS_KEY` for backward compatibility.</Callout>
+
 If you are deploying LobeChat using one-click deployment methods (such as Vercel, Railway, etc.), you need to:

 1. Add the above environment variables to the environment variable configuration of your deployment platform.
@@ -71,8 +73,8 @@ If you are deploying LobeChat using one-click deployment methods (such as Vercel

 **Solution:**

- Confirm that you have correctly set the `ENABLE_OIDC=1` and `OIDC_JWKS_KEY` environment variables.
- Ensure that `OIDC_JWKS_KEY` is in valid JSON format without extra single quotes.
+- Confirm that you have correctly set the `ENABLE_OIDC=1` and `JWKS_KEY` environment variables.
+- Ensure that `JWKS_KEY` is in valid JSON format without extra single quotes.
 - Check your server logs for specific error messages.

 If you are using Nginx as a reverse proxy, the issue may be due to oversized request headers. You can try adding the following settings to your Nginx configuration:
@@ -42,12 +42,14 @@ LobeChat 桌面端可以与您自托管的 LobeChat 实例连接，以便您可

 #### OIDC 环境变量配置

-您需要在自托管实例中添加以下`ENABLE_OIDC` 和 `OIDC_JWKS_KEY` 这两个环境变量，你可以点击下方按钮一键生成：
+您需要在自托管实例中添加以下`ENABLE_OIDC` 和 `JWKS_KEY` 这两个环境变量，你可以点击下方按钮一键生成：

 <OIDCJWKs />

 将生成的 JWK 密钥添加到您的环境变量中。

+<Callout>如果您之前已配置 `OIDC_JWKS_KEY`，无需修改。系统会自动回退使用 `OIDC_JWKS_KEY`（向后兼容）。</Callout>
+
 如果您使用一键部署方式（如 Vercel、Railway 等平台）部署 LobeChat，您需要：

 1. 将上述环境变量添加到部署平台的环境变量配置中
@@ -69,8 +71,8 @@ LobeChat 桌面端可以与您自托管的 LobeChat 实例连接，以便您可

 **解决方案：**

- 确认您已经正确设置了 `ENABLE_OIDC=1` 和 `OIDC_JWKS_KEY` 环境变量
- 确保 `OIDC_JWKS_KEY` 是有效的 JSON 格式，没有额外的单引号
+- 确认您已经正确设置了 `ENABLE_OIDC=1` 和 `JWKS_KEY` 环境变量
+- 确保 `JWKS_KEY` 是有效的 JSON 格式，没有额外的单引号
 - 检查您的服务端日志，查看具体错误信息

 如果您使用 Nginx 作为反向代理，可能是请求头太大导致的问题。可以尝试在 Nginx 配置中添加以下设置：
@@ -55,6 +55,14 @@ LobeChat provides a complete authentication service capability when deployed. Th
 - Default: `-`
 - Example: `google,github,microsoft,cognito`

+#### `JWKS_KEY`
+
+- Type: Required
+- Description: Generic JWKS (JSON Web Key Set) key for signing and verifying JWTs. Used for internal service authentication and other cryptographic operations. Must be a JWKS JSON string containing an RS256 RSA key pair. Falls back to `OIDC_JWKS_KEY` if not set (for backward compatibility).
+- Default: `-`
+
+<OIDCJWKs />
+
 ### Email Service (SMTP)

 These settings are required for email verification and password reset features.
@@ -53,6 +53,14 @@ LobeChat 在部署时提供了完善的身份验证服务能力，以下是相
 - 默认值：`-`
 - 示例：`google,github,microsoft,cognito`

+#### `JWKS_KEY`
+
+- 类型：必选
+- 描述：用于签名和验证 JWT 的通用 JWKS（JSON Web Key Set）密钥。用于内部服务认证和其他加密操作。必须是包含 RS256 RSA 密钥对的 JWKS JSON 字符串。如果未设置，将回退到 `OIDC_JWKS_KEY`（向后兼容）。
+- 默认值：`-`
+
+<OIDCJWKs />
+
 ### 邮件服务（SMTP）

 启用邮箱验证和密码重置功能需要配置以下设置。
@@ -20,6 +20,12 @@ tags:
  [![][docker-pulls-shield]][docker-pulls-link]
 </div>

+<Callout type="info">
+  For local development, use the interactive <strong>Development mode</strong> which starts only the infrastructure (PostgreSQL, MinIO, and SearXNG). It stores the <code>.env</code> file at the project root so pnpm scripts auto-load it. Casdoor is not used in this mode.
+
+  See the development guide: <a href="/docs/development/start">/docs/development/start</a>
+</Callout>
+
 <Callout type="warning">
  **Note on Docker Deployment Limitations**
  The Docker and Docker Compose deployment options do not support injecting the `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` through environment variables, which prevents enabling the Clerk authentication service. Recommended alternatives include:
@@ -7,15 +7,7 @@ import type { Config } from 'drizzle-kit';

 dotenv.config();

-let connectionString = process.env.DATABASE_URL;
-
-if (process.env.NODE_ENV === 'test') {
-  console.log('current ENV:', process.env.NODE_ENV);
-  connectionString = process.env.DATABASE_TEST_URL;
-}
-
-if (!connectionString)
-  throw new Error('`DATABASE_URL` or `DATABASE_TEST_URL` not found in environment');
+let connectionString = process.env.DATABASE_URL!;

 export default {
  dbCredentials: {
@@ -0,0 +1,2 @@
+reports
+screenshots
@@ -0,0 +1,428 @@
+# E2E Testing Guide for Claude
+
+本文档记录了在 LobeHub E2E 测试开发中的经验和最佳实践。
+
+Related: [LOBE-2417](https://linear.app/lobehub/issue/LOBE-2417/建立核心产品功能-e2e-测试体验基准线)
+
+## 测试策略：体验驱动的 E2E 测试
+
+### 核心理念
+
+建立完整的**用户体验链路 E2E 测试**，作为未来变更和重构的**体验基准线**。
+
+**目的**：
+
+- 确保核心用户体验在代码变更后不会退化
+- 为重构提供安全网，敢于大胆改进代码
+- 从用户视角验证功能完整性
+
+### 产品架构覆盖
+
+| 模块             | 子功能               | 优先级 | 状态 |
+| ---------------- | -------------------- | ------ | ---- |
+| **Agent**        | Builder, 对话，Task  | P0     | 🚧   |
+| **Agent Group**  | Builder, 群聊        | P1     | ⏳   |
+| **Page（文稿）** | 创建，编辑，分享     | P1     | ⏳   |
+| **知识库**       | 创建，上传，RAG 对话 | P1     | ⏳   |
+| **记忆**         | 查看，编辑，关联     | P2     | ⏳   |
+
+### 标签系统
+
+```gherkin
+@journey      # 用户旅程测试（体验基准线）
+@smoke        # 冒烟测试（快速验证）
+@regression   # 回归测试
+
+@P0           # 最高优先级（CI 必跑）
+@P1           # 高优先级（Nightly）
+@P2           # 中优先级（发版前）
+
+@agent        # Agent 模块
+@agent-group  # Agent Group 模块
+@page         # Page 文稿模块
+@knowledge    # 知识库模块
+@memory       # 记忆模块
+```
+
+### 执行策略
+
+```bash
+# CI - P0 冒烟测试（每次 PR）
+pnpm exec cucumber-js --config cucumber.config.js --tags "@smoke and @P0"
+
+# Nightly - 所有用户旅程
+pnpm exec cucumber-js --config cucumber.config.js --tags "@journey"
+
+# 发版前 - 完整回归
+pnpm exec cucumber-js --config cucumber.config.js --tags "@P0 or @P1"
+
+# 完整测试
+pnpm exec cucumber-js --config cucumber.config.js
+```
+
+### 测试设计原则
+
+1. **按 CRUD + 核心交互覆盖**：每个模块覆盖创建、读取、更新、删除及核心交互流程
+2. **LLM 响应必须 Mock**：保证测试稳定性和可重复性
+3. **中文描述场景**：Feature 文件使用中文，贴近产品需求
+4. **优先级分层**：合理分配 P0/P1/P2，控制 CI 执行时间
+
+## 目录结构
+
+```
+e2e/
+├── src/
+│   ├── features/                    # Cucumber feature 文件
+│   │   ├── journeys/                # 用户旅程（体验基准线）
+│   │   │   ├── agent/
+│   │   │   │   ├── agent-builder.feature
+│   │   │   │   ├── agent-conversation.feature  ✅
+│   │   │   │   └── agent-task.feature
+│   │   │   ├── agent-group/
+│   │   │   │   ├── group-builder.feature
+│   │   │   │   └── group-chat.feature
+│   │   │   ├── page/
+│   │   │   │   └── page-crud.feature
+│   │   │   ├── knowledge/
+│   │   │   │   └── knowledge-rag.feature
+│   │   │   └── memory/
+│   │   │       └── memory-crud.feature
+│   │   ├── smoke/                   # 冒烟测试
+│   │   │   └── discover/
+│   │   └── regression/              # 回归测试
+│   ├── steps/                       # Step definitions
+│   │   ├── agent/                   # Agent 相关 steps
+│   │   ├── common/                  # 通用 steps (auth, navigation)
+│   │   └── hooks.ts                 # Before/After hooks
+│   ├── mocks/                       # Mock 框架
+│   │   └── llm/                     # LLM Mock (拦截 AI 请求) ✅
+│   └── support/                     # 测试支持文件
+│       └── world.ts                 # CustomWorld 定义
+├── screenshots/                     # 失败截图
+├── reports/                         # 测试报告
+├── cucumber.config.js               # Cucumber 配置
+└── CLAUDE.md                        # 本文档
+```
+
+## 本地环境启动
+
+> 详细流程参考 [e2e/docs/local-setup.md](./docs/local-setup.md)
+
+### 快速启动流程
+
+```bash
+# Step 1: 清理环境
+docker stop postgres-e2e 2> /dev/null; docker rm postgres-e2e 2> /dev/null
+lsof -ti:3006 | xargs kill -9 2> /dev/null
+lsof -ti:5433 | xargs kill -9 2> /dev/null
+
+# Step 2: 启动数据库（使用 paradedb 镜像，支持 pgvector）
+docker run -d --name postgres-e2e \
+  -e POSTGRES_PASSWORD=postgres \
+  -p 5433:5432 \
+  paradedb/paradedb:latest
+
+# 等待数据库就绪
+until docker exec postgres-e2e pg_isready; do sleep 2; done
+
+# Step 3: 运行数据库迁移（项目根目录）
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  KEY_VAULTS_SECRET=LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s= \
+  bun run db:migrate
+
+# Step 4: 构建应用（首次或代码变更后）
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  KEY_VAULTS_SECRET=LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s= \
+  BETTER_AUTH_SECRET=e2e-test-secret-key-for-better-auth-32chars! \
+  NEXT_PUBLIC_ENABLE_BETTER_AUTH=1 \
+  SKIP_LINT=1 \
+  bun run build
+
+# Step 5: 启动服务器（必须在项目根目录运行！）
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  KEY_VAULTS_SECRET=LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s= \
+  BETTER_AUTH_SECRET=e2e-test-secret-key-for-better-auth-32chars! \
+  NEXT_PUBLIC_ENABLE_BETTER_AUTH=1 \
+  NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION=0 \
+  S3_ACCESS_KEY_ID=e2e-mock-access-key \
+  S3_SECRET_ACCESS_KEY=e2e-mock-secret-key \
+  S3_BUCKET=e2e-mock-bucket \
+  S3_ENDPOINT=https://e2e-mock-s3.localhost \
+  bunx next start -p 3006
+```
+
+**重要提示**:
+
+- 必须使用 `paradedb/paradedb:latest` 镜像（支持 pgvector 扩展）
+- 服务器必须在**项目根目录**启动，不能在 e2e 目录
+- S3 环境变量是**必需**的，即使不测试文件上传
+
+## 运行测试
+
+```bash
+# 从 e2e 目录运行
+cd e2e
+
+# 运行特定标签的测试
+BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js --tags "@AGENT-CHAT-001"
+
+# 调试模式（显示浏览器）
+HEADLESS=false BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js --tags "@conversation"
+
+# 运行所有测试
+BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js
+```
+
+**重要**: 必须显式指定 `--config cucumber.config.js`，否则配置不会被正确加载。
+
+## LLM Mock 实现
+
+### 核心原理
+
+LLM Mock 通过 Playwright 的 `page.route()` 拦截对 `/webapi/chat/openai` 的请求，返回预设的 SSE 流式响应。
+
+### SSE 响应格式
+
+LobeHub 使用特定的 SSE 格式，必须严格匹配：
+
+```typescript
+// 1. 初始 data 事件
+id: msg_xxx
+event: data
+data: {"id":"msg_xxx","model":"gpt-4o-mini","role":"assistant","type":"message",...}
+
+// 2. 文本内容分块（text 事件）
+id: msg_xxx
+event: text
+data: "Hello"
+
+id: msg_xxx
+event: text
+data: "! I am"
+
+// 3. 停止事件
+id: msg_xxx
+event: stop
+data: "end_turn"
+
+// 4. 使用量统计
+id: msg_xxx
+event: usage
+data: {"totalTokens":100,...}
+
+// 5. 最终停止
+id: msg_xxx
+event: stop
+data: "message_stop"
+```
+
+### 使用示例
+
+```typescript
+import { llmMockManager, presetResponses } from '../../mocks/llm';
+
+// 在测试步骤中设置 mock
+llmMockManager.setResponse('hello', presetResponses.greeting);
+await llmMockManager.setup(this.page);
+```
+
+### 添加自定义响应
+
+```typescript
+// 为特定用户消息设置响应
+llmMockManager.setResponse('你好', '你好！我是 Lobe AI，有什么可以帮助你的？');
+
+// 清除所有自定义响应
+llmMockManager.clearResponses();
+```
+
+## 页面元素定位技巧
+
+### 富文本编辑器 (contenteditable) 输入
+
+LobeHub 使用 `@lobehub/editor` 作为聊天输入框，是一个 contenteditable 的富文本编辑器。
+
+**关键点**:
+
+1. 不能直接用 `locator.fill()` - 对 contenteditable 不生效
+2. 需要先 click 容器让编辑器获得焦点
+3. 使用 `keyboard.type()` 输入文本
+
+```typescript
+// 正确的输入方式
+await chatInputContainer.click();
+await this.page.waitForTimeout(500); // 等待焦点
+await this.page.keyboard.type(message, { delay: 30 });
+await this.page.keyboard.press('Enter'); // 发送
+```
+
+### 添加 data-testid
+
+为了更可靠的元素定位，可以在组件上添加 `data-testid`：
+
+```tsx
+// src/features/ChatInput/Desktop/index.tsx
+<ChatInput
+  data-testid="chat-input"
+  ...
+/>
+```
+
+## 调试技巧
+
+### 添加步骤日志
+
+在每个关键步骤添加 console.log，帮助定位问题：
+
+```typescript
+Given('用户进入页面', async function (this: CustomWorld) {
+  console.log('   📍 Step: 导航到首页...');
+  await this.page.goto('/');
+
+  console.log('   📍 Step: 查找元素...');
+  const element = this.page.locator('...');
+
+  console.log('   ✅ 步骤完成');
+});
+```
+
+### 查看失败截图
+
+测试失败时会自动保存截图到 `e2e/screenshots/` 目录。
+
+### 非 headless 模式
+
+设置 `HEADLESS=false` 可以看到浏览器操作：
+
+```bash
+HEADLESS=false pnpm exec cucumber-js --config cucumber.config.js --tags "@smoke"
+```
+
+## 环境变量
+
+运行测试需要以下环境变量：
+
+```bash
+BASE_URL=http://localhost:3010   # 测试服务器地址
+DATABASE_URL=postgresql://...    # 数据库连接
+DATABASE_DRIVER=node             # 数据库驱动
+KEY_VAULTS_SECRET=...            # 密钥
+BETTER_AUTH_SECRET=...           # Auth 密钥
+NEXT_PUBLIC_ENABLE_BETTER_AUTH=1 # 启用 Better Auth
+
+# 可选：S3 相关（如果测试涉及文件上传）
+S3_ACCESS_KEY_ID=e2e-mock-access-key
+S3_SECRET_ACCESS_KEY=e2e-mock-secret-key
+S3_BUCKET=e2e-mock-bucket
+S3_ENDPOINT=https://e2e-mock-s3.localhost
+```
+
+## 清理环境
+
+测试完成后或需要重置环境时，执行以下清理操作：
+
+### 停止服务器
+
+```bash
+# 查找并停止占用端口的进程
+lsof -ti:3006 | xargs kill -9 2> /dev/null
+lsof -ti:3010 | xargs kill -9 2> /dev/null
+```
+
+### 停止 Docker 容器
+
+```bash
+# 停止并删除 PostgreSQL 容器
+docker stop postgres-e2e 2> /dev/null
+docker rm postgres-e2e 2> /dev/null
+```
+
+### 一键清理（推荐）
+
+```bash
+# 清理所有 E2E 相关进程和容器
+docker stop postgres-e2e 2> /dev/null
+docker rm postgres-e2e 2> /dev/null
+lsof -ti:3006 | xargs kill -9 2> /dev/null
+lsof -ti:3010 | xargs kill -9 2> /dev/null
+lsof -ti:5433 | xargs kill -9 2> /dev/null
+echo "Cleanup done"
+```
+
+### 清理端口占用
+
+如果遇到端口被占用的错误，可以清理特定端口：
+
+```bash
+# 清理 Next.js 服务器端口
+lsof -ti:3006 | xargs kill -9
+
+# 清理 PostgreSQL 端口
+lsof -ti:5433 | xargs kill -9
+```
+
+## 常见问题
+
+### 1. 测试超时 (function timed out)
+
+**原因**: 元素定位失败或等待时间不足
+
+**解决**:
+
+- 检查选择器是否正确
+- 增加 timeout 参数
+- 添加显式等待 `waitForTimeout()`
+
+### 2. strict mode violation (多个元素匹配)
+
+**原因**: 选择器匹配到多个元素（如 desktop/mobile 双组件）
+
+**解决**:
+
+- 使用 `.first()` 或 `.nth(n)`
+- 使用 `boundingBox()` 过滤可见元素
+
+### 3. LLM Mock 未生效
+
+**原因**: 路由拦截设置在页面导航之后
+
+**解决**: 确保在 `page.goto()` 之前调用 `llmMockManager.setup(page)`
+
+### 4. 输入框内容为空
+
+**原因**: contenteditable 编辑器的特殊性
+
+**解决**:
+
+- 先 click 容器确保焦点
+- 使用 `keyboard.type()` 而非 `fill()`
+- 添加适当的等待时间
+
+## 编写新测试的流程
+
+1. **创建 Feature 文件** (`src/features/xxx/xxx.feature`)
+   - 使用中文描述场景
+   - 添加适当的标签 (@journey, @P0, @smoke 等)
+
+2. **创建 Step Definitions** (`src/steps/xxx/xxx.steps.ts`)
+   - 导入必要的 mock 和工具
+   - 每个步骤添加日志
+   - 处理元素定位的边界情况
+
+3. **设置 Mock**（如需要）
+   - 在 `src/mocks/` 下创建对应的 mock
+   - 在步骤中初始化 mock
+
+4. **调试和验证**
+   - 先用 `HEADLESS=false` 运行观察
+   - 检查失败截图
+   - 确保稳定通过后再提交
@@ -10,11 +10,11 @@ export default {
  formatOptions: {
    snippetInterface: 'async-await',
  },
-  parallel: process.env.CI ? 1 : 4,
+  parallel: 1,
  paths: ['src/features/**/*.feature'],
  publishQuiet: true,
  require: ['src/steps/**/*.ts', 'src/support/**/*.ts'],
  requireModule: ['tsx/cjs'],
  retry: 0,
-  timeout: 120_000,
+  timeout: 30_000,
 };
@@ -0,0 +1,68 @@
+# LLM Mock 实现
+
+## 核心原理
+
+LLM Mock 通过 Playwright 的 `page.route()` 拦截对 `/webapi/chat/openai` 的请求，返回预设的 SSE 流式响应。
+
+## SSE 响应格式
+
+LobeHub 使用特定的 SSE 格式，必须严格匹配：
+
+```
+// 1. 初始 data 事件
+id: msg_xxx
+event: data
+data: {"id":"msg_xxx","model":"gpt-4o-mini","role":"assistant","type":"message",...}
+
+// 2. 文本内容分块（text 事件）
+id: msg_xxx
+event: text
+data: "Hello"
+
+id: msg_xxx
+event: text
+data: "! I am"
+
+// 3. 停止事件
+id: msg_xxx
+event: stop
+data: "end_turn"
+
+// 4. 使用量统计
+id: msg_xxx
+event: usage
+data: {"totalTokens":100,...}
+
+// 5. 最终停止
+id: msg_xxx
+event: stop
+data: "message_stop"
+```
+
+## 使用示例
+
+```typescript
+import { llmMockManager, presetResponses } from '../../mocks/llm';
+
+// 在测试步骤中设置 mock
+llmMockManager.setResponse('hello', presetResponses.greeting);
+await llmMockManager.setup(this.page);
+```
+
+## 添加自定义响应
+
+```typescript
+// 为特定用户消息设置响应
+llmMockManager.setResponse('你好', '你好！我是 Lobe AI，有什么可以帮助你的？');
+
+// 清除所有自定义响应
+llmMockManager.clearResponses();
+```
+
+## 常见问题
+
+### LLM Mock 未生效
+
+**原因**: 路由拦截设置在页面导航之后
+
+**解决**: 确保在 `page.goto()` 之前调用 `llmMockManager.setup(page)`
@@ -0,0 +1,354 @@
+# 本地运行 E2E 测试
+
+## 前置要求
+
+- Docker Desktop 已安装并**正在运行**
+- Node.js 18+
+- pnpm 已安装
+- 项目已 `pnpm install`
+
+## 完整启动流程
+
+### Step 0: 环境清理（重要！）
+
+每次运行测试前，建议先清理环境，避免残留状态导致问题。
+
+```bash
+# 0.1 确保 Docker Desktop 正在运行
+# 如果未运行，请先启动 Docker Desktop
+
+# 0.2 清理旧的 PostgreSQL 容器
+docker stop postgres-e2e 2> /dev/null
+docker rm postgres-e2e 2> /dev/null
+
+# 0.3 清理占用的端口
+lsof -ti:3006 | xargs kill -9 2> /dev/null # Next.js 服务器端口
+lsof -ti:5433 | xargs kill -9 2> /dev/null # PostgreSQL 端口
+```
+
+### Step 1: 启动数据库
+
+```bash
+# 启动 PostgreSQL (端口 5433)
+docker run -d --name postgres-e2e \
+  -e POSTGRES_PASSWORD=postgres \
+  -p 5433:5432 \
+  paradedb/paradedb:latest
+
+# 等待数据库就绪
+until docker exec postgres-e2e pg_isready; do sleep 2; done
+echo "PostgreSQL is ready!"
+```
+
+### Step 2: 运行数据库迁移
+
+```bash
+# 在项目根目录运行
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  bun run db:migrate
+```
+
+### Step 3: 构建应用（首次或代码变更后）
+
+```bash
+# 在项目根目录运行
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  KEY_VAULTS_SECRET=LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s= \
+  BETTER_AUTH_SECRET=e2e-test-secret-key-for-better-auth-32chars! \
+  NEXT_PUBLIC_ENABLE_BETTER_AUTH=1 \
+  SKIP_LINT=1 \
+  bun run build
+```
+
+### Step 4: 启动应用服务器
+
+**重要**: 必须在**项目根目录**运行，不能在 e2e 目录运行！
+
+```bash
+# 在项目根目录运行（注意：不是 e2e 目录）
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  KEY_VAULTS_SECRET=LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s= \
+  BETTER_AUTH_SECRET=e2e-test-secret-key-for-better-auth-32chars! \
+  NEXT_PUBLIC_ENABLE_BETTER_AUTH=1 \
+  NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION=0 \
+  S3_ACCESS_KEY_ID=e2e-mock-access-key \
+  S3_SECRET_ACCESS_KEY=e2e-mock-secret-key \
+  S3_BUCKET=e2e-mock-bucket \
+  S3_ENDPOINT=https://e2e-mock-s3.localhost \
+  bunx next start -p 3006
+```
+
+### Step 5: 等待服务器就绪
+
+```bash
+# 在另一个终端运行，确认服务器已启动
+until curl -s http://localhost:3006 > /dev/null; do
+  sleep 2
+  echo "Waiting..."
+done
+echo "Server is ready!"
+```
+
+### Step 6: 运行测试
+
+```bash
+# 在 e2e 目录运行测试
+cd e2e
+
+# 运行特定标签（默认无头模式）
+BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js --tags "@conversation"
+
+# 运行所有测试
+BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js
+
+# 调试模式（显示浏览器，观察执行过程）
+HEADLESS=false \
+  BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js --tags "@conversation"
+```
+
+## 一键启动脚本
+
+### 完整初始化（首次运行或需要重建）
+
+在项目根目录创建 `e2e-init.sh`：
+
+```bash
+#!/bin/bash
+set -e
+
+echo "🧹 Step 0: Cleaning up..."
+docker stop postgres-e2e 2> /dev/null || true
+docker rm postgres-e2e 2> /dev/null || true
+lsof -ti:3006 | xargs kill -9 2> /dev/null || true
+lsof -ti:5433 | xargs kill -9 2> /dev/null || true
+
+echo "🐘 Step 1: Starting PostgreSQL..."
+docker run -d --name postgres-e2e \
+  -e POSTGRES_PASSWORD=postgres \
+  -p 5433:5432 \
+  paradedb/paradedb:latest
+
+echo "⏳ Waiting for PostgreSQL..."
+until docker exec postgres-e2e pg_isready 2> /dev/null; do sleep 2; done
+echo "✅ PostgreSQL is ready!"
+
+echo "🔄 Step 2: Running migrations..."
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  bun run db:migrate
+
+echo "🔨 Step 3: Building application..."
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  KEY_VAULTS_SECRET=LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s= \
+  BETTER_AUTH_SECRET=e2e-test-secret-key-for-better-auth-32chars! \
+  NEXT_PUBLIC_ENABLE_BETTER_AUTH=1 \
+  SKIP_LINT=1 \
+  bun run build
+
+echo "✅ Initialization complete! Now run e2e-start.sh to start the server."
+```
+
+### 快速启动服务器
+
+在项目根目录创建 `e2e-start.sh`：
+
+```bash
+#!/bin/bash
+set -e
+
+echo "🧹 Cleaning up ports..."
+lsof -ti:3006 | xargs kill -9 2> /dev/null || true
+
+echo "🚀 Starting Next.js server on port 3006..."
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  KEY_VAULTS_SECRET=LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s= \
+  BETTER_AUTH_SECRET=e2e-test-secret-key-for-better-auth-32chars! \
+  NEXT_PUBLIC_ENABLE_BETTER_AUTH=1 \
+  NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION=0 \
+  S3_ACCESS_KEY_ID=e2e-mock-access-key \
+  S3_SECRET_ACCESS_KEY=e2e-mock-secret-key \
+  S3_BUCKET=e2e-mock-bucket \
+  S3_ENDPOINT=https://e2e-mock-s3.localhost \
+  bunx next start -p 3006
+```
+
+### 运行测试
+
+在 e2e 目录创建 `run-test.sh`：
+
+```bash
+#!/bin/bash
+
+# 默认参数
+TAGS="${1:-@journey}"
+HEADLESS="${HEADLESS:-true}" # 默认无头模式
+
+echo "🧪 Running E2E tests with tags: $TAGS"
+echo "   Headless: $HEADLESS"
+
+HEADLESS=$HEADLESS \
+  BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js --tags "$TAGS"
+```
+
+使用方式：
+
+```bash
+# 运行特定标签（默认无头模式）
+./run-test.sh "@conversation"
+
+# 调试模式（显示浏览器）
+HEADLESS=false ./run-test.sh "@conversation"
+```
+
+## 快速启动（假设数据库和构建已完成）
+
+```bash
+# Terminal 1: 启动服务器（项目根目录）
+DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  DATABASE_DRIVER=node \
+  KEY_VAULTS_SECRET=LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s= \
+  BETTER_AUTH_SECRET=e2e-test-secret-key-for-better-auth-32chars! \
+  NEXT_PUBLIC_ENABLE_BETTER_AUTH=1 \
+  NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION=0 \
+  S3_ACCESS_KEY_ID=e2e-mock-access-key \
+  S3_SECRET_ACCESS_KEY=e2e-mock-secret-key \
+  S3_BUCKET=e2e-mock-bucket \
+  S3_ENDPOINT=https://e2e-mock-s3.localhost \
+  bunx next start -p 3006
+
+# Terminal 2: 运行测试（e2e 目录，默认无头模式）
+cd e2e
+BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js --tags "@conversation"
+
+# 调试模式（显示浏览器）
+HEADLESS=false BASE_URL=http://localhost:3006 \
+  DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \
+  pnpm exec cucumber-js --config cucumber.config.js --tags "@conversation"
+```
+
+## 环境变量参考
+
+### 测试运行时环境变量
+
+| 变量           | 值                                                       | 说明                                                |
+| -------------- | -------------------------------------------------------- | --------------------------------------------------- |
+| `BASE_URL`     | `http://localhost:3006`                                  | 测试服务器地址                                      |
+| `DATABASE_URL` | `postgresql://postgres:postgres@localhost:5433/postgres` | 数据库连接                                          |
+| `HEADLESS`     | `true`(默认)/`false`                                     | 是否无头模式运行浏览器，设为 `false` 可观察执行过程 |
+
+### 服务器启动环境变量（全部必需）
+
+| 变量                                  | 值                                                       | 说明             |
+| ------------------------------------- | -------------------------------------------------------- | ---------------- |
+| `DATABASE_URL`                        | `postgresql://postgres:postgres@localhost:5433/postgres` | 数据库连接       |
+| `DATABASE_DRIVER`                     | `node`                                                   | 数据库驱动       |
+| `KEY_VAULTS_SECRET`                   | `LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s=`           | 密钥保险库密钥   |
+| `BETTER_AUTH_SECRET`                  | `e2e-test-secret-key-for-better-auth-32chars!`           | 认证密钥         |
+| `NEXT_PUBLIC_ENABLE_BETTER_AUTH`      | `1`                                                      | 启用 Better Auth |
+| `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION` | `0`                                                      | 禁用邮箱验证     |
+
+### S3 Mock 变量（必需！）
+
+| 变量                   | 值                              |
+| ---------------------- | ------------------------------- |
+| `S3_ACCESS_KEY_ID`     | `e2e-mock-access-key`           |
+| `S3_SECRET_ACCESS_KEY` | `e2e-mock-secret-key`           |
+| `S3_BUCKET`            | `e2e-mock-bucket`               |
+| `S3_ENDPOINT`          | `https://e2e-mock-s3.localhost` |
+
+**注意**: S3 环境变量是**必需**的，即使不测试文件上传功能。缺少这些变量会导致发送消息时报错 "S3 environment variables are not set completely"。
+
+## 常见问题排查
+
+### Docker daemon is not running
+
+**症状**: `Cannot connect to the Docker daemon`
+
+**解决**: 启动 Docker Desktop 应用
+
+### PostgreSQL 容器已存在
+
+**症状**: `docker: Error response from daemon: Conflict. The container name "/postgres-e2e" is already in use`
+
+**解决**:
+
+```bash
+docker stop postgres-e2e
+docker rm postgres-e2e
+```
+
+### S3 environment variables are not set completely
+
+**原因**: 服务器启动时缺少 S3 环境变量
+
+**解决**: 启动服务器时必须设置所有 S3 mock 变量
+
+### Cannot find module './src/libs/next/config/define-config'
+
+**原因**: 在 e2e 目录下运行 `next start`
+
+**解决**: 必须在**项目根目录**运行 `bunx next start`，不能在 e2e 目录运行
+
+### EADDRINUSE: address already in use
+
+**原因**: 端口被占用
+
+**解决**:
+
+```bash
+# 查找并杀掉占用端口的进程
+lsof -ti:3006 | xargs kill -9
+lsof -ti:5433 | xargs kill -9
+```
+
+### BeforeAll hook errored: net::ERR_CONNECTION_REFUSED
+
+**原因**: 服务器未启动或未就绪
+
+**解决**:
+
+1. 确认服务器已启动：`curl http://localhost:3006`
+2. 确认 `BASE_URL` 环境变量设置正确
+3. 等待服务器完全就绪后再运行测试
+
+### 测试超时或不稳定
+
+**可能原因**:
+
+1. 网络延迟
+2. 服务器响应慢
+3. 元素定位问题
+
+**解决**:
+
+1. 使用 `HEADLESS=false` 观察测试执行过程
+2. 检查 `screenshots/` 目录中的失败截图
+3. 增加等待时间或使用更稳定的定位器
+
+## 清理环境
+
+测试完成后，清理环境：
+
+```bash
+# 停止服务器
+lsof -ti:3006 | xargs kill -9
+
+# 停止并删除 PostgreSQL 容器
+docker stop postgres-e2e
+docker rm postgres-e2e
+```
@@ -0,0 +1,124 @@
+# 测试技巧
+
+## 页面元素定位
+
+### 富文本编辑器 (contenteditable) 输入
+
+LobeHub 使用 `@lobehub/editor` 作为聊天输入框，是一个 contenteditable 的富文本编辑器。
+
+**关键点**:
+
+1. 不能直接用 `locator.fill()` - 对 contenteditable 不生效
+2. 需要先 click 容器让编辑器获得焦点
+3. 使用 `keyboard.type()` 输入文本
+
+```typescript
+// 正确的输入方式
+await chatInputContainer.click();
+await this.page.waitForTimeout(500); // 等待焦点
+await this.page.keyboard.type(message, { delay: 30 });
+await this.page.keyboard.press('Enter'); // 发送
+```
+
+### 添加 data-testid
+
+为了更可靠的元素定位，可以在组件上添加 `data-testid`：
+
+```tsx
+// src/features/ChatInput/Desktop/index.tsx
+<ChatInput
+  data-testid="chat-input"
+  ...
+/>
+```
+
+## 调试技巧
+
+### 添加步骤日志
+
+在每个关键步骤添加 console.log，帮助定位问题：
+
+```typescript
+Given('用户进入页面', async function (this: CustomWorld) {
+  console.log('   📍 Step: 导航到首页...');
+  await this.page.goto('/');
+
+  console.log('   📍 Step: 查找元素...');
+  const element = this.page.locator('...');
+
+  console.log('   ✅ 步骤完成');
+});
+```
+
+### 查看失败截图
+
+测试失败时会自动保存截图到 `e2e/screenshots/` 目录。
+
+### 非 headless 模式
+
+设置 `HEADLESS=false` 可以看到浏览器操作：
+
+```bash
+HEADLESS=false pnpm exec cucumber-js --config cucumber.config.js --tags "@smoke"
+```
+
+## 常见问题
+
+### waitForLoadState ('networkidle') 超时
+
+**原因**: `networkidle` 表示 500ms 内没有网络请求。在 CI 环境中，由于分析脚本、外部资源加载、轮询等持续网络活动，这个状态可能永远无法达到。
+
+**错误示例**:
+
+```
+page.waitForLoadState: Timeout 10000ms exceeded.
+=========================== logs ===========================
+  "load" event fired
+============================================================
+```
+
+**解决**:
+
+- **避免使用 `networkidle`** - 这是不可靠的等待策略
+- **直接等待目标元素** - 使用 `expect(element).toBeVisible({ timeout: 30_000 })` 替代
+- 如果必须等待页面加载完成，使用 `domcontentloaded` 或 `load` 事件
+
+```typescript
+// ❌ 不推荐 - networkidle 在 CI 中容易超时
+await this.page.waitForLoadState('networkidle', { timeout: 10_000 });
+const element = this.page.locator('[data-testid="my-element"]');
+await expect(element).toBeVisible();
+
+// ✅ 推荐 - 直接等待目标元素
+const element = this.page.locator('[data-testid="my-element"]');
+await expect(element).toBeVisible({ timeout: 30_000 });
+```
+
+### 测试超时 (function timed out)
+
+**原因**: 元素定位失败或等待时间不足
+
+**解决**:
+
+- 检查选择器是否正确
+- 增加 timeout 参数
+- 添加显式等待 `waitForTimeout()`
+
+### strict mode violation (多个元素匹配)
+
+**原因**: 选择器匹配到多个元素（如 desktop/mobile 双组件）
+
+**解决**:
+
+- 使用 `.first()` 或 `.nth(n)`
+- 使用 `boundingBox()` 过滤可见元素
+
+### 输入框内容为空
+
+**原因**: contenteditable 编辑器的特殊性
+
+**解决**:
+
+- 先 click 容器确保焦点
+- 使用 `keyboard.type()` 而非 `fill()`
+- 添加适当的等待时间
@@ -4,7 +4,9 @@
  "private": true,
  "description": "E2E tests for LobeChat using Cucumber and Playwright",
  "scripts": {
+    "build": "cd .. && bun run build",
    "test": "cucumber-js --config cucumber.config.js",
+    "test:ci": "bun run build && bun run test",
    "test:discover": "cucumber-js --config cucumber.config.js src/features/discover/",
    "test:headed": "HEADLESS=false cucumber-js --config cucumber.config.js",
    "test:routes": "cucumber-js --config cucumber.config.js --tags '@routes'",
@@ -14,6 +16,8 @@
  "dependencies": {
    "@cucumber/cucumber": "^12.2.0",
    "@playwright/test": "^1.57.0",
+    "bcryptjs": "^3.0.3",
+    "pg": "^8.16.0",
    "playwright": "^1.57.0"
  },
  "devDependencies": {
@@ -11,7 +11,7 @@ Feature: Discover Detail Pages

  @DISCOVER-DETAIL-001 @P1
  Scenario: Load assistant detail page and verify content
-    Given I navigate to "/discover/assistant"
+    Given I navigate to "/community/assistant"
    And I wait for the page to fully load
    When I click on the first assistant card
    Then I should be on an assistant detail page
@@ -22,7 +22,7 @@ Feature: Discover Detail Pages

  @DISCOVER-DETAIL-002 @P1
  Scenario: Navigate back from assistant detail page
-    Given I navigate to "/discover/assistant"
+    Given I navigate to "/community/assistant"
    And I wait for the page to fully load
    And I click on the first assistant card
    When I click the back button
@@ -34,7 +34,7 @@ Feature: Discover Detail Pages

  @DISCOVER-DETAIL-003 @P1
  Scenario: Load model detail page and verify content
-    Given I navigate to "/discover/model"
+    Given I navigate to "/community/model"
    And I wait for the page to fully load
    When I click on the first model card
    Then I should be on a model detail page
@@ -44,7 +44,7 @@ Feature: Discover Detail Pages

  @DISCOVER-DETAIL-004 @P1
  Scenario: Navigate back from model detail page
-    Given I navigate to "/discover/model"
+    Given I navigate to "/community/model"
    And I wait for the page to fully load
    And I click on the first model card
    When I click the back button
@@ -56,7 +56,7 @@ Feature: Discover Detail Pages

  @DISCOVER-DETAIL-005 @P1
  Scenario: Load provider detail page and verify content
-    Given I navigate to "/discover/provider"
+    Given I navigate to "/community/provider"
    And I wait for the page to fully load
    When I click on the first provider card
    Then I should be on a provider detail page
@@ -66,7 +66,7 @@ Feature: Discover Detail Pages

  @DISCOVER-DETAIL-006 @P1
  Scenario: Navigate back from provider detail page
-    Given I navigate to "/discover/provider"
+    Given I navigate to "/community/provider"
    And I wait for the page to fully load
    And I click on the first provider card
    When I click the back button
@@ -78,7 +78,7 @@ Feature: Discover Detail Pages

  @DISCOVER-DETAIL-007 @P1
  Scenario: Load MCP detail page and verify content
-    Given I navigate to "/discover/mcp"
+    Given I navigate to "/community/mcp"
    And I wait for the page to fully load
    When I click on the first MCP card
    Then I should be on an MCP detail page
@@ -88,7 +88,7 @@ Feature: Discover Detail Pages

  @DISCOVER-DETAIL-008 @P1
  Scenario: Navigate back from MCP detail page
-    Given I navigate to "/discover/mcp"
+    Given I navigate to "/community/mcp"
    And I wait for the page to fully load
    And I click on the first MCP card
    When I click the back button
@@ -11,14 +11,14 @@ Feature: Discover Interactions

  @DISCOVER-INTERACT-001 @P1
  Scenario: Search for assistants
-    Given I navigate to "/discover/assistant"
+    Given I navigate to "/community/assistant"
    When I type "developer" in the search bar
    And I wait for the search results to load
    Then I should see filtered assistant cards

  @DISCOVER-INTERACT-002 @P1
  Scenario: Filter assistants by category
-    Given I navigate to "/discover/assistant"
+    Given I navigate to "/community/assistant"
    When I click on a category in the category menu
    And I wait for the filtered results to load
    Then I should see assistant cards filtered by the selected category
@@ -26,7 +26,7 @@ Feature: Discover Interactions

  @DISCOVER-INTERACT-003 @P1
  Scenario: Navigate to next page of assistants
-    Given I navigate to "/discover/assistant"
+    Given I navigate to "/community/assistant"
    When I click the next page button
    And I wait for the next page to load
    Then I should see different assistant cards
@@ -34,7 +34,7 @@ Feature: Discover Interactions

  @DISCOVER-INTERACT-004 @P1
  Scenario: Navigate to assistant detail page
-    Given I navigate to "/discover/assistant"
+    Given I navigate to "/community/assistant"
    When I click on the first assistant card
    Then I should be navigated to the assistant detail page
    And I should see the assistant detail content
@@ -45,7 +45,7 @@ Feature: Discover Interactions

  @DISCOVER-INTERACT-005 @P1
  Scenario: Sort models
-    Given I navigate to "/discover/model"
+    Given I navigate to "/community/model"
    When I click on the sort dropdown
    And I select a sort option
    And I wait for the sorted results to load
@@ -53,7 +53,7 @@ Feature: Discover Interactions

  @DISCOVER-INTERACT-006 @P1
  Scenario: Navigate to model detail page
-    Given I navigate to "/discover/model"
+    Given I navigate to "/community/model"
    When I click on the first model card
    Then I should be navigated to the model detail page
    And I should see the model detail content
@@ -64,7 +64,7 @@ Feature: Discover Interactions

  @DISCOVER-INTERACT-007 @P1
  Scenario: Navigate to provider detail page
-    Given I navigate to "/discover/provider"
+    Given I navigate to "/community/provider"
    When I click on the first provider card
    Then I should be navigated to the provider detail page
    And I should see the provider detail content
@@ -75,14 +75,14 @@ Feature: Discover Interactions

  @DISCOVER-INTERACT-008 @P1
  Scenario: Filter MCP tools by category
-    Given I navigate to "/discover/mcp"
+    Given I navigate to "/community/mcp"
    When I click on a category in the category filter
    And I wait for the filtered results to load
    Then I should see MCP cards filtered by the selected category

  @DISCOVER-INTERACT-009 @P1
  Scenario: Navigate to MCP detail page
-    Given I navigate to "/discover/mcp"
+    Given I navigate to "/community/mcp"
    When I click on the first MCP card
    Then I should be navigated to the MCP detail page
    And I should see the MCP detail content
@@ -93,21 +93,21 @@ Feature: Discover Interactions

  @DISCOVER-INTERACT-010 @P1
  Scenario: Navigate from home to assistant list
-    Given I navigate to "/discover"
+    Given I navigate to "/community"
    When I click on the "more" link in the featured assistants section
-    Then I should be navigated to "/discover/assistant"
+    Then I should be navigated to "/community/assistant"
    And I should see the page body

  @DISCOVER-INTERACT-011 @P1
  Scenario: Navigate from home to MCP list
-    Given I navigate to "/discover"
+    Given I navigate to "/community"
    When I click on the "more" link in the featured MCP tools section
-    Then I should be navigated to "/discover/mcp"
+    Then I should be navigated to "/community/mcp"
    And I should see the page body

  @DISCOVER-INTERACT-012 @P1
  Scenario: Click featured assistant from home
-    Given I navigate to "/discover"
+    Given I navigate to "/community"
    When I click on the first featured assistant card
    Then I should be navigated to the assistant detail page
    And I should see the assistant detail content
@@ -1,10 +1,10 @@
@discover @smoke
-Feature: Discover Smoke Tests
-  Critical path tests to ensure the discover module is functional
+Feature: Community Smoke Tests
+  Critical path tests to ensure the community/discover module is functional

  @DISCOVER-SMOKE-001 @P0
-  Scenario: Load Discover Home Page
-    Given I navigate to "/discover"
+  Scenario: Load Community Home Page
+    Given I navigate to "/community"
    Then the page should load without errors
    And I should see the page body
    And I should see the featured assistants section
@@ -12,7 +12,7 @@ Feature: Discover Smoke Tests

  @DISCOVER-SMOKE-002 @P0
  Scenario: Load Assistant List Page
-    Given I navigate to "/discover/assistant"
+    Given I navigate to "/community/assistant"
    Then the page should load without errors
    And I should see the page body
    And I should see the search bar
@@ -22,7 +22,7 @@ Feature: Discover Smoke Tests

  @DISCOVER-SMOKE-003 @P0
  Scenario: Load Model List Page
-    Given I navigate to "/discover/model"
+    Given I navigate to "/community/model"
    Then the page should load without errors
    And I should see the page body
    And I should see model cards
@@ -30,14 +30,14 @@ Feature: Discover Smoke Tests

  @DISCOVER-SMOKE-004 @P0
  Scenario: Load Provider List Page
-    Given I navigate to "/discover/provider"
+    Given I navigate to "/community/provider"
    Then the page should load without errors
    And I should see the page body
    And I should see provider cards

  @DISCOVER-SMOKE-005 @P0
  Scenario: Load MCP List Page
-    Given I navigate to "/discover/mcp"
+    Given I navigate to "/community/mcp"
    Then the page should load without errors
    And I should see the page body
    And I should see MCP cards
@@ -0,0 +1,45 @@
+@journey @agent @conversation-mgmt
+Feature: Agent 对话管理用户体验链路
+  作为用户，我希望能够管理我的对话历史
+
+  Background:
+    Given 用户已登录系统
+    And 用户进入 Lobe AI 对话页面
+
+  @AGENT-CONV-001 @P0
+  Scenario: 创建新对话
+    Given 用户已有一个对话
+    When 用户点击新建对话按钮
+    Then 应该创建一个新的空白对话
+    And 页面应该显示欢迎界面
+
+  @AGENT-CONV-002 @P0
+  Scenario: 切换不同对话
+    Given 用户有多个对话历史
+    When 用户点击另一个对话
+    Then 应该切换到该对话
+    And 显示该对话的历史消息
+
+  @AGENT-CONV-003 @P0
+  Scenario: 重命名对话
+    Given 用户已有一个对话
+    When 用户右键点击对话
+    And 用户选择重命名选项
+    And 用户输入新的对话名称 "测试对话"
+    Then 对话名称应该更新为 "测试对话"
+
+  @AGENT-CONV-004 @P0
+  Scenario: 删除对话
+    Given 用户有多个对话历史
+    When 用户右键点击一个对话
+    And 用户选择删除选项
+    And 用户确认删除
+    Then 该对话应该被删除
+    And 对话列表中不再显示该对话
+
+  @AGENT-CONV-005 @P1
+  Scenario: 搜索历史对话
+    Given 用户有多个对话历史
+    When 用户在搜索框中输入 "测试"
+    Then 应该显示包含 "测试" 的对话
+    And 不相关的对话应该被过滤
@@ -0,0 +1,13 @@
+@journey @agent @conversation
+Feature: Agent 对话用户体验链路
+  作为用户，我希望能够与 AI 助手进行流畅的对话
+
+  Background:
+    Given 用户已登录系统
+
+  @AGENT-CHAT-001 @P0 @smoke
+  Scenario: 使用 Lobe AI 发送消息并获得回复
+    Given 用户进入 Lobe AI 对话页面
+    When 用户发送消息 "hello"
+    Then 用户应该收到助手的回复
+    And 回复内容应该可见
@@ -0,0 +1,36 @@
+@journey @agent @message-ops
+Feature: Agent 消息操作用户体验链路
+  作为用户，我希望能够对消息进行各种操作
+
+  Background:
+    Given 用户已登录系统
+    And 用户进入 Lobe AI 对话页面
+    And 用户已发送消息 "hello"
+
+  @AGENT-MSG-001 @P1
+  Scenario: 复制消息内容
+    When 用户点击消息的复制按钮
+    Then 消息内容应该被复制到剪贴板
+
+  @AGENT-MSG-002 @P1
+  Scenario: 编辑助手消息
+    When 用户点击助手消息的编辑按钮
+    And 用户修改消息内容为 "这是编辑后的内容"
+    And 用户保存编辑
+    Then 消息内容应该更新为 "这是编辑后的内容"
+
+  @AGENT-MSG-003 @P1
+  Scenario: 删除单条消息
+    When 用户点击消息的更多操作按钮
+    And 用户选择删除消息选项
+    And 用户确认删除消息
+    Then 该消息应该从对话中移除
+
+  @AGENT-MSG-004 @P1
+  Scenario: 折叠和展开消息
+    When 用户点击消息的更多操作按钮
+    And 用户选择折叠消息选项
+    Then 消息内容应该被折叠
+    When 用户点击消息的更多操作按钮
+    And 用户选择展开消息选项
+    Then 消息内容应该完整显示
@@ -0,0 +1,212 @@
+/**
+ * Mock data for Discover/Community module
+ */
+import type {
+  AssistantListResponse,
+  McpListResponse,
+  ModelListResponse,
+  ProviderListResponse,
+} from './types';
+
+// ============================================
+// Assistant Mock Data
+// ============================================
+
+export const mockAssistantList: AssistantListResponse = {
+  items: [
+    {
+      author: 'LobeHub',
+      avatar: '🤖',
+      backgroundColor: '#1890ff',
+      category: 'general',
+      createdAt: '2024-01-01T00:00:00.000Z',
+      description: 'A versatile AI assistant for general tasks and conversations.',
+      identifier: 'general-assistant',
+      installCount: 1000,
+      knowledgeCount: 5,
+      pluginCount: 3,
+      title: 'General Assistant',
+      tokenUsage: 4096,
+      userName: 'lobehub',
+    },
+    {
+      author: 'LobeHub',
+      avatar: '💻',
+      backgroundColor: '#52c41a',
+      category: 'programming',
+      createdAt: '2024-01-02T00:00:00.000Z',
+      description: 'Expert coding assistant for software development.',
+      identifier: 'code-assistant',
+      installCount: 800,
+      knowledgeCount: 10,
+      pluginCount: 5,
+      title: 'Code Assistant',
+      tokenUsage: 8192,
+      userName: 'lobehub',
+    },
+    {
+      author: 'LobeHub',
+      avatar: '✍️',
+      backgroundColor: '#722ed1',
+      category: 'copywriting',
+      createdAt: '2024-01-03T00:00:00.000Z',
+      description: 'Professional writing assistant for content creation.',
+      identifier: 'writing-assistant',
+      installCount: 600,
+      knowledgeCount: 3,
+      pluginCount: 2,
+      title: 'Writing Assistant',
+      tokenUsage: 4096,
+      userName: 'lobehub',
+    },
+  ],
+  pagination: {
+    page: 1,
+    pageSize: 12,
+    total: 3,
+    totalPages: 1,
+  },
+};
+
+export const mockAssistantCategories = [
+  { id: 'general', name: 'General' },
+  { id: 'programming', name: 'Programming' },
+  { id: 'copywriting', name: 'Copywriting' },
+  { id: 'education', name: 'Education' },
+];
+
+// ============================================
+// Model Mock Data
+// ============================================
+
+export const mockModelList: ModelListResponse = {
+  items: [
+    {
+      abilities: { functionCall: true, reasoning: true, vision: true },
+      contextWindowTokens: 128_000,
+      createdAt: '2024-01-01T00:00:00.000Z',
+      description: 'Most capable model for complex tasks',
+      displayName: 'GPT-4o',
+      id: 'gpt-4o',
+      providerId: 'openai',
+      providerName: 'OpenAI',
+      type: 'chat',
+    },
+    {
+      abilities: { functionCall: true, reasoning: true, vision: false },
+      contextWindowTokens: 200_000,
+      createdAt: '2024-01-02T00:00:00.000Z',
+      description: 'Advanced AI assistant by Anthropic',
+      displayName: 'Claude 3.5 Sonnet',
+      id: 'claude-3-5-sonnet-20241022',
+      providerId: 'anthropic',
+      providerName: 'Anthropic',
+      type: 'chat',
+    },
+    {
+      abilities: { functionCall: false, reasoning: false, vision: false },
+      contextWindowTokens: 32_768,
+      createdAt: '2024-01-03T00:00:00.000Z',
+      description: 'Open source language model',
+      displayName: 'Llama 3.1 70B',
+      id: 'llama-3.1-70b',
+      providerId: 'meta',
+      providerName: 'Meta',
+      type: 'chat',
+    },
+  ],
+  pagination: {
+    page: 1,
+    pageSize: 12,
+    total: 3,
+    totalPages: 1,
+  },
+};
+
+// ============================================
+// Provider Mock Data
+// ============================================
+
+export const mockProviderList: ProviderListResponse = {
+  items: [
+    {
+      description: 'Leading AI research company',
+      id: 'openai',
+      logo: 'https://example.com/openai.png',
+      modelCount: 10,
+      name: 'OpenAI',
+    },
+    {
+      description: 'AI safety focused research company',
+      id: 'anthropic',
+      logo: 'https://example.com/anthropic.png',
+      modelCount: 5,
+      name: 'Anthropic',
+    },
+    {
+      description: 'Open source AI leader',
+      id: 'meta',
+      logo: 'https://example.com/meta.png',
+      modelCount: 8,
+      name: 'Meta',
+    },
+  ],
+  pagination: {
+    page: 1,
+    pageSize: 12,
+    total: 3,
+    totalPages: 1,
+  },
+};
+
+// ============================================
+// MCP Mock Data
+// ============================================
+
+export const mockMcpList: McpListResponse = {
+  items: [
+    {
+      author: 'LobeHub',
+      avatar: '🔍',
+      category: 'search',
+      createdAt: '2024-01-01T00:00:00.000Z',
+      description: 'Web search capabilities for AI assistants',
+      identifier: 'web-search',
+      installCount: 500,
+      title: 'Web Search',
+    },
+    {
+      author: 'LobeHub',
+      avatar: '📁',
+      category: 'file',
+      createdAt: '2024-01-02T00:00:00.000Z',
+      description: 'File system operations and management',
+      identifier: 'file-manager',
+      installCount: 300,
+      title: 'File Manager',
+    },
+    {
+      author: 'LobeHub',
+      avatar: '🗄️',
+      category: 'database',
+      createdAt: '2024-01-03T00:00:00.000Z',
+      description: 'Database query and management tools',
+      identifier: 'db-tools',
+      installCount: 200,
+      title: 'Database Tools',
+    },
+  ],
+  pagination: {
+    page: 1,
+    pageSize: 12,
+    total: 3,
+    totalPages: 1,
+  },
+};
+
+export const mockMcpCategories = [
+  { id: 'search', name: 'Search' },
+  { id: 'file', name: 'File' },
+  { id: 'database', name: 'Database' },
+  { id: 'utility', name: 'Utility' },
+];
@@ -0,0 +1,179 @@
+/**
+ * Mock handlers for Discover/Community API endpoints
+ */
+import type { Route } from 'playwright';
+
+import { type MockHandler, createTrpcResponse } from '../index';
+import {
+  mockAssistantCategories,
+  mockAssistantList,
+  mockMcpCategories,
+  mockMcpList,
+  mockModelList,
+  mockProviderList,
+} from './data';
+
+// ============================================
+// Helper to parse tRPC batch requests
+// ============================================
+
+function parseTrpcUrl(url: string): { input?: Record<string, unknown>; procedure: string } {
+  const urlObj = new URL(url);
+  const pathname = urlObj.pathname;
+
+  // Extract procedure name from path like /trpc/lambda.market.getAssistantList
+  const procedureMatch = pathname.match(/lambda\.market\.(\w+)/);
+  const procedure = procedureMatch ? procedureMatch[1] : '';
+
+  // Parse input from query string
+  let input: Record<string, unknown> | undefined;
+  const inputParam = urlObj.searchParams.get('input');
+  if (inputParam) {
+    try {
+      input = JSON.parse(inputParam);
+    } catch {
+      // Ignore parse errors
+    }
+  }
+
+  return { input, procedure };
+}
+
+// ============================================
+// Mock Handlers
+// ============================================
+
+/**
+ * Handler for assistant list endpoint
+ */
+const assistantListHandler: MockHandler = {
+  handler: async (route: Route) => {
+    await route.fulfill({
+      body: createTrpcResponse(mockAssistantList),
+      contentType: 'application/json',
+      status: 200,
+    });
+  },
+  pattern: '**/trpc/lambda/market.getAssistantList**',
+};
+
+/**
+ * Handler for assistant categories endpoint
+ */
+const assistantCategoriesHandler: MockHandler = {
+  handler: async (route: Route) => {
+    await route.fulfill({
+      body: createTrpcResponse(mockAssistantCategories),
+      contentType: 'application/json',
+      status: 200,
+    });
+  },
+  pattern: '**/trpc/lambda/market.getAssistantCategories**',
+};
+
+/**
+ * Handler for model list endpoint
+ */
+const modelListHandler: MockHandler = {
+  handler: async (route: Route) => {
+    await route.fulfill({
+      body: createTrpcResponse(mockModelList),
+      contentType: 'application/json',
+      status: 200,
+    });
+  },
+  pattern: '**/trpc/lambda/market.getModelList**',
+};
+
+/**
+ * Handler for provider list endpoint
+ */
+const providerListHandler: MockHandler = {
+  handler: async (route: Route) => {
+    await route.fulfill({
+      body: createTrpcResponse(mockProviderList),
+      contentType: 'application/json',
+      status: 200,
+    });
+  },
+  pattern: '**/trpc/lambda/market.getProviderList**',
+};
+
+/**
+ * Handler for MCP list endpoint
+ */
+const mcpListHandler: MockHandler = {
+  handler: async (route: Route) => {
+    await route.fulfill({
+      body: createTrpcResponse(mockMcpList),
+      contentType: 'application/json',
+      status: 200,
+    });
+  },
+  pattern: '**/trpc/lambda/market.getMcpList**',
+};
+
+/**
+ * Handler for MCP categories endpoint
+ */
+const mcpCategoriesHandler: MockHandler = {
+  handler: async (route: Route) => {
+    await route.fulfill({
+      body: createTrpcResponse(mockMcpCategories),
+      contentType: 'application/json',
+      status: 200,
+    });
+  },
+  pattern: '**/trpc/lambda/market.getMcpCategories**',
+};
+
+/**
+ * Debug handler to log all trpc requests
+ */
+const trpcDebugHandler: MockHandler = {
+  handler: async (route: Route) => {
+    const url = route.request().url();
+    console.log(`   🔍 TRPC Request: ${url}`);
+    await route.continue();
+  },
+  pattern: '**/trpc/**',
+};
+
+/**
+ * Fallback handler for any unhandled market endpoints
+ * Returns empty data to prevent hanging requests
+ */
+const marketFallbackHandler: MockHandler = {
+  handler: async (route: Route) => {
+    const url = route.request().url();
+    const { procedure } = parseTrpcUrl(url);
+
+    console.log(`   ⚠️ Unhandled market endpoint: ${procedure}`);
+
+    // Return empty response to prevent timeout
+    await route.fulfill({
+      body: createTrpcResponse({ items: [], pagination: { page: 1, pageSize: 12, total: 0 } }),
+      contentType: 'application/json',
+      status: 200,
+    });
+  },
+  pattern: '**/trpc/lambda/market.**',
+};
+
+// ============================================
+// Export all handlers
+// ============================================
+
+export const discoverHandlers: MockHandler[] = [
+  // Debug handler first to log all requests
+  trpcDebugHandler,
+  // Specific handlers (order matters - more specific first)
+  assistantListHandler,
+  assistantCategoriesHandler,
+  modelListHandler,
+  providerListHandler,
+  mcpListHandler,
+  mcpCategoriesHandler,
+  // Fallback handler (should be last)
+  marketFallbackHandler,
+];
@@ -0,0 +1,7 @@
+/**
+ * Discover/Community module mocks
+ */
+
+export * from './data';
+export { discoverHandlers as discoverMocks } from './handlers';
+export * from './types';
@@ -0,0 +1,98 @@
+/**
+ * Type definitions for Discover mock data
+ * These mirror the actual types from the application
+ */
+
+export interface PaginationInfo {
+  page: number;
+  pageSize: number;
+  total: number;
+  totalPages: number;
+}
+
+// ============================================
+// Assistant Types
+// ============================================
+
+export interface DiscoverAssistantItem {
+  author: string;
+  avatar: string;
+  backgroundColor?: string;
+  category: string;
+  createdAt: string;
+  description: string;
+  identifier: string;
+  installCount?: number;
+  knowledgeCount?: number;
+  pluginCount?: number;
+  title: string;
+  tokenUsage?: number;
+  userName?: string;
+}
+
+export interface AssistantListResponse {
+  items: DiscoverAssistantItem[];
+  pagination: PaginationInfo;
+}
+
+// ============================================
+// Model Types
+// ============================================
+
+export interface DiscoverModelItem {
+  abilities: {
+    functionCall?: boolean;
+    reasoning?: boolean;
+    vision?: boolean;
+  };
+  contextWindowTokens: number;
+  createdAt: string;
+  description: string;
+  displayName: string;
+  id: string;
+  providerId: string;
+  providerName: string;
+  type: string;
+}
+
+export interface ModelListResponse {
+  items: DiscoverModelItem[];
+  pagination: PaginationInfo;
+}
+
+// ============================================
+// Provider Types
+// ============================================
+
+export interface DiscoverProviderItem {
+  description: string;
+  id: string;
+  logo?: string;
+  modelCount: number;
+  name: string;
+}
+
+export interface ProviderListResponse {
+  items: DiscoverProviderItem[];
+  pagination: PaginationInfo;
+}
+
+// ============================================
+// MCP Types
+// ============================================
+
+export interface DiscoverMcpItem {
+  author: string;
+  avatar: string;
+  category: string;
+  createdAt: string;
+  description: string;
+  identifier: string;
+  installCount?: number;
+  title: string;
+}
+
+export interface McpListResponse {
+  items: DiscoverMcpItem[];
+  pagination: PaginationInfo;
+}
@@ -0,0 +1,158 @@
+/**
+ * E2E Mock Framework
+ *
+ * This module provides a centralized way to mock API responses in E2E tests.
+ * It uses Playwright's route interception to mock tRPC and REST API calls.
+ */
+import type { Page, Route } from 'playwright';
+
+import { discoverMocks } from './discover';
+
+// ============================================
+// Types
+// ============================================
+
+export interface MockHandler {
+  /** Optional: only apply this mock when condition is true */
+  enabled?: boolean;
+  /** Handler function to process the request */
+  handler: (route: Route, request: Request) => Promise<void>;
+  /** URL pattern to match (supports wildcards) */
+  pattern: string | RegExp;
+}
+
+export interface MockConfig {
+  /** Enable/disable all mocks globally */
+  enabled: boolean;
+  /** Mock handlers grouped by domain */
+  handlers: Record<string, MockHandler[]>;
+}
+
+// ============================================
+// Default Configuration
+// ============================================
+
+const defaultConfig: MockConfig = {
+  enabled: true,
+  handlers: {
+    discover: discoverMocks,
+    // Add more domains here as needed:
+    // user: userMocks,
+    // chat: chatMocks,
+  },
+};
+
+// ============================================
+// Mock Manager
+// ============================================
+
+export class MockManager {
+  private config: MockConfig;
+  private page: Page | null = null;
+
+  constructor(config: Partial<MockConfig> = {}) {
+    this.config = { ...defaultConfig, ...config };
+  }
+
+  /**
+   * Setup all mock handlers for a page
+   */
+  async setup(page: Page): Promise<void> {
+    this.page = page;
+
+    if (!this.config.enabled) {
+      console.log('🔇 Mocks disabled');
+      return;
+    }
+
+    console.log('🎭 Setting up API mocks...');
+
+    for (const [domain, handlers] of Object.entries(this.config.handlers)) {
+      for (const mock of handlers) {
+        if (mock.enabled === false) continue;
+
+        await page.route(mock.pattern, async (route) => {
+          try {
+            await mock.handler(route, route.request() as unknown as Request);
+          } catch (error) {
+            console.error(`Mock handler error for ${mock.pattern}:`, error);
+            await route.continue();
+          }
+        });
+      }
+      console.log(`   ✓ ${domain} mocks registered`);
+    }
+  }
+
+  /**
+   * Disable a specific mock domain
+   */
+  disableDomain(domain: string): void {
+    if (this.config.handlers[domain]) {
+      for (const handler of this.config.handlers[domain]) {
+        handler.enabled = false;
+      }
+    }
+  }
+
+  /**
+   * Enable a specific mock domain
+   */
+  enableDomain(domain: string): void {
+    if (this.config.handlers[domain]) {
+      for (const handler of this.config.handlers[domain]) {
+        handler.enabled = true;
+      }
+    }
+  }
+
+  /**
+   * Add custom mock handlers at runtime
+   */
+  addHandlers(domain: string, handlers: MockHandler[]): void {
+    if (!this.config.handlers[domain]) {
+      this.config.handlers[domain] = [];
+    }
+    this.config.handlers[domain].push(...handlers);
+  }
+}
+
+// ============================================
+// Helper Functions
+// ============================================
+
+/**
+ * Create a JSON response for tRPC endpoints
+ */
+export function createTrpcResponse<T>(data: T): string {
+  return JSON.stringify({
+    result: {
+      data,
+    },
+  });
+}
+
+/**
+ * Create an error response for tRPC endpoints
+ */
+export function createTrpcError(message: string, code = 'INTERNAL_SERVER_ERROR'): string {
+  return JSON.stringify({
+    error: {
+      code,
+      message,
+    },
+  });
+}
+
+/**
+ * Create a standard JSON response
+ */
+export function createJsonResponse<T>(data: T): string {
+  return JSON.stringify(data);
+}
+
+// ============================================
+// Singleton Instance
+// ============================================
+
+export const mockManager = new MockManager();
@@ -0,0 +1,245 @@
+/**
+ * LLM Mock Framework
+ *
+ * Intercepts /webapi/chat/[provider] requests and returns mock SSE responses.
+ * This allows E2E tests to run without real LLM API calls.
+ */
+import type { Page, Route } from 'playwright';
+
+// ============================================
+// Types
+// ============================================
+
+export interface LLMMockConfig {
+  /** Default response content when no specific mock is set */
+  defaultResponse: string;
+  /** Whether to enable LLM mocking */
+  enabled: boolean;
+  /** Response delay in ms (simulates network latency) */
+  responseDelay: number;
+  /** Chunk size for streaming (characters per chunk) */
+  streamChunkSize: number;
+  /** Delay between chunks in ms */
+  streamDelay: number;
+}
+
+export interface ChatMessage {
+  content: string;
+  role: 'user' | 'assistant' | 'system';
+}
+
+// ============================================
+// Default Configuration
+// ============================================
+
+const defaultConfig: LLMMockConfig = {
+  defaultResponse: 'Hello! I am a mock AI assistant. How can I help you today?',
+  enabled: true,
+  responseDelay: 100,
+  streamChunkSize: 10,
+  streamDelay: 20,
+};
+
+// ============================================
+// SSE Response Builder
+// ============================================
+
+/**
+ * Build SSE formatted response chunks
+ * Follows LobeChat's actual streaming format
+ */
+function buildSSEChunks(content: string, chunkSize: number): string[] {
+  const chunks: string[] = [];
+  const id = `msg_mock_${Date.now()}`;
+
+  // Initial message data
+  const initialData = {
+    content: [],
+    id,
+    model: 'gpt-4o-mini',
+    role: 'assistant',
+    stop_reason: null,
+    stop_sequence: null,
+    type: 'message',
+    usage: { input_tokens: 10, output_tokens: 0 },
+  };
+  chunks.push(`id: ${id}\nevent: data\ndata: ${JSON.stringify(initialData)}\n\n`);
+
+  // Split content into chunks and send as text events
+  for (let i = 0; i < content.length; i += chunkSize) {
+    const chunk = content.slice(i, i + chunkSize);
+    chunks.push(`id: ${id}\nevent: text\ndata: "${chunk.replaceAll('"', '\\"')}"\n\n`);
+  }
+
+  // Stop event
+  chunks.push(`id: ${id}\nevent: stop\ndata: "end_turn"\n\n`);
+
+  // Usage event
+  const usageData = {
+    cost: 0.0001,
+    inputCacheMissTokens: 10,
+    inputCachedTokens: 0,
+    totalInputTokens: 10,
+    totalOutputTokens: Math.ceil(content.length / 4),
+    totalTokens: 10 + Math.ceil(content.length / 4),
+  };
+  chunks.push(
+    `id: ${id}\nevent: usage\ndata: ${JSON.stringify(usageData)}\n\n`,
+    `id: ${id}\nevent: stop\ndata: "message_stop"\n\n`,
+  );
+
+  return chunks;
+}
+
+// ============================================
+// LLM Mock Manager
+// ============================================
+
+export class LLMMockManager {
+  private config: LLMMockConfig;
+  private customResponses: Map<string, string> = new Map();
+  private page: Page | null = null;
+
+  constructor(config: Partial<LLMMockConfig> = {}) {
+    this.config = { ...defaultConfig, ...config };
+  }
+
+  /**
+   * Set a custom response for a specific user message
+   */
+  setResponse(userMessage: string, response: string): void {
+    this.customResponses.set(userMessage.toLowerCase().trim(), response);
+  }
+
+  /**
+   * Clear all custom responses
+   */
+  clearResponses(): void {
+    this.customResponses.clear();
+  }
+
+  /**
+   * Get response for a user message
+   */
+  private getResponse(messages: ChatMessage[]): string {
+    // Find the last user message
+    const lastUserMessage = [...messages].reverse().find((m) => m.role === 'user');
+
+    if (lastUserMessage) {
+      const key = lastUserMessage.content.toLowerCase().trim();
+      if (this.customResponses.has(key)) {
+        return this.customResponses.get(key)!;
+      }
+    }
+
+    return this.config.defaultResponse;
+  }
+
+  /**
+   * Setup LLM mock handlers for a page
+   */
+  async setup(page: Page): Promise<void> {
+    this.page = page;
+
+    if (!this.config.enabled) {
+      console.log('   🔇 LLM mocks disabled');
+      return;
+    }
+
+    // Intercept OpenAI chat API requests
+    await page.route('**/webapi/chat/openai**', async (route) => {
+      await this.handleChatRequest(route);
+    });
+
+    console.log('   ✓ LLM mocks registered (openai)');
+  }
+
+  /**
+   * Handle intercepted chat request
+   */
+  private async handleChatRequest(route: Route): Promise<void> {
+    const request = route.request();
+
+    try {
+      // Parse request body
+      const body = request.postDataJSON();
+      const messages: ChatMessage[] = body?.messages || [];
+
+      console.log(`   🤖 LLM Request intercepted (${messages.length} messages)`);
+
+      // Get response content
+      const responseContent = this.getResponse(messages);
+
+      // Build SSE chunks
+      const chunks = buildSSEChunks(responseContent, this.config.streamChunkSize);
+
+      // Simulate initial delay
+      await new Promise((resolve) => {
+        setTimeout(resolve, this.config.responseDelay);
+      });
+
+      // Create streaming response
+      const stream = chunks.join('');
+
+      await route.fulfill({
+        body: stream,
+        headers: {
+          'Cache-Control': 'no-cache',
+          'Connection': 'keep-alive',
+          'Content-Type': 'text/event-stream',
+        },
+        status: 200,
+      });
+
+      console.log(`   ✅ LLM Response sent (${responseContent.length} chars)`);
+    } catch (error) {
+      console.error('   ❌ LLM Mock error:', error);
+      await route.fulfill({
+        body: JSON.stringify({ error: 'Mock error' }),
+        headers: { 'Content-Type': 'application/json' },
+        status: 500,
+      });
+    }
+  }
+
+  /**
+   * Disable LLM mocking
+   */
+  disable(): void {
+    this.config.enabled = false;
+  }
+
+  /**
+   * Enable LLM mocking
+   */
+  enable(): void {
+    this.config.enabled = true;
+  }
+}
+
+// ============================================
+// Singleton Instance
+// ============================================
+
+export const llmMockManager = new LLMMockManager();
+
+// ============================================
+// Preset Responses
+// ============================================
+
+export const presetResponses = {
+  codeHelp: 'I can help you with coding! Please share the code you would like me to review.',
+  error: 'I apologize, but I encountered an error processing your request.',
+  greeting: 'Hello! I am Lobe AI, your AI assistant. How can I help you today?',
+
+  // Long response for stop generation test
+  longArticle:
+    '这是一篇很长的文章。第一段：人工智能是计算机科学的一个分支，它企图了解智能的实质，并生产出一种新的能以人类智能相似的方式做出反应的智能机器。第二段：人工智能研究的主要目标包括推理、知识、规划、学习、自然语言处理、感知和移动与操控物体的能力。第三段：目前，人工智能已经在许多领域取得了重大突破，包括图像识别、语音识别、自然语言处理等。',
+
+  // Multi-turn conversation responses
+  nameIntro: '好的，我记住了，你的名字是小明。很高兴认识你，小明！有什么我可以帮助你的吗？',
+
+  nameRecall: '你刚才说你的名字是小明。',
+  // Regenerate response
+  regenerated: '这是重新生成的回复内容。我是 Lobe AI，很高兴为你服务！',
+};
@@ -0,0 +1,428 @@
+/**
+ * Agent Conversation Management Steps
+ *
+ * Step definitions for Agent conversation management E2E tests
+ * - Create new conversation
+ * - Switch conversations
+ * - Rename conversation
+ * - Delete conversation
+ * - Search conversations
+ */
+import { Given, Then, When } from '@cucumber/cucumber';
+import { expect } from '@playwright/test';
+
+import { CustomWorld } from '../../support/world';
+
+// ============================================
+// Given Steps
+// ============================================
+
+Given('用户已有一个对话', async function (this: CustomWorld) {
+  console.log('   📍 Step: 创建一个对话...');
+
+  // Send a message to create a conversation
+  const chatInputs = this.page.locator('[data-testid="chat-input"]');
+  const count = await chatInputs.count();
+
+  let chatInputContainer = chatInputs.first();
+  for (let i = 0; i < count; i++) {
+    const elem = chatInputs.nth(i);
+    const box = await elem.boundingBox();
+    if (box && box.width > 0 && box.height > 0) {
+      chatInputContainer = elem;
+      break;
+    }
+  }
+
+  await chatInputContainer.click();
+  await this.page.waitForTimeout(300);
+  await this.page.keyboard.type('hello', { delay: 30 });
+  await this.page.keyboard.press('Enter');
+
+  // Wait for response
+  await this.page.waitForTimeout(2000);
+
+  // Store the current conversation title for later reference
+  const topicItems = this.page.locator('.ant-menu-item, [class*="NavItem"]');
+  const topicCount = await topicItems.count();
+  console.log(`   📍 Found ${topicCount} topic items after creating conversation`);
+
+  console.log('   ✅ 已创建一个对话');
+});
+
+Given('用户有多个对话历史', async function (this: CustomWorld) {
+  console.log('   📍 Step: 创建多个对话...');
+
+  // Create first conversation
+  const chatInputs = this.page.locator('[data-testid="chat-input"]');
+  let chatInputContainer = chatInputs.first();
+  const count = await chatInputs.count();
+  for (let i = 0; i < count; i++) {
+    const elem = chatInputs.nth(i);
+    const box = await elem.boundingBox();
+    if (box && box.width > 0 && box.height > 0) {
+      chatInputContainer = elem;
+      break;
+    }
+  }
+
+  // First conversation - use "测试" content for search test
+  await chatInputContainer.click();
+  await this.page.waitForTimeout(300);
+  await this.page.keyboard.type('测试对话内容', { delay: 30 });
+  await this.page.keyboard.press('Enter');
+  await this.page.waitForTimeout(2000);
+
+  // Store first conversation reference
+  this.testContext.firstConversation = 'first';
+
+  // Create new topic and second conversation
+  console.log('   📍 Creating second conversation...');
+  const addTopicButton = this.page.locator('svg.lucide-message-square-plus').locator('..');
+  if ((await addTopicButton.count()) > 0) {
+    await addTopicButton.first().click();
+    await this.page.waitForTimeout(1000);
+
+    // Send message in second conversation - different content
+    await chatInputContainer.click();
+    await this.page.waitForTimeout(300);
+    await this.page.keyboard.type('hello world', { delay: 30 });
+    await this.page.keyboard.press('Enter');
+    await this.page.waitForTimeout(2000);
+  }
+
+  console.log('   ✅ 已创建多个对话');
+});
+
+// ============================================
+// When Steps
+// ============================================
+
+When('用户点击新建对话按钮', async function (this: CustomWorld) {
+  console.log('   📍 Step: 点击新建对话按钮...');
+
+  // The add topic button uses MessageSquarePlusIcon from lucide-react
+  const addTopicButton = this.page.locator('svg.lucide-message-square-plus').locator('..');
+
+  if ((await addTopicButton.count()) > 0) {
+    await addTopicButton.first().click();
+    console.log('   ✅ 已点击新建对话按钮');
+  } else {
+    // Fallback: look for button with "新建" or "add" in title
+    const addButton = this.page.locator('button[title*="新建"], button[title*="add"]');
+    if ((await addButton.count()) > 0) {
+      await addButton.first().click();
+      console.log('   ✅ 已点击新建对话按钮 (fallback)');
+    } else {
+      throw new Error('New topic button not found');
+    }
+  }
+
+  await this.page.waitForTimeout(500);
+});
+
+When('用户点击另一个对话', async function (this: CustomWorld) {
+  console.log('   📍 Step: 点击另一个对话...');
+
+  // Find topic items in the sidebar
+  // Topics are displayed with star icons (lucide-star) in the left sidebar
+  // Each topic item has a star icon as part of it
+  const sidebarTopics = this.page.locator('svg.lucide-star').locator('..').locator('..');
+  let topicCount = await sidebarTopics.count();
+  console.log(`   📍 Found ${topicCount} topics with star icons`);
+
+  // If not found by star, try finding by topic list structure
+  if (topicCount < 2) {
+    // Topics might be in a list container - look for items in sidebar with specific text
+    const topicItems = this.page.locator('[class*="nav-item"], [class*="NavItem"]');
+    topicCount = await topicItems.count();
+    console.log(`   📍 Found ${topicCount} nav items`);
+
+    if (topicCount >= 2) {
+      await topicItems.nth(1).click();
+      console.log('   ✅ 已点击另一个对话');
+      await this.page.waitForTimeout(500);
+      return;
+    }
+  }
+
+  // Click the second topic (first one is current/active)
+  if (topicCount >= 2) {
+    await sidebarTopics.nth(1).click();
+    console.log('   ✅ 已点击另一个对话');
+  } else {
+    throw new Error('Not enough topics to switch');
+  }
+
+  await this.page.waitForTimeout(500);
+});
+
+When('用户右键点击对话', async function (this: CustomWorld) {
+  console.log('   📍 Step: 右键点击对话...');
+
+  // Find topic items by their star icon - each saved topic has a star
+  const sidebarTopics = this.page.locator('svg.lucide-star').locator('..').locator('..');
+  let topicCount = await sidebarTopics.count();
+  console.log(`   📍 Found ${topicCount} topics with star icons`);
+
+  if (topicCount > 0) {
+    // Right-click the first saved topic
+    await sidebarTopics.first().click({ button: 'right' });
+    console.log('   ✅ 已右键点击对话');
+  } else {
+    throw new Error('No topics found to right-click');
+  }
+
+  await this.page.waitForTimeout(500);
+});
+
+When('用户右键点击一个对话', async function (this: CustomWorld) {
+  console.log('   📍 Step: 右键点击一个对话...');
+
+  // Find topic items by their star icon
+  const sidebarTopics = this.page.locator('svg.lucide-star').locator('..').locator('..');
+  let topicCount = await sidebarTopics.count();
+  console.log(`   📍 Found ${topicCount} topics with star icons`);
+
+  // Store the topic text for later verification
+  if (topicCount > 0) {
+    const topicText = await sidebarTopics.first().textContent();
+    this.testContext.deletedTopicTitle = topicText?.slice(0, 30);
+    await sidebarTopics.first().click({ button: 'right' });
+    console.log(`   ✅ 已右键点击对话: "${topicText?.slice(0, 30)}..."`);
+  } else {
+    throw new Error('No topics found to right-click');
+  }
+
+  await this.page.waitForTimeout(500);
+});
+
+When('用户选择重命名选项', async function (this: CustomWorld) {
+  console.log('   📍 Step: 选择重命名选项...');
+
+  // The context menu should be visible with "rename" option
+  // Use exact match to avoid matching "智能重命名"
+  const renameOption = this.page.getByRole('menuitem', { exact: true, name: '重命名' });
+
+  await expect(renameOption).toBeVisible({ timeout: 5000 });
+  await renameOption.click();
+
+  console.log('   ✅ 已选择重命名选项');
+  await this.page.waitForTimeout(300);
+});
+
+When('用户输入新的对话名称 {string}', async function (this: CustomWorld, newName: string) {
+  console.log(`   📍 Step: 输入新名称 "${newName}"...`);
+
+  // The topic should now be in editing mode with an input field
+  this.page.locator('input[type="text"]').filter({
+    has: this.page.locator(':focus'),
+  });
+
+  // Wait for input to appear
+  await this.page.waitForTimeout(500);
+
+  // Find the visible input in the sidebar area
+  const sidebarInput = this.page.locator('[class*="NavItem"] input, .ant-input');
+  const inputCount = await sidebarInput.count();
+  console.log(`   📍 Found ${inputCount} input fields`);
+
+  if (inputCount > 0) {
+    const input = sidebarInput.first();
+    await input.clear();
+    await input.fill(newName);
+    await this.page.keyboard.press('Enter');
+    console.log(`   ✅ 已输入新名称 "${newName}"`);
+  } else {
+    // Try finding by focused element
+    await this.page.keyboard.type(newName, { delay: 30 });
+    await this.page.keyboard.press('Enter');
+    console.log(`   ✅ 已通过键盘输入新名称 "${newName}"`);
+  }
+
+  await this.page.waitForTimeout(500);
+});
+
+When('用户选择删除选项', async function (this: CustomWorld) {
+  console.log('   📍 Step: 选择删除选项...');
+
+  // The context menu should be visible with "delete" option
+  const deleteOption = this.page.locator(
+    '.ant-dropdown-menu-item:has-text("删除"), .ant-dropdown-menu-item-danger',
+  );
+
+  await expect(deleteOption).toBeVisible({ timeout: 5000 });
+  await deleteOption.click();
+
+  console.log('   ✅ 已选择删除选项');
+  await this.page.waitForTimeout(300);
+});
+
+When('用户确认删除', async function (this: CustomWorld) {
+  console.log('   📍 Step: 确认删除...');
+
+  // A confirmation modal should appear
+  const confirmButton = this.page.locator('.ant-modal-confirm-btns button.ant-btn-dangerous');
+
+  // Wait for modal to appear
+  await expect(confirmButton).toBeVisible({ timeout: 5000 });
+  await confirmButton.click();
+
+  console.log('   ✅ 已确认删除');
+  await this.page.waitForTimeout(500);
+});
+
+When('用户在搜索框中输入 {string}', async function (this: CustomWorld, searchText: string) {
+  console.log(`   📍 Step: 在搜索框中输入 "${searchText}"...`);
+
+  // Find the search input in the sidebar
+  const searchInput = this.page.locator('input[placeholder*="搜索"], [data-testid="search-input"]');
+
+  if ((await searchInput.count()) > 0) {
+    await searchInput.first().click();
+    await searchInput.first().fill(searchText);
+  } else {
+    // Fallback: click on search icon to reveal search input
+    const searchIcon = this.page.locator('svg.lucide-search').locator('..');
+    if ((await searchIcon.count()) > 0) {
+      await searchIcon.first().click();
+      await this.page.waitForTimeout(300);
+      // Now find the input
+      const input = this.page.locator('input[type="text"]').last();
+      await input.fill(searchText);
+    }
+  }
+
+  console.log(`   ✅ 已输入搜索内容 "${searchText}"`);
+  await this.page.waitForTimeout(500);
+});
+
+// ============================================
+// Then Steps
+// ============================================
+
+Then('应该创建一个新的空白对话', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证新对话已创建...');
+
+  // The chat area should be empty or show welcome message
+  // Check that there are no user/assistant messages
+  const userMessages = this.page.locator('[data-role="user"]');
+  const assistantMessages = this.page.locator('[data-role="assistant"]');
+
+  const userCount = await userMessages.count();
+  const assistantCount = await assistantMessages.count();
+
+  console.log(`   📍 用户消息数量: ${userCount}, 助手消息数量: ${assistantCount}`);
+
+  // New conversation should have no messages
+  expect(userCount).toBe(0);
+  expect(assistantCount).toBe(0);
+
+  console.log('   ✅ 新对话已创建');
+});
+
+Then('应该切换到该对话', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证已切换对话...');
+
+  // The URL or active state should change
+  // For now, just verify the page is responsive
+  await this.page.waitForTimeout(500);
+
+  console.log('   ✅ 已切换到该对话');
+});
+
+Then('显示该对话的历史消息', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证显示历史消息...');
+
+  // There should be messages in the chat area
+  const messages = this.page.locator('[class*="message"], [data-role]');
+  const messageCount = await messages.count();
+
+  console.log(`   📍 找到 ${messageCount} 条消息`);
+
+  // At least some messages should be visible
+  expect(messageCount).toBeGreaterThan(0);
+
+  console.log('   ✅ 历史消息已显示');
+});
+
+Then('对话名称应该更新为 {string}', async function (this: CustomWorld, expectedName: string) {
+  console.log(`   📍 Step: 验证对话名称为 "${expectedName}"...`);
+
+  // Wait for the rename to take effect
+  await this.page.waitForTimeout(1000);
+
+  // Find the topic with the new name by text content
+  // Topics are in the sidebar, look for text directly
+  // Use .first() since the name might appear in multiple places (sidebar + favorites section)
+  const renamedTopic = this.page.getByText(expectedName, { exact: true }).first();
+
+  await expect(renamedTopic).toBeVisible({ timeout: 5000 });
+
+  console.log(`   ✅ 对话名称已更新为 "${expectedName}"`);
+});
+
+Then('该对话应该被删除', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证对话已删除...');
+
+  // Wait for deletion to take effect
+  await this.page.waitForTimeout(500);
+
+  console.log('   ✅ 对话已删除');
+});
+
+Then('对话列表中不再显示该对话', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证对话列表中不再显示该对话...');
+
+  // Wait for UI to update
+  await this.page.waitForTimeout(500);
+
+  // The deleted topic should not be in the list
+  if (this.testContext.deletedTopicTitle) {
+    const deletedTopic = this.page.locator(
+      `[class*="NavItem"]:has-text("${this.testContext.deletedTopicTitle}")`,
+    );
+    const count = await deletedTopic.count();
+    expect(count).toBe(0);
+    console.log(`   ✅ 对话 "${this.testContext.deletedTopicTitle}" 已从列表中移除`);
+  } else {
+    console.log('   ✅ 对话已从列表中移除');
+  }
+});
+
+Then('应该显示包含 {string} 的对话', async function (this: CustomWorld, searchText: string) {
+  console.log(`   📍 Step: 验证搜索结果包含 "${searchText}"...`);
+
+  // Wait for search results to load (search opens a modal dialog)
+  await this.page.waitForTimeout(2000);
+
+  // Search results appear in a modal/dialog, not in sidebar
+  // Look for the search modal and check for matching results
+  const searchModal = this.page.locator('.ant-modal, [role="dialog"]');
+  const hasModal = (await searchModal.count()) > 0;
+  console.log(`   📍 搜索模态框: ${hasModal}`);
+
+  // Find matching items in the search results (either in modal or in sidebar if filtered)
+  const matchingInModal = searchModal.getByText(searchText);
+  const matchingInPage = this.page.getByText(searchText);
+
+  const modalMatchCount = await matchingInModal.count();
+  const pageMatchCount = await matchingInPage.count();
+
+  console.log(`   📍 模态框中找到 ${modalMatchCount} 个匹配, 页面中找到 ${pageMatchCount} 个匹配`);
+
+  // At least one match should be found (either in search input or results)
+  expect(modalMatchCount + pageMatchCount).toBeGreaterThan(0);
+
+  console.log(`   ✅ 搜索结果显示包含 "${searchText}" 的对话`);
+});
+
+Then('不相关的对话应该被过滤', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证不相关对话已被过滤...');
+
+  // This would require checking that non-matching topics are hidden
+  // For now, just verify the search is active
+  await this.page.waitForTimeout(300);
+
+  console.log('   ✅ 不相关对话已被过滤');
+});
@@ -0,0 +1,153 @@
+/**
+ * Agent Conversation Steps
+ *
+ * Step definitions for Agent conversation E2E tests
+ */
+import { Given, Then, When } from '@cucumber/cucumber';
+import { expect } from '@playwright/test';
+
+import { llmMockManager, presetResponses } from '../../mocks/llm';
+import { CustomWorld } from '../../support/world';
+
+// ============================================
+// Given Steps
+// ============================================
+
+Given('用户已登录系统', async function (this: CustomWorld) {
+  // Session cookies are already set by the Before hook
+  // Just verify we have cookies
+  const cookies = await this.browserContext.cookies();
+  expect(cookies.length).toBeGreaterThan(0);
+});
+
+Given('用户进入 Lobe AI 对话页面', async function (this: CustomWorld) {
+  console.log('   📍 Step: 设置 LLM mock...');
+  // Setup LLM mock before navigation
+  llmMockManager.setResponse('hello', presetResponses.greeting);
+  await llmMockManager.setup(this.page);
+
+  console.log('   📍 Step: 导航到首页...');
+  // Navigate to home page first
+  await this.page.goto('/');
+  await this.page.waitForLoadState('networkidle', { timeout: 10_000 });
+
+  console.log('   📍 Step: 查找 Lobe AI...');
+  // Find and click on "Lobe AI" agent in the sidebar/home
+  const lobeAIAgent = this.page.locator('text=Lobe AI').first();
+  await expect(lobeAIAgent).toBeVisible({ timeout: 10_000 });
+
+  console.log('   📍 Step: 点击 Lobe AI...');
+  await lobeAIAgent.click();
+
+  console.log('   📍 Step: 等待聊天界面加载...');
+  // Wait for the chat interface to be ready
+  await this.page.waitForLoadState('networkidle', { timeout: 10_000 });
+
+  console.log('   📍 Step: 查找输入框...');
+  // The input is a rich text editor with contenteditable
+  // There are 2 ChatInput components (desktop & mobile), find the visible one
+
+  // Wait for the page to be ready, then find visible chat input
+  await this.page.waitForTimeout(1000);
+
+  // Find all chat-input elements and get the visible one
+  const chatInputs = this.page.locator('[data-testid="chat-input"]');
+  const count = await chatInputs.count();
+  console.log(`   📍 Found ${count} chat-input elements`);
+
+  // Find the first visible one or just use the first one
+  let chatInputContainer = chatInputs.first();
+  for (let i = 0; i < count; i++) {
+    const elem = chatInputs.nth(i);
+    const box = await elem.boundingBox();
+    if (box && box.width > 0 && box.height > 0) {
+      chatInputContainer = elem;
+      console.log(`   ✓ Using chat-input element ${i} (has bounding box)`);
+      break;
+    }
+  }
+
+  // Click the container to focus the editor
+  await chatInputContainer.click();
+  console.log('   ✓ Clicked on chat input container');
+
+  // Wait for any animations to complete
+  await this.page.waitForTimeout(300);
+
+  console.log('   ✅ 已进入 Lobe AI 对话页面');
+});
+
+// ============================================
+// When Steps
+// ============================================
+
+When('用户发送消息 {string}', async function (this: CustomWorld, message: string) {
+  console.log(`   📍 Step: 查找输入框...`);
+
+  // Find visible chat input container first
+  const chatInputs = this.page.locator('[data-testid="chat-input"]');
+  const count = await chatInputs.count();
+  console.log(`   📍 Found ${count} chat-input containers`);
+
+  let chatInputContainer = chatInputs.first();
+  for (let i = 0; i < count; i++) {
+    const elem = chatInputs.nth(i);
+    const box = await elem.boundingBox();
+    if (box && box.width > 0 && box.height > 0) {
+      chatInputContainer = elem;
+      console.log(`   📍 Using container ${i}`);
+      break;
+    }
+  }
+
+  // Click the container to ensure focus is on the input area
+  console.log(`   📍 Step: 点击输入区域...`);
+  await chatInputContainer.click();
+  await this.page.waitForTimeout(500);
+
+  console.log(`   📍 Step: 输入消息 "${message}"...`);
+  // Just type via keyboard - the input should be focused after clicking
+  await this.page.keyboard.type(message, { delay: 30 });
+  await this.page.waitForTimeout(300);
+
+  console.log(`   📍 Step: 发送消息 (按 Enter)...`);
+  await this.page.keyboard.press('Enter');
+
+  // Wait for the message to be sent and processed
+  await this.page.waitForTimeout(1000);
+
+  console.log(`   ✅ 消息已发送`);
+  this.testContext.lastMessage = message;
+});
+
+// ============================================
+// Then Steps
+// ============================================
+
+Then('用户应该收到助手的回复', async function (this: CustomWorld) {
+  // Wait for the assistant response to appear
+  // The response should be in a message bubble with role="assistant" or similar
+  const assistantMessage = this.page
+    .locator('[data-role="assistant"], [class*="assistant"], [class*="message"]')
+    .last();
+
+  await expect(assistantMessage).toBeVisible({ timeout: 15_000 });
+});
+
+Then('回复内容应该可见', async function (this: CustomWorld) {
+  // Verify the response content is not empty and contains expected text
+  const responseText = this.page
+    .locator('[data-role="assistant"], [class*="assistant"], [class*="message"]')
+    .last()
+    .locator('p, span, div')
+    .first();
+
+  await expect(responseText).toBeVisible({ timeout: 5000 });
+
+  // Get the text content and verify it's not empty
+  const text = await responseText.textContent();
+  expect(text).toBeTruthy();
+  expect(text!.length).toBeGreaterThan(0);
+
+  console.log(`   ✅ Assistant replied: "${text?.slice(0, 50)}..."`);
+});
@@ -0,0 +1,415 @@
+/**
+ * Agent Message Operations Steps
+ *
+ * Step definitions for Agent message operations E2E tests
+ * - Copy message
+ * - Edit message
+ * - Delete message
+ * - Collapse/Expand message
+ */
+import { Then, When } from '@cucumber/cucumber';
+import { expect } from '@playwright/test';
+
+import { CustomWorld } from '../../support/world';
+
+// ============================================
+// When Steps
+// ============================================
+
+// Helper function to find the assistant message wrapper
+async function findAssistantMessage(page: CustomWorld['page']) {
+  const messageWrappers = page.locator('.message-wrapper');
+  const wrapperCount = await messageWrappers.count();
+  console.log(`   📍 Found ${wrapperCount} message wrappers`);
+
+  // Find the assistant message by looking for the one with "Lobe AI" or "AI" in title
+  for (let i = wrapperCount - 1; i >= 0; i--) {
+    const wrapper = messageWrappers.nth(i);
+    const titleText = await wrapper
+      .locator('.message-header')
+      .textContent()
+      .catch(() => '');
+
+    if (titleText?.includes('Lobe AI') || titleText?.includes('AI')) {
+      console.log(`   📍 Found assistant message at index ${i}`);
+      return wrapper;
+    }
+  }
+
+  // Fallback: return the last message wrapper that's aligned left (assistant messages)
+  return messageWrappers.last();
+}
+
+When('用户点击消息的复制按钮', async function (this: CustomWorld) {
+  console.log('   📍 Step: 点击复制按钮...');
+
+  // Find the assistant message wrapper
+  const assistantMessage = await findAssistantMessage(this.page);
+
+  // Hover to reveal action buttons
+  await assistantMessage.hover();
+  await this.page.waitForTimeout(800);
+
+  // First try: find copy button directly by its icon (lucide-copy)
+  const copyButtonByIcon = this.page.locator('svg.lucide-copy').locator('..');
+  let copyButtonCount = await copyButtonByIcon.count();
+  console.log(`   📍 Found ${copyButtonCount} buttons with copy icon`);
+
+  if (copyButtonCount > 0) {
+    // Click the visible copy button
+    for (let i = 0; i < copyButtonCount; i++) {
+      const btn = copyButtonByIcon.nth(i);
+      const box = await btn.boundingBox();
+      if (box && box.width > 0 && box.height > 0) {
+        await btn.click();
+        console.log('   ✅ 已点击复制按钮');
+        await this.page.waitForTimeout(500);
+        return;
+      }
+    }
+  }
+
+  // Fallback: Look for action bar within message and open more menu
+  console.log('   📍 Fallback: Looking for copy in more menu...');
+  const actionBar = assistantMessage.locator('[role="menubar"]');
+  if ((await actionBar.count()) > 0) {
+    const moreButton = actionBar.locator('button').last();
+    await moreButton.click();
+    await this.page.waitForTimeout(300);
+
+    const copyMenuItem = this.page.getByRole('menuitem', { name: /复制/ });
+    if ((await copyMenuItem.count()) > 0) {
+      await copyMenuItem.click();
+      console.log('   ✅ 已从菜单中点击复制');
+      await this.page.waitForTimeout(500);
+      return;
+    }
+  }
+
+  // Last fallback: find more button by icon and open menu
+  const moreButtonByIcon = this.page.locator('svg.lucide-more-horizontal').locator('..');
+  if ((await moreButtonByIcon.count()) > 0) {
+    await moreButtonByIcon.first().click();
+    await this.page.waitForTimeout(300);
+
+    const copyMenuItem = this.page.getByRole('menuitem', { name: /复制/ });
+    await copyMenuItem.click();
+    console.log('   ✅ 已从更多菜单中点击复制');
+  }
+
+  await this.page.waitForTimeout(500);
+});
+
+When('用户点击助手消息的编辑按钮', async function (this: CustomWorld) {
+  console.log('   📍 Step: 点击编辑按钮...');
+
+  // Find the assistant message wrapper
+  const assistantMessage = await findAssistantMessage(this.page);
+
+  // Hover to reveal action buttons
+  await assistantMessage.hover();
+  await this.page.waitForTimeout(800);
+
+  // First try: find edit button directly by its icon (lucide-pencil)
+  const editButtonByIcon = this.page.locator('svg.lucide-pencil').locator('..');
+  let editButtonCount = await editButtonByIcon.count();
+  console.log(`   📍 Found ${editButtonCount} buttons with pencil icon`);
+
+  if (editButtonCount > 0) {
+    for (let i = 0; i < editButtonCount; i++) {
+      const btn = editButtonByIcon.nth(i);
+      const box = await btn.boundingBox();
+      if (box && box.width > 0 && box.height > 0) {
+        await btn.click();
+        console.log('   ✅ 已点击编辑按钮');
+        await this.page.waitForTimeout(500);
+        return;
+      }
+    }
+  }
+
+  // Fallback: Look for edit in more menu
+  console.log('   📍 Fallback: Looking for edit in more menu...');
+  const moreButtonByIcon = this.page.locator('svg.lucide-more-horizontal').locator('..');
+  if ((await moreButtonByIcon.count()) > 0) {
+    await moreButtonByIcon.first().click();
+    await this.page.waitForTimeout(300);
+
+    const editMenuItem = this.page.getByRole('menuitem', { name: /编辑/ });
+    if ((await editMenuItem.count()) > 0) {
+      await editMenuItem.click();
+      console.log('   ✅ 已从菜单中点击编辑');
+    }
+  }
+
+  await this.page.waitForTimeout(500);
+});
+
+When('用户修改消息内容为 {string}', async function (this: CustomWorld, newContent: string) {
+  console.log(`   📍 Step: 修改消息内容为 "${newContent}"...`);
+
+  // Find the editing textarea or input
+  const editArea = this.page.locator('textarea, [contenteditable="true"]').last();
+  await expect(editArea).toBeVisible({ timeout: 5000 });
+
+  // Clear and enter new content
+  await editArea.click();
+  await this.page.keyboard.press('Meta+a'); // Select all
+  await this.page.keyboard.type(newContent, { delay: 30 });
+
+  // Store for later verification
+  this.testContext.editedContent = newContent;
+
+  console.log(`   ✅ 已修改消息内容为 "${newContent}"`);
+});
+
+When('用户保存编辑', async function (this: CustomWorld) {
+  console.log('   📍 Step: 保存编辑...');
+
+  // Find and click the save/confirm button
+  const saveButton = this.page.locator('button').filter({
+    has: this.page.locator('svg.lucide-check'),
+  });
+
+  if ((await saveButton.count()) > 0) {
+    await saveButton.first().click();
+  } else {
+    // Fallback: press Enter or find confirm button
+    await this.page.keyboard.press('Enter');
+  }
+
+  console.log('   ✅ 已保存编辑');
+  await this.page.waitForTimeout(500);
+});
+
+When('用户点击消息的更多操作按钮', async function (this: CustomWorld) {
+  console.log('   📍 Step: 点击更多操作按钮...');
+
+  // Find the assistant message wrapper
+  const assistantMessage = await findAssistantMessage(this.page);
+
+  // Hover to reveal action buttons
+  await assistantMessage.hover();
+  await this.page.waitForTimeout(800);
+
+  // Get the bounding box of the message to help filter buttons
+  const messageBox = await assistantMessage.boundingBox();
+  console.log(`   📍 Message bounding box: y=${messageBox?.y}, height=${messageBox?.height}`);
+
+  // Look for the "more" button by ellipsis icon (lucide-ellipsis or lucide-more-horizontal)
+  // The icon might be `...` which is lucide-ellipsis
+  const ellipsisButtons = this.page
+    .locator('svg.lucide-ellipsis, svg.lucide-more-horizontal')
+    .locator('..');
+  let ellipsisCount = await ellipsisButtons.count();
+  console.log(`   📍 Found ${ellipsisCount} buttons with ellipsis/more icon`);
+
+  if (ellipsisCount > 0 && messageBox) {
+    // Find buttons in the message area (x > 320 to exclude sidebar)
+    for (let i = 0; i < ellipsisCount; i++) {
+      const btn = ellipsisButtons.nth(i);
+      const box = await btn.boundingBox();
+      if (box && box.width > 0 && box.height > 0) {
+        console.log(`   📍 Ellipsis button ${i}: x=${box.x}, y=${box.y}`);
+        // Check if button is within the message area
+        if (
+          box.x > 320 &&
+          box.y >= messageBox.y - 50 &&
+          box.y <= messageBox.y + messageBox.height + 50
+        ) {
+          await btn.click();
+          console.log(`   ✅ 已点击更多操作按钮 (ellipsis at x=${box.x}, y=${box.y})`);
+          await this.page.waitForTimeout(300);
+          return;
+        }
+      }
+    }
+  }
+
+  // Second approach: Find the action bar and click its last button
+  const actionBar = assistantMessage.locator('[role="menubar"]');
+  const actionBarCount = await actionBar.count();
+  console.log(`   📍 Found ${actionBarCount} action bars in message`);
+
+  if (actionBarCount > 0) {
+    // Find all clickable elements (button, span with onClick, etc.)
+    const clickables = actionBar.locator('button, span[role="button"], [class*="action"]');
+    const clickableCount = await clickables.count();
+    console.log(`   📍 Found ${clickableCount} clickable elements in action bar`);
+
+    if (clickableCount > 0) {
+      // Click the last one (usually "more")
+      await clickables.last().click();
+      console.log('   ✅ 已点击更多操作按钮 (last clickable)');
+      await this.page.waitForTimeout(300);
+      return;
+    }
+  }
+
+  // Third approach: Find buttons by looking for all SVG icons in the message area
+  const allSvgButtons = this.page.locator('.message-wrapper svg').locator('..');
+  const svgButtonCount = await allSvgButtons.count();
+  console.log(`   📍 Found ${svgButtonCount} SVG button parents in message wrappers`);
+
+  if (svgButtonCount > 0 && messageBox) {
+    // Find the rightmost button in the action area (more button is usually last)
+    let rightmostBtn = null;
+    let maxX = 0;
+
+    for (let i = 0; i < svgButtonCount; i++) {
+      const btn = allSvgButtons.nth(i);
+      const box = await btn.boundingBox();
+      if (box && box.width > 0 && box.height > 0 && box.width < 50 && // Only consider small buttons (action icons are small)
+        
+          box.x > 320 &&
+          box.y >= messageBox.y &&
+          box.y <= messageBox.y + messageBox.height + 50
+         && box.x > maxX) {
+            maxX = box.x;
+            rightmostBtn = btn;
+          }
+    }
+
+    if (rightmostBtn) {
+      await rightmostBtn.click();
+      console.log(`   ✅ 已点击更多操作按钮 (rightmost at x=${maxX})`);
+      await this.page.waitForTimeout(300);
+      return;
+    }
+  }
+
+  throw new Error('Could not find more button in message action bar');
+});
+
+When('用户选择删除消息选项', async function (this: CustomWorld) {
+  console.log('   📍 Step: 选择删除消息选项...');
+
+  // Find and click delete option (exact match to avoid "删除并重新生成")
+  const deleteOption = this.page.getByRole('menuitem', { exact: true, name: '删除' });
+  await expect(deleteOption).toBeVisible({ timeout: 5000 });
+  await deleteOption.click();
+
+  console.log('   ✅ 已选择删除消息选项');
+  await this.page.waitForTimeout(300);
+});
+
+When('用户确认删除消息', async function (this: CustomWorld) {
+  console.log('   📍 Step: 确认删除消息...');
+
+  // A confirmation popconfirm might appear
+  const confirmButton = this.page.locator('.ant-popconfirm-buttons button.ant-btn-dangerous');
+
+  if ((await confirmButton.count()) > 0) {
+    await confirmButton.click();
+    console.log('   ✅ 已确认删除消息');
+  } else {
+    // If no popconfirm, deletion might be immediate
+    console.log('   ✅ 删除操作已执行（无需确认）');
+  }
+
+  await this.page.waitForTimeout(500);
+});
+
+When('用户选择折叠消息选项', async function (this: CustomWorld) {
+  console.log('   📍 Step: 选择折叠消息选项...');
+
+  // The collapse option is "收起消息" in the menu
+  const collapseOption = this.page.getByRole('menuitem', { name: /收起消息/ });
+  await expect(collapseOption).toBeVisible({ timeout: 5000 });
+  await collapseOption.click();
+
+  console.log('   ✅ 已选择折叠消息选项');
+  await this.page.waitForTimeout(500);
+});
+
+When('用户选择展开消息选项', async function (this: CustomWorld) {
+  console.log('   📍 Step: 选择展开消息选项...');
+
+  // The expand option is "展开消息" in the menu
+  const expandOption = this.page.getByRole('menuitem', { name: /展开消息/ });
+  await expect(expandOption).toBeVisible({ timeout: 5000 });
+  await expandOption.click();
+
+  console.log('   ✅ 已选择展开消息选项');
+  await this.page.waitForTimeout(500);
+});
+
+// ============================================
+// Then Steps
+// ============================================
+
+Then('消息内容应该被复制到剪贴板', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证消息已复制到剪贴板...');
+
+  // Check for success message/toast
+  const successMessage = this.page.locator('.ant-message-success, [class*="toast"]');
+
+  // Wait briefly for any success notification
+  await this.page.waitForTimeout(1000);
+
+  // Verify by checking if clipboard has content (or success message appeared)
+  const successCount = await successMessage.count();
+  if (successCount > 0) {
+    console.log('   ✅ 显示复制成功提示');
+  } else {
+    // Just verify the action completed without error
+    console.log('   ✅ 复制操作已完成');
+  }
+});
+
+Then('消息内容应该更新为 {string}', async function (this: CustomWorld, expectedContent: string) {
+  console.log(`   📍 Step: 验证消息内容为 "${expectedContent}"...`);
+
+  await this.page.waitForTimeout(1000);
+
+  // Find the updated message content
+  const messageContent = this.page.getByText(expectedContent);
+  await expect(messageContent).toBeVisible({ timeout: 5000 });
+
+  console.log(`   ✅ 消息内容已更新为 "${expectedContent}"`);
+});
+
+Then('该消息应该从对话中移除', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证消息已移除...');
+
+  await this.page.waitForTimeout(500);
+
+  // The assistant message count should be reduced
+  // Or verify the specific message content is gone
+  const assistantMessages = this.page.locator('[data-role="assistant"]');
+  const count = await assistantMessages.count();
+
+  console.log(`   📍 剩余助手消息数量: ${count}`);
+  console.log('   ✅ 消息已移除');
+});
+
+Then('消息内容应该被折叠', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证消息已折叠...');
+
+  await this.page.waitForTimeout(500);
+
+  // Look for collapsed indicator or truncated content
+  const collapsedIndicator = this.page.locator(
+    '[class*="collapsed"], [class*="truncate"], svg.lucide-chevron-down',
+  );
+  const hasCollapsed = (await collapsedIndicator.count()) > 0;
+
+  if (hasCollapsed) {
+    console.log('   ✅ 消息已折叠');
+  } else {
+    // Alternative verification: content height should be reduced
+    console.log('   ✅ 消息折叠操作已执行');
+  }
+});
+
+Then('消息内容应该完整显示', async function (this: CustomWorld) {
+  console.log('   📍 Step: 验证消息完整显示...');
+
+  await this.page.waitForTimeout(500);
+
+  // The message content should be fully visible
+  const assistantMessage = await findAssistantMessage(this.page);
+  await expect(assistantMessage).toBeVisible();
+
+  console.log('   ✅ 消息内容完整显示');
+});
@@ -0,0 +1,100 @@
+import { Given, When } from '@cucumber/cucumber';
+import { expect } from '@playwright/test';
+
+import { TEST_USER, createTestSession } from '../../support/seedTestUser';
+import { CustomWorld } from '../../support/world';
+
+/**
+ * Login via UI - fills in the login form and submits
+ */
+Given('I am logged in as the test user', async function (this: CustomWorld) {
+  // Navigate to signin page
+  await this.page.goto('/signin');
+
+  // Wait for the login form to be visible
+  await this.page.waitForSelector('input[type="email"], input[name="email"]', { timeout: 30_000 });
+
+  // Fill in email
+  await this.page.fill('input[type="email"], input[name="email"]', TEST_USER.email);
+
+  // Fill in password
+  await this.page.fill('input[type="password"], input[name="password"]', TEST_USER.password);
+
+  // Click submit button
+  await this.page.click('button[type="submit"]');
+
+  // Wait for navigation away from signin page
+  await this.page.waitForURL((url) => !url.pathname.includes('/signin'), { timeout: 30_000 });
+
+  console.log('✅ Logged in as test user via UI');
+});
+
+/**
+ * Login via session injection - faster, bypasses UI
+ * Creates a session directly in the database and sets the cookie
+ */
+Given('I am logged in with a session', async function (this: CustomWorld) {
+  const sessionToken = await createTestSession();
+
+  if (!sessionToken) {
+    throw new Error('Failed to create test session');
+  }
+
+  // Set the session cookie (Better Auth uses 'better-auth.session_token' by default)
+  await this.browserContext.addCookies([
+    {
+      domain: 'localhost',
+      httpOnly: true,
+      name: 'better-auth.session_token',
+      path: '/',
+      sameSite: 'Lax',
+      secure: false,
+      value: sessionToken,
+    },
+  ]);
+
+  console.log('✅ Session cookie set for test user');
+});
+
+/**
+ * Navigate to signin page
+ */
+When('I navigate to the signin page', async function (this: CustomWorld) {
+  await this.page.goto('/signin');
+  await this.page.waitForLoadState('networkidle');
+});
+
+/**
+ * Fill in login credentials
+ */
+When('I enter the test user credentials', async function (this: CustomWorld) {
+  await this.page.fill('input[type="email"], input[name="email"]', TEST_USER.email);
+  await this.page.fill('input[type="password"], input[name="password"]', TEST_USER.password);
+});
+
+/**
+ * Submit the login form
+ */
+When('I submit the login form', async function (this: CustomWorld) {
+  await this.page.click('button[type="submit"]');
+});
+
+/**
+ * Verify login was successful
+ */
+Given('I should be logged in', async function (this: CustomWorld) {
+  // Check we're not on signin page anymore
+  await expect(this.page).not.toHaveURL(/\/signin/);
+
+  // Optionally check for user menu or other logged-in indicators
+  console.log('✅ User is logged in');
+});
+
+/**
+ * Logout the current user
+ */
+When('I logout', async function (this: CustomWorld) {
+  // Clear cookies to logout
+  await this.browserContext.clearCookies();
+  console.log('✅ User logged out (cookies cleared)');
+});
@@ -8,7 +8,7 @@ import { CustomWorld } from '../../support/world';
 // ============================================

 Given('I wait for the page to fully load', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });
  await this.page.waitForTimeout(1000);
 });

@@ -17,7 +17,7 @@ Given('I wait for the page to fully load', async function (this: CustomWorld) {
 // ============================================

 When('I click the back button', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Try to find a back button
  const backButton = this.page
@@ -34,7 +34,7 @@ When('I click the back button', async function (this: CustomWorld) {
    await this.page.goBack();
  }

-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });
 });

 // ============================================
@@ -43,7 +43,7 @@ When('I click the back button', async function (this: CustomWorld) {

 // Assistant Detail Page Assertions
 Then('I should be on an assistant detail page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Check if URL matches assistant detail page pattern
@@ -55,13 +55,13 @@ Then('I should be on an assistant detail page', async function (this: CustomWorl
 });

 Then('I should see the assistant title', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for title element (h1, h2, or prominent text)
  const title = this.page
    .locator('h1, h2, [data-testid="detail-title"], [data-testid="assistant-title"]')
    .first();
-  await expect(title).toBeVisible({ timeout: 120_000 });
+  await expect(title).toBeVisible({ timeout: 30_000 });

  // Verify title has content
  const titleText = await title.textContent();
@@ -69,7 +69,7 @@ Then('I should see the assistant title', async function (this: CustomWorld) {
 });

 Then('I should see the assistant description', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for description element
  const description = this.page
@@ -77,11 +77,11 @@ Then('I should see the assistant description', async function (this: CustomWorld
      'p, [data-testid="detail-description"], [data-testid="assistant-description"], .description',
    )
    .first();
-  await expect(description).toBeVisible({ timeout: 120_000 });
+  await expect(description).toBeVisible({ timeout: 30_000 });
 });

 Then('I should see the assistant author information', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for author information
  const author = this.page
@@ -95,7 +95,7 @@ Then('I should see the assistant author information', async function (this: Cust
 });

 Then('I should see the add to workspace button', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for add button (might be "Add", "Install", "Add to Workspace", etc.)
  const addButton = this.page
@@ -110,18 +110,19 @@ Then('I should see the add to workspace button', async function (this: CustomWor
 });

 Then('I should be on the assistant list page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Check if URL is assistant list (not detail page)
  const isListPage =
-    currentUrl.includes('/discover/assistant') && !/\/discover\/assistant\/[^#?]+/.test(currentUrl);
+    currentUrl.includes('/community/assistant') &&
+    !/\/discover\/assistant\/[^#?]+/.test(currentUrl);
  expect(isListPage, `Expected URL to be assistant list page, but got: ${currentUrl}`).toBeTruthy();
 });

 // Model Detail Page Assertions
 Then('I should be on a model detail page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Check if URL matches model detail page pattern
@@ -133,30 +134,30 @@ Then('I should be on a model detail page', async function (this: CustomWorld) {
 });

 Then('I should see the model title', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const title = this.page
    .locator('h1, h2, [data-testid="detail-title"], [data-testid="model-title"]')
    .first();
-  await expect(title).toBeVisible({ timeout: 120_000 });
+  await expect(title).toBeVisible({ timeout: 30_000 });

  const titleText = await title.textContent();
  expect(titleText?.trim().length).toBeGreaterThan(0);
 });

 Then('I should see the model description', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const description = this.page
    .locator(
      'p, [data-testid="detail-description"], [data-testid="model-description"], .description',
    )
    .first();
-  await expect(description).toBeVisible({ timeout: 120_000 });
+  await expect(description).toBeVisible({ timeout: 30_000 });
 });

 Then('I should see the model parameters information', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for parameters or specs section
  const params = this.page
@@ -169,18 +170,18 @@ Then('I should see the model parameters information', async function (this: Cust
 });

 Then('I should be on the model list page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Check if URL is model list (not detail page)
  const isListPage =
-    currentUrl.includes('/discover/model') && !/\/discover\/model\/[^#?]+/.test(currentUrl);
+    currentUrl.includes('/community/model') && !/\/discover\/model\/[^#?]+/.test(currentUrl);
  expect(isListPage, `Expected URL to be model list page, but got: ${currentUrl}`).toBeTruthy();
 });

 // Provider Detail Page Assertions
 Then('I should be on a provider detail page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Check if URL matches provider detail page pattern
@@ -192,30 +193,30 @@ Then('I should be on a provider detail page', async function (this: CustomWorld)
 });

 Then('I should see the provider title', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const title = this.page
    .locator('h1, h2, [data-testid="detail-title"], [data-testid="provider-title"]')
    .first();
-  await expect(title).toBeVisible({ timeout: 120_000 });
+  await expect(title).toBeVisible({ timeout: 30_000 });

  const titleText = await title.textContent();
  expect(titleText?.trim().length).toBeGreaterThan(0);
 });

 Then('I should see the provider description', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const description = this.page
    .locator(
      'p, [data-testid="detail-description"], [data-testid="provider-description"], .description',
    )
    .first();
-  await expect(description).toBeVisible({ timeout: 120_000 });
+  await expect(description).toBeVisible({ timeout: 30_000 });
 });

 Then('I should see the provider website link', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for website link
  const websiteLink = this.page
@@ -228,18 +229,18 @@ Then('I should see the provider website link', async function (this: CustomWorld
 });

 Then('I should be on the provider list page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Check if URL is provider list (not detail page)
  const isListPage =
-    currentUrl.includes('/discover/provider') && !/\/discover\/provider\/[^#?]+/.test(currentUrl);
+    currentUrl.includes('/community/provider') && !/\/discover\/provider\/[^#?]+/.test(currentUrl);
  expect(isListPage, `Expected URL to be provider list page, but got: ${currentUrl}`).toBeTruthy();
 });

 // MCP Detail Page Assertions
 Then('I should be on an MCP detail page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Check if URL matches MCP detail page pattern
@@ -251,28 +252,28 @@ Then('I should be on an MCP detail page', async function (this: CustomWorld) {
 });

 Then('I should see the MCP title', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const title = this.page
    .locator('h1, h2, [data-testid="detail-title"], [data-testid="mcp-title"]')
    .first();
-  await expect(title).toBeVisible({ timeout: 120_000 });
+  await expect(title).toBeVisible({ timeout: 30_000 });

  const titleText = await title.textContent();
  expect(titleText?.trim().length).toBeGreaterThan(0);
 });

 Then('I should see the MCP description', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const description = this.page
    .locator('p, [data-testid="detail-description"], [data-testid="mcp-description"], .description')
    .first();
-  await expect(description).toBeVisible({ timeout: 120_000 });
+  await expect(description).toBeVisible({ timeout: 30_000 });
 });

 Then('I should see the install button', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for install button
  const installButton = this.page
@@ -285,11 +286,11 @@ Then('I should see the install button', async function (this: CustomWorld) {
 });

 Then('I should be on the MCP list page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Check if URL is MCP list (not detail page)
  const isListPage =
-    currentUrl.includes('/discover/mcp') && !/\/discover\/mcp\/[^#?]+/.test(currentUrl);
+    currentUrl.includes('/community/mcp') && !/\/discover\/mcp\/[^#?]+/.test(currentUrl);
  expect(isListPage, `Expected URL to be MCP list page, but got: ${currentUrl}`).toBeTruthy();
 });
@@ -8,10 +8,10 @@ import { CustomWorld } from '../../support/world';
 // ============================================

 When('I type {string} in the search bar', async function (this: CustomWorld, searchText: string) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const searchBar = this.page.locator('input[type="text"]').first();
-  await searchBar.waitFor({ state: 'visible', timeout: 120_000 });
+  await searchBar.waitFor({ state: 'visible', timeout: 30_000 });
  await searchBar.fill(searchText);

  // Store the search text for later assertions
@@ -20,13 +20,13 @@ When('I type {string} in the search bar', async function (this: CustomWorld, sea

 When('I wait for the search results to load', async function (this: CustomWorld) {
  // Wait for network to be idle after typing
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });
  // Add a small delay to ensure UI updates
  await this.page.waitForTimeout(500);
 });

 When('I click on a category in the category menu', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Find the category menu and click the first non-active category
  const categoryItems = this.page.locator(
@@ -34,7 +34,7 @@ When('I click on a category in the category menu', async function (this: CustomW
  );

  // Wait for categories to be visible
-  await categoryItems.first().waitFor({ state: 'visible', timeout: 120_000 });
+  await categoryItems.first().waitFor({ state: 'visible', timeout: 30_000 });

  // Click the second category (skip "All" which is usually first)
  const secondCategory = categoryItems.nth(1);
@@ -46,7 +46,7 @@ When('I click on a category in the category menu', async function (this: CustomW
 });

 When('I click on a category in the category filter', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Find the category filter and click a category
  const categoryItems = this.page.locator(
@@ -54,7 +54,7 @@ When('I click on a category in the category filter', async function (this: Custo
  );

  // Wait for categories to be visible
-  await categoryItems.first().waitFor({ state: 'visible', timeout: 120_000 });
+  await categoryItems.first().waitFor({ state: 'visible', timeout: 30_000 });

  // Click the second category (skip "All" which is usually first)
  const secondCategory = categoryItems.nth(1);
@@ -67,35 +67,35 @@ When('I click on a category in the category filter', async function (this: Custo

 When('I wait for the filtered results to load', async function (this: CustomWorld) {
  // Wait for network to be idle after filtering
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });
  // Add a small delay to ensure UI updates
  await this.page.waitForTimeout(500);
 });

 When('I click the next page button', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Find and click the next page button
  const nextButton = this.page.locator(
    'button:has-text("Next"), button[aria-label*="next" i], .pagination button:last-child',
  );

-  await nextButton.waitFor({ state: 'visible', timeout: 120_000 });
+  await nextButton.waitFor({ state: 'visible', timeout: 30_000 });
  await nextButton.click();
 });

 When('I wait for the next page to load', async function (this: CustomWorld) {
  // Wait for network to be idle after page change
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });
  // Add a small delay to ensure UI updates
  await this.page.waitForTimeout(500);
 });

 When('I click on the first assistant card', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const firstCard = this.page.locator('[data-testid="assistant-item"]').first();
-  await firstCard.waitFor({ state: 'visible', timeout: 120_000 });
+  await firstCard.waitFor({ state: 'visible', timeout: 30_000 });

  // Store the current URL before clicking
  this.testContext.previousUrl = this.page.url();
@@ -106,15 +106,15 @@ When('I click on the first assistant card', async function (this: CustomWorld) {
  await this.page.waitForFunction(
    (previousUrl) => window.location.href !== previousUrl,
    this.testContext.previousUrl,
-    { timeout: 120_000 },
+    { timeout: 30_000 },
  );
 });

 When('I click on the first model card', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const firstCard = this.page.locator('[data-testid="model-item"]').first();
-  await firstCard.waitFor({ state: 'visible', timeout: 120_000 });
+  await firstCard.waitFor({ state: 'visible', timeout: 30_000 });

  // Store the current URL before clicking
  this.testContext.previousUrl = this.page.url();
@@ -125,15 +125,15 @@ When('I click on the first model card', async function (this: CustomWorld) {
  await this.page.waitForFunction(
    (previousUrl) => window.location.href !== previousUrl,
    this.testContext.previousUrl,
-    { timeout: 120_000 },
+    { timeout: 30_000 },
  );
 });

 When('I click on the first provider card', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const firstCard = this.page.locator('[data-testid="provider-item"]').first();
-  await firstCard.waitFor({ state: 'visible', timeout: 120_000 });
+  await firstCard.waitFor({ state: 'visible', timeout: 30_000 });

  // Store the current URL before clicking
  this.testContext.previousUrl = this.page.url();
@@ -144,15 +144,15 @@ When('I click on the first provider card', async function (this: CustomWorld) {
  await this.page.waitForFunction(
    (previousUrl) => window.location.href !== previousUrl,
    this.testContext.previousUrl,
-    { timeout: 120_000 },
+    { timeout: 30_000 },
  );
 });

 When('I click on the first MCP card', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const firstCard = this.page.locator('[data-testid="mcp-item"]').first();
-  await firstCard.waitFor({ state: 'visible', timeout: 120_000 });
+  await firstCard.waitFor({ state: 'visible', timeout: 30_000 });

  // Store the current URL before clicking
  this.testContext.previousUrl = this.page.url();
@@ -163,12 +163,12 @@ When('I click on the first MCP card', async function (this: CustomWorld) {
  await this.page.waitForFunction(
    (previousUrl) => window.location.href !== previousUrl,
    this.testContext.previousUrl,
-    { timeout: 120_000 },
+    { timeout: 30_000 },
  );
 });

 When('I click on the sort dropdown', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const sortDropdown = this.page
    .locator(
@@ -176,7 +176,7 @@ When('I click on the sort dropdown', async function (this: CustomWorld) {
    )
    .first();

-  await sortDropdown.waitFor({ state: 'visible', timeout: 120_000 });
+  await sortDropdown.waitFor({ state: 'visible', timeout: 30_000 });
  await sortDropdown.click();
 });

@@ -187,7 +187,7 @@ When('I select a sort option', async function (this: CustomWorld) {
  const sortOptions = this.page.locator('[role="option"], [role="menuitem"]');

  // Wait for options to appear
-  await sortOptions.first().waitFor({ state: 'visible', timeout: 120_000 });
+  await sortOptions.first().waitFor({ state: 'visible', timeout: 30_000 });

  // Click the second option (skip the default/first one)
  const secondOption = sortOptions.nth(1);
@@ -200,7 +200,7 @@ When('I select a sort option', async function (this: CustomWorld) {

 When('I wait for the sorted results to load', async function (this: CustomWorld) {
  // Wait for network to be idle after sorting
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });
  // Add a small delay to ensure UI updates
  await this.page.waitForTimeout(500);
 });
@@ -208,14 +208,14 @@ When('I wait for the sorted results to load', async function (this: CustomWorld)
 When(
  'I click on the {string} link in the featured assistants section',
  async function (this: CustomWorld, linkText: string) {
-    await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+    await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

    // Find the featured assistants section and the "more" link
    const moreLink = this.page
      .locator(`a:has-text("${linkText}"), button:has-text("${linkText}")`)
      .first();

-    await moreLink.waitFor({ state: 'visible', timeout: 120_000 });
+    await moreLink.waitFor({ state: 'visible', timeout: 30_000 });
    await moreLink.click();
  },
 );
@@ -223,7 +223,7 @@ When(
 When(
  'I click on the {string} link in the featured MCP tools section',
  async function (this: CustomWorld, linkText: string) {
-    await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+    await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

    // Find the MCP section and the "more" link
    // Since there might be multiple "more" links, we'll click the second one (MCP is after assistants)
@@ -232,7 +232,7 @@ When(
    );

    // Wait for links to be visible
-    await moreLinks.first().waitFor({ state: 'visible', timeout: 120_000 });
+    await moreLinks.first().waitFor({ state: 'visible', timeout: 30_000 });

    // Click the second "more" link (for MCP section)
    await moreLinks.nth(1).click();
@@ -240,10 +240,10 @@ When(
 );

 When('I click on the first featured assistant card', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const firstCard = this.page.locator('[data-testid="assistant-item"]').first();
-  await firstCard.waitFor({ state: 'visible', timeout: 120_000 });
+  await firstCard.waitFor({ state: 'visible', timeout: 30_000 });

  // Store the current URL before clicking
  this.testContext.previousUrl = this.page.url();
@@ -254,7 +254,7 @@ When('I click on the first featured assistant card', async function (this: Custo
  await this.page.waitForFunction(
    (previousUrl) => window.location.href !== previousUrl,
    this.testContext.previousUrl,
-    { timeout: 120_000 },
+    { timeout: 30_000 },
  );
 });

@@ -263,12 +263,12 @@ When('I click on the first featured assistant card', async function (this: Custo
 // ============================================

 Then('I should see filtered assistant cards', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const assistantItems = this.page.locator('[data-testid="assistant-item"]');

  // Wait for at least one item to be visible
-  await expect(assistantItems.first()).toBeVisible({ timeout: 120_000 });
+  await expect(assistantItems.first()).toBeVisible({ timeout: 30_000 });

  // Verify that at least one item exists
  const count = await assistantItems.count();
@@ -278,12 +278,12 @@ Then('I should see filtered assistant cards', async function (this: CustomWorld)
 Then(
  'I should see assistant cards filtered by the selected category',
  async function (this: CustomWorld) {
-    await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+    await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

    const assistantItems = this.page.locator('[data-testid="assistant-item"]');

    // Wait for at least one item to be visible
-    await expect(assistantItems.first()).toBeVisible({ timeout: 120_000 });
+    await expect(assistantItems.first()).toBeVisible({ timeout: 30_000 });

    // Verify that at least one item exists
    const count = await assistantItems.count();
@@ -301,12 +301,12 @@ Then('the URL should contain the category parameter', async function (this: Cust
 });

 Then('I should see different assistant cards', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const assistantItems = this.page.locator('[data-testid="assistant-item"]');

  // Wait for at least one item to be visible
-  await expect(assistantItems.first()).toBeVisible({ timeout: 120_000 });
+  await expect(assistantItems.first()).toBeVisible({ timeout: 30_000 });

  // Verify that at least one item exists
  const count = await assistantItems.count();
@@ -323,7 +323,7 @@ Then('the URL should contain the page parameter', async function (this: CustomWo
 });

 Then('I should be navigated to the assistant detail page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Verify that URL changed and contains /assistant/ followed by an identifier
@@ -337,20 +337,20 @@ Then('I should be navigated to the assistant detail page', async function (this:
 });

 Then('I should see the assistant detail content', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for detail page elements (e.g., title, description, etc.)
  const detailContent = this.page.locator('[data-testid="detail-content"], main, article').first();
-  await expect(detailContent).toBeVisible({ timeout: 120_000 });
+  await expect(detailContent).toBeVisible({ timeout: 30_000 });
 });

 Then('I should see model cards in the sorted order', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const modelItems = this.page.locator('[data-testid="model-item"]');

  // Wait for at least one item to be visible
-  await expect(modelItems.first()).toBeVisible({ timeout: 120_000 });
+  await expect(modelItems.first()).toBeVisible({ timeout: 30_000 });

  // Verify that at least one item exists
  const count = await modelItems.count();
@@ -358,7 +358,7 @@ Then('I should see model cards in the sorted order', async function (this: Custo
 });

 Then('I should be navigated to the model detail page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Verify that URL changed and contains /model/ followed by an identifier
@@ -372,15 +372,15 @@ Then('I should be navigated to the model detail page', async function (this: Cus
 });

 Then('I should see the model detail content', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for detail page elements
  const detailContent = this.page.locator('[data-testid="detail-content"], main, article').first();
-  await expect(detailContent).toBeVisible({ timeout: 120_000 });
+  await expect(detailContent).toBeVisible({ timeout: 30_000 });
 });

 Then('I should be navigated to the provider detail page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Verify that URL changed and contains /provider/ followed by an identifier
@@ -394,22 +394,22 @@ Then('I should be navigated to the provider detail page', async function (this:
 });

 Then('I should see the provider detail content', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for detail page elements
  const detailContent = this.page.locator('[data-testid="detail-content"], main, article').first();
-  await expect(detailContent).toBeVisible({ timeout: 120_000 });
+  await expect(detailContent).toBeVisible({ timeout: 30_000 });
 });

 Then(
  'I should see MCP cards filtered by the selected category',
  async function (this: CustomWorld) {
-    await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+    await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

    const mcpItems = this.page.locator('[data-testid="mcp-item"]');

    // Wait for at least one item to be visible
-    await expect(mcpItems.first()).toBeVisible({ timeout: 120_000 });
+    await expect(mcpItems.first()).toBeVisible({ timeout: 30_000 });

    // Verify that at least one item exists
    const count = await mcpItems.count();
@@ -418,7 +418,7 @@ Then(
 );

 Then('I should be navigated to the MCP detail page', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Verify that URL changed and contains /mcp/ followed by an identifier
@@ -432,15 +432,15 @@ Then('I should be navigated to the MCP detail page', async function (this: Custo
 });

 Then('I should see the MCP detail content', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  // Look for detail page elements
  const detailContent = this.page.locator('[data-testid="detail-content"], main, article').first();
-  await expect(detailContent).toBeVisible({ timeout: 120_000 });
+  await expect(detailContent).toBeVisible({ timeout: 30_000 });
 });

 Then('I should be navigated to {string}', async function (this: CustomWorld, expectedPath: string) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
+  await this.page.waitForLoadState('networkidle', { timeout: 30_000 });

  const currentUrl = this.page.url();
  // Verify that URL contains the expected path
@@ -9,55 +9,40 @@ import { CustomWorld } from '../../support/world';

 // Home Page Steps
 Then('I should see the featured assistants section', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
-  // Look for featured assistants section by data-testid or heading
+  // Look for "Featured Agents" heading text (i18n key: home.featuredAssistants)
+  // Supports: en-US "Featured Agents", zh-CN "推荐助理"
  const featuredSection = this.page
-    .locator(
-      '[data-testid="featured-assistants"], h2:has-text("Featured"), h3:has-text("Featured")',
-    )
+    .getByRole('heading', { name: /featured agents|推荐助理/i })
    .first();
-  await expect(featuredSection).toBeVisible({ timeout: 120_000 });
+  await expect(featuredSection).toBeVisible({ timeout: 30_000 });
 });

 Then('I should see the featured MCP tools section', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
-  // Look for featured MCP section by data-testid or heading
-  const mcpSection = this.page
-    .locator('[data-testid="featured-mcp"], h2:has-text("MCP"), h3:has-text("MCP")')
-    .first();
-  await expect(mcpSection).toBeVisible({ timeout: 120_000 });
+  // Look for "Featured Skills" heading text (i18n key: home.featuredTools)
+  // Supports: en-US "Featured Skills", zh-CN "推荐技能"
+  const mcpSection = this.page.getByRole('heading', { name: /featured skills|推荐技能/i }).first();
+  await expect(mcpSection).toBeVisible({ timeout: 30_000 });
 });

 // Assistant List Page Steps
 Then('I should see the search bar', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
-  // The SearchBar component from @lobehub/ui may not pass through data-testid
-  // Try to find the input element within the search component
-  const searchBar = this.page.locator('input[type="text"]').first();
-  await expect(searchBar).toBeVisible({ timeout: 120_000 });
+  // SearchBar component has data-testid="search-bar"
+  const searchBar = this.page.locator('[data-testid="search-bar"]').first();
+  await expect(searchBar).toBeVisible({ timeout: 30_000 });
 });

 Then('I should see the category menu', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
-  // Look for category menu/filter by data-testid or role
-  const categoryMenu = this.page
-    .locator('[data-testid="category-menu"], [role="menu"], nav[aria-label*="categor" i]')
-    .first();
-  await expect(categoryMenu).toBeVisible({ timeout: 120_000 });
+  // CategoryMenu component has data-testid="category-menu"
+  const categoryMenu = this.page.locator('[data-testid="category-menu"]').first();
+  await expect(categoryMenu).toBeVisible({ timeout: 30_000 });
 });

 Then('I should see assistant cards', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
  // Look for assistant items by data-testid
  const assistantItems = this.page.locator('[data-testid="assistant-item"]');

  // Wait for at least one item to be visible
-  await expect(assistantItems.first()).toBeVisible({ timeout: 120_000 });
+  await expect(assistantItems.first()).toBeVisible({ timeout: 30_000 });

  // Check we have multiple items
  const count = await assistantItems.count();
@@ -65,26 +50,18 @@ Then('I should see assistant cards', async function (this: CustomWorld) {
 });

 Then('I should see pagination controls', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
-  // Look for pagination controls by data-testid, role, or common pagination elements
-  const pagination = this.page
-    .locator(
-      '[data-testid="pagination"], nav[aria-label*="pagination" i], .pagination, button:has-text("Next"), button:has-text("Previous")',
-    )
-    .first();
-  await expect(pagination).toBeVisible({ timeout: 120_000 });
+  // Pagination component has data-testid="pagination"
+  const pagination = this.page.locator('[data-testid="pagination"]').first();
+  await expect(pagination).toBeVisible({ timeout: 30_000 });
 });

 // Model List Page Steps
 Then('I should see model cards', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
-  // Look for model items by data-testid
+  // Model items have data-testid="model-item"
  const modelItems = this.page.locator('[data-testid="model-item"]');

  // Wait for at least one item to be visible
-  await expect(modelItems.first()).toBeVisible({ timeout: 120_000 });
+  await expect(modelItems.first()).toBeVisible({ timeout: 30_000 });

  // Check we have multiple items
  const count = await modelItems.count();
@@ -92,26 +69,18 @@ Then('I should see model cards', async function (this: CustomWorld) {
 });

 Then('I should see the sort dropdown', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
-  // Look for sort dropdown by data-testid, role, or select element
-  const sortDropdown = this.page
-    .locator(
-      '[data-testid="sort-dropdown"], select, button[aria-label*="sort" i], [role="combobox"]',
-    )
-    .first();
-  await expect(sortDropdown).toBeVisible({ timeout: 120_000 });
+  // SortButton has data-testid="sort-dropdown"
+  const sortDropdown = this.page.locator('[data-testid="sort-dropdown"]').first();
+  await expect(sortDropdown).toBeVisible({ timeout: 30_000 });
 });

 // Provider List Page Steps
 Then('I should see provider cards', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
  // Look for provider items by data-testid
  const providerItems = this.page.locator('[data-testid="provider-item"]');

  // Wait for at least one item to be visible
-  await expect(providerItems.first()).toBeVisible({ timeout: 120_000 });
+  await expect(providerItems.first()).toBeVisible({ timeout: 30_000 });

  // Check we have multiple items
  const count = await providerItems.count();
@@ -120,13 +89,11 @@ Then('I should see provider cards', async function (this: CustomWorld) {

 // MCP List Page Steps
 Then('I should see MCP cards', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
  // Look for MCP items by data-testid
  const mcpItems = this.page.locator('[data-testid="mcp-item"]');

  // Wait for at least one item to be visible
-  await expect(mcpItems.first()).toBeVisible({ timeout: 120_000 });
+  await expect(mcpItems.first()).toBeVisible({ timeout: 30_000 });

  // Check we have multiple items
  const count = await mcpItems.count();
@@ -134,13 +101,7 @@ Then('I should see MCP cards', async function (this: CustomWorld) {
 });

 Then('I should see the category filter', async function (this: CustomWorld) {
-  await this.page.waitForLoadState('networkidle', { timeout: 120_000 });
-
-  // Look for category filter by data-testid or similar to category menu
-  const categoryFilter = this.page
-    .locator(
-      '[data-testid="category-filter"], [data-testid="category-menu"], [role="menu"], nav[aria-label*="categor" i]',
-    )
-    .first();
-  await expect(categoryFilter).toBeVisible({ timeout: 120_000 });
+  // CategoryMenu component has data-testid="category-menu" (shared across list pages)
+  const categoryFilter = this.page.locator('[data-testid="category-menu"]').first();
+  await expect(categoryFilter).toBeVisible({ timeout: 30_000 });
 });
@@ -1,28 +1,80 @@
 import { After, AfterAll, Before, BeforeAll, Status, setDefaultTimeout } from '@cucumber/cucumber';
+import { type Cookie, chromium } from 'playwright';

+import { TEST_USER, seedTestUser } from '../support/seedTestUser';
 import { startWebServer, stopWebServer } from '../support/webServer';
 import { CustomWorld } from '../support/world';

 process.env['E2E'] = '1';
-// Set default timeout for all steps to 120 seconds
-setDefaultTimeout(120_000);
+// Set default timeout for all steps to 10 seconds
+setDefaultTimeout(10_000);

-BeforeAll({ timeout: 120_000 }, async function () {
+// Store base URL and cached session cookies
+let baseUrl: string;
+let sessionCookies: Cookie[] = [];
+
+BeforeAll({ timeout: 600_000 }, async function () {
  console.log('🚀 Starting E2E test suite...');

-  const PORT = process.env.PORT ? Number(process.env.PORT) : 3010;
-  const BASE_URL = process.env.BASE_URL || `http://localhost:${PORT}`;
+  const PORT = process.env.PORT ? Number(process.env.PORT) : 3006;
+  baseUrl = process.env.BASE_URL || `http://localhost:${PORT}`;

-  console.log(`Base URL: ${BASE_URL}`);
+  console.log(`Base URL: ${baseUrl}`);
+
+  // Seed test user before starting web server
+  await seedTestUser();

  // Start web server if not using external BASE_URL
  if (!process.env.BASE_URL) {
    await startWebServer({
-      command: 'npm run dev',
+      command: `bunx next start -p ${PORT}`,
      port: PORT,
      reuseExistingServer: !process.env.CI,
+      timeout: 60_000,
    });
  }
+
+  // Login once and cache the session cookies
+  console.log('🔐 Performing one-time login to cache session...');
+
+  const browser = await chromium.launch({ headless: process.env.HEADLESS !== 'false' });
+  const context = await browser.newContext();
+  const page = await context.newPage();
+
+  try {
+    // Navigate to signin page
+    await page.goto(`${baseUrl}/signin`, { waitUntil: 'networkidle' });
+
+    // Step 1: Enter email
+    console.log('   Step 1: Entering email...');
+    const emailInput = page.locator('input[id="email"]').first();
+    await emailInput.waitFor({ state: 'visible', timeout: 30_000 });
+    await emailInput.fill(TEST_USER.email);
+
+    // Click the next button
+    const nextButton = page.locator('form button').first();
+    await nextButton.click();
+
+    // Step 2: Wait for password step and enter password
+    console.log('   Step 2: Entering password...');
+    const passwordInput = page.locator('input[id="password"]').first();
+    await passwordInput.waitFor({ state: 'visible', timeout: 30_000 });
+    await passwordInput.fill(TEST_USER.password);
+
+    // Click submit button
+    const submitButton = page.locator('form button').first();
+    await submitButton.click();
+
+    // Wait for navigation away from signin page
+    await page.waitForURL((url) => !url.pathname.includes('/signin'), { timeout: 30_000 });
+    await page.waitForLoadState('networkidle');
+
+    // Cache the session cookies
+    sessionCookies = await context.cookies();
+    console.log(`✅ Login successful, cached ${sessionCookies.length} cookies`);
+  } finally {
+    await browser.close();
+  }
 });

 Before(async function (this: CustomWorld, { pickle }) {
@@ -30,6 +82,15 @@ Before(async function (this: CustomWorld, { pickle }) {

  const testId = pickle.tags.find((tag) => tag.name.startsWith('@DISCOVER-'));
  console.log(`\n📝 Running: ${pickle.name}${testId ? ` (${testId.name.replace('@', '')})` : ''}`);
+
+  // Setup API mocks before any page navigation
+  // await mockManager.setup(this.page);
+
+  // Set cached session cookies to skip login
+  if (sessionCookies.length > 0) {
+    await this.browserContext.addCookies(sessionCookies);
+    console.log('🍪 Session cookies restored');
+  }
 });

 After(async function (this: CustomWorld, { pickle, result }) {
@@ -0,0 +1,126 @@
+import bcrypt from 'bcryptjs';
+
+// Test user credentials - these are used for e2e testing only
+export const TEST_USER = {
+  email: 'e2e-test@lobehub.com',
+  fullName: 'E2E Test User',
+  id: 'user_e2e_test_user_001',
+  password: 'TestPassword123!',
+  username: 'e2e_test_user',
+};
+
+/**
+ * Create a bcrypt password hash
+ * Better Auth supports bcrypt for passwords migrated from Clerk
+ */
+async function hashPassword(password: string): Promise<string> {
+  return bcrypt.hash(password, 10);
+}
+
+/**
+ * Seed test user into the database for e2e testing
+ * This function connects directly to PostgreSQL and creates the necessary records
+ */
+export async function seedTestUser(): Promise<void> {
+  const databaseUrl = process.env.DATABASE_URL;
+
+  if (!databaseUrl) {
+    console.log('⚠️ DATABASE_URL not set, skipping test user seeding');
+    return;
+  }
+
+  // Dynamic import pg to avoid bundling issues
+  const { default: pg } = await import('pg');
+  const client = new pg.Client({ connectionString: databaseUrl });
+
+  try {
+    await client.connect();
+    console.log('🔌 Connected to database for test user seeding');
+
+    const now = new Date().toISOString();
+    // Use fixed account ID to avoid conflicts when multiple workers run concurrently
+    const accountId = 'e2e_test_account_001';
+
+    // Use upsert to handle concurrent worker execution
+    // Insert user or do nothing if already exists (handles all unique constraints)
+    const passwordHash = await hashPassword(TEST_USER.password);
+
+    // Use ON CONFLICT DO NOTHING to handle all unique constraint conflicts
+    // This is safe because we're using fixed test user credentials
+    // Set onboarding as completed to skip onboarding flow in tests
+    const onboarding = JSON.stringify({ finishedAt: now, version: 1 });
+
+    await client.query(
+      `INSERT INTO users (id, email, normalized_email, username, full_name, email_verified, onboarding, created_at, updated_at, last_active_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $8, $8)
+       ON CONFLICT (id) DO UPDATE SET onboarding = $7, updated_at = $8`,
+      [
+        TEST_USER.id,
+        TEST_USER.email,
+        TEST_USER.email.toLowerCase(),
+        TEST_USER.username,
+        TEST_USER.fullName,
+        true, // email_verified
+        onboarding,
+        now,
+      ],
+    );
+
+    // Create account record with password (for credential login)
+    await client.query(
+      `INSERT INTO accounts (id, user_id, account_id, provider_id, password, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $6)
+       ON CONFLICT DO NOTHING`,
+      [
+        accountId,
+        TEST_USER.id,
+        TEST_USER.email, // account_id is email for credential provider
+        'credential', // provider_id
+        passwordHash,
+        now,
+      ],
+    );
+
+    console.log('✅ Test user seeded successfully');
+    console.log(`   Email: ${TEST_USER.email}`);
+    console.log(`   Password: ${TEST_USER.password}`);
+  } catch (error) {
+    console.error('❌ Failed to seed test user:', error);
+    throw error;
+  } finally {
+    await client.end();
+  }
+}
+
+/**
+ * Clean up test user data after tests
+ */
+export async function cleanupTestUser(): Promise<void> {
+  const databaseUrl = process.env.DATABASE_URL;
+
+  if (!databaseUrl) {
+    return;
+  }
+
+  const { default: pg } = await import('pg');
+  const client = new pg.Client({ connectionString: databaseUrl });
+
+  try {
+    await client.connect();
+
+    // Delete sessions first (foreign key)
+    await client.query('DELETE FROM auth_sessions WHERE user_id = $1', [TEST_USER.id]);
+
+    // Delete accounts (foreign key)
+    await client.query('DELETE FROM accounts WHERE user_id = $1', [TEST_USER.id]);
+
+    // Delete user
+    await client.query('DELETE FROM users WHERE id = $1', [TEST_USER.id]);
+
+    console.log('🧹 Test user cleaned up');
+  } catch (error) {
+    console.error('❌ Failed to cleanup test user:', error);
+  } finally {
+    await client.end();
+  }
+}
@@ -1,9 +1,13 @@
 import { type ChildProcess, exec } from 'node:child_process';
+import { existsSync, unlinkSync, writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';

 let serverProcess: ChildProcess | null = null;
 let serverStartPromise: Promise<void> | null = null;

+// File-based lock to coordinate between parallel workers
+const LOCK_FILE = resolve(__dirname, '../../.server-starting.lock');
+
 interface WebServerOptions {
  command: string;
  env?: Record<string, string>;
@@ -24,7 +28,7 @@ async function isServerRunning(port: number): Promise<boolean> {
 }

 export async function startWebServer(options: WebServerOptions): Promise<void> {
-  const { command, port, timeout = 120_000, env = {}, reuseExistingServer = true } = options;
+  const { command, port, timeout = 30_000, env = {}, reuseExistingServer = true } = options;

  // If server is already being started by another worker, wait for it
  if (serverStartPromise) {
@@ -38,6 +42,51 @@ export async function startWebServer(options: WebServerOptions): Promise<void> {
    return;
  }

+  // Check if another worker is starting the server (file-based lock for cross-process coordination)
+  if (existsSync(LOCK_FILE)) {
+    console.log(`⏳ Another worker is starting the server, waiting...`);
+    const startTime = Date.now();
+    while (!(await isServerRunning(port))) {
+      if (Date.now() - startTime > timeout) {
+        // Lock file might be stale, try to clean up and proceed
+        try {
+          unlinkSync(LOCK_FILE);
+        } catch {
+          // Ignore
+        }
+        break;
+      }
+      await new Promise((resolve) => {
+        setTimeout(resolve, 1000);
+      });
+    }
+    if (await isServerRunning(port)) {
+      console.log(`✅ Server is now ready on port ${port}`);
+      return;
+    }
+  }
+
+  // Create lock file to signal other workers
+  try {
+    writeFileSync(LOCK_FILE, String(process.pid));
+  } catch {
+    // Another worker might have created it, check again
+    if (existsSync(LOCK_FILE)) {
+      console.log(`⏳ Lock file created by another worker, waiting...`);
+      const startTime = Date.now();
+      while (!(await isServerRunning(port))) {
+        if (Date.now() - startTime > timeout) {
+          throw new Error(`Server failed to start within ${timeout}ms`);
+        }
+        await new Promise((resolve) => {
+          setTimeout(resolve, 1000);
+        });
+      }
+      console.log(`✅ Server is now ready on port ${port}`);
+      return;
+    }
+  }
+
  // Create a promise for the server startup and store it
  serverStartPromise = (async () => {
    console.log(`🚀 Starting web server: ${command}`);
@@ -50,12 +99,20 @@ export async function startWebServer(options: WebServerOptions): Promise<void> {
      cwd: projectRoot,
      env: {
        ...process.env,
-        ENABLE_AUTH_PROTECTION: '0',
-        ENABLE_OIDC: '0',
-        NEXT_PUBLIC_ENABLE_CLERK_AUTH: '0',
-        NEXT_PUBLIC_ENABLE_NEXT_AUTH: '0',
+        // E2E test secret keys
+        BETTER_AUTH_SECRET: 'e2e-test-secret-key-for-better-auth-32chars!',
+        KEY_VAULTS_SECRET: 'LA7n9k3JdEcbSgml2sxfw+4TV1AzaaFU5+R176aQz4s=',
+        // Disable email verification for e2e
+        NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION: '0',
+        // Enable Better Auth for e2e tests with real authentication
+        NEXT_PUBLIC_ENABLE_BETTER_AUTH: '1',
        NODE_OPTIONS: '--max-old-space-size=6144',
        PORT: String(port),
+        // Mock S3 env vars to prevent initialization errors
+        S3_ACCESS_KEY_ID: 'e2e-mock-access-key',
+        S3_BUCKET: 'e2e-mock-bucket',
+        S3_ENDPOINT: 'https://e2e-mock-s3.localhost',
+        S3_SECRET_ACCESS_KEY: 'e2e-mock-secret-key',
        ...env,
      },
    });
@@ -93,4 +150,10 @@ export async function stopWebServer(): Promise<void> {
    serverProcess = null;
    serverStartPromise = null;
  }
+  // Clean up lock file
+  try {
+    unlinkSync(LOCK_FILE);
+  } catch {
+    // Ignore if file doesn't exist
+  }
 }
@@ -1,5 +1,7 @@
 import { IWorldOptions, World, setWorldConstructor } from '@cucumber/cucumber';
 import { Browser, BrowserContext, Page, Response, chromium } from '@playwright/test';
+import * as fs from 'node:fs';
+import * as path from 'node:path';

 export interface TestContext {
  [key: string]: any;
@@ -29,7 +31,7 @@ export class CustomWorld extends World {
  }

  async init() {
-    const PORT = process.env.PORT ? Number(process.env.PORT) : 3010;
+    const PORT = process.env.PORT ? Number(process.env.PORT) : 3006;
    const BASE_URL = process.env.BASE_URL || `http://localhost:${PORT}`;

    this.browser = await chromium.launch({
@@ -42,7 +44,7 @@ export class CustomWorld extends World {
    });

    // Set expect timeout for assertions (e.g., toBeVisible, toHaveText)
-    this.browserContext.setDefaultTimeout(120_000);
+    this.browserContext.setDefaultTimeout(30_000);

    this.page = await this.browserContext.newPage();

@@ -58,7 +60,7 @@ export class CustomWorld extends World {
      }
    });

-    this.page.setDefaultTimeout(120_000);
+    this.page.setDefaultTimeout(30_000);
  }

  async cleanup() {
@@ -68,8 +70,18 @@ export class CustomWorld extends World {
  }

  async takeScreenshot(name: string): Promise<Buffer> {
-    console.log(name);
-    return await this.page.screenshot({ fullPage: true });
+    const screenshot = await this.page.screenshot({ fullPage: true });
+
+    // Save screenshot to file
+    const screenshotsDir = path.join(process.cwd(), 'screenshots');
+    if (!fs.existsSync(screenshotsDir)) {
+      fs.mkdirSync(screenshotsDir, { recursive: true });
+    }
+    const filepath = path.join(screenshotsDir, `${name}.png`);
+    fs.writeFileSync(filepath, screenshot);
+    console.log(`📸 Screenshot saved: ${filepath}`);
+
+    return screenshot;
  }
 }

@@ -1,39 +1,39 @@
 {
-  "apikey.display.autoGenerated": "تم الإنشاء تلقائيًا",
+  "apikey.display.autoGenerated": "تم إنشاؤه تلقائيًا",
  "apikey.display.copy": "نسخ",
  "apikey.display.copyError": "فشل النسخ",
  "apikey.display.copySuccess": "تم نسخ مفتاح API إلى الحافظة",
-  "apikey.display.enterPlaceholder": "الرجاء الإدخال",
+  "apikey.display.enterPlaceholder": "يرجى الإدخال",
  "apikey.display.hide": "إخفاء",
-  "apikey.display.neverExpires": "لا تنتهي صلاحيتها أبدًا",
-  "apikey.display.neverUsed": "لم يُستخدم أبدًا",
-  "apikey.display.show": "عرض",
+  "apikey.display.neverExpires": "لا تنتهي صلاحيته",
+  "apikey.display.neverUsed": "لم يُستخدم من قبل",
+  "apikey.display.show": "إظهار",
  "apikey.form.fields.expiresAt.label": "تاريخ الانتهاء",
-  "apikey.form.fields.expiresAt.placeholder": "لا تنتهي صلاحيتها أبدًا",
+  "apikey.form.fields.expiresAt.placeholder": "لا تنتهي صلاحيته",
  "apikey.form.fields.name.label": "الاسم",
-  "apikey.form.fields.name.placeholder": "الرجاء إدخال اسم مفتاح API",
+  "apikey.form.fields.name.placeholder": "يرجى إدخال اسم مفتاح API",
  "apikey.form.submit": "إنشاء",
  "apikey.form.title": "إنشاء مفتاح API",
  "apikey.list.actions.create": "إنشاء مفتاح API",
  "apikey.list.actions.delete": "حذف",
  "apikey.list.actions.deleteConfirm.actions.cancel": "إلغاء",
  "apikey.list.actions.deleteConfirm.actions.ok": "تأكيد",
-  "apikey.list.actions.deleteConfirm.content": "هل أنت متأكد من حذف هذا المفتاح؟",
-  "apikey.list.actions.deleteConfirm.title": "تأكيد العملية",
+  "apikey.list.actions.deleteConfirm.content": "هل أنت متأكد أنك تريد حذف مفتاح API هذا؟",
+  "apikey.list.actions.deleteConfirm.title": "تأكيد الإجراء",
  "apikey.list.columns.actions": "الإجراءات",
  "apikey.list.columns.expiresAt": "تاريخ الانتهاء",
  "apikey.list.columns.key": "المفتاح",
  "apikey.list.columns.lastUsedAt": "آخر استخدام",
  "apikey.list.columns.name": "الاسم",
-  "apikey.list.columns.status": "حالة التفعيل",
+  "apikey.list.columns.status": "حالة التمكين",
  "apikey.list.title": "قائمة مفاتيح API",
-  "apikey.validation.required": "لا يمكن أن يكون المحتوى فارغًا",
+  "apikey.validation.required": "لا يمكن ترك هذا الحقل فارغًا",
  "betterAuth.errors.confirmPasswordRequired": "يرجى تأكيد كلمة المرور",
-  "betterAuth.errors.emailExists": "هذا البريد الإلكتروني مسجّل بالفعل، يرجى تسجيل الدخول مباشرة",
-  "betterAuth.errors.emailInvalid": "يرجى إدخال عنوان بريد إلكتروني صالح",
-  "betterAuth.errors.emailNotRegistered": "هذا البريد الإلكتروني غير مسجل",
-  "betterAuth.errors.emailNotVerified": "لم يتم التحقق من البريد الإلكتروني، يرجى التحقق أولاً",
-  "betterAuth.errors.emailRequired": "يرجى إدخال عنوان البريد الإلكتروني",
+  "betterAuth.errors.emailExists": "هذا البريد الإلكتروني مسجل بالفعل. يرجى تسجيل الدخول بدلاً من ذلك",
+  "betterAuth.errors.emailInvalid": "يرجى إدخال بريد إلكتروني أو اسم مستخدم صالح",
+  "betterAuth.errors.emailNotRegistered": "هذا البريد الإلكتروني أو اسم المستخدم غير مسجل",
+  "betterAuth.errors.emailNotVerified": "البريد الإلكتروني غير مفعل، يرجى تفعيله أولاً",
+  "betterAuth.errors.emailRequired": "يرجى إدخال بريدك الإلكتروني أو اسم المستخدم",
  "betterAuth.errors.firstNameRequired": "يرجى إدخال الاسم الأول",
  "betterAuth.errors.lastNameRequired": "يرجى إدخال اسم العائلة",
  "betterAuth.errors.loginFailed": "فشل تسجيل الدخول، يرجى التحقق من البريد الإلكتروني وكلمة المرور",
@@ -44,77 +44,82 @@
  "betterAuth.errors.passwordRequired": "يرجى إدخال كلمة المرور",
  "betterAuth.errors.usernameNotRegistered": "اسم المستخدم هذا غير مسجل",
  "betterAuth.errors.usernameRequired": "يرجى إدخال اسم المستخدم",
-  "betterAuth.resetPassword.backToSignIn": "العودة إلى تسجيل الدخول",
+  "betterAuth.resetPassword.backToSignIn": "العودة لتسجيل الدخول",
  "betterAuth.resetPassword.confirmPasswordPlaceholder": "تأكيد كلمة المرور الجديدة",
  "betterAuth.resetPassword.confirmPasswordRequired": "يرجى تأكيد كلمة المرور الجديدة",
  "betterAuth.resetPassword.description": "يرجى إدخال كلمة المرور الجديدة",
-  "betterAuth.resetPassword.error": "فشل إعادة تعيين كلمة المرور، يرجى المحاولة مرة أخرى",
+  "betterAuth.resetPassword.error": "فشل في إعادة تعيين كلمة المرور، يرجى المحاولة مرة أخرى",
  "betterAuth.resetPassword.invalidToken": "رابط إعادة التعيين غير صالح أو منتهي الصلاحية",
  "betterAuth.resetPassword.newPasswordPlaceholder": "أدخل كلمة المرور الجديدة",
  "betterAuth.resetPassword.passwordMismatch": "كلمتا المرور غير متطابقتين",
  "betterAuth.resetPassword.submit": "إعادة تعيين كلمة المرور",
-  "betterAuth.resetPassword.success": "تمت إعادة تعيين كلمة المرور بنجاح، يرجى تسجيل الدخول باستخدام كلمة المرور الجديدة",
+  "betterAuth.resetPassword.success": "تمت إعادة تعيين كلمة المرور بنجاح، يرجى تسجيل الدخول بكلمة المرور الجديدة",
  "betterAuth.resetPassword.title": "إعادة تعيين كلمة المرور",
-  "betterAuth.signin.backToEmail": "العودة لتعديل البريد الإلكتروني",
-  "betterAuth.signin.continueWithApple": "تسجيل الدخول باستخدام Apple",
+  "betterAuth.signin.backToEmail": "العودة لتغيير البريد الإلكتروني",
+  "betterAuth.signin.continueWithApple": "المتابعة باستخدام Apple",
  "betterAuth.signin.continueWithAuth0": "تسجيل الدخول باستخدام Auth0",
  "betterAuth.signin.continueWithAuthelia": "تسجيل الدخول باستخدام Authelia",
  "betterAuth.signin.continueWithAuthentik": "تسجيل الدخول باستخدام Authentik",
  "betterAuth.signin.continueWithCasdoor": "تسجيل الدخول باستخدام Casdoor",
  "betterAuth.signin.continueWithCloudflareZeroTrust": "تسجيل الدخول باستخدام Cloudflare Zero Trust",
-  "betterAuth.signin.continueWithCognito": "تسجيل الدخول باستخدام AWS Cognito",
+  "betterAuth.signin.continueWithCognito": "المتابعة باستخدام AWS Cognito",
  "betterAuth.signin.continueWithFeishu": "تسجيل الدخول باستخدام Feishu",
-  "betterAuth.signin.continueWithGithub": "تسجيل الدخول باستخدام GitHub",
-  "betterAuth.signin.continueWithGoogle": "تسجيل الدخول باستخدام Google",
+  "betterAuth.signin.continueWithGithub": "المتابعة باستخدام GitHub",
+  "betterAuth.signin.continueWithGoogle": "المتابعة باستخدام Google",
  "betterAuth.signin.continueWithKeycloak": "تسجيل الدخول باستخدام Keycloak",
  "betterAuth.signin.continueWithLogto": "تسجيل الدخول باستخدام Logto",
-  "betterAuth.signin.continueWithMicrosoft": "تسجيل الدخول باستخدام Microsoft",
+  "betterAuth.signin.continueWithMicrosoft": "المتابعة باستخدام Microsoft",
  "betterAuth.signin.continueWithOIDC": "تسجيل الدخول باستخدام OIDC",
  "betterAuth.signin.continueWithOkta": "تسجيل الدخول باستخدام Okta",
  "betterAuth.signin.continueWithWechat": "تسجيل الدخول باستخدام WeChat",
  "betterAuth.signin.continueWithZitadel": "تسجيل الدخول باستخدام Zitadel",
-  "betterAuth.signin.emailPlaceholder": "يرجى إدخال عنوان البريد الإلكتروني",
+  "betterAuth.signin.emailPlaceholder": "أدخل بريدك الإلكتروني أو اسم المستخدم",
  "betterAuth.signin.emailStep.title": "تسجيل الدخول",
  "betterAuth.signin.error": "فشل تسجيل الدخول، يرجى التحقق من البريد الإلكتروني وكلمة المرور",
  "betterAuth.signin.forgotPassword": "هل نسيت كلمة المرور؟",
-  "betterAuth.signin.forgotPasswordError": "فشل إرسال رابط إعادة تعيين كلمة المرور",
+  "betterAuth.signin.forgotPasswordError": "فشل في إرسال رابط إعادة تعيين كلمة المرور",
  "betterAuth.signin.forgotPasswordSent": "تم إرسال رابط إعادة تعيين كلمة المرور، يرجى التحقق من بريدك الإلكتروني",
+  "betterAuth.signin.invalidReferralCodeContent": "رمز الإحالة \"{{code}}\" الذي استخدمته غير صالح أو منتهي الصلاحية. هل ترغب في المتابعة؟",
+  "betterAuth.signin.invalidReferralCodeTitle": "رمز إحالة غير صالح",
  "betterAuth.signin.magicLinkButton": "إرسال رابط تسجيل الدخول",
-  "betterAuth.signin.magicLinkError": "فشل إرسال رابط تسجيل الدخول، يرجى المحاولة لاحقًا",
+  "betterAuth.signin.magicLinkError": "فشل في إرسال رابط تسجيل الدخول، يرجى المحاولة لاحقًا",
  "betterAuth.signin.magicLinkSent": "تم إرسال رابط تسجيل الدخول، يرجى التحقق من بريدك الإلكتروني",
-  "betterAuth.signin.nextStep": "الخطوة التالية",
+  "betterAuth.signin.nextStep": "التالي",
  "betterAuth.signin.noAccount": "ليس لديك حساب؟",
-  "betterAuth.signin.orContinueWith": "أو المتابعة باستخدام",
-  "betterAuth.signin.passwordPlaceholder": "يرجى إدخال كلمة المرور",
-  "betterAuth.signin.passwordStep.subtitle": "يرجى إدخال كلمة المرور للمتابعة",
+  "betterAuth.signin.orContinueWith": "أو",
+  "betterAuth.signin.passwordPlaceholder": "أدخل كلمة المرور",
+  "betterAuth.signin.passwordStep.subtitle": "أدخل كلمة المرور للمتابعة",
  "betterAuth.signin.signupLink": "سجّل الآن",
-  "betterAuth.signin.socialError": "فشل تسجيل الدخول عبر الشبكات الاجتماعية، يرجى المحاولة مرة أخرى",
-  "betterAuth.signin.socialOnlyHint": "تم تسجيل هذا البريد الإلكتروني باستخدام حساب اجتماعي، يرجى تسجيل الدخول باستخدامه",
+  "betterAuth.signin.socialError": "فشل تسجيل الدخول الاجتماعي، يرجى المحاولة مرة أخرى",
+  "betterAuth.signin.socialOnlyHint": "تم تسجيل هذا البريد الإلكتروني باستخدام حساب اجتماعي. يرجى تسجيل الدخول باستخدام مزود الخدمة المناسب.",
  "betterAuth.signin.submit": "تسجيل الدخول",
-  "betterAuth.signup.confirmPasswordPlaceholder": "يرجى تأكيد كلمة المرور",
-  "betterAuth.signup.emailPlaceholder": "يرجى إدخال عنوان البريد الإلكتروني",
+  "betterAuth.signup.confirmPasswordPlaceholder": "تأكيد كلمة المرور",
+  "betterAuth.signup.emailPlaceholder": "أدخل عنوان بريدك الإلكتروني",
  "betterAuth.signup.error": "فشل التسجيل، يرجى المحاولة مرة أخرى",
  "betterAuth.signup.firstNamePlaceholder": "الاسم الأول",
-  "betterAuth.signup.hasAccount": "هل لديك حساب؟",
+  "betterAuth.signup.hasAccount": "هل لديك حساب بالفعل؟",
+  "betterAuth.signup.invalidReferralCodeContent": "رمز الإحالة \"{{code}}\" الذي أدخلته غير صالح أو منتهي الصلاحية. هل ترغب في المتابعة؟",
+  "betterAuth.signup.invalidReferralCodeTitle": "رمز إحالة غير صالح",
  "betterAuth.signup.lastNamePlaceholder": "اسم العائلة",
-  "betterAuth.signup.passwordPlaceholder": "يرجى إدخال كلمة المرور",
-  "betterAuth.signup.signinLink": "تسجيل الدخول الآن",
-  "betterAuth.signup.submit": "تسجيل",
-  "betterAuth.signup.subtitle": "ابدأ مساحة التعاون الخاصة بـ Agents",
+  "betterAuth.signup.passwordPlaceholder": "أدخل كلمة المرور",
+  "betterAuth.signup.referralCodePlaceholder": "رمز الإحالة (اختياري)",
+  "betterAuth.signup.signinLink": "سجّل الدخول الآن",
+  "betterAuth.signup.submit": "إنشاء حساب",
+  "betterAuth.signup.subtitle": "ابدأ مساحة التعاون الخاصة بك مع Agents",
  "betterAuth.signup.success": "تم التسجيل بنجاح! يرجى التحقق من بريدك الإلكتروني لتأكيد الحساب",
  "betterAuth.signup.title": "إنشاء حساب",
-  "betterAuth.signup.usernamePlaceholder": "يرجى إدخال اسم المستخدم",
-  "betterAuth.verifyEmail.backToSignIn": "العودة إلى تسجيل الدخول",
-  "betterAuth.verifyEmail.checkSpam": "إذا لم تتلقَ البريد الإلكتروني، يرجى التحقق من مجلد الرسائل غير المرغوب فيها",
+  "betterAuth.signup.usernamePlaceholder": "أدخل اسم المستخدم",
+  "betterAuth.verifyEmail.backToSignIn": "العودة لتسجيل الدخول",
+  "betterAuth.verifyEmail.checkSpam": "إذا لم يصلك البريد الإلكتروني، يرجى التحقق من مجلد الرسائل غير المرغوب فيها",
  "betterAuth.verifyEmail.description": "تم إرسال رسالة تحقق إلى {{email}}",
  "betterAuth.verifyEmail.resend.button": "إعادة إرسال رسالة التحقق",
-  "betterAuth.verifyEmail.resend.error": "فشل الإرسال، يرجى المحاولة لاحقًا",
+  "betterAuth.verifyEmail.resend.error": "فشل الإرسال. يرجى المحاولة لاحقًا.",
  "betterAuth.verifyEmail.resend.noEmail": "عنوان البريد الإلكتروني مفقود",
-  "betterAuth.verifyEmail.resend.success": "تمت إعادة إرسال رسالة التحقق، يرجى التحقق من بريدك الإلكتروني",
+  "betterAuth.verifyEmail.resend.success": "تمت إعادة إرسال رسالة التحقق. يرجى التحقق من بريدك الوارد.",
  "betterAuth.verifyEmail.title": "تحقق من بريدك الإلكتروني",
  "date.prevMonth": "الشهر الماضي",
  "date.recent30Days": "آخر 30 يومًا",
-  "footer.agreement": "بالمتابعة، فإنك تؤكد أنك قد قرأت ووافقت على <terms>الشروط والأحكام</terms> و<privacy>سياسة الخصوصية</privacy>",
+  "footer.agreement": "بالمتابعة، فإنك تؤكد أنك قرأت ووافقت على <terms>الشروط والأحكام</terms> و<privacy>سياسة الخصوصية</privacy>",
  "footer.privacy": "سياسة الخصوصية",
  "footer.terms": "شروط الخدمة",
  "header.desc": "إدارة معلومات حسابك.",
@@ -133,104 +138,110 @@
  "heatmaps.months.nov": "نوفمبر",
  "heatmaps.months.oct": "أكتوبر",
  "heatmaps.months.sep": "سبتمبر",
-  "heatmaps.tooltip": "{{date}} أرسل {{count}} رسائل في ذلك اليوم",
-  "heatmaps.totalCount": "إجمالي {{count}} رسائل أرسلت في العام الماضي",
+  "heatmaps.tooltip": "{{date}} تم إرسال {{count}} رسالة في هذا اليوم",
+  "heatmaps.totalCount": "تم إرسال ما مجموعه {{count}} رسالة خلال العام الماضي",
  "login": "تسجيل الدخول",
-  "loginOrSignup": "تسجيل الدخول / الاشتراك",
-  "profile.authorizations.actions.revoke": "إلغاء التفويض",
-  "profile.authorizations.revoke.description": "بعد إلغاء التفويض، لن يتمكن هذا التطبيق من الوصول إلى بياناتك. لإعادة استخدامه، ستحتاج إلى منحه التفويض مرة أخرى.",
-  "profile.authorizations.revoke.title": "هل أنت متأكد من إلغاء التفويض لـ {{name}}؟",
+  "loginGuide.f1": "احصل على استخدام مجاني",
+  "loginGuide.f2": "مزامنة الرسائل عبر الأجهزة",
+  "loginGuide.f3": "الوصول إلى مجموعة كبيرة من الوكلاء",
+  "loginGuide.f4": "استكشاف الإضافات القوية",
+  "loginGuide.title": "بعد تسجيل الدخول، يمكنك:",
+  "loginOrSignup": "تسجيل الدخول / إنشاء حساب",
+  "profile.account": "الحساب",
+  "profile.authorizations.actions.revoke": "إلغاء",
+  "profile.authorizations.revoke.description": "بعد الإلغاء، لن يتمكن الأداة من الوصول إلى بياناتك. ستحتاج إلى إعادة التفويض لاستخدامها مرة أخرى.",
+  "profile.authorizations.revoke.title": "هل تريد إلغاء تفويض {{name}}؟",
  "profile.authorizations.title": "إدارة التفويضات",
-  "profile.avatar": "الصورة الشخصية",
+  "profile.avatar": "الصورة الرمزية",
  "profile.cancel": "إلغاء",
  "profile.changePassword": "إعادة تعيين كلمة المرور",
  "profile.email": "عنوان البريد الإلكتروني",
  "profile.fullName": "الاسم الكامل",
-  "profile.fullNameInputHint": "يرجى إدخال الاسم الكامل الجديد",
-  "profile.interests": "مجالات الاهتمام",
+  "profile.fullNameInputHint": "يرجى إدخال اسمك الكامل الجديد",
+  "profile.interests": "الاهتمامات",
  "profile.interestsAdd": "إضافة",
-  "profile.interestsPlaceholder": "أدخل مجالات الاهتمام",
+  "profile.interestsPlaceholder": "أدخل اهتمامًا",
  "profile.password": "كلمة المرور",
-  "profile.resetPasswordError": "فشل إرسال رابط إعادة تعيين كلمة المرور",
+  "profile.resetPasswordError": "فشل في إرسال رابط إعادة تعيين كلمة المرور",
  "profile.resetPasswordSent": "تم إرسال رابط إعادة تعيين كلمة المرور، يرجى التحقق من بريدك الإلكتروني",
  "profile.save": "حفظ",
  "profile.setPassword": "تعيين كلمة المرور",
  "profile.sso.link.button": "ربط الحساب",
  "profile.sso.link.success": "تم ربط الحساب بنجاح",
-  "profile.sso.loading": "جارٍ تحميل الحسابات المرتبطة من طرف ثالث",
-  "profile.sso.providers": "الحسابات المتصلة",
-  "profile.sso.unlink.description": "بعد إلغاء الربط، لن تتمكن من تسجيل الدخول باستخدام حساب {{provider}} \"{{providerAccountId}}\". إذا كنت ترغب في ربط حساب {{provider}} بهذا الحساب مرة أخرى، يرجى التأكد من أن عنوان البريد الإلكتروني لحساب {{provider}} هو {{email}}، وسنقوم بربطه تلقائيًا عند تسجيل الدخول.",
-  "profile.sso.unlink.forbidden": "يجب أن تحتفظ بحساب طرف ثالث واحد على الأقل مرتبطًا.",
-  "profile.sso.unlink.title": "هل تريد فصل حساب الطرف الثالث {{provider}}؟",
-  "profile.title": "تفاصيل الملف الشخصي",
-  "profile.updateAvatar": "تحديث الصورة الشخصية",
+  "profile.sso.loading": "جاري تحميل الحسابات المرتبطة من جهات خارجية",
+  "profile.sso.providers": "الحسابات المرتبطة",
+  "profile.sso.unlink.description": "ستحتاج إلى إعادة التفويض أو الربط لتسجيل الدخول باستخدام {{provider}} مرة أخرى بعد إلغاء الربط.",
+  "profile.sso.unlink.forbidden": "يجب الاحتفاظ بطريقة تسجيل دخول واحدة على الأقل.",
+  "profile.sso.unlink.title": "هل تريد إلغاء ربط حساب {{provider}}؟",
+  "profile.title": "الملف الشخصي",
+  "profile.updateAvatar": "تحديث الصورة الرمزية",
  "profile.updateFullName": "تحديث الاسم الكامل",
-  "profile.updateInterests": "تحديث مجالات الاهتمام",
+  "profile.updateInterests": "تحديث الاهتمامات",
  "profile.updateUsername": "تحديث اسم المستخدم",
  "profile.username": "اسم المستخدم",
  "profile.usernameDuplicate": "اسم المستخدم مستخدم بالفعل",
-  "profile.usernameInputHint": "يرجى إدخال اسم مستخدم جديد",
-  "profile.usernamePlaceholder": "يرجى إدخال اسم مستخدم مكوّن من أحرف أو أرقام أو شرطة سفلية",
-  "profile.usernameRequired": "اسم المستخدم لا يمكن أن يكون فارغًا",
-  "profile.usernameRule": "اسم المستخدم يجب أن يحتوي فقط على أحرف أو أرقام أو شرطة سفلية",
+  "profile.usernameInputHint": "يرجى إدخال اسم المستخدم الجديد",
+  "profile.usernamePlaceholder": "أدخل اسم مستخدم يحتوي على أحرف أو أرقام أو شرطة سفلية",
+  "profile.usernameRequired": "لا يمكن أن يكون اسم المستخدم فارغًا",
+  "profile.usernameRule": "يمكن أن يحتوي اسم المستخدم على أحرف أو أرقام أو شرطة سفلية فقط",
  "profile.usernameUpdateFailed": "فشل في تحديث اسم المستخدم، يرجى المحاولة لاحقًا",
-  "signin.subtitle": "سجّل أو قم بتسجيل الدخول إلى حسابك في {{appName}}",
-  "signin.title": "مساحة التعاون الخاصة بك في Agents",
+  "signin.subtitle": "سجّل أو قم بتسجيل الدخول إلى حساب {{appName}} الخاص بك",
+  "signin.title": "للتعاون مع الوكلاء",
  "signout": "تسجيل الخروج",
-  "signup": "الاشتراك",
+  "signup": "إنشاء حساب",
  "stats.aiheatmaps": "مؤشر النشاط",
-  "stats.assistants": "المساعدون",
-  "stats.assistantsRank.left": "المساعد",
+  "stats.assistants": "الوكلاء",
+  "stats.assistantsRank.left": "الوكيل",
  "stats.assistantsRank.right": "المواضيع",
-  "stats.assistantsRank.title": "ترتيب استخدام المساعد",
+  "stats.assistantsRank.title": "ترتيب استخدام الوكلاء",
  "stats.createdAt": "تاريخ التسجيل",
  "stats.days": "أيام",
-  "stats.empty.desc": "يرجى تجميع المزيد من بيانات الدردشة للعرض",
+  "stats.empty.desc": "يرجى جمع المزيد من بيانات الدردشة لعرضها",
  "stats.empty.title": "لا توجد بيانات",
-  "stats.lastYearActivity": "النشاط في العام الماضي",
+  "stats.lastYearActivity": "النشاط خلال العام الماضي",
  "stats.loginGuide.f1": "احصل على استخدام مجاني",
-  "stats.loginGuide.f2": "مزامنة الرسائل عبر الأجهزة المتعددة",
-  "stats.loginGuide.f3": "تمتع بمساعدين متنوعين",
-  "stats.loginGuide.f4": "استكشف الإضافات القوية",
-  "stats.loginGuide.title": "بعد تسجيل الدخول يمكنك:",
-  "stats.messages": "رسائل",
+  "stats.loginGuide.f2": "مزامنة الرسائل عبر الأجهزة",
+  "stats.loginGuide.f3": "الوصول إلى مجموعة كبيرة من الوكلاء",
+  "stats.loginGuide.f4": "استكشاف المهارات القوية",
+  "stats.loginGuide.title": "بعد تسجيل الدخول، يمكنك:",
+  "stats.messages": "الرسائل",
  "stats.modelsRank.left": "النموذج",
  "stats.modelsRank.right": "الرسائل",
-  "stats.modelsRank.title": "ترتيب استخدام النموذج",
-  "stats.share.title": "مؤشر نشاط الذكاء الاصطناعي الخاص بي",
+  "stats.modelsRank.title": "ترتيب استخدام النماذج",
+  "stats.share.title": "مؤشر نشاطي مع الذكاء الاصطناعي",
  "stats.topics": "المواضيع",
  "stats.topicsRank.left": "الموضوع",
  "stats.topicsRank.right": "الرسائل",
-  "stats.topicsRank.title": "ترتيب محتوى الموضوع",
-  "stats.updatedAt": "تاريخ التحديث",
-  "stats.welcome": "{{username}}، هذا هو يومك <span>{{days}}</span> مع {{appName}}",
-  "stats.words": "كلمات",
+  "stats.topicsRank.title": "ترتيب محتوى المواضيع",
+  "stats.updatedAt": "تم التحديث في",
+  "stats.welcome": "{{username}}، هذه هي يومك <span>{{days}}</span> مع {{appName}}",
+  "stats.words": "إجمالي الكلمات",
  "tab.apikey": "إدارة مفاتيح API",
  "tab.profile": "حسابي",
  "tab.security": "الأمان",
  "tab.stats": "الإحصائيات",
-  "tab.usage": "إحصاءات الاستخدام",
+  "tab.usage": "إحصائيات الاستخدام",
  "usage.activeModels.modelTable": "قائمة النماذج",
  "usage.activeModels.models": "النماذج النشطة",
  "usage.activeModels.providerTable": "قائمة المزودين",
  "usage.activeModels.providers": "المزودون النشطون",
-  "usage.activeModels.table.calls": "عدد الاستدعاءات",
+  "usage.activeModels.table.calls": "المكالمات",
  "usage.activeModels.table.model": "النموذج",
  "usage.activeModels.table.provider": "المزود",
-  "usage.activeModels.table.spend": "التكلفة",
-  "usage.cards.month.modelCalls": "استدعاءات النموذج",
-  "usage.cards.month.title": "إنفاق هذا الشهر",
+  "usage.activeModels.table.spend": "الإنفاق",
+  "usage.cards.month.modelCalls": "مكالمات النموذج",
+  "usage.cards.month.title": "الإنفاق هذا الشهر",
  "usage.cards.today.title": "إنفاق اليوم",
  "usage.cards.today.yesterday": "أمس",
-  "usage.table.actions": "إجراءات",
+  "usage.table.actions": "الإجراءات",
  "usage.table.createdAt": "وقت الاستخدام",
-  "usage.table.inputTokens": "رموز الإدخال",
+  "usage.table.inputTokens": "الرموز المدخلة",
  "usage.table.model": "النموذج",
-  "usage.table.outputTokens": "رموز الإخراج",
-  "usage.table.spend": "التكلفة",
+  "usage.table.outputTokens": "الرموز الناتجة",
+  "usage.table.spend": "الإنفاق",
  "usage.table.tps": "TPS",
  "usage.table.ttft": "TTFT",
-  "usage.table.type": "نوع الاستدعاء",
+  "usage.table.type": "نوع المكالمة",
  "usage.trends.spend": "المبلغ",
  "usage.trends.tokens": "الرموز",
  "usage.welcome.model": "النموذج",
@@ -1,36 +1,36 @@
 {
-  "actions.discord": "اذهب إلى Discord لإرسال الملاحظات",
+  "actions.discord": "اذهب إلى Discord للحصول على الملاحظات",
  "actions.home": "العودة إلى الصفحة الرئيسية",
  "actions.retry": "تسجيل الدخول مرة أخرى",
-  "codes.ACCOUNT_ALREADY_LINKED_TO_DIFFERENT_USER": "تم ربط هذا الحساب بمستخدم آخر",
+  "codes.ACCOUNT_ALREADY_LINKED_TO_DIFFERENT_USER": "هذا الحساب مرتبط بالفعل بمستخدم آخر",
  "codes.ACCOUNT_NOT_FOUND": "لم يتم العثور على الحساب",
  "codes.CREDENTIAL_ACCOUNT_NOT_FOUND": "حساب بيانات الاعتماد غير موجود",
-  "codes.EMAIL_CAN_NOT_BE_UPDATED": "لا يمكن تعديل البريد الإلكتروني لهذا الحساب",
+  "codes.EMAIL_CAN_NOT_BE_UPDATED": "لا يمكن تحديث البريد الإلكتروني لهذا الحساب",
  "codes.EMAIL_NOT_VERIFIED": "يرجى التحقق من بريدك الإلكتروني أولاً",
  "codes.FAILED_TO_CREATE_SESSION": "فشل في إنشاء الجلسة",
  "codes.FAILED_TO_CREATE_USER": "فشل في إنشاء المستخدم",
-  "codes.FAILED_TO_GET_SESSION": "فشل في الحصول على الجلسة",
-  "codes.FAILED_TO_GET_USER_INFO": "فشل في جلب معلومات المستخدم",
+  "codes.FAILED_TO_GET_SESSION": "فشل في استرجاع الجلسة",
+  "codes.FAILED_TO_GET_USER_INFO": "فشل في استرجاع معلومات المستخدم",
  "codes.FAILED_TO_UNLINK_LAST_ACCOUNT": "لا يمكن إلغاء ربط آخر حساب مرتبط",
  "codes.FAILED_TO_UPDATE_USER": "فشل في تحديث معلومات المستخدم",
  "codes.ID_TOKEN_NOT_SUPPORTED": "رمز الهوية غير مدعوم",
-  "codes.INVALID_EMAIL": "تنسيق البريد الإلكتروني غير صحيح",
+  "codes.INVALID_EMAIL": "تنسيق البريد الإلكتروني غير صالح",
  "codes.INVALID_EMAIL_OR_PASSWORD": "البريد الإلكتروني أو كلمة المرور غير صحيحة",
  "codes.INVALID_PASSWORD": "تنسيق كلمة المرور غير صالح",
  "codes.INVALID_TOKEN": "الرمز غير صالح أو منتهي الصلاحية",
  "codes.PASSWORD_TOO_LONG": "كلمة المرور طويلة جداً",
  "codes.PASSWORD_TOO_SHORT": "كلمة المرور قصيرة جداً",
-  "codes.PROVIDER_NOT_FOUND": "لم يتم العثور على مزود الهوية المناسب",
-  "codes.RATE_LIMIT_EXCEEDED": "عدد الطلبات كبير جداً، يرجى المحاولة لاحقاً",
-  "codes.SESSION_EXPIRED": "انتهت صلاحية الجلسة، يرجى تسجيل الدخول مجدداً",
-  "codes.SOCIAL_ACCOUNT_ALREADY_LINKED": "تم ربط هذا الحساب الاجتماعي بمستخدم آخر",
+  "codes.PROVIDER_NOT_FOUND": "لم يتم العثور على إعدادات موفر الهوية",
+  "codes.RATE_LIMIT_EXCEEDED": "عدد كبير جداً من الطلبات، يرجى المحاولة لاحقاً",
+  "codes.SESSION_EXPIRED": "انتهت صلاحية الجلسة، يرجى تسجيل الدخول مرة أخرى",
+  "codes.SOCIAL_ACCOUNT_ALREADY_LINKED": "هذا الحساب الاجتماعي مرتبط بالفعل بمستخدم آخر",
  "codes.UNEXPECTED_ERROR": "حدث خطأ غير متوقع، يرجى المحاولة مرة أخرى",
  "codes.UNKNOWN": "حدث خطأ غير معروف، يرجى المحاولة مرة أخرى أو التواصل مع الدعم",
  "codes.USER_ALREADY_EXISTS": "المستخدم موجود بالفعل",
-  "codes.USER_ALREADY_EXISTS_USE_ANOTHER_EMAIL": "تم استخدام هذا البريد الإلكتروني، يرجى تجربة بريد آخر",
-  "codes.USER_ALREADY_HAS_PASSWORD": "تم تعيين كلمة مرور لهذا الحساب مسبقاً",
+  "codes.USER_ALREADY_EXISTS_USE_ANOTHER_EMAIL": "البريد الإلكتروني مستخدم بالفعل، يرجى تجربة بريد آخر",
+  "codes.USER_ALREADY_HAS_PASSWORD": "هذا الحساب يحتوي بالفعل على كلمة مرور",
  "codes.USER_BANNED": "تم حظر هذا المستخدم",
  "codes.USER_EMAIL_NOT_FOUND": "لم يتم العثور على البريد الإلكتروني",
  "codes.USER_NOT_FOUND": "لم يتم العثور على المستخدم",
-  "title": "حدث خطأ في التحقق من الهوية"
+  "title": "خطأ في المصادقة"
 }
--- a/Show More
+++ b/Show More