tako 文档 GitHub

37 · 删除与档案清理(项目连带删会话 / 单场删除 / 子代理保留窗口)

性质:已落地(D1–D4、D-l)。2026-10-20 起草;2026-10-21 补拍 D3(单场删除,仅属主本人)与 D4(子代理逐字档案保留窗口 + 清扫器,与用户「把删除和 sub agent 状态结合在一起做」的决定合并)。D1、D2 随 0fd15c5 入库;D3、D4 于 2026-10-21 在 127.0.0.1:8905 用 curl 验收后随本篇入库。不表示版本号跳了一档。 D-l 的落地(2026-11-10,随 doc/65 记忆改造):pipeline 只物理删除该项目 scope='workspace' 的记忆行,scope='user' 的个人记忆跨项目保留;markdown 模式随项目目录删除 MEMORY.md,用户 USER.md 不动。代码落点 pgstore.go 的删除事务(memory_items 两类分 scope 删、memory_jobs 按项目删)、memory_migrate.go(markdown 的 MEMORY.md 按 workspace 清);存储侧不变量由 delete_cascade_test.go 钉住,活体由 scripts/acceptance/memory_project_delete_live.sh 验收(9/9 通过)。 代码落点:yk-tako-eino/internal/runengine/pgstore.go、product_api.go、session_access.go、store.go、server.go(D3 路由、D4 探针)、worker.go(D4 清扫 ticker)、archive_sweep.go(清扫与探针)、auth.go(114006、114007)、cmd/yktako/main.go(-archive-ttl)。 验收结论(2026-10-21,引擎 127.0.0.1:8905,工作区 tmp/ws-38):D3 打过五条。属主删除游离会话 s_01M5DAHJZB42KR6Q8BX0M8VA8X 回 200 {"code":0,"message":"","data":{"status":"deleted"}},deliverable.md 还在,.tako/ 没了;再删、取详情、POST /api/runs 都是旧体 404 {"error":"session_not_found"};runs、runlog_entries、sessions 行数不变。属主删除挂载会话后,按项目列会话少一场,项目目录里的产出还在。活 run 期间删除回 409 {"code":114007,"message":"这场会话正在运行,等它跑完再删","data":null},跑完再删是 200。成员删别人的私有会话是旧体 404;会话改成 tenant 之后是 403 {"code":111204,"message":"只有本人能修改","data":null};租户 owner 删成员的会话同样 403,行没有软删。D4 的 POST /api/dev/clean-sweep 不带鉴权,成功体是 {"swept":N,"watermark":"..."}。空库第一次探针 swept 为 0,水印停在 1970-01-01T00:00:00Z,没有跳到截止时刻。compact 窗口默认 256000,curl 打不出真压缩,验收时用 SQL 往已结束的 run 插入行:seq=0 的摘要和 compacted=false 留下,清扫器删掉 compacted=true 且 seq<>0 的行。把软删会话的 deleted_at 拨到水印之后、窗口之外,探针清掉该会话全部 run_model_messages,runlog_entries 和会话行还在。两个引擎同时打探针,一个 swept 为 1、一个为 0,cleaner_state 租约仍是一行。-archive-ttl 12h 的启动日志是 archive ttl 12h0m0s:清扫器删掉 13 小时前的压缩行,11 小时前的留下。随后改回默认,日志是 archive ttl 168h0m0s,再探针 swept 为 0,11 小时那行还在。ticker 每分钟写一行 clean-sweep:,swept 为 0 也写。S1 那份 wire 的 SHA-256 仍是 71a4d705d46ef01d212704b8d29f37cc036d06d1982bbd54b403055d79856455。施工收尾时 go test ./internal/runengine 与 go vet 已通过,其后没有再改 Go。 2026-10-22 补记(doc/40 换信封后):上面这段是 2026-10-21 当时的实测字节——其中「旧体 404 {"error":"session_not_found"}」与 clean-sweep 的旧成功体 {"swept":N,"watermark":"…"} 现已换成信封(404 → {"code":112001,"message":"找不到这场会话","data":null};clean-sweep → {"code":0,"message":"","data":{…}}),见 doc/40。本文正文里的期望字节已按新码改。 真源关系:项目目录真源是 doc/35。本篇改写它 A6 拍好的「删除只删空项目」语义(doc/35 第 0 节第 3 条「连带删会话另立拍」即本篇)。 后续修改方案:doc/76(2026-11-13 已落地)已把项目磁盘删除边界改为整个“资源容器”:项目删除连本项目异步工作区与不可变结果一并清掉,容器删除失败回 cleanup=pending 由 project_cleanups 补偿;租户技能/工具、系统技能与用户记忆仍不在删除边界内。 不在本篇:已删会话的恢复入口、runlog_entries 的物理清除(两者同属 purge/restore 独立方案)、前端页面(删除按钮、确认弹窗 2026-10-23 已由 doc/44 落地)、原子写 / 写路径清单 / scratch TTL(清理架构其余姊妹件,见 §9)。

