降重接口二开 - 艺创AI-文档中心

核心接口定义
后端 API 接口主要定义在 server/app/api/controller/ReductionController.php 中。
1.1 提交降重订单接口 (place)

接口地址: POST /api/reduction/place

功能: 创建一个降重订单（待支付状态）。它不会立即执行降重，而是复制原订单的文档内容，准备进行降重。

请求参数:

order_id (int): 原写作订单的 ID。

terminal (int): 终端类型 (1=微信小程序, 2=微信公众号, 3=H5, 4=PC, 5=安卓)。

代码逻辑:

调用 ReductionLogic::place。

校验原订单是否存在且属于当前用户。

校验写作分类是否开启了降重功能 (reduction_status)。

创建新订单，类型为 OrderEnum::ORDER_TYPE_REDUCTION，价格取自分类配置的 reduction_price。

关键点: 新订单会完整复制原订单的 document (文档内容) 字段。

返回值:

JSON
{
"code": 1,
"show": 0,
"msg": "",
"data": {
"order_id": 123 // 新创建的降重订单ID
}
}
1.2 降重记录列表接口 (lists)

接口地址: GET /api/reduction/lists

功能: 获取用户的降重历史记录。

实现: 调用 ReductionOrderLists 类，返回标准的列表数据。

业务流程与核心逻辑
降重功能的执行是一个异步流程，依赖于消息队列。
2.1 支付与触发 (PayNotifyLogic)
用户支付成功后，系统通过支付回调触发降重任务。

文件: server/app/common/logic/PayNotifyLogic.php

逻辑:

handle('reduction', ...) 方法被调用。

将订单状态更新为“已支付”。

调用 BaseQueue::pushReduce($order) 将任务推送到队列。
2.2 队列处理 (ReQueueJob)
这是实际执行降重逻辑的地方。

文件: server/app/queue/ReQueueJob.php

执行步骤:

解析文档: 读取订单的 document 字段（JSON 结构），遍历所有章节。

过滤内容: 自动跳过包含“参考文献”、“参考”、“文献”的章节。

调用 AI: 对每个小节的内容，调用 AiReduceService::handle 进行降重。

更新进度: 每处理完一节，更新数据库中的 progress 字段（前端可能会用到进度条）。

保存结果: 所有章节处理完成后，将降重后的新内容覆盖保存到 document 字段，并将订单状态更新为 GEN_SUCCESS (2)。
2.3 AI 降重服务 (AiReduceService)

文件: server/app/common/service/ai/AiReduceService.php

外部接口: 调用第三方接口 https://open.aidianyun.com/api/weight_reduction/weight。

鉴权: 使用 AD_YUN 的 Key 进行鉴权（需在后台配置）。

前端调用 (PC端示例)

文件: pc/api/pay.ts

调用代码:

TypeScript

// 降重下单
export function reductionPrepay(params: any) {
return $request.post({ url: '/reduction/place',
params })
}

交互逻辑: 在 pc/pages/generate/index/user/index/buy_record.vue 中，用户点击“AI降重”按钮 -> 调用 reductionPrepay 下单 -> 跳转支付 -> 支付成功后轮询状态 -> 状态变为完成 -> 显示下载按钮。
总结
该项目的降重功能设计规范，采用了 Controller (API入口) -> Logic (业务逻辑) -> Queue (异步任务) -> Service (第三方调用) 的分层架构。如果需要修改降重的具体效果或更换提供商，主要只需修改 AiReduceService.php 即可。

服务端 (PHP)
核心业务 (API 接口)
这些文件负责处理前端用户的降重请求、下单和列表查询。

控制器: ReductionController.php (处理 place 下单, lists 列表, download 下载)

业务逻辑: ReductionLogic.php (实现下单逻辑，复制原订单内容)

验证器: ReductionValidate.php (校验请求参数)

列表查询: ReductionOrderLists.php (查询用户的降重历史)
核心服务 (后台处理)
这些文件负责实际的 AI 降重执行和异步任务处理。

