停用与卸载

一键停用回到官方行为;卸载时如何处置已接管的会话。

1. 临时停用

设置页的「全局开关」关掉,或:

coskey disable    # 保留安装,包装器纯透传,等价原生行为(需重启 app 生效)
coskey enable     # 重新启用

排查问题、临时回到官方模型时用这个,配置与密钥都不动。

2. 卸载

应用内提供卸载入口,会移除登录注入(macOS LaunchAgent / Windows 用户环境变量)、包装器与 运行状态;配置与钥匙串默认保留,重装后无需重新录入供应商与 API key。需要彻底清干净时, 勾选连同配置与日志一并删除的选项。

卸载后 ChatGPT.app 重启即恢复官方行为,系统回到原状。

3. 卸载前的会话处置

受 Coskey 接管的会话,其持久化的 provider 是 coskey直接卸载后,这类会话在 ChatGPT.app 里会打不开。卸载流程会问你怎么办:

  • 默认:保留现状——适合日后还会重装 Coskey 的情况(重装后自动恢复接管);
  • 选「恢复接管前 provider」——把受管会话的 provider 写回接管前的原值,会话交还原生打开。

也可以先转交再卸载:在会话页或用 coskey hand-over 批量转交,之后随时卸载。 详见会话、状态与设置

4. 关于 ~/.codex 的写入

~/.codex 目录默认不被 Coskey 写入。仅两处用户显式操作例外,且都先备份、带旧值守卫:

  1. 会话转交(coskey hand-over);
  2. 卸载时选「恢复接管前 provider」。

两者都要求 ChatGPT.app 已退出(会检查线程写锁),写入前后都有汇总报告。