cc-viewer 1.2.1 → 1.2.2

package/concepts/th/Tool-Grep.md

@@ -0,0 +1,47 @@
+# Grep
+
+## คำจำกัดความ
+
+เครื่องมือค้นหาเนื้อหาที่ทรงพลังโดยใช้ ripgrep รองรับนิพจน์ทั่วไป การกรองตามประเภทไฟล์ และโหมดผลลัพธ์หลายแบบ
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `pattern` | string | ใช่ | รูปแบบค้นหาด้วยนิพจน์ทั่วไป |
+| `path` | string | ไม่ | พาธค้นหา (ไฟล์หรือไดเรกทอรี) ค่าเริ่มต้นคือไดเรกทอรีทำงานปัจจุบัน |
+| `glob` | string | ไม่ | ตัวกรองชื่อไฟล์ (เช่น `*.js`, `*.{ts,tsx}`) |
+| `type` | string | ไม่ | ตัวกรองประเภทไฟล์ (เช่น `js`, `py`, `rust`) มีประสิทธิภาพมากกว่า glob |
+| `output_mode` | enum | ไม่ | โหมดผลลัพธ์: `files_with_matches` (ค่าเริ่มต้น), `content`, `count` |
+| `-i` | boolean | ไม่ | ค้นหาโดยไม่คำนึงถึงตัวพิมพ์ใหญ่-เล็ก |
+| `-n` | boolean | ไม่ | แสดงหมายเลขบรรทัด (เฉพาะโหมด content) ค่าเริ่มต้น true |
+| `-A` | number | ไม่ | จำนวนบรรทัดที่แสดงหลังการจับคู่ |
+| `-B` | number | ไม่ | จำนวนบรรทัดที่แสดงก่อนการจับคู่ |
+| `-C` / `context` | number | ไม่ | จำนวนบรรทัดที่แสดงก่อนและหลังการจับคู่ |
+| `head_limit` | number | ไม่ | จำกัดจำนวนรายการผลลัพธ์ ค่าเริ่มต้น 0 (ไม่จำกัด) |
+| `offset` | number | ไม่ | ข้ามผลลัพธ์ N รายการแรก |
+| `multiline` | boolean | ไม่ | เปิดใช้โหมดจับคู่หลายบรรทัด ค่าเริ่มต้น false |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ค้นหาสตริงหรือรูปแบบเฉพาะในโค้ดเบส
+- ค้นหาตำแหน่งการใช้งานของฟังก์ชัน/ตัวแปร
+- กรองผลลัพธ์การค้นหาตามประเภทไฟล์
+- นับจำนวนการจับคู่
+
+**ไม่เหมาะสำหรับ:**
+- ค้นหาไฟล์ตามชื่อ — ควรใช้ Glob
+- การสำรวจแบบเปิดที่ต้องค้นหาหลายรอบ — ควรใช้ Task (ประเภท Explore)
+
+## ข้อควรระวัง
+
+- ใช้ไวยากรณ์ ripgrep (ไม่ใช่ grep) อักขระพิเศษเช่นวงเล็บปีกกาต้องใช้ escape
+- โหมด `files_with_matches` ส่งคืนเฉพาะพาธไฟล์ มีประสิทธิภาพสูงสุด
+- โหมด `content` ส่งคืนเนื้อหาบรรทัดที่ตรงกัน รองรับบรรทัดบริบท
+- การจับคู่หลายบรรทัดต้องตั้งค่า `multiline: true`
+- ควรใช้เครื่องมือ Grep แทนคำสั่ง `grep` หรือ `rg` ใน Bash เสมอ
+
+## ความสำคัญใน cc-viewer
+
+การเรียก Grep ปรากฏในบันทึกคำร้องขอเป็นคู่ content block `tool_use` / `tool_result` โดย `tool_result` มีผลลัพธ์การค้นหา

