Files
AX-Copilot-Codex/docs/SEMINAR.md

291 lines
13 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AX Copilot 湲곗닠 ?몃???### ?щ궡 AI ?앹궛???뚮옯?????꾪궎?띿쿂?€ ?듭떖 湲곗닠
> **諛쒗몴 ?€??*: ?щ궡 媛쒕컻?€ / AI ?곌뎄?€
> **踰꾩쟾**: v1.6.1 湲곗? (2026??3??
> **諛쒗몴??*: AX?곌뎄??AI?€
---
## 1. AX Copilot ?대??
> **"Alt+Space ??踰덉쑝濡?紐⑤뱺 ?낅Т ?꾧뎄???묎렐?섎뒗 ?щ궡 ?꾩슜 AI ?뚮옯??**
### ??媛€吏€ ?쒗뭹?쇰줈 援ъ꽦
| ?쒗뭹紐?| ??븷 | 二쇱슂 湲곕뒫 |
|--------|------|-----------|
| **AX Commander** | 湲€濡쒕쾶 ?곗쿂 | 紐낅졊 寃€?? ?꾧뎄 ?ㅽ뻾, ?먮룞??|
| **AX Agent** | AI ?€???붿쭊 | Chat / Cowork / Code 3??|
| **AX Copilot** | ?듯빀 ?뚮옯??| ?????쒗뭹 + ?ㅼ젙쨌蹂댁븞 ?듯빀 |
### ???곗뒪?ы깙 ?깆씤媛€? ??2026??AI ?꾧뎄??諛⑺뼢
> **"釉뚮씪?곗? ?덉쓽 AI"?먯꽌 "??PC?먯꽌 吏곸젒 ?€吏곸씠??AI"濡??꾪솚 以?*
2024~2025??AI ?쒕퉬?ㅻ뱾?€ ??梨꾪똿(ChatGPT, Sigmoid.ai)??二쇰쪟?€吏€留?
2026???꾩옱 **二쇱슂 AI 肄붾뵫 ?쒕퉬?ㅺ? 紐⑤몢 ?곗뒪?ы깙 ???곕????ㅼ씠?곕툕**濡??꾪솚?덉뒿?덈떎:
| ?쒕퉬??| ?뺥깭 | 濡쒖뺄 ?뚯씪 ?묎렐 |
|--------|------|:------------:|
| **Claw Code** | ?곕???CLI (?ъ슜??PC?먯꽌 吏곸젒 ?ㅽ뻾) | ???뚯씪 ?쎄린/?곌린/?ㅽ뻾 |
| **Cursor** | ?곗뒪?ы깙 IDE (Electron 湲곕컲) | ???꾨줈?앺듃 ?꾩껜 遺꾩꽍 |
| **Windsurf** | ?곗뒪?ы깙 IDE (VS Code ?ы겕) | ??48?쒓컙 ?먮룞 ?몃뜳??|
| **GitHub Copilot** | VS Code ?뺤옣 ???낅┰ ?먯씠?꾪듃 | ??濡쒖뺄 Git ?곕룞 |
| **Raycast** | ?곗뒪?ы깙 ?곗쿂 (macOS ?ㅼ씠?곕툕) | ???굿룻뙆?셋룻겢由쎈낫???듯빀 |
**怨듯넻 ?⑦꽩**: AI媛€ ?ㅼ젣濡??좎슜?섎젮硫?**?ъ슜?먯쓽 ?ㅼ젣 ?뚯씪???쎄퀬, ?섏젙?섍퀬, ?ㅽ뻾**?댁빞 ?⑸땲??
??釉뚮씪?곗??먯꽌???닿쾬??遺덇??ν븯誘€濡? 紐⑤뱺 ?쒕퉬?ㅺ? ?곗뒪?ы깙/?곕??먮줈 ?대젮?붿뒿?덈떎.
**AX Copilot?€ ???먮쫫???뺤쨷?숈뿉 ?꾩튂?⑸땲??**
- ?뼢截?**?곗뒪?ы깙 ?ㅼ씠?곕툕** ??WPF ?깆씠 OS ?덈꺼?먯꽌 ?뚯씪쨌?꾨줈?몄뒪쨌?대┰蹂대뱶??吏곸젒 ?묎렐
- ?⑨툘 **湲€濡쒕쾶 ?곗쿂** ??Alt+Space ??踰덉쑝濡??대뼡 ???꾩뿉?쒕뱺 利됱떆 ?몄텧
- ?쨼 **?먯씠?꾪듃 ?꾧뎄 52媛?* ???뚯씪 ?쎄린/?곌린, 肄붾뱶 ?ㅽ뻾, Git, 臾몄꽌 ?앹꽦??AI媛€ 吏곸젒 ?섑뻾
### ?듭떖 ?ㅺ퀎 ?먯튃
- ?룫 **?щ궡 ?꾩슜** ???몃? ?쒕쾭 ?섏〈 ?놁쓬, ?붾젅硫뷀듃由??놁쓬
- ?뮶 **濡쒖뺄 ?곗꽑** ??紐⑤뱺 ?곗씠?곕뒗 `%APPDATA%\AxCopilot\`???€??- ?뵏 **蹂댁븞** ??AES-256 ?ㅼ젙 ?뷀샇?? ??났??諛⑹?
- ?벀 **?몄뒪?⑤윭 150MB ?댄븯** ??.NET 8 ?고????댁옣 ?⑥씪 諛고룷
---
## 2. ?꾩껜 ?꾪궎?띿쿂
```
?뚢??€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€???? App.xaml.cs (吏꾩엯?? ???? ?쒕퉬??珥덇린??쨌 ?몃젅???꾩씠肄?쨌 ?꾩뿭 ??愿€由? ???붴??€?€?€?€?€?€?€?р??€?€?€?€?€?€?€?€?€?€?€?€?€?р??€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?? ?? ???뚢??€?€?€?€?€?€?€?쇄??€?€?€?€?€?€?? ?뚢??€?€?쇄??€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€???? AX Commander ?? ?? AX Agent ???? (?곗쿂 WPF) ?? ?? (Chat / Cowork / Code) ???붴??€?€?€?€?€?€?€?р??€?€?€?€?€?€?? ?붴??€?€?р??€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?? ?? ???뚢??€?€?€?€?€?€?€?쇄??€?€?€?€?€?€?€?€?€?€?€?€?€?쇄??€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€???? 怨듯넻 ?쒕퉬??怨꾩링 ???? SettingsService 쨌 LogService 쨌 IndexService ???? CryptoService 쨌 McpClientService 쨌 LLMRouter ???붴??€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€??```
### 湲곗닠 ?ㅽ깮
| 怨꾩링 | 湲곗닠 |
|------|------|
| UI | WPF (.NET 8), WinForms (?몃젅?? |
| ?몄뼱 | C# 12, XAML |
| ?곗씠??| JSON 吏곷젹??(System.Text.Json) |
| 寃€??| TF-IDF + SQLite (肄붾뱶), ?쇱? ?붿쭊 (?곗쿂) |
| AI | Ollama쨌vLLM (?щ궡), Gemini쨌Sigmoid (?몃? ?듭뀡) |
| ?꾨줈?좎퐳 | MCP (Model Context Protocol) |
---
## 3. AX Commander ???곗쿂 湲곗닠
### ?낅젰 ??寃곌낵 泥섎━ ?뚯씠?꾨씪??
```
?ъ슜???낅젰
?? ??CommandResolver (?꾨━?쎌뒪 ?쇱슦??
?? ?쒋??€ ?꾨━?쎌뒪 留ㅼ묶 ?€?€??44媛??몃뱾???ㅽ뻾
?? = 怨꾩궛湲? ; ?ㅻ땲?? # ?대┰蹂대뱶
?? @ URL 蹂꾩묶 ~ ?대뜑 $ ?대┰蹂대뱶 蹂€?? ?? ! ?뚰겕?ㅽ럹?댁뒪 / ?쒖뒪??紐낅졊
?? color쨌date쨌emoji쨌port쨌json쨌encode ?? ?? ?붴??€ ?꾨━?쎌뒪 ?놁쓬 ?€?€??FuzzyEngine
(?쒓뎅??珥덉꽦 + ?쇱? 留ㅼ묶)
```
### FuzzyEngine ?듭떖 ?뚭퀬由ъ쬁
```
?낅젰: "?ㅼ젙"
??珥덉꽦 異붿텧: "?끹뀍"
??LCS(理쒖옣 怨듯넻 遺€遺??섏뿴) 湲곕컲 ?먯닔 怨꾩궛
???ъ슜 鍮덈룄 媛€以묒튂 ?곸슜 (UsageRankingService)
???뺣젹 ??寃곌낵 諛섑솚
```
### 二쇱슂 ?몃뱾??移댄깉濡쒓렇 (44醫?
| 移댄뀒怨좊━ | ?몃뱾??| 湲곕뒫 |
|----------|--------|------|
| 媛쒕컻 ?꾧뎄 | json, encode, port, color | JSON 寃€利? ?몄퐫?? ?ы듃 議고쉶, ?됱긽 蹂€??|
| ?뚯씪/?쒖뒪??| recent, rename, scaffold, svc | 理쒓렐 ?뚯씪, ?쇨큵 ?대쫫蹂€寃? ?꾨줈?앺듃 ?앹꽦 |
| ?앹궛??| note, snippet, date, stats | 硫붾え, ?ㅻ땲?? ?좎쭨 怨꾩궛, ?띿뒪??遺꾩꽍 |
| UI/?붾㈃ | cap, snap, pick | ?붾㈃ 罹≪쿂, 李?諛곗튂, ?됱긽 異붿텧 |
| ?뚰겕?ㅽ럹?댁뒪 | !, workspace | 22媛??덉씠?꾩썐, ?꾨줈?뚯씪 ?€??蹂듭썝 |
---
## 4. AX Agent ??AI ?€???붿쭊
### ?먯씠?꾪듃 猷⑦봽 (AgentLoopService)
```
?ъ슜??硫붿떆吏€
?? ???뚢??€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€???? ?먯씠?꾪듃 猷⑦봽 (諛섎났) ???? ???? 1. LLM API ?몄텧 ???? 2. ?묐떟 ?뚯떛 ???? 3. ?꾧뎄 ?몄텧 媛먯? ???? 4. ?꾧뎄 ?ㅽ뻾 ?귘뾼?€?€?€?€ 52媛??꾧뎄
?? 5. 寃곌낵 ??而⑦뀓?ㅽ듃 異붽? ???? 6. 紐⑺몴 ?ъ꽦? ??醫낅즺 ???붴??€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?? ?? ??理쒖쥌 ?묐떟 ?ㅽ듃由щ컢 異쒕젰 (SSE)
```
### 3媛??€????쓽 ?뱀꽦
| ??| 紐⑹쟻 | ?쒖뒪???꾨\?꾪듃 | 二쇱슂 ?꾧뎄 |
|----|------|----------------|-----------|
| **Chat** | ?쇰컲 AI ?€??| 踰붿슜 ?댁떆?ㅽ꽩??| 湲곕낯 ?꾧뎄 |
| **Cowork** | ?낅Т ?먮룞??| 20媛??꾨━???뱁솕 | 臾몄꽌쨌?곗씠???꾧뎄 |
| **Code** | 媛쒕컻 吏€??| 肄붾뵫 ?먯씠?꾪듃 | LSP쨌Git쨌鍮뚮뱶 ?꾧뎄 |
### 而⑦뀓?ㅽ듃 愿€由?
- **?좏겙 異붿젙**: `TokenEstimator` ??CJK 臾몄옄 媛€以묒튂 ?곸슜, ?ㅼ떆媛?鍮꾩슜 ?쒖떆
- **?€???뺤텞**: 而⑦뀓?ㅽ듃 珥덇낵 ??`ContextCondenser`濡??붿빟 ???ъ븬異?- **?€??遺꾧린**: `ParentId` 湲곕컲 ?몃━ 援ъ“, ?고겢由?"?ш린??遺꾧린"
---
## 5. ?꾧뎄 ?앺깭怨???52媛??먯씠?꾪듃 ?꾧뎄
### ?꾧뎄 移댄뀒怨좊━
```
?뚯씪쨌肄붾뱶 (18媛? 臾몄꽌쨌?곗씠??(12媛?
file_read/write document_read/write
directory_list pptx_create
search_files xlsx_analyze
file_watch data_pivot
lsp_goto_definition template_render
lsp_find_references text_summarize
search_codebase (TF-IDF) image_analyze
媛쒕컻 (12媛? ?쒖뒪?쑣룻봽濡쒖꽭??(10媛?
git_status/diff/commit process_run
build_run environment_read
test_generate/run clipboard_read/write
code_review screen_capture
spawn_agent notification_show
```
### ?ㅽ궗 ?쒖뒪??(29媛??댁옣 ?щ옒??紐낅졊)
```
/daily-standup /email-draft /code-review
/translate /security-audit /prd-generator
/weekly-report /refactor /gen-test
/changelog /sql-report /perf-audit ??```
- `*.skill.md` 留덊겕?ㅼ슫 ?뚯씪濡??뺤쓽 (YAML ?꾨줎?몃ℓ??
- `%APPDATA%\AxCopilot\skills\` ?몃? ?대뜑濡??щ퉴???놁씠 異붽?
- Python/Node.js ?고???媛먯? ??怨좉툒 ?ㅽ궗 ?먮룞 ?쒖꽦??
---
## 6. 肄붾뱶 ?명뀛由ъ쟾??湲곗닠
### LSP (Language Server Protocol) ?곕룞
```
?먯씠?꾪듃 LSP ?쒕쾭
?? ?? ?쒋? lsp_goto_definition ?€?€??OmniSharp (C#)
?쒋? lsp_find_references ?€?€??typescript-language-server
?붴? lsp_symbols ?€?€??pyright (Python)
```
**?④낵**: ?띿뒪??寃€?됱씠 ?꾨땶 ?섎? 湲곕컲 肄붾뱶 ?먯깋 ???섏젙 ?뺥솗???€???μ긽
### ?쒕㎤??肄붾뱶 寃€??(TF-IDF ?붿쭊)
```
1. ?꾨줈?앺듃 ?뚯씪 ?몃뜳?? ?붴??€ 諛붿씠洹몃옩 ?좏겕?섏씠?€ + ?ㅽ넲?뚮뱶 ?쒓굅
?붴??€ SQLite ?곸냽 ?€??(利앸텇 ?낅뜲?댄듃)
2. 吏덉쓽 ??愿€???뚯씪 ?먮룞 寃€?? ?붴??€ TF-IDF ?먯닔 怨꾩궛 ???곸쐞 N媛?諛섑솚
?붴??€ ?먯씠?꾪듃媛€ ?먮룞?쇰줈 愿€??肄붾뱶 ?쎄린
```
### MCP (Model Context Protocol) ?대씪?댁뼵??
- `stdio` + `JSON-RPC 2.0` ?쒖? 援ы쁽
- ?몃? MCP ?쒕쾭???꾧뎄瑜??먯씠?꾪듃 ?꾧뎄濡??먮룞 ?섑븨
- ?щ궡 ?꾩슜 MCP ?쒕쾭留??곌껐 ?덉슜
---
## 7. 蹂댁븞 & ?щ궡 ?섍꼍 ?ㅺ퀎
### ?ㅼ링 蹂댁븞 援ъ“
```
?덉씠??1: ?ㅼ젙 ?뷀샇?? ?붴??€ settings.json ??AES-256-GCM ??settings.dat
?붴??€ PC蹂?DPAPI ??議고빀 (?댁떇 遺덇?)
?덉씠??2: ??났??諛⑹? (AntiTamper)
?붴??€ ?붾쾭嫄?媛먯?, 由щ쾭???꾧뎄 ?꾨줈?몄뒪 媛먯?
?붴??€ ?щ궡 IP ?€???덉쇅 泥섎━ (媛쒕컻 ?섍꼍)
?덉씠??3: 蹂댁븞 媛먯궗 濡쒓렇
?붴??€ AuditLogService ??紐⑤뱺 ?꾧뎄 ?몄텧 JSON ?곸냽?? ?붴??€ 媛쒕컻??紐⑤뱶?먯꽌 媛먯궗 濡쒓렇 ?대뜑 ?닿린
?덉씠??4: ?ㅽ뻾 踰붿쐞 ?쒗븳
?붴??€ ?몃? HTTP ?몄텧 湲덉? (LLM API ?쒖쇅)
?붴??€ ?먭꺽 肄붾뱶 ?ㅽ뻾 湲덉?
?붴??€ ?붾젅硫뷀듃由??꾩쟾 李⑤떒
```
### 紐⑤뜽 ?쇱슦???꾨왂
```
吏덈Ц ?좏삎 遺꾨쪟
?? ?쒋??€ 肄붾뵫/湲곗닠 ??肄붾뱶 ?뱁솕 紐⑤뜽 (?щ궡 vLLM)
?쒋??€ 踰덉뿭/?붿빟 ??寃쎈웾 紐⑤뜽 (Ollama)
?붴??€ 蹂듭옟 遺꾩꽍 ???€??紐⑤뜽 (Gemini Pro / Sigmoid)
?대갚 泥섎━: 紐⑤뜽 ?ㅻ쪟 ??FallbackModels ?쒖감 ?쒕룄
```
---
## 8. Phase蹂?媛쒕컻 ?꾪솴
### ?꾨즺??二쇱슂 Phase
| Phase | 踰꾩쟾 | ?듭떖 ?깃낵 |
|-------|------|-----------|
| 2.5~7 | v1.1~1.2 | ?먯씠?꾪듃 猷⑦봽, 21媛??꾧뎄, 留덊겕?ㅼ슫 ?뚮뜑??|
| 8 | v1.5.0 | MCP ?대씪?댁뼵?? 紐⑤뜽 ?대갚, ?€??遺꾧린, ?좏겙 愿€由?|
| 9 | v1.5.0 | LSP ?곕룞, 蹂묐젹 ?먯씠?꾪듃, 肄붾뱶 ?쒕㎤??寃€?? ?대깽???몃━嫄?|
| 10~11 | v1.5.0 | Auto Router, ?먯씠?꾪듃 硫붾え由? ?ㅽ궗 ?쒖뒪?? AI 肄붾뱶 由щ럭 |
| 15 | v1.6.0 | 硫€?고뙣??臾몄꽌 ?앹꽦, 42??2媛??꾧뎄, 29媛??댁옣 ?ㅽ궗 |
| 16 | v1.7.0 | ?뚮옖 紐⑤뱶, 蹂묐젹 ?꾧뎄 ?ㅽ뻾, ?꾨줈?앺듃 洹쒖튃 ?쒖뒪??|
### ?꾩옱 洹쒕え (v1.6.1)
```
?먯씠?꾪듃 ?꾧뎄: 52媛??댁옣 ?ㅽ궗: 29媛?肄붿썙???꾨━?? 20媛?吏€??LLM: 4醫?(Ollama 쨌 vLLM 쨌 Gemini 쨌 Sigmoid)
?곗쿂 ?몃뱾?? 44媛?吏€???뚮쭏: 10醫?```
---
## 9. 李④린 媛쒕컻 諛⑺뼢 (v1.8~2.0)
### 寃쎌웳 ?쒕퉬???€鍮?濡쒕뱶留?
| 湲곕뒫 | 寃쎌웳 ?쒕퉬??| AX Copilot 怨꾪쉷 |
|------|-------------|-----------------|
| ?먭린 ?깆같 猷⑦봽 | Claw Code Reflexion | **v1.8** ?먭린 ?깆같 ?쒕퉬??|
| ?곸냽 ?묒뾽 湲곗뼲 | Windsurf Memory | **v1.8** Working Memory |
| 硫€?고뙆??Diff | Cursor diff view | **v1.8** ?듯빀 Diff UI |
| HTTP+SSE MCP | Claw Code ?먭꺽 | **v1.8** MCP HTTP ?꾩넚 |
| ?먯씠?꾪듃 ?€ | GitHub Copilot Workspace | **v2.0** ?ㅼ쨷 ?먯씠?꾪듃 |
| ?뚮윭洹몄씤 媛ㅻ윭由?| Raycast Store | **v2.0** 濡쒖뺄 ?덉??ㅽ듃由?|
### ?щ궡 ?섍꼍 ?뱁솕 ?먯튃 ?좎?
- ???몃? ?쒕쾭 ?섏〈 ?놁쓬 ???⑦봽?덈???LLM ?곗꽑
- ???몄뒪?⑤윭 150MB ?댄븯 ?좎?
- ???뚮윭洹몄씤 濡쒖뺄 zip ?ㅼ튂留??덉슜
- ??紐⑤뱺 ?곗씠??濡쒖뺄 ?€??
---
## 10. ?뺣━ 諛?Q&A
### AX Copilot??湲곗닠??李⑤퀎??
```
1. ?꾩쟾 ?ㅽ봽?쇱씤 ?숈옉 媛€??(?щ궡 Ollama/vLLM)
2. 52媛??먯씠?꾪듃 ?꾧뎄 + 29媛??щ옒???ㅽ궗
3. LSP 湲곕컲 ?ㅼ젣 肄붾뱶 ?댄빐 (?띿뒪??寃€???섏? 珥덉썡)
4. MCP ?쒖??쇰줈 ?щ궡 ?쒕쾭 ?먯쑀 ?곌껐
5. AES-256 + DPAPI ?댁쨷 ?뷀샇???ㅼ젙 蹂댁븞
6. ?꾩뿭 ?ロ궎 Alt+Space ???대뼡 ?깆뿉?쒕룄 利됱떆 ?몄텧
```
### ?ν썑 湲곗뿬 諛⑸쾿
- **?ㅽ궗 異붽?**: `*.skill.md` ?뚯씪 ?묒꽦 ??`%APPDATA%\AxCopilot\skills\` 諛곗튂
- **MCP ?쒕쾭**: ?щ궡 ?꾧뎄瑜?MCP ?쒕쾭濡??몄텧 ??AX Copilot?먯꽌 ?먮룞 ?ъ슜
- **?뚮윭洹몄씤**: `IActionHandler` ?명꽣?섏씠??援ы쁽 ??DLL 諛곗튂
---
*諛쒗몴 ?먮즺 ?묒꽦: AX?곌뎄??AI?€ | 臾몄쓽: ?대? 硫붿떊?€*