Apache | Carbon
1413 字
7 分钟
PCL Intelligence 主页说明书

前言
警告
- 本项目仅供学习交流,请在遵守当地法律法规的情况下使用。中国大陆用户请勿输入政治敏感等违法内容。
- 项目仍在开发中,可能会出现不稳定的现象。
截图:
感谢 @Light-Beacon/HomepageBuilder 的主页构建器,使得大模型输出的 Markdown 得以构建并输出为 XAML 文件。
Waiting for api.github.com...
需求
- 一个 Vercel 账号:用于部署主页后端。
- Google AI Studio API 密钥(香港地区不支持访问 Google AI Studio):用于请求模型。
- 如需请求单个 API Key,Gemini 2.5 Flash 仅可每天调用 250 次;Gemini 2.5 Pro 仅可每天调用 100 次。
- 如需请求多个 API Key 用于后续的 多 API Key 模式,请从https://console.cloud.google.com/projectcreate 创建多个项目,后在 AI Studio 中创建 API Key。遇到问题请自行 Google。
- 一个 GitHub 账号:用于 Fork 项目。
部署
警告
- 目前仅对 Vercel 平台和 Gemini 模型进行适配,如需使用自己的服务器与其他模型,请自行修改对应文件。
- 请务必按照以下指示部署你的 PCL Intelligence 主页,不当的操作可能会导致你的 API Key 被泄露。
- 请关注 Vercel Usage 使用情况(位于 Vercel 主菜单 左侧),需重点关注
Fluid Active CPU
和Edge Requests
使用量。不要用超了。更多 Usage Limit 请查看主菜单横条上的Usage
选项。
注意现在有两个部署方式:
- 如果你需要使用 多 API Key 模式,请看 #多 API Key 模式 。
- (推荐轻度使用)如果你需要使用 单 API Key 模式 (一切请求只通过一个 Key 调用) ,请看 #单 API Key 模式 。
简单点,
如果你是轻度单人使用,推荐使用 #单 API Key 模式。
如果你是重度或多人使用,推荐使用 多 API Key 模式,请看 #多 API Key 模式,但请注意不要用超 Vercel 限制。
这个是前置步骤:
Waiting for api.github.com...
- 来到 GitHub 仓库 @Ad-closeNN/PCL-Intelligence-Homepage 或 点此 Fork 仓库。
多 API Key 模式
- 将 GitHub 仓库的可见性改为 私密:
- 在仓库顶端点击 Settings。
- 滑至底部,点击 Leave fork network 按钮并确认操作。
- 等待10至30秒,使 Fork 后的仓库脱离 Fork 网络。
- 刷新页面,待 Danger Zone 里的 Change visibility 按钮可用后,点击 Change visibility 按钮并确认操作。
- 更改
config/api_key
文件,删掉原有内容,把从 Google AI Studio 申请的 API Key 以 一行一个 Key 的格式填入。 - 使用 Vercel 部署:Create New Project
需要填写相关变量:- 填写获取 API Key 的方法:
- Env Name:
mode
- Env Value:
local
- Env Name:
- 填写请求地址(在 PCL 主页需要通过点击一个按钮来向你所部署的服务器发送一个请求,所以这个
请求地址
需要填写部署好的链接):- Env Name:
link
- Env Value:域名或 IP 地址,必须以 http 开头
提示如果不知道怎么填写
link
,请按照下列指示操作:- 先不填这个变量
link
。但是上面mode
需要填,填完直接部署。 - 部署完成后建议绑定自定义域名。也可以尝试做Vercel 优选(非必须)。
- 来到 Vercel 项目的 Settings,在左侧菜单选择 Environment Variables。
Key
填入link
;Value
填入 部署后的链接(优先选有绑定好的自定义域名)(如https:/url.pcl-community.org
或https://pih.vercel.app
)必须带上协议! 如http://
和https://
。
关于link
能填什么,例如说,我在 Domains 内绑定了几个域名,只有以.vercel.app
结尾的地址是 Vercel 给的,其他剩下的域名是自己的(不包括pclc.cc
),所以变量link
就为除vercel.app
之外的域名,如 pclai.adclosenn.top。如果你不在海外,就不要选带vercel.app
的域名了。- 点击
Save
按钮,保存变量。 - 点击右下角弹出的
Redeploy
按钮,重新部署
- Env Name:
- 填写获取 API Key 的方法:
- 部署完成后,就可以把链接填在 PCL 的自定义主页-联网获取了。不要填我的,要填你部署后用的链接。
单 API Key 模式(推荐轻度使用)
- 使用 Vercel 部署:Create New Project
需要填写相关变量:- 填写 API Key:
- Env Name:
api_key
- Env Value:
你的单个 API Key
- Env Name:
- 填写请求地址(在 PCL 主页需要通过点击一个按钮来向你所部署的服务器发送一个请求,所以这个
请求地址
需要填写部署好的链接):- Env Name:
link
- Env Value:域名或 IP 地址,必须以 http 开头
提示如果不知道怎么填写
link
,请返回查看 #如果不知道怎么填写link
请按照下列指示操作,无需填写mode
! - Env Name:
- 填写 API Key:
- 部署完成后,就可以把链接填在 PCL 的自定义主页-联网获取了。不要填我的,要填你部署后用的链接。
其他
提示如果你把
api_key
和mode
都填了,其使用的顺序为mode
>api_key
(也就是优先使用多个 API Key)。
如果你什么都不填,或者mode
填的不是local
或 以http
开头的链接,会报 500 内部服务器错误。
解答
什么是“多 API Key 模式”?
返回 #需求 | 返回 #部署
Google Gemini API 有速率限制,详情可以查看这张图片,或直接去 官网 查询:
提示Free Tier:免费层级
RPM(Requests Per Minute):每分钟请求数
TPM(Token Per Minute) :每分钟输入数(令牌数)
RPD(Requests Per Day):每日请求数
单 API Key 每天只能用 Gemini 2.5 Flash 250 次。而每个 API Key 是单独计算请求数量的,所以当我们把多个 API Key 一起用的时候就可以请求 250*n
次(取决于模型 RPD 和 Key 数量)。
PCL Intelligence 主页说明书
https://adclosenn.top/posts/pcl-intelligence-homepage/