0. 本篇做什么

三件事,一条「保留窗口」主线贯穿:

  1. 项目连带删(D1/D2):DELETE /api/workspaces/:id 从「有会话就 409」改成连带软删挂载会话 + 清目录。
  2. 单场删除(D3):新增 DELETE /api/sessions/:id,仅会话属主本人可删;文件按所有权分层清理(系统档案清、产出留)。
  3. 子代理逐字档案的保留窗口(D4):被 compact 压掉的逐字原文行(run_model_messages.compacted=true,含子代理消息)今天只进不出、永久留库;本篇给它们一个保留窗口,到期由持 PG 租约的清扫器物理删除。窗口同时是删除会话后的档案宽限期——同一个数(D-k)。

1. 背景与动机:两个失败故事

故事一(删除): 用户「Q4 调研」项目下挂 12 场会话(自己 8 场、成员 4 场),按 doc/35 A6 想删项目得先逐场解绑——12 次操作劝退,项目越积越多,删除形同虚设。连带的问题是单场会话也删不掉:DELETE /api/sessions/:id 在 doc/28 权限表里只有一行设计,从没排期,代码里不存在(server.go 全部路由核实过)。

故事二(只进不出的档案): 子代理每次委派跑完,逐字消息留在 run_model_messages——被 compact 压掉的原文行打 compacted=true 标记后永不删除(pgstore.go:85 注释明写「保留作审计,不进模型输入」)。会话长跑几轮,这张表只涨不清;runlog_entries 同样永久增长(server.go:1018 注释明说无上限)。借鉴 Kimi / dsh / opencode 梳理后的结论:tako 缺的是「会话生命周期 + 保留窗口 + 可租约的清扫任务」,三件不补,档案只进不出。

本篇把故事一的生命周期(删项目 / 删会话)和故事二的保留窗口合成一套:删除动作软删留档(可恢复、审计不断),清扫器按窗口做物理清除(空间回收)——两个阶段、同一个窗口数。

2. 名词

3. 现状(代码事实)

DELETE /api/workspaces/:id 今天的完整路径:

  1. handler deleteWorkspace(product_api.go:200-233)调 store,成功后事务提交之后 os.RemoveAll 项目目录(删目录在事务外,避免库回滚了目录已经没了)。
  2. store DeleteWorkspace(pgstore.go:292-320)单事务三步:lockOwnedWorkspace 锁项目行(FOR UPDATE)→ 查 is_default(默认工作区回 ErrWorkspaceDefault → 409 114005)→ SELECT COUNT(*) FROM sessions WHERE workspace_id = ?(只有这一个条件)→ 大于 0 回 ErrWorkspaceNotEmpty(409 114002),等于 0 才 DELETE FROM workspaces。

互斥现状有两层是现成的:删除事务锁 workspaces 行 ↔︎「新会话挂这个项目」的 AcquireRun(lockVisibleWorkspace)锁同一行;one_live_run_per_workspace 部分唯一索引(pgstore.go:428-432)保证同一项目同时最多一场活 run。没有的一层:删除与「已有挂载会话继续发消息」之间——那条路径锁 sessions 行(AcquireRun 的 SELECT ... FOR UPDATE WHERE id = ?),本篇软删会话的 UPDATE sessions WHERE workspace_id = ? 恰好也锁这些行,互斥顺带成立(§5.3)。

