Merge remote-tracking branch 'origin/dev' into dev

# Conflicts: # docs/使用教程.md
2026-05-05 17:41:11 +08:00
parent 527def5a1d 3ae1fe702f
commit f2f5d27543
12 changed files with 1093 additions and 313 deletions
@@ -0,0 +1,62 @@
+# 第一部分：相关项目地址与部署说明
+
+## 部分信息
+
+- `section_slug`: `project-and-deployment`
+- `适用主题`: `cpa`、`sub2api`、项目地址、部署前提、部署环境
+- `维护方式`: `直接更新本文件`
+
+## 适用场景
+
+- 需要拉取并部署 `cpa` 项目
+- 需要拉取并部署 `sub2api` 项目
+- 需要先确认项目地址和部署前提
+
+## 准备内容
+
+- 可以访问 `GitHub`
+- 一个可用的本地目录或服务器目录
+- 基础的 `git` 使用能力，或者可以手动下载压缩包
+- 如果要部署 `cpa`，部署环境必须可以访问 `OpenAI`
+
+## 操作步骤
+
+### 第一步：确认项目地址
+
+- `cpa` 项目地址：`https://github.com/router-for-me/CLIProxyAPI`
+- `sub2api` 项目地址：`https://github.com/Wei-Shaw/sub2api`
+
+先确认你本次要部署的是哪个项目，再决定后续拉取和配置范围。
+
+### 第二步：拉取项目到本地
+
+可以用 `git clone` 拉取，也可以直接下载压缩包后解压。
+如果你准备后续持续更新，建议优先使用 `git clone`。
+
+### 第三步：确认部署方式
+
+本教程只负责把项目地址和部署前提说明清楚，不在这里展开完整部署命令。
+项目拉取到本地后，可以再让 AI 结合当前环境继续完成部署。
+
+### 第四步：确认 `cpa` 的环境要求
+
+如果你部署的是 `cpa`，部署所在环境必须可以访问 `OpenAI`。
+如果环境本身访问不到 `OpenAI`，后续认证流程可能会异常。
+
+## 常见问题
+
+### 为什么部署前要先分清 `cpa` 和 `sub2api`？
+
+因为两者仓库不同、运行方式不同、后续配置项也不同。
+如果一开始就搞混，后面让 AI 继续部署时很容易走错方向。
+
+### 为什么认证看起来成功了，但没有生成认证文件？
+
+常见原因是 `cpa` 部署环境无法访问 `OpenAI`。
+这种情况下，前面看起来像是执行完成了，但关键结果并没有真正落盘。
+
+## 注意事项
+
+- 先确认本次目标项目，再继续部署
+- 需要长期维护时，尽量用 `git` 拉取，而不是每次手动覆盖
+- 部署 `cpa` 前，先确认环境确实能访问 `OpenAI`