新增 memory 和 skill 存储，实现 Agent 持续学习，并增加工具支持；增加 LLM progress detail 输出

src/config.ts

@@ -6,24 +6,66 @@ dotenv.config({ path: ".local.env", override: false });
 
 // 统一在启动时解析环境变量，避免业务代码里散落字符串默认值。
 const envSchema = z.object({
+  // 运行环境标识，如 development / production。
   NODE_ENV: z.string().default("development"),
+  // HTTP 服务监听端口。
   PORT: z.coerce.number().int().positive().default(8787),
+  // HTTP 服务监听地址。
   HOST: z.string().default("0.0.0.0"),
+  // Pino 日志级别。
   LOG_LEVEL: z.string().default("info"),
-  LLM_REQUEST_AUDIT_LOG_PATH: z.string().default("./logs/llm-request-audit.log"),
+  // LLM 工具/技能调用审计日志路径。
+  LLM_REQUEST_AUDIT_LOG_PATH: z
+    .string()
+    .default("./logs/llm-request-audit.log"),
+  // 内部工具桥调用本服务时使用的鉴权 token；未显式配置时启动阶段会自动生成。
   AGENT_INTERNAL_TOKEN: z.string().optional(),
+  // embedded opencode server 的监听地址。
   OPENCODE_HOSTNAME: z.string().default("127.0.0.1"),
+  // embedded opencode server 的监听端口。
   OPENCODE_PORT: z.coerce.number().int().positive().default(4096),
+  // opencode SDK 启动或连接运行时时的超时时间（毫秒）。
   OPENCODE_TIMEOUT_MS: z.coerce.number().int().positive().default(5000),
+  // 默认使用的 opencode 模型标识。
   OPENCODE_MODEL: z.string().default("deepseek/deepseek-v4-pro"),
+  // 外部 opencode server 的基础地址；配置后将跳过 embedded 模式。
   OPENCODE_BASE_URL: z.string().optional(),
+  // 外部 opencode server 的访问密码（预留）。
   OPENCODE_SERVER_PASSWORD: z.string().optional(),
+  // 外部 opencode server 的访问用户名（预留）。
   OPENCODE_SERVER_USERNAME: z.string().default("opencode"),
+  // chat session 在本地注册表中的保活时长（秒）。
   SESSION_TTL_SECONDS: z.coerce.number().int().positive().default(1800),
+  // 提供给本地 opencode tools 读取的会话上下文目录。
+  SESSION_CONTEXT_STORAGE_DIR: z.string().default("./data/session-contexts"),
+  // TJWater 后端 API 的基础地址。
   TJWATER_API_BASE_URL: z.string().default("http://127.0.0.1:8000"),
+  // 代理调用 TJWater 后端 API 的超时时间（毫秒）。
   TJWATER_API_TIMEOUT_MS: z.coerce.number().int().positive().default(30000),
+  // 后端结果在直接内联返回给模型前允许的最大字节数。
   MAX_INLINE_RESULT_BYTES: z.coerce.number().int().positive().default(12000),
+  // 生成结果 preview 时最多抽样的条目数。
   MAX_PREVIEW_SAMPLE_ITEMS: z.coerce.number().int().positive().default(3),
+  // memory 持久化存储目录。
+  MEMORY_STORAGE_DIR: z.string().default("./data/memory"),
+  // 注入到 prompt 的 memory 快照最大字符数，避免上下文过大。
+  MEMORY_MAX_PROMPT_CHARS: z.coerce.number().int().positive().default(1800),
+  // result_ref 持久化存储目录。
+  RESULT_REF_STORAGE_DIR: z.string().default("./data/result-refs"),
+  // result_ref 保留时长（小时）。
+  RESULT_REF_TTL_HOURS: z.coerce.number().int().positive().default(168),
+  // 定时清理过期 result_ref 的扫描周期（毫秒）。
+  RESULT_REF_CLEANUP_INTERVAL_MS: z.coerce
+    .number()
+    .int()
+    .positive()
+    .default(3600000),
+  // fetch_result_ref 默认最多返回的顶层项/字段数量。
+  RESULT_REF_MAX_RETRIEVAL_ITEMS: z.coerce
+    .number()
+    .int()
+    .positive()
+    .default(50),
 });
 
 export type AppConfig = z.infer<typeof envSchema>;