AI 服务: AiReduceService.php (核心文件，调用第三方 API 执行降重)

server\app\adminapi\logic\write\CategoryLogic.php

server\app\common\service\ai\AiReduceService.php

队列任务: ReQueueJob.php (异步处理降重任务，解析文档并逐节降重)

支付回调: PayNotifyLogic.php (支付成功后触发队列任务)
管理后台 (AdminAPI)

控制器: ReductionController.php (后台管理降重记录)

注意：该控制器引用的 ReductionLogic 和 ReductionRecordLists 在对应目录下未找到，可能存在文件缺失或路径配置问题。

客户端 (PC 端)

API 定义: pay.ts (定义了 reductionPrepay 等接口)

入口页面: buy_record.vue (购买记录页，包含“AI降重”按钮和弹窗逻辑)

功能组件:

index.vue (降重支付弹窗)

index.vue (降重记录查看弹窗)

客户端 (Uniapp / 移动端)

目前在 Uniapp 目录下未发现明确的降重功能代码（如 reduction 相关的 API 或页面），推测移动端暂未实现该功能。
总结
如果您需要修改降重的核心逻辑（如更换 AI 提供商），请修改 AiReduceService.php。如果您需要修改前端交互，请关注 PC 端的 buy_record.vue 和相关组件。如果您需要排查任务不执行的问题，请检查 PayNotifyLogic.php 和 ReQueueJob.php。

AiReduceService.php

降重API接口优化版可用
erver\app\common\service\ai\AiReduceService.php

暂时无法在飞书文档外展示此内容
server\app\adminapi\logic\write\CategoryLogic.php 后台降重的地址

\pc\layouts\components\gen_siderBar\index.vue 侧边栏
\pc\layouts\generate.vue 内容布局
\pc\pages\generate\index[id].vue 顶部广告
\pc\layouts\components\header\user.vue 会员弹出UI

\pc\pages\index.vue 首页组件

\pc\layouts\components\header\index.vue 菜单栏
\pc\layouts\components\main\index.vue 布局

核心设计体系 (Design System)

项目采用了 Nuxt 3 结合 Element Plus 和 Tailwind CSS 的混合技术栈，构建了一套现代化的响应式 UI。

色彩系统：

主色调：蓝色系，核心变量定义在 assets/styles/var.css 中，主色为 #4a5dff。

辅助色：通过 tailwind.config.js 扩展了 Tailwind 的颜色配置，映射了 Element Plus 的颜色变量（如 primary-light-3 等），确保了组件库与自定义样式的一致性。

背景：使用了大面积的渐变背景（bg-gradient-to-br），例如从 primary-light-9 到白色的过渡，营造出轻盈的科技感。

排版与布局：

字体：优先使用 PingFang SC 和 Microsoft YaHei，确保中文阅读体验。

容器：核心内容区域通常限制在 1200px 宽度（min-w-[1200px]），但在移动端会自动适配。

响应式：通过 useAppStore 的 isMobile 状态和 Tailwind 的断点（如 md:mx-0）实现 PC/Mobile 双端适配。

布局架构 (Layouts)

项目包含两种核心布局，分别服务于营销展示和功能操作：

默认布局 (layouts/default.vue)：

适用场景：首页、信息页、个人中心等。

结构：

Header：固定顶部 (sticky)，包含 Logo、用户头像。导航栏逻辑看似被注释，可能处于调整期。

Main：内容区域，内置了登录状态检查 (ToLogin 组件) 和全局弹窗 (UserPop, Float)。

Footer：深色底设计，包含版权信息和协议链接。

生成页布局 (layouts/generate.vue)：

适用场景：核心写作工具页面。

结构：典型的 Sidebar + Main 两栏布局。

Sidebar：左侧侧边栏 (genSiderBar)，负责功能导航，支持折叠。移动端通过 el-drawer 抽屉式展示。

Main：右侧主要操作区，使用 el-scrollbar 实现独立滚动，背景沿用了主色调的渐变设计。

首页 UI 设计分析 (pages/index.vue)

