系统使用 · 测试文档 · 持续更新

🎓 小陆辅导 · 文章写作辅导平台

面向管理员（小陆）、写手、客户三端的一站式论文辅导协作平台：闲鱼订单同步（自动分配 KEY、写手抢单）、套餐与写手管理、订单分配、三方实时沟通（文字 / 图片 / 语音）、写手通讯录私聊、内部论坛、客户免登录下单、数据自动清理。

文档版本v1.6
系统地址https://xiaolu-tutoring.pages.dev
写手工作台https://xiaolu-tutoring.pages.dev/writer.html
客户门户https://xiaolu-tutoring.pages.dev/client.html
更新日期2026-08-12

1平台概览

小陆辅导是一个连接论文辅导客户与写手的协作平台。客户通过客户门户选择套餐下单；管理员在后台接收订单、分配写手并管理套餐；写手拥有独立工作台，只查看自己负责的订单。订单分配后，管理员（小陆）、写手、客户三方可在同一订单下沟通；此外写手之间、写手与管理员之间还可通过通讯录私聊，并在内部论坛发帖交流。平台部署于 Cloudflare Pages，数据存储于 Cloudflare D1（免费版单库 500 MB 上限）。

👑

管理员 · 小陆

订单 / 套餐 / 写手全局管理，沟通中心、通讯录私聊、内部论坛、数据清理、使用文档

https://xiaolu-tutoring.pages.dev/（管理后台）
✍️

写手（独立工作台）

我的订单、订单沟通、通讯录私聊（写手间 / 与管理）、内部论坛

https://xiaolu-tutoring.pages.dev/writer.html
🙋

客户

免注册浏览套餐、下单，凭专属链接查看订单并沟通

https://xiaolu-tutoring.pages.dev/client.html（免登录下单）
💡 角色与可见性规则：订单分配后，管理员、写手、客户均可查看该订单的完整对话；写手只能看到分配给自己的订单；写手登录后自动进入独立工作台，不进入管理后台；管理员与写手共享通讯录与内部论坛。
flowchart LR
  C[客户门户 /client.html] -->|浏览套餐/下单| A[API 网关]
  A -->|订单+token| DB[(D1 数据库)]
  M[管理后台 /] -->|订单/套餐/写手管理| A
  W[写手工作台 /writer.html] -->|我的订单| A
  W2[写手/管理员] -->|通讯录私聊| A
  W3[写手/管理员] -->|内部论坛 发帖/回复| A
  C2[客户专属链接] -->|token 自动登录| A
  subgraph 沟通体系
    A -->|订单对话: 文字/图片/语音| DB
    A -->|私聊: 文字/图片/语音| DB
  end
  A -->|图片/语音文件| R2[(R2 对象存储)]
图 1-1：平台架构与数据流向（v1.2）

2账号清单与入口

2.1 管理员账号

角色用户名密码说明
管理员adminadmin123系统显示名为「小陆」，拥有全部管理权限
⚠️ 生产环境请立即修改默认密码：更新 ADMIN_PASSWORD 环境变量（wrangler.toml）。

2.2 写手示例账号（密码均为 writer123）

用户名手机号专业方向说明
张老师13800001111数学与应用数学可测试写手间私聊
李老师13800002222英语语言文学—
王老师13800003333计算机科学与技术已有 3 单，可测试写手视角与私聊
赵老师13800004444经济学—
陈老师13800005555临床医学—
刘老师13800006666法学—

2.3 客户账号（免注册）

客户无需注册。下单后系统自动生成 16 位访问口令（Token）与专属链接，客户凭链接自动登录。测试方法：在客户门户下单，或构造链接 https://xiaolu-tutoring.pages.dev/client.html?token=口令。

3管理员使用手册（小陆）

3.1 登录与工作台

登录访问系统首页，选择「管理员」身份，输入 admin / admin123。
身份显示登录后侧边栏显示「小陆」，进入工作台（6 项统计卡片 + 3 张图表）。
仪表盘图表近30天订单趋势（柱状+折线）、套餐分类占比（环形图）、写手排行（按完成订单与收入），数据实时统计。

3.2 订单管理（含客户免登录链接）

