docs: improve README product previews

.github/readme-assets/asset-manifest.json

@@ -0,0 +1,38 @@
+{
+  "ui_assets_complete": true,
+  "semantic_media_policy": "Use real ReplyPier interface captures; do not substitute generated product mockups.",
+  "assets": [
+    {
+      "file": "replypier-agent-customization.png",
+      "role": "AI agent appearance editor and live widget preview",
+      "source": "Saved local ReplyPier interface capture, cropped to the main workspace",
+      "alt": "ReplyPier 客服配置工作台，左侧调整聊天外观，右侧即时预览访客窗口",
+      "usage": "README product overview"
+    },
+    {
+      "file": "replypier-visitor-chat.png",
+      "role": "Visitor-facing chat widget",
+      "source": "User-provided real widget capture; the avatar marks were updated to the selected paper-boat brand asset",
+      "alt": "ReplyPier 网站客服聊天窗口，纸舟标志显示在客服头像与页脚图标处",
+      "usage": "README visitor-side preview"
+    }
+  ],
+  "omitted": [
+    {
+      "item": "Generated service-flow illustration and 340 x 280 widget crop",
+      "reason": "Replaced with two larger, distinct interface views"
+    }
+  ],
+  "qa": [
+    {
+      "file": "replypier-agent-customization.png",
+      "status": "passed",
+      "checks": ["chrome controls removed", "live preview visible", "alt text present"]
+    },
+    {
+      "file": "replypier-visitor-chat.png",
+      "status": "passed",
+      "checks": ["full widget visible", "paper-boat marks applied", "message text preserved", "alt text present"]
+    }
+  ]
+}

.github/readme-assets/replypier-service-flow.svg

@@ -1,41 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1440 410" role="img" aria-labelledby="title desc">
-  <title id="title">ReplyPier 客服服务闭环</title>
-  <desc id="desc">AI 知识问答、人工客服接手、结束服务并评价。</desc>
-  <rect width="1440" height="410" rx="28" fill="#F5F7F2"/>
-  <text x="720" y="52" text-anchor="middle" fill="#24332D" font-family="-apple-system, BlinkMacSystemFont, 'PingFang SC', sans-serif" font-size="25" font-weight="700">一段对话，从 AI 到人工，顺畅接力</text>
-  <text x="720" y="80" text-anchor="middle" fill="#69766F" font-family="-apple-system, BlinkMacSystemFont, 'PingFang SC', sans-serif" font-size="15">保留上下文 · 按权限接待 · 服务结果可回看</text>
-
-  <g font-family="-apple-system, BlinkMacSystemFont, 'PingFang SC', sans-serif">
-    <rect x="40" y="112" width="400" height="250" rx="22" fill="#FFFFFF" stroke="#DDE5DC"/>
-    <circle cx="91" cy="171" r="31" fill="#EAF2EC"/>
-    <path d="M74 156h34a6 6 0 0 1 6 6v17a6 6 0 0 1-6 6H91l-10 8v-8h-7a6 6 0 0 1-6-6v-17a6 6 0 0 1 6-6Z" fill="#2E6A5C"/>
-    <circle cx="83" cy="171" r="2.3" fill="#FFFFFF"/>
-    <circle cx="91" cy="171" r="2.3" fill="#FFFFFF"/>
-    <circle cx="99" cy="171" r="2.3" fill="#FFFFFF"/>
-    <text x="139" y="165" fill="#24332D" font-size="21" font-weight="700">AI 知识问答</text>
-    <text x="139" y="193" fill="#69766F" font-size="14">从关联知识库中寻找答案</text>
-    <path d="M68 232h344" stroke="#E8ECE6"/>
-    <text x="68" y="275" fill="#2E6A5C" font-size="14" font-weight="600">知识来源可追溯</text>
-    <text x="68" y="302" fill="#77837C" font-size="13">资料不足时，明确反馈或转人工</text>
-
-    <rect x="520" y="112" width="400" height="250" rx="22" fill="#FFFFFF" stroke="#DDE5DC"/>
-    <circle cx="571" cy="171" r="31" fill="#F9ECE7"/>
-    <path d="M554 166v-4a17 17 0 0 1 34 0v4M554 165h5v14h-5a4 4 0 0 1-4-4v-6a4 4 0 0 1 4-4Zm34 0h-5v14h5a4 4 0 0 0 4-4v-6a4 4 0 0 0-4-4Zm-17-6a7 7 0 1 0 0 14 7 7 0 0 0 0-14Zm-12 28c2-6 8-9 12-9s10 3 12 9" fill="none" stroke="#C96F5A" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
-    <text x="619" y="165" fill="#24332D" font-size="21" font-weight="700">人工客服接手</text>
-    <text x="619" y="193" fill="#69766F" font-size="14">在同一会话中继续服务</text>
-    <path d="M548 232h344" stroke="#E8ECE6"/>
-    <text x="548" y="275" fill="#2E6A5C" font-size="14" font-weight="600">上下文保留，授权后接待</text>
-    <text x="548" y="302" fill="#77837C" font-size="13">支持客服组、接管与转交</text>
-
-    <rect x="1000" y="112" width="400" height="250" rx="22" fill="#FFFFFF" stroke="#DDE5DC"/>
-    <circle cx="1051" cy="171" r="31" fill="#EEF1E6"/>
-    <path d="m1051 149 6.7 13.6 15 2.2-10.9 10.6 2.6 15-13.4-7-13.4 7 2.6-15-10.9-10.6 15-2.2Z" fill="#6D9678"/>
-    <text x="1099" y="165" fill="#24332D" font-size="21" font-weight="700">结束并评价</text>
-    <text x="1099" y="193" fill="#69766F" font-size="14">收集星级与文字反馈</text>
-    <path d="M1028 232h344" stroke="#E8ECE6"/>
-    <text x="1028" y="275" fill="#2E6A5C" font-size="14" font-weight="600">管理员查看服务结果</text>
-    <text x="1028" y="302" fill="#77837C" font-size="13">会话、接待人和评价连在一起</text>
-  </g>
-
-  <path d="M451 237h54m-12-9 12 9-12 9M931 237h54m-12-9 12 9-12 9" fill="none" stroke="#8BB49C" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
-</svg>

