TMCRA

Codex

让 Codex 带着项目记忆,接着做。

在 TMCRA Memory 桌面应用里,一处完成 Codex 的安装、登录和连接。Codex 回答前自动找回相关记忆;回答后,你的消息和 Codex 的回答会分别保存。已有的项目还能导入本机保留的 Codex 历史,不必从零开始。

安装步骤

安装 TMCRA Memory,然后连接 Codex。

下载 Windows 或 macOS 版本并核对 SHA-256,然后在应用内登录并连接 Codex。

  1. 安装 TMCRA Memory

    下载 Windows 或 macOS 预览版,安装前核对 SHA-256。

    下载桌面应用

  2. 登录并连接 Codex

    打开 TMCRA Memory 并登录,选择“连接 Codex”,核对授权信息后确认即可。访问令牌会安全地保存在本机,不需要手动复制。

  3. 重启 Codex 并确认 Hook

    重启 Codex,在插件页面确认 TMCRA Memory 已启用。在任一任务中输入 /hooks,逐项查看 TMCRA 的九个生命周期 Hook 后确认。是否授权,始终由你决定。

    Codex
    /hooks
  4. 导入已有的 Codex 历史

    在连接中心扫描本机,选择项目预览,勾选需要的对话后确认导入。预览内容只保留在本机;推理过程、工具日志、开发者指令和疑似凭据的内容都会被排除。

  5. 查看记忆与用量

    在应用或网页控制台中,按项目和对话浏览记忆、查看记忆图谱、核对用量与额度,也可以单独断开某一台 Codex,不影响其他连接。

手动安装

习惯命令行或使用 Linux?手动安装。

ZIP 安装包适合希望掌控每一步的开发者;大多数用户直接使用桌面应用即可。

  1. 下载并解压

    解压到一个固定目录,不要放在可能被系统自动清理的临时下载目录里。

  2. 在 Windows 上安装

    脚本会注册 Codex 插件、检查本机环境,并发起 TMCRA 账户授权。

    PowerShell
    .\Install-TMCRA.ps1
  3. 在 macOS 或 Linux 上安装

    按提示完成账户授权,然后重启 Codex,并确认同样的九个 Hook。

    Shell
    sh ./install.sh
  4. 无需复制任何密钥

    全程不需要复制 API Key。你只需登录并确认授权码,权限受限的访问令牌就会安全地保存在本机。

记忆边界

个人信息跨项目通用,项目内容互不串用。

稳定的偏好和个人信息保存在一份个人通用记忆中;每个项目都有独立的 Scope,每个 Codex 任务是所在项目下的一个 Session。这样既能跨对话延续,又不会让不同项目混在一起。

两类记录之后都能被找回:用户记录承载要求与事实,Codex 记录承载已经完成的进度与结果;Codex 的回答不会被当成你说的话。

memory.boundaries
user
├── global
└── project_scope
    ├── session_a
    ├── session_b
    └── session_c

已有项目

导入已有的 Codex 历史。

导入不会自动进行:先预览,再选择项目并确认。只导入你和助手的对话内容,推理过程、开发者指令、工具日志和疑似凭据的内容都会被排除。

仅预览,不上传
node .\plugins\tmcra-memory\scripts\history_import.mjs preview
导入指定项目
node .\plugins\tmcra-memory\scripts\history_import.mjs import --project "D:\work\my-project" --confirm --wait
预览当前仓库快照
node .\plugins\tmcra-memory\scripts\project_bootstrap.mjs preview --project "D:\work\my-project"
导入仓库快照
node .\plugins\tmcra-memory\scripts\project_bootstrap.mjs import --project "D:\work\my-project" --confirm

如果旧对话已经不在本机,就无法恢复。这时可以用仓库快照:读取项目的主要文档和近期 Git 历史,标记为“仓库依据”,导入前同样需要你确认。

开始使用

下载桌面应用,连接 Codex。

桌面应用会帮你完成登录和配置;需要脚本化部署时,也可以使用 ZIP 安装包。