新建订单点击「+ 新建订单」，填写客户信息并选择套餐提交；成功后将自动复制客户免登录链接到剪贴板并弹窗提示，直接发给客户即可。
订单列表链接每个订单右侧有 🔗链接 按钮，一键复制该订单的客户免登录链接（https://xiaolu-tutoring.pages.dev/client.html?token=xxx），随时可再次发送给客户。
分配写手待处理订单点击「分配」，选择写手后订单转为「进行中」，系统自动发送通知。
状态流转支持 待处理 / 进行中 / 已完成 / 已取消，可按状态筛选；每次状态变更、分配、交付自动写入订单进度时间线。
订单详情点击订单行「详情」，可查看完整信息、📌 订单进度时间线（创建→分配→进行中→交付→完成）、📎 交付文件（可下载 / 删除 / 上传补交）。

3.3 套餐管理

新建套餐配置名称、价格、辅导天数、修改次数、字数、特色功能、排序、上架状态。
编辑 / 下架 / 重新上架套餐卡片操作按钮；下架后客户不可见但历史订单不受影响。
四类分类职称论文 / 研究生论文 / 大学论文 / 日常文稿·PPT；研究生论文按辅导深度分档（普通 ¥499 / 深度 ¥999 / 全程 ¥1999），服务内容贴合研究生实际需求：开题报告、文献综述、数据分析、查重降重、盲审意见应对等（写手团队均为研究生水平，可胜任）。

3.4 写手管理

添加写手填写姓名、昵称、手机、微信、专业、擅长领域、登录密码（≥6 位）、评分。
编辑 / 重置密码 / 删除写手卡片操作；有进行中订单的写手删除时自动转为「停用」。

3.5 沟通中心与通讯录

沟通中心：管理员可查看并参与全部订单对话，发送文字 / 图片（自动压缩）/ 语音，身份显示「小陆」（紫色气泡）。

通讯录：管理员可见全部写手，可发起一对一私聊（文字 / 图片 / 语音），未读消息带角标提醒。

3.6 内部论坛与使用文档

内部论坛侧边栏「内部论坛」，管理员与写手均可发帖、回复；管理员可删除任意帖子。
使用文档侧边栏「📖 使用文档」，系统内置本使用与测试文档，随系统更新同步维护，可随时查阅（支持打印）。
数据清理写手管理页「🧹 数据清理」手动清理旧数据并显示数据库占用。

4写手使用手册（独立工作台）

✅ v1.2 起写手拥有独立工作台 https://xiaolu-tutoring.pages.dev/writer.html：登录后自动跳转，不再进入管理后台，只能看到分配给自己的订单。
登录访问系统首页（https://xiaolu-tutoring.pages.dev），选择「写手」身份，输入姓名（或手机号）+ 密码（示例：王老师 / writer123），自动进入写手工作台。
数据概览我的订单页顶部显示个人统计：总订单 / 进行中 / 已完成 / 待处理 / 累计收入，近7天新增订单柱状图与最近动态列表。
抢单大厅侧边栏「⚡ 抢单大厅」显示全部待抢订单（含 🛒 闲鱼订单与手动订单）：显示客户、套餐、金额、提交时间与备注；点击「抢单」先到先得，抢到后自动进入我的订单并开始计时；已被他人抢走的订单会提示「该订单已被抢或已分配」。
我的订单仅显示分配给自己的订单，支持按状态筛选；闲鱼订单带 🛒 标识；点击「详情」查看订单完整信息。
订单详情含📌 订单进度时间线（创建→分配→交付→完成全过程）与📎 交付文件管理：点击上传框选择文件交付成果（支持文档/PDF/压缩包，≤50MB，可填备注），上传后客户和管理员均可下载；写手可删除自己上传的文件。
订单沟通与小陆、客户实时对话，支持文字 / 图片（自动压缩）/ 语音，5 秒自动刷新。
通讯录可见管理员「小陆」与全部写手，点击联系人即可私聊（文字 / 图片 / 语音），未读角标提醒。
内部论坛浏览帖子、发帖、回复；管理员帖子带 🏛️ 标识。
⚠️ 账号被停用后无法登录，提示「用户名或密码错误，或账号已被停用」。

5客户使用手册

5.1 下单流程

打开客户门户访问 https://xiaolu-tutoring.pages.dev/client.html（或管理后台登录页「我是客户？去下单」）。
浏览套餐首页热门套餐 / 套餐页全部套餐，点击卡片可选中。
填写并提交称呼、联系方式、套餐、学科、题目、备注 → 提交订单。
获取专属链接成功页显示订单号与专属链接，可一键复制或立即进入。

