cx-viewer 1.0.0

package/concepts/th/Tool-executeCode.md

@@ -0,0 +1,41 @@
+# executeCode (mcp__ide__executeCode)
+
+## คำจำกัดความ
+
+รันโค้ด Python ใน Jupyter kernel ของไฟล์ notebook ปัจจุบัน
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `code` | string | ใช่ | โค้ด Python ที่จะรัน |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- รันโค้ดในสภาพแวดล้อม Jupyter notebook
+- ทดสอบโค้ดสนิปเป็ต
+- การวิเคราะห์ข้อมูลและการคำนวณ
+
+**ไม่เหมาะสำหรับ:**
+- การรันโค้ดนอกสภาพแวดล้อม Jupyter — ควรใช้ Bash
+- การแก้ไขไฟล์ — ควรใช้ Edit หรือ Write
+
+## ข้อควรระวัง
+
+- นี่คือเครื่องมือ MCP (Model Context Protocol) ที่จัดเตรียมโดยการรวมกับ IDE
+- โค้ดจะถูกรันใน Jupyter kernel ปัจจุบัน สถานะจะคงอยู่ระหว่างการเรียก
+- เว้นแต่ผู้ใช้ร้องขออย่างชัดเจน ควรหลีกเลี่ยงการประกาศตัวแปรหรือแก้ไขสถานะ kernel
+- สถานะจะสูญหายหลังจากรีสตาร์ท kernel
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
+    
+    All code will be executed in the current Jupyter kernel.
+    
+    Avoid declaring variables or modifying the state of the kernel unless the user
+    explicitly asks for it.
+    
+    Any code executed will persist across calls to this tool, unless the kernel
+    has been restarted.</textarea>

package/concepts/th/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## คำจำกัดความ
+
+รับข้อมูลการวินิจฉัยภาษาจาก VS Code รวมถึงข้อผิดพลาดทางไวยากรณ์ ข้อผิดพลาดประเภท คำเตือน lint ฯลฯ
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `uri` | string | ไม่ | URI ของไฟล์ หากไม่ระบุจะรับข้อมูลวินิจฉัยของไฟล์ทั้งหมด |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ตรวจสอบปัญหาเชิงความหมายของโค้ด เช่น ไวยากรณ์ ประเภท lint
+- ตรวจสอบว่าการแก้ไขโค้ดทำให้เกิดข้อผิดพลาดใหม่หรือไม่
+- ใช้แทนคำสั่ง Bash เพื่อตรวจสอบคุณภาพโค้ด
+
+**ไม่เหมาะสำหรับ:**
+- รันการทดสอบ — ควรใช้ Bash
+- ตรวจสอบข้อผิดพลาดขณะรัน — ควรใช้ Bash เพื่อรันโค้ด
+
+## ข้อควรระวัง
+
+- นี่คือเครื่องมือ MCP (Model Context Protocol) ที่จัดเตรียมโดยการรวมกับ IDE
+- ใช้ได้เฉพาะในสภาพแวดล้อม VS Code / IDE
+- ควรใช้เครื่องมือนี้แทนคำสั่ง Bash เพื่อตรวจสอบปัญหาโค้ด
+
+## ข้อความต้นฉบับ
+
+<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/th/Tools.md