档案侧的现状:compact 只打 compacted=true 标记,没有任何代码路径删这些行;全库无外键无级联;runs.finished_at 记 run 终态时刻——这就是 D4 清扫条件的全部输入,不需要新档案表(D-i)。

4. 待拍决策与推荐

# 决策点 推荐 理由
D-a 会话删除语义:软删还是硬删 软删(新增 deleted_at 列) 硬删要顺手清 5 张 session_id 关联表(全库无外键无级联),动作大且掐断审计线;软删 + D4 清扫器分两阶段,兼得可恢复与空间回收
D-b 连带删的范围 见下表 原则是:表行软删保审计、磁盘字节删掉、计费数据不动;记忆按 scope 处理,D-l 在 2026-11-09 定为项目 workspace 行随删、个人 user 行保留
D-c 删除时遇到活 run 拒绝,项目 409 114006、会话 409 114007 删除不可逆,活 run 说明正在用;等跑完再删比自动 stop 安全(不误杀、不收尸)
D-d 成员挂在项目下的会话(A7b) 无差别连带软删 项目 owner 对项目内容有处置权(A7c);软删不是抹除,runlog 仍在库里
D-e 114002 的去向 退役(本篇起 DELETE 项目不再返回它) 新语义下「有会话」不是拒绝理由;想留会话先解绑再删(A5)
D-f 单场删除的门槛(10-21 拍) 仅会话属主本人;tenant owner/admin 不豁免 doc/28 表格「owner/admin」口径作废。会话正文是私人对话;与 A5 同门槛同双轨错误
D-g 删会话时产出怎么办(10-21 拍) 产出保留,只清系统档案 所有权口径:系统档案(.tako/、.media/)随删清;agent 写的产出是用户资产,删对话记录不没收。删项目(D-b)是容器销毁,产出随之清——「只能由用户删或删项目」
D-h 保留窗口多长(10-21 拍) 7 天,启动参数 -archive-ttl(默认 168h) 借鉴口径「保留窗口 = 恢复承诺」:窗口内误删可恢复(行还在),窗口外物理清除。子代理暂不能「接着做」,审计主要靠 runlog 展示帧,窗口偏短;做成参数是上线后不改代码可调
D-i 要不要新增 subagent_runs 档案表(10-21 拍) 不新增 逐字档案已在 run_model_messages(compacted 行),归属由 run_id → runs.finished_at 推导;委派无实例 id(delegationTool 一次性调起)。「新增表按父 run + 子代理 id 存」是 Kimi 独立 wire 文件的解法,tako 没有独立 wire,新表只是同一份数据的第二个真源
D-j 清扫器形态(10-21 拍) 进程内 goroutine + ticker,互斥靠 PG 租约表 + 删除幂等 + 水印推进 借鉴材料明说不能用进程内定时器当互斥;多副本各跑各的 ticker,抢到租约才扫,DELETE 幂等,双跑只重复劳动不出错。闸在库(AGENTS.md 多副本纪律)
D-k 软删会话的档案何时物理清(10-21 拍) 与全局同一个窗口:sessions.deleted_at + 窗口 < now() 才清 「保留窗口 = 恢复承诺,同一个数」的推论:软删不是抹除,宽限期内行还在(未来恢复入口的余地),窗口外连同模型消息行一起清
D-l 记忆线跟不跟着项目一起删(11-07 拍;11-09 按 scope 修订) 项目记忆跟着删,个人记忆保留:pipeline 清 scope='workspace' 的 memory_items 与该项目 memory_jobs;markdown 清项目 MEMORY.md;两种模式都清 dialogue_chunks,都不动用户 USER.md / scope='user' 行 项目是容器,但个人偏好跟人走,不能因来源项目删除而误删;项目常驻规矩与召回事实也不分层残留。租户归档不动记忆行:归档不是销毁

连带删的范围明细(D-b):

