添加注释以说明工具和会话的上下文处理

src/config.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 
+// 统一在启动时解析环境变量，避免业务代码里散落字符串默认值。
 const envSchema = z.object({
   NODE_ENV: z.string().default("development"),
   PORT: z.coerce.number().int().positive().default(8788),

src/server.ts

@@ -16,6 +16,7 @@ const registry = new SessionRegistry(config.SESSION_TTL_SECONDS);
 const sessionBridge = new ChatSessionBridge(registry, opencodeRuntime);
 const internalToken = config.AGENT_INTERNAL_TOKEN ?? randomUUID();
 
+// 这个 token 只用于 .opencode/tools 回调本服务，避免把 internal endpoint 暴露成无鉴权入口。
 process.env.TJWATER_AGENT_INTERNAL_TOKEN = internalToken;
 
 app.use(cors());
@@ -57,6 +58,7 @@ app.post("/internal/tools/dynamic-http-call", async (req, res) => {
   }
 
   try {
+    // opencode 工具运行在 .opencode 侧，这里负责把工具调用重新绑定到当前用户/项目上下文。
     const result = await dynamicHttpExecutor.execute(
       {
         path: req.body?.path,
@@ -87,6 +89,7 @@ const server = app.listen(config.PORT, config.HOST, () => {
 const shutdown = async () => {
   logger.info("shutting down TJWaterAgent");
   server.close();
+  // 同步关闭 embedded opencode server，避免本服务退出后留下孤儿进程。
   await opencodeRuntime.dispose();
 };
 

src/session/registry.ts

@@ -62,6 +62,7 @@ export class SessionRegistry {
   }
 
   private makeKey(context: SessionContext): string {
+    // 会话隔离不能只看 conversationId；同一浏览器会话切换用户或项目时必须映射到不同 opencode session。
     const digest = crypto
       .createHash("sha256")
       .update(