diff --git a/.github/readme-assets/asset-manifest.json b/.github/readme-assets/asset-manifest.json index 880284b..d886f71 100644 --- a/.github/readme-assets/asset-manifest.json +++ b/.github/readme-assets/asset-manifest.json @@ -1,38 +1,51 @@ { "ui_assets_complete": true, "semantic_media_policy": "Use real ReplyPier interface captures; do not substitute generated product mockups.", + "capture_notes": "Captured at 100%-equivalent CSS layout through the shared CDP daemon at deviceScaleFactor 2, then downscaled to 1500 px wide (JPEG, quality 93, 4:4:4) for the README. Visible legacy brand strings in the UI (sidebar wordmark, widget footer, site title, page footer) were fixed in source before capture, so no text was rewritten in the browser for the shots.", "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-conversations.jpg", + "role": "Agent conversation workspace with a real AI answer, handoff and rating panel", + "source": "Local ReplyPier build, /conversations, 1600x900 CSS viewport at 2x", + "alt": "ReplyPier 会话工作台：访客提问、AI 依据知识库作答，转人工后由人工客服接管", + "usage": "README product overview (hero)" + }, + { + "file": "replypier-agent-customization.jpg", + "role": "AI agent appearance editor with live visitor-widget preview", + "source": "Local ReplyPier build, /ai-agents?tab=customization, 1440x900 CSS viewport at 2x, cropped below the save row", + "alt": "ReplyPier AI 客服配置页：左侧选择聊天外观，右侧即时预览访客窗口", + "usage": "README configuration preview" }, { "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 网站客服聊天窗口，纸舟标志显示在客服头像与页脚图标处", + "source": "Local ReplyPier build, widget on /local-demo.html, transparent background capture at 2x, alpha-trimmed", + "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" + "item": "Previous 900 px wide captures with a 75% browser zoom", + "reason": "Soft text and inconsistent crops; replaced with 2x captures and a single framing rule" } ], "qa": [ { - "file": "replypier-agent-customization.png", + "file": "replypier-conversations.jpg", "status": "passed", - "checks": ["chrome controls removed", "live preview visible", "alt text present"] + "checks": ["2x text rendering", "three-pane layout fully visible", "browser extension overlay removed from the right edge", "alt text present"] + }, + { + "file": "replypier-agent-customization.jpg", + "status": "passed", + "checks": ["ReplyPier wordmark", "live preview visible", "no cut card edges inside the frame", "alt text present"] }, { "file": "replypier-visitor-chat.png", "status": "passed", - "checks": ["full widget visible", "paper-boat marks applied", "message text preserved", "alt text present"] + "checks": ["full widget visible", "paper-boat marks applied", "footer shows ReplyPier", "transparent background", "alt text present"] } ] } diff --git a/.github/readme-assets/replypier-agent-customization.jpg b/.github/readme-assets/replypier-agent-customization.jpg new file mode 100644 index 0000000..e44d7e9 Binary files /dev/null and b/.github/readme-assets/replypier-agent-customization.jpg differ diff --git a/.github/readme-assets/replypier-agent-customization.png b/.github/readme-assets/replypier-agent-customization.png deleted file mode 100644 index b47c98f..0000000 Binary files a/.github/readme-assets/replypier-agent-customization.png and /dev/null differ diff --git a/.github/readme-assets/replypier-conversations.jpg b/.github/readme-assets/replypier-conversations.jpg new file mode 100644 index 0000000..8df0d59 Binary files /dev/null and b/.github/readme-assets/replypier-conversations.jpg differ diff --git a/.github/readme-assets/replypier-visitor-chat.png b/.github/readme-assets/replypier-visitor-chat.png index 958c858..fe76149 100644 Binary files a/.github/readme-assets/replypier-visitor-chat.png and b/.github/readme-assets/replypier-visitor-chat.png differ diff --git a/README.md b/README.md index 4541faa..5168598 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@
- ReplyPier 纸舟标志 + ReplyPier 纸舟标志

ReplyPier

AI 先答疑，人工接得住；一段会话，服务有始有终。

面向个人与公司网站的 AI 客服，把知识问答、人工协作和服务评价连在一起。

@@ -13,7 +13,7 @@