package/concepts/th/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## คำจำกัดความ
+
+แทนที่ แทรก หรือลบเซลล์เฉพาะใน Jupyter notebook (ไฟล์ .ipynb)
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `notebook_path` | string | ใช่ | พาธแบบสัมบูรณ์ของไฟล์ notebook |
+| `new_source` | string | ใช่ | เนื้อหาใหม่ของเซลล์ |
+| `cell_id` | string | ไม่ | ID ของเซลล์ที่จะแก้ไข ในโหมดแทรก เซลล์ใหม่จะถูกแทรกหลัง ID นี้ |
+| `cell_type` | enum | ไม่ | ประเภทเซลล์: `code` หรือ `markdown` จำเป็นในโหมดแทรก |
+| `edit_mode` | enum | ไม่ | โหมดแก้ไข: `replace` (ค่าเริ่มต้น), `insert`, `delete` |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- แก้ไขเซลล์โค้ดหรือ markdown ใน Jupyter notebook
+- เพิ่มเซลล์ใหม่ใน notebook
+- ลบเซลล์ใน notebook
+
+## ข้อควรระวัง
+
+- `cell_number` เป็นดัชนีเริ่มจาก 0
+- โหมด `insert` แทรกเซลล์ใหม่ที่ตำแหน่งที่ระบุ
+- โหมด `delete` ลบเซลล์ที่ตำแหน่งที่ระบุ
+- พาธต้องเป็นแบบสัมบูรณ์
+
+## ความสำคัญใน cc-viewer
+
+การเรียก NotebookEdit ปรากฏในบันทึกคำร้องขอเป็น content block `tool_use` ซึ่งบันทึกการดำเนินการแก้ไขเฉพาะที่ทำกับ notebook

package/concepts/th/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## คำจำกัดความ
+
+อ่านเนื้อหาไฟล์จากระบบไฟล์ในเครื่อง รองรับไฟล์ข้อความ รูปภาพ PDF และ Jupyter notebook
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `file_path` | string | ใช่ | พาธแบบสัมบูรณ์ของไฟล์ |
+| `offset` | number | ไม่ | หมายเลขบรรทัดเริ่มต้น (สำหรับอ่านไฟล์ขนาดใหญ่แบบแบ่งส่วน) |
+| `limit` | number | ไม่ | จำนวนบรรทัดที่จะอ่าน (สำหรับอ่านไฟล์ขนาดใหญ่แบบแบ่งส่วน) |
+| `pages` | string | ไม่ | ช่วงหน้า PDF (เช่น "1-5", "3", "10-20") ใช้ได้เฉพาะกับ PDF |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- อ่านไฟล์โค้ด ไฟล์การตั้งค่า และไฟล์ข้อความอื่นๆ
+- ดูไฟล์รูปภาพ (Claude เป็นโมเดลมัลติโมดัล)
+- อ่านเอกสาร PDF
+- อ่าน Jupyter notebook (ส่งคืนเซลล์ทั้งหมดพร้อมผลลัพธ์)
+- อ่านหลายไฟล์พร้อมกันเพื่อรับบริบท
+
+**ไม่เหมาะสำหรับ:**
+- อ่านไดเรกทอรี — ควรใช้คำสั่ง `ls` ของ Bash
+- การสำรวจโค้ดเบสแบบเปิด — ควรใช้ Task (ประเภท Explore)
+
+## ข้อควรระวัง
+
+- พาธต้องเป็นแบบสัมบูรณ์ ไม่ใช่แบบสัมพัทธ์
+- ค่าเริ่มต้นอ่าน 2000 บรรทัดแรกของไฟล์
+- บรรทัดที่เกิน 2000 ตัวอักษรจะถูกตัดทอน
+- ผลลัพธ์ใช้รูปแบบ `cat -n` หมายเลขบรรทัดเริ่มจาก 1
+- PDF ขนาดใหญ่ (เกิน 10 หน้า) ต้องระบุพารามิเตอร์ `pages` สูงสุด 20 หน้าต่อครั้ง
+- การอ่านไฟล์ที่ไม่มีอยู่จะส่งคืนข้อผิดพลาด (ไม่ทำให้ล่ม)
+- สามารถเรียก Read หลายครั้งพร้อมกันในข้อความเดียว
+
+## ความสำคัญใน cc-viewer
+
+การเรียก Read ปรากฏในบันทึกคำร้องขอเป็นคู่ content block `tool_use` (การเรียก) และ `tool_result` (เนื้อหาที่ส่งคืน) โดย `tool_result` มีเนื้อหาจริงของไฟล์ สามารถใช้วิเคราะห์ว่าโมเดลอ่านไฟล์ใดบ้าง