5.2 订单查看与沟通

自动登录凭专属链接（或输入访问口令）进入「我的订单」。
闲鱼订单与 KEY来自闲鱼的订单带 🛒 标识；下单成功后系统自动分配激活 KEY（卡密），订单详情顶部显示金色 🔑 卡密卡片，一键复制，无需等待人工发放。
订单详情查看套餐、金额、辅导老师、状态，以及📌 订单进度时间线（创建→分配→进行中→交付→完成全流程可视化）。
交付文件📎 交付成果列表：写手交付的文件（论文/文档/PPT等）可直接在线下载查看。
沟通点击「与老师沟通」，与小陆和写手实时对话，支持文字 / 图片 / 语音。

6通讯录与私聊

v1.2 新增的站内即时通信能力，用于写手之间、写手与管理员的非订单事务沟通（如排班协调、请教经验）。

📇 通讯录成员

管理员可见：全部写手；写手可见：管理员「小陆」+ 全部写手。支持按姓名搜索。

💬 会话能力

文字、图片（自动压缩）、语音消息；未读消息数角标；会话列表显示最后一条消息与时间；5 秒自动刷新。

💡 私聊记录独立于订单对话存储；数据自动清理会同步清理 60 天前的私聊记录。

7内部论坛

v1.2 新增的内部交流区，管理员与写手均可参与，用于发布平台通知、经验分享、求助答疑。

浏览帖子列表按时间倒序，显示标题、作者、回复数、时间；管理员帖子带 🏛️ 标识。
发帖输入标题与内容，点击「发布」；管理员与写手均可发帖。
回复点击帖子进入详情，查看全部回复并发表回复。
删除仅管理员可删除帖子（写手无权限，接口返回 403）。

8系统自动功能说明

8.1 聊天记录自动清理（2 个月）

每次 API 请求有 10% 概率触发惰性清理，自动删除超过 60 天的订单消息与私聊记录，无需人工干预。

8.2 数据库容量自动保护

Cloudflare D1 免费版单库上限 500 MB，超过后无法写入[1]。系统在清理时读取数据库实时大小，达到 400 MB（80%）时自动深度清理：30 天前消息与日志、90 天前已完成/取消订单。

8.3 图片自动压缩

发送图片时前端自动处理：超过 1 MB 或宽度大于 1920px 的图片压缩为 JPEG（质量 80%），PNG 透明底转白底，GIF 动图不压缩。

8.4 语音消息

基于 MediaRecorder 录音（WebM/MP4），上传 R2 后以播放器展示；三端与私聊均可使用，单文件上限 20 MB。

8.5 会话安全

登录会话持久化存储于数据库，7 天自动过期；客户口令永久有效直至订单被清理。

9闲鱼接入（下单自动分配 KEY + 写手抢单）

✅ v1.6 起系统接入闲鱼（闲管家开放平台）：闲鱼买家下单后自动建单、自动匹配套餐、自动生成分配 KEY 并即时展示给客户，同时订单进入抢单大厅供写手先到先得抢单。

9.1 接入前提

开通闲管家在闲管家开放平台（open.goofish.pro）开通铂金版（48 元/月或 198 元/年），创建「进销存」应用获得 AppKey / AppSecret；需已开通鱼小铺店铺，支持 7 天免费体验。
配置回调密钥将闲管家侧获取的应用密钥填入系统环境变量 XIANYU_API_KEY（当前为占位默认值，上线前必须替换）。
配置回调地址在闲管家应用回调中填写 https://xiaolu-tutoring.pages.dev/api/xianyu/callback，闲鱼新订单将自动推送至此接口。

9.2 自动分配 KEY 流程

闲鱼下单买家在闲鱼拍下商品并付款。
自动建单闲管家推送订单 → 系统校验 Bearer 密钥 → 同一闲鱼订单号幂等（重复推送自动跳过）→ 创建订单（来源标记 🛒 闲鱼）。
匹配套餐按商品标题关键词自动匹配平台套餐（如「全程/无忧/深度/优秀/初级/中级/高级」等），匹配不到时自动选择第一个套餐兜底。
生成 KEY系统自动生成唯一卡密（格式 XL-XXXX-XXXX，去除易混淆字符 0/O/1/l/I），KEY 同时写入卡密台账表并留痕订单时间线。
自动显示客户凭回调返回的专属链接进入「我的订单」，详情顶部立即显示金色 🔑 卡密卡片，一键复制，无需人工发放。
推送写手新订单自动出现在每位写手工作台的「⚡ 抢单大厅」，状态为「待抢」。

