SeekerX工具使用说明

SeekerX 是 SequenceQ 面向 Windows 和 macOS 用户提供的 Codex 桌面辅助工具，用于集中完成 Codex 安装检测、认证配置、本地代理、账号信息查看、代理浮窗和软件更新等操作。

查看 SeekerX 完整用户手册

完整手册包含各功能页面截图、Windows 与 macOS 安装步骤、代理说明和详细故障排查。

安装指南

• Windows安装SeekerX
• macOS安装SeekerX

Windows 当前提供 0.1.5 x64 NSIS 安装包；macOS 正式 DMG 尚待完成签名、公证和 Gatekeeper 验收。请先阅读对应系统的安装说明。

推荐给谁

SeekerX 更适合不熟悉终端、命令行或配置文件的用户。它把 Codex Desktop 的安装检测、SequenceQ API Key 配置、本地代理和重启操作集中到图形界面中，减少手动编辑 auth.json 和 config.toml 的步骤。

如果你熟悉终端并需要精确控制配置，可以参考 SeqeuenceQ 的技术用户手动配置；其他用户建议直接按本手册完成 SeekerX 配置。

一、SeekerX 能做什么

SeekerX 主要处理 Codex 使用前后的本地环境准备工作：

• 检查电脑是否已安装 Codex Desktop。
• 协助安装并配置 Codex。
• 将 SequenceQ API Key 写入 Codex 所需的本地配置。
• 启动或停止本地代理，并查看当前连接状态。
• 登录 SequenceQ 账号后查看账户信息和使用数据。
• 通过浮窗持续查看代理状态。
• 检查并安装 SeekerX 更新。

SeekerX 不负责修改 Codex 的模型推理方式、命令权限、沙箱或审批策略，这些设置仍由 Codex 管理。

二、使用前准备

开始前请准备：

1. 一台 Windows 或 macOS 电脑。
2. 可正常使用的 SequenceQ 账号。
3. 已创建的 SequenceQ API Key。
4. 稳定的网络连接。

如果还没有 API Key，请先阅读 SeqeuenceQ的使用说明，完成注册、充值、选择分组和创建 API 密钥。

三、首次使用流程

1. 下载并安装 SeekerX

根据当前系统阅读 Windows安装 或 macOS安装，完成 SeekerX 安装后再启动应用。

2. 打开“安装配置”

首次启动后进入“安装配置”页面。SeekerX 会检查当前系统以及 Codex Desktop 的安装状态。

如果尚未安装 Codex，按照页面提示自动安装或打开手动安装帮助。安装完成后返回 SeekerX，再次执行“一键安装并配置”。

3. 选择认证方式

根据实际使用方式选择配置：

• 使用 SequenceQ API Key：填写平台生成的 API Key，由 SeekerX 写入 Codex 本地配置。
• 保留 Codex 登录：保留现有 Codex Desktop 登录状态，只更新需要的连接配置。

如果电脑中已经存在 Codex 配置，遇到配置不一致提示时，请先确认当前配置是否需要保留，再继续操作。

4. 执行配置并重启 Codex

点击“一键安装并配置”，等待检测和配置完成。完成后按照提示重启 Codex，确保新配置应用到新的 Codex 会话。

5. 发送测试请求

打开 Codex，新建会话并发送一个简单请求，例如：

请查看当前目录结构，不要修改任何文件。

能够正常返回结果，说明安装、认证和连接已经生效。

四、主要功能

1. 安装配置

用于检测 Codex Desktop、选择认证方式、填写 SequenceQ API Key、写入配置以及重启 Codex。首次使用或更换连接配置时从这里开始。

2. 本地代理

用于启动和停止本地代理、选择可用线路并查看当前连接状态。切换线路后，后续新请求会使用新线路；已经失败的请求不会自动重新提交。

停止代理时，SeekerX 会恢复相关 Codex 配置。恢复后应重新启动 Codex，再创建新会话进行验证。

3. 用户信息

使用 SequenceQ 用户名或邮箱和密码登录后，可以查看账号信息及平台提供的使用数据。退出登录只会清除 SeekerX 中的账号会话，不会删除 SequenceQ 账号。

4. 设置与代理浮窗

设置页面可以调整下载源、本地代理端口、界面背景、日志、代理浮窗和软件更新。

开启代理浮窗后，关闭 SeekerX 主窗口时会显示代理状态浮窗；关闭浮窗功能后，主程序可以继续保留在系统托盘。需要完全退出时，请使用系统托盘中的退出入口。

五、日常使用建议

1. 启动 SeekerX，确认代理和账号状态。
2. 打开 Codex 并新建会话。
3. 需要更换线路时，在 SeekerX 中完成切换后再发送新请求。
4. 修改认证或代理配置后，重启 Codex 并使用新会话验证。
5. 定期在设置页面检查 SeekerX 更新。

六、常见问题

Codex 没有检测到

先确认 Codex Desktop 已完成系统安装。安装器启动并不代表安装已经结束，完成安装后需要返回 SeekerX，再次点击“一键安装并配置”。

配置完成后没有生效

完全退出 Codex 后重新打开，并新建会话测试。不要只关闭当前对话窗口。

API Key 无法使用

检查 API Key 是否复制完整、是否已停用、是否选择了正确分组，以及 SequenceQ 账户是否有可用余额或额度。

切换线路后请求仍然失败

切换线路只影响后续请求，不会自动重试已经失败的请求。请在 Codex 中重新发送请求，必要时重启 Codex 并创建新会话。

关闭窗口后 SeekerX 仍在运行

主窗口关闭后，SeekerX 可能继续在系统托盘中运行。需要完全退出时，请打开系统托盘菜单并选择退出。

七、完整说明

安装截图、各功能页面说明、Windows 与 macOS 的详细操作以及更多故障排查，请访问：

SeekerX 用户使用手册