package/concepts/th/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## คำจำกัดความ
+
+รันทักษะ (skill) ในการสนทนาหลัก ทักษะคือความสามารถเฉพาะทางที่ผู้ใช้สามารถเรียกใช้ผ่าน slash command (เช่น `/commit`, `/review-pr`)
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `skill` | string | ใช่ | ชื่อทักษะ (เช่น "commit", "review-pr", "pdf") |
+| `args` | string | ไม่ | อาร์กิวเมนต์ของทักษะ |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ผู้ใช้ป้อน slash command ในรูปแบบ `/<skill-name>`
+- คำร้องขอของผู้ใช้ตรงกับฟังก์ชันของทักษะที่ลงทะเบียนไว้
+
+**ไม่เหมาะสำหรับ:**
+- คำสั่ง CLI ในตัว (เช่น `/help`, `/clear`)
+- ทักษะที่กำลังทำงานอยู่แล้ว
+- ชื่อทักษะที่ไม่อยู่ในรายการทักษะที่ใช้ได้
+
+## ข้อควรระวัง
+
+- หลังจากถูกเรียก ทักษะจะขยายเป็น prompt ที่สมบูรณ์
+- รองรับชื่อแบบเต็ม (เช่น `ms-office-suite:pdf`)
+- รายการทักษะที่ใช้ได้จะอยู่ในข้อความ system-reminder
+- เมื่อเห็นแท็ก `<command-name>` แสดงว่าทักษะถูกโหลดแล้ว ควรดำเนินการโดยตรงโดยไม่ต้องเรียกเครื่องมือนี้อีก
+- อย่ากล่าวถึงทักษะโดยไม่ได้เรียกเครื่องมือจริง
+
+## ความสำคัญใน cc-viewer
+
+การเรียก Skill ปรากฏในบันทึกคำร้องขอเป็น content block `tool_use` prompt ที่ขยายจากทักษะจะส่งผลต่อ system prompt หรือเนื้อหาข้อความของคำร้องขอถัดไป