@@ -0,0 +1,67 @@
+# ภาพรวมเครื่องมือของ Claude Code
+
+Claude Code มอบชุดเครื่องมือในตัวให้กับโมเดลผ่านกลไก tool_use ของ Anthropic API อาร์เรย์ `tools` ของคำร้องขอ MainAgent แต่ละรายการจะมีคำจำกัดความ JSON Schema ที่สมบูรณ์ของเครื่องมือเหล่านี้ และโมเดลจะเรียกใช้ผ่าน content block `tool_use` ในการตอบกลับ
+
+ต่อไปนี้คือดัชนีจำแนกตามหมวดหมู่ของเครื่องมือทั้งหมด
+
+## ระบบ Agent
+
+| เครื่องมือ | วัตถุประสงค์ |
+|------|------|
+| [Task](Tool-Task.md) | เริ่มต้น sub-agent (SubAgent) เพื่อจัดการงานหลายขั้นตอนที่ซับซ้อน |
+| [TaskOutput](Tool-TaskOutput.md) | รับผลลัพธ์ของงานเบื้องหลัง |
+| [TaskStop](Tool-TaskStop.md) | หยุดงานเบื้องหลังที่กำลังทำงาน |
+| [TaskCreate](Tool-TaskCreate.md) | สร้างรายการในรายการงานแบบมีโครงสร้าง |
+| [TaskGet](Tool-TaskGet.md) | รับรายละเอียดงาน |
+| [TaskUpdate](Tool-TaskUpdate.md) | อัปเดตสถานะงาน ความสัมพันธ์การพึ่งพา ฯลฯ |
+| [TaskList](Tool-TaskList.md) | แสดงรายการงานทั้งหมด |
+
+## การดำเนินการไฟล์
+
+| เครื่องมือ | วัตถุประสงค์ |
+|------|------|
+| [Read](Tool-Read.md) | อ่านเนื้อหาไฟล์ (รองรับข้อความ, รูปภาพ, PDF, Jupyter notebook) |
+| [Edit](Tool-Edit.md) | แก้ไขไฟล์ด้วยการแทนที่สตริงที่แม่นยำ |
+| [Write](Tool-Write.md) | เขียนหรือเขียนทับไฟล์ |
+| [NotebookEdit](Tool-NotebookEdit.md) | แก้ไขเซลล์ Jupyter notebook |
+
+## การค้นหา
+
+| เครื่องมือ | วัตถุประสงค์ |
+|------|------|
+| [Glob](Tool-Glob.md) | ค้นหาไฟล์ตามรูปแบบชื่อไฟล์ |
+| [Grep](Tool-Grep.md) | ค้นหาเนื้อหาไฟล์โดยใช้ ripgrep |
+
+## เทอร์มินัล
+
+| เครื่องมือ | วัตถุประสงค์ |
+|------|------|
+| [Bash](Tool-Bash.md) | รันคำสั่ง shell |
+
+## เว็บ
+
+| เครื่องมือ | วัตถุประสงค์ |
+|------|------|
+| [WebFetch](Tool-WebFetch.md) | ดึงเนื้อหาเว็บเพจและประมวลผลด้วย AI |
+| [WebSearch](Tool-WebSearch.md) | ค้นหาผ่านเครื่องมือค้นหา |
+
+## การวางแผนและการโต้ตอบ
+
+| เครื่องมือ | วัตถุประสงค์ |
+|------|------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | เข้าสู่โหมดวางแผนเพื่อออกแบบแผนการดำเนินงาน |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | ออกจากโหมดวางแผนและส่งแผนให้ผู้ใช้อนุมัติ |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | ถามคำถามผู้ใช้เพื่อขอคำชี้แจงหรือการตัดสินใจ |
+
+## ส่วนขยาย
+
+| เครื่องมือ | วัตถุประสงค์ |
+|------|------|
+| [Skill](Tool-Skill.md) | รันทักษะ (slash command) |
+
+## การรวมกับ IDE
+
+| เครื่องมือ | วัตถุประสงค์ |
+|------|------|
+| [getDiagnostics](Tool-getDiagnostics.md) | รับข้อมูลการวินิจฉัยภาษาจาก VS Code |
+| [executeCode](Tool-executeCode.md) | รันโค้ดใน Jupyter kernel |

package/concepts/th/ToolsFirst.md

