[v1.8.0] 배포 준비 — 가이드 문서 갱신 및 암호화
DEVELOPMENT.md v1.8.0 항목 상세 보완: - Phase 17-B: TaskStateService JSON 영속화 + AgentEventLog JSONL 7종 이벤트 정확히 기술 - Phase 17-C: ExtendedHookRunner 18종 이벤트 + Prompt/Command/Http 3타입 상세 기술 - Phase 17-D: PathBasedSkillActivator + context:fork DI 콜백 주입 방식 기술 - Phase 17-E: HierarchicalMemoryService 4-layer + AxMdIncludeResolver + PathScopedRuleInjector 정확히 기술 - Phase 17-F: PermissionDecisionService Chain 5단계 + EvaluateToolPermission 3종 결정 기술 - Phase 17-G: DiffTracker CaptureOriginalFileContent + ToolRiskMapper 위험도 태그 기술 개발자 가이드 v1.8.0 버전 이력 항목 추가 (15개 신기능): - 자기성찰 메모리, 세션 상태 영속화, 훅 시스템, 스킬 fork - 경로 기반 스킬/규칙, 계층 메모리, 권한 시스템, 멀티파일 Diff - 사내/사외 모드, 멀티에이전트, AI 스니펫, 퀵링크, 알림 센터 사용자 가이드: 개발자 가이드에서 버전 이력 섹션 제거 후 재생성 암호화: guide_dev.enc + guide_user.enc 재생성 (AES-256-CBC) 빌드: 경고 0, 오류 0 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -905,6 +905,32 @@ Ollama의 모든 모델이 도구 사용을 지원하지는 않습니다. 아래
|
||||
<!-- 푸터 -->
|
||||
<!-- ══════════════════════════════════════════════════════════ -->
|
||||
|
||||
<!-- v1.8.0 -->
|
||||
<div class="version-entry" style="border-left:3px solid #6366F1; background:linear-gradient(90deg,#6366F110,transparent);">
|
||||
<div class="version-meta">
|
||||
<div class="version-badge" style="background:#6366F1; color:#fff;">v1.8.0</div>
|
||||
</div>
|
||||
<div class="version-changes">
|
||||
<ul>
|
||||
<li><strong>에이전트 인프라 전면 고도화</strong> — Claude Code 아키텍처 기반 Phase 17 전 구간(A~G) 완료</li>
|
||||
<li><strong>자기성찰 메모리</strong> — 성공·실패 경험을 기록하고 동일 유형 작업 시 자동 참고합니다</li>
|
||||
<li><strong>세션 상태 영속화</strong> — 대화 압축 후에도 작업 상태와 참조 파일 목록이 유지됩니다</li>
|
||||
<li><strong>훅 시스템 고도화</strong> — 18종 라이프사이클 이벤트. AI 보안 검사(Prompt 훅)로 위험 명령 차단 가능</li>
|
||||
<li><strong>스킬 fork 실행</strong> — 스킬을 격리된 AI 컨텍스트에서 실행하여 메인 대화 오염 방지</li>
|
||||
<li><strong>경로 기반 스킬/규칙 자동 주입</strong> — 작업 파일에 따라 관련 스킬과 코딩 규칙이 자동 적용됩니다</li>
|
||||
<li><strong>계층 메모리 통합</strong> — 전사·개인·프로젝트·로컬 4단계 AX.md를 병합하여 컨텍스트로 자동 주입</li>
|
||||
<li><strong>권한 시스템 고도화</strong> — acceptEdits 모드: 파일 편집 자동 승인. 패턴 기반 허용/차단 규칙 지원</li>
|
||||
<li><strong>멀티파일 Diff 추적</strong> — 에이전트가 수정한 파일 변경 내역을 세션 단위로 추적·표시</li>
|
||||
<li><strong>도구 위험도 표시</strong> — 실행 중인 도구의 위험도(높음/보통)를 실시간으로 표시합니다</li>
|
||||
<li><strong>사내/사외 네트워크 모드</strong> — 기본 사내 모드에서 외부 인터넷 접속 차단. 사외 모드 전환 시 인증 필요</li>
|
||||
<li><strong>멀티에이전트 팀</strong> — 코드·문서·보안·리서치 특화 서브에이전트에 작업 위임 가능</li>
|
||||
<li><strong>AI 스니펫</strong> — 업무 이메일·요약·번역·코드리뷰 등 자주 쓰는 AI 작업을 단축 명령으로 즉시 실행</li>
|
||||
<li><strong>파라미터 퀵링크</strong> — 자주 여는 URL에 변수를 넣어 검색어·번호 등을 바로 전달</li>
|
||||
<li><strong>알림 센터</strong> — 에이전트·시스템 알림을 타입별(정보/성공/경고/오류)로 분류·관리</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- v1.7.2 -->
|
||||
<div class="version-entry" style="border-left:3px solid #22C55E; background:linear-gradient(90deg,#22C55E10,transparent);">
|
||||
<div class="version-meta">
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
<!DOCTYPE html>
|
||||
<!DOCTYPE html>
|
||||
<html lang="ko">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
@@ -344,7 +344,9 @@ td {
|
||||
<li><a href="#sec-symbol" style="color:#fff;text-decoration:none;font-weight:600;">⚡ 특수 기호 예약어</a></li>
|
||||
<li><a href="#sec-keyword" style="color:#fff;text-decoration:none;font-weight:600;">📝 영문 키워드 예약어</a></li>
|
||||
<li><a href="#sec-tips" style="color:#fff;text-decoration:none;font-weight:600;">💡 유용한 팁</a></li>
|
||||
<li><a href="#sec-models" style="color:#fff;text-decoration:none;font-weight:600;">🧠 AI 모델 호환성</a></li>
|
||||
<li><a href="#sec-settings" style="color:#fff;text-decoration:none;font-weight:600;">⚙️ 설정 기능 탭</a></li>
|
||||
<li><a href="#sec-version" style="color:#fff;text-decoration:none;font-weight:600;">📋 버전 이력</a></li>
|
||||
</ol>
|
||||
</div>
|
||||
|
||||
@@ -737,6 +739,90 @@ td {
|
||||
<span class="kw">info disk</span>에서 드라이브 항목을 Enter하면 탐색기로 바로 열립니다.
|
||||
</div>
|
||||
|
||||
<!-- ══════════════════════════════════════════════════════════ -->
|
||||
<!-- AI 모델 호환성 -->
|
||||
<!-- ══════════════════════════════════════════════════════════ -->
|
||||
<h2 id="sec-models" class="section-title">🧠 AI 모델 호환성 — 도구 사용(Function Calling) 지원 현황</h2>
|
||||
<p class="section-desc">
|
||||
AX Agent의 Cowork/Code 탭은 <strong>도구 사용(Function Calling)</strong>을 통해 파일 읽기/쓰기, 문서 생성, 코드 실행 등을 수행합니다.<br>
|
||||
도구 사용을 지원하지 않는 모델에서는 Cowork/Code 기능이 정상 동작하지 않으며, Chat 탭의 일반 대화만 가능합니다.
|
||||
</p>
|
||||
|
||||
<h3 style="font-size:16px;font-weight:700;margin:20px 0 10px;color:#1e293b;">☁️ 클라우드 서비스 (모두 도구 사용 지원)</h3>
|
||||
<div class="table-wrap">
|
||||
<table>
|
||||
<thead><tr>
|
||||
<th class="hd-dark" style="width:120px">서비스</th>
|
||||
<th class="hd-dark">모델</th>
|
||||
<th class="hd-dark" style="width:100px">도구 사용</th>
|
||||
<th class="hd-dark" style="width:100px">컨텍스트</th>
|
||||
</tr></thead>
|
||||
<tbody>
|
||||
<tr><td>Claude</td><td>claude-sonnet-4, claude-opus-4</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>200K</td></tr>
|
||||
<tr><td>Claude</td><td>claude-haiku-3.5</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>200K</td></tr>
|
||||
<tr><td>Gemini</td><td>gemini-2.5-pro, gemini-2.5-flash</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>1M</td></tr>
|
||||
<tr><td>Gemini</td><td>gemini-2.0-flash</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>1M</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<h3 style="font-size:16px;font-weight:700;margin:20px 0 10px;color:#1e293b;">🏠 Ollama 로컬 모델 — 도구 사용 지원 여부</h3>
|
||||
<p style="font-size:13px;color:#64748b;margin-bottom:10px;">
|
||||
Ollama의 모든 모델이 도구 사용을 지원하지는 않습니다. 아래 표에서 ✅ 표시된 모델만 Cowork/Code 탭에서 사용 가능합니다.
|
||||
</p>
|
||||
<div class="table-wrap">
|
||||
<table>
|
||||
<thead><tr>
|
||||
<th class="hd-dark" style="width:180px">모델</th>
|
||||
<th class="hd-dark" style="width:100px">도구 사용</th>
|
||||
<th class="hd-dark" style="width:100px">파라미터</th>
|
||||
<th class="hd-dark">비고</th>
|
||||
</tr></thead>
|
||||
<tbody>
|
||||
<tr style="background:#f0fdf4;"><td><strong>qwen2.5</strong></td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>7B ~ 72B</td><td>⭐ <strong>가장 추천</strong> — 한국어 + 도구 사용 안정적</td></tr>
|
||||
<tr style="background:#f0fdf4;"><td><strong>qwen3</strong></td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>8B ~ 32B</td><td>최신 모델, 도구 지원 우수</td></tr>
|
||||
<tr style="background:#f0fdf4;"><td><strong>qwen2.5-coder</strong></td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>7B ~ 32B</td><td>⭐ Code 탭 추천 — 코드 특화 + 도구</td></tr>
|
||||
<tr><td>llama3.1</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>8B / 70B</td><td>Meta 공식 도구 지원</td></tr>
|
||||
<tr><td>llama3.3</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>70B</td><td>도구 호출 개선 버전</td></tr>
|
||||
<tr><td>mistral</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>7B</td><td>경량, 기본적인 도구 지원</td></tr>
|
||||
<tr><td>mistral-nemo</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>12B</td><td>도구 지원 개선</td></tr>
|
||||
<tr><td>command-r</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>35B</td><td>Cohere, 도구 특화</td></tr>
|
||||
<tr><td>firefunction-v2</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>70B</td><td>Function Calling 특화</td></tr>
|
||||
<tr><td>granite3</td><td style="color:#16a34a;font-weight:bold;">✅ 지원</td><td>2B / 8B</td><td>IBM, 경량 도구 지원</td></tr>
|
||||
<tr style="background:#fef2f2;"><td>deepseek-r1</td><td style="color:#dc2626;font-weight:bold;">❌ 미지원</td><td>다양</td><td>추론 특화, 도구 호출 불가</td></tr>
|
||||
<tr style="background:#fef2f2;"><td>phi3 / phi4</td><td style="color:#dc2626;font-weight:bold;">❌ 미지원</td><td>3B ~ 14B</td><td>도구 미지원</td></tr>
|
||||
<tr style="background:#fef2f2;"><td>gemma2</td><td style="color:#dc2626;font-weight:bold;">❌ 미지원</td><td>9B / 27B</td><td>도구 미지원</td></tr>
|
||||
<tr style="background:#fef2f2;"><td>codellama</td><td style="color:#dc2626;font-weight:bold;">❌ 미지원</td><td>7B ~ 70B</td><td>코드 특화이나 도구 미지원</td></tr>
|
||||
<tr style="background:#fef2f2;"><td>llava / bakllava</td><td style="color:#dc2626;font-weight:bold;">❌ 미지원</td><td>다양</td><td>비전 특화</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<h3 style="font-size:16px;font-weight:700;margin:20px 0 10px;color:#1e293b;">💡 사내 환경 추천 조합</h3>
|
||||
<div class="table-wrap">
|
||||
<table>
|
||||
<thead><tr>
|
||||
<th class="hd-dark" style="width:150px">용도</th>
|
||||
<th class="hd-dark" style="width:180px">추천 모델</th>
|
||||
<th class="hd-dark" style="width:100px">VRAM</th>
|
||||
<th class="hd-dark">설명</th>
|
||||
</tr></thead>
|
||||
<tbody>
|
||||
<tr><td>Cowork (문서 작성)</td><td><strong>qwen2.5:32b</strong> 이상</td><td>24GB+</td><td>한국어 품질과 도구 사용 모두 우수</td></tr>
|
||||
<tr><td>Code (코드 작성)</td><td><strong>qwen2.5-coder:32b</strong></td><td>24GB+</td><td>코드 특화 + 도구 지원</td></tr>
|
||||
<tr><td>경량 (GPU 부족)</td><td><strong>qwen2.5:7b</strong> 또는 <strong>granite3:8b</strong></td><td>8GB</td><td>기본적인 도구 사용 가능</td></tr>
|
||||
<tr><td>최고 품질 (로컬)</td><td><strong>qwen3:32b</strong> 또는 <strong>llama3.3:70b</strong></td><td>24~48GB+</td><td>대규모 문서/코드 작업에 적합</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<div class="info-box" style="background:linear-gradient(135deg,#1e1e3f 0%,#2d1b69 100%); color:#e2e8f0; border:1px solid #4338ca;">
|
||||
<strong style="color:#fbbf24;">⚠️ 도구 미지원 모델 사용 시</strong><br>
|
||||
도구 사용을 지원하지 않는 모델을 Cowork/Code 탭에서 사용하면 <code style="background:#4338ca55;padding:2px 6px;border-radius:4px;">400 BadRequest</code> 에러가 발생합니다.<br>
|
||||
이 경우 AX Copilot이 자동으로 일반 텍스트 응답으로 전환하지만, 파일 생성·코드 실행 등의 에이전트 기능은 사용할 수 없습니다.<br>
|
||||
<span style="color:#60a5fa;">Chat 탭의 일반 대화는 모든 모델에서 정상 동작합니다.</span>
|
||||
</div>
|
||||
|
||||
<!-- ══════════════════════════════════════════════════════════ -->
|
||||
<!-- 6. 설정 기능 토글 -->
|
||||
<!-- ══════════════════════════════════════════════════════════ -->
|
||||
@@ -815,6 +901,11 @@ td {
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<!-- ══════════════════════════════════════════════════════════ -->
|
||||
<!-- 푸터 -->
|
||||
<!-- ══════════════════════════════════════════════════════════ -->
|
||||
|
||||
|
||||
|
||||
<!-- ══════════════════════════════════════════════════════════ -->
|
||||
<!-- 푸터 -->
|
||||
|
||||
Binary file not shown.
Binary file not shown.
Reference in New Issue
Block a user