package/concepts/th/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## คำจำกัดความ
+
+เริ่มต้น sub-agent (SubAgent) เพื่อจัดการงานหลายขั้นตอนที่ซับซ้อนอย่างอิสระ Sub-agent เป็นกระบวนการย่อยอิสระ แต่ละตัวมีชุดเครื่องมือและบริบทเฉพาะของตัวเอง
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `prompt` | string | ใช่ | คำอธิบายงานที่ sub-agent จะดำเนินการ |
+| `description` | string | ใช่ | สรุปสั้น 3-5 คำ |
+| `subagent_type` | string | ใช่ | ประเภท sub-agent กำหนดชุดเครื่องมือที่ใช้ได้ |
+| `model` | enum | ไม่ | ระบุโมเดล (sonnet / opus / haiku) ค่าเริ่มต้นสืบทอดจากพาเรนต์ |
+| `max_turns` | integer | ไม่ | จำนวนรอบ agentic สูงสุด |
+| `run_in_background` | boolean | ไม่ | รันในเบื้องหลังหรือไม่ งานเบื้องหลังส่งคืนพาธ output_file |
+| `resume` | string | ไม่ | ID ของ agent ที่จะกลับมาทำต่อ ดำเนินการต่อจากการรันครั้งก่อน |
+| `isolation` | enum | ไม่ | โหมดแยกส่วน `worktree` สร้าง git worktree ชั่วคราว |
+
+## ประเภท Sub-agent
+
+| ประเภท | วัตถุประสงค์ | เครื่องมือที่ใช้ได้ |
+|------|------|----------|
+| `Bash` | รันคำสั่ง การดำเนินการ git | Bash |
+| `general-purpose` | งานทั่วไปหลายขั้นตอน | เครื่องมือทั้งหมด |
+| `Explore` | สำรวจโค้ดเบสอย่างรวดเร็ว | ทั้งหมดยกเว้น Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | ออกแบบแผนการดำเนินงาน | ทั้งหมดยกเว้น Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | ถาม-ตอบเกี่ยวกับคู่มือการใช้ Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | ตั้งค่าแถบสถานะ | Read, Edit |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- งานซับซ้อนที่ต้องดำเนินการหลายขั้นตอนอย่างอิสระ
+- การสำรวจและวิจัยเชิงลึกของโค้ดเบส (ใช้ประเภท Explore)
+- งานคู่ขนานที่ต้องการสภาพแวดล้อมแยก
+- งานที่ใช้เวลานานที่ต้องรันในเบื้องหลัง
+
+**ไม่เหมาะสำหรับ:**
+- อ่านพาธไฟล์เฉพาะ — ใช้ Read หรือ Glob โดยตรง
+- ค้นหาใน 2-3 ไฟล์ที่รู้จัก — ใช้ Read โดยตรง
+- ค้นหาคำจำกัดความคลาสเฉพาะ — ใช้ Glob โดยตรง
+
+## ข้อควรระวัง
+
+- หลังจากเสร็จสิ้น sub-agent จะส่งคืนข้อความเดียว ผลลัพธ์ไม่ปรากฏให้ผู้ใช้เห็น agent หลักต้องถ่ายทอดให้
+- สามารถเริ่มการเรียก Task หลายรายการพร้อมกันในข้อความเดียวเพื่อเพิ่มประสิทธิภาพ
+- งานเบื้องหลังตรวจสอบความคืบหน้าผ่านเครื่องมือ TaskOutput
+- ประเภท Explore ช้ากว่าการเรียก Glob/Grep โดยตรง ใช้เฉพาะเมื่อการค้นหาง่ายๆ ไม่เพียงพอ
+
+## ความสำคัญใน cc-viewer
+
+การเรียก Task จะสร้างสายคำร้องขอ SubAgent ซึ่งสามารถเห็นในรายการคำร้องขอเป็นลำดับคำร้องขอย่อยที่แยกจาก MainAgent คำร้องขอ SubAgent มักมี system prompt แบบย่อและคำจำกัดความเครื่องมือน้อยกว่า ซึ่งแตกต่างอย่างชัดเจนจาก MainAgent

package/concepts/th/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## คำจำกัดความ
+
+สร้างรายการในรายการงานแบบมีโครงสร้าง ใช้สำหรับติดตามความคืบหน้า จัดระเบียบงานที่ซับซ้อน และแสดงความคืบหน้าของงานให้ผู้ใช้เห็น
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `subject` | string | ใช่ | หัวข้องานสั้น ใช้รูปแบบคำสั่ง (เช่น "Fix authentication bug") |
+| `description` | string | ใช่ | คำอธิบายโดยละเอียด รวมถึงบริบทและเกณฑ์การยอมรับ |
+| `activeForm` | string | ไม่ | ข้อความรูปแบบกำลังดำเนินการที่แสดงเมื่อกำลังทำงาน (เช่น "Fixing authentication bug") |
+| `metadata` | object | ไม่ | ข้อมูลเมตาที่แนบกับงาน |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- งานหลายขั้นตอนที่ซับซ้อน (มากกว่า 3 ขั้นตอน)
+- ผู้ใช้ให้รายการสิ่งที่ต้องทำหลายรายการ
+- ติดตามงานในโหมดวางแผน
+- ผู้ใช้ร้องขออย่างชัดเจนให้ใช้รายการ todo
+
+**ไม่เหมาะสำหรับ:**
+- งานเดียวที่ง่าย
+- การดำเนินการง่ายๆ ไม่เกิน 3 ขั้นตอน
+- การสนทนาหรือการสอบถามข้อมูลล้วนๆ
+
+## ข้อควรระวัง
+
+- งานที่สร้างใหม่ทั้งหมดมีสถานะเริ่มต้นเป็น `pending`
+- `subject` ใช้รูปแบบคำสั่ง ("Run tests"), `activeForm` ใช้รูปแบบกำลังดำเนินการ ("Running tests")
+- หลังจากสร้างงาน สามารถตั้งค่าความสัมพันธ์การพึ่งพา (blocks/blockedBy) ผ่าน TaskUpdate
+- ก่อนสร้าง ควรเรียก TaskList เพื่อตรวจสอบว่ามีงานซ้ำหรือไม่
+
+## ความสำคัญใน cc-viewer
+
+TaskCreate เป็นการดำเนินการจัดการงานภายในของ Claude Code ไม่สร้างคำร้องขอ API อิสระ แต่ใน Chat Mode สามารถเห็น tool_use block ที่โมเดลเรียกเครื่องมือนี้ได้

