From b7a81964c9821d38e0d4e8696090419afc05250c Mon Sep 17 00:00:00 2001
From: duanshuwen <duanshuwen@gogpay.cn>
Date: Sat, 22 Aug 2026 08:26:23 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E8=B7=AF=E7=BA=BF?=
 =?UTF-8?q?=E8=AF=A6=E6=83=85=E5=85=B3=E8=81=94=E7=AE=A1=E5=AE=B6=E9=A1=BE?=
 =?UTF-8?q?=E9=97=AE=E5=8F=8A=E7=9B=B8=E5=85=B3=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

详细变更如下：
- 更新 .gitignore 文件，添加 pnpm-store 忽略规则
- 新增数据库迁移脚本，为 DetailRecord 添加可空的 conciergeAdvisorId 字段用于关联管家顾问
- 完善 Admin 后台玩法详情编辑器，支持选择关联的管家顾问并校验合法性
- 公共 API 支持返回已启用的管家顾问完整数据，不在详情表中冗余存储管家资料
- 小程序端新增详情页联系管家入口、个人页最近浏览历史功能
- 更新所有相关文档与测试用例，修复下拉选择框的 z-index 样式问题
---
 .gitignore                                    |   1 +
 WonderQ-Admin-UI/src/api.ts                   |   1 +
 .../admin/WanfaRouteDetailFields.tsx          |  33 +++++-
 .../src/components/admin/WanfaRouteEditor.tsx |  12 ++-
 .../src/components/admin/WanfaRouteRail.tsx   |  11 +-
 WonderQ-Admin-UI/src/components/ui/select.tsx |   2 +-
 .../src/pages/structure/WanfaPage.tsx         |  12 ++-
 .../versions/0023_detail_concierge_advisor.py |  22 ++++
 WonderQ-Admin/app/models.py                   |   1 +
 WonderQ-Admin/app/routers/admin.py            |  15 +++
 WonderQ-Admin/app/routers/public.py           |   7 +-
 WonderQ-Admin/app/schemas.py                  |  18 ++++
 WonderQ-Admin/app/serializers.py              |   3 +-
 WonderQ-Admin/tests/test_details.py           | 101 +++++++++++++++++-
 WonderQ-MiniAPP/src/lib/navigation.ts         |   8 ++
 WonderQ-MiniAPP/src/lib/recentlyViewed.ts     |  91 ++++++++++++++++
 WonderQ-MiniAPP/src/lib/types.ts              |   1 +
 WonderQ-MiniAPP/src/lib/wechat-profile.ts     |   8 ++
 .../concierge/components/conciergeTypes.ts    |  42 ++++----
 .../detail/components/DetailActionBar.vue     |   8 +-
 .../detail/components/detailPresentation.ts   |   4 +
 WonderQ-MiniAPP/src/pages/detail/index.vue    |  37 ++++---
 .../src/pages/mine/components/MineMember.vue  |  60 ++++++++++-
 .../pages/mine/components/MineRecentViews.vue |  66 ++++++++++++
 WonderQ-MiniAPP/src/pages/mine/index.vue      |  47 +++++++-
 .../src/pages/team-buildings/detail.vue       |  15 +++
 .../src/pages/wild-archives/detail.vue        |  15 +++
 WonderQ-MiniAPP/tests/concierge-data.test.ts  |  21 +++-
 WonderQ-MiniAPP/tests/detail-data.test.ts     |  35 ++++++
 WonderQ-MiniAPP/tests/recently-viewed.test.ts |  54 ++++++++++
 docs/concierge-api.md                         |   6 ++
 docs/detail-api.md                            |  29 +++--
 docs/integration-workflow.md                  |   7 +-
 docs/public-api.md                            |   9 +-
 34 files changed, 739 insertions(+), 63 deletions(-)
 create mode 100644 WonderQ-Admin/alembic/versions/0023_detail_concierge_advisor.py
 create mode 100644 WonderQ-MiniAPP/src/lib/recentlyViewed.ts
 create mode 100644 WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue
 create mode 100644 WonderQ-MiniAPP/tests/recently-viewed.test.ts

diff --git a/.gitignore b/.gitignore
index 3d379e0..057e908 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,7 @@
 node_modules/
 dist/
 apps/*/dist/
+.pnpm-store
 .env
 .env.local
 **/.venv/