9.3 写手抢单规则

先到先得任一写手点击「抢单」，系统原子更新订单（仅待抢状态可抢），成功者自动成为该订单写手，状态变「进行中」，全程写入订单时间线。
防并发两写手同时抢同一订单时，仅一人成功；另一方收到提示「该订单已被抢或已分配」。
系统通知抢单成功后向抢单写手推送站内消息，管理员在订单列表可见闲鱼标识与 KEY 按钮。

9.4 相关接口

接口说明鉴权
POST /api/xianyu/callback闲鱼订单回调：建单 + 匹配套餐 + 生成分配 KEY，返回 client_urlBearer XIANYU_API_KEY
GET /api/orders/claims抢单大厅列表（全部待抢订单，含闲鱼/手动）写手登录
POST /api/orders/:id/claim抢单（原子更新，先到先得）写手登录
GET /api/orders/:id/key按订单查看 KEY（管理员/订单写手/订单客户）三端登录
GET /api/keys卡密台账列表（近 200 条，含订单与来源）管理员
⚠️ 当前为模拟联调状态（默认密钥 your-xianyu-api-key-here）。开通闲管家后将真实 AppKey/AppSecret 填入 XIANYU_API_KEY 并重新部署即可上线，无需改动其他代码。

10测试用例清单

共 67 条测试用例，覆盖管理员 / 写手 / 客户 / 通讯录私聊 / 内部论坛 / 系统自动 / 闲鱼接入七类。执行时按编号逐条测试，在「11. 测试记录表」中填写结果。

10.1 管理员模块 24 条

编号测试项操作步骤预期结果
TC-001管理员登录选择「管理员」，输入 admin / admin123登录成功，进入工作台，侧边栏显示「小陆」
TC-002工作台统计进入工作台查看统计卡片待处理/进行中/已完成/总收入与订单一致
TC-003新建订单订单管理 → 新建订单生成订单号、客户 token 与专属链接
TC-004订单详情点击订单「详情」展示套餐、金额、题目、学科、备注、写手、时间
TC-005分配写手待处理订单 → 分配 → 选择写手状态变「进行中」，写手收到系统通知
TC-006标记完成进行中订单 → 标记完成状态变「已完成」，收入统计更新
TC-007状态筛选按四种状态筛选列表正确过滤
TC-008新建套餐套餐管理 → 新建套餐创建成功，客户门户可见
TC-009编辑套餐套餐卡片 → 编辑 → 修改价格保存后价格立即生效
TC-010下架套餐套餐卡片 → 下架置灰显示「已下架」，客户门户不可见，历史订单不受影响
TC-011重新上架已下架套餐 → 重新上架套餐恢复正常，客户门户可见
TC-012添加写手写手管理 → 添加写手，设置密码创建成功，新写手可用该账号登录
TC-013编辑写手写手卡片 → 编辑 → 修改专业/评分信息更新成功
TC-014重置密码写手卡片 → 重置密码写手使用新密码可登录，旧密码失效
TC-015删除写手对无订单写手执行删除删除成功，账号消失
TC-016停用保护对王老师（有进行中订单）执行删除转为停用，订单不受影响，账号无法登录
TC-017管理员对话沟通中心选择订单，发送文字紫色气泡显示，发送者「小陆」
TC-018数据清理写手管理页 → 数据清理弹窗显示删除条数与数据库占用 MB
TC-019未授权拦截不带 token 调用管理 API返回 401「未授权，请以管理员身份登录」
TC-040订单客户链接订单列表点击任意订单「🔗链接」弹出提示并复制客户免登录链接到剪贴板
TC-041使用文档入口侧边栏点击「📖 使用文档」内容区展示本使用与测试文档，可滚动查看
TC-053仪表盘图表进入工作台查看图表区渲染 3 张图表：近 30 天订单趋势（柱状+折线）、套餐分类占比（环形图）、写手排行（横向柱状）
TC-054订单时间线订单详情 → 查看 📌 进度时间线展示创建/分配/状态变更/交付等节点，含操作人与时间
TC-055交付文件管理订单详情 📎 交付文件 → 查看/删除/提示写手补交文件列表含大小与上传人；删除需确认；操作记录写入时间线