package/concepts/th/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## คำจำกัดความ
+
+รับรายละเอียดงานทั้งหมดผ่าน ID ของงาน
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `taskId` | string | ใช่ | ID ของงานที่จะรับข้อมูล |
+
+## เนื้อหาที่ส่งคืน
+
+- `subject` — หัวข้องาน
+- `description` — ข้อกำหนดโดยละเอียดและบริบท
+- `status` — สถานะ: `pending`, `in_progress` หรือ `completed`
+- `blocks` — รายการงานที่ถูกบล็อกโดยงานนี้
+- `blockedBy` — รายการงานเงื่อนไขก่อนหน้าที่บล็อกงานนี้
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- รับคำอธิบายและบริบทที่สมบูรณ์ของงานก่อนเริ่มทำงาน
+- ทำความเข้าใจความสัมพันธ์การพึ่งพาของงาน
+- รับข้อกำหนดที่สมบูรณ์หลังจากได้รับมอบหมายงาน
+
+## ข้อควรระวัง
+
+- หลังจากรับงาน ควรตรวจสอบว่ารายการ `blockedBy` ว่างเปล่าก่อนเริ่มทำงาน
+- ใช้ TaskList เพื่อดูข้อมูลสรุปของงานทั้งหมด
+
+## ความสำคัญใน cc-viewer
+
+TaskGet เป็นการดำเนินการจัดการงานภายใน ไม่สร้างคำร้องขอ API อิสระ

package/concepts/th/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## คำจำกัดความ
+
+แสดงรายการงานทั้งหมดในรายการงาน เพื่อดูความคืบหน้าโดยรวมและงานที่พร้อมทำ
+
+## พารามิเตอร์
+
+ไม่มีพารามิเตอร์
+
+## เนื้อหาที่ส่งคืน
+
+ข้อมูลสรุปของแต่ละงาน:
+- `id` — ตัวระบุงาน
+- `subject` — คำอธิบายสั้น
+- `status` — สถานะ: `pending`, `in_progress` หรือ `completed`
+- `owner` — ผู้รับผิดชอบ (ID ของ agent) ว่างหมายถึงยังไม่ได้มอบหมาย
+- `blockedBy` — รายการ ID ของงานที่ยังไม่เสร็จที่บล็อกงานนี้
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ดูว่ามีงานใดพร้อมทำ (สถานะ pending ไม่มี owner ไม่ถูกบล็อก)
+- ตรวจสอบความคืบหน้าโดยรวมของโปรเจกต์
+- ค้นหางานที่ถูกบล็อก
+- ค้นหางานถัดไปหลังจากทำงานเสร็จ
+
+## ข้อควรระวัง
+
+- ควรดำเนินการงานตามลำดับ ID (ID น้อยสุดก่อน) เพราะงานก่อนหน้ามักให้บริบทสำหรับงานถัดไป
+- งานที่มี `blockedBy` ไม่สามารถรับมาทำได้จนกว่าการพึ่งพาจะถูกแก้ไข
+- ใช้ TaskGet เพื่อรับรายละเอียดที่สมบูรณ์ของงานเฉพาะ
+
+## ความสำคัญใน cc-viewer
+
+TaskList เป็นการดำเนินการจัดการงานภายใน ไม่สร้างคำร้องขอ API อิสระ

