Signalman AI

安全切换 Codex provider，不悄悄覆盖你的工作环境。

Signalman AI 是 Windows 上的本地桌面工具。它适合已经在 Codex 里配置了 MCP、插件、项目和个人工作习惯，却不想再手工编辑配置文件的用户。

它不会把“切换服务商”做成一次看不见的整文件覆盖：先检查目标服务商、让你看清将发生的变更、再由你确认；每次需要写入前都会创建恢复点。无法确认安全时，它会停止，而不是猜测或覆盖。

当前为 alpha。 适合知情的小范围试用；切换完成后，仍应在新的 Codex 会话里确认你的实际工作正常。

下载最新 GitHub 版 · 查看首次使用流程 · 遇到问题先看排错指南

本页截图来自 0.10.0-alpha 的离线示例配置：不包含真实服务商、地址、密钥、本机路径或 Codex 内容，也不会连接任何服务商。

你为什么会需要它

换 provider 本身并不复杂；真正让人不放心的是，某些工具会把旧的 config.toml 或 auth.json 整份覆盖回来，连同自己长期积累的 MCP、插件、项目设置和其他工作环境一起改掉。

Signalman AI 的目标不是替你更快地编辑文件，而是把这件高风险的小事变成一个能检查、能确认、也能安全回退的流程。

你关心的事	Signalman AI 怎么做
先确认能不能用	对当前服务商、模型、地址和访问密钥运行一次最小真实请求。没有通过，就不允许切换，也不会写入 Codex 配置。
只改必要的部分	切换前显示检查结果和变更影响；确认时再次检查配置有没有被其他程序改动。不能安全确认时，直接停止。
出问题能回去	首次启动建立基线恢复点；每天首次打开自动备份，也可以随时手动备份。恢复同样需要确认，不会整份覆盖你的现有工作环境。

第一次使用只要四步

1. 安装并打开。 第一次启动只会创建“首次启动基线备份”，不会切换服务商或改写 Codex 配置。
2. 添加服务商并选择模型。 填写名称、接口地址、模型和访问密钥；资料保存在本机。
3. 运行可用性测试。 它会检查当前服务商是否能完成一次最小真实请求；未通过时不会进入写入路径。
4. 查看检查结果后确认切换。 完成后关闭当前 Codex 会话并重新打开，再确认你的实际工作；需要回退时，到“配置保护”选择恢复点。

测试只验证“当前地址、密钥和模型能完成最小请求”。它不能代替你的长上下文、工具调用、配额或第三方服务稳定性的实际使用确认。

它会改什么，又不会碰什么

内容	行为
Codex 的 provider、模型、接口地址和认证所需字段	只有你确认切换后才会更新；写入前会创建恢复点，并再次确认配置没有漂移。
config.toml 和 auth.json 的无关内容	保留。遇到未知或冲突的 provider 变化，产品会停止自动操作，而不是覆盖。
MCP、插件、项目、桌面设置、记忆、自动化规则和聊天/历史环境	不作为切换或恢复的覆盖目标。恢复只回退 Signalman AI 自己管理的 provider 字段。
API key、配置、恢复副本和活动记录	不上传。切换器保存的敏感资料和恢复副本使用当前 Windows 用户的 DPAPI 保护。
你的最终使用结果	仍需要你在新的 Codex 会话里确认；任何工具都不能替第三方 provider 承诺余额、长期稳定性或所有高级能力。

恢复不是“把一份旧文件整份写回去”。如果 Signalman AI 发现 provider 字段已经被你或其他程序改过、无法证明自动回退安全，就会拒绝自动恢复并保留当前内容，交由你决定下一步。

选择下载方式

你想要什么	选择	更新方式
尽快使用已经公开交付的新功能	GitHub Releases	日常小版本优先在这里发布；应用内可以检查带签名的更新。
更省心、由微软管理更新	Microsoft Store	只发布经过一段时间验证的稳定大版本，可能晚于 GitHub。

两条路径是同一个产品的不同交付节奏。一台电脑请选择其中一个作为日常入口，不要把开发版、维护者候选版、GitHub 安装版和 Store 安装版混在一起使用。

GitHub 最新版

1. 打开最新发布页，确认页面标为 Latest，再下载名称带 setup.exe 的 Windows 安装包和同名 .sha256 文件。
2. 确认下载页属于本仓库、版本号与校验文件一致后再运行安装包。GitHub 通道尚未购买 Windows Authenticode 签名，Windows 可能显示 SmartScreen 提示；企业策略或 Smart App Control 也可能不允许继续。
3. 从开始菜单或桌面图标启动 Signalman AI。完整的安装、更新和卸载说明见安装与更新。

Microsoft Store 稳定版

1. 打开 Microsoft Store 产品页，安装 Signalman AI。
2. 后续稳定更新由 Microsoft Store 检查和交付；Store 版本可能晚于 GitHub，这是刻意保持的双渠道节奏。

正常入口只打开一个应用窗口：不需要浏览器、不需要输入端口，也不应留下 CMD 窗口。源码运行的开发版只用于验收，不应替代已安装版本。

常见问题

测试通过了，为什么还要在新 Codex 会话里确认？

测试用于避免把明显不可用的配置写进去。实际工作还会受到上下文长度、工具调用、服务商策略、网络和额度的影响，因此最终确认必须在新的 Codex 会话完成。

为什么切换或恢复会被停止？

可能是服务商测试没有通过、验证结束后配置被其他程序修改，或恢复时发现 provider 字段存在冲突。停止是保护措施：先查看界面中的原因，修正后重新测试或重新预览；不要手工把旧备份整份覆盖到当前文件。

怎样安全地报告问题？

先阅读排错指南。提交 Issue 时只提供版本、操作步骤、脱敏错误摘要和时间；不要上传密钥、完整配置、profiles、备份、本机路径或私有截图。

继续了解

使用软件： 安装、更新与卸载 · 排错指南 · 隐私政策 · 安全说明

了解产品边界： 产品规格 · 获取帮助 · 变更记录

参与开发与维护： 贡献说明 · 开发与 PR 指南 · 发布与交付手册 · 依赖与安全治理

安全问题请按 SECURITY.md 的私密路径报告。