cc 2 weeks ago
parent
commit
61e4c9b9fe
1 changed files with 40 additions and 0 deletions
  1. 40 0
      .zcode/plans/plan-sess_bc4bbb24-615c-4839-9899-949e22febe6f.md

+ 40 - 0
.zcode/plans/plan-sess_bc4bbb24-615c-4839-9899-949e22febe6f.md

@@ -0,0 +1,40 @@
+## Context
+
+方案:**长期记忆跨会话共享,产物(工作区文件)按会话隔离**——避免新会话把上一会话的过期产物当现成结论引用。框架机制已核实可行:`isolationScope(SESSION)` 让文件工具按会话命名空间隔离(实例池不受影响),`filesystemRoute` 把 `memory/` 与 `MEMORY.md` 路由回用户级共享目录(位置与现状相同,存量记忆继续可用)。
+
+按你的决定:**开发阶段不考虑历史兼容**——不做两代并存、不管旧布局、历史会话数据不迁移;聚合接口回退;Insight 不动。
+
+## 实施清单
+
+### 1. 回退「案件+专家产物聚合」(全部未提交,精确摘除)
+- 后端:AgentChatController 的 `/chat/artifacts` 端点、AgentChatService 接口方法、AgentChatServiceImpl 的 `listCaseArtifacts`/`parseToolEventsQuietly`/`extractArtifactMeta`
+- 前端:chatApi 的 `listCaseArtifacts`/`CaseArtifactItem`/`ArtifactMeta` 导入、types.ts 的 `CaseArtifactItem`、chatStream 的 `caseArtifacts` 状态/`loadCaseArtifacts` 动作/loadMessages 内触发段/`toCount, SessionArtifact` 导入、index.vue 的 merge computed 与 SessionArtifact 导入、ArtifactPanel 副标题来源会话段、artifacts.ts 的 `sourceSessionTitle` 字段与 `toCount` export
+
+### 2. 主 Agent 产物会话隔离(核心)
+[AgentService.java](E:\workspace\zsjz-ai\ai-server\src\main\java\com\zsjz\ai\module\agent\service\AgentService.java) `buildAgent`(~492 行):
+```java
+Path sharedUserDir = storageLayout.agentWorkspace(workspaceId, entry.getRowId())
+        .resolve(String.valueOf(userId));
+LocalFilesystem sharedMemoryFs = new LocalFilesystem(sharedUserDir);
+b.filesystem(new LocalFilesystemSpec().isolationScope(IsolationScope.SESSION));
+b.filesystemRoute("memory/", sharedMemoryFs);
+b.filesystemRoute("MEMORY.md", sharedMemoryFs);
+```
+- 文件工具全部落 `{工作区}/{sessionId}/`(`write_file`/`list_files` 会话隔离,新会话看不到旧产物)
+- `memory/` 与 `MEMORY.md` 路由到 `agents/{专家id}/{用户id}/`(与现状同位置,长期记忆跨会话共享不变)
+
+### 3. 连带适配(只按新标准,无兼容分支)
+- [AgentArtifactScanner.java](E:\workspace\zsjz-ai\ai-server\src\main\java\com\zsjz\ai\module\agent\artifact\AgentArtifactScanner.java):扫描根 1 从 `resolve(userId)` 改为 `resolve(String.valueOf(sessionId))`;同步更新 AgentArtifactScannerTest
+- [AgentService.java](E:\workspace\zsjz-ai\ai-server\src\main\java\com\zsjz\ai\module\agent\service\AgentService.java) `deleteSessionTranscript`(252-280):转录位置改为 `{工作区}/{sessionId}/.agentscope-runtime/agents/{agentId}/sessions/{s_user}/{s_session}`,**删除旧布局遍历逻辑**
+- [PromptAssembler.java](E:\workspace\zsjz-ai\ai-server\src\main\java\com\zsjz\ai\module\agent\prompt\PromptAssembler.java) `TOOL_RULES` 追加一条:工作区按会话隔离,历史会话产物不可访问,数据结论必须来自本会话的实际计算/读取;记忆中的文件路径仅作背景参考
+
+### 4. 不做
+- InsightAgentFactory(案件级工作区,保持现状)
+- 子代理(目录已带 parentSessionId,天然会话隔离)
+- 旧布局数据迁移/清理(不管)
+- 磁盘清理策略(后续项)
+
+### 5. 验证
+1. **第 0 步分层 spike 单测**(先行,新增):构造 SESSION 命名空间 LocalFilesystem + CompositeFilesystem + memory 路由,断言普通路径写入 `{root}/{sessionId}/…`、`memory/` 与 `MEMORY.md` 写入共享根——钉死命名空间/路由层序,失败则先汇报再调整方案
+2. `mvn -pl ai-server compile test-compile` + 回归:AgentRuntimeTuningTest、PromptAssemblyTest、AgentExpertTest、AgentArtifactScannerTest(更新后)
+3. E2E:启动后端 → 会话 A 让模型生成 HTML 产物 → 新会话 B 要求列出工作区文件并重新分析 → 断言:B 看不到 A 的文件并重新计算;A 中 `memory_save` 的内容在 B 的 `memory_search` 可查(记忆共享 ✓);产物栏 A/B 各自会话独立;删除会话 B 后其转录目录被清理