对象 处置 说明
workspaces 行 硬删(不变) 项目是真删,doc/35 A6 已拍
挂载的 sessions 行 软删:deleted_at = now() 过滤点见 §6
项目目录 tenants/<tid>/workspaces/<wid>/ RemoveAll(不变) 含 .media/ 附件与全部产出;markdown 模式的项目 MEMORY.md 随目录一起删
各挂载会话目录 tenants/<tid>/sessions/<sid>/ RemoveAll(新增) 挂过又挪走的会话的游离期残留,容器销毁时一并清
runs / run_model_messages / runlog_entries 删除动作不动;物理清除归 D4 审计线;D4 只清 compacted 行与过窗软删会话的模型消息行(§5.5),runlog 本篇永不清
usage / tenant_usage_daily 不动 计费线
memory_items(pipeline,两层) 只删项目行:DELETE FROM memory_items WHERE workspace = ? AND scope = 'workspace' 不分 resident/recall;scope='user' 行跨项目保留
USER.md / scope='user' 行 不动 用户记忆跟人走;来源项目删除不等于个人偏好失效
dialogue_chunks / memory_jobs 删:DELETE … WHERE workspace = ? 派生索引与该项目待办 job 一起走;markdown 没有 memory_jobs
Redis 事件键(runlive/draft) 不动 只在活 run 期存在;活 run 已被 D-c 挡在删除之外
默认工作区 不受影响 游离会话不挂默认工作区;409 114005 逻辑不变

5. 新 DELETE 语义

5.1 项目删除的请求响应

路由、鉴权、成功响应全不变:DELETE /api/workspaces/:id,仅创建者,成功仍是 200 {"code":0,"message":"","data":{"status":"deleted"}}。失败分支变化:

场景 旧语义 新语义
项目下有会话 409 114002 200 deleted,会话连带软删
项目下有活 run (撞项目闸 409 114004,仅新建 run) 409 114006「项目里有正在运行的会话,等它跑完再删」
默认工作区 409 114005 不变
别人的/不存在的项目 404 114001 不变
未登录 401 111102 不变

5.2 项目删除的事务时序(store 层新方法 DeleteWorkspaceCascade)

BEGIN
  1. lockOwnedWorkspace(id, tenantID, userID)     -- FOR UPDATE 锁项目行;没有 → 114001
  2. is_default? → ErrWorkspaceDefault            -- 114005(不变)
  3. SELECT COUNT(*) FROM runs
     WHERE workspace_id = :id AND status='running' AND lease_until > now()
     → > 0 回 ErrWorkspaceBusy(新错误 → 114006)
  4. SELECT id FROM sessions WHERE workspace_id = :id
     → 记下 id 列表(删目录用)
  5. UPDATE sessions SET deleted_at = now()
     WHERE workspace_id = :id                      -- 软删全部挂载会话
  6. pipeline:取得与 writeMemory 相同的 workspace advisory lock
     → 等已在写库的记忆任务收口,删除后旧 job 不得再写
  7. DELETE FROM memory_items
     WHERE workspace = :id AND scope = 'workspace'  -- 两层都删;user 行保留
  8. DELETE FROM dialogue_chunks WHERE workspace = :id
  9. DELETE FROM memory_jobs WHERE workspace = :id  -- markdown 没有此表写入
  10. DELETE FROM workspaces WHERE id = :id
COMMIT

handler:拿到 store 返回的会话 id 列表后(沿用「事务外删目录」的现状结构):先 RemoveAll 项目目录(现状;markdown 的项目 MEMORY.md 随之删除),再对列表逐个 RemoveAll 会话目录。目录删除失败照旧只记日志、不改响应。逐字档案表(runs / run_model_messages / runlog_entries)不动,物理清除由 §5.5 清扫器按窗口做;项目记忆线(步骤 6–9)在这笔事务里就删掉了,个人 user 记忆明确保留,不进清扫器的窗口流程——项目容器销毁与个人偏好跟人走是同一条 scope 规则的两边。

5.3 时序竞争为什么安全

所有并发路径都在抢同两把锁中的一把,且活 run 检查在锁保护之内:

不会出现「会话已删、run 还在跑」或「run 在跑、项目没了」的孤儿态。

