Activity：本地 Agent 记忆活动

Activity 是 macOS App 中的本地记忆活动视图。它把 DSH 与 Codex Desktop/App 的会话日志投影成同一套小模型：

Agent 活动 → 用户请求 → Memory 检索 → 实际交付给 Agent 的 Memory 片段

它不是通用聊天记录，也不是完整 transcript 归档器。Assistant 回复、与 Clumsies 无关的工具调用、其他 MCP Server 的调用，以及 ChatGPT conversations.json 导出都不在范围内。

当前契约

会话阅读围绕三类信息展开：

1. 某个已绑定工作区中的用户请求是什么；
2. Agent 当时传给 memory.activate 的原始查询是什么；
3. 那次检索最终向 Agent 交付了哪些 Memory 片段。

界面按最新会话优先排列，使用三栏布局：

区域	内容
全局侧栏	选中 Activity 工作区。
会话列表	已绑定工作区中的 Agent 活动；每行显示 DSH 或 Codex host、标题和时间。
详情	用户请求、原始 Memory 查询、检索状态与耗时，以及直接内联渲染为 Markdown 的完整历史片段。

会话身份是 (host, session_id)，因为 session id 只要求在各自 host 内唯一。项目筛选会包含该 Project 绑定的全部工作区。

有 run 身份的每次 Memory 检索提供 Retrieval Process 入口。点击后，工作区临时收起会话列表，保留全局侧栏，用完整宽度展示该次检索摘要与候选表；返回时恢复原会话和检索位置。一个用户请求可以包含多次检索，入口始终指向当前这一次。详情复用 Report Inaccurate 和 Review Evidence，可以为该 run 建立评估案例并核对证据。共享的 Diagnostics 视图也支持跨会话的 Retrieval Runs 列表。

用户请求与 Memory 查询不是同一份数据

• 用户请求来自 Agent harness 记录的人类消息。
• Memory 查询是 Agent 原样提交给 memory.activate 的 query。daemon 只做首尾空白处理，不执行 LLM 改写、意图提取、对话扩展或隐藏 filter 推断。

查询依次参与精确 id/path/title 匹配、BM25 全文检索、语义向量检索、reciprocal-rank fusion 与 cross-encoder rerank。最终装配会去除重叠片段，并应用相关性、单资源数量、总片段数和 token budget 限制。

Activity 的会话页展示最终向 Agent 提供的片段。候选分数、排序中间量和被排除的候选放在按需打开的 Retrieval Process 详情里，让会话阅读仍围绕用户请求与检索结果展开。

add、replace 与 reuse

这些值描述上下文增量，不是 Memory 写操作：

值	含义
add	上次 activation state 中没有该片段，本次将它发送给 Agent。
replace	Agent 已持有同一片段的旧版本，本次用新版本替换。
reuse	片段未变化且已在 Agent 上下文中，本次响应可以省略正文。

UI 使用面向用户的交付标签，不会把 add 表述成创建或修改已存储的 Memory。

本地数据源

Activity 由本机 daemon 直接读取本地日志和本地 retrieval history。当前 App 只传 Project filter（或不传 filter），这两条 UI 路径都从 daemon 的 workspace binding 表取根目录，因此正常界面只列出已绑定工作区。

显式 workspace_root 过滤同样必须匹配绑定表；同时传入 Project filter 时还会校验项目归属。未匹配时返回空列表。

DSH

DSH 会话位于：

~/.dsh/sessions/<encoded-workspace>/<session>/session.jsonl.zstd

session.jsonl.zstd 是 append-only 的多 frame zstd 文件：DSH 每追加一条 JSONL 记录就写入一个独立 frame。读取器必须消费所有完整 frame；只解第一个 frame 通常只会得到 session header，使任务数看起来为零。若读取时正好遇到未写完的末尾 frame，Activity 保留此前已完整解出的前缀，等待下次刷新。

投影只消费：

• session 与 session/title：session id、工作区、时间和标题；
• user/message 且 source.kind == "user"：人类请求；
• tool/call：当前统一工具 mcp__clumsies__memory 的 {"op":{"activate":{"query":"...","state":"..."}}}，以及旧 mcp__clumsies__activate 的顶层 query 兼容格式；
• tool/result：用 callId 与调用配对，读取结构化 activation 结果或错误。

统一 memory 工具中的 load、store 等其他 operation 不会被误判为 activation。

Codex Desktop/App

Codex rollout 从以下目录递归发现：

~/.codex/sessions
~/.codex/archived_sessions

开发实例可以通过 daemon 配置使用独立的 Codex home。session_meta.payload.cwd 必须能匹配已绑定工作区；subagent rollout 被排除。活动目录和归档目录出现同一 session 时，活动副本优先；标题从本地 session_index.jsonl 读取。

当前结构化 activation 记录为：

event_msg.payload.type = "item_completed"
payload.item = {
  type: "McpToolCall",
  id: "...",
  server: "clumsies",
  tool: "memory",
  arguments: { op: { activate: { query: "...", state?: "..." } } },
  result?: { structuredContent: { run_id?, fragments, ... }, isError? },
  error?: { message: "..." }
}

用户请求优先读取结构化 response_item 中标记为 user.text 的内容，并兼容旧 event_msg.payload.type = "user_message"。旧 mcp_tool_call_end 事件、工具名 memory/activate、activate 及 JSON 字符串参数继续作为只读兼容输入；其他 MCP Server 和 memory 的其他 operation 被忽略。