README.md

@@ -1,15 +1,13 @@
 <div align="center">
-  <img src="frontend/src/assets/logo.svg" width="76" height="57" alt="ReplyPier 纸舟标志" />
+  <img src="frontend/src/assets/logo.svg" width="64" height="48" alt="ReplyPier 纸舟标志" />
   <h1>ReplyPier</h1>
   <p><strong>AI 先答疑，人工接得住；一段会话，服务有始有终。</strong></p>
-  <p>面向个人与公司网站的 AI 客服：连接知识库问答、人工协作与服务评价。</p>
+  <p>面向个人与公司网站的 AI 客服，把知识问答、人工协作和服务评价连在一起。</p>
 
   <p>
     <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-2E6A5C?style=flat-square&logo=apache&logoColor=white" alt="Apache 2.0 License" /></a>
     <a href="backend/requirements.txt"><img src="https://img.shields.io/badge/Python-FastAPI-2E6A5C?style=flat-square&logo=fastapi&logoColor=white" alt="Python and FastAPI" /></a>
     <a href="frontend/package.json"><img src="https://img.shields.io/badge/Vue_3-TypeScript-568B73?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3 and TypeScript" /></a>
-    <a href="backend/requirements.txt"><img src="https://img.shields.io/badge/Realtime-Socket.IO-386A5B?style=flat-square&logo=socketdotio&logoColor=white" alt="Socket.IO" /></a>
-    <a href="backend/requirements.txt"><img src="https://img.shields.io/badge/Database-PostgreSQL_%2B_pgvector-587A91?style=flat-square&logo=postgresql&logoColor=white" alt="PostgreSQL and pgvector" /></a>
   </p>
 
   <p>
@@ -23,22 +21,24 @@
 
 ## 产品预览
 
-工作台可以直接预览访客看到的聊天窗口。下面是内置的 Widget 对话示例：
+先在工作台调整客服外观，再看右侧即时预览；访客侧窗口使用纸舟标志展示同一段对话。
+
+![ReplyPier 客服配置工作台，左侧调整聊天外观，右侧即时预览访客窗口](.github/readme-assets/replypier-agent-customization.png)
+
+<p align="center"><strong>访客看到的聊天窗口</strong></p>
 
 <p align="center">
-  <img src=".github/readme-assets/replypier-widget-preview.png" width="340" alt="ReplyPier 工作台中的网站客服 Widget 对话预览，使用纸舟头像展示一段示例问答" />
+  <img src=".github/readme-assets/replypier-visitor-chat.png" width="480" alt="ReplyPier 网站客服聊天窗口，纸舟标志显示在客服头像与页脚图标处" />
 </p>
 
-<p align="center"><img src=".github/readme-assets/replypier-service-flow.svg" width="100%" alt="客服服务流程：AI 知识问答、人工客服接手、结束服务并评价" /></p>
-
 ## 核心能力
 
-- 💬 **知识库问答**：为 AI 客服关联知识资料，并在 Widget 中展示回答来源。
+- **知识库问答**：为 AI 客服关联知识资料，并在 Widget 中展示回答来源。
-- 🤝 **同会话转人工**：保留聊天上下文，支持客服组接待、人工接管与授权转交。
+- **同会话转人工**：保留聊天上下文，支持客服组接待、人工接管与授权转交。
-- ⭐ **评价与回看**：收集星级和文字反馈，管理员可查看完整会话与接待情况。
+- **评价与回看**：收集星级和文字反馈，管理员可查看完整会话与接待情况。
-- 🔐 **多客服协作**：按角色、组织、分组和会话可见范围控制访问。
+- **多客服协作**：按角色、组织、分组和会话可见范围控制访问。
-- 🧩 **可配置 Agent 与 Widget**：管理 AI 客服、知识关联、外观和网站嵌入。
+- **可配置 Agent 与 Widget**：管理 AI 客服、知识关联、外观和网站嵌入。
-- ⚙️ **知识任务与工作流**：处理知识导入，并编排客服消息处理步骤。
+- **知识任务与工作流**：处理知识导入，并编排客服消息处理步骤。
 
 ## 技术结构