From 885316c9909d83441dfe9af3880f6044c5a8301f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=A0=82=E5=90=89=E8=AF=83=E5=BE=B7=E6=8B=89=E6=9B=BC?=
 =?UTF-8?q?=E6=9F=A5=E7=9A=84=E8=8B=B1=E8=B1=AA?= <devhalo@163.com>
Date: Thu, 27 Aug 2026 15:01:02 +0800
Subject: [PATCH] =?UTF-8?q?AI=E9=9D=A2=E8=AF=95=20=E6=96=87=E5=AD=97?=
 =?UTF-8?q?=E8=BD=AC=E9=9F=B3=E9=A2=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/AIService/AIService.php                   |  3 ++-
 src/AIService/AiInterviewTtsInterface.php     | 25 +++++++++++++++++++
 .../JsonRpcInterface/FileServiceInterface.php |  6 +++++
 3 files changed, 33 insertions(+), 1 deletion(-)
 create mode 100644 src/AIService/AiInterviewTtsInterface.php

diff --git a/src/AIService/AIService.php b/src/AIService/AIService.php
index 61ed094..e963439 100644
--- a/src/AIService/AIService.php
+++ b/src/AIService/AIService.php
@@ -10,4 +10,5 @@ namespace Dhd\Micro\Interface\AIService;
 
 interface AIService extends
     AiEssayCheckInterface,
-    AiInterviewCheckInterface {}
+    AiInterviewCheckInterface,
+    AiInterviewTtsInterface {}
diff --git a/src/AIService/AiInterviewTtsInterface.php b/src/AIService/AiInterviewTtsInterface.php
new file mode 100644
index 0000000..35d1810
--- /dev/null
+++ b/src/AIService/AiInterviewTtsInterface.php
@@ -0,0 +1,25 @@
+<?php
+
+/**
+ * AI面试朗读(TTS)相关接口
+ */
+
+declare(strict_types=1);
+
+namespace Dhd\Micro\Interface\AIService;
+
+interface AiInterviewTtsInterface
+{
+    /**
+     * 朗读面试题（文字转语音）：懒生成并缓存，已存在则直接返回已有音频
+     * 音频按题目(question_id)生成并全局复用
+     * @param array $params 参数，['question_id'=>面试题ID]
+     */
+    public function interviewTtsAudio(array $params): array;
+
+    /**
+     * 查询面试题是否已生成音频，仅查缓存不触发合成（供取题接口附带音频使用）
+     * @param int $questionId 面试题ID
+     */
+    public function getInterviewQuestionAudioUrl(int $questionId): ?string;
+}
\ No newline at end of file
diff --git a/src/FileService/JsonRpcInterface/FileServiceInterface.php b/src/FileService/JsonRpcInterface/FileServiceInterface.php
index a83c4ed..7e3bdcf 100644
--- a/src/FileService/JsonRpcInterface/FileServiceInterface.php
+++ b/src/FileService/JsonRpcInterface/FileServiceInterface.php
@@ -27,4 +27,10 @@ interface FileServiceInterface
      * 获取文件列表
      */
     public function getFileList(array $params): array;
+
+    /**
+     * 保存二进制(base64)文件，用于服务端生成的文件
+     * @param array $params 参数，如 ['base64'=>.., 'file_name'=>.., 'file_type'=>.., 'group_id'=>.., 'channel'=>.., 'uploader_id'=>..]
+     */
+    public function saveBase64File(array $params): array;
 }