@@ -0,0 +1,77 @@
+# ทำไม Tools ถึงแสดงก่อน?
+
+ในแผง Context ของ cc-viewer **Tools จะปรากฏก่อน System Prompt และ Messages** ลำดับนี้สะท้อนให้เห็นถึง **ลำดับ prefix ของ KV-Cache ใน Anthropic API** อย่างแม่นยำ
+
+## ลำดับ prefix ของ KV-Cache
+
+เมื่อ Anthropic API สร้าง KV-Cache จะเชื่อมต่อบริบทเป็น prefix ตาม **ลำดับที่ตายตัว** นี้:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+หมายความว่า **Tools อยู่ก่อน System Prompt ที่จุดเริ่มต้นของ cache prefix**
+
+## ทำไม Tools จึงมีน้ำหนักใน cache มากกว่า System?
+
+ในการจับคู่ prefix ของ KV-Cache **เนื้อหาที่อยู่ก่อนหน้ามีความสำคัญมากกว่า** — การเปลี่ยนแปลงใดๆ จะทำให้ทุกอย่างที่ตามมาเป็นโมฆะ:
+
+1. **การจับคู่ prefix เริ่มต้นจากจุดเริ่มต้น**: KV-Cache เปรียบเทียบคำขอปัจจุบันกับ prefix ที่แคชไว้ทีละ token จากจุดเริ่มต้น เมื่อพบความไม่ตรงกัน เนื้อหาทั้งหมดที่ตามมาจะถูกทำให้เป็นโมฆะ
+
+2. **Tools เปลี่ยน = cache ทั้งหมดเป็นโมฆะ**: เนื่องจาก Tools อยู่ก่อน การเปลี่ยนแปลงใดๆ ในนิยามของเครื่องมือ (แม้แต่การเพิ่มหรือลบ MCP tool เพียงอันเดียว) จะ **ทำลาย prefix จากจุดเริ่มต้น** ทำให้ System Prompt และ Messages ที่แคชไว้ทั้งหมดเป็นโมฆะ
+
+3. **System เปลี่ยน = cache ของ Messages เป็นโมฆะ**: System Prompt อยู่ตรงกลาง ดังนั้นการเปลี่ยนแปลงจึงทำให้เฉพาะส่วน Messages ที่ตามมาเป็นโมฆะ
+
+4. **Messages เปลี่ยน = ส่งผลเฉพาะส่วนท้าย**: Messages อยู่ท้ายสุด ดังนั้นการเพิ่มข้อความใหม่จะทำให้เฉพาะส่วนท้ายเล็กๆ เป็นโมฆะ — cache ของ Tools และ System ยังคงสมบูรณ์
+
+## ผลกระทบในทางปฏิบัติ
+
+| ประเภทการเปลี่ยนแปลง | ผลกระทบต่อ cache | สถานการณ์ทั่วไป |
+|----------------------|-----------------|-----------------|
+| เพิ่ม/ลบ Tool | **เป็นโมฆะทั้งหมด** | เชื่อมต่อ/ตัดการเชื่อมต่อ MCP server, เปิด/ปิด IDE plugin |
+| เปลี่ยน System Prompt | สูญเสีย cache ของ Messages | แก้ไข CLAUDE.md, การฉีด system reminder |
+| เพิ่มข้อความใหม่ | เพิ่มเฉพาะส่วนท้ายเท่านั้น | การสนทนาปกติ (พบบ่อยที่สุด, ถูกที่สุด) |
+
+นี่คือเหตุผลที่ `tools_change` ใน [CacheRebuild](CacheRebuild.md) มักเป็นเหตุผลของการสร้างใหม่ที่แพงที่สุด — มันทำลายห่วงโซ่ prefix ตั้งแต่ด้านหน้าสุด
+
+## ทำไมคำจำกัดความเครื่องมือถึงอยู่ก่อน "สมอง"?
+
+จากมุมมองของแคช การที่ Tools อยู่ก่อนเป็นข้อเท็จจริงทางเทคนิค แต่จากมุมมองของการออกแบบเชิงปัญญา ลำดับนี้ก็มีเหตุผลเท่าเทียมกัน — **Tools คือมือและเท้า, System Prompt คือสมอง**
+
+ก่อนลงมือทำ คนเราต้องรับรู้ก่อนว่ามีแขนขาและเครื่องมืออะไรใช้ได้บ้าง ทารกไม่ได้เข้าใจกฎของโลก (System) ก่อนแล้วค่อยเรียนรู้การหยิบจับ — พวกเขารับรู้ก่อนว่ามีมือและเท้า จากนั้นค่อยๆ เข้าใจกฎผ่านการมีปฏิสัมพันธ์กับสิ่งแวดล้อม เช่นเดียวกัน LLM ต้องรู้ว่าเรียกใช้เครื่องมืออะไรได้บ้าง (อ่านไฟล์ เขียนโค้ด ค้นหา รันคำสั่ง) ก่อนได้รับคำสั่งงาน (System Prompt) เพื่อจะได้ประเมินได้อย่างแม่นยำว่า "ฉันทำอะไรได้" และ "ฉันควรทำอย่างไร" เมื่อประมวลผลคำสั่ง
+
+ถ้าสลับลำดับ — บอกโมเดลก่อนว่า "งานของคุณคือรีแฟกเตอร์โมดูลนี้" แล้วค่อยบอกว่า "คุณมีเครื่องมือ Read, Edit, Bash" — โมเดลจะขาดข้อมูลสำคัญเกี่ยวกับขอบเขตความสามารถเมื่อทำความเข้าใจงาน อาจวางแผนที่ไม่สมจริงหรือมองข้ามวิธีการที่ใช้ได้
+
+**รู้ไพ่ในมือก่อน แล้วค่อยตัดสินใจว่าจะเล่นอย่างไร** นี่คือตรรกะเชิงปัญญาที่อยู่เบื้องหลังการวาง Tools ก่อน System
+
+## ทำไมเครื่องมือ MCP ก็อยู่ในตำแหน่งนี้ด้วย?
+
+เครื่องมือ MCP (Model Context Protocol) เช่นเดียวกับเครื่องมือในตัว ถูกวางไว้ที่ส่วนเริ่มต้นของพื้นที่ Tools การเข้าใจตำแหน่งของ MCP ในบริบทช่วยประเมินประโยชน์และต้นทุนที่แท้จริง
+
+### ข้อดีของ MCP
+
+- **ขยายความสามารถ**: MCP ให้โมเดลเข้าถึงบริการภายนอก (คิวรีฐานข้อมูล, เรียก API, ปฏิบัติการ IDE, ควบคุมเบราว์เซอร์ ฯลฯ) ก้าวข้ามขอบเขตของเครื่องมือในตัว
+- **ระบบนิเวศเปิด**: ใครก็สามารถสร้าง MCP server ได้ โมเดลได้รับความสามารถใหม่โดยไม่ต้องเทรนใหม่
+- **โหลดตามต้องการ**: MCP server สามารถเชื่อมต่อ/ตัดการเชื่อมต่อได้ตามสถานการณ์ ประกอบชุดเครื่องมือได้อย่างยืดหยุ่น
+
+### ต้นทุนของ MCP
+
+- **ฆาตกรแคช**: คำจำกัดความ JSON Schema ของเครื่องมือ MCP แต่ละตัวถูกต่อเข้าที่จุดเริ่มต้นของ prefix KV-Cache การเพิ่มหรือลบเครื่องมือ MCP หนึ่งตัว = **แคชทั้งหมดถูกยกเลิกตั้งแต่ต้น** การเชื่อมต่อ/ตัดการเชื่อมต่อ MCP server บ่อยครั้งจะลดอัตราการ hit แคชอย่างมาก
+- **prefix บวม**: Schema ของเครื่องมือ MCP มักใหญ่กว่าเครื่องมือในตัว (คำอธิบายพารามิเตอร์โดยละเอียด, ค่า enum ฯลฯ) เครื่องมือ MCP จำนวนมากเพิ่มจำนวน token ในพื้นที่ Tools อย่างมาก บีบพื้นที่บริบทสำหรับ Messages
+- **ค่าใช้จ่ายด้านความหน่วง**: การเรียกเครื่องมือ MCP ต้องการการสื่อสารระหว่างโปรเซส (JSON-RPC ผ่าน stdio/SSE) ช้ากว่าการเรียกฟังก์ชันในตัวเป็นอันดับขนาด
+- **ความเสี่ยงด้านเสถียรภาพ**: MCP server เป็นโปรเซสภายนอกที่อาจล่ม หมดเวลา หรือส่งคืนรูปแบบที่ไม่คาดคิด ต้องการการจัดการข้อผิดพลาดเพิ่มเติม
+
+### คำแนะนำเชิงปฏิบัติ
+
+| สถานการณ์ | คำแนะนำ |
+|-----------|---------|
+| บทสนทนายาว, โต้ตอบบ่อย | ลดจำนวนเครื่องมือ MCP ให้น้อยที่สุดเพื่อปกป้องเสถียรภาพ prefix แคช |
+| งานสั้น, ปฏิบัติการครั้งเดียว | ใช้เครื่องมือ MCP ได้อย่างอิสระ; ผลกระทบต่อแคชจำกัด |
+| เพิ่ม/ลบ MCP server บ่อย | ทุกการเปลี่ยนแปลงทำให้แคชสร้างใหม่ทั้งหมด; พิจารณาตรึงชุดเครื่องมือ |
+| Tool Schema ขนาดใหญ่เกินไป | ลด description และ enum เพื่อลดการใช้ token ของ prefix |
+
+ในแผง Context ของ cc-viewer เครื่องมือ MCP แสดงร่วมกับเครื่องมือในตัวในพื้นที่ Tools ให้มุมมองที่ชัดเจนของขนาด Schema แต่ละเครื่องมือและการมีส่วนร่วมต่อ prefix แคช

