@lobehub/chat 0.128.2 → 0.128.4

package/docs/self-hosting/vercel.mdx

@@ -0,0 +1,39 @@
+import { Callout, Steps } from 'nextra/components';
+
+# Vercel Deployment Guide
+
+If you want to deploy LobeChat on Vercel, you can follow the steps below:
+
+## Vercel Deployment Process
+
+<Steps>
+
+### Prepare your OpenAI API Key
+
+Go to [OpenAI API Key](https://platform.openai.com/account/api-keys) to get your OpenAI API Key.
+
+### Click the button below to deploy
+
+[![][deploy-button-image]][deploy-link]
+
+[deploy-button-image]: https://vercel.com/button
+[deploy-link]: https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Flobehub%2Flobe-chat&env=OPENAI_API_KEY,ACCESS_CODE&envDescription=Find%20your%20OpenAI%20API%20Key%20by%20click%20the%20right%20Learn%20More%20button.%20%7C%20Access%20Code%20can%20protect%20your%20website&envLink=https%3A%2F%2Fplatform.openai.com%2Faccount%2Fapi-keys&project-name=lobe-chat&repository-name=lobe-chat
+
+Simply log in with your GitHub account, and remember to fill in `OPENAI_API_KEY` (required) and `ACCESS_CODE` (recommended) in the environment variables page.
+
+### After deployment, you can start using it
+
+### Bind a custom domain (optional)
+
+Vercel's assigned domain DNS may be polluted in some regions, so binding a custom domain can establish a direct connection.
+
+</Steps>
+
+## Automatic Synchronization of Updates
+
+If you have deployed your project using the one-click deployment steps mentioned above, you may find that you are always prompted with "updates available." This is because Vercel creates a new project for you by default instead of forking this project, which causes the inability to accurately detect updates.
+
+<Callout>
+  We recommend following the [Self-Hosting Upstream
+  Sync](/zh/self-hosting/upstream-sync) steps to Redeploy.
+</Callout>

package/docs/self-hosting/vercel.zh-CN.mdx

@@ -0,0 +1,39 @@
+import { Callout, Steps } from 'nextra/components';
+
+# Vercel 部署指引
+
+如果想在 Vercel 上部署 LobeChat，可以按照以下步骤进行操作：
+
+## Vercel 部署流程
+
+<Steps>
+
+### 准备好你的 OpenAI API Key
+
+前往 [OpenAI API Key](https://platform.openai.com/account/api-keys) 获取你的 OpenAI API Key
+
+### 点击下方按钮进行部署
+
+[![][deploy-button-image]][deploy-link]
+
+直接使用 GitHub 账号登录即可，记得在环境变量页填入 `OPENAI_API_KEY` （必填） and `ACCESS_CODE`（推荐）；
+
+[deploy-button-image]: https://vercel.com/button
+[deploy-link]: https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Flobehub%2Flobe-chat&env=OPENAI_API_KEY,ACCESS_CODE&envDescription=Find%20your%20OpenAI%20API%20Key%20by%20click%20the%20right%20Learn%20More%20button.%20%7C%20Access%20Code%20can%20protect%20your%20website&envLink=https%3A%2F%2Fplatform.openai.com%2Faccount%2Fapi-keys&project-name=lobe-chat&repository-name=lobe-chat
+
+### 部署完毕后，即可开始使用
+
+### 绑定自定义域名（可选）
+
+Vercel 分配的域名 DNS 在某些区域被污染了，绑定自定义域名即可直连。
+
+</Steps>
+
+## 自动同步更新
+
+如果你根据上述中的一键部署步骤部署了自己的项目，你可能会发现总是被提示 “有可用更新”。这是因为 Vercel 默认为你创建新项目而非 fork 本项目，这将导致无法准确检测更新。
+
+<Callout>
+  我们建议按照 [📘 LobeChat
+  自部署保持更新](/zh/self-hosting/upstream-sync) 步骤重新部署。
+</Callout>

package/docs/usage/agent-market.mdx

@@ -0,0 +1,35 @@
+import { Callout } from 'nextra/components';
+
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/268670869-f1ffbf66-42b6-42cf-a937-9ce1f8328514.png)
+
+# Assistant Market
+
+In LobeChat's Assistant Market, creators can discover a vibrant and innovative community that brings together numerous carefully designed assistants. These assistants not only play a crucial role in work scenarios but also provide great convenience in the learning process. Our market is not just a showcase platform, but also a collaborative space. Here, everyone can contribute their wisdom and share their personally developed assistants.
+
+<Callout type={'info'}>
+  By [🤖/🏪 submitting agents][submit-agents-link], you can easily submit your assistant works to
+  our platform. We particularly emphasize that LobeChat has established a sophisticated automated
+  internationalization (i18n) workflow, which excels in seamlessly converting your assistants into
+  multiple language versions. This means that regardless of the language your users are using, they
+  can seamlessly experience your assistant.{' '}
+</Callout>
+
+<Callout>
+  We welcome all users to join this ever-growing ecosystem and participate in the iteration and
+  optimization of assistants. Together, let's create more interesting, practical, and innovative
+  assistants, further enriching the diversity and practicality of assistants.
+</Callout>
+
+## Assistant Examples
+
+| Recently Added | Assistant Description |
+| --- | --- |
+| [Copywriting](https://chat-preview.lobehub.com/market?agent=copywriting)<br/><sup>By **[pllz7](https://github.com/pllz7)** on **2024-02-14**</sup> | Proficient in persuasive copywriting and consumer psychology<br/>`E-commerce` |
+| [Private Domain Operation Expert](https://chat-preview.lobehub.com/market?agent=gl-syyy)<br/><sup>By **[guling-io](https://github.com/guling-io)** on **2024-02-14**</sup> | Proficient in private domain operation, traffic acquisition, conversion, and content planning, familiar with marketing theories and related classic works.<br/>`Private domain operation` `Traffic acquisition` `Conversion` `Content planning` |
+| [Self-media Operation Expert](https://chat-preview.lobehub.com/market?agent=gl-zmtyy)<br/><sup>By **[guling-io](https://github.com/guling-io)** on **2024-02-14**</sup> | Proficient in self-media operation and content creation<br/>`Self-media operation` `Social media` `Content creation` `Fan growth` `Brand promotion` |
+| [Product Description](https://chat-preview.lobehub.com/market?agent=product-description)<br/><sup>By **[pllz7](https://github.com/pllz7)** on **2024-02-14**</sup> | Create captivating product descriptions to improve e-commerce sales performance<br/>`E-commerce` |
+
+> 📊 Total agents: [<kbd>**177**</kbd> ](https://github.com/lobehub/lobe-chat-agents)
+
+[submit-agents-link]: https://github.com/lobehub/lobe-chat-agents
+[submit-agents-shield]: https://img.shields.io/badge/🤖/🏪_submit_agent-%E2%86%92-c4f042?labelColor=black&style=for-the-badge

package/docs/usage/agent-market.zh-CN.mdx

@@ -0,0 +1,32 @@
+import { Callout } from 'nextra/components';
+
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/268670869-f1ffbf66-42b6-42cf-a937-9ce1f8328514.png)
+
+# 助手市场
+
+在 LobeChat 的助手市场中，创作者们可以发现一个充满活力和创新的社区，它汇聚了众多精心设计的助手，这些助手不仅在工作场景中发挥着重要作用，也在学习过程中提供了极大的便利。我们的市场不仅是一个展示平台，更是一个协作的空间。在这里，每个人都可以贡献自己的智慧，分享个人开发的助手。
+
+<Callout type={'info'}>
+  通过 [🤖/🏪 提交助手][submit-agents-link]
+  ，你可以轻松地将你的助手作品提交到我们的平台。我们特别强调的是，LobeChat
+  建立了一套精密的自动化国际化（i18n）工作流程，
+  它的强大之处在于能够无缝地将你的助手转化为多种语言版本。这意味着，不论你的用户使用何种语言，他们都能无障碍地体验到你的助手。
+</Callout>
+
+<Callout>
+  我们欢迎所有用户加入这个不断成长的生态系统，共同参与到助手的迭代与优化中来。共同创造出更多有趣、实用且具有创新性的助手，进一步丰富助手的多样性和实用性。
+</Callout>
+
+## 助手示例
+
+| 最近新增 | 助手说明 |
+| --- | --- |
+| [产品文案撰写](https://chat-preview.lobehub.com/market?agent=copywriting)<br/><sup>By **[pllz7](https://github.com/pllz7)** on **2024-02-14**</sup> | 精通有说服力的文案撰写和消费者心理学<br/>`电子商务` |
+| [私域运营专家](https://chat-preview.lobehub.com/market?agent=gl-syyy)<br/><sup>By **[guling-io](https://github.com/guling-io)** on **2024-02-14**</sup> | 擅长私域运营、引流、承接、转化和内容策划，熟悉营销理论和相关经典著作。<br/>`私域运营` `引流` `承接` `转化` `内容策划` |
+| [自媒体运营专家](https://chat-preview.lobehub.com/market?agent=gl-zmtyy)<br/><sup>By **[guling-io](https://github.com/guling-io)** on **2024-02-14**</sup> | 擅长自媒体运营与内容创作<br/>`自媒体运营` `社交媒体` `内容创作` `粉丝增长` `品牌推广` |
+| [产品描述](https://chat-preview.lobehub.com/market?agent=product-description)<br/><sup>By **[pllz7](https://github.com/pllz7)** on **2024-02-14**</sup> | 打造引人入胜的产品描述，提升电子商务销售业绩<br/>`电子商务` |
+
+> 📊 Total agents: [<kbd>**177**</kbd> ](https://github.com/lobehub/lobe-chat-agents)
+
+[submit-agents-link]: https://github.com/lobehub/lobe-chat-agents
+[submit-agents-shield]: https://img.shields.io/badge/🤖/🏪_submit_agent-%E2%86%92-c4f042?labelColor=black&style=for-the-badge

package/docs/usage/mobile.mdx

@@ -0,0 +1,8 @@
+![](https://gw.alipayobjects.com/zos/kitchen/R441AuFS4W/mobile.webp)
+
+# Mobile Device Adaptation
+
+LobeChat has undergone a series of optimized designs for mobile devices to enhance the user's mobile experience.
+
+Currently, we are iterating on the user experience for mobile devices to achieve a smoother and more intuitive interaction. If you have any suggestions or ideas, we warmly welcome your feedback through GitHub Issues or Pull Requests.
+

package/docs/usage/mobile.zh-CN.mdx

@@ -0,0 +1,7 @@
+![](https://gw.alipayobjects.com/zos/kitchen/R441AuFS4W/mobile.webp)
+
+# 移动设备适配
+
+LobeChat 针对移动设备进行了一系列的优化设计，以提升用户的移动体验。
+
+目前，我们正在对移动端的用户体验进行版本迭代，以实现更加流畅和直观的交互。如果您有任何建议或想法，我们非常欢迎您通过 GitHub Issues 或者 Pull Requests 提供反馈。

package/docs/usage/more.mdx

@@ -0,0 +1,21 @@
+import { Callout } from 'nextra/components';
+
+# More Features
+
+In addition to the above features, our design and technical capabilities will provide you with more assurance in usage:
+
+- [x] 💎 **Exquisite UI Design**: Carefully designed interface with elegant appearance and smooth interaction effects, supporting light and dark themes, and adaptable to mobile devices. Supports PWA, providing an experience closer to native applications.
+- [x] 🗣️ **Smooth Conversation Experience**: Responsive design brings a smooth conversation experience and supports full Markdown rendering, including code highlighting, LaTex formulas, Mermaid flowcharts, and more.
+- [x] 💨 **Fast Deployment**: Use the Vercel platform or our Docker image, simply click the deploy button, and deployment can be completed within 1 minute without complex configuration processes.
+- [x] 🔒 **Privacy and Security**: All data is stored locally in the user's browser, ensuring user privacy and security.
+- [x] 🌐 **Custom Domain**: If users have their own domain, they can bind it to the platform for quick access to the chat assistant from anywhere.
+
+> ✨ As the product continues to iterate, we will bring more exciting features!
+
+---
+
+<Callout>
+  You can find our upcoming [Roadmap][github-project-link] plans in the Projects section.
+</Callout>
+
+[github-project-link]: https://github.com/lobehub/lobe-chat/projects

package/docs/usage/more.zh-CN.mdx

@@ -0,0 +1,19 @@
+import { Callout } from 'nextra/components';
+
+# 更多特性
+
+除了上述功能特性以外，我们的所具有的设计和技术能力将为你带来了更多使用保障：
+
+- [x] 💎 **精致 UI 设计**：经过精心设计的界面，具有优雅的外观和流畅的交互效果，支持亮暗色主题，适配移动端。支持 PWA，提供更加接近原生应用的体验。
+- [x] 🗣️ **流畅的对话体验**：流式响应带来流畅的对话体验，并且支持完整的 Markdown 渲染，包括代码高亮、LaTex 公式、Mermaid 流程图等。
+- [x] 💨 **快速部署**：使用 Vercel 平台或者我们的 Docker 镜像，只需点击一键部署按钮，即可在 1 分钟内完成部署，无需复杂的配置过程。
+- [x] 🔒 **隐私安全**：所有数据保存在用户浏览器本地，保证用户的隐私安全。
+- [x] 🌐 **自定义域名**：如果用户拥有自己的域名，可以将其绑定到平台上，方便在任何地方快速访问对话助手。
+
+> ✨ 随着产品迭代持续更新，我们将会带来更多更多令人激动的功能！
+
+---
+
+<Callout>你可以在 Projects 中找到我们后续的 [Roadmap][github-project-link] 计划</Callout>
+
+[github-project-link]: https://github.com/lobehub/lobe-chat/projects

package/docs/usage/plugin-system.mdx

@@ -0,0 +1,84 @@
+import { Callout, Steps } from 'nextra/components';
+
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/268670883-33c43a5c-a512-467e-855c-fa299548cce5.png)
+
+# Plugin System
+
+The plugin ecosystem of LobeChat is an important extension of its core functionality, greatly enhancing the practicality and flexibility of the LobeChat assistant.
+
+<video
+  controls
+  src="https://github.com/lobehub/lobe-chat/assets/28616219/f29475a3-f346-4196-a435-41a6373ab9e2"
+  muted
+  loop
+></video>
+
+By utilizing plugins, LobeChat assistants can obtain and process real-time information, such as searching for web information and providing users with instant and relevant news.
+
+In addition, these plugins are not limited to news aggregation, but can also extend to other practical functions, such as quickly searching documents, generating images, obtaining data from various platforms like Bilibili, Steam, and interacting with various third-party services.
+
+Learn more about [plugin usage](/en-US/usage/plugins/basic) by checking it out.
+
+<Callout type={'default'}>
+  To help developers better participate in this ecosystem, we provide comprehensive development
+  resources. This includes detailed component development documentation, a fully-featured software
+  development kit (SDK), and template examples, all aimed at simplifying the development process and
+  lowering the entry barrier for developers.
+</Callout>
+
+<Callout type={'info'}>
+  We welcome developers to utilize these resources, unleash their creativity, and write
+  feature-rich, user-friendly plugins. Through collective efforts, we can continuously expand the
+  functional boundaries of the chat application and explore a more intelligent and efficient
+  creativity platform.
+</Callout>
+
+📊 Total plugins: [<kbd>**61**</kbd>](https://github.com/lobehub/lobe-chat-plugins)
+
+| Recently Added | Plugin Description |
+| --- | --- |
+| [Charts and Graphs](https://chat-preview.lobehub.com/settings/agent)<br/><sup>By **pyxl** on **2024-02-05**</sup> | Mermaid charts, presentation schemes, analysis, research websites, pie charts.<br/>`Charts` `Graphs` |
+| [Social Search](https://chat-preview.lobehub.com/settings/agent)<br/><sup>By **say-apps** on **2024-02-02**</sup> | Social search provides access to tweets, users, followers, images, media, and more.<br/>`Social` `Twitter` `x` `Search` |
+| [TokenInsights](https://chat-preview.lobehub.com/settings/agent)<br/><sup>By **feednews** on **2024-01-27**</sup> | Get real-time cryptocurrency prices, BTC, ETH, BNB, and the latest insights. The latest coin news and airdrop opportunities.<br/>`Cryptocurrency` `btc` `eth` `bnb` |
+| [Bilibili](https://chat-preview.lobehub.com/settings/agent)<br/><sup>By **LobeHub** on **2024-01-27**</sup> | Experience Bilibili's rich content through keyword video search, replay access, interactive barrage, popular video recommendations, and hot search insights, all at your fingertips.<br/>`Video` `Bilibili` `Search` |
+
+## Plugin Ecosystem
+
+<Callout>
+  If you are interested in plugin development, please refer to our [📘 Plugin Development
+  Guide](/en/usage/plugins/development) in the Wiki.
+</Callout>
+
+- [lobe-chat-plugins][lobe-chat-plugins]: This is the plugin index for LobeChat. It retrieves the list of plugins from the index.json of this repository and displays them to the users.
+- [chat-plugin-template][chat-plugin-template]: Chat Plugin plugin development template, you can quickly create a new plugin project through the project template.
+- [@lobehub/chat-plugin-sdk][chat-plugin-sdk]: The LobeChat plugin SDK can help you create excellent Lobe Chat plugins.
+- [@lobehub/chat-plugins-gateway][chat-plugins-gateway]: The LobeChat plugin gateway is a backend service that serves as the gateway for LobeChat plugins. We deploy this service using Vercel.
+
+### Roadmap Progress
+
+The plugin system of LobeChat has now entered a stable stage, and we have basically completed most of the functionality required by the plugin system. However, we are still planning and considering the new possibilities that plugins can bring to us. You can learn more in the following Issues:
+
+<Steps>
+
+### ✅ Phase One of Plugins
+
+Implementing the separation of plugins from the main body, splitting the plugins into independent repositories for maintenance, and implementing dynamic loading of plugins. [**#73**](https://github.com/lobehub/lobe-chat/issues/73)
+
+### ✅ Phase Two of Plugins
+
+The security and stability of plugin usage, more accurate presentation of abnormal states, maintainability and developer-friendliness of the plugin architecture. [**#97**](https://github.com/lobehub/lobe-chat/issues/97)
+
+### ✅ Phase Three of Plugins
+
+Higher-level and improved customization capabilities, support for OpenAPI schema invocation, compatibility with ChatGPT plugins, and the addition of Midjourney plugins. [**#411**](https://github.com/lobehub/lobe-chat/discussions/#411)
+
+### 💭 Phase Four of Plugins
+
+Comprehensive authentication, visual configuration of plugin definitions, Plugin SDK CLI, Python language development template, any other ideas? Join the discussion: [**#1310**](https://github.com/lobehub/lobe-chat/discussions/#1310)
+
+</Steps>
+
+[lobe-chat-plugins]: https://github.com/lobehub/lobe-chat-plugins
+[chat-plugin-sdk]: https://github.com/lobehub/chat-plugin-sdk
+[chat-plugin-template]: https://github.com/lobehub/chat-plugin-template
+[chat-plugins-gateway]: https://github.com/lobehub/chat-plugins-gateway

package/docs/usage/plugin-system.zh-CN.mdx

@@ -0,0 +1,77 @@
+import { Callout, Steps } from 'nextra/components';
+
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/268670883-33c43a5c-a512-467e-855c-fa299548cce5.png)
+
+# 插件系统
+
+LobeChat 的插件生态系统是其核心功能的重要扩展，它极大地增强了 LobeChat 助手的实用性和灵活性。
+
+<video
+  controls
+  src="https://github.com/lobehub/lobe-chat/assets/28616219/f29475a3-f346-4196-a435-41a6373ab9e2"
+  muted
+  loop
+></video>
+
+通过利用插件，LobeChat 的助手们能够实现实时信息的获取和处理，例如搜索网络信息，为用户提供即时且相关的资讯。
+
+此外，这些插件不仅局限于新闻聚合，还可以扩展到其他实用的功能，如快速检索文档、生成图片、获取 Bilibili 、Steam 等各种平台数据，以及与其他各式各样的第三方服务交互。
+
+通过查看 [插件使用](/zh/usage/plugins/basic) 了解更多。
+
+<Callout type={'default'}>
+  为了帮助开发者更好地参与到这个生态中来，我们在提供了全面的开发资源。这包括详尽的组件开发文档、功能齐全的软件开发工具包（SDK），以及样板示例，这些都是为了简化开发过程，降低开发者的入门门槛。
+</Callout>
+
+<Callout type={'info'}>
+  我们欢迎开发者利用这些资源，发挥创造力，编写出功能丰富、用户友好的插件。通过共同的努力，我们可以不断扩展聊天应用的功能界限，探索一个更加智能、高效的创造力平台。
+</Callout>
+
+📊 Total plugins: [<kbd>**61**</kbd>](https://github.com/lobehub/lobe-chat-plugins)
+
+| 最近新增 | 插件描述 |
+| --- | --- |
+| [图表和图示](https://chat-preview.lobehub.com/settings/agent)<br/><sup>By **pyxl** on **2024-02-05**</sup> | 美人鱼图表，演示文稿方案，分析，研究网站，饼图。<br/>`图表` `图示` |
+| [社交搜索](https://chat-preview.lobehub.com/settings/agent)<br/><sup>By **say-apps** on **2024-02-02**</sup> | 社交搜索提供访问推文、用户、关注者、图片、媒体等功能。<br/>`社交` `推特` `x` `搜索` |
+| [TokenInsights](https://chat-preview.lobehub.com/settings/agent)<br/><sup>By **feednews** on **2024-01-27**</sup> | 获取实时加密货币价格，BTC，ETH，BNB 和最新见解。最新的币新闻和空投机会。<br/>`加密货币` `btc` `eth` `bnb` |
+| [哔哩哔哩](https://chat-preview.lobehub.com/settings/agent)<br/><sup>By **LobeHub** on **2024-01-27**</sup> | 通过关键词视频搜索、回放访问、互动弹幕、热门视频推荐和热搜洞察等功能，深入体验哔哩哔哩丰富的内容，尽在您的指尖。<br/>`视频` `哔哩哔哩` `搜索` |
+
+## 插件生态体系
+
+<Callout>
+  如果你对插件开发感兴趣，请在 Wiki 中查阅我们的 [📘 插件开发指南](/zh/usage/plugins/development)。
+</Callout>
+
+- [lobe-chat-plugins][lobe-chat-plugins]：这是 LobeChat 的插件索引。它从该仓库的 index.json 中获取插件列表并显示给用户。
+- [chat-plugin-template][chat-plugin-template]: Chat Plugin 插件开发模版，你可以通过项目模版快速新建插件项目。
+- [@lobehub/chat-plugin-sdk][chat-plugin-sdk]：LobeChat 插件 SDK 可帮助您创建出色的 Lobe Chat 插件。
+- [@lobehub/chat-plugins-gateway][chat-plugins-gateway]：LobeChat 插件网关是一个后端服务，作为 LobeChat 插件的网关。我们使用 Vercel 部署此服务。
+
+[lobe-chat-plugins]: https://github.com/lobehub/lobe-chat-plugins
+[chat-plugin-sdk]: https://github.com/lobehub/chat-plugin-sdk
+[chat-plugin-template]: https://github.com/lobehub/chat-plugin-template
+[chat-plugins-gateway]: https://github.com/lobehub/chat-plugins-gateway
+
+### 路线进展
+
+LobeChat 的插件系统目前已初步进入一个稳定阶段，我们已基本完成大部分插件系统所需的功能，但我们仍然在规划与思考插件能为我们带来的全新可能性。您可以在以下 Issues 中了解更多信息:
+
+<Steps>
+
+### ✅ 插件一期
+
+实现插件与主体分离，将插件拆分为独立仓库维护，并实现插件的动态加载。 [**#73**](https://github.com/lobehub/lobe-chat/issues/73)
+
+### ✅ 插件二期
+
+插件的安全性与使用的稳定性，更加精准地呈现异常状态，插件架构的可维护性与开发者友好。[**#97**](https://github.com/lobehub/lobe-chat/issues/97)
+
+### ✅ 插件三期
+
+更高阶与完善的自定义能力，支持 OpenAPI schema 调用、兼容 ChatGPT 插件、新增 Midjourney 插件。 [**#411**](https://github.com/lobehub/lobe-chat/discussions/#411)
+
+### 💭 插件四期
+
+完善的鉴权、可视化配置插件定义、 Plugin SDK CLI 、 Python 语言研发模板、还有什么想法？欢迎参与讨论： [**#1310**](https://github.com/lobehub/lobe-chat/discussions/#1310)
+
+</Steps>

package/docs/usage/pwa.mdx

@@ -0,0 +1,21 @@
+import { Steps } from 'nextra/components';
+
+![](https://gw.alipayobjects.com/zos/kitchen/69x6bllkX3/pwa.webp)
+
+# Progressive Web App (PWA)
+
+We understand the importance of providing a seamless experience for users in today's multi-device environment. To achieve this, we have adopted Progressive Web App [PWA](https://support.google.com/chrome/answer/9658361) technology, which is a modern web technology that elevates web applications to a near-native app experience. Through PWA, LobeChat is able to provide a highly optimized user experience on both desktop and mobile devices, while maintaining lightweight and high performance characteristics. Visually and perceptually, we have also carefully designed it to ensure that its interface is indistinguishable from a native app, providing smooth animations, responsive layouts, and adaptation to different screen resolutions of various devices.
+
+If you are unfamiliar with the installation process of PWA, you can follow the steps below to add LobeChat as a desktop app (also applicable to mobile devices):
+
+<Steps>
+
+### Run Chrome or Edge browser on your computer
+
+### Visit the LobeChat webpage
+
+### In the top right corner of the address bar, click the <kbd>Install</kbd> icon
+
+### Follow the on-screen instructions to complete the PWA installation
+
+</Steps>

package/docs/usage/pwa.zh-CN.mdx

@@ -0,0 +1,21 @@
+import { Steps } from 'nextra/components';
+
+![](https://gw.alipayobjects.com/zos/kitchen/69x6bllkX3/pwa.webp)
+
+# 渐进式 Web 应用（PWA）
+
+我们利深知在当今多设备环境下为用户提供无缝体验的重要性。为此，我们采用了渐进式 Web 应用 [PWA](https://support.google.com/chrome/answer/9658361) 技术，这是一种能够将网页应用提升至接近原生应用体验的现代 Web 技术。通过 PWA，LobeChat 能够在桌面和移动设备上提供高度优化的用户体验，同时保持轻量级和高性能的特点。在视觉和感觉上，我们也经过精心设计，以确保它的界面与原生应用无差别，提供流畅的动画、响应式布局和适配不同设备的屏幕分辨率。
+
+若您未熟悉 PWA 的安装过程，您可以按照以下步骤将 LobeChat 添加为您的桌面应用（也适用于移动设备）：
+
+<Steps>
+
+### 在电脑上运行 Chrome 或 Edge 浏览器
+
+### 访问 LobeChat 网页
+
+### 在地址栏的右上角，单击 <kbd>安装</kbd> 图标
+
+### 根据屏幕上的指示完成 PWA 的安装
+
+</Steps>

package/docs/usage/text-to-image.mdx

@@ -0,0 +1,5 @@
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/297746445-0ff762b9-aa08-4337-afb7-12f932b6efbb.png)
+
+# Text to Image Generation
+
+Supporting the latest text-to-image generation technology, LobeChat now enables users to directly utilize the Text to Image tool during conversations with the assistant. By harnessing the capabilities of AI tools such as [DALL-E 3](https://openai.com/dall-e-3), [MidJourney](https://www.midjourney.com/), and [Pollinations](https://pollinations.ai/), assistants can now transform your ideas into images. This allows for a more private and immersive creative process.

package/docs/usage/text-to-image.zh-CN.mdx

@@ -0,0 +1,6 @@
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/297746445-0ff762b9-aa08-4337-afb7-12f932b6efbb.png)
+
+# Text to Image 文生图
+
+支持最新的文本到图片生成技术，LobeChat 现在能够让用户在与助手对话中直接调用文成图工具进行创作。通过利用 [`DALL-E 3`](https://openai.com/dall-e-3)、[`MidJourney`](https://www.midjourney.com/) 和 [`Pollinations`](https://pollinations.ai/) 等 AI 工具的能力， 助手们现在可以将你的想法转化为图像。同时可以更私密和沉浸式的完成你的创造过程。
+

package/docs/usage/theme.mdx

@@ -0,0 +1,17 @@
+import { Callout } from 'nextra/components';
+
+![](https://gw.alipayobjects.com/zos/kitchen/pvus1lo%26Z7/darkmode.webp)
+
+# Custom Themes
+
+LobeChat places a strong emphasis on personalized user experiences in its interface design, and thus introduces flexible and diverse theme modes, including a light mode for daytime and a dark mode for nighttime.
+
+In addition to theme mode switching, we also provide a series of color customization options, allowing users to adjust the application's theme colors according to their preferences. Whether it's a stable deep blue, a lively peach pink, or a professional gray and white, users can find color choices in LobeChat that match their own style.
+
+<Callout type={'info'}>
+  The default configuration can intelligently identify the user's system color mode and
+  automatically switch themes to ensure a consistent visual experience with the operating
+  system.
+</Callout>
+
+For users who prefer to manually adjust details, LobeChat also provides intuitive setting options and offers a choice between conversation bubble mode and document mode for chat scenes.

package/docs/usage/theme.zh-CN.mdx

@@ -0,0 +1,15 @@
+import { Callout } from 'nextra/components';
+
+![](https://gw.alipayobjects.com/zos/kitchen/pvus1lo%26Z7/darkmode.webp)
+
+# 自定义主题
+
+LobeChat 在界面设计上十分考虑用户的个性化体验，因此引入了灵活多变的主题模式，其中包括日间的亮色模式和夜间的深色模式。
+
+除了主题模式的切换，我们还提供了一系列的颜色定制选项，允许用户根据自己的喜好来调整应用的主题色彩。无论是想要沉稳的深蓝，还是希望活泼的桃粉，或者是专业的灰白，用户都能够在 LobeChat 中找到匹配自己风格的颜色选择。
+
+<Callout type={'info'}>
+  默认配置能够智能地识别用户系统的颜色模式，自动进行主题切换，以确保应用界面与操作系统保持一致的视觉体验。
+</Callout>
+
+对于喜欢手动调控细节的用户，LobeChat 同样提供了直观的设置选项，针对聊天场景也提供了对话气泡模式和文档模式的选择。

package/docs/usage/tts.mdx

@@ -0,0 +1,26 @@
+import { Callout } from 'nextra/components';
+
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/284072124-c9853d8d-f1b5-44a8-a305-45ebc0f6d19a.png)
+
+# TTS & STT Voice Conversation
+
+LobeChat supports Text-to-Speech (TTS) and Speech-to-Text (STT) technologies. Our application can convert text information into clear voice output, allowing users to interact with our conversational agents as if they were talking to a real person. Users can choose from a variety of voices and pair the appropriate audio with the assistant. Additionally, for users who prefer auditory learning or need to obtain information while busy, TTS provides an excellent solution.
+
+In LobeChat, we have carefully selected a series of high-quality voice options (OpenAI Audio, Microsoft Edge Speech) to meet the needs of users from different regions and cultural backgrounds. Users can choose suitable voices based on personal preferences or specific scenarios, thereby obtaining a personalized communication experience.
+
+## Lobe TTS
+
+![](https://camo.githubusercontent.com/278c08d77b754726f5ed40cb03bfc7a5632a69750518d11d140ae13ae06d0f48/68747470733a2f2f6769746875622d70726f64756374696f6e2d757365722d61737365742d3632313064662e73332e616d617a6f6e6177732e636f6d2f31373837303730392f3238343037373930392d38353463633039612d623363372d346663342d396561372d6637313337616262613335312e706e67)
+
+[@lobehub/tts](https://tts.lobehub.com) is a high-quality TTS toolkit developed using the TS language, supporting usage in both server and browser environments.
+
+- **Server**: With just 15 lines of code, it can achieve high-quality speech generation capabilities comparable to OpenAI TTS services. It currently supports EdgeSpeechTTS, MicrosoftTTS, OpenAITTS, and OpenAISTT.
+- **Browser**: It provides high-quality React Hooks and visual audio components, supporting common functions such as loading, playing, pausing, and dragging the timeline, and offering extensive audio track style adjustment capabilities.
+
+<Callout type={'info'}>
+  During the implementation of the TTS feature in LobeChat, we found that there was no good frontend
+  TTS library on the market, which resulted in a lot of effort being spent on implementation,
+  including data conversion, audio progress management, and speech visualization. Adhering to the
+  "Community First" concept, we have polished and open-sourced this implementation, hoping to help
+  community developers who want to implement TTS.
+</Callout>

package/docs/usage/tts.zh-CN.mdx

@@ -0,0 +1,24 @@
+import { Callout } from 'nextra/components';
+
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/284072124-c9853d8d-f1b5-44a8-a305-45ebc0f6d19a.png)
+
+# TTS & STT 语音会话
+
+LobeChat 支持文字转语音（Text-to-Speech，TTS）和语音转文字（Speech-to-Text，STT）技术，我们的应用能够将文本信息转化为清晰的语音输出，用户可以像与真人交谈一样与我们的对话代理进行交流。用户可以从多种声音中选择，给助手搭配合适的音源。 同时，对于那些倾向于听觉学习或者想要在忙碌中获取信息的用户来说，TTS 提供了一个极佳的解决方案。
+
+在 LobeChat 中，我们精心挑选了一系列高品质的声音选项 (OpenAI Audio, Microsoft Edge Speech)，以满足不同地域和文化背景用户的需求。用户可以根据个人喜好或者特定场景来选择合适的语音，从而获得个性化的交流体验。
+
+## Lobe TTS
+
+![](https://camo.githubusercontent.com/278c08d77b754726f5ed40cb03bfc7a5632a69750518d11d140ae13ae06d0f48/68747470733a2f2f6769746875622d70726f64756374696f6e2d757365722d61737365742d3632313064662e73332e616d617a6f6e6177732e636f6d2f31373837303730392f3238343037373930392d38353463633039612d623363372d346663342d396561372d6637313337616262613335312e706e67)
+
+[@lobehub/tts](https://tts.lobehub.com) 是一个使用 TS 语言开发的，高质量 TTS 工具包，支持在服务端和浏览器中使用。
+
+- **服务端**：只要使用 15 行代码，即可实现对标 OpenAI TTS 服务的高质量语音生成能力。目前支持 EdgeSpeechTTS 与 MicrosoftTTS 与 OpenAITTS、OpenAISTT。
+- **浏览器**：提供了高质量的 React Hooks 与可视化音频组件，支持加载、播放、暂停、拖动时间轴等常用功能，且提供了非常丰富的音轨样式调整能力。
+
+<Callout type={'info'}>
+  我们在实现 LobeChat 的 TTS 功能过程中，发现市面上并没有一款很好的 TTS
+  前端库，导致在实现上耗费了很多精力，包括数据转换、音频进度管理、语音可视化等。秉承「 Community
+  First 」 的理念，我们把这套实现打磨并开源了出来，希望能帮助到想要实现 TTS 的社区开发者们。
+</Callout>

package/docs/usage/vision.mdx

@@ -0,0 +1,8 @@
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/284072129-382bdf30-e3d6-4411-b5a0-249710b8ba08.png)
+
+#### Model Visual Recognition
+
+LobeChat now supports large language models with visual recognition capabilities such as OpenAI's [`gpt-4-vision`](https://platform.openai.com/docs/guides/vision), Google Gemini Pro vision, and Zhipu GLM-4 Vision, enabling LobeChat to have multimodal interaction capabilities. Users can easily upload or drag and drop images into the chat box, and the assistant will be able to recognize the content of the images and engage in intelligent conversations based on them, creating more intelligent and diverse chat scenarios.
+
+This feature opens up new ways of interaction, allowing communication to extend beyond text and encompass rich visual elements. Whether it's sharing images in daily use or interpreting images in specific industries, the assistant can provide an excellent conversational experience.
+

package/docs/usage/vision.zh-CN.mdx

@@ -0,0 +1,7 @@
+![](https://github-production-user-asset-6210df.s3.amazonaws.com/17870709/284072129-382bdf30-e3d6-4411-b5a0-249710b8ba08.png)
+
+#### 模型视觉识别
+
+LobeChat 已经支持 OpenAI 的 [`gpt-4-vision`](https://platform.openai.com/docs/guides/vision) 、Google Gemini Pro vision、智谱 GLM-4 Vision 等具有视觉识别能力的大语言模型，这使得 LobeChat 具备了多模态交互的能力。用户可以轻松上传图片或者拖拽图片到对话框中，助手将能够识别图片内容，并在此基础上进行智能对话，构建更智能、更多元化的聊天场景。
+
+这一特性打开了新的互动方式，使得交流不再局限于文字，而是可以涵盖丰富的视觉元素。无论是日常使用中的图片分享，还是在特定行业内的图像解读，助手都能提供出色的对话体验。

package/locales/ar/common.json

@@ -27,6 +27,7 @@
   "defaultAgent": "مساعد افتراضي",
   "defaultSession": "جلسة افتراضية",
   "delete": "حذف",
+  "document": "وثيقة الاستخدام",
   "duplicate": "إنشاء نسخة",
   "edit": "تحرير",
   "export": "تصدير الإعدادات",

package/locales/de-DE/common.json

@@ -27,6 +27,7 @@
   "defaultAgent": "Standardassistent",
   "defaultSession": "Standardassistent",
   "delete": "Löschen",
+  "document": "Dokumentation",
   "duplicate": "Duplikat erstellen",
   "edit": "Bearbeiten",
   "export": "Exportieren",

package/locales/en-US/common.json

@@ -27,6 +27,7 @@
   "defaultAgent": "Default Agent",
   "defaultSession": "Default Agent",
   "delete": "Delete",
+  "document": "User Manual",
   "duplicate": "Create Duplicate",
   "edit": "Edit",
   "export": "Export Configuration",

package/locales/es-ES/common.json

@@ -27,6 +27,7 @@
   "defaultAgent": "Asistente predeterminado",
   "defaultSession": "Sesión predeterminada",
   "delete": "Eliminar",
+  "document": "Documento de uso",
   "duplicate": "Duplicar",
   "edit": "Editar",
   "export": "Exportar configuración",

package/locales/fr-FR/common.json

@@ -27,6 +27,7 @@
   "defaultAgent": "Agent par défaut",
   "defaultSession": "Session par défaut",
   "delete": "Supprimer",
+  "document": "Document d'utilisation",
   "duplicate": "Dupliquer",
   "edit": "Modifier",
   "export": "Exporter",

package/locales/it-IT/common.json

@@ -27,6 +27,7 @@
   "defaultAgent": "Assistente predefinito",
   "defaultSession": "Sessione predefinita",
   "delete": "Elimina",
+  "document": "Documento di utilizzo",
   "duplicate": "Duplicato",
   "edit": "Modifica",
   "export": "Esporta configurazione",

package/locales/ja-JP/common.json

@@ -27,6 +27,7 @@
   "defaultAgent": "デフォルトエージェント",
   "defaultSession": "デフォルトセッション",
   "delete": "削除",
+  "document": "ドキュメント",
   "duplicate": "コピーを作成する",
   "edit": "編集",
   "export": "エクスポート",

package/locales/ko-KR/common.json

@@ -27,6 +27,7 @@
   "defaultAgent": "기본 에이전트",
   "defaultSession": "기본 세션",
   "delete": "삭제",
+  "document": "사용 설명서",
   "duplicate": "복제품 만들기",
   "edit": "편집",
   "export": "내보내기",