diff --git a/WonderQ-Admin-UI/src/api.ts b/WonderQ-Admin-UI/src/api.ts
index d8e88fc..93273e8 100644
--- a/WonderQ-Admin-UI/src/api.ts
+++ b/WonderQ-Admin-UI/src/api.ts
@@ -133,6 +133,7 @@ export type DetailRecord = {
   excluded: string[];
   notes: string[];
   gallery: string[];
+  conciergeAdvisorId: string | null;
   isActive: boolean;
   sortOrder: number;
   createdAt?: string;
diff --git a/WonderQ-Admin-UI/src/components/admin/WanfaRouteDetailFields.tsx b/WonderQ-Admin-UI/src/components/admin/WanfaRouteDetailFields.tsx
index a947239..d311369 100644
--- a/WonderQ-Admin-UI/src/components/admin/WanfaRouteDetailFields.tsx
+++ b/WonderQ-Admin-UI/src/components/admin/WanfaRouteDetailFields.tsx
@@ -1,6 +1,13 @@
-import type { DetailCreate } from "@/api";
+import type { ConciergeAdvisor, DetailCreate } from "@/api";
 import { ImageGalleryUploader } from "@/components/admin/ImageGalleryUploader";
 import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
 import { Switch } from "@/components/ui/switch";
 import { Textarea } from "@/components/ui/textarea";
 
@@ -15,9 +22,11 @@ type DetailArrayField = (typeof detailArrayFields)[number][0];
 
 export function WanfaRouteDetailFields({
   detail,
+  conciergeAdvisors,
   onChange,
 }: {
   detail: DetailCreate;
+  conciergeAdvisors: ConciergeAdvisor[];
   onChange: <K extends keyof DetailCreate>(key: K, value: DetailCreate[K]) => void;
 }) {
   const updateLines = (key: DetailArrayField, value: string) => {
@@ -107,6 +116,28 @@ export function WanfaRouteDetailFields({
             />
           </label>
         ))}
+        <div className="grid gap-2 text-sm font-medium text-slate-800 sm:col-span-2">
+          <span>联系管家</span>
+          <p className="-mt-1 text-xs font-normal leading-5 text-slate-500">
+            详情页只保存顾问 ID，前台会读取管家领域的最新头像、二维码和服务详情。
+          </p>
+          <Select
+            value={detail.conciergeAdvisorId ?? "__none__"}
+            onValueChange={(value) => onChange("conciergeAdvisorId", value === "__none__" ? null : value)}
+          >
+            <SelectTrigger aria-label="选择联系管家">
+              <SelectValue placeholder="不配置管家" />
+            </SelectTrigger>
+            <SelectContent position="item-aligned">
+              <SelectItem value="__none__">不配置管家</SelectItem>
+              {conciergeAdvisors.map((advisor) => (
+                <SelectItem key={advisor.id} value={advisor.id}>
+                  {advisor.name} · {advisor.role}{advisor.isActive ? "" : "（已停用）"}
+                </SelectItem>
+              ))}
+            </SelectContent>
+          </Select>
+        </div>
         <div className="sm:col-span-2">
           <ImageGalleryUploader
             id="wanfa-detail-gallery"
diff --git a/WonderQ-Admin-UI/src/components/admin/WanfaRouteEditor.tsx b/WonderQ-Admin-UI/src/components/admin/WanfaRouteEditor.tsx
index 95d671b..770bd72 100644
--- a/WonderQ-Admin-UI/src/components/admin/WanfaRouteEditor.tsx
+++ b/WonderQ-Admin-UI/src/components/admin/WanfaRouteEditor.tsx
@@ -1,7 +1,7 @@
 import { useState } from "react";
 import { Save, X } from "lucide-react";
 
-import type { DetailCreate, DetailRecord, WanfaRoute, WanfaRouteCreate } from "@/api";
+import type { ConciergeAdvisor, DetailCreate, DetailRecord, WanfaRoute, WanfaRouteCreate } from "@/api";
 import { SingleImageUploader } from "@/components/admin/SingleImageUploader";
 import { WanfaRouteDetailFields } from "@/components/admin/WanfaRouteDetailFields";
 import { Button } from "@/components/ui/button";
@@ -28,6 +28,7 @@ const emptyDetail = (): DetailCreate => ({
   excluded: [],
   notes: [],
   gallery: [],
+  conciergeAdvisorId: null,
   isActive: true,
 });
 
@@ -56,6 +57,7 @@ const detailDraft = (detail?: DetailRecord): DetailCreate =>
         excluded: detail.excluded ?? [],
         notes: detail.notes ?? [],
         gallery: detail.gallery ?? [],
+        conciergeAdvisorId: detail.conciergeAdvisorId ?? null,
         isActive: detail.isActive,
         sortOrder: detail.sortOrder,
       }
@@ -71,6 +73,7 @@ export function WanfaRouteEditor({
   categoryLabel,
   initialRoute,
   initialDetail,
+  conciergeAdvisors,
   saving,
   onSave,
   onClose,
@@ -79,6 +82,7 @@ export function WanfaRouteEditor({
   categoryLabel: string;
   initialRoute?: WanfaRoute;
   initialDetail?: DetailRecord;
+  conciergeAdvisors: ConciergeAdvisor[];
   saving: boolean;
   onSave: (input: WanfaRouteEditorValue) => void;
   onClose: () => void;
@@ -221,7 +225,11 @@ export function WanfaRouteEditor({
             group="wanfa"
           />
         </div>
-        <WanfaRouteDetailFields detail={draft.detail} onChange={updateDetail} />
+        <WanfaRouteDetailFields
+          detail={draft.detail}
+          conciergeAdvisors={conciergeAdvisors}
+          onChange={updateDetail}
+        />
         {error ? <p className="text-sm leading-5 text-rose-600">{error}</p> : null}
       </div>
       <footer className="flex justify-end gap-3 border-t border-slate-100 px-5 py-4">
diff --git a/WonderQ-Admin-UI/src/components/admin/WanfaRouteRail.tsx b/WonderQ-Admin-UI/src/components/admin/WanfaRouteRail.tsx
index 8987e27..01d8e4f 100644
--- a/WonderQ-Admin-UI/src/components/admin/WanfaRouteRail.tsx
+++ b/WonderQ-Admin-UI/src/components/admin/WanfaRouteRail.tsx
@@ -38,7 +38,9 @@ export function WanfaRouteRail({
       {category ? (
         <div className="mapped-list">
           {category.routes.map((route, index) => {
-            const hasDetail = details.some((detail) => detail.key === route.id);
+            const detail = details.find((item) => item.key === route.id);
+            const hasDetail = Boolean(detail);
+            const hasConcierge = Boolean(detail?.conciergeAdvisorId);
             return (
               <div className="mapped-list-row" key={route.id}>
                 <div className="mapped-list-main">
@@ -54,6 +56,13 @@ export function WanfaRouteRail({
                 >
                   {hasDetail ? "详情已配置" : "详情未配置"}
                 </span>
+                {hasDetail ? (
+                  <span
+                    className={`hidden rounded-full px-2.5 py-1 text-xs font-semibold lg:inline-flex ${hasConcierge ? "bg-sky-50 text-sky-700" : "bg-slate-100 text-slate-500"}`}
+                  >
+                    {hasConcierge ? "管家已配置" : "未配管家"}
+                  </span>
+                ) : null}
                 <Button
                   type="button"
                   variant="ghost"
diff --git a/WonderQ-Admin-UI/src/components/ui/select.tsx b/WonderQ-Admin-UI/src/components/ui/select.tsx
index 845088e..7ed1b8f 100644
--- a/WonderQ-Admin-UI/src/components/ui/select.tsx
+++ b/WonderQ-Admin-UI/src/components/ui/select.tsx
@@ -65,7 +65,7 @@ const SelectContent = React.forwardRef<
       ref={ref}
       position={position}
       className={cn(
-        "relative z-50 max-h-96 min-w-[8rem] overflow-hidden rounded-lg border border-slate-200 bg-white text-slate-950 shadow-lg outline-none data-[state=closed]:opacity-0 data-[state=open]:opacity-100",
+        "relative z-[70] max-h-96 min-w-[8rem] overflow-hidden rounded-lg border border-slate-200 bg-white text-slate-950 shadow-lg outline-none data-[state=closed]:opacity-0 data-[state=open]:opacity-100",
         position === "popper" && "translate-y-1",
         className,
       )}
diff --git a/WonderQ-Admin-UI/src/pages/structure/WanfaPage.tsx b/WonderQ-Admin-UI/src/pages/structure/WanfaPage.tsx
index 7a200e3..5578f3b 100644
--- a/WonderQ-Admin-UI/src/pages/structure/WanfaPage.tsx
+++ b/WonderQ-Admin-UI/src/pages/structure/WanfaPage.tsx
@@ -6,6 +6,7 @@ import {
   createWanfaRoute,
   deleteWanfaCategory,
   deleteWanfaRoute,
+  getConciergeAdvisors,
   getDetails,
   getWanfaCategories,
   reorderWanfaCategories,
@@ -14,7 +15,7 @@ import {
   updateWanfaCategory,
   updateWanfaRoute,
 } from "@/api";
-import type { DetailRecord, WanfaCategory, WanfaRoute } from "@/api";
+import type { ConciergeAdvisor, DetailRecord, WanfaCategory, WanfaRoute } from "@/api";
 import { WanfaCategoryEditor } from "@/components/admin/WanfaCategoryEditor";
 import { WanfaCategoryRail } from "@/components/admin/WanfaCategoryRail";
 import { WanfaConfirmDialog } from "@/components/admin/WanfaConfirmDialog";
@@ -46,6 +47,7 @@ function swap<T>(items: T[], index: number, direction: -1 | 1) {
 export function WanfaPage({ notify }: { notify: Notify }) {
   const [categories, setCategories] = useState<WanfaCategory[] | null>(null);
   const [details, setDetails] = useState<DetailRecord[]>([]);
+  const [conciergeAdvisors, setConciergeAdvisors] = useState<ConciergeAdvisor[]>([]);
   const [selectedCategoryId, setSelectedCategoryId] = useState("");
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState("");
@@ -63,10 +65,15 @@ export function WanfaPage({ notify }: { notify: Notify }) {
   const loadCategories = async () => {
     setLoading(true);
     try {
-      const [categoryResponse, detailResponse] = await Promise.all([getWanfaCategories(), getDetails()]);
+      const [categoryResponse, detailResponse, conciergeResponse] = await Promise.all([
+        getWanfaCategories(),
+        getDetails(),
+        getConciergeAdvisors(),
+      ]);
       const nextCategories = categoryResponse.categories ?? [];
       setCategories(nextCategories);
       setDetails(detailResponse.details ?? []);
+      setConciergeAdvisors(conciergeResponse.advisors ?? []);
       setSelectedCategoryId((current) =>
         nextCategories.some((category) => category.id === current)
           ? current
@@ -325,6 +332,7 @@ export function WanfaPage({ notify }: { notify: Notify }) {
                   ? details.find((detail) => detail.key === routeEditor.route?.id)
                   : undefined
               }
+              conciergeAdvisors={conciergeAdvisors}
               saving={savingKey === "route"}
               onSave={(input) => void saveRoute(input)}
               onClose={() => setRouteEditor(null)}
diff --git a/WonderQ-Admin/alembic/versions/0023_detail_concierge_advisor.py b/WonderQ-Admin/alembic/versions/0023_detail_concierge_advisor.py
new file mode 100644
index 0000000..80390c9
--- /dev/null
+++ b/WonderQ-Admin/alembic/versions/0023_detail_concierge_advisor.py
@@ -0,0 +1,22 @@
+"""Add optional concierge association to route details.
+
+Revision ID: 0023_detail_concierge_advisor
+Revises: 0022_opaque_ids
+"""
+
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "0023_detail_concierge_advisor"
+down_revision = "0022_opaque_ids"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("DetailRecord", sa.Column("conciergeAdvisorId", sa.String(), nullable=True))
+
+
+def downgrade() -> None:
+    op.drop_column("DetailRecord", "conciergeAdvisorId")
diff --git a/WonderQ-Admin/app/models.py b/WonderQ-Admin/app/models.py
index 62bc461..311f9fd 100644
--- a/WonderQ-Admin/app/models.py
+++ b/WonderQ-Admin/app/models.py
@@ -206,6 +206,7 @@ class DetailRecord(Base):
     excluded: Mapped[list[str]] = mapped_column(JSONB, default=list, nullable=False)
     notes: Mapped[list[str]] = mapped_column(JSONB, default=list, nullable=False)
     gallery: Mapped[list[str]] = mapped_column(JSONB, default=list, nullable=False)
+    conciergeAdvisorId: Mapped[str | None] = mapped_column(String, nullable=True)
     isActive: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False, index=True)
     sortOrder: Mapped[int] = mapped_column(Integer, default=0, nullable=False, index=True)
     createdAt: Mapped[datetime] = mapped_column(DateTime, default=utc_now, nullable=False)
diff --git a/WonderQ-Admin/app/routers/admin.py b/WonderQ-Admin/app/routers/admin.py
index 153be90..b713685 100644
--- a/WonderQ-Admin/app/routers/admin.py
+++ b/WonderQ-Admin/app/routers/admin.py
@@ -841,6 +841,18 @@ def detail_key_conflict(db: Session, key: str, current_id: str | None = None) ->
         detail_error(409, "详情 key 已存在", "DETAIL_KEY_EXISTS", {"key": key})
 
 
+def validate_detail_concierge_advisor(db: Session, advisor_id: str | None) -> None:
+    if not advisor_id:
+        return
+    if not db.get(ConciergeAdvisor, advisor_id):
+        detail_error(
+            422,
+            "关联的管家顾问不存在",
+            "DETAIL_CONCIERGE_ADVISOR_INVALID",
+            {"conciergeAdvisorId": advisor_id},
+        )
+
+
 def validate_detail_order(item_ids: list[str], current_ids: list[str]) -> None:
     validate_wanfa_order(item_ids, current_ids, "DETAIL_REORDER_INVALID")
 
@@ -881,6 +893,7 @@ def create_detail(
     db: Session = Depends(get_db),
 ):
     detail_key_conflict(db, body.key)
+    validate_detail_concierge_advisor(db, body.conciergeAdvisorId)
     detail = DetailRecord(
         **body.model_dump(exclude={"sortOrder"}),
         sortOrder=body.sortOrder if body.sortOrder is not None else next_site_sort_order(db, DetailRecord),
@@ -905,6 +918,8 @@ def update_detail(
     before = detail_record_dict(detail)
     if "key" in body.model_fields_set:
         detail_key_conflict(db, body.key or "", detail.id)
+    if "conciergeAdvisorId" in body.model_fields_set:
+        validate_detail_concierge_advisor(db, body.conciergeAdvisorId)
     for field in body.model_fields_set:
         setattr(detail, field, getattr(body, field))
     db.flush()
diff --git a/WonderQ-Admin/app/routers/public.py b/WonderQ-Admin/app/routers/public.py
index 536ce93..99ee44e 100644
--- a/WonderQ-Admin/app/routers/public.py
+++ b/WonderQ-Admin/app/routers/public.py
@@ -64,7 +64,12 @@ def get_public_detail(detail_key: str, db: Session = Depends(get_db)):
     )
     if not detail:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="详情不存在")
-    return success_response(public_detail_dict(detail))
+    advisor = None
+    if detail.conciergeAdvisorId:
+        candidate = db.get(ConciergeAdvisor, detail.conciergeAdvisorId)
+        if candidate and candidate.isActive:
+            advisor = candidate
+    return success_response(public_detail_dict(detail, advisor))
 
 
 @router.get("/api/public/concierge/advisors")
diff --git a/WonderQ-Admin/app/schemas.py b/WonderQ-Admin/app/schemas.py
index 0c05730..499458b 100644
--- a/WonderQ-Admin/app/schemas.py
+++ b/WonderQ-Admin/app/schemas.py
@@ -193,6 +193,7 @@ class DetailCreate(BaseModel):
     excluded: list[str] = Field(default_factory=list)
     notes: list[str] = Field(default_factory=list)
     gallery: list[str] = Field(default_factory=list)
+    conciergeAdvisorId: str | None = Field(default=None, max_length=120)
     isActive: bool = True
     sortOrder: int | None = Field(default=None, ge=0)
 
@@ -211,6 +212,14 @@ class DetailCreate(BaseModel):
     def validate_detail_gallery(cls, value: list[str]) -> list[str]:
         return normalize_detail_gallery(value)
 
+    @field_validator("conciergeAdvisorId", mode="before")
+    @classmethod
+    def normalize_concierge_advisor_id(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        normalized = str(value).strip()
+        return normalized or None
+
 
 class DetailPatch(BaseModel):
     key: str | None = Field(default=None, min_length=1, max_length=120)
@@ -224,6 +233,7 @@ class DetailPatch(BaseModel):
     excluded: list[str] | None = None
     notes: list[str] | None = None
     gallery: list[str] | None = None
+    conciergeAdvisorId: str | None = Field(default=None, max_length=120)
     isActive: bool | None = None
     sortOrder: int | None = Field(default=None, ge=0)
 
@@ -248,6 +258,14 @@ class DetailPatch(BaseModel):
             raise ValueError("字段不能为空")
         return normalize_detail_gallery(value)
 
+    @field_validator("conciergeAdvisorId", mode="before")
+    @classmethod
+    def normalize_optional_concierge_advisor_id(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        normalized = str(value).strip()
+        return normalized or None
+
 
 class HomeExperienceCreate(BaseModel):
     badge: str = Field(min_length=1, max_length=40)
diff --git a/WonderQ-Admin/app/serializers.py b/WonderQ-Admin/app/serializers.py
index 5cd3af0..a739ff5 100644
--- a/WonderQ-Admin/app/serializers.py
+++ b/WonderQ-Admin/app/serializers.py
@@ -50,7 +50,7 @@ def detail_record_dict(detail) -> dict:
     return model_dict(detail)
 
 
-def public_detail_dict(detail) -> dict:
+def public_detail_dict(detail, concierge_advisor=None) -> dict:
     return {
         "key": detail.key,
         "eyebrow": detail.eyebrow,
@@ -63,6 +63,7 @@ def public_detail_dict(detail) -> dict:
         "excluded": detail.excluded or [],
         "notes": detail.notes or [],
         "gallery": detail.gallery or [],
+        "conciergeAdvisor": public_concierge_advisor_dict(concierge_advisor) if concierge_advisor else None,
     }
 
 
diff --git a/WonderQ-Admin/tests/test_details.py b/WonderQ-Admin/tests/test_details.py
index 1ce710d..deb01ad 100644
--- a/WonderQ-Admin/tests/test_details.py
+++ b/WonderQ-Admin/tests/test_details.py
@@ -7,7 +7,7 @@ import pytest
 from app.auth import require_admin
 from app.database import get_db
 from app.main import create_app
-from app.models import AdminUser, DetailRecord
+from app.models import AdminUser, ConciergeAdvisor, DetailRecord
 from app.schemas import DetailCreate
 
 
@@ -79,6 +79,7 @@ def make_detail(**overrides):
         "gallery": ["https://example.test/family-water.jpg"],
         "isActive": True,
         "sortOrder": 0,
+        "conciergeAdvisorId": None,
         "createdAt": datetime(2026, 1, 1),
         "updatedAt": datetime(2026, 1, 2),
     }
@@ -86,6 +87,23 @@ def make_detail(**overrides):
     return DetailRecord(**values)
 
 
+def make_advisor(**overrides):
+    values = {
+        "id": "advisor-amanda",
+        "avatar": "https://example.test/amanda.jpg",
+        "name": "Amanda",
+        "role": "SENIOR TRAVEL ADVISOR",
+        "details": [{"icon": "calendar", "label": "服务经验：8年"}],
+        "qrImage": "https://example.test/amanda-qr.png",
+        "isActive": True,
+        "sortOrder": 0,
+        "createdAt": datetime(2026, 1, 1),
+        "updatedAt": datetime(2026, 1, 2),
+    }
+    values.update(overrides)
+    return ConciergeAdvisor(**values)
+
+
 def authenticated_app(fake_db):
     app = create_app()
     app.dependency_overrides[get_db] = lambda: fake_db
@@ -130,6 +148,20 @@ def test_detail_schema_rejects_invalid_gallery_url():
         )
 
 
+def test_detail_schema_normalizes_empty_concierge_advisor_id_to_null():
+    detail = DetailCreate(
+        key="family-water",
+        eyebrow="玩法推荐",
+        duration="5天4晚",
+        title="亲子玩水",
+        subtitle="贵州路线",
+        intro="介绍",
+        conciergeAdvisorId="   ",
+    )
+
+    assert detail.conciergeAdvisorId is None
+
+
 def test_public_detail_returns_frontend_contract_without_auth():
     fake_db = FakeDb(scalar_values=[make_detail()])
     app = create_app()
@@ -156,10 +188,53 @@ def test_public_detail_returns_frontend_contract_without_auth():
         "excluded": ["往返大交通"],
         "notes": ["请准备轻便雨具。"],
         "gallery": ["https://example.test/family-water.jpg"],
+        "conciergeAdvisor": None,
         },
     }
 
 
+def test_public_detail_includes_active_concierge_advisor():
+    advisor = make_advisor()
+    fake_db = FakeDb(
+        scalar_values=[make_detail(conciergeAdvisorId=advisor.id)],
+        get_results={(ConciergeAdvisor, advisor.id): advisor},
+    )
+    app = create_app()
+    app.dependency_overrides[get_db] = lambda: fake_db
+
+    try:
+        response = TestClient(app).get("/api/public/details/family-water")
+    finally:
+        app.dependency_overrides.clear()
+
+    assert response.status_code == 200
+    assert response.json()["data"]["conciergeAdvisor"] == {
+        "avatar": advisor.avatar,
+        "name": advisor.name,
+        "role": advisor.role,
+        "details": advisor.details,
+        "qrImage": advisor.qrImage,
+    }
+
+
+def test_public_detail_hides_inactive_concierge_advisor():
+    advisor = make_advisor(isActive=False)
+    fake_db = FakeDb(
+        scalar_values=[make_detail(conciergeAdvisorId=advisor.id)],
+        get_results={(ConciergeAdvisor, advisor.id): advisor},
+    )
+    app = create_app()
+    app.dependency_overrides[get_db] = lambda: fake_db
+
+    try:
+        response = TestClient(app).get("/api/public/details/family-water")
+    finally:
+        app.dependency_overrides.clear()
+
+    assert response.status_code == 200
+    assert response.json()["data"]["conciergeAdvisor"] is None
+
+
 def test_public_detail_returns_not_found_for_missing_key():
     fake_db = FakeDb(scalar_values=[None])
     app = create_app()
@@ -227,3 +302,27 @@ def test_admin_detail_create_normalizes_key_and_appends():
     assert response.status_code == 201
     assert response.json()["data"]["key"] == "family-water"
     assert fake_db.added[0].sortOrder == 3
+
+
+def test_admin_detail_create_rejects_unknown_concierge_advisor():
+    fake_db = FakeDb(scalar_values=[None, 2])
+    app = authenticated_app(fake_db)
+
+    try:
+        response = TestClient(app).post(
+            "/api/admin/details",
+            json={
+                "key": "family-water",
+                "eyebrow": "玩法推荐",
+                "duration": "5天4晚",
+                "title": "亲子玩水",
+                "subtitle": "贵州路线",
+                "intro": "沿着山地深入探索。",
+                "conciergeAdvisorId": "missing-advisor",
+            },
+        )
+    finally:
+        app.dependency_overrides.clear()
+
+    assert response.status_code == 422
+    assert response.json()["errorCode"] == "DETAIL_CONCIERGE_ADVISOR_INVALID"
diff --git a/WonderQ-MiniAPP/src/lib/navigation.ts b/WonderQ-MiniAPP/src/lib/navigation.ts
index 066a93c..d591135 100644
--- a/WonderQ-MiniAPP/src/lib/navigation.ts
+++ b/WonderQ-MiniAPP/src/lib/navigation.ts
@@ -36,6 +36,14 @@ export function goWildArchives() {
   go("/pages/wild-archives/index");
 }
 
+export function goPlay() {
+  uni.switchTab({ url: "/pages/play/index" });
+}
+
+export function goConcierge() {
+  uni.switchTab({ url: "/pages/concierge/index" });
+}
+
 export function goWildArchiveDetail(archiveId: string) {
   go("/pages/wild-archives/detail", { id: archiveId });
 }
diff --git a/WonderQ-MiniAPP/src/lib/recentlyViewed.ts b/WonderQ-MiniAPP/src/lib/recentlyViewed.ts
new file mode 100644
index 0000000..5c942f2
--- /dev/null
+++ b/WonderQ-MiniAPP/src/lib/recentlyViewed.ts
@@ -0,0 +1,91 @@
+export const RECENTLY_VIEWED_KEY = "miniapp:recently-viewed";
+export const RECENTLY_VIEWED_LIMIT = 5;
+
+export type RecentlyViewedType = "wanfa-route" | "team-building" | "wild-archive";
+
+export type RecentlyViewedItem = {
+  type: RecentlyViewedType;
+  id: string;
+  title: string;
+  image: string;
+  visitedAt: number;
+};
+
+const recentlyViewedTypes = new Set<RecentlyViewedType>([
+  "wanfa-route",
+  "team-building",
+  "wild-archive",
+]);
+
+function isRecentlyViewedType(value: unknown): value is RecentlyViewedType {
+  return typeof value === "string" && recentlyViewedTypes.has(value as RecentlyViewedType);
+}
+
+function normalizeRecentlyViewedItem(value: unknown): RecentlyViewedItem | null {
+  if (!value || typeof value !== "object") return null;
+
+  const item = value as Partial<RecentlyViewedItem>;
+  const type = isRecentlyViewedType(item.type) ? item.type : null;
+  const id = typeof item.id === "string" ? item.id.trim() : "";
+  const title = typeof item.title === "string" ? item.title.trim() : "";
+  const image = typeof item.image === "string" ? item.image.trim() : "";
+  const visitedAt = typeof item.visitedAt === "number" && Number.isFinite(item.visitedAt)
+    ? item.visitedAt
+    : null;
+
+  if (!type || !id || !title || visitedAt === null) return null;
+
+  return { type, id, title, image, visitedAt };
+}
+
+export function normalizeRecentlyViewed(value: unknown): RecentlyViewedItem[] {
+  if (!Array.isArray(value)) return [];
+
+  const unique = new Map<string, RecentlyViewedItem>();
+  for (const candidate of value) {
+    const item = normalizeRecentlyViewedItem(candidate);
+    if (!item) continue;
+
+    const existing = unique.get(item.id);
+    if (!existing || item.visitedAt > existing.visitedAt) {
+      unique.set(item.id, item);
+    }
+  }
+
+  return [...unique.values()]
+    .sort((left, right) => right.visitedAt - left.visitedAt)
+    .slice(0, RECENTLY_VIEWED_LIMIT);
+}
+
+export function upsertRecentlyViewed(
+  current: unknown,
+  item: RecentlyViewedItem,
+): RecentlyViewedItem[] {
+  return normalizeRecentlyViewed([item, ...(Array.isArray(current) ? current : [])]);
+}
+
+export function getRecentlyViewed(): RecentlyViewedItem[] {
+  try {
+    return normalizeRecentlyViewed(uni.getStorageSync(RECENTLY_VIEWED_KEY));
+  } catch {
+    return [];
+  }
+}
+
+export function rememberRecentlyViewed(item: RecentlyViewedItem): RecentlyViewedItem[] {
+  const next = upsertRecentlyViewed(getRecentlyViewed(), item);
+  try {
+    uni.setStorageSync(RECENTLY_VIEWED_KEY, next);
+  } catch {
+    // Storage can be unavailable in strict privacy or emulator modes.
+  }
+  return next;
+}
+
+export function clearRecentlyViewed() {
+  try {
+    uni.removeStorageSync(RECENTLY_VIEWED_KEY);
+  } catch {
+    // Storage can be unavailable in strict privacy or emulator modes.
+  }
+}
diff --git a/WonderQ-MiniAPP/src/lib/types.ts b/WonderQ-MiniAPP/src/lib/types.ts
index 07f6ecc..aaab686 100644
--- a/WonderQ-MiniAPP/src/lib/types.ts
+++ b/WonderQ-MiniAPP/src/lib/types.ts
@@ -135,6 +135,7 @@ export type PublicDetail = {
   excluded: string[];
   notes: string[];
   gallery: string[];
+  conciergeAdvisor: PublicConciergeAdvisor | null;
 };
 
 export type PublicConciergeDetail = {
diff --git a/WonderQ-MiniAPP/src/lib/wechat-profile.ts b/WonderQ-MiniAPP/src/lib/wechat-profile.ts
index 8b61c74..cdcede1 100644
--- a/WonderQ-MiniAPP/src/lib/wechat-profile.ts
+++ b/WonderQ-MiniAPP/src/lib/wechat-profile.ts
@@ -25,6 +25,14 @@ export function saveWechatProfile(profile: WechatProfile) {
   uni.setStorageSync(WECHAT_PROFILE_KEY, profile);
 }
 
+export function clearWechatProfile() {
+  try {
+    uni.removeStorageSync(WECHAT_PROFILE_KEY);
+  } catch {
+    // Storage can be unavailable in strict privacy or emulator modes.
+  }
+}
+
 export function requestWechatProfile(): Promise<WechatProfile | null> {
   return new Promise((resolve) => {
     if (typeof uni.getUserProfile !== "function") {
diff --git a/WonderQ-MiniAPP/src/pages/concierge/components/conciergeTypes.ts b/WonderQ-MiniAPP/src/pages/concierge/components/conciergeTypes.ts
index c436f3a..eba941b 100644
--- a/WonderQ-MiniAPP/src/pages/concierge/components/conciergeTypes.ts
+++ b/WonderQ-MiniAPP/src/pages/concierge/components/conciergeTypes.ts
@@ -19,27 +19,31 @@ function normalizeText(value: unknown) {
   return typeof value === "string" ? value.trim() : "";
 }
 
+export function normalizeConciergeAdvisor(value: unknown): ConciergeAdvisor | null {
+  if (!isRecord(value)) return null;
+
+  const avatar = normalizeText(value.avatar);
+  const name = normalizeText(value.name);
+  const role = normalizeText(value.role);
+  const qrImage = normalizeText(value.qrImage);
+  if (!avatar || !name || !role || !qrImage) return null;
+
+  const details = Array.isArray(value.details)
+    ? value.details.flatMap((detail) => {
+        if (!isRecord(detail)) return [];
+        const icon = normalizeText(detail.icon);
+        const label = normalizeText(detail.label);
+        return icon && label ? [{ icon, label }] : [];
+      })
+    : [];
+
+  return { avatar, name, role, details, qrImage };
+}
+
 export function normalizeConciergeAdvisors(value: unknown): ConciergeAdvisor[] {
   if (!isRecord(value) || !Array.isArray(value.advisors)) return [];
-
   return value.advisors.flatMap((item) => {
-    if (!isRecord(item)) return [];
-
-    const avatar = normalizeText(item.avatar);
-    const name = normalizeText(item.name);
-    const role = normalizeText(item.role);
-    const qrImage = normalizeText(item.qrImage);
-    if (!avatar || !name || !role || !qrImage) return [];
-
-    const details = Array.isArray(item.details)
-      ? item.details.flatMap((detail) => {
-          if (!isRecord(detail)) return [];
-          const icon = normalizeText(detail.icon);
-          const label = normalizeText(detail.label);
-          return icon && label ? [{ icon, label }] : [];
-        })
-      : [];
-
-    return [{ avatar, name, role, details, qrImage }];
+    const advisor = normalizeConciergeAdvisor(item);
+    return advisor ? [advisor] : [];
   });
 }
diff --git a/WonderQ-MiniAPP/src/pages/detail/components/DetailActionBar.vue b/WonderQ-MiniAPP/src/pages/detail/components/DetailActionBar.vue
index 1afa514..e6bac3c 100644
--- a/WonderQ-MiniAPP/src/pages/detail/components/DetailActionBar.vue
+++ b/WonderQ-MiniAPP/src/pages/detail/components/DetailActionBar.vue
@@ -28,6 +28,7 @@
             price }}万</text>
         </view>
         <view
+          v-if="showConcierge"
           class="tap-feedback flex items-center justify-center m-0 h-11 rounded-full bg-[#e96635] px-4 text-[13px] font-semibold text-white shadow-[0_6px_16px_rgba(233,102,53,0.22)]"
           @click="$emit('concierge')">联系管家</view>
       </view>
@@ -38,10 +39,13 @@
 <script setup lang="ts">
 import { formatWan } from "@/lib/data";
 
-defineProps<{
+withDefaults(defineProps<{
   price: number;
   favorite: boolean;
-}>();
+  showConcierge?: boolean;
+}>(), {
+  showConcierge: true,
+});
 
 defineEmits<{
   call: [];
diff --git a/WonderQ-MiniAPP/src/pages/detail/components/detailPresentation.ts b/WonderQ-MiniAPP/src/pages/detail/components/detailPresentation.ts
index 472dc97..d32feaf 100644
--- a/WonderQ-MiniAPP/src/pages/detail/components/detailPresentation.ts
+++ b/WonderQ-MiniAPP/src/pages/detail/components/detailPresentation.ts
@@ -1,5 +1,6 @@
 import { playCategories, type PlayRoute } from "../../play/components/playData";
 import type { PublicDetail } from "@/lib/types";
+import { normalizeConciergeAdvisor } from "../../concierge/components/conciergeTypes";
 
 export type DetailPresentation = PublicDetail;
 
@@ -30,6 +31,7 @@ function createRouteFallback(route: PlayRoute): DetailPresentation {
       "最终行程以出行日期、人数和资源确认结果为准。",
     ],
     gallery: Array.from(new Set([route.image, ...sharedGallery])).slice(0, 5),
+    conciergeAdvisor: null,
   };
 }
 
@@ -75,6 +77,7 @@ export function normalizeDetailPresentation(
   const subtitle = cleanText(source.subtitle) || fallback?.subtitle || "";
   const intro = cleanText(source.intro) || fallback?.intro || "";
   const gallery = cleanGallery(source.gallery);
+  const conciergeAdvisor = normalizeConciergeAdvisor(source.conciergeAdvisor);
 
   if (!key || !eyebrow || !duration || !title || !subtitle || !intro) {
     return fallback;
@@ -92,5 +95,6 @@ export function normalizeDetailPresentation(
     excluded: cleanList(source.excluded).length ? cleanList(source.excluded) : fallback?.excluded ?? [],
     notes: cleanList(source.notes).length ? cleanList(source.notes) : fallback?.notes ?? [],
     gallery: gallery.length ? gallery : fallback?.gallery ?? [],
+    conciergeAdvisor,
   };
 }
diff --git a/WonderQ-MiniAPP/src/pages/detail/index.vue b/WonderQ-MiniAPP/src/pages/detail/index.vue
index 14d7217..5cd617e 100644
--- a/WonderQ-MiniAPP/src/pages/detail/index.vue
+++ b/WonderQ-MiniAPP/src/pages/detail/index.vue
@@ -42,7 +42,13 @@
       </view>
     </scroll-view>
 
-    <DetailActionBar :price="1.68" :favorite="false" @call="goCall" @concierge="goConcierge" />
+    <DetailActionBar
+      :price="1.68"
+      :favorite="false"
+      :show-concierge="Boolean(presentation?.conciergeAdvisor)"
+      @call="goCall"
+      @concierge="goConcierge"
+    />
 
     <ConciergeContactSheet :open="Boolean(selectedAdvisor)" :advisor="selectedAdvisor" @close="handleConciergeClosed" />
   </view>
@@ -54,6 +60,7 @@ import { onLoad, onShareAppMessage } from "@dcloudio/uni-app";
 import ConciergeContactSheet from "@/components/ConciergeContactSheet.vue";
 import { fetchPublicDetail } from "@/lib/api";
 import { goBack } from "@/lib/navigation";
+import { rememberRecentlyViewed } from "@/lib/recentlyViewed";
 import { SUPPORT_PHONE } from "@/lib/types";
 import type { ConciergeAdvisor } from "../concierge/components/conciergeTypes";
 import DetailActionBar from "./components/DetailActionBar.vue";
@@ -74,17 +81,6 @@ const usingFallback = ref(false);
 const errorMessage = ref("");
 const selectedAdvisor = ref<ConciergeAdvisor | null>(null);
 
-const conciergeAdvisor: ConciergeAdvisor = {
-  avatar: "https://images.unsplash.com/photo-1494790108377-be9c29b29330?auto=format&fit=crop&fm=jpg&q=80&w=240&h=240",
-  name: "Amanda",
-  role: "SENIOR TRAVEL ADVISOR",
-  qrImage: "https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=WonderQ%20Concierge",
-  details: [
-    { icon: "calendar", label: "服务经验：8年" },
-    { icon: "navigate", label: "擅长领域：瀑降 / 探洞" },
-  ],
-};
-
 const heroImage = computed(() => presentation.value?.gallery[0] ?? "");
 const priceParagraphs = computed(() => ["最终价格会根据出行日期、人数和资源确认结果生成。"]);
 
@@ -125,16 +121,31 @@ async function loadDetail() {
     usingFallback.value = Boolean(fallback);
     errorMessage.value = cause instanceof Error ? cause.message : "路线详情接口暂时不可用。";
   } finally {
+    rememberCurrentDetail();
     loading.value = false;
   }
 }
 
+function rememberCurrentDetail() {
+  const current = presentation.value;
+  if (!current || !routeId.value) return;
+
+  rememberRecentlyViewed({
+    type: "wanfa-route",
+    id: routeId.value,
+    title: current.title,
+    image: current.gallery[0] ?? "",
+    visitedAt: Date.now(),
+  });
+}
+
 function goCall() {
   uni.makePhoneCall({ phoneNumber: SUPPORT_PHONE });
 }
 
 function goConcierge() {
-  selectedAdvisor.value = conciergeAdvisor;
+  const advisor = presentation.value?.conciergeAdvisor;
+  if (advisor) selectedAdvisor.value = advisor;
 }
 
 function handleConciergeClosed() {
diff --git a/WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue b/WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue
index 368baad..ce59b2a 100644
--- a/WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue
+++ b/WonderQ-MiniAPP/src/pages/mine/components/MineMember.vue
@@ -1,6 +1,6 @@
 <template>
-  <view class="flex h-screen flex-col overflow-hidden bg-[#f5f2ed]">
-    <view class="relative h-[52%] min-h-[300px] overflow-hidden rounded-b-[24px] bg-[#211e1c]">
+  <view class="min-h-screen bg-[#f5f2ed]">
+    <view class="relative h-[32vh] min-h-[230px] max-h-[320px] overflow-hidden rounded-b-[24px] bg-[#211e1c]">
       <image class="absolute inset-0 h-full w-full opacity-75"
         src="https://images.unsplash.com/photo-1774623703220-b3b5e6d3cedf?auto=format&fit=crop&fm=jpg&q=80&w=1200&h=1800"
         mode="aspectFill" />
@@ -17,7 +17,7 @@
       </view>
     </view>
     <view
-      class="flex min-h-0 flex-1 flex-col items-stretch px-6 pb-[calc(12px+env(safe-area-inset-bottom))] pt-6">
+      class="px-6 pb-[calc(28px+env(safe-area-inset-bottom))] pt-6">
       <view
         class="w-full rounded-[22px] border border-[#ded6cd] bg-white/95 px-4 py-4 shadow-[0_12px_30px_rgba(80,58,45,0.08)]">
         <view class="flex items-center gap-3">
@@ -48,33 +48,83 @@
         <text v-else-if="avatarUrl" class="mt-3 block text-[11px] leading-5 text-[#9a9189]">头像仅保存在当前设备</text>
         <text v-else class="mt-3 block text-[11px] leading-5 text-[#9a9189]">微信头像可在授权后显示</text>
       </view>
+
+      <button
+        class="m-0 mt-5 flex min-h-[58px] w-full items-center gap-3 rounded-[16px] bg-[#a45a3d] px-4 text-left text-white shadow-[0_8px_20px_rgba(164,90,61,0.16)]"
+        @click="emit('open-concierge')"
+      >
+        <view class="flex h-9 w-9 shrink-0 items-center justify-center rounded-full bg-white/15">
+          <uni-icons type="headphones" :size="18" color="#fffaf5" />
+        </view>
+        <view class="min-w-0 flex-1">
+          <text class="block text-[14px] font-semibold">联系管家</text>
+          <text class="mt-1 block text-[10px] leading-4 text-white/75">获取适合你的出行建议</text>
+        </view>
+        <uni-icons type="right" :size="16" color="#fffaf5" />
+      </button>
+
+      <MineRecentViews
+        :items="props.recentViews"
+        @select="(item) => emit('select-recent', item)"
+        @explore="emit('open-play')"
+      />
+
+      <view class="mt-6 rounded-[16px] border border-[#e2d9d0] bg-white px-4 py-4 shadow-[0_8px_20px_rgba(80,58,45,0.04)]">
+        <text class="block text-[14px] font-semibold text-[#2b2724]">账号操作</text>
+        <text class="mt-1 block text-[11px] leading-5 text-[#9a9189]">退出登录会清除本机最近浏览记录</text>
+        <button
+          class="m-0 mt-4 flex min-h-[42px] w-full items-center justify-center rounded-full border border-[#d9c7bb] bg-[#fffaf5] px-4 text-[12px] font-medium tracking-[0.04em] text-[#8c4f39]"
+          @click="emit('logout')"
+        >
+          <uni-icons type="forward" :size="16" color="#8c4f39" />
+          <text class="ml-1">退出登录</text>
+        </button>
+      </view>
     </view>
   </view>
 </template>
 
 <script setup lang="ts">
-import { computed, ref } from "vue";
+import { computed, onMounted, ref } from "vue";
+import type { RecentlyViewedItem } from "@/lib/recentlyViewed";
+import MineRecentViews from "./MineRecentViews.vue";
 
-withDefaults(
+const props = withDefaults(
   defineProps<{
     customerLine: string;
     customerName?: string;
     avatarUrl?: string;
     showAvatarAction?: boolean;
+    recentViews?: RecentlyViewedItem[];
   }>(),
   {
     customerName: "万趣会员",
     avatarUrl: "",
     showAvatarAction: false,
+    recentViews: () => [],
   },
 );
 
 const emit = defineEmits<{
   "request-avatar": [];
+  "open-concierge": [];
+  "open-play": [];
+  "select-recent": [item: RecentlyViewedItem];
+  logout: [];
 }>();
 
 const menuButtonTop = ref<number | null>(null);
 const brandPositionStyle = computed(() =>
   menuButtonTop.value === null ? {} : { top: `${menuButtonTop.value}px` },
 );
+
+function syncMenuButtonPosition() {
+  try {
+    menuButtonTop.value = uni.getMenuButtonBoundingClientRect().top;
+  } catch {
+    menuButtonTop.value = null;
+  }
+}
+
+onMounted(syncMenuButtonPosition);
 </script>
diff --git a/WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue b/WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue
new file mode 100644
index 0000000..5d970ae
--- /dev/null
+++ b/WonderQ-MiniAPP/src/pages/mine/components/MineRecentViews.vue
@@ -0,0 +1,66 @@
+<template>
+  <view class="mt-6">
+    <view class="mb-3 flex items-end justify-between">
+      <view>
+        <text class="block text-[18px] font-semibold tracking-[0.02em] text-[#24211f]">继续探索</text>
+        <text class="mt-1 block text-[11px] leading-5 text-[#9a9189]">最近浏览的内容</text>
+      </view>
+      <text v-if="items.length" class="text-[11px] text-[#b18a76]">{{ items.length }} 条记录</text>
+    </view>
+
+    <view v-if="items.length" class="overflow-hidden rounded-[16px] border border-[#e2d9d0] bg-white shadow-[0_8px_20px_rgba(80,58,45,0.05)]">
+      <button
+        v-for="(item, index) in items"
+        :key="`${item.type}-${item.id}`"
+        class="m-0 flex w-full items-center gap-3 px-3 py-3 text-left"
+        :class="index < items.length - 1 ? 'border-b border-[#eee7e0]' : ''"
+        @click="emit('select', item)"
+      >
+        <view class="h-14 w-16 shrink-0 overflow-hidden rounded-[10px] bg-[#f1ece6]">
+          <image v-if="item.image" class="h-full w-full" :src="item.image" mode="aspectFill" />
+          <view v-else class="flex h-full w-full items-center justify-center">
+            <uni-icons type="image" :size="20" color="#b8aaa0" />
+          </view>
+        </view>
+        <view class="min-w-0 flex-1">
+          <text class="block truncate text-[14px] font-medium text-[#2b2724]">{{ item.title }}</text>
+          <text class="mt-1 block text-[10px] leading-4 text-[#a19890]">{{ typeLabel(item.type) }}</text>
+        </view>
+        <uni-icons type="right" :size="15" color="#b3a79e" />
+      </button>
+    </view>
+
+    <view v-else class="rounded-[16px] border border-dashed border-[#d8cec5] bg-white/70 px-5 py-6 text-center">
+      <view class="mx-auto flex h-10 w-10 items-center justify-center rounded-full bg-[#f4eee8]">
+        <uni-icons type="eye" :size="20" color="#a45a3d" />
+      </view>
+      <text class="mt-3 block text-[14px] font-medium text-[#4a413a]">暂无浏览记录</text>
+      <text class="mt-1 block text-[11px] leading-5 text-[#9a9189]">去看看玩法，收藏下一段旅程</text>
+      <button
+        class="m-0 mx-auto mt-4 flex min-h-[36px] items-center justify-center rounded-full bg-[#a45a3d] px-5 text-[12px] font-medium text-white"
+        @click="emit('explore')"
+      >
+        去看看玩法
+      </button>
+    </view>
+  </view>
+</template>
+
+<script setup lang="ts">
+import type { RecentlyViewedItem, RecentlyViewedType } from "@/lib/recentlyViewed";
+
+defineProps<{
+  items: RecentlyViewedItem[];
+}>();
+
+const emit = defineEmits<{
+  select: [item: RecentlyViewedItem];
+  explore: [];
+}>();
+
+function typeLabel(type: RecentlyViewedType) {
+  if (type === "wanfa-route") return "玩法路线";
+  if (type === "team-building") return "团队共创";
+  return "客片案例";
+}
+</script>
diff --git a/WonderQ-MiniAPP/src/pages/mine/index.vue b/WonderQ-MiniAPP/src/pages/mine/index.vue
index 6daeb75..fb9650c 100644
--- a/WonderQ-MiniAPP/src/pages/mine/index.vue
+++ b/WonderQ-MiniAPP/src/pages/mine/index.vue
@@ -8,7 +8,12 @@
           :customer-name="wechatProfile?.nickName || '万趣会员'"
           :avatar-url="wechatProfile?.avatarUrl"
           :show-avatar-action="isWechatMiniProgram"
-          @request-avatar="loadWechatProfile" />
+          :recent-views="recentViews"
+          @request-avatar="loadWechatProfile"
+          @open-concierge="goConcierge"
+          @open-play="goPlay"
+          @select-recent="openRecent"
+          @logout="logout" />
       </scroll-view>
     </view>
   </view>
@@ -17,9 +22,22 @@
 <script setup lang="ts">
 import { ref } from "vue";
 import { onShow } from "@dcloudio/uni-app";
-import { getAuthSession, loginWithPhoneCode } from "@/lib/auth";
+import { clearAuthSession, getAuthSession, loginWithPhoneCode } from "@/lib/auth";
+import {
+  clearRecentlyViewed,
+  getRecentlyViewed,
+  type RecentlyViewedItem,
+} from "@/lib/recentlyViewed";
+import {
+  goConcierge,
+  goPlay,
+  goTeamBuildingDetail,
+  goWanfaRouteDetail,
+  goWildArchiveDetail,
+} from "@/lib/navigation";
 import { loadAppData } from "@/lib/store";
 import {
+  clearWechatProfile,
   getStoredWechatProfile,
   requestWechatProfile,
   saveWechatProfile,
@@ -34,9 +52,11 @@ const wechatProfile = ref(getStoredWechatProfile());
 const isWechatMiniProgram = ref(false);
 const isLoggingIn = ref(false);
 const isLoadingWechatProfile = ref(false);
+const recentViews = ref<RecentlyViewedItem[]>([]);
 onShow(() => {
   session.value = getAuthSession();
   wechatProfile.value = getStoredWechatProfile();
+  recentViews.value = getRecentlyViewed();
   try {
     isWechatMiniProgram.value = uni.getSystemInfoSync().uniPlatform === "mp-weixin";
   } catch {
@@ -101,4 +121,27 @@ async function loadWechatProfile() {
     uni.hideLoading();
   }
 }
+
+function openRecent(item: RecentlyViewedItem) {
+  if (item.type === "wanfa-route") {
+    goWanfaRouteDetail(item.id);
+    return;
+  }
+  if (item.type === "team-building") {
+    goTeamBuildingDetail(item.id);
+    return;
+  }
+  goWildArchiveDetail(item.id);
+}
+
+function logout() {
+  clearAuthSession();
+  clearWechatProfile();
+  clearRecentlyViewed();
+  session.value = null;
+  wechatProfile.value = null;
+  recentViews.value = [];
+  customerLine.value = "登录后管理头像与手机号，继续探索旅程。";
+  uni.showToast({ title: "已退出登录", icon: "none" });
+}
 </script>
diff --git a/WonderQ-MiniAPP/src/pages/team-buildings/detail.vue b/WonderQ-MiniAPP/src/pages/team-buildings/detail.vue
index d395992..e8f4d48 100644
--- a/WonderQ-MiniAPP/src/pages/team-buildings/detail.vue
+++ b/WonderQ-MiniAPP/src/pages/team-buildings/detail.vue
@@ -42,6 +42,7 @@ import { ref } from "vue";
 import { onLoad } from "@dcloudio/uni-app";
 import { fetchPublicTeamBuildingDetail } from "@/lib/api";
 import { goBack } from "@/lib/navigation";
+import { rememberRecentlyViewed } from "@/lib/recentlyViewed";
 import {
   homeTeamBuildingFallback,
   normalizeHomeTeamBuildingDetail,
@@ -63,10 +64,24 @@ async function loadDetail(teamBuildingId: string) {
     detail.value = fallback ? { ...fallback, detailParagraphs: [...fallback.detailParagraphs] } : null;
     if (detail.value) fallbackNotice.value = "接口暂不可用，当前展示模拟数据";
   } finally {
+    rememberCurrentDetail(teamBuildingId);
     loading.value = false;
   }
 }
 
+function rememberCurrentDetail(teamBuildingId: string) {
+  const current = detail.value;
+  if (!current || !teamBuildingId) return;
+
+  rememberRecentlyViewed({
+    type: "team-building",
+    id: teamBuildingId,
+    title: current.title,
+    image: current.image,
+    visitedAt: Date.now(),
+  });
+}
+
 onLoad((query) => {
   const teamBuildingId = typeof query?.id === "string" ? query.id : "";
   if (!teamBuildingId) {
diff --git a/WonderQ-MiniAPP/src/pages/wild-archives/detail.vue b/WonderQ-MiniAPP/src/pages/wild-archives/detail.vue
index 1db5289..a467c29 100644
--- a/WonderQ-MiniAPP/src/pages/wild-archives/detail.vue
+++ b/WonderQ-MiniAPP/src/pages/wild-archives/detail.vue
@@ -33,6 +33,7 @@ import { ref } from "vue";
 import { onLoad } from "@dcloudio/uni-app";
 import { fetchPublicWildArchiveDetail } from "@/lib/api";
 import { goBack } from "@/lib/navigation";
+import { rememberRecentlyViewed } from "@/lib/recentlyViewed";
 import { homeWildArchiveFallback, normalizeHomeWildArchiveDetail, type HomeWildArchive } from "@/pages/home/components/homeWildArchivesData";
 
 const detail = ref<HomeWildArchive | null>(null);
@@ -50,10 +51,24 @@ async function loadDetail(archiveId: string) {
     detail.value = fallback ? { ...fallback, images: [...fallback.images] } : null;
     if (detail.value) fallbackNotice.value = "接口暂不可用，当前展示模拟数据";
   } finally {
+    rememberCurrentDetail(archiveId);
     loading.value = false;
   }
 }
 
+function rememberCurrentDetail(archiveId: string) {
+  const current = detail.value;
+  if (!current || !archiveId) return;
+
+  rememberRecentlyViewed({
+    type: "wild-archive",
+    id: archiveId,
+    title: current.title,
+    image: current.image,
+    visitedAt: Date.now(),
+  });
+}
+
 onLoad((query) => {
   const archiveId = typeof query?.id === "string" ? query.id : "";
   if (!archiveId) {
diff --git a/WonderQ-MiniAPP/tests/concierge-data.test.ts b/WonderQ-MiniAPP/tests/concierge-data.test.ts
index dbf9c49..62946b0 100644
--- a/WonderQ-MiniAPP/tests/concierge-data.test.ts
+++ b/WonderQ-MiniAPP/tests/concierge-data.test.ts
@@ -1,7 +1,26 @@
 import { describe, expect, it } from "vitest";
-import { normalizeConciergeAdvisors } from "@/pages/concierge/components/conciergeTypes";
+import { normalizeConciergeAdvisor, normalizeConciergeAdvisors } from "@/pages/concierge/components/conciergeTypes";
 
 describe("normalizeConciergeAdvisors", () => {
+  it("normalizes a single valid advisor and rejects incomplete data", () => {
+    expect(
+      normalizeConciergeAdvisor({
+        avatar: " https://example.test/amanda.jpg ",
+        name: " Amanda ",
+        role: " ADVISOR ",
+        details: [{ icon: " calendar ", label: " 服务经验：8年 " }],
+        qrImage: " https://example.test/amanda-qr.png ",
+      }),
+    ).toEqual({
+      avatar: "https://example.test/amanda.jpg",
+      name: "Amanda",
+      role: "ADVISOR",
+      details: [{ icon: "calendar", label: "服务经验：8年" }],
+      qrImage: "https://example.test/amanda-qr.png",
+    });
+    expect(normalizeConciergeAdvisor({ name: "缺少头像" })).toBeNull();
+  });
+
   it("normalizes public advisor data and filters incomplete records", () => {
     expect(
       normalizeConciergeAdvisors({
diff --git a/WonderQ-MiniAPP/tests/detail-data.test.ts b/WonderQ-MiniAPP/tests/detail-data.test.ts
index 823d7e5..7f305ea 100644
--- a/WonderQ-MiniAPP/tests/detail-data.test.ts
+++ b/WonderQ-MiniAPP/tests/detail-data.test.ts
@@ -20,6 +20,7 @@ describe("wanfa route detail presentation", () => {
         excluded: [" 往返大交通 "],
         notes: [" 请准备雨具。 "],
         gallery: [" https://example.test/cover.jpg "],
+        conciergeAdvisor: null,
       }),
     ).toEqual({
       key: "family-water",
@@ -33,6 +34,40 @@ describe("wanfa route detail presentation", () => {
       excluded: ["往返大交通"],
       notes: ["请准备雨具。"],
       gallery: ["https://example.test/cover.jpg"],
+      conciergeAdvisor: null,
+    });
+  });
+
+  it("normalizes a valid concierge advisor without inventing fallback data", () => {
+    expect(
+      normalizeDetailPresentation({
+        key: "family-water",
+        eyebrow: "玩法推荐",
+        duration: "5天4晚",
+        title: "亲子玩水",
+        subtitle: "贵州路线",
+        intro: "介绍",
+        highlights: [],
+        included: [],
+        excluded: [],
+        notes: [],
+        gallery: ["https://example.test/cover.jpg"],
+        conciergeAdvisor: {
+          avatar: " https://example.test/amanda.jpg ",
+          name: " Amanda ",
+          role: " SENIOR TRAVEL ADVISOR ",
+          details: [{ icon: " calendar ", label: " 服务经验：8年 " }],
+          qrImage: " https://example.test/amanda-qr.png ",
+        },
+      }),
+    ).toMatchObject({
+      conciergeAdvisor: {
+        avatar: "https://example.test/amanda.jpg",
+        name: "Amanda",
+        role: "SENIOR TRAVEL ADVISOR",
+        details: [{ icon: "calendar", label: "服务经验：8年" }],
+        qrImage: "https://example.test/amanda-qr.png",
+      },
     });
   });
 
diff --git a/WonderQ-MiniAPP/tests/recently-viewed.test.ts b/WonderQ-MiniAPP/tests/recently-viewed.test.ts
new file mode 100644
index 0000000..66df30c
--- /dev/null
+++ b/WonderQ-MiniAPP/tests/recently-viewed.test.ts
@@ -0,0 +1,54 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  normalizeRecentlyViewed,
+  upsertRecentlyViewed,
+  type RecentlyViewedItem,
+} from "@/lib/recentlyViewed";
+
+const baseItem: RecentlyViewedItem = {
+  type: "wanfa-route",
+  id: "route-1",
+  title: "亲子玩水",
+  image: "https://example.test/route-1.jpg",
+  visitedAt: 100,
+};
+
+describe("recently viewed data", () => {
+  it("filters invalid records and sorts valid records by latest visit", () => {
+    expect(
+      normalizeRecentlyViewed([
+        { ...baseItem, visitedAt: 100 },
+        { ...baseItem, id: "route-2", visitedAt: 300 },
+        { id: "missing-title", type: "wanfa-route", visitedAt: 200 },
+        "invalid",
+      ]),
+    ).toEqual([
+      { ...baseItem, id: "route-2", visitedAt: 300 },
+      baseItem,
+    ]);
+  });
+
+  it("updates an existing ID, puts it first, and keeps at most five records", () => {
+    const existing = Array.from({ length: 5 }, (_, index) => ({
+      ...baseItem,
+      id: `route-${index}`,
+      visitedAt: index,
+    }));
+
+    expect(
+      upsertRecentlyViewed(existing, {
+        ...baseItem,
+        id: "route-3",
+        title: "更新后的路线",
+        visitedAt: 10,
+      }),
+    ).toEqual([
+      { ...baseItem, id: "route-3", title: "更新后的路线", visitedAt: 10 },
+      { ...baseItem, id: "route-4", visitedAt: 4 },
+      { ...baseItem, id: "route-2", visitedAt: 2 },
+      { ...baseItem, id: "route-1", visitedAt: 1 },
+      { ...baseItem, id: "route-0", visitedAt: 0 },
+    ]);
+  });
+});
diff --git a/docs/concierge-api.md b/docs/concierge-api.md
index 24226b9..2cf15ee 100644
--- a/docs/concierge-api.md
+++ b/docs/concierge-api.md
@@ -23,6 +23,12 @@ Admin 顾问记录的 `id` 为服务端生成的稳定 UUID 字符串；MiniAPP
 - 订单、预订、商品和商品图片关联。
 - 管家页面 Hero 文案和服务原则内容。
 
+## 路线详情关联
+
+路线详情可以关联一名管家顾问。`DetailRecord` 只保存可空的 `conciergeAdvisorId`，不建立数据库外键，也不复制头像、二维码或服务详情。玩法详情由详情接口维护，管家资料仍由本领域的 Admin CRUD 和 Public API 维护。
+
+`GET /api/public/details/{key}` 会在关联顾问存在且启用时嵌入最新的 `conciergeAdvisor`；未配置、顾问已删除或已停用时返回 `conciergeAdvisor: null`，不会阻塞路线详情读取。Admin UI 选择顾问时使用本接口返回的稳定 `id`，清空选择即解除关联。
+
 当前 `WonderQ-MiniAPP/src/pages/concierge/index.vue` 中的 Hero 和服务原则仍是本地内容；顾问卡片由 Admin UI 维护，MiniAPP 通过独立的 Public API 消费已启用顾问。
 
 ## 接口清单
diff --git a/docs/detail-api.md b/docs/detail-api.md
index 9d4cfd0..7cbfee1 100644
--- a/docs/detail-api.md
+++ b/docs/detail-api.md
@@ -11,6 +11,7 @@
 - 详情页识别键、标题眉标、出行时长和标题文案。
 - 详情介绍、行程亮点、费用包含、费用不含和注意事项。
 - 详情页图片画廊及图片顺序。
+- 详情页可选的联系管家顾问 ID；顾问资料仍由管家领域维护。
 - 启用状态和详情列表顺序。
 
 本接口不负责：
@@ -18,7 +19,7 @@
 - 商品、商品价格、商品库存或商品详情表。
 - Product、ProductImage 或任何商品外键。
 - 订单、预订、收藏、评价或线索。
-- 详情页底部的电话、管家联系和预订动作。
+- 管家顾问的头像、二维码、服务详情和管家 CRUD；详情只保存顾问 ID。
 
 `key` 固定使用玩法路线 ID（即服务端生成的 `WanfaRoute.id` UUID），但 `DetailRecord` 不建立数据库外键。详情页通过 `/pages/detail/index?routeId={key}` 定位内容；详情记录删除不会跨领域级联删除路线或其他数据。
 
@@ -80,6 +81,7 @@ type DetailPresentation = {
 type DetailRecord = DetailPresentation & {
   id: string;
   key: string;
+  conciergeAdvisorId: string | null;
   isActive: boolean;
   sortOrder: number;
   createdAt: string;
@@ -88,10 +90,20 @@ type DetailRecord = DetailPresentation & {
 
 type PublicDetail = Omit<DetailPresentation, "key"> & {
   key: string;
+  conciergeAdvisor: PublicConciergeAdvisor | null;
+};
+
+type PublicConciergeAdvisor = {
+  avatar: string;
+  name: string;
+  role: string;
+  details: Array<{ icon: string; label: string }>;
+  qrImage: string;
 };
 
 type DetailCreate = DetailPresentation & {
   key: string;
+  conciergeAdvisorId?: string | null;
   isActive?: boolean;
   sortOrder?: number;
 };
@@ -123,6 +135,7 @@ type DetailReorderRequest = {
 | `excluded` | `string[]` | 是 | “费用不含”列表，保留数组顺序。 |
 | `notes` | `string[]` | 是 | “注意事项”列表，保留数组顺序。 |
 | `gallery` | `string[]` | 是 | 详情图片 URL 列表，按展示顺序返回；建议最多 6 张以匹配当前前台逻辑。 |
+| `conciergeAdvisorId` | `string \| null` | 否 | 关联的管家顾问 ID；不建立数据库外键，空字符串保存为 `null`。 |
 | `isActive` | `boolean` | 响应必填 | 是否进入已发布前台内容，创建默认 `true`。 |
 | `sortOrder` | `number` | 响应必填 | 非负整数，数值越小越靠前；创建时未传则追加到末尾。 |
 | `createdAt` | `string` | 响应必填 | ISO 8601 创建时间。 |
@@ -187,7 +200,7 @@ Authorization: Bearer <admin-jwt>
 Content-Type: application/json
 ```
 
-请求体为 `DetailCreate`。成功返回 `201` 和 `data` 内新建的 `DetailRecord`；未传 `sortOrder` 时追加到当前列表末尾。
+请求体为 `DetailCreate`。成功返回 `201` 和 `data` 内新建的 `DetailRecord`；未传 `sortOrder` 时追加到当前列表末尾。`conciergeAdvisorId` 传空字符串时归一化为 `null`，传入不存在的顾问 ID 返回 `422 DETAIL_CONCIERGE_ADVISOR_INVALID`。
 
 ### 编辑详情
 
@@ -267,10 +280,11 @@ type PublicDetail = {
   excluded: string[];
   notes: string[];
   gallery: string[];
+  conciergeAdvisor: PublicConciergeAdvisor | null;
 };
 ```
 
-不存在、停用或未配置详情时返回 `404`。MiniAPP 请求失败或字段不完整时，按 `key` 查找本地 fallback；找不到 fallback 时展示未找到和重试状态。该页面暂不提供价格、收藏、在线订阅、预订、订单或管家联系动作。
+不存在、停用或未配置详情时返回 `404`。详情未配置顾问、顾问不存在或顾问已停用时，详情仍正常返回，但 `conciergeAdvisor` 为 `null`。MiniAPP 请求失败或字段不完整时，按 `key` 查找本地 fallback；fallback 不伪造管家数据，找不到 fallback 时展示未找到和重试状态。详情页仅在返回有效顾问时展示“联系管家”入口。
 
 ## 图片与素材
 
@@ -288,14 +302,14 @@ POST /api/admin/media-assets/upload
 
 Admin UI 应按以下方式调用：
 
-1. 玩法页加载时同时调用玩法分类和 `GET /api/admin/details`；详情编辑器嵌入现有路线编辑抽屉，不新增侧边菜单。
+1. 玩法页加载时同时调用玩法分类、`GET /api/admin/details` 和 `GET /api/admin/concierge/advisors`；详情编辑器嵌入现有路线编辑抽屉，不新增侧边菜单。
 2. 新增和编辑表单维护眉标、时长、标题、副标题、介绍和四组列表文案；保存路线时以已保存的路线 ID 作为详情 `key`。
 3. `highlights`、`included`、`excluded`、`notes` 使用可增删的重复字段编辑器，提交时保留数组顺序，不拼接成换行字符串。
 4. 使用图片上传接口维护 `gallery`，支持新增、删除和调整图片顺序。
 5. 上移或下移详情时提交完整详情 ID 列表，不直接修改本地 `sortOrder` 后假设保存成功。
 6. 删除前要求二次确认；删除成功后以接口返回或重新查询的数据更新列表。
 7. 处理 `401`、`404`、`409`、`422` 和 `5xx`，保存、上传或排序进行中禁用重复提交。
-8. 详情编辑器不得出现 Product ID、ProductImage ID、库存、订单、价格或预订字段；详情保存失败时明确提示路线摘要已保存、详情需要重试。
+8. 详情编辑器不得出现 Product ID、ProductImage ID、库存、订单、价格或预订字段；联系管家使用顾问 ID 选择器；详情保存失败时明确提示路线摘要已保存、详情需要重试。
 
 建议的 Admin UI API 封装函数：
 
@@ -310,7 +324,7 @@ reorderDetails(itemIds: string[]);
 
 ## 与前台展示模型的映射
 
-Admin API 返回的 `DetailRecord` 可以映射为 `DetailPresentation`：
+Public API 返回的 `PublicDetail` 可以直接映射为 MiniAPP 的 `DetailPresentation`；Admin API 返回的 `DetailRecord` 只包含 `conciergeAdvisorId`，不复制管家资料：
 
 ```ts
 const presentation: DetailPresentation = {
@@ -325,6 +339,7 @@ const presentation: DetailPresentation = {
   excluded: record.excluded,
   notes: record.notes,
   gallery: record.gallery,
+  conciergeAdvisor: publicDetail.conciergeAdvisor ?? null,
 };
 ```
 
@@ -332,7 +347,7 @@ const presentation: DetailPresentation = {
 
 ## 后端落地边界
 
-当前实现由 `WonderQ-Admin` 的 `DetailRecord` 模型、`0021_detail_records` 迁移、Admin/Public 路由和审计日志提供能力；由 `WonderQ-Admin-UI` 在玩法路线编辑抽屉中维护详情；由 `WonderQ-MiniAPP` 调用 Public 详情接口并按路线 ID fallback。迁移文件只负责生成和初始化详情记录，不自动执行数据库升级。
+当前实现由 `WonderQ-Admin` 的 `DetailRecord` 模型、`0021_detail_records`、`0022_opaque_ids` 和 `0023_detail_concierge_advisor` 迁移、Admin/Public 路由和审计日志提供能力；由 `WonderQ-Admin-UI` 在玩法路线编辑抽屉中维护详情及顾问 ID；由 `WonderQ-MiniAPP` 调用 Public 详情接口并按路线 ID fallback。迁移文件只负责生成和初始化详情记录，不自动执行数据库升级。顾问资料始终从管家领域实时读取，不复制到详情表。
 
 相关文档：
 
diff --git a/docs/integration-workflow.md b/docs/integration-workflow.md
index 0226239..8d8a020 100644
--- a/docs/integration-workflow.md
+++ b/docs/integration-workflow.md
@@ -94,10 +94,11 @@ MiniAPP 联调重点：
 路线详情使用独立 `DetailRecord`，不修改 `WanfaRoute` 表结构，也不建立商品、订单或预订关联。联调顺序如下：
 
 1. 执行数据库迁移，确认 `0021_detail_records` 已创建详情表并为已有路线生成基础记录；确认 `0022_opaque_ids` 已将历史语义 ID 转换为稳定 UUID，并同步玩法外键、详情 `key` 和审计引用。生产环境执行前按迁移规范单独确认。
-2. 在 Admin UI 进入“玩法”，编辑路线摘要和详情字段，保存时先保存路线，再以路线 ID 作为 `DetailRecord.key` 创建或更新详情。
+2. 在 Admin UI 进入“玩法”，编辑路线摘要、详情字段和联系管家，保存时先保存路线，再以路线 ID 作为 `DetailRecord.key` 创建或更新详情；顾问选项来自 `GET /api/admin/concierge/advisors`。
 3. 检查 `GET /api/public/wanfa/categories` 仍只返回路线摘要；检查 `GET /api/public/home` 的玩法推荐携带关联路线摘要。
 4. 在 MiniAPP 首页玩法推荐或玩法页点击路线，确认跳转 `/pages/detail/index?routeId={routeId}`，并请求 `GET /api/public/details/{routeId}`。
-5. 修改 Admin UI 的详情内容后刷新 MiniAPP，确认标题、正文、费用说明、注意事项和画廊更新；停用或删除详情时确认 Public API 返回 `404`。
+5. 修改 Admin UI 的详情内容或联系管家后刷新 MiniAPP，确认标题、正文、费用说明、注意事项、画廊和顾问资料更新；停用或删除详情时确认 Public API 返回 `404`。
+6. 在管家页面停用或删除已关联顾问，再刷新路线详情，确认详情仍可读取且 `conciergeAdvisor` 为 `null`，联系入口隐藏；重新启用顾问后确认入口和弹窗资料恢复。
 6. 关闭后端接口，确认 MiniAPP 按路线 ID 展示本地网络图片和模拟文案，并提示当前为模拟数据；未知路线展示未找到和重试状态。
 
 ## 稳定 ID 联调检查
@@ -107,7 +108,7 @@ MiniAPP 联调重点：
 3. 检查首页玩法推荐的 `categoryId`、路线 `id` 与 `GET /api/public/details/{key}` 的 `key` 关联正确。
 4. MiniAPP 本地 fallback 的语义 ID 只在接口失败时使用，不得覆盖接口成功返回的 UUID。
 
-路线详情页当前不包含价格、收藏、在线订阅、预订、订单或管家联系动作。字段和错误约定以 `detail-api.md`、`public-api.md` 为准。
+路线详情页不包含在线订阅、收藏、预订或订单动作；联系管家入口由 `conciergeAdvisor` 是否有效决定。字段和错误约定以 `detail-api.md`、`public-api.md` 和 `concierge-api.md` 为准。
 
 ## 接口变更流程
 
diff --git a/docs/public-api.md b/docs/public-api.md
index e668cb5..d998b78 100644
--- a/docs/public-api.md
+++ b/docs/public-api.md
@@ -93,10 +93,17 @@ type PublicDetail = {
   excluded: string[];
   notes: string[];
   gallery: string[];
+  conciergeAdvisor: {
+    avatar: string;
+    name: string;
+    role: string;
+    details: Array<{ icon: string; label: string }>;
+    qrImage: string;
+  } | null;
 };
 ```
 
-不存在、停用或未配置详情返回 `404`。MiniAPP 路线详情页通过 `/pages/detail/index?routeId={key}` 进入；接口失败或字段不完整时按路线 ID 使用本地网络图片和模拟文案。该详情页暂不提供价格、收藏、在线订阅、预订、订单或管家联系动作。
+不存在、停用或未配置详情返回 `404`。关联管家未配置、已删除或已停用时 `conciergeAdvisor` 为 `null`。MiniAPP 路线详情页通过 `/pages/detail/index?routeId={key}` 进入；接口失败或字段不完整时按路线 ID 使用本地网络图片和模拟文案，fallback 不伪造管家数据。仅当 `conciergeAdvisor` 有效时展示联系管家入口。
 
 ## 管家展示