5.4 单场删除:DELETE /api/sessions/:id(D3)

端点至今不存在(§1),本篇新增。软删基础设施由 D1 铺好,本端点增量 = 路由 + handler + store 一个方法。

5.5 保留窗口与清扫器(D4)

清理对象(两类,都落在 run_model_messages):

  1. 过窗 run 的逐字档案:compacted=true 的行,条件是所属 run 已终态且过窗: DELETE FROM run_model_messages WHERE compacted=true AND run_id IN (SELECT id FROM runs WHERE finished_at IS NOT NULL AND finished_at < now() - ttl)。seq=0 摘要行与 compacted=false 的行(模型输入)不在这类里——前者是「发生过什么」永不删,后者还在被使用。
  2. 过窗软删会话的全部模型消息:软删会话没有了「继续跑」的可能,它的 compacted=false 行也失去用途(D-k): DELETE FROM run_model_messages WHERE session_id IN (SELECT id FROM sessions WHERE deleted_at IS NOT NULL AND deleted_at < now() - ttl)。

不清理:runlog_entries(页面展示线,本篇永不清)、runs、usage、摘要行。记忆线也不在清扫器的清理范围里——项目删除时只清 scope='workspace' 的记忆与该项目任务,scope='user' 行继续跟人走(D-l,§5.2 步骤 6–9),不进「宽限期 + 窗口」这套流程;清掉的是逐字档案,不是记忆。

单场会话删除(D3)不动记忆:项目记忆跨会话、用户记忆跨项目,删一场会话不等于记忆作废。pipeline 的 memory_items / memory_jobs 与 markdown 文件都不因单场删除而清;只有项目删除才按 D-l 的 scope 规则处理。

2026-10-27 补记(后加的两张会话级表):run_tasks(doc/41)与 run_questions(doc/47)都带 session_id,语义上属于上面第 2 类,但今天不在任何 DELETE 里——run 结束、会话软删、过窗清扫都不动它们(全仓 DELETE FROM 实读,没有一条指向这两张表)。补法是同一拍各加一条按 session_id IN (SELECT id FROM sessions WHERE deleted_at IS NOT NULL AND deleted_at < now() - ttl) 的删除 + 单测;未排期,不在别的方案里顺手改。

清扫器结构:

与删除的联动:软删会话/删项目当时不动表(软删语义);会话的模型消息(含子代理逐字)由清扫器在 deleted_at + ttl 后物理清(D-k)。想更快释放空间,调小 -archive-ttl。

6. 软删对全站查询的影响

软删列一旦存在,所有按 id 或列表查会话的地方都要补 deleted_at IS NULL,否则已删会话照常收发消息。查询点(2026-10-20 实读):

查询点 位置 不加的后果
SessionAccess(按 id 取会话,一切会话读写的总闸) session_access.go:43-57 已删会话的发消息 / 详情 / log / media 全放开——最大洞
AcquireRun 的 SELECT ... FOR UPDATE store.go:146-148 已删会话继续建 run
ListSessions session_access.go:76-97 列表里诈尸
SetSessionVisibility 的 FOR UPDATE session_access.go:106 已删会话还能改可见性
SetSessionWorkspace 的 FOR UPDATE(A5) session_access.go:135 已删会话还能挪挂
Exists pgstore.go:448-454 按调用点逐个核
POST /api/runs/:runId/resume 的鉴权路径 server.go(resume handler) 实现时核:已删会话的 run 不许复活

SessionStatus 的 EXISTS(SELECT 1 FROM sessions WHERE id=?)(pgstore.go:492)不用改——只组装 liveRunId,拦人的是它前面的 SessionAccess。

配套:部分索引 CREATE INDEX ... ON sessions (tenant_id, user_id) WHERE deleted_at IS NULL,对齐项目闸建法;D4 另给 run_model_messages.compacted 加 (compacted, run_id) 索引(或按查询计划定),让清扫批查不为全表扫。

7. 错误码

114 段新增两格,doc/35 §10 的表随施工同步:

