QA 1차 (커밋 6ab4c0d 검증) 에서 3건 AC 미충족 → 03-Developer 반려.
본 커밋은 그 3건을 해결한다.
AC6 — _AiSuggestButton 가시성 분기 분리:
- optIn=false → 숨김 유지
- optIn=true && !ready → 노출 + disabled + Tooltip("AI 도움을 먼저 켜주세요")
- optIn=true && ready → enabled
AC5 보완: 후보의 c.level 직접 전달 (이전 "나는" 휴리스틱 제거).
FrameSuggestionDialog.show 반환 타입 String? → FrameCandidate?.
AC4 — L2:2 + L3:1 분포 강제:
- few_shot prompt 에 "정확히 L2 2개 + L3 1개" 명시
- suggestFrame 결과를 _shapeDistribution(l2Quota=2, l3Quota=1) 로 후처리
- 부족분은 패딩 X (graceful: UI 가 더 적은 카드만 표시)
AC2 — 다운로드 진행률 + 일시정지/재개 UI:
- ModelDownloadController (StateNotifier<DownloadProgress?>)
· start() / pause() / resume() / cancel()
· pause() 는 subscription 만 cancel, .tmp + meta_kv 유지 → resume 시 Range header 로 이어받음
- AiSettingsController.setOptIn(true) → controller.start() 자동 호출
- SettingsScreen 에 _DownloadProgressTile 추가
· LinearProgressIndicator + bytes/total + 일시정지/재개/다시 시도 토글
회귀 테스트 9건 신규:
- test/ui/ai_suggest_button_visibility_test.dart (4): AC6 4상태 (hidden / disabled+tooltip × missing/downloading / enabled)
- test/state/model_download_controller_test.dart (3): opt-in→start, pause→paused, cancel→idle
- test/domain/ai/suggest_frame_test.dart (+3): AC4 분포 케이스 3개 (기존 take(3) 테스트 대체)
검증:
- flutter analyze → No issues found
- flutter test → 71 tests pass (62 → 71, +9 신규)
- flutter build apk --debug → 성공 (8.8s)
OQ-1 (모델 URL+SHA) 미해결 유지. MockLlmService 기본 주입 + placeholder URL 다운로드는 여전히 실패하지만, UI/스트림 wiring 은 모두 검증됨.
Refs #215
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
97 lines
3.3 KiB
Dart
97 lines
3.3 KiB
Dart
import '../models/frame_pattern.dart';
|
|
import '../models/habit.dart';
|
|
import 'frame_candidate.dart';
|
|
|
|
/// Builds the prompt string fed to the LLM. Pure — no I/O, no globals.
|
|
///
|
|
/// Strategy: pick top-N FramePattern by token-overlap with rawText. If no
|
|
/// match, fall back to first [maxFewShot] patterns. If patterns is empty,
|
|
/// emit a system+user prompt with no few-shot section (graceful).
|
|
String buildFewShotPrompt(
|
|
SuggestFrameInput input,
|
|
List<FramePatternModel> framePatterns, {
|
|
int maxFewShot = 5,
|
|
}) {
|
|
final tokens = _tokenize(input.rawText);
|
|
final scored = <MapEntry<FramePatternModel, int>>[];
|
|
for (final p in framePatterns) {
|
|
final score = _scorePattern(tokens, p);
|
|
if (score > 0) scored.add(MapEntry(p, score));
|
|
}
|
|
scored.sort((a, b) => b.value.compareTo(a.value));
|
|
|
|
List<FramePatternModel> selected;
|
|
if (scored.isNotEmpty) {
|
|
selected = scored.take(maxFewShot).map((e) => e.key).toList();
|
|
} else if (framePatterns.isNotEmpty) {
|
|
selected = framePatterns.take(maxFewShot).toList();
|
|
} else {
|
|
selected = const [];
|
|
}
|
|
|
|
final buf = StringBuffer();
|
|
buf.writeln(_systemPrompt());
|
|
if (selected.isNotEmpty) {
|
|
buf.writeln();
|
|
buf.writeln('# 변환 예시');
|
|
var i = 1;
|
|
for (final p in selected) {
|
|
buf.writeln('## 예시 $i');
|
|
buf.writeln('L0: ${p.l0Example}');
|
|
buf.writeln('L2: ${p.l2Suggestion}');
|
|
if (p.l3Identity != null) {
|
|
buf.writeln('L3: ${p.l3Identity}');
|
|
}
|
|
buf.writeln();
|
|
i += 1;
|
|
}
|
|
}
|
|
buf.writeln('# 사용자 입력');
|
|
buf.writeln('habit_type: ${input.habitType.dbValue}');
|
|
buf.writeln('raw_text: "${input.rawText}"');
|
|
if (input.anchorHint != null && input.anchorHint!.isNotEmpty) {
|
|
buf.writeln('anchor_hint: "${input.anchorHint}"');
|
|
} else {
|
|
buf.writeln('anchor_hint: 없음');
|
|
}
|
|
buf.writeln();
|
|
buf.writeln(
|
|
'위 raw_text 를 정확히 L2(조건부 긍정) 2개 + L3(정체성) 1개, 총 3개 후보로 '
|
|
'변환하세요. 순서는 L2 → L2 → L3. emit_frame_candidates 함수로 호출하세요.',
|
|
);
|
|
return buf.toString();
|
|
}
|
|
|
|
String _systemPrompt() => '''
|
|
당신은 Huberman 프로토콜을 따르는 한국어 코치입니다. 사용자가 입력한
|
|
raw_text 를 L2 (조건부 긍정 — "X 할 때 Y 한다") 또는 L3 (정체성 — "나는 ~ 인 사람이다")
|
|
프레임의 한국어 문장으로 변환합니다.
|
|
|
|
규칙:
|
|
- L0/L1 (회피·부정·금지 표현) 금지. "안", "끊다", "그만두다", "참는다" 사용 금지.
|
|
- 각 후보는 120자 이내.
|
|
- 의도가 명확하지 않으면 confidence 를 낮춥니다.
|
|
- 반드시 함수 emit_frame_candidates 를 호출해 JSON 으로 응답합니다.''';
|
|
|
|
List<String> _tokenize(String text) {
|
|
final normalized = text.trim();
|
|
if (normalized.isEmpty) return const [];
|
|
// Split on whitespace + Korean punctuation.
|
|
final parts = normalized.split(RegExp(r'[\s,.!?;:()\[\]"' "'" r'`/\\]+'));
|
|
return parts.where((t) => t.isNotEmpty).toList(growable: false);
|
|
}
|
|
|
|
int _scorePattern(List<String> tokens, FramePatternModel p) {
|
|
if (tokens.isEmpty) return 0;
|
|
var score = 0;
|
|
for (final t in tokens) {
|
|
if (t.contains(p.avoidanceKeyword) || p.avoidanceKeyword.contains(t)) {
|
|
score += 3;
|
|
}
|
|
if (p.domain != null && t.contains(p.domain!)) {
|
|
score += 1;
|
|
}
|
|
}
|
|
return score;
|
|
}
|