docs

README.md

@@ -1,4 +1,4 @@
-MemeMeow 是一个基于自然语言的表情包检索工具。它能让你通过描述想要的场景或心情，快速找到合适的表情包（无需记住具体的文件名或标签）。
+MemeMeow 是一个基于自然语言的表情包检索工具。它能自动标注表情包含义，并通过描述想要的场景或心情，快速找到合适的表情包（无需记住具体的文件名或标签）。
 
 > [!CAUTION]
 > 本项目返回的表情包结果均由 AI 理解和生成，与开发者本人观点无关。
@@ -7,18 +7,18 @@ MemeMeow 是一个基于自然语言的表情包检索工具。它能让你通
 
 ## ✨ 核心特性
 
+- **🧠 自动化语境理解**: **无需手动为表情包分类和标注**，内置 OpenCode Agent，选择完整分析上传图片时，Agent 会对图片进行结构化分析、生成语境和描述。
+- **📤 直接上传**: 无需运行 Agent 语境分析，使用有效文件名生成文本向量，同时生成图片视觉向量；后台根据图片内容尝试自动命名，生成有效名称后更新文本向量。
 - **🤖 自然语言检索**: 采用 Embedding 模型，实现 Q&A 式的检索，能够根据你的描述（如“表达无奈”）找到匹配的图片。
-- **🧠 自动化语境理解**: 内置 OpenCode Agent，当你上传图片时，Agent 会对图片进行结构化分析、生成语境和描述。
 - **👁️ 视觉近邻搜索**: 支持本地 DINOv2 视觉模型，实现图片之间的相似度搜索。
 - **📦 容器部署**: 提供 Vue 3 Web 界面和统一的 API，服务可通过 Docker Compose 启动。
-- **⚡ 任务调度**: 内置受控并发队列，支持长任务异步处理（如批量图片导入、后台模型推理），支持单机部署。
   ![截图](docs/images/image-preview-zh.png)
 
 ## 🚀 立即使用
 
-前往[MemeMeow官网](https://mememeow.cc) 立即开始使用，无需本地部署。
+前往[MemeMeow官网](https://mememeow.cc/home) 立即开始使用，无需本地部署。
 
-可在[Release](https://github.com/MemeMeow-Studio/MemeMeow/releases/tag/v0.1.0) 下载桌面端软件。移动端软件正在开发。
+支持浏览器直接使用，以及Windows，Android，macos和Linux主要发行版。可在官网下载软件。
 
 > 目前正处于早期测试阶段。可以提交issue或加入交流群反馈错误。
 
@@ -48,7 +48,7 @@ MemeMeow 是一个基于自然语言的表情包检索工具。它能让你通
 
 ### 3. 上传图片
 
-将本地的新表情包文件上传至系统并触发后台分析。
+将本地的新表情包文件上传至系统，上传成功后可以在图片库中浏览和管理。
 
 ![上传图片截图](docs/images/image-pre-upload-image-zh.png)
 
@@ -56,7 +56,10 @@ MemeMeow 是一个基于自然语言的表情包检索工具。它能让你通
   * **拖拽上传**：将单张图片或多张图片拖入虚线区域。
   * **剪贴板上传**：在页面中使用快捷键（如 `Ctrl+V` 或 `Cmd+V`）直接粘贴剪贴板中的图片。
   * **点击上传**：点击区域打开文件选择器选择本地文件。
-* **处理选项设置**：在确认提交前，可配置后台 Agent 对这批图片的分析规则：
+* **处理方式**：在确认提交前，可以选择“直接上传”或“完整分析”。一次选择超过 10 张图片时默认直接上传，10 张及以下默认完整分析，也可以手动修改：
+  * **直接上传**：使用有效文件名生成文本向量，并生成图片视觉向量。后台根据图片内容尝试自动命名，生成有效名称后更新文本向量，无需运行 Agent 语境分析。文件名为无意义的哈希值且没有其他有效检索文本时，文本向量暂时等待有效名称，图片视觉向量仍会正常生成。
+  * **完整分析**：运行 Agent 分析图片的出处、用法和含义，生成语境和描述，并生成检索所需的向量。
+* **完整分析选项**：选择完整分析时，可配置后台 Agent 对这批图片的分析规则：
   * **反向搜索策略**：设置在遇到较难理解的图片时，是否允许 Agent 使用谷歌进行联网以图搜图，从而获取图片的来源和背景信息。
   * **自动命名**：选择是否允许 AI 根据图片内容生成新的文件名。
 * **上传队列**：页面下方会显示当前批次文件的上传进度，并支持对上传失败的单个文件进行重试。
@@ -74,7 +77,7 @@ MemeMeow 是一个基于自然语言的表情包检索工具。它能让你通
 
 ## 本地部署
 
-本项目依赖容器化环境进行隔离与部署，请确保机器已安装 **Docker Engine** 与 **Compose v2 插件**。
+本项目依赖容器化环境进行隔离与部署，请确保机器已安装 **Docker Engine 28或以上** 与 **Compose v2 插件**。
 
 ### 1. 克隆代码与配置环境变量
 
@@ -98,7 +101,7 @@ uv run python -m scripts.sync_env
 该命令会启动 PostgreSQL（附带 pgvector）、代理执行器 (Agent Executor)、视觉服务以及后端 API 容器。
 服务启动成功后，浏览器访问 `http://127.0.0.1:8275/` 即可看到前端界面。
 
-### 3. 可选：下载本地视觉权重
+### 3. 下载本地视觉权重
 
 需要下载官方 DINOv2 权重：
 
@@ -110,7 +113,7 @@ curl -L --fail --output data/models/dinov2_vitb14_pretrain.pth \
 
 下载完成后，若环境配置无误，容器内部会自动挂载并启动服务。
 
-### 常用运维命令
+### 常用命令
 
 ```bash
 ./start.sh status         # 查看运行状态
@@ -134,7 +137,7 @@ MemeMeow 本质是一个 API 驱动的服务。如果你是开发者，可以直
 
 关于双环境隔离设计与作用域约束，请查阅 [应用作用域设计 (docs/application-scope.md)](docs/application-scope.md)。 -->
 
-官方MemeMeow API正在开发。同时，我们欢迎相关使用需求的讨论。您可以提出issue或加入Q群交流。
+> 官方MemeMeow API正在开发。同时，我们欢迎相关使用需求的讨论。您可以提出issue或加入Q群交流。
 
 ## 加入交流