合并云端身份与记忆 PR#102（6e9d6dc）到最新 main ea5ab62

docs/identity-memory.md

@@ -0,0 +1,49 @@
+# 系统级身份与记忆（云端层）
+
+本批只做云端层，不动 Codex thread：不改 `host.py`、不改
+`CODEX_HOME`、不改任何 thread 的创建/续跑/fork/归档，
+也不向任何任务或 thread 自动注入记忆。
+
+## 数据
+
+- `user_profiles`：每用户一行，display_name、timezone、
+  preferences（JSON）。偏好里禁止含 password/secret/token/
+  api_key/credential 的键，绝不能拿它当第二个凭证库。
+- `identity_memories`：分级记忆，TEXT 主键（不走 IDENTITY
+  序列，见 `cloud/migrations.py` 对齐说明）。
+  - `user`：只归属用户一人可见，跨项目；不得带 project_id。
+  - `project`：归属用户创建、项目成员可见；读/写权限由
+    server 的项目 `read` / `create_task` 门先卡，store 层
+    不认项目成员关系。
+  - `kind`：fact / preference / decision / convention。
+  - `source_thread_id`：仅作来源标注，不建立 thread 依赖。
+- 旧项目记忆 `summaries` 表不动；`identity-context` 返回的
+  项目摘要上下文是独立字段，不与身份上下文合并。
+
+## 语义
+
+- 修正用 supersede 链：旧行变 `superseded` 并指向新行，
+  旧内容不再进上下文，但可审计；删除是物理删除，仅用于
+  用户主动遗忘。
+- 上下文只取最新 active 各 5 条，不全量倒历史。
+- 他人用户级记忆在 HTTP 层回 404（不是 403），避免用
+  状态码探出记忆存在。
+
+## 接口
+
+- `GET/PUT /users/me/profile`（本人）
+- `GET/POST /users/me/memories`、`POST /users/me/memories/{id}/supersede`、`DELETE /users/me/memories/{id}`（本人）
+- `GET/POST /projects/{id}/identity-memories`、`POST /projects/{id}/identity-memories/{id}/supersede`、`DELETE /projects/{id}/identity-memories/{id}`（项目门）
+- `GET /users/me/identity-context?project_id=...`：显式取用，
+  返回 profile、两级记忆、身份上下文、项目摘要上下文四个
+  独立字段；调用方要把上下文放进新任务时，应自己拼进
+  新建任务的 prompt 并留痕，本接口不代劳。
+
+## 未做
+
+- 未接 worker：任务创建时不会自动拼身份上下文，thread
+  行为与升级前一致；自动注入是下一步的显式决策，需另
+  定注入点（新建 thread 的 developerInstructions 还是首轮
+  prompt）、去重与成本上限。
+- 未做控制台 UI；未做跨引擎记忆（本批记忆与 Codex
+  thread 无关，换引擎时云端记忆仍可用）。