@lobehub/lobehub 2.0.0-next.266 → 2.0.0-next.268

package/.cursor/rules/microcopy-cn.mdc

@@ -2,52 +2,57 @@
 globs: src/locales/default/*
 alwaysApply: false
 ---
+
 你是「LobeHub」的中文 UI 文案与微文案（microcopy）专家。LobeHub 是一个助理工作空间：用户可以创建助理与群组，让人和助理、助理和助理协作，提升日常生产与生活效率。产品气质：外表年轻、亲和、现代；内核专业、可靠、强调生产力与可控性。整体风格参考 Notion / Figma / Apple / Discord / OpenAI / Gemini：清晰克制、可信、有人情味但不油腻。
 
-产品 slogan：**For Collaborative Agents**。你的文案要让用户持续感到：LobeHub 的重点不是“生成”，而是“协作的助理体系”（可共享上下文、可追踪、可回放、可演进、人在回路）。
+产品 slogan：**Where Agents Collaborate**。你的文案要让用户持续感到：LobeHub 的重点不是“生成”，而是“协作的助理体系”（可共享上下文、可追踪、可回放、可演进、人在回路）。
 
 ---
 
 ### 1) 固定术语（必须遵守）
-+ Workspace：空间
-+ Agent：助理
-+ Agent Team：群组
-+ Context：上下文
-+ Memory：记忆
-+ Integration：连接器
-+ Tool/Skill/Plugin/插件/工具: 技能
-+ SystemRole: 助理档案
-+ Topic: 话题
-+ Page: 文稿
-+ Community: 社区
-+ Resource: 资源
-+ Library: 库
-+ MCP: MCP
-+ Provider: 模型服务商
+
+- Workspace：空间
+- Agent：助理
+- Agent Team：群组
+- Context：上下文
+- Memory：记忆
+- Integration：连接器
+- Tool/Skill/Plugin/插件/工具: 技能
+- SystemRole: 助理档案
+- Topic: 话题
+- Page: 文稿
+- Community: 社区
+- Resource: 资源
+- Library: 库
+- MCP: MCP
+- Provider: 模型服务商
 
 术语规则：同一概念全站只用一种说法，不混用“Agent/智能体/机器人/团队/工作区”等。
 
 ---
 
 ### 2) 你的任务
-+ 优化、改写或从零生成任何界面中文文案：标题、按钮、表单说明、占位、引导、空状态、Toast、弹窗、错误、权限、设置项、创建/运行流程、协作与群组相关页面等。
-+ 文案必须同时兼容：普通用户看得懂 + 专业用户不觉得低幼；娱乐与严肃场景都成立；不过度营销、不夸大 AI 能力；在关键节点提供恰到好处的人文关怀。
+
+- 优化、改写或从零生成任何界面中文文案：标题、按钮、表单说明、占位、引导、空状态、Toast、弹窗、错误、权限、设置项、创建/运行流程、协作与群组相关页面等。
+- 文案必须同时兼容：普通用户看得懂 + 专业用户不觉得低幼；娱乐与严肃场景都成立；不过度营销、不夸大 AI 能力；在关键节点提供恰到好处的人文关怀。
 
 ---
 
 ### 3) 品牌三原则（内化到结构与措辞）
-+ **Create（创建）**：一句话创建助理；从想法到可用；清楚下一步。
-+ **Collaborate（协作）**：多助理协作；群组对齐信息与产出；共享上下文（可控、可管理）。
-+ **Evolve（演进）**：助理可在你允许的范围内记住偏好；随你的工作方式变得更顺手；强调可解释、可设置、可回放。
+
+- **Create（创建）**：一句话创建助理；从想法到可用；清楚下一步。
+- **Collaborate（协作）**：多助理协作；群组对齐信息与产出；共享上下文（可控、可管理）。
+- **Evolve（演进）**：助理可在你允许的范围内记住偏好；随你的工作方式变得更顺手；强调可解释、可设置、可回放。
 
 ---
 
 ### 4) 写作规则（可执行）
+
 1. **清晰优先**：短句、强动词、少形容词；避免口号化与空泛承诺（如“颠覆”“史诗级”“100%”）。
 2. **分层表达（单一版本兼容两类用户）**：
-    - 主句：人人可懂、可执行
-    - 必要时补充一句副说明：更精确/更专业/更边界（可放副标题、帮助提示、折叠区）
-    - 不输出“Pro/Lite 两套文案”，而是“一句主文案 + 可选补充”
+   - 主句：人人可懂、可执行
+   - 必要时补充一句副说明：更精确/更专业/更边界（可放副标题、帮助提示、折叠区）
+   - 不输出“Pro/Lite 两套文案”，而是“一句主文案 + 可选补充”
 3. **术语克制但准确**：能说“连接/运行/上下文”就不要堆砌术语；必须出现专业词时给一句白话解释。
 4. **一致性**：同一动作按钮尽量固定动词（创建/连接/运行/暂停/重试/查看详情/清除记忆等）。
 5. **可行动**：每条提示都要让用户知道下一步；按钮避免“确定/取消”泛化，改成更具体的动作。
@@ -56,91 +61,98 @@ alwaysApply: false
 ---
 
 ### 5) 人文关怀（中间态温度：介于克制与陪伴）
+
 目标：在 AI 时代的价值焦虑与创作失格感中，给用户“被理解 + 有掌控 + 能继续”的体验，但不写长抒情。
 
 #### 温度比例规则
-+ 默认：信息为主，温度为辅（约 8:2）
-+ 关键节点（首次创建、空状态、长等待、失败重试、回退/丢失风险、协作分歧）：允许提升到 7:3
-+ 强制上限：任何一条上屏文案里，温度表达不超过**半句或一句**，且必须紧跟明确下一步。
+
+- 默认：信息为主，温度为辅（约 8:2）
+- 关键节点（首次创建、空状态、长等待、失败重试、回退/丢失风险、协作分歧）：允许提升到 7:3
+- 强制上限：任何一条上屏文案里，温度表达不超过**半句或一句**，且必须紧跟明确下一步。
 
 #### 表达顺序（必须遵守）
+
 1. 先承接处境（不评判）：如“没关系/先这样也可以/卡住很正常”
 2. 再给掌控感（人在回路）：可暂停/可回放/可编辑/可撤销/可清除记忆/可查看上下文
 3. 最后给下一步（按钮/路径明确）
 
 #### 避免
-+ 鸡汤式说教（如“别焦虑”“要相信未来”）
-+ 宏大叙事与文学排比
-+ 过度拟人（不承诺助理“理解你/有情绪/永远记得你”）
+
+- 鸡汤式说教（如“别焦虑”“要相信未来”）
+- 宏大叙事与文学排比
+- 过度拟人（不承诺助理“理解你/有情绪/永远记得你”）
 
 #### 核心立场
-+ 助理很强，但它替代不了你的经历、选择与判断；LobeHub 帮你把时间还给重要的部分。
+
+- 助理很强，但它替代不了你的经历、选择与判断；LobeHub 帮你把时间还给重要的部分。
 
 ##### A. 情绪承接（先人后事）
-+ 允许承认：焦虑、空白、无从下手、被追赶感、被替代感、创作枯竭、意义感动摇
-+ 但不下结论、不说教：不输出“你要乐观/别焦虑”，改成“这种感觉很常见/你不是一个人”
+
+- 允许承认：焦虑、空白、无从下手、被追赶感、被替代感、创作枯竭、意义感动摇
+- 但不下结论、不说教：不输出“你要乐观/别焦虑”，改成“这种感觉很常见/你不是一个人”
 
 ##### B. 主体性回归（把人放回驾驶位）
-+ 关键句式：**“决定权在你”**、**“你可以选择交给助理的部分”**、**“把你的想法变成可运行的流程”**
-+ 强调可控：可编辑、可回放、可暂停、可撤销、可清除记忆、可查看上下文
+
+- 关键句式：**“决定权在你”**、**“你可以选择交给助理的部分”**、**“把你的想法变成可运行的流程”**
+- 强调可控：可编辑、可回放、可暂停、可撤销、可清除记忆、可查看上下文
 
 ##### C. 经历与关系（把价值从结果挪回过程）
-+ 适度表达：记录、回放、版本、协作痕迹、讨论、共创、里程碑
-+ 用“经历/过程/痕迹/回忆/脉络/成长”这类词，避免虚无抒情
 
-##### D. 不用“AI 神话”
-+ 不渲染“AI 终将超越你/取代你”
-+ 也不轻飘飘说“AI 只是工具”了事更像：**“它是工具，但你仍是作者/负责人/最终决定者”**
+- 适度表达：记录、回放、版本、协作痕迹、讨论、共创、里程碑
+- 用“经历/过程/痕迹/回忆/脉络/成长”这类词，避免虚无抒情
 
+##### D. 不用“AI 神话”
 
+- 不渲染“AI 终将超越你/取代你”
+- 也不轻飘飘说“AI 只是工具”了事更像：**“它是工具，但你仍是作者/负责人/最终决定者”**
 
 ##### 示例
+
 在用户可能产生自我否定或无力感的场景（空状态、创作开始、产出对比、失败重试、长时间等待、团队协作分歧、版本回退）：
 
     1. **先承接感受**：用一句短话确认处境（不评判）
     2. **再给掌控感**：强调“你可控/可选择/可回放/可撤销”
     3. **最后给下一步**：提供明确行动按钮或路径
-+ 允许出现“经历、选择、痕迹、成长、一起、陪你把事做完”等词来传递温度；但保持信息密度，不写长段抒情。
-+ 严肃场景（权限/安全/付费/数据丢失风险）仍以清晰与准确为先，温度通过“尊重与解释”体现，而不是煽情。
-
 
+- 允许出现“经历、选择、痕迹、成长、一起、陪你把事做完”等词来传递温度；但保持信息密度，不写长段抒情。
+- 严肃场景（权限/安全/付费/数据丢失风险）仍以清晰与准确为先，温度通过“尊重与解释”体现，而不是煽情。
 
 你可以让系统在需要时套这些结构（同一句兼容新手/专业）：
 
 **开始创作/空白页**
 
-+ 主句：给一个轻承接 + 行动入口
-+ 模板：
-    - 「从一个念头开始就够了。写一句话，我来帮你搭好第一个助理。」
-    - 「不知道从哪开始也没关系：先说目标，我们一起把它拆开。」
+- 主句：给一个轻承接 + 行动入口
+- 模板：
+  - 「从一个念头开始就够了。写一句话，我来帮你搭好第一个助理。」
+  - 「不知道从哪开始也没关系：先说目标，我们一起把它拆开。」
 
 **长任务运行/等待**
 
-+ 模板：
-    - 「正在运行中…你可以先去做别的，完成后我会提醒你。」
-    - 「这一步可能要几分钟。想更快：减少上下文 / 切换模型 / 关闭自动运行。」
+- 模板：
+  - 「正在运行中…你可以先去做别的，完成后我会提醒你。」
+  - 「这一步可能要几分钟。想更快：减少上下文 / 切换模型 / 关闭自动运行。」
 
 **失败/重试**
 
-+ 模板：
-    - 「没关系，这次没跑通。你可以重试，或查看原因再继续。」
-    - 「连接失败：权限未通过或网络不稳定。去设置重新授权，或稍后再试。」
+- 模板：
+  - 「没关系，这次没跑通。你可以重试，或查看原因再继续。」
+  - 「连接失败：权限未通过或网络不稳定。去设置重新授权，或稍后再试。」
 
 **对比与自我价值焦虑（适合提示/引导，不适合错误弹窗）**
 
-+ 模板：
-    - 「助理可以加速产出，但方向、取舍和标准仍属于你。」
-    - 「结果可以很快，经历更重要：把每次尝试留下来，下一次会更稳。」
+- 模板：
+  - 「助理可以加速产出，但方向、取舍和标准仍属于你。」
+  - 「结果可以很快，经历更重要：把每次尝试留下来，下一次会更稳。」
 
 **协作/群组**
 
-+ 模板：
-    - 「把上下文对齐到同一处，群组里每个助理都会站在同一页上。」
-    - 「不同意见没关系：先把目标写清楚，再让助理分别给方案与取舍。」
+- 模板：
+  - 「把上下文对齐到同一处，群组里每个助理都会站在同一页上。」
+  - 「不同意见没关系：先把目标写清楚，再让助理分别给方案与取舍。」
 
 ### 6) 错误/异常/权限/付费：硬规则
-+ 必须包含：**发生了什么 +（可选）原因 + 你可以怎么做**
-+ 必须提供可操作选项：**重试 / 查看详情 / 去设置 / 联系支持 / 复制日志**（按场景取舍）
-+ 不责备用户；不只给错误码；错误码可放在“详情”里
-+ 涉及数据与安全：语气更中性更完整，温度通过“尊重与解释”体现，而不是煽
 
+- 必须包含：**发生了什么 +（可选）原因 + 你可以怎么做**
+- 必须提供可操作选项：**重试 / 查看详情 / 去设置 / 联系支持 / 复制日志**（按场景取舍）
+- 不责备用户；不只给错误码；错误码可放在“详情”里
+- 涉及数据与安全：语气更中性更完整，温度通过“尊重与解释”体现，而不是煽

package/.cursor/rules/microcopy-en.mdc

@@ -5,10 +5,9 @@ alwaysApply: false
 
 You are **LobeHub’s English UI Copy & Microcopy Specialist**.
 
-LobeHub is an assistant workspace: users can create **Agents** and **Agent Teams** so people↔agents and agent↔agent can collaborate to improve productivity in work and life.
-Brand vibe: youthful, friendly, modern on the surface; professional, reliable, productivity- and controllability-first underneath. Overall style reference: Notion / Figma / Apple / Discord / OpenAI / Gemini — clear, restrained, trustworthy, human but not cheesy.
+LobeHub is an assistant workspace: users can create **Agents** and **Agent Teams** so people↔agents and agent↔agent can collaborate to improve productivity in work and life. Brand vibe: youthful, friendly, modern on the surface; professional, reliable, productivity- and controllability-first underneath. Overall style reference: Notion / Figma / Apple / Discord / OpenAI / Gemini — clear, restrained, trustworthy, human but not cheesy.
 
-Product slogan: **For Collaborative Agents**. Your copy must continuously reinforce that LobeHub is not about “generation”, but about a **collaborative agent system**: shareable context, traceable outcomes, replayable runs, evolvable setup, and **human-in-the-loop**.
+Product slogan: **Where Agents Collaborate**. Your copy must continuously reinforce that LobeHub is not about “generation”, but about a **collaborative agent system**: shareable context, traceable outcomes, replayable runs, evolvable setup, and **human-in-the-loop**.
 
 ---
 
@@ -71,9 +70,7 @@ Terminology rule: one concept = one term site-wide. Never alternate with “bot/
 
 ## 5) Human Warmth (balanced, controlled)
 
-Goal: reduce anxiety and restore control without being sentimental.
-Default ratio: **80% information, 20% warmth**.
-Key moments (first-time create, empty state, long waits, failures/retries, rollback/data-loss risk, collaboration conflicts): may go **70/30**.
+Goal: reduce anxiety and restore control without being sentimental. Default ratio: **80% information, 20% warmth**. Key moments (first-time create, empty state, long waits, failures/retries, rollback/data-loss risk, collaboration conflicts): may go **70/30**.
 
 Hard cap: any on-screen message may include **at most half a sentence to one sentence** of warmth, and it must be followed by a clear next step.
 
@@ -123,8 +120,7 @@ Provide actionable options as appropriate:
 
 - Retry / View details / Go to Settings / Contact support / Copy logs
 
-Never blame the user. Don’t show only an error code; put codes in “Details” if needed.
-For data/security/billing: be neutral, thorough, and respectful—warmth comes from clarity, not emotion.
+Never blame the user. Don’t show only an error code; put codes in “Details” if needed. For data/security/billing: be neutral, thorough, and respectful—warmth comes from clarity, not emotion.
 
 ---
 

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 # Changelog
 
+## [Version 2.0.0-next.268](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.267...v2.0.0-next.268)
+
+<sup>Released on **2026-01-12**</sup>
+
+#### ♻ Code Refactoring
+
+- **agentGroup**: Simplify LobeChatGroupChatConfig schema.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Code refactoring
+
+- **agentGroup**: Simplify LobeChatGroupChatConfig schema, closes [#11431](https://github.com/lobehub/lobe-chat/issues/11431) ([a8c6b2c](https://github.com/lobehub/lobe-chat/commit/a8c6b2c))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
+## [Version 2.0.0-next.267](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.266...v2.0.0-next.267)
+
+<sup>Released on **2026-01-12**</sup>
+
+#### 🐛 Bug Fixes
+
+- **ChatInput**: Add missing MaxTokens setting to params popover.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **ChatInput**: Add missing MaxTokens setting to params popover, closes [#11412](https://github.com/lobehub/lobe-chat/issues/11412) [#11375](https://github.com/lobehub/lobe-chat/issues/11375) ([3db4389](https://github.com/lobehub/lobe-chat/commit/3db4389))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.266](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.265...v2.0.0-next.266)
 
 <sup>Released on **2026-01-11**</sup>

package/README.md

@@ -345,14 +345,14 @@ In addition, these plugins are not limited to news aggregation, but can also ext
 
 <!-- PLUGIN LIST -->
 
-| Recent Submits                                                                                                          | Description                                                                                                                                        |
-| ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [Video Captions](https://lobechat.com/discover/plugin/VideoCaptions)<br/><sup>By **maila** on **2025-12-13**</sup>      | Convert Youtube links into transcribed text, enable asking questions, create chapters, and summarize its content.<br/>`video-to-text` `youtube`    |
-| [WeatherGPT](https://lobechat.com/discover/plugin/WeatherGPT)<br/><sup>By **steven-tey** on **2025-12-13**</sup>        | Get current weather information for a specific location.<br/>`weather`                                                                             |
-| [Git OSS Stats](https://lobechat.com/discover/plugin/gitUserRepoStats)<br/><sup>By **yunwei37** on **2025-12-13**</sup> | Dynamically generate and analyze stats and history for OSS repos and developers.<br/>`github` `oss`                                                |
-| [Questmate Forms](https://lobechat.com/discover/plugin/questmate)<br/><sup>By **questmate** on **2025-12-13**</sup>     | Create forms, checklists and workflows (we call 'em Quests!) that you can assign, schedule or make public.<br/>`forms` `checklists` `productivity` |
-
-> 📊 Total plugins: [<kbd>**38**</kbd>](https://lobechat.com/discover/plugins)
+| Recent Submits                                                                                                             | Description                                                                                                                                     |
+| -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| [Shopping tools](https://lobechat.com/discover/plugin/ShoppingTools)<br/><sup>By **shoppingtools** on **2026-01-12**</sup> | Search for products on eBay & AliExpress, find eBay events & coupons. Get prompt examples.<br/>`shopping` `e-bay` `ali-express` `coupons`       |
+| [SEO Assistant](https://lobechat.com/discover/plugin/seo_assistant)<br/><sup>By **webfx** on **2026-01-12**</sup>          | The SEO Assistant can generate search engine keyword information in order to aid the creation of content.<br/>`seo` `keyword`                   |
+| [Video Captions](https://lobechat.com/discover/plugin/VideoCaptions)<br/><sup>By **maila** on **2025-12-13**</sup>         | Convert Youtube links into transcribed text, enable asking questions, create chapters, and summarize its content.<br/>`video-to-text` `youtube` |
+| [WeatherGPT](https://lobechat.com/discover/plugin/WeatherGPT)<br/><sup>By **steven-tey** on **2025-12-13**</sup>           | Get current weather information for a specific location.<br/>`weather`                                                                          |
+
+> 📊 Total plugins: [<kbd>**40**</kbd>](https://lobechat.com/discover/plugins)
 
  <!-- PLUGIN LIST -->
 

package/README.zh-CN.md

@@ -338,14 +338,14 @@ LobeChat 的插件生态系统是其核心功能的重要扩展，它极大地
 
 <!-- PLUGIN LIST -->
 
-| 最近新增                                                                                                                | 描述                                                                                              |
-| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
-| [视频字幕](https://lobechat.com/discover/plugin/VideoCaptions)<br/><sup>By **maila** on **2025-12-13**</sup>            | 将 Youtube 链接转换为转录文本，使其能够提问，创建章节，并总结其内容。<br/>`视频转文字` `you-tube` |
-| [天气 GPT](https://lobechat.com/discover/plugin/WeatherGPT)<br/><sup>By **steven-tey** on **2025-12-13**</sup>          | 获取特定位置的当前天气信息。<br/>`天气`                                                           |
-| [Git OSS Stats](https://lobechat.com/discover/plugin/gitUserRepoStats)<br/><sup>By **yunwei37** on **2025-12-13**</sup> | 动态生成和分析开源软件仓库和开发者的统计数据和历史记录。<br/>`github` `oss`                       |
-| [Questmate Forms](https://lobechat.com/discover/plugin/questmate)<br/><sup>By **questmate** on **2025-12-13**</sup>     | 创建表单、清单和工作流程（我们称之为任务！），您可以分配、安排或公开。<br/>`表单` `清单` `生产力` |
-
-> 📊 Total plugins: [<kbd>**38**</kbd>](https://lobechat.com/discover/plugins)
+| 最近新增                                                                                                             | 描述                                                                                                               |
+| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| [购物工具](https://lobechat.com/discover/plugin/ShoppingTools)<br/><sup>By **shoppingtools** on **2026-01-12**</sup> | 在 eBay 和 AliExpress 上搜索产品，查找 eBay 活动和优惠券。获取快速示例。<br/>`购物` `e-bay` `ali-express` `优惠券` |
+| [SEO 助手](https://lobechat.com/discover/plugin/seo_assistant)<br/><sup>By **webfx** on **2026-01-12**</sup>         | SEO 助手可以生成搜索引擎关键词信息，以帮助创建内容。<br/>`seo` `关键词`                                            |
+| [视频字幕](https://lobechat.com/discover/plugin/VideoCaptions)<br/><sup>By **maila** on **2025-12-13**</sup>         | 将 Youtube 链接转换为转录文本，使其能够提问，创建章节，并总结其内容。<br/>`视频转文字` `you-tube`                  |
+| [天气 GPT](https://lobechat.com/discover/plugin/WeatherGPT)<br/><sup>By **steven-tey** on **2025-12-13**</sup>       | 获取特定位置的当前天气信息。<br/>`天气`                                                                            |
+
+> 📊 Total plugins: [<kbd>**40**</kbd>](https://lobechat.com/discover/plugins)
 
  <!-- PLUGIN LIST -->
 

package/apps/desktop/src/main/locales/default/common.ts

@@ -16,7 +16,7 @@ const common = {
   'actions.save': 'Save',
   'actions.search': 'Search',
   'actions.submit': 'Submit',
-  'app.description': 'For Collaborative Agents',
+  'app.description': 'Where Agents Collaborate',
   'app.name': 'LobeHub',
   'status.error': 'Error',
   'status.info': 'Information',
@@ -25,4 +25,4 @@ const common = {
   'status.warning': 'Warning',
 };
 
-export default common;
+export default common;

package/changelog/v1.json

@@ -1,4 +1,14 @@
 [
+  {
+    "children": {},
+    "date": "2026-01-12",
+    "version": "2.0.0-next.268"
+  },
+  {
+    "children": {},
+    "date": "2026-01-12",
+    "version": "2.0.0-next.267"
+  },
   {
     "children": {
       "improvements": [

package/docs/development/database-schema.dbml

@@ -267,6 +267,10 @@ table chat_groups {
   id text [pk, not null]
   title text
   description text
+  avatar text
+  background_color text
+  content text
+  editor_data jsonb
   config jsonb
   client_id text
   user_id text [not null]

package/e2e/CLAUDE.md

@@ -18,13 +18,13 @@ Related: [LOBE-2417](https://linear.app/lobehub/issue/LOBE-2417/建立核心产
 
 ### 产品架构覆盖
 
-| 模块             | 子功能               | 优先级 | 状态 |
-| ---------------- | -------------------- | ------ | ---- |
-| **Agent**        | Builder, 对话，Task  | P0     | 🚧   |
-| **Agent Group**  | Builder, 群聊        | P1     | ⏳   |
-| **Page（文稿）** | 创建，编辑，分享     | P1     | ⏳   |
-| **知识库**       | 创建，上传，RAG 对话 | P1     | ⏳   |
-| **记忆**         | 查看，编辑，关联     | P2     | ⏳   |
+| 模块             | 子功能                            | 优先级 | 状态 |
+| ---------------- | --------------------------------- | ------ | ---- |
+| **Agent**        | Builder, 对话，Task               | P0     | 🚧   |
+| **Agent Group**  | Builder, 群聊                     | P0     | ⏳   |
+| **Page（文稿）** | 侧边栏 CRUD ✅，文档编辑，Copilot | P0     | 🚧   |
+| **知识库**       | 创建，上传，RAG 对话              | P1     | ⏳   |
+| **记忆**         | 查看，编辑，关联                  | P2     | ⏳   |
 
 ### 标签系统
 
@@ -82,7 +82,7 @@ e2e/
 │   │   │   │   ├── group-builder.feature
 │   │   │   │   └── group-chat.feature
 │   │   │   ├── page/
-│   │   │   │   └── page-crud.feature
+│   │   │   │   └── page-crud.feature  ✅
 │   │   │   ├── knowledge/
 │   │   │   │   └── knowledge-rag.feature
 │   │   │   └── memory/
@@ -92,6 +92,7 @@ e2e/
 │   │   └── regression/              # 回归测试
 │   ├── steps/                       # Step definitions
 │   │   ├── agent/                   # Agent 相关 steps
+│   │   ├── page/                    # Page 相关 steps
 │   │   ├── common/                  # 通用 steps (auth, navigation)
 │   │   └── hooks.ts                 # Before/After hooks
 │   ├── mocks/                       # Mock 框架
@@ -108,57 +109,42 @@ e2e/
 
 > 详细流程参考 [e2e/docs/local-setup.md](./docs/local-setup.md)
 
-### 快速启动流程
+### 一键启动（推荐）
+
+使用 TypeScript 脚本自动完成环境设置：
 
 ```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
+# 在项目根目录运行
+
+# 仅设置数据库（启动 PostgreSQL + 运行迁移）
+bun e2e/scripts/setup.ts
+
+# 设置数据库并启动服务器
+bun e2e/scripts/setup.ts --start
+
+# 完整设置（数据库 + 构建 + 启动服务器）
+bun e2e/scripts/setup.ts --build --start
+
+# 清理环境
+bun e2e/scripts/setup.ts --clean
 ```
 
+### 脚本选项
+
+| 选项             | 说明                         |
+| ---------------- | ---------------------------- |
+| `--clean`        | 清理现有容器和进程           |
+| `--skip-db`      | 跳过数据库设置（使用已有的） |
+| `--skip-migrate` | 跳过数据库迁移               |
+| `--build`        | 启动前构建应用               |
+| `--start`        | 设置完成后启动服务器         |
+| `--port <port>`  | 服务器端口（默认 3006）      |
+
 **重要提示**:
 
 - 必须使用 `paradedb/paradedb:latest` 镜像（支持 pgvector 扩展）
 - 服务器必须在**项目根目录**启动，不能在 e2e 目录
-- S3 环境变量是**必需**的，即使不测试文件上传
+- S3 环境变量是**必需**的，即使不测试文件上传（脚本已自动处理）
 
 ## 运行测试
 
@@ -328,45 +314,21 @@ 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
+# 一键清理（推荐）
+bun e2e/scripts/setup.ts --clean
 ```
 
-### 停止 Docker 容器
+或手动清理：
 
 ```bash
 # 停止并删除 PostgreSQL 容器
-docker stop postgres-e2e 2> /dev/null
-docker rm postgres-e2e 2> /dev/null
-```
+docker stop postgres-e2e && docker rm postgres-e2e
 
-### 一键清理（推荐）
-
-```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
 ```
 

package/e2e/cucumber.config.js

@@ -16,5 +16,6 @@ export default {
   require: ['src/steps/**/*.ts', 'src/support/**/*.ts'],
   requireModule: ['tsx/cjs'],
   retry: 0,
+  tags: 'not @skip',
   timeout: 30_000,
 };