10.2 写手模块 10 条

编号测试项操作步骤预期结果
TC-020写手登录选择「写手」，输入 王老师 / writer123登录成功，自动跳转独立写手工作台
TC-021订单隔离写手登录后查看「我的订单」仅显示分配给自己的订单（王老师 3 单）
TC-022写手发文字订单沟通选择订单，发送文字蓝色气泡显示，发送者为写手姓名
TC-023写手发图片发送 3MB 以上大图发送成功且图片被压缩
TC-024写手发语音点击 🎤 录音后结束发送消息包含可播放语音条
TC-025停用拦截用被停用账号尝试登录提示「用户名或密码错误，或账号已被停用」
TC-042写手访问管理后台写手登录态下直接访问 https://xiaolu-tutoring.pages.dev自动重定向到 https://xiaolu-tutoring.pages.dev/writer.html
TC-043写手无管理菜单检查写手工作台侧边栏仅含 我的订单/订单沟通/通讯录/内部论坛，无套餐/写手管理等
TC-056数据概览进入写手工作台「我的订单」顶部展示 5 个统计卡片（总单/进行中/已完成/待处理/累计收入）+ 近 7 天订单柱状图 + 最近动态列表
TC-057交付文件上传订单详情 📎 → 选择文档/PDF/压缩包 → 填写备注 → 上传上传成功（≤50MB），列表可见文件与备注，管理员/客户端同步可见

10.3 客户模块 12 条

编号测试项操作步骤预期结果
TC-026门户访问访问 https://xiaolu-tutoring.pages.dev/client.html展示品牌、热门套餐、下单表单
TC-027套餐浏览进入「套餐」页展示全部上架套餐
TC-028提交下单填写信息选择套餐提交成功卡片显示订单号 + 专属链接
TC-029链接自动登录访问专属链接免注册自动登录，进入「我的订单」
TC-030订单列表登录后查看我的订单仅显示自己的订单，含状态徽章
TC-031订单详情点击订单卡片展示套餐、金额、写手、状态、备注
TC-032客户发文字与老师沟通 → 发送文字灰色气泡显示
TC-033客户发图片发送大图图片自动压缩后上传成功
TC-034客户发语音点击 🎤 录音发送生成可播放语音消息
TC-035口令登录右上角登录 → 输入口令错误口令提示无效；正确口令进入订单
TC-058订单进度时间线订单详情 → 查看 📌 进度时间线展示创建/分配/进行中/交付/完成等节点，客户可直观了解进度
TC-059交付文件下载订单详情 📎 交付文件 → 点击下载文件可正常下载打开，内容与写手上传一致

10.4 通讯录与私聊 6 条

编号测试项操作步骤预期结果
TC-044管理员发起私聊管理员 → 通讯录 → 选择写手 → 发送文字消息发送成功，写手端可见
TC-045未读提醒写手不打开通讯录，管理员再发一条写手通讯录侧边栏出现未读角标，列表显示未读数
TC-046写手回复管理员写手 → 通讯录 → 小陆 → 回复管理员通讯录出现未读角标与消息
TC-047写手之间私聊王老师 → 通讯录 → 张老师 → 发送消息张老师登录后可查看该会话
TC-048私聊发图片私聊窗口发送大图图片压缩后发送成功
TC-049私聊发语音私聊窗口 🎤 录音发送对端可见可播放的语音消息

10.5 内部论坛 3 条

编号测试项操作步骤预期结果
TC-050发帖与浏览管理员/写手在内部论坛发布帖子帖子出现在列表，显示作者与时间，管理员带 🏛️ 标识
TC-051回复帖子打开帖子详情 → 发表回复回复出现在详情页，回复数 +1
TC-052删除权限写手尝试删除帖子；管理员删除帖子写手被拒（仅管理员可删除）；管理员删除成功

10.6 系统自动模块 4 条

编号测试项操作步骤预期结果
TC-036消息自动清理执行 60 天清理 SQL 验证规则60 天前的消息可被清除，索引生效
TC-037容量保护检查清理接口 db_size_mb；模拟超 400MB自动深度清理旧数据
TC-038图片压缩效果上传 5MB、4000×3000 图片压缩后明显小于原图，可正常预览
TC-039会话过期等待 7 天或手动删除 sessions 记录旧 token 失效，需重新登录