请求、activation 与 Retrieval Run 的关联

每条真实人类消息开始一个请求；之后的 Clumsies activation 归入该请求，直到下一条人类消息。DSH 用 callId 配对调用和结果；Codex 的 McpToolCall 完成事件已同时包含两端。

新日志中，structuredContent.run_id 是关联本地 retrieval_runs 的权威身份。daemon 还会校验该 run 属于工作区绑定的 Project；查询文本只用于展示，不是身份键。

选中候选的 unit_key、heading、最终顺序和预览来自该 run。每张可见且预览被截断或为空的片段卡使用 run_id + unit_key 和冻结 locator，从该次 run 保留的 corpus body 读取完整历史正文，并直接内联渲染 Markdown，不读取可能已经变化的当前 Memory。description-only 检索单元没有正文 byte range，因此只能如实返回当时保存的预览。快照缺失或检索历史已清理时，保留工具结果中的原始预览；历史记录不可用不等于没有发生检索。

同一次关联读取还提供可选的 total_us：只显示已结束 run 记录的检索耗时，运行中或无法关联时保持缺失。该值不是模型回复耗时，也不能通过简单相加各阶段计时得出。片段数量包含 reuse，不表示本次新发送的内容数量。

旧日志可能没有 run_id。此时仍展示工具结果中自带的片段或错误；daemon 只有在 (project_id, query) 恰好匹配唯一 retrieval run 时才补关联，不会从多个同 query 结果中擅自选择“最新一条”。匹配不唯一时，run 状态与历史正文保持缺失。

隐私与权限边界

Activity 不会为了生成视图把本地会话日志上传到 Server，也不会调用模型总结日志。读取和投影发生在本机 daemon；App 通过本地 XPC 请求结果。

但“本地”不等于“不敏感”：Activity 会显示日志中记录的完整用户请求、Agent 写出的原始 Memory 查询，以及被选中的 Memory 片段。能够访问本机账号、这些日志文件或已解锁 App 的人，可能看到这些内容。当前实现不提供额外的字段脱敏、按消息授权或 Activity 专属加密层；敏感信息不应写入 prompt、查询或 Memory 正文。

当前 UI 路径与历史正文读取具有以下边界：

• App 的无 filter / Project filter 只从 daemon binding 表发现 workspace；
• Project filter 只包含绑定到该 Project 的 workspace；
• run_id 与完整历史片段读取必须再次通过 Project 边界校验。

浏览 Activity 不会修改 Memory、Issue 或 session 文件，也不会导入 ChatGPT 数据导出。检索详情中的不准确反馈与证据核对会更新评估记录，并为评估保留对应的 source run。源日志与其他 retrieval history 的保留和删除仍由各自的本地存储生命周期负责。

加载、分页与项目恢复

首个请求前恢复该服务器、组织和账号上次选择的具体项目。已删除或无权访问时，依次回退到当前 Memory 项目和第一个可用项目。All Projects 保留为本次会话中的主动选择，下次启动仍恢复上次具体项目。没有项目时不发起初始 Activity 请求。

• list_recalls 只返回摘要，每页默认 20 条、最多 100 条。首次发现只在阻塞线程池读取有界日志头和标题预览，不解析完整会话或关联检索详情。
• 后续页通过游标复用同一摘要快照，不重新扫描目录。手动刷新才建立新快照。
• get_recall_session 使用摘要返回的 session_token，只解析选中的会话。任务按页返回，后续页复用首次解析结果，只为当前页补齐检索详情。
• 移除原先 500 个请求、每个请求 100 次 activation 的静默截断；完整片段只在可见预览被截断或为空时读取。
• daemon 在内存中保留最近八个列表快照和四个选中会话，不建立额外持久化会话副本。快照被淘汰或 daemon 重启后，可通过 Refresh Activity 恢复；绑定变化后不能沿用旧快照越界读取。
• 单个损坏的日志头会被跳过；选中会话正文读取失败时，在详情区域显示错误与重试。Codex discovery 失败时保留 DSH 结果；DSH 工作区目录无法枚举时请求失败。

首次加载只在等待区域显示一个原生指示器；刷新保留内容和选中项；翻页只在列表或任务末尾显示进度。项目或会话切换后，旧响应不能覆盖新内容。该设计参考 Apple 的 Loading 和 Progress indicators，移除了通用组件中转圈与装饰性骨架的叠加。

实现索引

关注点	路径
共享投影、绑定过滤与 DSH reader	crates/daemon/src/recall.rs
摘要快照与任务分页	crates/daemon/src/recall/paging.rs
Codex rollout discovery 与 parser	crates/daemon/src/recall/codex.rs
历史片段与 Project 边界	crates/daemon/src/retrieval_history.rs
XPC dispatch	crates/daemon/src/state.rs（list_recalls、get_recall_session、get_recall_fragment）
XPC client 与模型	apps/macos/Sources/Services/Daemon/DaemonXPCClient.swift、apps/macos/Sources/Libraries/Models/DaemonModels.swift
Activity UI 与 host badge	apps/macos/Sources/Features/Activity/ActivityView.swift、ActivityModel.swift
Workspace 接线	apps/macos/Sources/Features/Workspace/WorkspaceView.swift