代聊系统 · 创作者端 24 小时关闭代聊冷静期 · 设计说明

文档类型：从 PRD v2.0 提取的专项设计说明 来源文档：PRD_代聊系统_产品需求文档 (1).md + PRD_代聊系统_技术落地版 (1).md PRD 版本：v2.0 | 2026-04-08 整理日期：2026-05-23 整理人：PM 助手 + 张一章 关联条款：CP-01 ~ CP-05、GR-02、EX-08、AC-27 ~ AC-32

一、核心设计哲学

对代聊员撒谎，保护创作者。 代聊员对冷静期完全不知情。

如果代聊员知道"24 小时后这个号就不属于我了"，极有可能疯狂发低俗内容、引流竞品、拉黑粉丝，进行同归于尽式毁号操作。

二、状态机定义

Off（关闭） ─→ On（开启） ─→ CoolingDown（冷静期） ─→ Off / On（撤回）

三、规则清单（CP 系列 + GR-02）

四、双端体验对照（关键差异）

4.1 创作者端（全程透明可见）

4.2 代聊员端（绝对静默 · 严禁告知）

五、数据库字段

users 表新增 2 个字段：

六、API 接口

七、完整流程

graph TD
A["创作者点击'关闭代聊'"] --> B["弹出挽留弹窗（CP-04）"]
B --> C{"创作者坚持关闭？"}
C -->|"被挽留，取消"| D["保持开启"]
C -->|"确认关闭"| E["设置 agent_chat_disabled_at = NOW()<br/>agent_chat_enabled 保持 true（CP-01）"]
E --> F["创作者端：显示24h倒计时（CP-02）<br/>+ 一键撤回按钮"]
E --> G["代聊端：零提示<br/>一切照常工作（GR-02）"]

F --> H{"创作者24h内撤回？"}
H -->|"撤回（CP-03）"| I["清除 disabled_at<br/>恢复正常"]
H -->|"未撤回，24h到（CP-05）"| J["agent_chat_enabled = false<br/>所有 agent_session 关闭"]

J --> K["创作者端：<br/>所有对话恢复可见"]
J --> L["代聊端：<br/>弹出'用户已离线'<br/>会话消失"]

style G fill:#d4edda,stroke:#28a745
style L fill:#f8d7da,stroke:#dc3545
style E fill:#e8daef,stroke:#8e44ad

八、相关页面规格

页面 C-P03：创作者中心 → 代聊设置（CreatorAgentScreen）

Tab1 代聊设置包含：

• 代聊开关：Switch 组件
• 关闭流程：点击关闭 → 弹挽留弹窗（显示"代聊帮你赚了 ¥xxx，关闭后粉丝互动将无人响应"）→ 确认关闭 → 显示 24h 倒计时 + 蓝色"撤回关闭"按钮
• 人设卡片配置

九、验收标准（AC-27 ~ AC-32 共 6 项）

十、异常场景

EX-08：创作者反复开关代聊

场景：频繁开 → 关 → 开

系统处理：

• 关闭有 24h 冷静期，冷静期内可撤回不消耗次数
• 到期后再开启，系统重新遍历粉丝做 72h 判定
• 不做额外限制，但运营可监控该创作者行为

优先级：P1

十一、关键要点速记表

十二、设计风险与防护

风险 1：代聊员蓄意破坏

风险描述：如果代聊员知道冷静期存在，可能在 24h 内进行毁号操作（发低俗内容、引流竞品、拉黑粉丝）。

防护机制：

• GR-02 静默冷静期：代聊端零提示
• 数据库字段 agent_chat_enabled 在冷静期内保持 true，代聊端无法通过状态判定
• 到期切断使用通用文案"用户已离线"，与正常用户流失无差异

风险 2：创作者不安导致离开平台

风险描述：完全黑箱让创作者怀疑"平台是不是拿着我的账号搞诈骗""我的死忠粉是不是被洗走了"。

防护机制：

• 配套代聊战报面板（GR-03）：创作者看不到聊天内容，但能看到脱敏的收入/互动数据
• 挽留弹窗（CP-04）：用具体收入数字（如"¥2,380"）让创作者意识到关闭代价
• 撤回按钮（CP-03）：给创作者后悔的余地

风险 3：创作者反复开关骚扰系统

风险描述：频繁开关代聊会触发多次粉丝重新分配，可能影响代聊员效率。

防护机制：

• EX-08：不做开关次数限制，但运营后台监控异常行为
• 24h 冷静期本身就是一道速率限制——关闭后必须等 24h 才能真正生效

修订记录