package/concepts/th/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## คำจำกัดความ
+
+รับผลลัพธ์ของงานเบื้องหลังที่กำลังทำงานหรือเสร็จสิ้นแล้ว ใช้ได้กับ shell เบื้องหลัง agent แบบอะซิงโครนัส และเซสชันระยะไกล
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `task_id` | string | ใช่ | ID ของงาน |
+| `block` | boolean | ใช่ | บล็อกรอจนกว่างานจะเสร็จหรือไม่ ค่าเริ่มต้น `true` |
+| `timeout` | number | ใช่ | เวลารอสูงสุด (มิลลิวินาที) ค่าเริ่มต้น 30000 สูงสุด 600000 |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ตรวจสอบความคืบหน้าของ agent เบื้องหลังที่เริ่มผ่าน Task (`run_in_background: true`)
+- รับผลลัพธ์การรันคำสั่ง Bash เบื้องหลัง
+- รอให้งานอะซิงโครนัสเสร็จสิ้นและรับผลลัพธ์
+
+**ไม่เหมาะสำหรับ:**
+- งานเบื้องหน้า — งานเบื้องหน้าส่งคืนผลลัพธ์โดยตรง ไม่ต้องใช้เครื่องมือนี้
+
+## ข้อควรระวัง
+
+- `block: true` จะบล็อกจนกว่างานจะเสร็จหรือหมดเวลา
+- `block: false` ใช้สำหรับตรวจสอบสถานะปัจจุบันแบบไม่บล็อก
+- ID ของงานสามารถค้นหาได้ผ่านคำสั่ง `/tasks`
+- ใช้ได้กับงานทุกประเภท: shell เบื้องหลัง, agent แบบอะซิงโครนัส, เซสชันระยะไกล
+
+## ความสำคัญใน cc-viewer
+
+การเรียก TaskOutput ไม่สร้างคำร้องขอ API เป็นการดำเนินการจัดการงานภายในของ Claude Code และไม่ปรากฏในบันทึกคำร้องขอ

package/concepts/th/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## คำจำกัดความ
+
+หยุดงานเบื้องหลังที่กำลังทำงานอยู่
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `task_id` | string | ไม่ | ID ของงานเบื้องหลังที่จะหยุด |
+| `shell_id` | string | ไม่ | เลิกใช้แล้ว ใช้ `task_id` แทน |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ยุติงานที่ทำงานนานที่ไม่ต้องการอีกต่อไป
+- ยกเลิกงานเบื้องหลังที่เริ่มผิดพลาด
+
+## ข้อควรระวัง
+
+- ส่งคืนสถานะสำเร็จหรือล้มเหลว
+- พารามิเตอร์ `shell_id` เลิกใช้แล้ว ควรใช้ `task_id`
+
+## ความสำคัญใน cc-viewer
+
+การเรียก TaskStop ไม่สร้างคำร้องขอ API เป็นการดำเนินการจัดการงานภายในของ Claude Code

package/concepts/th/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## คำจำกัดความ
+
+อัปเดตสถานะ เนื้อหา หรือความสัมพันธ์การพึ่งพาของงานในรายการงาน
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `taskId` | string | ใช่ | ID ของงานที่จะอัปเดต |
+| `status` | enum | ไม่ | สถานะใหม่: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | ไม่ | หัวข้อใหม่ |
+| `description` | string | ไม่ | คำอธิบายใหม่ |
+| `activeForm` | string | ไม่ | ข้อความรูปแบบกำลังดำเนินการที่แสดงเมื่อกำลังทำงาน |
+| `owner` | string | ไม่ | ผู้รับผิดชอบงานใหม่ (ชื่อ agent) |
+| `metadata` | object | ไม่ | ข้อมูลเมตาที่จะรวม (ตั้งเป็น null เพื่อลบคีย์) |
+| `addBlocks` | string[] | ไม่ | รายการ ID ของงานที่ถูกบล็อกโดยงานนี้ |
+| `addBlockedBy` | string[] | ไม่ | รายการ ID ของงานเงื่อนไขก่อนหน้าที่บล็อกงานนี้ |
+
+## การเปลี่ยนสถานะ
+
+```
+pending → in_progress → completed
+```
+
+`deleted` สามารถเปลี่ยนจากสถานะใดก็ได้ ลบงานอย่างถาวร
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ทำเครื่องหมายงานเป็น `in_progress` เมื่อเริ่มทำงาน
+- ทำเครื่องหมายงานเป็น `completed` หลังจากทำงานเสร็จ
+- ตั้งค่าความสัมพันธ์การพึ่งพาระหว่างงาน
+- อัปเดตเนื้อหางานเมื่อข้อกำหนดเปลี่ยนแปลง
+
+**กฎสำคัญ:**
+- ทำเครื่องหมายเป็น `completed` เฉพาะเมื่อทำงานเสร็จสมบูรณ์เท่านั้น
+- คงสถานะ `in_progress` เมื่อพบข้อผิดพลาดหรือการบล็อก
+- ห้ามทำเครื่องหมายเป็น `completed` เมื่อการทดสอบล้มเหลว การดำเนินงานไม่สมบูรณ์ หรือมีข้อผิดพลาดที่ยังไม่ได้แก้ไข
+
+## ข้อควรระวัง
+
+- ก่อนอัปเดต ควรรับสถานะล่าสุดของงานผ่าน TaskGet เพื่อหลีกเลี่ยงข้อมูลที่ล้าสมัย
+- หลังจากทำงานเสร็จ เรียก TaskList เพื่อค้นหางานถัดไปที่พร้อมทำ
+
+## ความสำคัญใน cc-viewer
+
+TaskUpdate เป็นการดำเนินการจัดการงานภายใน ไม่สร้างคำร้องขอ API อิสระ

