Initial commit

普惠算力平台-用户使用手册.md

+## 普惠算力平台-用户使用手册
+## 普惠算力平台-用户使用手册
+
+文档日期 ： 2026/06/30
+
+主页地址: [phslkhd.hnluchuan.com
+](https://phslkhd.hnluchuan.com/)
+
+本文档用于指导普通用户使用普惠算力平台。
+
+---
+
+### 1. 获取 apiKey
+
+#### (1) 登录页自动获取
+
+在登录页,**默认勾选"若无 token 令牌,自动创建"**。若新用户注册或无 apiKey 的账号登录,将自动获取 apiKey。
+
+#### (2) 已登录用户手动获取
+
+在登录情况下,可在**模型列表**点击「立即获取」,
+
+![模型列表](模型列表.png)
+
+或者 「控制台」→「个人中心」,在 token 卡片处点击「获取令牌」。
+
+![控制台个人中心](控制台个人中心.png)
+
+---
+
+### 2. 充值与消费
+
+#### (1) 发起充值
+
+获取 apiKey 后,「控制台」→「个人中心」,token 卡片会显示余额、apiKey、服务地址,以及**充值**。用户输入想要充值的金额,点击充值,扫二维码即可付款。
+
+![充值](充值.png)
+
+#### (2) 个人充值记录
+
+「控制台」→「token 使用记录」,选择「**充值**」tab 页,可看见个人的充值记录。
+
+![img](面相用户充值记录.png)
+
+#### (3) 查看消费记录
+
+「控制台」→「token 使用记录」,「**消费**」tab 页,可按照时间或者模型筛选查看消费总额、token 使用记录。这里的两次记录，一次是调用deepseek生成诗，是按量计费。一次是qwen生成图片，是按次计费。
+
+![token使用记录2.png](token使用记录2.png)
+
+---
+
+### 3. apiKey使用
+
+#### (1) 诗词生成测试
+
+通过 apiKey 调用大语言模型生成文字内容:
+
+![测试生成诗](测试生成诗.png)
+
+#### (2) 图片生成测试
+
+通过 apiKey 调用图像模型生成图片:
+
+![测试生成图片1](测试生成图片1.png)
+
+![测试生成图片2](测试生成图片2.png)
\ No newline at end of file

普惠算力平台-管理员使用手册.md

+# 普惠算力平台-管理员使用手册
+# 普惠算力平台-管理员使用手册
+
+文档日期 ： 2026/06/30
+
+普惠算力主站: [phslgld.hnluchuan.com](https://phslgld.hnluchuan.com/)
+
+普惠算力NewAPI中转站：[phslgld.hnluchuan.com:3000](http://phslgld.hnluchuan.com:3000/)
+
+本文档用于指导管理员用户管理普惠算力平台与普惠算力NewAPI中转站。
+
+---
+
+## 一、普惠算力NewAPI中转站
+
+### 1. 系统初始化
+
+按系统提示走完流程,创建管理员账号,**使用模式选择"对外运营模式"**。
+
+![系统初始化](系统初始化.png)
+
+---
+
+### 2. 添加渠道
+
+渠道是平台对接 AI 服务商的核心配置单元,每条渠道对应一个服务商的 API Key。使用管理员账号登录后,左侧导航点击「渠道」。渠道列表展示所有已配置的 AI 服务商渠道,包含名称、类型、状态(绿色 = 正常 / 红色 = 禁用)、响应时间、已用配额等信息。
+
+![添加渠道](添加渠道.png)
+
+**添加渠道流程:**
+
+1. 在渠道列表页点击右上角「添加渠道」按钮,弹出配置弹窗
+2. 在弹窗中选择服务商类型(天翼云的是 OpenAI)
+3. 填写渠道名称和 API Key
+4. 在模型列表中勾选该渠道支持的模型,**推荐点击「获取模型列表」按钮自动拉取**
+
+![获取模型列表](获取模型列表.png)
+
+5. 点击「提交」按钮完成渠道添加,新渠道出现在列表中
+
+![渠道创建成功](渠道创建成功.png)
+
+6. 渠道添加，支持批量增加模型。
+
+![1782729028239](image/普惠算力平台-管理员使用手册/1782729028239.png)
+
+---
+
+### 3. 添加模型
+
+使用管理员账号登录后,左侧导航点击「模型管理」。
+
+1. 在页面中点击「未配置模型」按钮,可看到渠道支持但**未被配置**的模型
+
+![未配置模型](未配置模型.png)
+
+2. 点击「配置」,模型名称已自动填充,名称匹配类型选默认的「精确名称匹配」,可填图标和描述用于普惠模型列表展示。点击「保存」完成配置。
+
+![添加模型](添加模型.png)
+
+ 3.在创建模型或编辑模型时可以配置标签，一个模型可以设置多个标签，标签可用于普惠模型列表筛选
+
+![配置标签](配置标签.png)
+
+![标签筛选](标签筛选.png)
+
+4. 新增模型支持批量Excel导入。
+
+![1782729154314](image/普惠算力平台-管理员使用手册/1782729154314.png)
+
+![1782729241561](image/普惠算力平台-管理员使用手册/1782729241561.png)
+
+### 4. 调整额度单位(汇率)
+
+使用管理员账号登录后,左侧导航点击「系统设置」,第一个 tab「**运营设置**」下的「通用设置」。
+
+> ⚠️ New API 系统默认所有额度将以美元($)显示,使用过程中可以无视。**但如果需要以人民币显示**,需将汇率设置为 1:1,因为填写模型价格时单位依旧是美元,并不会变为人民币。点击「保存通用设置」生效。
+
+![运营设置](运营设置.png)
+
+---
+
+### 5. 开启充值功能(为了开通兑换码功能)
+
+使用管理员账号登录后,点击「系统设置」的「**支付设置**」tab 选项。填写确认合规声明。
+
+![确认合规声明](确认合规声明.png)
+
+---
+
+### 6. 设置模型价格
+
+使用管理员账号登录后,点击「系统设置」的「**分组与模型定价设置**」tab 选项。
+
+![分组与模型定价设置](分组与模型定价设置.png)
+
+**操作步骤:**
+
+1. 列表中已有默认的模型定价。可点击「手动编辑」,**清空数据**。在最下方点击「保存模型倍率设置」按钮保存。
+
+![手动编辑,清空数据](手动编辑，清空数据.png)
+
+2. 点击「**未设置价格模型**」,可看到还未设置价格的模型列表。
+
+![未设置价格模型](未设置价格模型.png)
+
+3. **按量计费**:设置输入价格、补全价格(输出价格)
+
+![设置模型按量收费](设置模型按量收费.png)
+
+4. **按次计费**:输入固定价格
+
+![设置模型按次收费](设置模型按次收费.png)
+
+5. **阶梯计费**:根据单次使用量分阶段计费，完整的阶梯收费需要点击模型后在右侧边栏查看。
+
+![设置模型阶梯计费](设置模型阶梯计费.png)
+
+![右侧边栏](右侧边栏.png)
+
+6. 点击「应用更改」按钮保存。
+7. 模型定价支持批量Excel定价。
+
+![1782729220843](image/普惠算力平台-管理员使用手册/1782729220843.png)
+
+![1782729241561](image/普惠算力平台-管理员使用手册/1782729241561.png)
+
+---
+
+### 7. 获取管理员系统访问令牌
+
+使用管理员账号登录后,左侧导航点击「个人设置」,页面中点击「**安全设置**」,点击「**生成令牌**」。
+
+![获取管理员系统访问令牌](获取管理员系统访问令牌.png)
+
+在普惠后端项目中配置 New API 的地址、admin-token、admin-user-id(**admin-user-id 为 1**)。
+
+![配置 newapi 信息](配置newapi信息.png)
+
+### 8. 使用日志
+
+1. 左侧导航点击「**使用日志**」。可以看到所有用户的使用、消费、充值、管理等记录，也可以看到用户的操作记录，并且可以基于时间日期等参数进行筛选。
+
+![使用日志](使用日志.png)
+
+### 9. 查看 / 修改用户余额
+
+在 New API 系统,使用管理员账号登录后,左侧导航点击「**用户管理**」,点击某个用户的「编辑」按钮可看见用户账号的金额,并可直接用管理员账号修改账户余额。
+
+![用户管理查看用户余额](用户管理查看用户余额.png)
+
+> ⚠️ **通过管理员增加修改的金额不会展示在普惠面向客户的用户充值列表中。**
+
+
+
+### 10. 充值底层实现—兑换码
+
+充值 New API 余额是通过**兑换码**实现的。使用管理员账号登录后,左侧导航点击「**兑换码管理**」,可看见充值使用过的兑换码。
+
+***必须先开启充值功能。***
+
+![兑换码列表](兑换码列表.png)
+
+## 二、普惠算力主站
+
+### 1. 平台驾驶舱
+
+首页为平台驾驶舱，可以查看平台整体的运营、态势情况。
+
+![驾驶舱](驾驶舱.png)
+
+### 2. 会员充值记录
+
+普惠后台新增「**会员充值记录**」页面。若出现付款成功却充值失败的情况,其充值状态会变为待充值。待充值的数据会出现在待充值列表中，工作人员在手动充值后，在待充值列表的操作栏中输入相应兑换码完成人工充值流程。
+
+![](会员充值记录2.png)
+
+![](待充值列表.png)
+
+![](人工充值.png)
+
+---
+
+## 三、监控平台
+
+两套系统通过Uptime Kuma进行监控，监控项可自行配置
+
+1. **状态正常监控项**: 绿色为正常状态监控项，例如HTTPS普惠算力平台的响应，在线，证书等信息
+   ![Uptime正常监控](Uptime正常监控.png)
+2. **状态异常监控项**: 红色为异常状态监控项目
+   ![异常通知Uptime](异常通知Uptime.png)
+
+3. 可以配置多种异常监控通知渠道，例如钉钉机器人
+   ![异常通知钉钉](异常通知钉钉.png)
+
+## 四、附:其他说明
+
+1. **未配置价格的模型**:若在 New API 中未设置模型价格,模型价格会**默认显示 75 元，未配置模型价格模型无法调用**。
+2. **AI token 页**:原 AI token 页需要在普惠后台管理,**算力资源分类管理禁用**。
+3. **数据看板**:New API 数据看板可以看见所有的统计数据。
+
+![数据看板](数据看板.png)
\ No newline at end of file