@downcity/agent 1.1.287 → 1.1.310

package/src/executor/core-engine/CoreEngineSignals.ts

@@ -92,7 +92,7 @@ function toJsonObject(value: unknown): JsonObject | null {
 /**
  * 生成日志友好的单行预览文本。
  */
-export function toInlinePreview(value: unknown): string {
+export function to_inline_preview(value: unknown): string {
   const normalized = String(value ?? "").replace(/\s+/g, " ").trim();
   if (!normalized) return "";
   return normalized.length > DEBUG_TEXT_PREVIEW_MAX_CHARS
@@ -155,8 +155,8 @@ function summarizeResponseBodyForDebug(body: unknown): JsonObject {
 /**
  * 汇总单个 step 的关键信号，便于定位“为什么没有继续下一轮”。
  */
-export function summarizeStepForDebug(stepResult: unknown): JsonObject {
-  const record = toJsonObject(stepResult) || {};
+export function summarize_step_for_debug(step_result: unknown): JsonObject {
+  const record = toJsonObject(step_result) || {};
   const usage = toJsonObject(record.usage);
   const response = toJsonObject(record.response);
   const toolCalls = Array.isArray(record.toolCalls) ? record.toolCalls : [];
@@ -171,7 +171,7 @@ export function summarizeStepForDebug(stepResult: unknown): JsonObject {
     rawFinishReason:
       typeof record.rawFinishReason === "string" ? record.rawFinishReason : null,
     textLength: typeof record.text === "string" ? record.text.length : 0,
-    textPreview: toInlinePreview(record.text),
+    textPreview: to_inline_preview(record.text),
     toolCallCount: toolCalls.length,
     toolCallNames: pickToolNames(toolCalls),
     toolResultCount: toolResults.length,
@@ -191,7 +191,7 @@ export function summarizeStepForDebug(stepResult: unknown): JsonObject {
 /**
  * 汇总最终 assistant UI 消息的调试摘要。
  */
-export function summarizeUiMessageForDebug(
+export function summarize_ui_message_for_debug(
   message: SessionMessageRecordV1 | null | undefined,
 ): JsonObject {
   const parts = Array.isArray(message?.parts) ? message.parts : [];
@@ -217,7 +217,7 @@ export function summarizeUiMessageForDebug(
     partCount: parts.length,
     partTypes,
     textLength: text.length,
-    textPreview: toInlinePreview(text),
+    textPreview: to_inline_preview(text),
     toolPartCount: toolNames.length,
     toolNames,
   };
@@ -229,7 +229,7 @@ export function summarizeUiMessageForDebug(
  * 关键点（中文）
  * - 多 step 场景下，最终 assistant message 需要把各 step 的 UI part 串起来。
  */
-export function mergeAssistantUiMessages(
+export function merge_assistant_ui_messages(
   base: SessionMessageRecordV1 | null,
   incoming: SessionMessageRecordV1,
 ): SessionMessageRecordV1 {
@@ -241,8 +241,8 @@ export function mergeAssistantUiMessages(
     metadata: {
       v: incomingMetadata?.v ?? baseMetadata?.v ?? 1,
       ts: incomingMetadata?.ts ?? baseMetadata?.ts ?? Date.now(),
-      sessionId:
-        incomingMetadata?.sessionId ?? baseMetadata?.sessionId ?? "",
+      session_id:
+        incomingMetadata?.session_id ?? baseMetadata?.session_id ?? "",
       ...(baseMetadata || {}),
       ...(incomingMetadata || {}),
     },
@@ -256,14 +256,14 @@ export function mergeAssistantUiMessages(
 function pickIncompleteToolParts(
   message: SessionMessageRecordV1 | null | undefined,
 ): Array<{
-  toolName: string;
+  tool_name: string;
   state: string;
 }> {
   const parts = Array.isArray(message?.parts) ? message.parts : [];
   return parts
     .filter(isToolUIPart)
     .map((part) => ({
-      toolName: String(getToolName(part) || "unknown_tool"),
+      tool_name: String(getToolName(part) || "unknown_tool"),
       state:
         typeof toJsonObject(part)?.state === "string"
           ? String(toJsonObject(part)?.state)
@@ -287,7 +287,7 @@ function looksLikeIncompleteText(text: string): boolean {
 /**
  * 构造“不完整响应恢复”提示。
  */
-export function buildIncompleteResponseRecoveryNudge(
+export function build_incomplete_response_recovery_nudge(
   recoveryIndex: number,
 ): string {
   const round = Math.max(1, recoveryIndex);
@@ -302,14 +302,14 @@ export function buildIncompleteResponseRecoveryNudge(
 /**
  * 检测“响应被中断但模型没有正常完成”的情况。
  */
-export function detectIncompleteResponse(params: {
-  stepResult: unknown;
-  assistantMessage: SessionMessageRecordV1 | null | undefined;
+export function detect_incomplete_response(params: {
+  step_result: unknown;
+  assistant_message: SessionMessageRecordV1 | null | undefined;
 }): {
   reason: string;
   details: JsonObject;
 } | null {
-  const record = toJsonObject(params.stepResult) || {};
+  const record = toJsonObject(params.step_result) || {};
   const finishReason =
     typeof record.finishReason === "string" ? record.finishReason : "";
   const rawFinishReason =
@@ -318,7 +318,7 @@ export function detectIncompleteResponse(params: {
   const toolCalls = Array.isArray(record.toolCalls) ? record.toolCalls : [];
   const toolResults = Array.isArray(record.toolResults) ? record.toolResults : [];
   const usage = toJsonObject(record.usage);
-  const incompleteToolParts = pickIncompleteToolParts(params.assistantMessage);
+  const incompleteToolParts = pickIncompleteToolParts(params.assistant_message);
 
   if (incompleteToolParts.length > 0) {
     return {
@@ -327,7 +327,7 @@ export function detectIncompleteResponse(params: {
         finishReason: finishReason || null,
         rawFinishReason: rawFinishReason || null,
         incompleteToolParts,
-        textPreview: toInlinePreview(text),
+        textPreview: to_inline_preview(text),
       },
     };
   }
@@ -353,7 +353,7 @@ export function detectIncompleteResponse(params: {
         finishReason,
         rawFinishReason: rawFinishReason || null,
         textLength: text.length,
-        textPreview: toInlinePreview(text),
+        textPreview: to_inline_preview(text),
         toolCallCount: toolCalls.length,
         toolResultCount: toolResults.length,
         inputTokens:
@@ -372,7 +372,7 @@ export function detectIncompleteResponse(params: {
       finishReason,
       rawFinishReason: rawFinishReason || null,
       textLength: text.length,
-      textPreview: toInlinePreview(text),
+      textPreview: to_inline_preview(text),
     },
   };
 }
@@ -380,10 +380,10 @@ export function detectIncompleteResponse(params: {
 /**
  * 检测“只有口头计划，没有真正执行”的续跑信号。
  */
-export function detectTextOnlyContinuationReason(
-  stepResult: unknown,
+export function detect_text_only_continuation_reason(
+  step_result: unknown,
 ): string | null {
-  const record = toJsonObject(stepResult) || {};
+  const record = toJsonObject(step_result) || {};
   const finishReason =
     typeof record.finishReason === "string" ? record.finishReason : "";
   const text = typeof record.text === "string" ? record.text.trim() : "";
@@ -403,7 +403,7 @@ export function detectTextOnlyContinuationReason(
 /**
  * 构造“text-only 续跑”提示。
  */
-export function buildTextOnlyContinuationNudge(
+export function build_text_only_continuation_nudge(
   continuationIndex: number,
 ): string {
   const round = Math.max(1, continuationIndex);

package/src/executor/core-engine/CoreEngineUiStreamCollector.ts

@@ -11,25 +11,25 @@ import type { streamText } from "ai";
 import type { Logger } from "@/utils/logger/Logger.js";
 import type { JsonObject } from "@/types/common/Json.js";
 import type { SessionMessageRecordV1 } from "@/executor/types/SessionRecords.js";
-import type { SessionUiMessageChunkCallback } from "@/executor/types/SessionRun.js";
-import { generateId } from "@/utils/Id.js";
+import type { SessionUiMessageChunkCallback } from "@/types/session/SessionExecution.js";
+import { generate_id } from "@/utils/Id.js";
 import {
-  summarizeUiMessageForDebug,
-  toInlinePreview,
+  summarize_ui_message_for_debug,
+  to_inline_preview,
 } from "@executor/core-engine/CoreEngineSignals.js";
 
 /**
  * 收敛 UI stream 中的最终 assistant 消息。
  */
-export async function collectFinalAssistantMessageFromUiStream(params: {
+export async function collect_final_assistant_message_from_ui_stream(params: {
   /**
    * 当前 `streamText` 执行结果。
    */
   result: ReturnType<typeof streamText>;
   /**
-   * 当前 sessionId，用于日志关联。
+   * 当前 session_id，用于日志关联。
    */
-  sessionId: string;
+  session_id: string;
   /**
    * 当前日志器。
    */
@@ -41,7 +41,7 @@ export async function collectFinalAssistantMessageFromUiStream(params: {
   /**
    * UI stream chunk 回调。
    */
-  onUiMessageChunkCallback?: SessionUiMessageChunkCallback;
+  on_ui_message_chunk_callback?: SessionUiMessageChunkCallback;
   /**
    * 当前 turn 的取消信号。
    *
@@ -49,7 +49,7 @@ export async function collectFinalAssistantMessageFromUiStream(params: {
    * - stop 触发后，UI stream 可能在 onFinish 前中断。
    * - 此时仍应尽量用已经收到的 text delta 构造可持久化 assistant 消息。
    */
-  abortSignal?: AbortSignal;
+  abort_signal?: AbortSignal;
 }): Promise<SessionMessageRecordV1> {
   let streamedAssistantMessage: SessionMessageRecordV1 | null = null;
   let uiFinishSummary: JsonObject | null = null;
@@ -59,13 +59,13 @@ export async function collectFinalAssistantMessageFromUiStream(params: {
   const uiStream = params.result.toUIMessageStream<SessionMessageRecordV1>({
     // 关键点（中文）：SDK stream 需要 reasoning 旁路事件时可直接消费；最终落盘仍由 responseMessage 收敛。
     originalMessages: [],
-    generateMessageId: () => `a:${params.sessionId}:${generateId()}`,
+    generateMessageId: () => `a:${params.session_id}:${generate_id()}`,
     messageMetadata: ({ part }) => {
       if (part.type !== "start" && part.type !== "finish") return undefined;
       return {
         v: 1,
         ts: Date.now(),
-        sessionId: params.sessionId,
+        session_id: params.session_id,
         source: "egress",
         kind: "normal",
       };
@@ -79,7 +79,7 @@ export async function collectFinalAssistantMessageFromUiStream(params: {
         isAborted: event.isAborted,
         finishReason:
           typeof event.finishReason === "string" ? event.finishReason : null,
-        ...summarizeUiMessageForDebug(event.responseMessage),
+        ...summarize_ui_message_for_debug(event.responseMessage),
       };
     },
   });
@@ -89,22 +89,22 @@ export async function collectFinalAssistantMessageFromUiStream(params: {
       if (chunk.type === "text-delta") {
         streamed_text += String(chunk.delta || "");
       }
-      if (typeof params.onUiMessageChunkCallback !== "function") continue;
+      if (typeof params.on_ui_message_chunk_callback !== "function") continue;
       try {
-        await params.onUiMessageChunkCallback(chunk);
+        await params.on_ui_message_chunk_callback(chunk);
       } catch (error) {
         callback_failed = true;
         throw error;
       }
     }
   } catch (error) {
-    if (callback_failed || !params.abortSignal?.aborted) {
+    if (callback_failed || !params.abort_signal?.aborted) {
       throw error;
     }
   }
 
   await params.logger.log("info", "[agent] ui.finish", {
-    sessionId: params.sessionId,
+    session_id: params.session_id,
     ...(uiFinishSummary || {
       responseMessageMissing: true,
     }),
@@ -123,9 +123,9 @@ export async function collectFinalAssistantMessageFromUiStream(params: {
   }
 
   await params.logger.log("warn", "[agent] final.message.fallback", {
-    sessionId: params.sessionId,
+    session_id: params.session_id,
     assistantTextLength: assistantText.length,
-    assistantTextPreview: toInlinePreview(assistantText),
+    assistantTextPreview: to_inline_preview(assistantText),
   });
 
   return params.buildFallbackAssistantMessage(

package/src/executor/ids/resolveSessionId.ts

@@ -1,14 +1,14 @@
 /**
- * 解析 sessionId。
+ * 解析 session_id。
  *
  * 优先级（中文）
- * 1) 显式参数 `input.sessionId`
+ * 1) 显式参数 `input.session_id`
  * 2) `DC_SESSION_ID`
  */
-export function resolveSessionId(input?: {
-  sessionId?: string;
+export function resolve_session_id(input?: {
+  session_id?: string;
 }): string | undefined {
-  const explicit = String(input?.sessionId || "").trim();
+  const explicit = String(input?.session_id || "").trim();
   if (explicit) return explicit;
 
   const envSessionId = String(process.env.DC_SESSION_ID || "").trim();

package/src/executor/messages/ChatMessageMarkup.ts

@@ -46,7 +46,7 @@ function parseTagAttributes(rawAttrs: string): Record<string, string> {
 /**
  * 归一化附件类型。
  */
-export function normalizeChatMessageFileType(value: unknown): ChatMessageFileType {
+export function normalize_chat_message_file_type(value: unknown): ChatMessageFileType {
   const text = normalizeText(value).toLowerCase();
   if (text === "photo" || text === "image") return "photo";
   if (text === "voice") return "voice";
@@ -58,7 +58,7 @@ export function normalizeChatMessageFileType(value: unknown): ChatMessageFileTyp
 /**
  * 提取 frontmatter metadata。
  */
-export function extractChatMessageFrontmatter(params: {
+export function extract_chat_message_frontmatter(params: {
   source: string;
 }): {
   metadata: Record<string, unknown>;
@@ -109,7 +109,7 @@ function toFileSegment(file: ChatMessageFileTag): ChatMessageFileSegment | null
     kind: "file",
     file: {
       path,
-      type: normalizeChatMessageFileType(file.type),
+      type: normalize_chat_message_file_type(file.type),
       ...(normalizeText(file.caption)
         ? { caption: normalizeText(file.caption) }
         : {}),
@@ -120,7 +120,7 @@ function toFileSegment(file: ChatMessageFileTag): ChatMessageFileSegment | null
 /**
  * 提取 `<file>` 标签，并保留正文/附件的真实顺序。
  */
-export function extractChatMessageSegments(source: string): ChatMessageSegment[] {
+export function extract_chat_message_segments(source: string): ChatMessageSegment[] {
   const out: ChatMessageSegment[] = [];
   const text = String(source || "");
 
@@ -139,7 +139,7 @@ export function extractChatMessageSegments(source: string): ChatMessageSegment[]
     const path = normalizeText(match[2] || attrs.path);
     const fileSegment = toFileSegment({
       path,
-      type: normalizeChatMessageFileType(attrs.type),
+      type: normalize_chat_message_file_type(attrs.type),
       ...(normalizeText(attrs.caption) ? { caption: normalizeText(attrs.caption) } : {}),
     });
     if (fileSegment) out.push(fileSegment);
@@ -154,8 +154,8 @@ export function extractChatMessageSegments(source: string): ChatMessageSegment[]
 /**
  * 提取 `<file>` 标签列表。
  */
-export function extractChatMessageFileTags(source: string): ChatMessageFileTag[] {
-  return extractChatMessageSegments(source)
+export function extract_chat_message_file_tags(source: string): ChatMessageFileTag[] {
+  return extract_chat_message_segments(source)
     .filter((segment): segment is ChatMessageFileSegment => segment.kind === "file")
     .map((segment) => segment.file);
 }
@@ -163,9 +163,9 @@ export function extractChatMessageFileTags(source: string): ChatMessageFileTag[]
 /**
  * 移除正文中的 `<file>` 标签，仅保留文本段。
  */
-export function stripChatMessageFileTags(source: string): string {
-  return buildChatMessageText({
-    segments: extractChatMessageSegments(source).filter(
+export function strip_chat_message_file_tags(source: string): string {
+  return build_chat_message_text({
+    segments: extract_chat_message_segments(source).filter(
       (segment): segment is ChatMessageTextSegment => segment.kind === "text",
     ),
   });
@@ -181,10 +181,10 @@ function normalizeTagAttributeValue(value: string, quote: '"' | "'"): string {
 /**
  * 渲染一条标准化 `<file>` 标签。
  */
-export function renderChatMessageFileTag(file: ChatMessageFileTag): string {
+export function render_chat_message_file_tag(file: ChatMessageFileTag): string {
   const path = normalizeText(file.path);
   if (!path) return "";
-  const type = normalizeChatMessageFileType(file.type);
+  const type = normalize_chat_message_file_type(file.type);
   const caption = normalizeText(file.caption);
   const quote: '"' | "'" = caption.includes('"') && !caption.includes("'") ? "'" : '"';
   const safeCaption = caption
@@ -196,15 +196,15 @@ export function renderChatMessageFileTag(file: ChatMessageFileTag): string {
 
 function renderChatMessageSegment(segment: ChatMessageSegment): string {
   if (segment.kind === "text") return normalizeText(segment.text);
-  return renderChatMessageFileTag(segment.file);
+  return render_chat_message_file_tag(segment.file);
 }
 
 /**
  * 把附件列表渲染回统一的 `<file>` 文本块。
  */
-export function buildChatMessageFileBlock(files: ChatMessageFileTag[]): string {
+export function build_chat_message_file_block(files: ChatMessageFileTag[]): string {
   return files
-    .map((file) => renderChatMessageFileTag(file))
+    .map((file) => render_chat_message_file_tag(file))
     .filter((item) => normalizeText(item).length > 0)
     .join("\n");
 }
@@ -212,18 +212,18 @@ export function buildChatMessageFileBlock(files: ChatMessageFileTag[]): string {
 /**
  * 把片段重建成统一消息文本。
  */
-export function buildChatMessageText(params: {
-  bodyText?: string;
+export function build_chat_message_text(params: {
+  body_text?: string;
   files?: ChatMessageFileTag[];
   segments?: ChatMessageSegment[];
 }): string {
   const segments = Array.isArray(params.segments)
     ? params.segments
     : [
-        ...(normalizeText(params.bodyText)
+        ...(normalizeText(params.body_text)
           ? [{
               kind: "text",
-              text: normalizeText(params.bodyText),
+              text: normalizeText(params.body_text),
             } satisfies ChatMessageTextSegment]
           : []),
         ...(Array.isArray(params.files)
@@ -243,14 +243,14 @@ export function buildChatMessageText(params: {
 /**
  * 统一解析一段 chat 消息文本。
  */
-export function parseChatMessageMarkup(source: string): ParsedChatMessageMarkup {
-  const extracted = extractChatMessageFrontmatter({
+export function parse_chat_message_markup(source: string): ParsedChatMessageMarkup {
+  const extracted = extract_chat_message_frontmatter({
     source: String(source || ""),
   });
-  const segments = extractChatMessageSegments(extracted.body);
+  const segments = extract_chat_message_segments(extracted.body);
   return {
     metadata: extracted.metadata,
-    bodyText: buildChatMessageText({
+    body_text: build_chat_message_text({
       segments: segments.filter(
         (segment): segment is ChatMessageTextSegment => segment.kind === "text",
       ),

package/src/executor/messages/ChatMessageMarkupTypes.ts

@@ -109,7 +109,7 @@ export interface ParsedChatMessageMarkup {
    * 说明（中文）
    * - 会把多段文本按消息原始顺序合并，中间使用空行分隔。
    */
-  bodyText: string;
+  body_text: string;
 
   /**
    * 按出现顺序提取出的附件标签列表。
@@ -127,36 +127,36 @@ export interface ParsedChatMessageMarkup {
  */
 export interface ChatMessageSendOptions {
   /**
-   * 目标 chatKey。
+   * 目标 chat_key。
    *
    * 说明（中文）
    * - 未提供时由调用方回退到当前上下文或显式参数。
    */
-  chatKey?: string;
+  chat_key?: string;
 
   /**
    * 延迟发送毫秒数。
    *
    * 说明（中文）
-   * - 由 `delay/delayMs/delay-ms` 解析得到。
+   * - 由 `delay/delay_ms/delay-ms` 解析得到。
    */
-  delayMs?: number;
+  delay_ms?: number;
 
   /**
    * 定时发送的绝对毫秒时间戳。
    *
    * 说明（中文）
-   * - 由 `time/sendAt/sendAtMs` 等字段解析得到。
+   * - 由 `time/sendAt/send_at_ms` 等字段解析得到。
    */
-  sendAtMs?: number;
+  send_at_ms?: number;
 
   /**
    * 是否使用 reply 语义发送。
    *
    * 说明（中文）
-   * - 允许仅设置布尔值，也允许结合 `messageId` 一起使用。
+   * - 允许仅设置布尔值，也允许结合 `message_id` 一起使用。
    */
-  replyToMessage?: boolean;
+  reply_to_message?: boolean;
 
   /**
    * 可选目标消息 ID。
@@ -164,5 +164,5 @@ export interface ChatMessageSendOptions {
    * 说明（中文）
    * - 当前主要用于 Telegram/Feishu reply 场景。
    */
-  messageId?: string;
+  message_id?: string;
 }

package/src/executor/messages/SessionAttachmentMapper.ts

@@ -21,7 +21,7 @@ import type {
   SessionRecordV1,
   SessionMessageRecordV1,
 } from "@/executor/types/SessionRecords.js";
-import { parseChatMessageMarkup } from "@/executor/messages/ChatMessageMarkup.js";
+import { parse_chat_message_markup } from "@/executor/messages/ChatMessageMarkup.js";
 
 /**
  * 从 `<file>` 标签中解析附件描述。
@@ -33,7 +33,7 @@ function parseAttachmentLinesFromText(text: string): Array<{
 }> {
   const raw = String(text || "");
   if (!raw.trim()) return [];
-  return parseChatMessageMarkup(raw).files.map((file) => ({
+  return parse_chat_message_markup(raw).files.map((file) => ({
     type: file.type,
     path: file.path,
     ...(typeof file.caption === "string" && file.caption.trim()
@@ -68,7 +68,7 @@ function buildDataUrl(mediaType: string, buffer: Buffer): string {
 }
 
 function resolveHydratableFilePath(
-  projectRoot: string | undefined,
+  project_root: string | undefined,
   rawPath: string,
 ): string | null {
   const raw = String(rawPath || "").trim();
@@ -76,7 +76,7 @@ function resolveHydratableFilePath(
   if (raw.startsWith("file://")) return fileURLToPath(raw);
   if (path.isAbsolute(raw)) return path.resolve(raw);
 
-  const root = path.resolve(String(projectRoot || "").trim() || process.cwd());
+  const root = path.resolve(String(project_root || "").trim() || process.cwd());
   const absPath = path.resolve(root, raw);
   const rel = path.relative(root, absPath);
   if (rel === "" || rel.startsWith("..") || path.isAbsolute(rel)) return null;
@@ -85,10 +85,10 @@ function resolveHydratableFilePath(
 
 async function hydrateFileUrlPart(
   part: FileUIPart,
-  projectRoot?: string,
+  project_root?: string,
 ): Promise<FileUIPart> {
   const url = String(part.url || "").trim();
-  const filePath = resolveHydratableFilePath(projectRoot, url);
+  const filePath = resolveHydratableFilePath(project_root, url);
   if (!filePath) return part;
   try {
     const buffer = await fs.readFile(filePath);
@@ -139,7 +139,7 @@ async function hydrateFileUrlPartStrict(
  * - 已经是 data URL 或远程 URL 的附件保持原样。
  * - 本地文件读取失败时直接报错，避免模型请求拿到不可访问的本地路径。
  */
-export async function hydrateUserPromptFileParts(
+export async function hydrate_user_prompt_file_parts(
   parts: SessionUserMessagePart[],
   project_root?: string,
 ): Promise<SessionUserMessagePart[]> {
@@ -167,15 +167,15 @@ export async function hydrateUserPromptFileParts(
 }
 
 /**
- * 将历史中的资源 file part 临时转换为模型可消费的 data URL。
+ * 将历史中的本地 file part 临时转换为模型可消费的 data URL。
  *
  * 关键点（中文）
  * - 该函数只修改本轮内存消息，不回写历史。
  * - 新历史保留 Agent 根目录相对路径，旧历史的 `file://` 仍继续兼容。
  */
-export async function hydrateFileUrlPartsForModel(
+export async function hydrate_file_url_parts_for_model(
   messages: SessionMessageRecordV1[],
-  projectRoot?: string,
+  project_root?: string,
 ): Promise<SessionMessageRecordV1[]> {
   if (!Array.isArray(messages) || messages.length === 0) return messages;
 
@@ -194,7 +194,7 @@ export async function hydrateFileUrlPartsForModel(
         nextParts.push(part);
         continue;
       }
-      const nextPart = await hydrateFileUrlPart(part as FileUIPart, projectRoot);
+      const nextPart = await hydrateFileUrlPart(part as FileUIPart, project_root);
       if (nextPart !== part) changed = true;
       nextParts.push(nextPart as SessionMessageRecordV1["parts"][number]);
     }
@@ -208,13 +208,13 @@ export async function hydrateFileUrlPartsForModel(
 /**
  * 在 user 消息上注入 FileUIPart，以便多模态模型直接消费本地附件。
  */
-export async function injectFilePartsFromAttachments(
+export async function inject_file_parts_from_attachments(
   messages: SessionMessageRecordV1[],
-  projectRoot?: string,
+  project_root?: string,
 ): Promise<SessionMessageRecordV1[]> {
   if (!Array.isArray(messages) || messages.length === 0) return messages;
 
-  const root = path.resolve(String(projectRoot || "").trim() || process.cwd());
+  const root = path.resolve(String(project_root || "").trim() || process.cwd());
   const out: SessionMessageRecordV1[] = [];
 
   for (const message of messages) {