package/concepts/th/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## คำจำกัดความ
+
+ดึงเนื้อหาเว็บเพจจาก URL ที่ระบุ แปลง HTML เป็น markdown และประมวลผลเนื้อหาด้วยโมเดล AI ตาม prompt
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `url` | string (URI) | ใช่ | URL แบบเต็มที่จะดึงข้อมูล |
+| `prompt` | string | ใช่ | อธิบายว่าต้องการสกัดข้อมูลอะไรจากหน้าเว็บ |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- ดึงเนื้อหาจากเว็บเพจสาธารณะ
+- ดูเอกสารออนไลน์
+- สกัดข้อมูลเฉพาะจากเว็บเพจ
+
+**ไม่เหมาะสำหรับ:**
+- URL ที่ต้องการการยืนยันตัวตน (Google Docs, Confluence, Jira, GitHub ฯลฯ) — ควรค้นหาเครื่องมือ MCP เฉพาะทางก่อน
+- URL ของ GitHub — ควรใช้ CLI `gh` แทน
+
+## ข้อควรระวัง
+
+- URL ต้องเป็น URL ที่ถูกต้องแบบเต็ม
+- HTTP จะถูกอัปเกรดเป็น HTTPS โดยอัตโนมัติ
+- ผลลัพธ์อาจถูกสรุปเมื่อเนื้อหามีขนาดใหญ่เกินไป
+- มีแคชที่ทำความสะอาดตัวเองทุก 15 นาที
+- เมื่อ URL เปลี่ยนเส้นทางไปยังโฮสต์อื่น เครื่องมือจะส่งคืน URL เปลี่ยนเส้นทาง ต้องร้องขอใหม่ด้วย URL ใหม่
+- หากมีเครื่องมือ web fetch จาก MCP ที่ใช้ได้ ให้ใช้เครื่องมือนั้นแทน
+
+## ความสำคัญใน cc-viewer
+
+การเรียก WebFetch ปรากฏในบันทึกคำร้องขอเป็นคู่ content block `tool_use` / `tool_result` โดย `tool_result` มีสรุปเนื้อหาเว็บเพจที่ประมวลผลโดย AI