code 场景 HTTP 从哪拍开始用
114006 项目下有活 run,拒绝删除项目 409 D1
114007 会话下有活 run,拒绝删除会话 409 D3
111204 删除别人会话(看得见但非属主) 403 D3(复用 A5 的码)
114002 项目里还有会话,不能删 409 本篇起退役,不再返回;码位留着不重用

D4 无用户可见错误码(清扫器是后台任务;dev 探针 dev-only)。

8. 分拍与验收

拍 做什么 怎么验收
D1 §5.2 全链路:sessions.deleted_at 列 + DeleteWorkspaceCascade + deleteWorkspace 换用 + 114006 + 目录连带删 + §6 前三个过滤点 curl 主链路
D2 §6 剩余过滤点(两个 SET、Exists、resume 核)+ sessions 软删部分索引 + 单测 curl 边角 + go test ./internal/runengine
D3 §5.4:DELETE /api/sessions/:id(路由 + handler + store DeleteSession + 114007 + 只清系统档案) curl 主链路
D4 §5.5:-archive-ttl 参数 + cleaner_state 表 + 清扫 goroutine/ticker + 两类清理 SQL + POST /api/dev/clean-sweep 探针 curl 探针 + psql 断言
D-l(11-07 拍,11-09 修订;11-10 落地) §5.2 步骤 6–9:pipeline 清该项目 scope='workspace' 的两层 memory_items、dialogue_chunks 与 memory_jobs,保留 user 行;markdown 由目录删除清 MEMORY.md,保留用户 USER.md curl 删项目 + psql/真实文件断言:项目两类记忆都归零、个人记忆仍在、runs/runlog 不变

D1 验收(用户 A、B,一个 visibility=tenant 共享项目):

# 1. 项目下挂两场会话(A 一场、B 挂上来一场),目录里各写得到文件
# 2. 有会话时删除:
curl -X DELETE -H "Authorization: Bearer $A_TOKEN" 127.0.0.1:8905/api/workspaces/$WS
# → 200 {"code":0,"message":"","data":{"status":"deleted"}}(旧语义是 409)
# 3. 项目没了:
curl -H "Authorization: Bearer $A_TOKEN" '127.0.0.1:8905/api/sessions?workspaceId='$WS
# → 404 {"code":114001,"message":"找不到这个项目","data":null}
# 4. 已删会话按 id 取详情、发消息:
curl -H "Authorization: Bearer $A_TOKEN" 127.0.0.1:8905/api/sessions/$SID_A
# → 404 {"code":112001,"message":"找不到这场会话","data":null}
curl -X POST -H "Authorization: Bearer $B_TOKEN" -d '{"text":"hi","sessionId":"'$SID_B'"}' 127.0.0.1:8905/api/runs
# → 404 {"code":112001,"message":"找不到这场会话","data":null},runs 行数不增
# 5. 目录没了:项目目录、两场会话目录都不在盘上;游离会话目录不受影响
# 6. 审计线在(psql):runs / runlog_entries / sessions 行数与删除前相同
# 7. 活 run 拒绝:挂一场会话、发长消息趁 running DELETE
# → 409 {"code":114006,...};项目行、会话行、目录都还在;run 跑完重发 → 200 deleted

D2 验收:对已删会话两个 PATCH → 均 404;go test + go vet 全绿。

D3 验收(先造文件场景:游离会话里让 agent 写 deliverable.md,再触发一次搜索截断落盘造出 .tako/search/):

# 1. 属主删自己的游离会话:
curl -sS -X DELETE "http://127.0.0.1:8905/api/sessions/$SID_FREE" -H "Authorization: Bearer $AT"
# → 200 {"code":0,"message":"","data":{"status":"deleted"}}
# 分层验证(D-g):会话目录还在;deliverable.md 原样保留;.tako/ 没了;.media/ 不存在算成功
# 再删一次 → 404 {"code":112001,"message":"找不到这场会话","data":null};详情/发消息 → 404
# 2. 属主删自己的挂载会话 → 200;项目下少一场;项目目录产出还在;该会话目录同样只清 .tako/.media
# 3. 活 run:发长消息趁 running 立刻 DELETE
# → 409 {"code":114007,...};行、目录、产出都在;run 跑完重发 → 200 deleted
# 4. 非属主:B DELETE A 的 tenant 可见会话 → 403 {"code":111204,...}
#    A DELETE B 的会话 → 同样 403:tenant owner 不豁免
# 5. 看不见:B DELETE A 的私有会话 → 404 {"code":112001,"message":"找不到这场会话","data":null}
# 6. psql:删除前后 runs / runlog_entries / sessions 行数不变

