Skip to content

Data and Privacy

Ericwong edited this page Aug 11, 2026 · 1 revision

本地数据与隐私

数据保存在哪里

正式版默认使用:

  • macOS:~/.better-codex/
  • Windows:%USERPROFILE%\.better-codex\

主要内容包括:

内容 默认位置
项目、任务、分配和运行状态 better-codex.db
附件 attachments/
日志 logs/
Runtime 状态与本地令牌 run/
托管 Core 与兼容层 runtime/

源码开发实例默认使用 ~/.better-codex-dev/ 保存自己的运行文件,但默认仍读取正式版数据库 ~/.better-codex/better-codex.db

网络边界

  • Runtime 只监听 127.0.0.1
  • 页面与 Runtime 之间使用本地令牌鉴权。
  • MCP 通过本机 stdio 运行。
  • Better Codex 没有云端任务服务,也不要求 Better Codex 账号。
  • 检查更新和下载安装包时会访问 GitHub Releases。

Codex 与模型提供方本身的网络和数据处理行为不由 Better Codex 控制,应遵循 Codex 的设置和服务条款。

备份

备份前先停止正在进行的任务,再退出 Codex 或运行:

better-codex stop

至少备份 better-codex.db。如果任务使用本地附件,还应同时备份 attachments/。恢复时应确保没有正在运行的 Better Codex Runtime 写入数据库。

Eject、Disable 与 Uninstall

  • better-codex disablebetter-codex eject:关闭页面集成,保留数据库和安装组件。
  • better-codex stop:同时停止 Runtime。
  • better-codex uninstall:完整卸载并删除本地数据。
  • better-codex data delete:只执行数据删除,并要求确认。

需要暂时停用时优先使用 eject 或 disable。只有在确认不再需要任务和附件,或已经完成备份后,才执行 uninstall 或 data delete。

分享诊断信息

数据库、任务描述、会话内容、附件、日志和本地路径都可能包含敏感信息。向 GitHub Issue 或 Discussions 提交材料前,应只保留复现所需的最小片段,并删除:

  • 用户名与邮箱
  • 绝对路径和项目名称
  • 任务与会话正文
  • 本地令牌、API 密钥和环境变量
  • 客户、公司或未公开产品信息

Clone this wiki locally