面向代码与项目
在终端、编辑器或桌面环境中理解项目上下文，协助编写功能、审查改动、修复错误，并运行测试、lint 或构建命令。
SequenceQ Desktop Utility
SeekerX 用户使用手册
让 Codex Desktop 更快接入 SequenceQ，更稳定地完成本地编码任务。
Codex 负责理解代码、修改文件、运行命令和协助排查问题；SeekerX 负责把本机安装、认证配置、 SequenceQ 代理线路、账号数据和工具更新收进一个清晰的桌面入口。
本地运行
官方线路
桌面常驻
01 / 视频教程
SeekerX 完整使用教程
从安装、配置 Codex 到启动本地代理，结合弹窗确认与浮窗操作，了解完整使用流程。
02 / 工具定位
Codex 处理代码工作，SeekerX 处理接入前后的本地环境。
面向安装、配置与连接
帮助普通用户完成 Codex Desktop 安装、本地 .codex 配置、SequenceQ 模型代理、账号状态查看和软件更新。
面向线路与账号数据
提供可切换的模型代理线路和账号数据服务。SeekerX 负责把线路状态、密钥信息和使用记录呈现在本机界面中。
为什么需要 SeekerX
Codex 的价值在于专注处理真实开发任务；SeekerX 把安装包、API Key、认证模式、代理线路、浮窗状态和账号查询这些准备工作集中管理，减少手动编辑配置文件和反复排查连接状态的成本。
03 / 目录与快速开始
先把 Codex 接入 SequenceQ，再把日常代理、账号和更新交给 SeekerX 管理。
首次使用
安装或检测 Codex Desktop，选择认证模式，写入 SequenceQ API Key 和本地配置。
日常使用
启动本地代理、选择 SequenceQ 线路，并在用户信息页面查看账号资料、密钥和使用记录。
问题处理
通过状态卡片、运行日志、线路切换和代理浮窗确认 Codex 当前是否使用了正确连接。
重要提示
首次使用按“安装 Codex → 配置 Codex → 启动代理”完成准备。配置完成不代表代理已运行；出现重启提示时，请先结束当前任务，再通过 SeekerX 确认重启。不要在文档、截图或日志中暴露 API Key、密码和完整密钥。
04 / Codex 使用衔接
SeekerX 完成连接准备后，继续在 Codex 里控制代码任务、权限和项目上下文。
从项目目录开始
配置完成并重启 Codex 后，在真实项目目录中开启新会话，让 Codex 读取当前仓库文件、运行本地工具，并围绕具体任务修改代码。
保留 Codex 权限控制
SeekerX 只负责安装、认证和代理连接；Codex 的模型选择、推理强度、命令权限、沙箱和审批策略仍在 Codex 侧管理。
用新会话验证配置
配置修改后，按 SeekerX 的提示重启 Codex，再创建新会话验证连接。主线路与香港线路之间切换直接对后续请求生效，无需为此重启 Codex。
05 / 界面概览
新版侧栏收束为三个主入口，安装、配置和代理统一放进 Codex 工作台。
Codex 工作台
按当前电脑状态展示“安装 Codex”“配置 Codex”或“本地代理”，右上角下拉菜单可在可用阶段之间切换。
用户信息
登录 SequenceQ 账号，查看资料、余额、额度、API 密钥列表和使用记录。
设置
查看下载源和代理端口，调整背景、代理浮窗、运行日志并检查更新。
06 / 产品界面
Codex 工作台包含安装、配置和本地代理三个阶段，每个页面都可以单独查看。
Codex 工作台
其他界面
07 / Codex 工作台
SeekerX 按检测结果分阶段展示安装、配置和本地代理，不再把所有操作挤在同一页。
未检测到 Codex 时显示“安装 Codex”；安装完成后进入“配置 Codex”；配置符合要求后进入“本地代理”，由你选择线路并手动启动。 工作台右上角的阶段菜单会标出当前页面，尚未满足条件的阶段保持不可用。
点开“查看安装帮助”后
页面会进入“Codex 手动下载安装指南”，按当前系统展示对应安装方式。
这个入口不是主流程的第一步，而是自动下载长时间没有进度、安装器启动失败、商店无法下载时使用。 安装完成后返回 Codex 工作台，重新检测安装状态；检测成功后工作台会进入“配置 Codex”。
- Windows 用户帮助页会优先提供“打开 Microsoft Store”，并说明商店里的官方应用可能显示为 ChatGPT；如果商店不可用，再使用“打开夸克备用下载”。
- macOS 用户帮助页会提供“打开官方 DMG 下载”，下载 Codex.dmg 后拖入“应用程序”，首次打开完成系统安全确认。
- 回到工作台手动安装只负责把 Codex 装到系统中；API Key、认证模式和
.codex文件仍需在“配置 Codex”阶段完成。
- 检测安装状态进入 Codex 工作台后，SeekerX 会先检测当前系统、Codex 是否已安装以及配置是否符合要求。
- 安装 Codex未检测到 Codex 时点击“安装 Codex”，按系统提示完成安装。此阶段不需要 API Key，也不会修改 Codex 配置；已安装桌面版则跳过安装。仅安装 Codex CLI 不等于已安装桌面版。
- 必要时手动安装自动下载长时间没有进度或失败时，点击“查看安装帮助”，按 Windows Microsoft Store、夸克备用下载或 macOS 官方 DMG 完成安装。
- 进入配置阶段安装完成并重新检测成功后，工作台会切换为“配置 Codex”，此时再填写 SequenceQ API Key。
- 选择配置方式选择“免登录配置”或“保留 Codex 登录”，然后点击“配置 Codex”；在点击前不会写入本地文件。
- 确认配置写入遇到已有配置不一致时，核对弹窗后点击“确认并更新配置”；选择“暂不更新”不会修改文件。SeekerX 保留无关字段，配置文件无法解析时会停止写入并提示错误。
- 处理重启提示配置有修改时按页面提示选择是否重启 Codex。重启会中断正在执行的任务；选择“暂不重启”后，当前 Codex 进程仍使用旧配置，新配置在下次启动时生效。
- 手动启动代理配置确认后进入“本地代理”，不会自动启动代理。选择主线路或香港线路，点击中央“启动代理”按钮，确认状态已运行，再开始使用 Codex。
配置完成与代理运行是两回事
Windows 和 macOS 都会将 Codex 请求指向 http://localhost:15721。只有 SeekerX 本地代理正在运行，Codex 才能通过它访问 SequenceQ。日常再次打开 SeekerX 时，已完成的安装和配置无需重复执行，直接在工作台启动代理即可。
“前往 SequenceQ”用于获取或创建 API Key。
如果还没有 SequenceQ API Key，点击输入框右侧的“前往 SequenceQ”会打开 SequenceQ 平台。登录后在平台创建或复制 API Key，再回到 SeekerX 粘贴到输入框中。
- 已有 Key：直接粘贴后继续选择配置模式。
- 没有 Key：先前往 SequenceQ 登录或注册，再创建密钥。
- 回到 SeekerX 后，点击“配置 Codex”才会检查并写入本地配置。
免登录配置
推荐希望直接使用 SequenceQ API Key 的用户选择。SeekerX 将 Key 写入 auth.json，并更新本地代理配置。Windows 只管理其中的 API Key 字段；macOS 还设置 API Key 认证方式，其他字段保留。
保留 Codex 登录
适合需要保留 Codex Desktop 账号登录能力的用户，同样需要填写 SequenceQ API Key。Key 保存在 config.toml 的认证字段中，不新建 auth.json；切换模式时仅清理免登录相关字段，保留其他登录内容。
更换 Key、切换认证方式或更新配置规则
通过工作台右上角菜单回到“配置 Codex”，填写新 Key 或选择新的配置方式，再点击“配置 Codex”。两种方式都用于接入 SequenceQ，与“用户信息”页面的账号登录是独立操作。
点击“检查配置规则更新”可检查适配规则；检查本身不会改写 Codex 配置。出现规则更新提示时，可选择按新规则重新配置，也可稍后处理。执行配置会按当前系统与所选方式使用本机有效规则，完成后按提示处理重启，再进入本地代理。
Windows
SeekerX 会优先通过 Microsoft Store 安装 OpenAI 官方桌面应用；商店中应用名称可能显示为 ChatGPT，发布者应为 OpenAI，Codex 能力包含在该应用中。
如果 Microsoft Store 下载缓慢或失败，可以进入安装帮助，使用夸克备用下载获取完整 MSIX 安装文件。安装完成后回到 Codex 工作台重新检测，再进入配置阶段。
配置写入完成后，请完全退出并重新启动 Codex Desktop，新开的会话才会读取更新后的 auth.json 和 config.toml。
macOS
SeekerX 会使用 macOS 对应的官方 DMG 下载和系统安装流程。自动下载不可用时，可在手动安装帮助中打开 OpenAI 官方 Codex.dmg 下载地址。
安装时双击 DMG，将 Codex 拖入“应用程序”，首次启动通过系统安全确认后，再回到 Codex 工作台重新检测并进入配置阶段。
macOS 使用顶层 OpenAI 配置，Windows 使用模型提供方配置表，SeekerX 会自动按系统处理，无需照搬另一系统的配置文件。两者最终都连接本机代理；配置有修改时，按提示通过 SeekerX 重启 Codex。
Windows 首选：Microsoft Store
这是 Windows 手动安装的首选方式。点击帮助页里的“打开 Microsoft Store”后，系统会直接打开商店应用。
- 确认商店页面中的应用名称为 ChatGPT、发布者为 OpenAI。
- 点击“获取”或“安装”，等待 Microsoft Store 完成下载和安装。
- 安装完成后回到 Codex 工作台，重新检测并进入“配置 Codex”。
Windows 备用：夸克下载
仅在 Microsoft Store 下载长时间没有进度或无法使用时选择。帮助页会读取备用下载信息，并在可用时显示提取码。
- 点击“打开夸克备用下载”，按页面提示登录或注册夸克账号。
- 下载完整的
ChatGPT-x64.msix安装文件。 - 双击 MSIX，按 Windows 应用安装程序提示完成安装。
- 回到 Codex 工作台，重新检测并进入“配置 Codex”。
macOS：官方 DMG
macOS 帮助页会提供“打开官方 DMG 下载”。这是 macOS 下的手动安装入口。
- 点击“打开官方 DMG 下载”，等待
Codex.dmg完整下载。 - 双击 DMG，在安装窗口中将 Codex 拖入“应用程序”。
- 首次打开 Codex 时，按 macOS 系统提示确认打开 OpenAI 官方应用。
- 回到 Codex 工作台，重新检测后点击“配置 Codex”。
08 / 使用本地代理
本地代理负责承接 Codex 到 SequenceQ 的请求链路。
本地代理现在是 Codex 工作台的第三个阶段。配置完成后会自动进入，也可以从工作台右上角菜单打开。
启动代理
- 在工作台阶段菜单中选择“本地代理”。
- 选择“SequenceQ 主线路”或“SequenceQ 香港线路”。
- 点击圆形启动按钮，等待状态从“已停止”变为“已运行”。
- 代理启动成功后，SeekerX 会检查 Codex：未运行时自动启动；已运行且需要加载新配置时询问是否重启，按提示确认即可。
- 确认代理已运行、Codex 已打开，再创建新会话发起请求。若自动启动 Codex 失败，代理会继续运行，可点击“启动 Codex”重试。
切换、停止与故障转移
代理运行期间可以切换主线路与香港线路，后续请求使用新线路，无需重启 Codex。线路连续出现连接故障时会自动尝试容错切换；当前失败请求不会自动重复提交，请确认任务状态后再重试。
点击“停止代理”会关闭本地代理，但保留 Codex 的本地代理地址，不恢复公网连接。停止代理或完全退出 SeekerX 后，Codex 无法通过它访问 SequenceQ；需要继续使用时，重新打开 SeekerX 并启动代理。
关闭主窗口可通过浮窗或系统托盘保持 SeekerX 运行，与完全退出应用不同。使用 VPN 或系统代理时，若提示重启，请通过 SeekerX 执行，让 Codex 加载本地直连设置。
09 / 用户信息与使用记录
用户信息页可以登录 SequenceQ，集中查看账号基础信息、密钥和使用记录。
未登录时显示登录表单。输入 SequenceQ 用户名或邮箱和密码后，SeekerX 会连接账号数据服务； 登录成功即可查看用户资料、余额、额度、权限和统计概览。
登录与账号详情
输入用户名或邮箱和密码，点击“登录”。需要核对密码时可点“显示”；共享设备上建议不要勾选“保存用户数据”。
基础信息
登录成功后可查看 SequenceQ 账号资料、余额、额度、权限和统计概览，便于判断当前账号是否可继续使用。
密钥列表
查看当前账号 API 密钥，列表默认以遮罩形式展示。复制完整密钥前需要再次确认，使用后请清理剪贴板。
使用记录
按“今天”“最近 7 天”“最近 30 天”或“最近有数据的一天”查询，也可手动设置时间范围和每页条数。
10 / 设置、浮窗与更新
设置页面集中管理下载来源、运行参数和显示选项。
这里可以查看 Windows/macOS 下载源、本地代理端口，调整界面背景，开启或关闭代理浮窗，控制运行日志，手动检查 SeekerX 更新，并查看工具能力说明。
界面背景
提供经典白、经典黑、雾灰、暖白和清冷五种方案。点击任意背景按钮后会立即应用，并在下次启动 SeekerX 时保留上次选择。
安装帮助
设置页会展示当前系统的 Codex 下载源：Windows 显示 Microsoft Store / 官方安装器，macOS 显示 OpenAI 官方 DMG；点击“查看说明”可进入对应系统的手动安装帮助。
代理浮窗
开启后，关闭 SeekerX 主窗口时会显示代理状态浮窗；关闭后，再关闭主窗口时 SeekerX 只保留在系统托盘，不显示浮窗。浮窗不会在开启开关后立即弹出，只有关闭主窗口时会显示。
软件更新
SeekerX 启动后会自动检查更新，也可以在设置页点击“检查更新”。下载中断时支持继续下载；安装前会校验安装包完整性和升级签名。
关于工具
设置页底部会展示当前版本和能力概览，包括安装配置、模型接入、本地代理和账号数据，便于确认当前工具覆盖哪些操作。
11 / 代理浮窗形态
完整面板、状态条和状态点可以相互切换，适配不同桌面占用需求。
浮窗注意事项
浮窗和工作台控制的是同一个本地代理；关闭浮窗不会停止代理。启动后出现重启提示时，通过 SeekerX 确认重启 Codex；切换主线路或香港线路无需重启。停止代理后 Codex 暂时无法访问 SequenceQ，再次启动代理即可恢复连接。
12 / 推荐操作顺序
首次完成安装和配置，日常确认代理运行后即可开始使用。
- 安装 Codex在 Codex 工作台完成自动安装；失败时打开对应系统的安装帮助。
- 配置 Codex输入 API Key，选择配置方式并点击“配置 Codex”。
- 处理配置确认有配置差异时确认更新；出现重启提示时先结束当前任务，再选择是否立即重启。
- 启动代理选择线路并启动，状态显示“运行中”。
- 确认 Codex 已启动SeekerX 会自动启动尚未运行的 Codex；失败时点击“启动 Codex”重试，出现重启提示时再确认处理。
- 进入项目目录在 Codex 中打开真实代码仓库，让它读取项目文件、说明和可用命令。
- 按需使用查看账号数据，开启浮窗、运行日志或检查更新。
13 / 常见问题与排查
遇到异常时，先确认安装状态、代理端口、线路和 Codex 重启。
安装器已启动但仍在等待
完成系统安装后点击“重新检测安装状态”。
Codex 没有使用新代理
确认状态为“运行中”，退出并重新启动 Codex。
代理启动失败
确认端口 15721 未被占用，检查网络或切换线路。
配置完成后为什么还不能用
配置完成不会自动启动代理。进入“本地代理”，选择线路并点击“启动代理”，确认已运行。
停止代理后 Codex 请求失败
Codex 仍指向本机代理地址。重新打开 SeekerX 并启动代理，无需重复安装和配置。
配置文件无法解析
SeekerX 会停止写入。根据错误提示修复文件格式，再执行“配置 Codex”，不要反复确认覆盖。
账号页面未连接
确认账号服务地址和网络连接，重新进入用户信息。
使用记录为空
扩大时间范围，或使用“最近有数据的一天”。
更新失败
检查网络后再次检查更新；当前版本和用户配置会保留。
SeekerX 会改变 Codex 权限吗
不会。SeekerX 只处理安装、认证和代理连接；Codex 的权限、沙箱和审批策略仍在 Codex 中控制。
为什么要新建 Codex 会话
配置文件、认证模式或代理线路改变后，新会话最容易确认 Codex 已读取最新状态。
14 / 获取支持与下载
反馈问题时，请提供版本号、系统、页面、操作步骤和错误文字。
截图或日志中请遮挡 API Key、密码、完整密钥、用户名和请求 ID。关闭主窗口不一定会退出 SeekerX；需要完全退出时，请使用系统托盘中的退出入口。