refactor: unify agent session persistence

src/config.ts

@@ -43,10 +43,12 @@ const envSchema = z
     OPENCODE_TIMEOUT_MS: z.coerce.number().int().positive().default(5000),
     // 默认使用的 opencode 模型标识。
     OPENCODE_MODEL: z.string().default("deepseek/deepseek-v4-pro"),
+    // opencode skills 树目录；会在运行时解析为绝对路径，避免工具 cwd 偏移。
+    OPENCODE_SKILLS_ROOT_DIR: z.string().default("./.opencode/skills"),
     // client 模式下，目标 opencode server 的基础地址。
     OPENCODE_CLIENT_BASE_URL: z.string().url().optional(),
     // 提供给本地 opencode tools 读取的会话上下文目录。
-    SESSION_CONTEXT_STORAGE_DIR: z.string().default("./data/session-contexts"),
+    SESSION_RUNTIME_CONTEXT_STORAGE_DIR: z.string().default("./data/session-runtime-contexts"),
     // tjwater-cli 可执行文件路径。
     TJWATER_CLI_PATH: z.string().default("./cli/tjwater-cli"),
     // TJWater 后端 API 的基础地址。
@@ -59,18 +61,18 @@ const envSchema = z
     MAX_PREVIEW_SAMPLE_ITEMS: z.coerce.number().int().positive().default(3),
     // memory 持久化存储目录。
     MEMORY_STORAGE_DIR: z.string().default("./data/memory"),
-    // 持久化文件写入前保留历史版本的目录。
-    PERSISTENCE_HISTORY_DIR: z.string().default("./data/history"),
+    // 持久化文件写入前保留备份版本的目录。
+    PERSISTENCE_BACKUP_DIR: z.string().default("./data/backup"),
     // 注入到 prompt 的 memory 快照最大字符数，避免上下文过大。
     MEMORY_MAX_PROMPT_CHARS: z.coerce.number().int().positive().default(1800),
     // session transcript 持久化目录。
-    SESSION_HISTORY_STORAGE_DIR: z.string().default("./data/session-history"),
-    // conversation metadata 持久化目录。
-    CONVERSATION_STORAGE_DIR: z.string().default("./data/conversations"),
-    // conversation UI state 持久化目录。
-    CONVERSATION_STATE_STORAGE_DIR: z.string().default("./data/conversation-states"),
+    SESSION_TRANSCRIPT_STORAGE_DIR: z.string().default("./data/session-transcripts"),
+    // session metadata 持久化目录。
+    SESSION_METADATA_STORAGE_DIR: z.string().default("./data/session-metadata"),
+    // session UI state 持久化目录。
+    SESSION_UI_STATE_STORAGE_DIR: z.string().default("./data/session-ui-states"),
     // 每个会话最多保留多少轮 transcript，超过后裁剪旧记录。
-    SESSION_HISTORY_MAX_TURNS_PER_SESSION: z.coerce
+    SESSION_TRANSCRIPT_MAX_TURNS_PER_SESSION: z.coerce
       .number()
       .int()
       .positive()
@@ -79,8 +81,8 @@ const envSchema = z
     SESSION_SEARCH_MAX_RESULTS: z.coerce.number().int().positive().default(8),
     // session_search 查询文本最大长度。
     SESSION_SEARCH_MAX_QUERY_CHARS: z.coerce.number().int().positive().default(240),
-    // learning review 会话状态目录。
-    LEARNING_STATE_STORAGE_DIR: z.string().default("./data/learning-state"),
+    // 当前 session 的 learning 进度状态目录。
+    SESSION_LEARNING_STATE_STORAGE_DIR: z.string().default("./data/session-learning-state"),
     // learning audit 日志路径。
     LEARNING_AUDIT_LOG_PATH: z
       .string()