package/concepts/th/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# การปนเปื้อนบริบทใน Translate API
+
+## ความเป็นมา
+
+CC-Viewer มีฟีเจอร์แปลภาษาในตัว (`POST /api/translate`) ที่ขับเคลื่อนโดย Anthropic Messages API ในการพัฒนาช่วงแรก คำขอแปลภาษาใช้ข้อมูลรับรองตัวตนที่แคชไว้จากเซสชัน Claude Code ซ้ำ — รวมถึงทั้ง header `x-api-key` และ `authorization` สิ่งนี้ทำให้เกิดปัญหาที่แนบเนียนแต่ร้ายแรง: ผลลัพธ์การแปลมักส่งคืนเนื้อหาที่ไม่เกี่ยวข้อง
+
+## สาเหตุหลัก
+
+### ความแตกต่างพื้นฐานระหว่างสองวิธีการรับรองตัวตน
+
+Anthropic API รองรับสองวิธีการรับรองตัวตน:
+
+| วิธี | Header | แหล่งที่มาทั่วไป | ลักษณะเฉพาะ |
+|------|--------|-------------------|-------------|
+| API Key | `x-api-key: sk-ant-...` | ตัวแปรสภาพแวดล้อม / Console | ไม่มีสถานะ แต่ละคำขอเป็นอิสระ |
+| OAuth Token | `authorization: Bearer sessionToken` | การเข้าสู่ระบบแบบสมัครสมาชิก Claude Code | ผูกกับเซสชัน เซิร์ฟเวอร์รักษาการเชื่อมโยงบริบท |
+
+ความแตกต่างสำคัญ: **API Key ไม่มีสถานะ** — แต่ละคำขอเป็นอิสระอย่างสมบูรณ์ ในขณะที่ **OAuth session token มีสถานะ** — เซิร์ฟเวอร์ Anthropic เชื่อมโยงคำขอที่ใช้โทเค็นเดียวกันเข้ากับบริบทเซสชันเดียวกัน
+
+### ห่วงโซ่การปนเปื้อน
+
+เมื่อ Claude Code ใช้การเข้าสู่ระบบ OAuth แบบสมัครสมาชิก กระบวนการรับรองตัวตนจะเป็นดังนี้:
+
+```
+การสนทนาหลักของ Claude Code ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                          ↑
+คำขอแปลภาษาของ CC-Viewer ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+เนื่องจากคำขอแปลภาษาใช้ session token เดียวกันซ้ำ เซิร์ฟเวอร์ Anthropic อาจเชื่อมโยงคำขอแปลภาษาเข้ากับบริบทการสนทนาหลักของ Claude Code ส่งผลให้:
+
+1. **ผลลัพธ์การแปลได้รับอิทธิพลจากบริบทการสนทนาหลัก**: system prompt ของคำขอแปลคือ "คุณคือนักแปล" แต่บริบทของเซิร์ฟเวอร์ยังคงมีประวัติการสนทนาของ Claude Code ซึ่งอาจรบกวนโมเดล
+2. **การสนทนาหลักถูกรบกวนจากคำขอแปลภาษา**: เนื้อหาของคำขอแปล (ส่วนข้อความ UI) อาจถูกแทรกเข้าไปในบริบทการสนทนาหลัก ทำให้คำตอบของ Claude Code เบี่ยงเบน
+3. **พฤติกรรมที่คาดเดาไม่ได้**: เนื่องจากการปนเปื้อนบริบทเป็นพฤติกรรมฝั่งเซิร์ฟเวอร์ ไคลเอนต์ไม่สามารถตรวจจับหรือควบคุมได้
+
+## บทเรียนที่ได้รับ
+
+- **OAuth session token ไม่ใช่ "แค่ API Key อีกตัว"** — มันมีสถานะฝั่งเซิร์ฟเวอร์ การใช้ซ้ำหมายถึงการแชร์บริบท
+- **การเรียกบริการภายในควรใช้การรับรองตัวตนแบบอิสระและไม่มีสถานะ** เพื่อหลีกเลี่ยงการเชื่อมโยงกับเซสชันของผู้ใช้
+
+## อ้างอิง
+
+- [Anthropic API Authentication Docs](https://docs.anthropic.com/en/api/getting-started)
+- [Claude Code Authentication](https://support.claude.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code)
+- [Anthropic Bans Subscription OAuth in Third-Party Apps](https://winbuzzer.com/2026/02/19/anthropic-bans-claude-subscription-oauth-in-third-party-apps-xcxwbn/)
+- [Claude Code Authentication: API Keys, Subscriptions, and SSO](https://developertoolkit.ai/en/claude-code/quick-start/authentication/)

package/concepts/th/UltraPlan.md

@@ -0,0 +1,55 @@
+# UltraPlan — เครื่องอธิษฐานสุดยอด
+
+## UltraPlan คืออะไร
+
+UltraPlan คือ**การนำไปใช้งานแบบ localized** ของ cc-viewer สำหรับคำสั่ง `/ultraplan` ดั้งเดิมของ Claude Code ช่วยให้คุณใช้ความสามารถทั้งหมดของ `/ultraplan` ในสภาพแวดล้อมภายในเครื่องของคุณ**โดยไม่จำเป็นต้องเปิดใช้บริการระยะไกลอย่างเป็นทางการของ Claude** นำทาง Claude Code ให้สำเร็จงานวางแผนและดำเนินการที่ซับซ้อนโดยใช้**การทำงานร่วมกันแบบหลายเอเจนต์**
+
+เมื่อเทียบกับโหมด Plan ปกติหรือ Agent Team แล้ว UltraPlan สามารถ:
+- ประเมินความซับซ้อนของงานโดยอัตโนมัติและเลือกกลยุทธ์การวางแผนที่เหมาะสมที่สุด
+- ส่งเอเจนต์คู่ขนานหลายตัวเพื่อสำรวจโค้ดเบสจากมิติที่แตกต่างกัน
+- รวมการค้นคว้าภายนอก (webSearch) เพื่อดูแนวปฏิบัติที่ดีที่สุดในอุตสาหกรรม
+- รวบรวมทีม Code Review โดยอัตโนมัติหลังจากดำเนินแผนเสร็จเพื่อตรวจสอบโค้ด
+- สร้างวงจรปิดที่สมบูรณ์ **วางแผน → ดำเนินการ → ตรวจสอบ → แก้ไข**
+
+---
+
+## หมายเหตุสำคัญ
+
+### 1. UltraPlan ไม่ใช่สิ่งที่ทำได้ทุกอย่าง
+UltraPlan เป็นเครื่องอธิษฐานที่ทรงพลังกว่า แต่นั่นไม่ได้หมายความว่าทุกคำอธิษฐานจะเป็นจริงได้ มันทรงพลังกว่า Plan และ Agent Team แต่ไม่สามารถ "ทำเงินให้คุณ" ได้โดยตรง พิจารณาความละเอียดของงานที่เหมาะสม — แบ่งเป้าหมายใหญ่เป็นงานขนาดกลางที่ดำเนินการได้ แทนที่จะพยายามทำทุกอย่างในครั้งเดียว
+
+### 2. ปัจจุบันมีประสิทธิภาพสูงสุดสำหรับโปรเจกต์โปรแกรมมิ่ง
+เทมเพลตและเวิร์กโฟลว์ของ UltraPlan ได้รับการปรับปรุงอย่างลึกซึ้งสำหรับโปรเจกต์โปรแกรมมิ่ง สถานการณ์อื่น ๆ (เอกสาร, การวิเคราะห์ข้อมูล ฯลฯ) สามารถลองได้ แต่คุณอาจต้องรอการปรับปรุงในเวอร์ชันอนาคต
+
+### 3. เวลาดำเนินการและข้อกำหนดหน้าต่างบริบท
+- การรัน UltraPlan ที่สำเร็จโดยทั่วไปใช้เวลา **30 นาทีขึ้นไป**
+- ต้องการให้ MainAgent มีหน้าต่างบริบทขนาดใหญ่ (แนะนำโมเดล Opus ที่มีบริบท 1M)
+- หากคุณมีเพียงโมเดล 200K **ต้องแน่ใจว่าได้ `/clear` บริบทก่อนรัน**
+- คำสั่ง `/compact` ของ Claude Code ทำงานได้ไม่ดีเมื่อหน้าต่างบริบทไม่เพียงพอ — หลีกเลี่ยงการใช้พื้นที่จนหมด
+- การรักษาพื้นที่บริบทให้เพียงพอเป็นข้อกำหนดเบื้องต้นที่สำคัญสำหรับการดำเนินการ UltraPlan ที่สำเร็จ
+
+หากคุณมีคำถามหรือข้อเสนอแนะเกี่ยวกับ UltraPlan แบบ localized สามารถเปิด [Issues บน GitHub](https://github.com/anthropics/claude-code/issues) เพื่อพูดคุยและร่วมมือกัน
+
+---
+
+## วิธีการทำงาน
+
+UltraPlan มีสองโหมดการทำงาน:
+
+### โหมดอัตโนมัติ
+วิเคราะห์ความซับซ้อนของงานโดยอัตโนมัติ (คะแนน 4-12) และนำทางไปยังกลยุทธ์ที่แตกต่างกัน:
+
+| เส้นทาง | คะแนน | กลยุทธ์ |
+|---------|--------|---------|
+| เส้นทาง A | 4-6 | การวางแผนแบบเบาพร้อมการสำรวจโค้ดโดยตรง |
+| เส้นทาง B | 7-9 | การวางแผนพร้อมไดอะแกรมโครงสร้าง (Mermaid / ASCII) |
+| เส้นทาง C | 10-12 | การสำรวจแบบหลายเอเจนต์ + วงจรปิดการตรวจสอบ |
+
+### โหมดบังคับ
+เปิดใช้งานเวิร์กโฟลว์หลายเอเจนต์แบบเต็มของเส้นทาง C โดยตรง:
+1. ส่งเอเจนต์คู่ขนานสูงสุด 5 ตัวเพื่อสำรวจโค้ดเบสพร้อมกัน (สถาปัตยกรรม, การระบุไฟล์, การประเมินความเสี่ยง ฯลฯ)
+2. ส่งเอเจนต์วิจัยเพิ่มเติมตามต้องการเพื่อตรวจสอบโซลูชันในอุตสาหกรรมผ่าน webSearch
+3. สังเคราะห์ผลการค้นพบทั้งหมดของเอเจนต์เป็นแผนการดำเนินงานโดยละเอียด
+4. ส่งเอเจนต์ตรวจสอบเพื่อพิจารณาแผนอย่างละเอียดจากหลายมุมมอง
+5. ดำเนินแผนเมื่อได้รับการอนุมัติ
+6. รวบรวมทีม Code Review โดยอัตโนมัติเพื่อตรวจสอบคุณภาพโค้ดหลังการดำเนินการ

package/concepts/tr/BodyDiffJSON.md

@@ -0,0 +1,32 @@
+# Body Diff JSON (İstek Gövdesi Artımlı Karşılaştırma)
+
+## Arka Plan
+
+Claude Code'un MainAgent'ı tam bağlam gönderme mekanizması kullanır — her istek, konuşma geçmişinin tamamını, system prompt'u, araç tanımlarını ve diğer içerikleri taşır. Bu, konuşma ilerledikçe istek gövdesinin giderek büyüyeceği anlamına gelir ve ham Body'yi doğrudan inceleyerek "bu turda tam olarak ne eklendi" sorusunu yanıtlamak zorlaşır.
+
+Body Diff JSON tam olarak bu sorunu çözmek için tasarlanmıştır: ardışık iki MainAgent isteğinin gövdesini otomatik olarak karşılaştırır, artımlı kısmı çıkarır ve bu istekte gerçekten eklenen içeriği bir bakışta görmenizi sağlar.
+
+## Çalışma Prensibi
+
+1. **Ardışık MainAgent isteklerini tanımlama**: Mevcut istek MainAgent türünde olmalı ve bir önceki MainAgent isteği mevcut olmalıdır
+2. **Alan bazında karşılaştırma**: İstek gövdesinin tüm üst düzey alanları taranır, `_` önekli dahili özellikler atlanır
+3. **Akıllı fark çıkarma**:
+   - Eklenen alanlar: Doğrudan gösterilir
+   - Silinen alanlar: Gösterilmez (genellikle anlamayı etkilemez)
+   - Değişen alanlar: Mevcut değer gösterilir
+   - `messages` dizisi özel işlem görür: Yalnızca eklenen mesajlar gösterilir (normal konuşmada ekleme modunda çalışıldığından önek mesajlar değişmez)
+4. **İstek gövdesi küçülme tespiti**: Mevcut istek gövdesi bir öncekinden küçükse, bağlam kesme veya oturum sıfırlama gerçekleşmiş demektir; bu durumda diff yerine bilgi mesajı gösterilir
+
+## Tipik Senaryolar
+
+Normal bir konuşma turunda Body Diff JSON genellikle yalnızca şunları içerir:
+- `messages`: Eklenen 1~2 mesaj (kullanıcının girişi + bir önceki turun asistan yanıtı)
+
+Diff'te `system`, `tools`, `model` gibi alanların değişikliklerini görüyorsanız, bu turda yapılandırma değişikliği olduğu anlamına gelir ve bu genellikle önbellek yeniden oluşturmanın da nedenidir.
+
+## Kullanım Şekli
+
+- Body Diff JSON, MainAgent isteğinin detay panelinde gösterilir
+- Başlığa tıklayarak genişletip/daraltabilirsiniz
+- JSON ve Text olmak üzere iki görüntüleme modu ile tek tıkla kopyalama desteklenir
+- Sol üst köşedeki **CC-Viewer → Genel Ayarlar** bölümünden "Body Diff JSON'u varsayılan olarak genişlet" seçeneği ayarlanabilir

package/concepts/tr/BodyFields.md

@@ -0,0 +1,42 @@
+# Request Body Alan Aciklamasi
+
+Claude API `/v1/messages` istek govdesinin ust duzey alan aciklamasi.
+
+## Alan Listesi
+
+| Alan | Tur | Aciklama |
+|------|------|------|
+| **model** | string | Kullanilan model adi, ornegin `claude-opus-4-6`, `claude-sonnet-4-6` |
+| **messages** | array | Konusma mesaj gecmisi. Her mesaj `role` (user/assistant) ve `content` (metin, gorsel, tool_use, tool_result gibi blok dizisi) icerir |
+| **system** | array | System prompt. Codex'un temel talimatlari, arac kullanim aciklamalari, ortam bilgileri, CLAUDE.md icerigi vb. icerir. `cache_control` isaretli bloklar prompt caching ile onbellege alinir |
+| **tools** | array | Kullanilabilir arac tanim listesi. Her arac `name`, `description` ve `input_schema` (JSON Schema) icerir. MainAgent genellikle 20'den fazla araca sahipken, SubAgent yalnizca birkacina sahiptir |
+| **metadata** | object | Istek meta verileri, genellikle kullaniciyi tanimlamak icin `user_id` icerir |
+| **max_tokens** | number | Modelin tek bir yanittaki maksimum token sayisi, ornegin `16000`, `64000` |
+| **thinking** | object | Genisletilmis dusunme yapilandirmasi. `type: "enabled"` dusunme modunu etkinlestirir, `budget_tokens` dusunme token ust sinirini kontrol eder |
+| **context_management** | object | Baglam yonetimi yapilandirmasi. `truncation: "auto"` Codex'un cok uzun mesaj gecmisini otomatik olarak kesmesine izin verir |
+| **output_config** | object | Cikis yapilandirmasi, ornegin `format` ayari |
+| **stream** | boolean | Akis yaniti etkinlestirilsin mi. Codex her zaman `true` kullanir |
+
+## messages Yapisi
+
+Her mesajin `content` alani bir blok dizisidir. Yaygin turler sunlardir:
+
+- **text**: Duz metin icerigi
+- **tool_use**: Modelin arac cagrisi (`name`, `input` icerir)
+- **tool_result**: Arac yurutme sonucu (`tool_use_id`, `content` icerir)
+- **image**: Gorsel icerigi (base64 veya URL)
+- **thinking**: Modelin dusunme sureci (genisletilmis dusunme modu)
+
+## system Yapisi
+
+system prompt dizisi genellikle sunlari icerir:
+
+1. **Temel ajan talimatlari** ("You are Codex...")
+2. **Arac kullanim kurallari**
+3. **CLAUDE.md icerigi** (proje duzeyi talimatlar)
+4. **Beceri hatirlaticilari** (skills reminder)
+5. **Ortam bilgileri** (OS, shell, git durumu vb.) — Aslinda Codex git'e buyuk olcude bagimlidir. Projede bir git deposu varsa, Codex projeyi daha iyi anlayabilir; uzak degisiklikleri ve commit kayitlarini cekerek analiz surecine yardimci olabilir
+
+`cache_control: { type: "ephemeral" }` ile isaretlenmis bloklar Anthropic API tarafindan 5 dakika boyunca onbellege alinir. Onbellek isabet ettiginde `cache_read_input_tokens` olarak faturalandirilir (`input_tokens`'dan cok daha dusuktur).
+
+> **Not**: Codex gibi ozel istemciler icin, Anthropic sunucusu aslinda onbellekleme davranisini belirlemek icin istekteki `cache_control` ozelligine tamamen bagimli degildir. Sunucu, istekte acikca `cache_control` isareti bulunmasa bile belirli alanlar icin (system prompt, arac tanimlari gibi) onbellekleme politikasini otomatik olarak uygular. Bu nedenle, istek govdesinde bu ozelligi gormediyseniz sasirmaniza gerek yoktur — sunucu onbellekleme islemini arka planda zaten tamamlamistir, ancak bu bilgiyi istemciye aciklamamistir. Bu, Codex ile Anthropic API arasindaki uskutulen bir anlasmadir.

package/concepts/tr/CacheRebuild.md

@@ -0,0 +1,36 @@
+# Cache Rebuild (Önbellek Yeniden Oluşturma)
+
+## Arka Plan
+
+Anthropic'in prompt caching mekanizması, istekteki system → tools → messages (cache breakpoint'e kadar) sırasıyla birleştirerek önbellek anahtarı oluşturur. Önbellek anahtarı bir önceki istekle tamamen aynı olduğunda, API `cache_read_input_tokens` döndürür (önbellek isabet); önbellek anahtarı değiştiğinde, API önbelleği yeniden oluşturur ve büyük miktarda `cache_creation_input_tokens` döndürür, yani önbellek yeniden oluşturma gerçekleşir.
+
+Önbellek yeniden oluşturma ek token ücreti anlamına gelir (cache creation fiyatı cache read'den yüksektir), bu nedenle yeniden oluşturma nedenini belirlemek maliyet optimizasyonu için doğrudan değer taşır.
+
+## Önbellek Yeniden Oluşturma Neden Sınıflandırması
+
+cc-viewer, ardışık iki MainAgent isteğinin gövdesini karşılaştırarak önbellek yeniden oluşturma nedenini kesin olarak belirler:
+
+| reason | Anlamı | Belirleme Yöntemi |
+|--------|--------|-------------------|
+| `ttl` | Önbellek süresi doldu | Önceki MainAgent isteğinden bu yana 5 dakikadan fazla geçmiş |
+| `system_change` | system prompt değişikliği | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
+| `tools_change` | Araç tanımı değişikliği | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
+| `model_change` | Model değişikliği | `prev.model !== curr.model` |
+| `msg_truncated` | Mesaj yığını kesildi | Mevcut isteğin messages sayısı öncekinden az, genellikle bağlam penceresi taşması nedeniyle kesme tetiklenir |
+| `msg_modified` | Geçmiş mesajlar değiştirildi | Önek mesaj içerikleri tutarsız (normal ekleme modunda önek tamamen aynı olmalıdır) |
+| `key_change` | Bilinmeyen anahtar değişikliği | Yukarıdaki koşulların hiçbiri eşleşmediğinde fallback |
+
+## Belirleme Önceliği
+
+1. Önce zaman aralığı kontrol edilir — 5 dakikayı aşarsa doğrudan `ttl` olarak belirlenir, body karşılaştırması yapılmaz
+2. Ardından sırasıyla model, system, tools, messages kontrol edilir
+3. Bir istek aynı anda birden fazla nedene sahip olabilir (örn. model değişikliği + system prompt değişikliği), bu durumda `reasons` dizisi tüm eşleşmeleri içerir, tooltip satır satır gösterir
+
+## Yaygın Senaryolar
+
+- **`ttl`**: Kullanıcı 5 dakikadan fazla ara verdikten sonra devam eder, önbellek doğal olarak sona erer
+- **`system_change`**: Claude Code system prompt'u güncelledi (örn. yeni CLAUDE.md yüklendi, project instructions değişti)
+- **`tools_change`**: MCP server bağlantı/kopma nedeniyle kullanılabilir araç listesi değişti
+- **`model_change`**: Kullanıcı `/model` komutuyla model değiştirdi
+- **`msg_truncated`**: Konuşma çok uzadığında bağlam penceresi yönetimi tetiklenir, Claude Code erken mesajları keser
+- **`msg_modified`**: Claude Code geçmiş mesajları düzenledi (örn. `/compact` sıkıştırma özeti orijinal mesajların yerini aldı)