产品预览 · 核心能力 · - 本机使用 · + 快速开始 · 技术结构 · 开发指引

@@ -21,24 +21,61 @@ ## 产品预览 -先在工作台调整客服外观，再看右侧即时预览；访客侧窗口使用纸舟标志展示同一段对话。 - -![ReplyPier 客服配置工作台，左侧调整聊天外观，右侧即时预览访客窗口](.github/readme-assets/replypier-agent-customization.png) - -

访客看到的聊天窗口

+客服工作台是每天停留最久的一屏：左边是会话列表，中间是完整对话，右边是访客信息、接待状态和服务评价。

- ReplyPier 网站客服聊天窗口，纸舟标志显示在客服头像与页脚图标处 + ReplyPier 会话工作台：访客提问、AI 依据知识库作答，转人工后由人工客服接管 +

+ +

+ 会话工作台 · AI 依据知识库作答 → 转人工保留上下文 → 接待结束邀请访客评价 +

+ +AI 客服的外观、知识与接待方式都在同一页配置，右侧预览与访客看到的窗口一致。 + +

+ ReplyPier AI 客服配置页：左侧选择聊天外观，右侧即时预览访客窗口 +

+ +

+ AI 客服配置 · 左侧挑选聊天外观，右侧即时预览访客窗口 +

+ +访客侧只在网站右下角露出一枚悬浮按钮，点开就是带纸舟标志的聊天窗口。 + +

+ ReplyPier 网站右下角的访客聊天窗口，纸舟标志显示在客服头像与页脚 +

+ +

+ 访客窗口 · 悬浮展开，纸舟标志贯穿头像与页脚

## 核心能力 -- **知识库问答**：为 AI 客服关联知识资料，并在 Widget 中展示回答来源。 -- **同会话转人工**：保留聊天上下文，支持客服组接待、人工接管与授权转交。 +- **知识库问答**：为 AI 客服关联知识资料，回答时在 Widget 中展示来源。 +- **同会话转人工**：保留完整聊天上下文，支持客服组接待、人工接管与授权转交。 - **评价与回看**：收集星级和文字反馈，管理员可查看完整会话与接待情况。 - **多客服协作**：按角色、组织、分组和会话可见范围控制访问。 - **可配置 Agent 与 Widget**：管理 AI 客服、知识关联、外观和网站嵌入。 -- **知识任务与工作流**：处理知识导入，并编排客服消息处理步骤。 +- **知识任务与工作流**：处理知识导入，并编排客服消息的处理步骤。 + +## 快速开始 + +本机已具备 PostgreSQL + pgvector、Redis、Python 3.12 与 Node 环境时，在项目根目录执行： + +```bash +./deploy/local/local.sh setup # 首次运行：安装依赖并构建前端 +./deploy/local/local.sh up # 启动数据库、后端与前端 +./deploy/local/local.sh status # 查看各服务状态 +``` + +启动后可访问： + +- [客服工作台](http://127.0.0.1:3018/)：登录后处理会话、配置 AI 客服。 +- [悬浮客服演示页](http://127.0.0.1:3018/local-demo.html)：从访客视角提问、转人工并提交评价。 + +账号、构建、日志、数据恢复与公网接入条件见 [LOCAL_DEPLOY.md](LOCAL_DEPLOY.md)。 ## 技术结构 @@ -57,20 +94,6 @@ e2e/ 端到端测试 deploy/local/ 本机环境与启停脚本 ``` -## 本机使用 - -在项目根目录执行： - -```bash -./deploy/local/local.sh up -./deploy/local/local.sh status -``` - -- [客服工作台](http://127.0.0.1:3018/) -- [悬浮客服演示页](http://127.0.0.1:3018/local-demo.html) - -账号、构建、日志、数据恢复及公网接入条件见 [LOCAL_DEPLOY.md](LOCAL_DEPLOY.md)。 - ## 开发检查 - 后端测试位于 `backend/tests/`。 diff --git a/deploy/local/demo.template.html b/deploy/local/demo.template.html index d89c33f..951477a 100644 --- a/deploy/local/demo.template.html +++ b/deploy/local/demo.template.html @@ -4,7 +4,7 @@ - ChatterMate 网站客服测试 + ReplyPier 网站客服测试