10.7 闲鱼接入模块 8 条 ✅ 已测

编号测试项操作步骤预期结果
TC-060闲鱼回调建单POST /api/xianyu/callback（正确 Bearer 密钥）推送订单创建订单成功，来源标记 🛒 闲鱼，返回订单号与 client_url
TC-061套餐自动匹配推送标题含「全程」的商品自动匹配「研究生论文全程辅导」等含全程套餐，不依赖固定 ID
TC-062KEY 自动生成回调建单成功后查卡密台账自动生成 XL-XXXX-XXXX 格式唯一卡密，状态 active，时间线留痕
TC-063重复推送幂等再次推送同一 xianyu_order_id返回「订单已存在，跳过重复推送」，不重复建单不重复发 KEY
TC-064推送写手可见写手登录 → 抢单大厅闲鱼订单出现在待抢列表，显示客户/套餐/金额/备注
TC-065先到先得抢单写手 A 点击「抢单」抢单成功，订单归属写手 A，状态变进行中，时间线记录抢单
TC-066并发抢单保护写手 B 抢已被 A 抢走的同一订单提示「该订单已被抢或已分配」，不产生双写手
TC-067客户查看 KEY客户访问 client_url → 订单详情详情顶部显示金色 KEY 卡，可一键复制；管理后台「卡密管理」同步可见

10.8 测试进度统计

图 10-1：测试用例分布（闲鱼接入 8 条 ✅ 已通过，其余待执行时更新）

11测试记录表

按 TC 编号逐条执行，通过打 ✓，失败记录现象与截图。

编号执行人结果
✓ / ✗		发现的问题 / 备注
TC-001
TC-002
TC-003
TC-004
TC-005
TC-006
TC-007
TC-008
TC-009
TC-010
TC-011
TC-012
TC-013
TC-014
TC-015
TC-016
TC-017
TC-018
TC-019
TC-020
TC-021
TC-022
TC-023
TC-024
TC-025
TC-026
TC-027
TC-028
TC-029
TC-030
TC-031
TC-032
TC-033
TC-034
TC-035
TC-036
TC-037
TC-038
TC-039
TC-040
TC-041
TC-042
TC-043
TC-044
TC-045
TC-046
TC-047
TC-048
TC-049
TC-050
TC-051
TC-052
TC-053
TC-054
TC-055
TC-056
TC-057
TC-058
TC-059
TC-060自动化 E2E✓2026-08-12 生产环境验证通过（订单号 / client_url 均返回）
TC-061自动化 E2E✓含「全程」标题自动匹配全程套餐，通过
TC-062自动化 E2E✓XL-XXXX-XXXX 格式唯一卡密，状态 active，通过
TC-063自动化 E2E✓重复推送被拦截，未重复建单未重复发 KEY，通过
TC-064自动化 E2E✓订单出现在写手抢单大厅，客户/套餐/金额/备注齐全，通过
TC-065自动化 E2E✓写手甲抢单成功，订单归属确认，状态转进行中，通过
TC-066自动化 E2E✓写手乙抢同一订单返回 409，无双写手；重复抢占亦 409，通过
TC-067自动化 E2E✓客户门户显示金色 KEY 卡可复制；管理后台卡密台账同步可见，通过

12附录

11.1 常用链接

用途地址
管理后台（管理员登录）https://xiaolu-tutoring.pages.dev
写手工作台https://xiaolu-tutoring.pages.dev/writer.html
客户门户（免登录下单）https://xiaolu-tutoring.pages.dev/client.html
使用与测试文档https://xiaolu-tutoring.pages.dev/docs/xiaolu-usage-guide.html
健康检查https://xiaolu-tutoring.pages.dev/api/health

11.2 核心 API 一览

