From dcc8600664cb1f0ee2009a4e6aff32cfaaf13134 Mon Sep 17 00:00:00 2001 From: zyc123 <2594064239@qq.com> Date: Thu, 14 May 2026 14:39:51 +0800 Subject: [PATCH] 864 --- guide/create-key.md | 60 +++++++-------- support/faq.md | 181 +++++++++++++++++++++----------------------- 2 files changed, 114 insertions(+), 127 deletions(-) diff --git a/guide/create-key.md b/guide/create-key.md index 2fa752f..c226897 100644 --- a/guide/create-key.md +++ b/guide/create-key.md @@ -1,45 +1,39 @@ -# 创建专属 Key +# 创建专属 Key 注册登录后，点击创建专属 Key。 -## 创建步骤 +## 创建步骤 - 1. 登录 OneinAI 平台 - 2. 访问"[令牌管理]()" - 3. 点击"添加令牌"按钮 - 4. 创建需要使用的令牌，不要选择用户分组，请根据[监测站]()的模型状态和令牌说明、倍率综合选择适合您的分组。 - 5. 保存并复制 Key +1. 登录 oneinai 平台 +2. 访问 [令牌管理](https://api.oneinai.com/console/token) +3. 点击「添加令牌」按钮 +4. 创建需要使用的令牌，**不要选择用户分组**。请根据[监测站](https://status.oneinai.com/)的模型状态、令牌说明与倍率综合选择适合你的分组 +5. 保存并复制 Key -💡 小提示 +> 💡 **小提示** +> **模型限制列表**留空即可，无需配置（除非你了解它的作用）。 -**模型限制列表** 留空即可，不需要配置。除非您看懂了它的作用。 +## 安全建议 -## 安全建议 +> 🔐 **安全提醒** +> - **不要**将 Key 分享给他人 +> - **不要**将 Key 提交到代码仓库 +> - **不要**在公开场合展示 Key +> - 询问配置是否正确时，请给 Key 打码 +> - 使用环境变量或配置文件存储 Key +> - 定期更换 Key 提高安全性 -🔐 安全提醒 +## 保存 Key - * **不要** 将 Key 分享给他人 - * **不要** 将 Key 提交到代码仓库 - * **不要** 在公开场合展示 Key - * 询问配置是否正确时，给Key打码 - * 使用环境变量或配置文件存储 Key - * 定期更换 Key 提高安全性 +创建成功后，请立即保存好你的 Key： -## 保存 Key +```bash +# 示例 Key（请替换为你的实际 Key） +sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +``` -创建成功后，请立即保存好您的 Key： +## 下一步 -bash - - - # 示例 Key（请替换为您的实际 Key） - sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx - -1 -2 - -## 下一步 - - * [修改令牌设置]() \- 调整令牌参数 - * [配置环境变量]() \- 在工具中使用 Key - * [充值]() \- 确保账户有足够余额 +- [修改令牌设置](/guide/modify-token) - 调整令牌参数 +- [配置环境变量](/deploy/claude-code#配置环境变量) - 在工具中使用 Key +- [充值](/guide/recharge) - 确保账户有足够余额 diff --git a/support/faq.md b/support/faq.md index 8957acc..09b837a 100644 --- a/support/faq.md +++ b/support/faq.md @@ -1,159 +1,152 @@ -# 常见问题（FAQ） +# 常见问题（FAQ） -## 账号与 Key +## 账号与 Key -### 1\. 可以开发票对吧？ +### 1. 可以开发票吗？ -对。支持普票、专票。累计充值满500元可提交开发票需求。 +可以，支持普票和专票。累计充值满 500 元可提交开票需求。 -### 2\. Key 无效/鉴权失败怎么办？ +### 2. Key 无效 / 鉴权失败怎么办？ - * 检查是否复制了多余空格 - * 检查 Key 是否过期/被禁用 - * 检查请求是否使用了正确的 Header/参数 - * 确认使用了对应工具的专用令牌组 +- 检查是否复制了多余空格 +- 检查 Key 是否过期或被禁用 +- 检查请求是否使用了正确的 Header / 参数 +- 确认使用了对应工具的专用令牌组 -### 3\. 如何查看余额和消费记录？ +### 3. 如何查看余额和消费记录？ -登录控制台即可查看： +登录 [oneinai 控制台](https://api.oneinai.com/console/token) 即可查看： - * 当前余额 - * 充值记录 - * 消费明细 - * 账单详情 +- 当前余额 +- 充值记录 +- 消费明细 +- 账单详情 -## 网站访问 +## 网站访问 -### 网站进入为什么白屏？ +### 网站打开为什么白屏？ -很有可能是你的广告过滤插件导致，请手动将我们的域名添加到白名单。 +很可能是浏览器的广告过滤插件导致，请手动将我们的域名添加到白名单。 常见的广告过滤插件： - * AdBlock - * uBlock Origin - * AdGuard +- AdBlock +- uBlock Origin +- AdGuard 解决方法： - 1. 打开插件设置 - 2. 添加 `api.ikuncode.cc` 到白名单 - 3. 刷新页面 - 4. 尝试浏览器强制刷新（Windows：`Ctrl + Shift + R`，macOS：`Cmd + Shift + R`） +1. 打开插件设置 +2. 将 `api.oneinai.com` 添加到白名单 +3. 刷新页面 +4. 必要时使用浏览器强制刷新（Windows：`Ctrl + Shift + R`，macOS：`Cmd + Shift + R`） -## 环境与安装 +## 环境与安装 -### npm 安装很慢/失败？ +### npm 安装很慢 / 失败？ -可以使用国内镜像： +可以切换为国内镜像： -bash - - - # 设置淘宝镜像 - npm config set registry https://registry.npmmirror.com - - # 验证配置 - npm config get registry +```bash +# 设置淘宝镜像 +npm config set registry https://registry.npmmirror.com -1 -2 -3 -4 -5 +# 验证配置 +npm config get registry +``` -### Node.js 版本过低怎么办？ +### Node.js 版本过低怎么办？ Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 版本。 升级方法： - * Windows: 重新下载安装最新版本 - * macOS: `brew upgrade node` - * Linux: 使用 nvm 或 NodeSource 仓库 +- **Windows**：重新下载安装最新版本 +- **macOS**：`brew upgrade node` +- **Linux**：使用 nvm 或 NodeSource 仓库 -### 环境变量设置后不生效？ +### 环境变量设置后不生效？ - * Windows: 重启终端窗口或重启电脑 - * macOS/Linux: 执行 `source ~/.bashrc` 或 `source ~/.zshrc` +- **Windows**：重启终端窗口或重启电脑 +- **macOS / Linux**：执行 `source ~/.bashrc` 或 `source ~/.zshrc` -## 工具使用 +## 工具使用 -### CC-Switch 无法启动？ +### CC-Switch 无法启动？ - 1. 检查是否有权限问题 - 2. 尝试以管理员身份运行 - 3. 查看是否有杀毒软件拦截 - 4. 重新下载安装最新版本 +1. 检查是否有权限问题 +2. 尝试以管理员身份运行 +3. 查看是否有杀毒软件拦截 +4. 重新下载安装最新版本 -### Claude Code 提示连接失败？ +### Claude Code 提示连接失败？ -检查项： +请按顺序排查： - * 网络连接是否正常 - * API 密钥是否正确 - * 环境变量是否设置正确 - * 余额是否充足 +- 网络连接是否正常 +- API 密钥是否正确 +- 环境变量是否设置正确 +- 余额是否充足 -### CodeX 和 Claude Code 的令牌不通用？ +### CodeX 和 Claude Code 的令牌不通用？ 是的，不同工具需要不同的令牌组： - * Claude Code: 使用 Claude Code 令牌组 - * CodeX: 使用 "codex测试" 令牌组 - * Gemini CLI: 使用 Gemini 令牌组 +- **Claude Code**：使用 Claude Code 令牌组 +- **CodeX**：使用 `codex` 令牌组 +- **Gemini CLI**：使用 Gemini 令牌组 -请在 IkunCode 平台创建对应的专用令牌。 +请在 oneinai 平台创建对应的专用令牌。 -## 计费相关 +## 计费相关 -### 如何计费？ +### 如何计费？ - * 按实际使用量计费 - * 不同模型价格不同 - * 详细计费规则请查看控制台 +- 按实际使用量计费 +- 不同模型价格不同 +- 详细计费规则请查看控制台 -### 余额不足会怎样？ +### 余额不足会怎样？ - * 服务会暂停 - * 请及时充值以继续使用 - * 充值后立即恢复服务 +- 服务会暂停 +- 请及时充值以继续使用 +- 充值后立即恢复服务 -### 支持退款吗？ +### 支持退款吗？ - * 未使用的余额可以申请退款 - * 已使用的部分不支持退款 - * 具体政策请咨询客服 +- 未使用的余额可以申请退款 +- 已使用的部分不支持退款 +- 具体政策请咨询客服 -## 技术问题 +## 技术问题 -### 代码会被保存吗？ +### 代码会被保存吗？ -不会。我们不会存储您的代码内容，仅转发请求和响应。 +不会。我们不会存储你的代码内容，仅转发请求与响应。 -### 是否支持企业使用？ +### 是否支持企业使用？ 支持。企业用户可以： - * 联系客服获取企业方案 - * 支持大额充值和发票 - * 可能享受优惠价格 +- 联系客服获取企业方案 +- 支持大额充值和开票 +- 可能享受优惠价格 -### 如何获得技术支持？ +### 如何获得技术支持？ -请查看[售前售后]()页面获取联系方式。 +请查看[售前售后](/support/after-sales) 页面获取联系方式。 -## 更多问题 +## 更多问题 -### 遇到技术难题？ +### 遇到技术难题？ 如果遇到启动失败、报错、超时等技术问题，请查看： -👉 **[疑难杂症排查指南]()** \- 详细的错误排查和解决方案 +👉 **[疑难杂症排查指南](/support/troubleshooting)** - 详细的错误排查与解决方案 -### 仍未解决？ +### 仍未解决？ -如果上述问题没有解决您的疑问，请： +如果上述内容没有解决你的疑问，请联系我们： - * 加入 Telegram 群组： - * 查看[售前售后]()联系客服 +- 加入 Telegram 群组： +- 查看[售前售后](/support/after-sales) 联系客服