TMCRA
控制台开始使用

Codex 桌面记忆 / 01

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

TMCRA Memory 应用把安装、登录和连接 Codex 放在一个地方完成。你提交问题后、Codex 开始回答前，系统会按这条新问题召回并注入相关记忆；回答结束后，再分别记录你的消息与 Codex 的最终回答，并保留清晰的对话主体和来源。两类记录都可以在后续对话中被召回：用户记录承载要求与事实，Codex 记录承载已经完成的进度与结果；Codex 的回答不会被当成用户本人陈述。新项目会自动建立记忆边界；旧项目也能导入本机仍保留的 Codex 历史，不必从零接手。

获取 1.0.0-rc.1 插件 →下载桌面应用 使用 Codex 手动接入包 打开记忆控制台
Windows 本地安装预览

1.0.0-rc.1 包含 Install-Local.cmd，可直接打开免账户的本地安装流程。首次安装需要下载依赖与模型。硬件要求及待验收项请查看插件中心；下方账户安装流程适用于托管服务。

本地安装与硬件要求 →

02 / 桌面端接入

安装 TMCRA Memory，然后连接 Codex。

下载 Windows 或 macOS 预览版并核对页面公布的 SHA-256，然后在桌面应用内完成账户授权和 Codex 连接。

  1. 01

    安装 TMCRA Memory

    从下载页获取 Windows 或 macOS 预览版，并在安装前核对页面公布的 SHA-256。

    下载桌面应用

  2. 02

    在应用内登录并连接 Codex

    打开 TMCRA Memory，登录你的账户，再选择“连接 Codex”。确认应用中展示的授权信息后完成连接。受 Scope 限制的 Token 会直接写入本机受保护的配置，不需要手动复制。

  3. 03

    重启 Codex，并确认全部九项 Hook

    重启 Codex，并在插件页面确认 TMCRA Memory 已启用。在任一 Codex 任务中输入 /hooks，逐项审核全部九项 TMCRA 生命周期 Hook 后再确认信任。决定权始终在你手里，Hook 授权由你亲自完成。

    /hooks
  4. 04

    预览并导入保留的 Codex 历史

    登录后进入连接中心并扫描本机，选择项目进行只读预览，再勾选会话并单独确认迁移。预览阶段的对话内容保留在本机；推理、工具日志、开发者指令及疑似凭据消息会被排除。

  5. 05

    查看额度与记忆图谱

    你可以在应用或个人控制台中查看 Scope、Session 和记忆图谱，核对服务端返回的用量与剩余额度，也可以单独吊销某一台 Codex，而不影响其他连接。

查看回答前召回了哪些记忆

自动召回在正常使用时不会打断回答。Codex 完成回答后，在任务中输入“查看上一轮回答的召回”，即可查看该次回答前注入的全局记忆、项目记忆及数量。新的查看请求不会覆盖已完成回答的回执；这里也不会重新检索或显示内部标识、检索调试信息。

查看上一轮回答的召回

03 / 高级手动接入

需要命令行或使用 Linux 时，再走手动接入。

如果你希望检查并控制每一步，仍然可以使用 ZIP 接入包。它面向开发者，不再是普通桌面用户的默认流程。

  1. 01

    下载并解压接入包

    把接入包解压到稳定目录，不要把插件长期放在可能被系统清理的临时下载目录中。

    下载 Codex 手动接入包 · SHA-256 校验文件 · 发行清单

  2. 02

    使用 Windows PowerShell 安装

    .\Install-TMCRA.ps1

    脚本会注册 Codex 插件、检查本机配置，并发起 TMCRA 账户授权。

  3. 03

    在 macOS 或 Linux 上安装

    sh ./install.sh

    安装后按提示完成账户授权，再重启 Codex，并逐项审核同样的九项 Hook。

  4. 04

    保留清晰的授权边界

    手动接入同样不需要登录服务器、使用 SSH 或复制 API Key。你需要亲自登录并确认短码，受 Scope 限制的 Token 才会写入本机受保护的配置。

04 / 记忆边界

基础资料可以跨项目，项目内容不能串门。

TMCRA 用一层用户全局记忆保存稳定偏好和基础资料；每个项目使用独立 Scope，每个 Codex 任务则作为该项目下的 Session。这样既能在同一项目内跨会话延续，也不会把十个项目混进一张图。

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

05 / 接管旧项目

把 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

如果旧对话在本机已经不存在，TMCRA 无法凭空恢复。仓库基线会读取部分项目文档和近期 Git 历史，并明确标记为“当前仓库证据”；写入前仍然需要用户确认。

06 / 开始使用

安装桌面应用，或使用 Codex 手动接入。

桌面应用负责账户授权与本机配置；手动接入包继续用于受控安装或脚本化部署。

下载桌面应用 Codex 手动接入 申请试用