方法路径说明鉴权
POST/api/orders客户下单，返回 token 与专属链接公开
GET/api/orders?writer_id=订单列表（写手按 ID 过滤）公开*
PUT/api/orders/:id/assign分配写手管理员会话
POST/api/packages新建套餐管理员会话
PUT/DELETE/api/packages/:id编辑 / 下架套餐管理员会话
POST/api/writers添加写手管理员会话
PUT/DELETE/api/writers/:id编辑 / 删除写手管理员会话
PUT/api/writers/:id/password重置写手密码管理员会话
POST/api/auth/client-login客户口令自动登录公开（需口令）
GET/api/client/orders客户查询自己的订单客户会话
GET/POST/api/messages(/:id)订单消息读取 / 发送（含图片、语音）公开*
POST/api/chat/send发送私聊消息管理员/写手会话
GET/api/chat/conversations私聊会话列表（含未读）管理员/写手会话
GET/api/chat/messages?with=私聊聊天记录管理员/写手会话
POST/api/forum/posts发布帖子管理员/写手会话
GET/api/forum/posts(/:id)帖子列表 / 详情（含回复）公开
POST/api/forum/posts/:id/replies回复帖子管理员/写手会话
DELETE/api/forum/posts/:id删除帖子仅管理员
POST/api/upload图片 / 音频上传（R2）公开*
POST/api/admin/cleanup手动数据清理管理员会话

* 标注「公开」的管理写操作需在系统运行中通过登录会话校验；会话有效期 7 天。

11.3 文档维护说明

📌 本使用与测试文档随系统功能同步维护：每次系统更新时，同步更新文档中的功能说明、测试用例清单与版本号。文档内嵌于管理员界面「📖 使用文档」，可直接查阅，支持浏览器打印。

11.4 常见问题

Q1：客户忘记保存专属链接怎么办？

回到客户门户点击右上角「登录」输入访问口令；口令丢失时，管理员在订单列表点击「🔗链接」重新获取并发送。

Q2：语音发送失败？

请使用 Chrome / Edge，允许麦克风权限；录音过短（<1 秒）会被拦截。

Q3：图片上传失败？

支持 JPG / PNG / GIF / WebP，单文件上限 20MB；大图自动压缩，仍超限请先手动缩小。

Q4：写手看不到订单？

请确认管理员已在订单上「分配」该写手；写手只能看到分配给自己的订单。

Q5：数据库满了怎么办？

系统在 400MB 时自动深度清理，也可在写手管理页手动清理；仍紧张可升级 Workers 付费版（单库上限 10GB）。

12更新历史

v1.6（2026-08-12）

  • 新增：闲鱼接入（闲管家开放平台 webhook 回调 /api/xianyu/callback）：闲鱼下单后自动建单、按商品标题自动匹配套餐、自动生成分配 KEY（卡密）并即时展示给客户
  • 新增：写手抢单机制（先到先得）：抢单大厅展示全部待抢订单（闲鱼 + 手动），原子更新防并发抢单，抢单全程写入订单时间线并通知写手
  • 新增：管理后台「卡密管理」页：闲鱼订单 KEY 全量台账（订单号/客户/套餐/KEY/状态），支持一键复制与按订单查看
  • 新增：客户门户闲鱼订单详情顶部金色 KEY 卡（一键复制）；订单列表闲鱼标识 🛒
  • 优化：套餐匹配不再硬编码 ID，按闲鱼商品标题关键词动态匹配（套餐调整后无需改代码）
  • 安全：webhook 使用 Bearer 密钥（XIANYU_API_KEY）鉴权；重复推送幂等（同一闲鱼订单号只建一单）

v1.5（2026-08-12）

  • 新增：管理后台仪表盘 3 张图表（近 30 天订单趋势 / 套餐分类占比 / 写手排行）
  • 新增：订单进度时间线（创建、分配、状态变更、交付自动记录），三端订单详情均可见
  • 新增：交付文件功能（写手上传 ≤50MB，管理员管理，客户下载）
  • 新增：写手工作台数据概览（5 项统计卡片 + 近 7 天趋势 + 最近动态）
  • 优化：研究生套餐按辅导深度分档（普通 ¥499 / 深度 ¥999 / 全程 ¥1999），内容贴合研究生写手团队水平

v1.4（2026-08-11）

  • 修复：手机端输入长句时输入法提前关闭的问题（所有聊天输入框统一使用 <textarea> + enterkeyhint="send" + 自动扩展高度）
  • 优化：管理后台订单列表和详情页增加一键复制客户免登录链接按钮
  • 优化：新建订单完成后自动复制客户链接到剪贴板
  • 文档：手册中所有平台入口使用完整网址

v1.3（2026-08-10）

  • 文档：管理后台使用文档入口，系统更新同步维护

v1.2（2026-08-10）

  • 新增：写手独立工作台（writer.html）
  • 新增：通讯录与私聊（写手之间、写手与管理员）
  • 新增：内部论坛（发帖、回复、管理员删除）
  • 新增：管理后台订单显示客户免登录链接