首页采用了 CMS 驱动的装修模式，数据主要来源于 decorateData，分为四个主要视觉区块：

首屏 Banner (Hero Section)：

视觉：全屏宽度的动态背景图，叠加居中的大标题和副标题。

交互：核心 CTA 按钮（“立即前往体验”）使用了渐变色背景 (from-minor to-primary)，视觉权重极高。

类型导航轮播 (Carousel)：

功能：展示不同的写作类型（如论文、报告）。

设计：使用卡片式设计，每张卡片包含图标、标题、简介和使用统计。

微交互：卡片支持 Hover 上浮效果 (transform: translateY(-10px))，同时右下角的箭头图标会从透明变为可见，增强点击诱导。

产品特性介绍 (Product Features)：

布局：经典的左右交替图文混排 (Z-pattern)，符合用户浏览习惯。

元素：左图右文或左文右图，配有带颜色的对勾图标 (el-icon-SuccessFilled) 强调卖点。

底部引导 (Bottom Call-to-Action)：

目的：在页面底部再次转化用户。

设计：背景图 + 标题 + 强按钮，形成视觉闭环。

关键代码参考

全局样式变量： var.css

Tailwind 配置： tailwind.config.js

首页实现： index.vue

默认布局： default.vue

改进建议 (可选)

导航栏：layouts/components/header/index.vue 中注释掉了 Navbar，建议根据需求恢复或重新设计，方便用户在不同功能间跳转。

移动端适配：首页 Banner 的高度在移动端可能需要调整，避免占据过多首屏空间。

组件复用：首页的 CTA 按钮样式重复出现，建议封装为通用组件。

部署到 Vercel 平台。

e:\Paper\pc 目录是一个标准的 Nuxt 3 项目，完全支持部署到 Vercel 平台。
由于该项目目前配置了一些用于集成到现有 PHP 后端的自定义构建脚本（scripts/build.mjs），在部署到 Vercel 时，您需要对构建命令做一些简单的调整，以跳过这些特定环境的复制操作。
以下是详细的部署方案：

Vercel 项目配置
在 Vercel 导入 Git 仓库时，请按以下参数进行配置：

Root Directory (根目录): 选择 pc 目录（不要选根目录）。

Framework Preset (框架预设): Vercel 通常会自动识别为 Nuxt.js。

Build Command (构建命令):

重要: 不要使用默认的 npm run build。

因为 package.json 中的 build 命令包含 node scripts/build.mjs，它会尝试将文件复制到本地的一个相对路径（用于 PHP 后端），这在 Vercel 云端环境中会导致报错。

请覆盖为: npx nuxt build (推荐，支持 SSR 服务端渲染) 或 npx nuxt generate (纯静态站点)。

Output Directory (输出目录): 默认即可 (Nuxt 3 默认为 .output)。

环境变量配置 (Environment Variables)
根据您的代码逻辑 (pc/nuxt/env.ts)，项目会读取 NUXT_ 开头的环境变量。您需要在 Vercel 的 Settings -> Environment Variables 中添加以下变量：
变量名
建议值
说明
NUXT_API_URL
https://您的后端域名/api
必须。指向您的 PHP 后端 API 地址。
NUXT_SSR
true
可选。设为 true 开启服务端渲染 (SSR)；不填则默认为客户端渲染 (SPA/SSG)。
NUXT_BASE_URL
/
可选。默认为 /，除非您部署在子路径下。

部署模式选择建议

SSR 模式 (推荐):

命令: npx nuxt build

优势: Vercel 会将 Nuxt 部署为 Serverless Functions，首屏加载快，SEO 友好，且支持动态路由。

注意: 确保 NUXT_SSR 环境变量设为 true。

SSG/SPA 模式 (静态):

命令: npx nuxt generate

优势: 纯静态文件，响应极快，成本最低。

劣势: 每次内容更新需要重新构建部署。

总结
您可以直接将 pc 目录部署到 Vercel，只需在 Vercel 控制台将 Build Command 修改为 npx nuxt build 并配置好 NUXT_API_URL 即可，无需修改代码。