backtrace-console 0.0.5 → 0.0.6

package/routes/backtrace-chat-claude.js

@@ -0,0 +1,477 @@
+var express = require('express');
+var fs = require('node:fs/promises');
+var path = require('node:path');
+var shared = require('./backtrace-shared');
+
+var router = express.Router();
+
+// ── 会话文件管理 ─────────────────────────────────────────────────────────
+
+async function getChatSessionIds(relativeFingerprintPath) {
+  var entries = await shared.listImmediateFiles(shared.FINGERPRINTS_ROOT, path.join(relativeFingerprintPath, 'messages'));
+  return entries
+    .filter(function(entry) { return entry.ext === '.json' && entry.name.startsWith('claude-'); })
+    .map(function(entry) { return path.basename(entry.name, '.json'); })
+    .sort(function(a, b) { return b.localeCompare(a); });
+}
+
+// 崩溃上下文 prompt 由 shared.buildCrashContextPrompt 统一提供
+
+async function readChatSession(relativeFingerprintPath, sessionId) {
+  var relativePath = path.join(relativeFingerprintPath, 'messages', sessionId + '.json');
+  var absolutePath = shared.toSafeAbsolute(shared.FINGERPRINTS_ROOT, relativePath);
+  var raw = await fs.readFile(absolutePath, 'utf8').catch(function(error) {
+    if (error && error.code === 'ENOENT') return '';
+    throw error;
+  });
+  return raw ? JSON.parse(raw) : null;
+}
+
+async function writeChatSession(relativeFingerprintPath, session) {
+  var messagesDir = shared.toSafeAbsolute(shared.FINGERPRINTS_ROOT, path.join(relativeFingerprintPath, 'messages'));
+  var absolutePath = shared.toSafeAbsolute(shared.FINGERPRINTS_ROOT, path.join(relativeFingerprintPath, 'messages', session.sessionId + '.json'));
+  await fs.mkdir(messagesDir, { recursive: true });
+  await fs.writeFile(absolutePath, JSON.stringify(session, null, 2), 'utf8');
+  return absolutePath;
+}
+
+async function listChatSessions(relativeFingerprintPath) {
+  var sessionIds = await getChatSessionIds(relativeFingerprintPath);
+  var sessions = [];
+  for (var i = 0; i < sessionIds.length; i += 1) {
+    var session = await readChatSession(relativeFingerprintPath, sessionIds[i]);
+    if (!session) continue;
+    sessions.push({
+      sessionId: session.sessionId,
+      claudeSessionId: session.claudeSessionId || null,
+      title: session.title || session.sessionId,
+      createdAt: session.createdAt || null,
+      updatedAt: session.updatedAt || session.createdAt || null,
+      messageCount: Array.isArray(session.messages) ? session.messages.length : 0,
+    });
+  }
+  return sessions;
+}
+
+async function createChatSession(relativeFingerprintPath) {
+  var meta = await shared.readFingerprintMeta(relativeFingerprintPath);
+  if (!meta) throw new Error('fingerprint not found');
+  var now = new Date();
+  var sessionId = 'claude-' + shared.formatChatSessionId(now);
+  var session = {
+    sessionId: sessionId,
+    fingerprint: relativeFingerprintPath,
+    claudeSessionId: null,
+    createdAt: now.toISOString(),
+    updatedAt: now.toISOString(),
+    title: '新对话 ' + sessionId,
+    messages: [{ kind: 'context', role: 'system', text: shared.buildCrashContextPrompt(meta), createdAt: now.toISOString() }],
+  };
+  await writeChatSession(relativeFingerprintPath, session);
+  return session;
+}
+
+async function appendChatSessionEvent(relativeFingerprintPath, sessionId, event) {
+  var session = await readChatSession(relativeFingerprintPath, sessionId);
+  if (!session) throw new Error('chat session not found');
+  if (!Array.isArray(session.messages)) session.messages = [];
+  session.messages.push(event);
+  session.updatedAt = new Date().toISOString();
+  if ((!session.title || session.title.indexOf('新对话') === 0) && event.role === 'user' && event.text) {
+    session.title = String(event.text).slice(0, 80);
+  }
+  await writeChatSession(relativeFingerprintPath, session);
+  return session;
+}
+
+async function updateChatSessionClaudeId(relativeFingerprintPath, sessionId, claudeSessionId) {
+  var session = await readChatSession(relativeFingerprintPath, sessionId);
+  if (!session) throw new Error('chat session not found');
+  session.claudeSessionId = typeof claudeSessionId === 'string' ? claudeSessionId : null;
+  session.updatedAt = new Date().toISOString();
+  await writeChatSession(relativeFingerprintPath, session);
+  return session;
+}
+
+async function upsertAgentDraftMessage(relativeFingerprintPath, sessionId, draftId, text, extraMeta) {
+  var session = await readChatSession(relativeFingerprintPath, sessionId);
+  if (!session) throw new Error('chat session not found');
+  if (!Array.isArray(session.messages)) session.messages = [];
+  var now = new Date().toISOString();
+  var draft = session.messages.find(function(message) {
+    return message && message.kind === 'agent_draft' && message.meta && message.meta.draftId === draftId;
+  });
+  if (!draft) {
+    draft = { kind: 'agent_draft', role: 'agent', text: '', createdAt: now, updatedAt: now, meta: { draftId: draftId, status: 'streaming' } };
+    session.messages.push(draft);
+  }
+  draft.text = String(text || '');
+  draft.updatedAt = now;
+  draft.meta = Object.assign({}, draft.meta || {}, extraMeta || {}, { draftId: draftId, status: 'streaming' });
+  session.updatedAt = now;
+  await writeChatSession(relativeFingerprintPath, session);
+  return session;
+}
+
+async function finalizeAgentDraftMessage(relativeFingerprintPath, sessionId, draftId, text) {
+  var session = await readChatSession(relativeFingerprintPath, sessionId);
+  if (!session) throw new Error('chat session not found');
+  if (!Array.isArray(session.messages)) session.messages = [];
+  var now = new Date().toISOString();
+  var draft = session.messages.find(function(message) {
+    return message && message.kind === 'agent_draft' && message.meta && message.meta.draftId === draftId;
+  });
+  if (!draft) {
+    draft = { createdAt: now, meta: { draftId: draftId } };
+    session.messages.push(draft);
+  }
+  draft.kind = 'message';
+  draft.role = 'agent';
+  draft.text = String(text || '');
+  draft.updatedAt = now;
+  draft.meta = Object.assign({}, draft.meta || {}, { draftId: draftId, status: 'completed' });
+  session.updatedAt = now;
+  await writeChatSession(relativeFingerprintPath, session);
+  return session;
+}
+
+// ── P4 提交说明构建 ──────────────────────────────────────────────────────
+// 与 backtrace-chat.js 中的 buildP4SubmitDescription 完全一致
+function buildP4SubmitDescription(changes, workdir) {
+  if (!changes || !changes.length) return '';
+  var wd = String(workdir || '').replace(/\\/g, '/').replace(/\/$/, '') + '/';
+
+  var relPaths = changes.map(function(c) {
+    var p = String(c.path || '').replace(/\\/g, '/');
+    return p.startsWith(wd) ? p.slice(wd.length) : p;
+  });
+
+  var segArrays = relPaths.map(function(p) {
+    return p.split('/').filter(Boolean).slice(0, -1);
+  });
+  var common = segArrays[0] ? segArrays[0].slice() : [];
+  for (var i = 1; i < segArrays.length; i++) {
+    var newCommon = [];
+    for (var j = 0; j < Math.min(common.length, segArrays[i].length); j++) {
+      if (common[j] === segArrays[i][j]) newCommon.push(common[j]);
+      else break;
+    }
+    common = newCommon;
+  }
+
+  var skip = new Set(['source', 'src', 'private', 'public', 'classes', 'aboveland', 'game']);
+  var module = 'Core';
+  for (var k = common.length - 1; k >= 0; k--) {
+    if (!skip.has(common[k].toLowerCase())) { module = common[k]; break; }
+  }
+
+  var kinds = changes.map(function(c) { return c.kind || 'update'; });
+  var op = kinds.every(function(x) { return x === 'add'; }) ? 'add'
+         : kinds.every(function(x) { return x === 'delete'; }) ? 'delete'
+         : 'update';
+
+  var names = changes.slice(0, 2).map(function(c) {
+    return String(c.path || '').split(/[/\\]/).pop().replace(/\.[^.]+$/, '');
+  }).join(', ');
+  if (changes.length > 2) names += ' +' + (changes.length - 2);
+
+  return '[' + module + '] ' + op + ' ' + names + ' <by claude code>';
+}
+
+// ── 流式输入构建：支持图片 ───────────────────────────────────────────────
+
+async function* buildPromptStream(builtPromptText, images) {
+  var content = [{ type: 'text', text: builtPromptText }];
+  for (var i = 0; i < images.length; i++) {
+    var img = images[i];
+    if (!img || !img.data || !img.mimeType) continue;
+    content.push({
+      type: 'image',
+      source: { type: 'base64', media_type: img.mimeType, data: img.data }
+    });
+  }
+  yield {
+    type: 'user',
+    message: { role: 'user', content: content }
+  };
+}
+
+// ── 路由：会话 CRUD ─────────────────────────────────────────────────────
+
+router.get('/claude-chat-sessions', async function(req, res) {
+  var fingerprint = String(req.query.fingerprint || '').trim();
+  if (!fingerprint) return res.status(400).json({ ok: false, error: 'fingerprint is required' });
+  try {
+    var relativeFingerprintPath = shared.normalizeFingerprintPath(fingerprint);
+    var meta = await shared.readFingerprintMeta(relativeFingerprintPath);
+    if (!meta) return res.status(404).json({ ok: false, error: 'fingerprint not found' });
+    var sessions = await listChatSessions(relativeFingerprintPath);
+    var activeSessionId = meta.activeClaudeSessionId || null;
+    if (activeSessionId && !sessions.some(function(session) { return session.sessionId === activeSessionId; })) {
+      activeSessionId = null;
+    }
+    return res.json({ ok: true, fingerprint: fingerprint, activeSessionId: activeSessionId, sessions: sessions });
+  } catch (error) {
+    return res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+router.get('/claude-chat-session', async function(req, res) {
+  var fingerprint = String(req.query.fingerprint || '').trim();
+  var sessionId = String(req.query.sessionId || '').trim();
+  if (!fingerprint || !sessionId) return res.status(400).json({ ok: false, error: 'fingerprint and sessionId are required' });
+  try {
+    var session = await readChatSession(shared.normalizeFingerprintPath(fingerprint), sessionId);
+    if (!session) return res.status(404).json({ ok: false, error: 'chat session not found' });
+    return res.json({ ok: true, fingerprint: fingerprint, session: session });
+  } catch (error) {
+    return res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+router.post('/claude-chat-session/create', async function(req, res) {
+  var fingerprint = String((req.body || {}).fingerprint || '').trim();
+  if (!fingerprint) return res.status(400).json({ ok: false, error: 'fingerprint is required' });
+  try {
+    var relativeFingerprintPath = shared.normalizeFingerprintPath(fingerprint);
+    var session = await createChatSession(relativeFingerprintPath);
+    var meta = await shared.readFingerprintMeta(relativeFingerprintPath);
+    meta.activeClaudeSessionId = session.sessionId;
+    meta.claudeSessionId = null;
+    await shared.writeFingerprintMeta(relativeFingerprintPath, meta);
+    return res.json({ ok: true, fingerprint: fingerprint, session: session });
+  } catch (error) {
+    return res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+// ── 路由：主对话 SSE 流 ─────────────────────────────────────────────────
+
+router.post('/claude-chat', async function(req, res) {
+  var body = req.body || {};
+  var prompt = body.prompt;
+  var claudeSessionId = body.claudeSessionId;
+  var fingerprint = String(body.fingerprint || '').trim();
+  var sessionId = String(body.sessionId || '').trim();
+  var images = Array.isArray(body.images) ? body.images : [];
+  var relativeFingerprintPath = '';
+  var draftId = '';
+  var finalResponse = '';
+
+  if (!prompt) return res.status(400).json({ ok: false, error: 'prompt is required' });
+  if (!fingerprint || !sessionId) return res.status(400).json({ ok: false, error: 'fingerprint and sessionId are required' });
+
+  try {
+    res.setHeader('Content-Type', 'text/event-stream');
+    res.setHeader('Cache-Control', 'no-cache');
+    res.setHeader('Connection', 'keep-alive');
+    res.write('event: ping\ndata: \n\n');
+
+    relativeFingerprintPath = shared.normalizeFingerprintPath(fingerprint);
+    var existingMeta = await shared.readFingerprintMeta(relativeFingerprintPath);
+    if (!existingMeta) throw new Error('fingerprint not found');
+    var session = await readChatSession(relativeFingerprintPath, sessionId);
+    if (!session) throw new Error('chat session not found');
+    claudeSessionId = claudeSessionId || session.claudeSessionId || existingMeta.claudeSessionId;
+
+    await appendChatSessionEvent(relativeFingerprintPath, sessionId, {
+      kind: 'message',
+      role: 'user',
+      text: body.userMessage || prompt,
+      createdAt: new Date().toISOString(),
+      meta: images.length > 0 ? { imageCount: images.length } : null,
+    });
+
+    var workdir = body.workdir || shared.DEFAULT_WORKDIR;
+    var proxy = shared.resolveCodexProxy(body.proxy);
+    var builtPrompt = shared.buildCodexChatPrompt(prompt, { workdir: workdir });
+
+    var childEnv = Object.assign({}, process.env);
+    if (proxy) {
+      childEnv.HTTP_PROXY = proxy;
+      childEnv.HTTPS_PROXY = proxy;
+      childEnv.http_proxy = proxy;
+      childEnv.https_proxy = proxy;
+      childEnv.ALL_PROXY = proxy;
+    }
+
+    var claudeAgentSdk = await import('@anthropic-ai/claude-agent-sdk');
+    var queryOptions = {
+      prompt: buildPromptStream(builtPrompt, images),
+      options: {
+        allowedTools: ['Read', 'Edit', 'Write', 'Bash', 'Glob', 'Grep'],
+        permissionMode: 'acceptEdits',
+        cwd: workdir,
+        model: shared.CLAUDE_MODEL,
+        maxTurns: 20,
+        includePartialMessages: true,
+        env: childEnv,
+      }
+    };
+    if (claudeSessionId) queryOptions.options.resume = claudeSessionId;
+
+    draftId = 'claude-draft-' + Date.now() + '-' + Math.random().toString(16).slice(2, 10);
+    var lastDraftWriteAt = 0;
+    var pendingTool = null; // { toolId, toolName, argsBuffer }
+    var fileChanges = [];
+    var resolvedClaudeSessionId = claudeSessionId;
+
+    await upsertAgentDraftMessage(relativeFingerprintPath, sessionId, draftId, '', { claudeSessionId: claudeSessionId });
+
+    function writeSse(payload) {
+      res.write('data: ' + JSON.stringify(payload) + '\n\n');
+    }
+    async function persistDraft(force) {
+      var now = Date.now();
+      if (!force && now - lastDraftWriteAt < 600) return;
+      lastDraftWriteAt = now;
+      await upsertAgentDraftMessage(relativeFingerprintPath, sessionId, draftId, finalResponse, { claudeSessionId: resolvedClaudeSessionId });
+    }
+
+    for await (var message of claudeAgentSdk.query(queryOptions)) {
+      // 1. 捕获 session_id
+      if (message.type === 'system' && message.subtype === 'init' && message.session_id) {
+        resolvedClaudeSessionId = message.session_id;
+      }
+
+      // 2. 流式事件 → SSE
+      if (message.type === 'stream_event') {
+        var ev = message.event;
+        if (!ev || !ev.type) continue;
+
+        if (ev.type === 'content_block_start' && ev.content_block && ev.content_block.type === 'tool_use') {
+          pendingTool = {
+            toolId: ev.content_block.id || ('claude-tool-' + Date.now()),
+            toolName: ev.content_block.name || 'tool',
+            argsBuffer: ''
+          };
+          await appendChatSessionEvent(relativeFingerprintPath, sessionId, {
+            kind: 'tool_call_started',
+            role: 'tool',
+            text: pendingTool.toolName,
+            createdAt: new Date().toISOString(),
+            meta: { toolId: pendingTool.toolId }
+          });
+          writeSse({
+            kind: 'tool_call_started',
+            toolId: pendingTool.toolId,
+            toolName: pendingTool.toolName,
+            args: null,
+            text: pendingTool.toolName
+          });
+          continue;
+        }
+
+        if (ev.type === 'content_block_delta' && ev.delta) {
+          if (ev.delta.type === 'text_delta') {
+            var delta = ev.delta.text || '';
+            if (delta) {
+              finalResponse += delta;
+              writeSse({ kind: 'agent_text', text: delta, replace: false });
+              await persistDraft(false);
+            }
+            continue;
+          }
+          if (ev.delta.type === 'input_json_delta' && pendingTool) {
+            pendingTool.argsBuffer += ev.delta.partial_json || '';
+            continue;
+          }
+        }
+
+        if (ev.type === 'content_block_stop' && pendingTool) {
+          var parsedArgs = null;
+          try { parsedArgs = pendingTool.argsBuffer ? JSON.parse(pendingTool.argsBuffer) : null; } catch (_) {}
+          await appendChatSessionEvent(relativeFingerprintPath, sessionId, {
+            kind: 'tool_call_completed',
+            role: 'tool',
+            text: '',
+            createdAt: new Date().toISOString(),
+            meta: { toolId: pendingTool.toolId, args: parsedArgs }
+          });
+          writeSse({
+            kind: 'tool_call_completed',
+            toolId: pendingTool.toolId,
+            toolName: pendingTool.toolName,
+            args: parsedArgs,
+            result: '',
+            text: ''
+          });
+          pendingTool = null;
+          continue;
+        }
+      }
+
+      // 3. assistant 完整消息 → 提取 tool_use 用于 P4 文件追踪
+      if (message.type === 'assistant' && message.message && Array.isArray(message.message.content)) {
+        for (var b = 0; b < message.message.content.length; b++) {
+          var block = message.message.content[b];
+          if (!block || block.type !== 'tool_use') continue;
+          var input = block.input || {};
+          var fpath = input.file_path || input.path || '';
+          if (!fpath) continue;
+          if (block.name === 'Write') fileChanges.push({ path: fpath, kind: 'add' });
+          else if (block.name === 'Edit') fileChanges.push({ path: fpath, kind: 'update' });
+        }
+      }
+
+      // 4. result 消息携带最终 session_id
+      if (message.type === 'result' && message.session_id) {
+        resolvedClaudeSessionId = message.session_id;
+      }
+    }
+
+    // 收尾：持久化、写 P4 描述、发送 done
+    await finalizeAgentDraftMessage(relativeFingerprintPath, sessionId, draftId, finalResponse);
+    await updateChatSessionClaudeId(relativeFingerprintPath, sessionId, resolvedClaudeSessionId);
+    existingMeta.claudeSessionId = resolvedClaudeSessionId;
+    existingMeta.activeClaudeSessionId = sessionId;
+    await shared.writeFingerprintMeta(relativeFingerprintPath, existingMeta);
+
+    // P4 文件去重 + 描述构建（与 Codex 版相同的输出格式）
+    var p4Description = '';
+    if (fileChanges.length > 0) {
+      var dedup = {};
+      fileChanges.forEach(function(c) { dedup[c.path] = c; });
+      var changes = Object.keys(dedup).map(function(k) { return dedup[k]; });
+      try {
+        p4Description = buildP4SubmitDescription(changes, workdir);
+        var repairDir = path.join(shared.FINGERPRINTS_ROOT, relativeFingerprintPath, 'repair', 'chat-' + sessionId);
+        await fs.mkdir(repairDir, { recursive: true });
+        await fs.writeFile(path.join(repairDir, 'p4-changes.json'), JSON.stringify({
+          fingerprint: relativeFingerprintPath,
+          sessionId: sessionId,
+          description: p4Description,
+          files: changes.map(function(c) { return c.path; }),
+          recordedAt: new Date().toISOString(),
+          submittedAt: null
+        }, null, 2));
+        console.log('[claude-chat] p4-changes.json 已写入 ' + changes.length + ' 个文件，描述: ' + p4Description);
+      } catch (e) {
+        console.error('[claude-chat] p4-changes.json 写入失败:', e.message);
+      }
+    }
+
+    writeSse({
+      kind: 'done',
+      claudeSessionId: resolvedClaudeSessionId,
+      sessionId: sessionId,
+      p4Description: p4Description || undefined
+    });
+    res.end();
+  } catch (error) {
+    var errMsg = error instanceof Error ? error.message : String(error);
+    var errStack = error instanceof Error && error.stack ? error.stack : '';
+    console.error('[claude-chat] 处理失败:', errMsg);
+    if (errStack) console.error(errStack);
+    if (relativeFingerprintPath && sessionId && draftId) {
+      await upsertAgentDraftMessage(relativeFingerprintPath, sessionId, draftId, finalResponse, {
+        status: 'interrupted',
+        error: errMsg,
+      }).catch(function() {});
+    }
+    res.write('event: error\ndata: ' + JSON.stringify({ kind: 'error', error: errMsg }) + '\n\n');
+    res.end();
+  }
+});
+
+module.exports = router;

package/routes/backtrace-chat.js

@@ -3,24 +3,18 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var os = require('node:os');
 var shared = require('./backtrace-shared');
+var p4ops = require('../lib/p4ops');
 
 var router = express.Router();
 
 async function getChatSessionIds(relativeFingerprintPath) {
   var entries = await shared.listImmediateFiles(shared.FINGERPRINTS_ROOT, path.join(relativeFingerprintPath, 'messages'));
-  return entries.filter(function(entry) { return entry.ext === '.json'; })
+  return entries.filter(function(entry) { return entry.ext === '.json' && !entry.name.startsWith('claude-'); })
     .map(function(entry) { return path.basename(entry.name, '.json'); })
     .sort(function(a, b) { return b.localeCompare(a); });
 }
 
-function buildContextMessage(meta) {
-  var errorMessage = meta && meta.errorMessage ? meta.errorMessage : '-';
-  var classifiers = meta && meta.classifiers ? meta.classifiers : '-';
-  return '你是一个非常专业并资深的C++开发工程师和UE工程师。当前崩溃的关键信息如下：\n'
-    + 'Error Message: ' + errorMessage + '\n'
-    + 'Classifiers: ' + classifiers + '\n\n'
-    + '请结合这些上下文，帮助用户定位问题并给出修复建议。';
-}
+// 崩溃上下文 prompt 由 shared.buildCrashContextPrompt 统一提供
 
 async function readChatSession(relativeFingerprintPath, sessionId) {
   var relativePath = path.join(relativeFingerprintPath, 'messages', sessionId + '.json');
@@ -70,7 +64,7 @@ async function createChatSession(relativeFingerprintPath) {
     createdAt: now.toISOString(),
     updatedAt: now.toISOString(),
     title: '新对话 ' + sessionId,
-    messages: [{ kind: 'context', role: 'system', text: buildContextMessage(meta), createdAt: now.toISOString() }],
+    messages: [{ kind: 'context', role: 'system', text: shared.buildCrashContextPrompt(meta), createdAt: now.toISOString() }],
   };
   await writeChatSession(relativeFingerprintPath, session);
   return session;
@@ -140,6 +134,53 @@ async function finalizeAgentDraftMessage(relativeFingerprintPath, sessionId, dra
   return session;
 }
 
+// 从 file_change 事件的 changes 数组构建 P4 提交说明
+// 格式：[<module>] <op> <filenames> <by codex ai>
+function buildP4SubmitDescription(changes, workdir) {
+  if (!changes || !changes.length) return '';
+  var wd = String(workdir || '').replace(/\\/g, '/').replace(/\/$/, '') + '/';
+
+  var relPaths = changes.map(function(c) {
+    var p = String(c.path || '').replace(/\\/g, '/');
+    return p.startsWith(wd) ? p.slice(wd.length) : p;
+  });
+
+  // 找各路径目录部分的最深公共段
+  var segArrays = relPaths.map(function(p) {
+    return p.split('/').filter(Boolean).slice(0, -1); // 去掉文件名
+  });
+  var common = segArrays[0] ? segArrays[0].slice() : [];
+  for (var i = 1; i < segArrays.length; i++) {
+    var newCommon = [];
+    for (var j = 0; j < Math.min(common.length, segArrays[i].length); j++) {
+      if (common[j] === segArrays[i][j]) newCommon.push(common[j]);
+      else break;
+    }
+    common = newCommon;
+  }
+
+  // 取最深的非通用目录名作为 module
+  var skip = new Set(['source', 'src', 'private', 'public', 'classes', 'aboveland', 'game']);
+  var module = 'Core';
+  for (var k = common.length - 1; k >= 0; k--) {
+    if (!skip.has(common[k].toLowerCase())) { module = common[k]; break; }
+  }
+
+  // 确定操作类型
+  var kinds = changes.map(function(c) { return c.kind || 'update'; });
+  var op = kinds.every(function(x) { return x === 'add'; }) ? 'add'
+         : kinds.every(function(x) { return x === 'delete'; }) ? 'delete'
+         : 'update';
+
+  // 文件名（最多 2 个，不含扩展名）
+  var names = changes.slice(0, 2).map(function(c) {
+    return String(c.path || '').split(/[/\\]/).pop().replace(/\.[^.]+$/, '');
+  }).join(', ');
+  if (changes.length > 2) names += ' +' + (changes.length - 2);
+
+  return '[' + module + '] ' + op + ' ' + names + ' <by codex ai>';
+}
+
 function buildCodexEventMeta(event) {
   var meta = {};
   if (!event || typeof event !== 'object') return meta;
@@ -272,19 +313,15 @@ router.post('/chat', async function(req, res) {
     var proxy = shared.resolveCodexProxy(body.proxy);
     var mod = await import('@openai/codex-sdk');
     var codex = new mod.Codex({ env: Object.assign({}, process.env, { HTTP_PROXY: proxy, HTTPS_PROXY: proxy, ALL_PROXY: proxy }) });
-    var thread = threadId ? codex.resumeThread(threadId, {
+    var threadOptions = {
       workingDirectory: workdir,
       skipGitRepoCheck: true,
       sandboxMode: 'workspace-write',
       approvalPolicy: 'never',
-      modelReasoningEffort: 'high',
-    }) : codex.startThread({
-      workingDirectory: workdir,
-      skipGitRepoCheck: true,
-      sandboxMode: 'workspace-write',
-      approvalPolicy: 'never',
-      modelReasoningEffort: 'high',
-    });
+      modelReasoningEffort: shared.CODEX_REASONING_EFFORT,
+    };
+    if (shared.CODEX_MODEL) threadOptions.model = shared.CODEX_MODEL;
+    var thread = threadId ? codex.resumeThread(threadId, threadOptions) : codex.startThread(threadOptions);
 
     // 构造 UserInput[]：文本 + 图片
     var userInput = [{ type: 'text', text: shared.buildCodexChatPrompt(prompt, { workdir: workdir }) }];
@@ -296,6 +333,7 @@ router.post('/chat', async function(req, res) {
     finalResponse = '';
     var lastSentText = '';
     var toolBuffers = {};
+    var fileChanges = [];  // 收集 Codex file_change 事件的 {path, kind} 列表
     draftId = 'draft-' + Date.now() + '-' + Math.random().toString(16).slice(2, 10);
     var lastDraftWriteAt = 0;
     await upsertAgentDraftMessage(relativeFingerprintPath, sessionId, draftId, '', { threadId: thread.id });
@@ -339,6 +377,14 @@ router.post('/chat', async function(req, res) {
         throw new Error(event.error && event.error.message ? event.error.message : 'Codex turn failed');
       }
 
+      // 直接从 file_change 事件提取 {path, kind}（FileChangeItem.changes[]）
+      if (event.type === 'item.completed' && event.item && event.item.type === 'file_change' && event.item.status === 'completed') {
+        var changes = event.item.changes || [];
+        for (var ci = 0; ci < changes.length; ci++) {
+          if (changes[ci].path) fileChanges.push({ path: changes[ci].path, kind: changes[ci].kind || 'update' });
+        }
+      }
+
       if (event.item && event.item.type && event.item.type !== 'agent_message' && event.item.type !== 'user_message') {
         var toolId = event.item.id || eventMeta.itemId || ('tool-' + Date.now());
         var toolText = extractCodexEventText(event);
@@ -367,7 +413,29 @@ router.post('/chat', async function(req, res) {
     existingMeta.threadId = thread.id;
     existingMeta.activeSessionId = sessionId;
     await shared.writeFingerprintMeta(relativeFingerprintPath, existingMeta);
-    writeSse({ kind: 'done', threadId: thread.id, sessionId: sessionId });
+
+    // Codex 修改了文件时，写 p4-changes.json 并把描述附在 done 事件里
+    var p4Description = '';
+    if (fileChanges.length > 0) {
+      try {
+        p4Description = buildP4SubmitDescription(fileChanges, workdir);
+        var repairDir = path.join(shared.FINGERPRINTS_ROOT, relativeFingerprintPath, 'repair', 'chat-' + sessionId);
+        await fs.mkdir(repairDir, { recursive: true });
+        await fs.writeFile(path.join(repairDir, 'p4-changes.json'), JSON.stringify({
+          fingerprint: relativeFingerprintPath,
+          sessionId: sessionId,
+          description: p4Description,
+          files: fileChanges.map(function(c) { return c.path; }),
+          recordedAt: new Date().toISOString(),
+          submittedAt: null
+        }, null, 2));
+        console.log('[chat] p4-changes.json 已写入 ' + fileChanges.length + ' 个文件，描述: ' + p4Description);
+      } catch (e) {
+        console.error('[chat] p4-changes.json 写入失败:', e.message);
+      }
+    }
+
+    writeSse({ kind: 'done', threadId: thread.id, sessionId: sessionId, p4Description: p4Description || undefined });
     res.end();
   } catch (error) {
     if (relativeFingerprintPath && sessionId && draftId) {