D4 验收(沿用 D1/D3 的库):

# 0. 前置断言(psql):SELECT COUNT(*) FROM run_model_messages WHERE compacted = true; → 记为 N
# 1. 窗口未到(run 刚终态):POST /api/dev/clean-sweep → 200
#    psql 再数 → 仍 N(没清)
# 2. 把某场 run 的 finished_at 改到 8 天前:
#    UPDATE runs SET finished_at = now() - interval '8 days' WHERE id = 'r_...';
#    再探针 → psql:该 run 的 compacted 行没了;compacted=false 行还在;seq=0 摘要行还在
# 3. 软删会话的模型消息:D3 删一场会话 → UPDATE sessions SET deleted_at = now() - interval '8 days' WHERE id='s_...';
#    探针 → psql:该会话的 run_model_messages 全没(含 compacted=false);runlog_entries 还在
# 4. 租约互斥:起两个引擎进程,同时打探针 → 只有一个真扫(cleaner_state 的 owner/expires_at 只有一份;
#    watermark 只推进一次;总行数断言与单跑一致)
# 5. 参数:-archive-ttl 12h 重启引擎 → 窗口按 12h 生效(finished_at 13 小时前的 run 被清)
# 6. go test + go vet 全绿

D-l 验收(沿用 D1/D3/D4 的库):

# 0. 造数据:同一来源项目各写一条 scope=user 与 scope=workspace 的常驻行、召回行;
#    再落 dialogue_chunks 与 memory_jobs。另开项目验证 user 行仍可见。
# 1. 删项目:
curl -sS -X DELETE "http://127.0.0.1:8905/api/workspaces/$WS" -H "Authorization: Bearer $AT"
# → 200 {"code":0,"message":"","data":{"status":"deleted"}}
# 2. psql 断言($WS 是项目 id):
#    SELECT count(*) FROM memory_items WHERE workspace='$WS' AND scope='workspace'; → 0(不分 layer)
#    SELECT count(*) FROM memory_items WHERE workspace='$WS' AND scope='user';      → 1(个人行保留)
#    SELECT count(*) FROM dialogue_chunks WHERE workspace='$WS';                  → 0
#    SELECT count(*) FROM memory_jobs   WHERE workspace='$WS';                     → 0
#    SELECT count(*) FROM runs          WHERE workspace_id='$WS';                 → 不变(审计线)
#    SELECT count(*) FROM runlog_entries WHERE ...                               → 不变
# 3. markdown 模式另跑:项目 MEMORY.md 随目录消失,用户 USER.md 字节不变。
# 4. go test + go vet 全绿

9. 不在本篇

10. 闭环

所以这解决了什么。 删除从「形同虚设」变成三个阶段各就各位:删除动作软删留档(可恢复、审计不断,D1/D3),文件按所有权分层(系统档案随删清、产出只随删项目清,D-g),档案按保留窗口物理回收(D4:过窗 run 的逐字行 + 过窗软删会话的模型消息,持 PG 租约的清扫器,多副本幂等)。子代理的逐字档案不再只进不出——压缩掉的原文行在窗口到期后真删,摘要行和 runlog 永留,「发生过什么」与「逐字过程」按价值分层保存。同一套软删语义和窗口数(D-k)把删除和清理焊成一个机制,而不是两个独立的垃圾来源。项目记忆跟着容器走,个人记忆跟着人走(D-l,2026-11-10 落地):项目删除时,两层 scope='workspace' 行一起清,scope='user' 行仍能在其他项目出现;Markdown 的项目文件随目录清、用户文件不动。

仍不解决的: 恢复入口、runlog 物理清除、半截文件的自动处理、原子写/写清单/scratch——都在 §9 明说。