package/concepts/th/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## คำจำกัดความ
+
+ค้นหาผ่านเครื่องมือค้นหา ส่งคืนผลลัพธ์การค้นหาเพื่อรับข้อมูลล่าสุด
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `query` | string | ใช่ | คำค้นหา (อย่างน้อย 2 ตัวอักษร) |
+| `allowed_domains` | string[] | ไม่ | รวมเฉพาะผลลัพธ์จากโดเมนเหล่านี้ |
+| `blocked_domains` | string[] | ไม่ | ไม่รวมผลลัพธ์จากโดเมนเหล่านี้ |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- รับข้อมูลล่าสุดที่เกินวันตัดความรู้ของโมเดล
+- ค้นหาเหตุการณ์ปัจจุบันและข้อมูลล่าสุด
+- ค้นหาเอกสารทางเทคนิคล่าสุด
+
+## ข้อควรระวัง
+
+- ผลลัพธ์การค้นหาส่งคืนในรูปแบบไฮเปอร์ลิงก์ markdown
+- หลังจากใช้ ต้องแนบส่วน "Sources:" ที่ท้ายคำตอบ โดยแสดงรายการ URL ที่เกี่ยวข้อง
+- รองรับการกรองโดเมน (รวม/ไม่รวม)
+- คำค้นหาควรใช้ปีปัจจุบัน
+- ใช้ได้เฉพาะในสหรัฐอเมริกา
+
+## ความสำคัญใน cc-viewer
+
+การเรียก WebSearch ปรากฏในบันทึกคำร้องขอเป็นคู่ content block `tool_use` / `tool_result` โดย `tool_result` มีรายการผลลัพธ์การค้นหา

package/concepts/th/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## คำจำกัดความ
+
+เขียนเนื้อหาลงในระบบไฟล์ในเครื่อง หากไฟล์มีอยู่แล้วจะถูกเขียนทับ
+
+## พารามิเตอร์
+
+| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
+|------|------|------|------|
+| `file_path` | string | ใช่ | พาธแบบสัมบูรณ์ของไฟล์ (ต้องเป็นพาธแบบสัมบูรณ์) |
+| `content` | string | ใช่ | เนื้อหาที่จะเขียน |
+
+## สถานการณ์การใช้งาน
+
+**เหมาะสำหรับ:**
+- สร้างไฟล์ใหม่
+- เมื่อต้องเขียนเนื้อหาไฟล์ใหม่ทั้งหมด
+
+**ไม่เหมาะสำหรับ:**
+- แก้ไขเนื้อหาบางส่วนในไฟล์ — ควรใช้ Edit
+- ไม่ควรสร้างไฟล์เอกสาร (*.md) หรือ README โดยอัตโนมัติ เว้นแต่ผู้ใช้ร้องขออย่างชัดเจน
+
+## ข้อควรระวัง
+
+- หากไฟล์เป้าหมายมีอยู่แล้ว ต้องอ่านผ่าน Read ก่อน มิฉะนั้นจะล้มเหลว
+- จะเขียนทับเนื้อหาทั้งหมดของไฟล์ที่มีอยู่
+- ควรใช้ Edit สำหรับแก้ไขไฟล์ที่มีอยู่ Write ใช้เฉพาะสำหรับสร้างไฟล์ใหม่หรือเขียนใหม่ทั้งหมด
+
+## ความสำคัญใน cc-viewer
+
+การเรียก Write ปรากฏในบันทึกคำร้องขอเป็น content block `tool_use` ซึ่ง `input.content` มีเนื้อหาที่เขียนทั้งหมด

package/concepts/th/Tool-executeCode.md

@@ -0,0 +1,33 @@
+# 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
+
+## ความสำคัญใน cc-viewer
+
+executeCode เป็นเครื่องมือ MCP ปรากฏในอาร์เรย์ `tools` ของบันทึกคำร้องขอด้วยชื่อ `mcp__ide__executeCode` การเรียกและส่งคืนเป็นไปตามรูปแบบ `tool_use` / `tool_result` มาตรฐาน การเพิ่ม/ลบเครื่องมือ MCP ทำให้อาร์เรย์ tools เปลี่ยนแปลง ซึ่งอาจทำให้เกิดการสร้างแคชใหม่

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 เพื่อตรวจสอบปัญหาโค้ด
+
+## ความสำคัญใน cc-viewer
+
+getDiagnostics เป็นเครื่องมือ MCP ปรากฏในอาร์เรย์ `tools` ของบันทึกคำร้องขอด้วยชื่อ `mcp__ide__getDiagnostics` การเรียกและส่งคืนเป็นไปตามรูปแบบ `tool_use` / `tool_result` มาตรฐาน การเพิ่ม/ลบเครื่องมือ MCP ทำให้อาร์เรย์ tools เปลี่ยนแปลง ซึ่งอาจทำให้เกิดการสร้างแคชใหม่