refactor(meeting): share the transcript polish prompt with tests

Move the polish instructions into their own module so the prompt the app
sends, the unit tests and the local-model probe use the same text. Tests
now pin the two rules that matter: fix a misheard name or in-house term to
the learned spelling, and never swap an ordinary word on similarity alone.

Verified against the local model with the real learned corpus: 하람록에 was
rewritten to HaramLog에 and the dictionary pronunciation 디에로 to D3RO,
while a natural sentence with no learned term came back with no word
substitutions. Recorded the trap that this model returns empty content
unless thinking is disabled.
This commit is contained in:
Yun Chan 2026-11-06 21:47:16 +09:00
parent 63e741b232
commit 648c7e4f4d
4 changed files with 65 additions and 22 deletions

View file

@ -58,6 +58,7 @@ import {
import { markdownToDocx } from '@d3ro/core/utils/markdown-to-docx'
import { getFileTranscriptionService } from './FileTranscriptionService'
import { getTranscriptGlossaryService } from './TranscriptGlossaryService'
import { buildPolishTranscriptPrompt } from './meeting/polish-prompt'
import { buildImportedMeetingTranscript } from './meeting/imported-recording'
import type {
MeetingModeState,
@ -95,26 +96,6 @@ const TRANSCRIPTION_FAILED_MESSAGE = 'Transcription failed during recording'
/** 자막 인식 실패를 렌더러에 다시 알리는 최소 간격 */
const CAPTION_FAILURE_NOTICE_INTERVAL_MS = 30_000
/**
* 전사 AI 교열(다듬기) 지시문.
*
* 사용자가 학습시킨 용어로 「잘못 들은 단어」를 반드시 고치게 하되, 근거 없는 일반 단어 교체는 금지한다.
* 한글 어절을 1자모 거리로 기계적으로 바꾸면 정상 문장이 망가지는 것을 실측했으므로(MTG-14),
* 단어 교체 판단은 문맥을 보는 모델에게 맡기고 근거(용어·표현 목록)를 함께 준다.
*/
const POLISH_TRANSCRIPT_PROMPT = [
'다음 음성 전사 텍스트를 회의록으로 다듬습니다.',
'',
'## 반드시 지킬 것',
'- 필러(음, 어, 그, 아, 뭐 등)·말 바꾸기(A 아니 A가 아니라 B → B)·불필요한 어절·의미 중복을 제거하세요.',
'- 아래 [사용자 용어]·[사용자가 자주 쓰는 용어]와 같은 이름·제품명·사내 용어가 전사에서 비슷하게 다르게 적혀 있고 문맥상 그것이 확실하면, **반드시 그 표기로 고치세요.**',
'- 이미 맞게 적힌 용어는 그대로 두세요.',
'- 반대로, 근거가 없는 일반 명사·부사·조사·어미는 절대 다른 단어로 바꾸지 마세요. 비슷하게 들린다는 이유만으로 단어를 바꾸면 문장이 망가집니다.',
'- 확실하지 않으면 원문을 그대로 두세요.',
'- 화자의 말투(반말/존댓말)와 의미·내용은 바꾸지 마세요. 타임스탬프 [MM:SS]와 화자 표기([화자 N] 등)는 그대로 유지하세요.',
'- [사용자가 실제로 쓰는 표현]은 말투·용어 참고용입니다. 그 문장을 그대로 옮겨 쓰지 마세요.',
].join('\n')
/**
* 회의 기능이 쓰는 LLM 포트 — 백엔드 선택(local/online, 폴백)은 LlmGateway 한 곳이 정한다.
* 문서 생성·요약 입력은 이 한도(프록시 메시지 한도) 안으로 맞춘다.
@ -1462,7 +1443,7 @@ class MeetingModeService extends EventEmitter {
const polished = await this._rewriteTranscriptInChunks(
llm,
preCorrected.text,
POLISH_TRANSCRIPT_PROMPT + (glossary ? `\n\n${glossary}` : ''),
buildPolishTranscriptPrompt({ glossary }),
ErrorCode.MeetingPolishFailed,
)

View file

@ -0,0 +1,26 @@
// src/main/services/meeting/polish-prompt.ts
// 전사 AI 교열(다듬기) 지시문의 정본.
//
// 사용자가 학습시킨 용어로 「잘못 들은 단어」를 반드시 고치게 하되, 근거 없는 일반 단어 교체는 금지한다.
// 한글 어절을 1자모 거리로 기계적으로 바꾸면 정상 문장이 망가지는 것을 실측했으므로(MTG-14),
// 단어 교체 판단은 문맥을 보는 모델에게 맡기고 근거(용어·표현 목록)를 함께 준다.
/** 교열 규칙 본문 — 글로서리 블록과 분리해 테스트·프로브가 같은 문장을 쓴다. */
export const POLISH_TRANSCRIPT_RULES = [
'다음 음성 전사 텍스트를 회의록으로 다듬습니다.',
'',
'## 반드시 지킬 것',
'- 필러(음, 어, 그, 아, 뭐 등)·말 바꾸기(A 아니 A가 아니라 B → B)·불필요한 어절·의미 중복을 제거하세요.',
'- 아래 [사용자 용어]·[사용자가 자주 쓰는 용어]와 같은 이름·제품명·사내 용어가 전사에서 비슷하게 다르게 적혀 있고 문맥상 그것이 확실하면, **반드시 그 표기로 고치세요.**',
'- 이미 맞게 적힌 용어는 그대로 두세요.',
'- 반대로, 근거가 없는 일반 명사·부사·조사·어미는 절대 다른 단어로 바꾸지 마세요. 비슷하게 들린다는 이유만으로 단어를 바꾸면 문장이 망가집니다.',
'- 확실하지 않으면 원문을 그대로 두세요.',
'- 화자의 말투(반말/존댓말)와 의미·내용은 바꾸지 마세요. 타임스탬프 [MM:SS]와 화자 표기([화자 N] 등)는 그대로 유지하세요.',
'- [사용자가 실제로 쓰는 표현]은 말투·용어 참고용입니다. 그 문장을 그대로 옮겨 쓰지 마세요.',
].join('\n')
/** 글로서리 블록(`buildGlossaryPromptSection`)을 규칙 뒤에 붙인 최종 시스템 프롬프트. */
export function buildPolishTranscriptPrompt(input: { glossary?: string } = {}): string {
const glossary = input.glossary?.trim()
return glossary ? `${POLISH_TRANSCRIPT_RULES}\n\n${glossary}` : POLISH_TRANSCRIPT_RULES
}