cc-viewer 1.6.182 → 1.6.183

package/concepts/th/Tool-EnterWorktree.md

@@ -1,56 +1,44 @@
 # EnterWorktree
 
-## คำจำกัดความ
+สร้าง Git worktree ที่แยกต่างหากบน branch ใหม่ หรือสลับ session เข้าไปใน worktree ที่มีอยู่แล้วของ repository ปัจจุบัน เพื่อให้งานแบบขนานหรือทดลองดำเนินการได้โดยไม่แตะ checkout หลัก
 
-Creates an isolated git worktree and switches the current session into it. Only used when the user explicitly asks to work in a worktree.
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
-
-| Name | Type | Required | Description |
-|---|---|---|---|
-| name | string | No | A name for the worktree. If not provided, a random name is generated. |
-
-## กรณีการใช้งาน
+- ผู้ใช้บอกชัดเจนว่า "worktree" — เช่น "start a worktree", "create a worktree", หรือ "work in a worktree"
+- คำสั่งโปรเจกต์ใน `CLAUDE.md` หรือ persistent memory สั่งให้ใช้ worktree สำหรับงานปัจจุบัน
+- คุณต้องการทำงานต่อที่เคยตั้งค่าไว้เป็น worktree ก่อนหน้า (ส่ง `path` เพื่อเข้าอีกครั้ง)
+- Branch ทดลองหลายตัวต้องอยู่ร่วมกันบน disk โดยไม่ต้อง checkout เปลี่ยนไปมา
+- งานที่รันนานควรแยกออกจากการแก้ไขที่ไม่เกี่ยวข้องใน working tree หลัก
 
-**เหมาะสำหรับ:**
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree")
-
-**ไม่เหมาะสำหรับ:**
-- The user asks to create/switch branches — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-
-## หมายเหตุ
-
-- Must be in a git repository, or have WorktreeCreate/WorktreeRemove hooks configured
-- Must not already be in a worktree
-
-## ข้อความต้นฉบับ
-
-<textarea readonly>Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.
+## พารามิเตอร์
 
-## When to Use
+- `name` (string, optional): ชื่อสำหรับ directory worktree ใหม่ แต่ละ segment ที่คั่นด้วย `/` ต้องมีเฉพาะตัวอักษร ตัวเลข จุด underscore และ dash; string เต็มจำกัดที่ 64 อักขระ หากละเว้นและ `path` ก็ละเว้นด้วย จะสร้างชื่อสุ่ม ใช้ร่วมกับ `path` ไม่ได้
+- `path` (string, optional): filesystem path ของ worktree ที่มีอยู่แล้วของ repository ปัจจุบันที่จะสลับเข้าไป ต้องปรากฏใน `git worktree list` สำหรับ repo นี้; path ที่ไม่ใช่ worktree ที่ลงทะเบียนของ repo ปัจจุบันจะถูกปฏิเสธ ใช้ร่วมกับ `name` ไม่ได้
 
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")
+## ตัวอย่าง
 
-## When NOT to Use
+### ตัวอย่างที่ 1: สร้าง worktree ใหม่ด้วยชื่อที่บรรยาย
 
-- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-- Never use this tool unless the user explicitly mentions "worktree"
+```
+EnterWorktree(name="feat/okta-sso")
+```
 
-## Requirements
+สร้าง `.claude/worktrees/feat/okta-sso` บน branch ใหม่ตาม `HEAD` แล้วสลับ working directory ของ session เข้าไป การแก้ไขไฟล์และ shell command ทั้งหมดต่อจากนี้จะทำภายใน worktree นั้นจนกว่าคุณจะออก
 
-- Must be in a git repository, OR have WorktreeCreate/WorktreeRemove hooks configured in settings.json
-- Must not already be in a worktree
+### ตัวอย่างที่ 2: เข้า worktree ที่มีอยู่แล้วอีกครั้ง
 
-## Behavior
+```
+EnterWorktree(path="/Users/me/repo/.claude/worktrees/feat/okta-sso")
+```
 
-- In a git repository: creates a new git worktree inside `.claude/worktrees/` with a new branch based on HEAD
-- Outside a git repository: delegates to WorktreeCreate/WorktreeRemove hooks for VCS-agnostic isolation
-- Switches the session's working directory to the new worktree
-- On session exit, the user will be prompted to keep or remove the worktree
+ทำงานต่อใน worktree ที่สร้างไว้ก่อนหน้า เพราะคุณเข้าผ่าน `path`, `ExitWorktree` จะไม่ลบมันโดยอัตโนมัติ — ออกด้วย `action: "keep"` จะแค่กลับไปยัง directory เดิม
 
-## Parameters
+## หมายเหตุ
 
-- `name` (optional): A name for the worktree. If not provided, a random name is generated.
-</textarea>
+- อย่าเรียก `EnterWorktree` เว้นแต่ผู้ใช้ขอชัดเจนหรือคำสั่งโปรเจกต์กำหนด คำขอสลับ branch หรือแก้บั๊กทั่วไปควรใช้คำสั่ง Git ปกติ ไม่ใช่ worktree
+- เมื่อเรียกภายใน Git repository, tool จะสร้าง worktree ใต้ `.claude/worktrees/` และลงทะเบียน branch ใหม่ตาม `HEAD` ภายนอก Git repository มันจะ delegate ไปยัง `WorktreeCreate` / `WorktreeRemove` hook ที่ตั้งไว้ใน `settings.json` สำหรับการแยกที่ไม่ขึ้นกับ VCS
+- มีเพียง worktree session เดียวที่ active ณ เวลาใดเวลาหนึ่ง Tool ปฏิเสธที่จะรันหากคุณอยู่ใน worktree session อยู่แล้ว ออกก่อนด้วย `ExitWorktree`
+- ใช้ `ExitWorktree` เพื่อออกกลางคัน หาก session จบในขณะที่ยังอยู่ใน worktree ที่เพิ่งสร้าง ผู้ใช้จะได้รับ prompt ให้เลือกเก็บหรือลบ
+- Worktree ที่เข้าโดย `path` ถือเป็น external — `ExitWorktree` ด้วย `action: "remove"` จะไม่ลบมัน นี่คือ safety rail ในการปกป้อง worktree ที่ผู้ใช้จัดการเอง
+- Worktree ใหม่สืบทอดเนื้อหาของ branch ปัจจุบันแต่มี working directory และ index อิสระ การเปลี่ยนแปลงที่ staged และ unstaged ใน checkout หลักไม่ visible ภายใน worktree
+- เคล็ดการตั้งชื่อ: ใส่ prefix ตามประเภทงาน (`feat/`, `fix/`, `spike/`) เพื่อให้แยก worktree พร้อมกันหลายตัวได้ง่ายใน `git worktree list`

package/concepts/th/Tool-ExitPlanMode.md

@@ -1,62 +1,42 @@
 # ExitPlanMode
 
-## คำจำกัดความ
+ส่งแผนการ implement ที่ร่างไว้ระหว่าง plan mode เพื่อให้ผู้ใช้อนุมัติ และหากได้รับอนุมัติ จะเปลี่ยน session ออกจาก plan mode เพื่อให้เริ่มแก้ไขได้
 
-ออกจากโหมดวางแผนและส่งแผนให้ผู้ใช้อนุมัติ เนื้อหาแผนจะถูกอ่านจากไฟล์แผนที่เขียนไว้ก่อนหน้า
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
-
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `allowedPrompts` | array | ไม่ | รายการคำอธิบายสิทธิ์ที่จำเป็นสำหรับแผนการดำเนินงาน |
-
-แต่ละองค์ประกอบในอาร์เรย์ `allowedPrompts`:
-
-| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `tool` | enum | ใช่ | เครื่องมือที่ใช้ได้ ปัจจุบันรองรับเฉพาะ `Bash` |
-| `prompt` | string | ใช่ | คำอธิบายเชิงความหมายของการดำเนินงาน (เช่น "run tests", "install dependencies") |
+- แผนที่เขียนระหว่าง `EnterPlanMode` เสร็จสมบูรณ์และพร้อม review
+- งานเน้นการ implement (การเปลี่ยนแปลงโค้ดหรือ config) ไม่ใช่การวิจัยล้วน ดังนั้นแผนที่ชัดเจนจึงเหมาะสม
+- การอ่านและวิเคราะห์ที่จำเป็นทั้งหมดได้ทำแล้ว ไม่ต้องการการสืบสวนเพิ่มก่อนที่ผู้ใช้จะตัดสินใจ
+- ผู้ช่วยได้ระบุ path ของไฟล์ function และขั้นตอนที่เป็นรูปธรรม — ไม่ใช่แค่เป้าหมาย
+- ผู้ใช้ขอดูแผน หรือ workflow plan-mode กำลังจะส่งต่อไปยัง edit tool
 
-## สถานการณ์การใช้งาน
-
-**เหมาะสำหรับ:**
-- ในโหมดวางแผน เมื่อแผนเสร็จสมบูรณ์และพร้อมส่งให้ผู้ใช้อนุมัติ
-- ใช้เฉพาะสำหรับงานดำเนินการที่ต้องเขียนโค้ด
-
-**ไม่เหมาะสำหรับ:**
-- งานวิจัย/สำรวจล้วนๆ — ไม่จำเป็นต้องออกจากโหมดวางแผน
-- ต้องการถามผู้ใช้ว่า "แผนนี้โอเคไหม?" — นี่คือฟังก์ชันของเครื่องมือนี้เอง อย่าใช้ AskUserQuestion เพื่อถาม
-
-## ข้อควรระวัง
+## พารามิเตอร์
 
-- เครื่องมือนี้ไม่รับเนื้อหาแผนเป็นพารามิเตอร์ — มันอ่านจากไฟล์แผนที่เขียนไว้ก่อนหน้า
-- ผู้ใช้จะเห็นเนื้อหาของไฟล์แผนเพื่ออนุมัติ
-- อย่าใช้ AskUserQuestion ถามว่า "แผนโอเคไหม?" ก่อนเรียกเครื่องมือนี้ เพราะเป็นการซ้ำซ้อน
-- อย่ากล่าวถึง "แผน" ในคำถาม เพราะผู้ใช้ไม่สามารถเห็นเนื้อหาแผนก่อน ExitPlanMode
+- `allowedPrompts` (array, optional): prompt ที่ผู้ใช้พิมพ์ได้บนหน้าจออนุมัติเพื่ออนุมัติอัตโนมัติหรือแก้ไขแผน แต่ละ element ระบุ permission ที่มีขอบเขต (เช่น ชื่อการดำเนินการและ tool ที่ใช้กับมัน) ปล่อยว่างเพื่อใช้ default approval flow
 
-## ข้อความต้นฉบับ
+## ตัวอย่าง
 
-<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
+### ตัวอย่างที่ 1: การส่งมาตรฐาน
 
-## How This Tool Works
-- You should have already written your plan to the plan file specified in the plan mode system message
-- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
-- This tool simply signals that you're done planning and ready for the user to review and approve
-- The user will see the contents of your plan file when they review it
+หลังจากสืบสวน authentication refactor ภายใน plan mode และเขียนไฟล์แผนลง disk ผู้ช่วยเรียก `ExitPlanMode` โดยไม่มี argument Harness อ่านแผนจากตำแหน่งมาตรฐาน แสดงต่อผู้ใช้ และรอการอนุมัติหรือปฏิเสธ
 
-## When to Use This Tool
-IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+### ตัวอย่างที่ 2: Quick action ที่อนุมัติไว้ล่วงหน้า
 
-## Before Using This Tool
-Ensure your plan is complete and unambiguous:
-- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
-- Once your plan is finalized, use THIS tool to request approval
+```
+ExitPlanMode(allowedPrompts=[
+  {"tool": "Bash", "prompt": "run tests"},
+  {"tool": "Bash", "prompt": "install dependencies"}
+])
+```
 
-**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
+ให้ผู้ใช้ให้ permission ล่วงหน้าสำหรับคำสั่ง follow-up ธรรมดา เพื่อให้ผู้ช่วยไม่ต้องหยุดเพื่อ permission prompt แต่ละครั้งระหว่าง implement
 
-## Examples
+## หมายเหตุ
 
-1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
-2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
-3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
-</textarea>
+- `ExitPlanMode` เหมาะกับงานประเภท implement เท่านั้น หากคำขอของผู้ใช้เป็นงานวิจัยหรือการอธิบายที่ไม่มีการเปลี่ยนแปลงไฟล์ ตอบโดยตรงแทน — อย่า route ผ่าน plan mode เพียงเพื่อออก
+- แผนต้องเขียนลง disk แล้วก่อนเรียก tool นี้ `ExitPlanMode` ไม่รับ body ของแผนเป็น parameter; มันอ่านจาก path ที่ harness คาดไว้
+- หากผู้ใช้ปฏิเสธแผน คุณกลับไปที่ plan mode แก้ไขตาม feedback และส่งอีกครั้ง; อย่าเริ่มแก้ไขไฟล์ขณะที่แผนไม่ได้รับอนุมัติ
+- การอนุมัติให้สิทธิ์ออกจาก plan mode และใช้ tool ที่แก้ไข (`Edit`, `Write`, `Bash`, และอื่นๆ) สำหรับขอบเขตที่อธิบายในแผน การขยายขอบเขตหลังจากนั้นต้องมีแผนใหม่หรือ consent ของผู้ใช้ที่ชัดเจน
+- อย่าใช้ `AskUserQuestion` ถามว่า "แผนนี้ดูโอเคไหม?" ก่อนเรียก tool นี้ — การขอการอนุมัติแผนคือสิ่งที่ `ExitPlanMode` ทำอยู่พอดี และผู้ใช้ไม่สามารถเห็นแผนจนกว่าจะถูกส่ง
+- ทำให้แผนน้อยที่สุดและปฏิบัติได้ ผู้ review ควรสามารถสแกนได้ในไม่ถึงนาทีและเข้าใจอย่างแน่ชัดว่าจะเปลี่ยนแปลงอะไร
+- หากคุณตระหนักกลางการ implement ว่าแผนผิด ให้หยุดและรายงานกลับไปยังผู้ใช้แทนที่จะเบี่ยงเบนอย่างเงียบๆ การกลับเข้า plan mode เป็นขั้นตอนถัดไปที่ใช้ได้

package/concepts/th/Tool-ExitWorktree.md

@@ -0,0 +1,42 @@
+# ExitWorktree
+
+ออกจากเซสชัน worktree ที่สร้างขึ้นก่อนหน้านี้โดย `EnterWorktree` และคืนค่าเซสชันกลับสู่ไดเรกทอรีทำงานเดิม เครื่องมือนี้ทำงานเฉพาะกับ worktree ที่สร้างโดย `EnterWorktree` ในเซสชันปัจจุบันเท่านั้น หากไม่มีเซสชันดังกล่าวที่ใช้งานอยู่ การเรียกใช้จะไม่มีผลใดๆ
+
+## เมื่อใดควรใช้
+
+- งานใน worktree แบบแยกส่วนเสร็จสิ้นแล้ว และต้องการกลับสู่ไดเรกทอรีทำงานหลัก
+- งานใน worktree ของสาขาฟีเจอร์เสร็จสิ้นและทำ merge แล้ว ต้องการลบสาขาและไดเรกทอรีทิ้ง
+- ต้องการเก็บ worktree ไว้ใช้งานภายหลัง โดยเพียงแค่กลับสู่ไดเรกทอรีเดิมโดยไม่ลบสิ่งใด
+- ต้องการละทิ้งสาขาเชิงทดลองหรือสาขาชั่วคราวโดยไม่ทิ้ง artifact ไว้บนดิสก์
+- ต้องการเริ่มเซสชัน `EnterWorktree` ใหม่ ซึ่งต้องออกจากเซสชันปัจจุบันก่อน
+
+## พารามิเตอร์
+
+- `action` (string, จำเป็น): `"keep"` เก็บไดเรกทอรี worktree และสาขาไว้บนดิสก์เพื่อให้กลับมาได้ในภายหลัง; `"remove"` ลบทั้งไดเรกทอรีและสาขาเพื่อออกอย่างสะอาด
+- `discard_changes` (boolean, ไม่บังคับ, ค่าเริ่มต้น `false`): มีความหมายเฉพาะเมื่อ `action` เป็น `"remove"` เท่านั้น หาก worktree มีไฟล์ที่ยังไม่ได้ commit หรือ commit ที่ไม่มีในสาขาเดิม เครื่องมือจะปฏิเสธการลบ เว้นแต่จะตั้ง `discard_changes` เป็น `true` การตอบกลับข้อผิดพลาดจะแสดงรายการการเปลี่ยนแปลงที่เกี่ยวข้อง เพื่อให้สามารถยืนยันกับผู้ใช้ก่อนเรียกใช้ซ้ำ
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ออกอย่างสะอาดหลังจาก merge การเปลี่ยนแปลง
+
+หลังจากเสร็จงานใน worktree และ merge สาขาเข้า main แล้ว ให้เรียก `ExitWorktree` ด้วย `action: "remove"` เพื่อลบไดเรกทอรี worktree และสาขา แล้วกลับสู่ไดเรกทอรีทำงานเดิม
+
+```
+ExitWorktree(action: "remove")
+```
+
+### ตัวอย่างที่ 2: ทิ้ง worktree ชั่วคราวที่มีโค้ดเชิงทดลองที่ยังไม่ได้ commit
+
+หาก worktree มีการเปลี่ยนแปลงเชิงทดลองที่ยังไม่ได้ commit ซึ่งต้องการทิ้งทั้งหมด ให้ลอง `action: "remove"` ก่อน เครื่องมือจะปฏิเสธและแสดงรายการการเปลี่ยนแปลงที่ยังไม่ได้ commit หลังจากได้รับการยืนยันจากผู้ใช้ว่าสามารถทิ้งได้ ให้เรียกใช้อีกครั้งด้วย `discard_changes: true`
+
+```
+ExitWorktree(action: "remove", discard_changes: true)
+```
+
+## หมายเหตุ
+
+- เครื่องมือนี้ทำงานเฉพาะกับ worktree ที่สร้างโดย `EnterWorktree` ในเซสชันปัจจุบันเท่านั้น จะไม่กระทบต่อ worktree ที่สร้างด้วย `git worktree add`, worktree จากเซสชันก่อนหน้า หรือไดเรกทอรีทำงานปกติหากไม่เคยเรียก `EnterWorktree` เลย — ในกรณีเหล่านี้การเรียกใช้จะไม่มีผลใดๆ
+- `action: "remove"` จะถูกปฏิเสธหาก worktree มีการเปลี่ยนแปลงที่ยังไม่ได้ commit หรือ commit ที่ไม่มีในสาขาเดิม เว้นแต่จะระบุ `discard_changes: true` อย่างชัดเจน ควรยืนยันกับผู้ใช้เสมอก่อนตั้งค่า `discard_changes: true` เนื่องจากข้อมูลไม่สามารถกู้คืนได้
+- หาก worktree มีเซสชัน tmux แนบอยู่: เมื่อ `remove` เซสชันจะถูกยุติ; เมื่อ `keep` เซสชันยังคงทำงานอยู่และจะส่งคืนชื่อเซสชันเพื่อให้ผู้ใช้สามารถเชื่อมต่อกลับในภายหลัง
+- หลังจาก `ExitWorktree` เสร็จสิ้น สามารถเรียก `EnterWorktree` อีกครั้งเพื่อเริ่มเซสชัน worktree ใหม่
+

package/concepts/th/Tool-Glob.md

@@ -1,39 +1,35 @@
 # Glob
 
-## คำจำกัดความ
+จับคู่ชื่อไฟล์กับ glob pattern และส่ง path กลับเรียงตามเวลาการแก้ไขล่าสุดก่อน เหมาะสำหรับค้นหาไฟล์อย่างรวดเร็วใน codebase ทุกขนาดโดยไม่ shell ออกไป `find`
 
-เครื่องมือจับคู่รูปแบบชื่อไฟล์ที่รวดเร็ว รองรับโค้ดเบสทุกขนาด ส่งคืนพาธไฟล์ที่ตรงกันเรียงตามเวลาแก้ไข
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
+- แจกแจงทุกไฟล์ของ extension เฉพาะ (เช่น ทุกไฟล์ `*.ts` ใต้ `src`)
+- ค้นหาไฟล์ configuration หรือ fixture ตามแบบแผนการตั้งชื่อ (`**/jest.config.*`, `**/*.test.tsx`)
+- จำกัด surface การค้นหาก่อนรัน `Grep` แบบ targeted
+- ตรวจสอบว่าไฟล์มีอยู่แล้วที่ pattern ที่รู้จักก่อนเรียก `Write` หรือไม่
+- ค้นหาไฟล์ที่แก้ไขล่าสุดโดยอาศัยการเรียงตามเวลาแก้ไข
 
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `pattern` | string | ใช่ | รูปแบบ glob (เช่น `**/*.js`, `src/**/*.ts`) |
-| `path` | string | ไม่ | ไดเรกทอรีค้นหา ค่าเริ่มต้นคือไดเรกทอรีทำงานปัจจุบัน อย่าส่ง "undefined" หรือ "null" |
+## พารามิเตอร์
 
-## สถานการณ์การใช้งาน
+- `pattern` (string, required): glob expression ที่จะ match รองรับ `*` สำหรับ wildcard segment เดียว, `**` สำหรับ match แบบ recursive, และ `{a,b}` สำหรับทางเลือก เช่น `src/**/*.{ts,tsx}`
+- `path` (string, optional): Directory ที่จะรันการค้นหา ต้องเป็น directory path ที่ถูกต้องเมื่อระบุ ละเว้น field ทั้งหมดเพื่อค้นหาใน working directory ปัจจุบัน อย่าส่ง string `"undefined"` หรือ `"null"`
 
-**เหมาะสำหรับ:**
-- ค้นหาไฟล์ตามรูปแบบชื่อ
-- ค้นหาไฟล์ทั้งหมดของประเภทเฉพาะ (เช่น ไฟล์ `.tsx` ทั้งหมด)
-- ระบุตำแหน่งไฟล์เมื่อค้นหาคำจำกัดความคลาสเฉพาะ (เช่น `class Foo`)
-- สามารถเรียก Glob หลายครั้งพร้อมกันในข้อความเดียว
+## ตัวอย่าง
 
-**ไม่เหมาะสำหรับ:**
-- ค้นหาเนื้อหาไฟล์ — ควรใช้ Grep
-- การสำรวจแบบเปิดที่ต้องค้นหาหลายรอบ — ควรใช้ Task (ประเภท Explore)
+### ตัวอย่างที่ 1: ไฟล์ TypeScript source ทุกไฟล์
+เรียก `Glob` ด้วย `pattern: "src/**/*.ts"` ผลลัพธ์เป็น list ที่เรียงตาม mtime ดังนั้นไฟล์ที่เพิ่งแก้ไขล่าสุดจะปรากฏก่อน ซึ่งมีประโยชน์สำหรับโฟกัสที่ hot spot
 
-## ข้อควรระวัง
+### ตัวอย่างที่ 2: ค้นหา candidate นิยาม class
+เมื่อคุณสงสัยว่า class อยู่ในไฟล์ที่ไม่รู้ชื่อ ให้ค้นหาด้วย `pattern: "**/*UserService*"` เพื่อจำกัด candidate แล้ว follow up ด้วย `Read` หรือ `Grep`
 
-- รองรับไวยากรณ์ glob มาตรฐาน: `*` จับคู่ระดับเดียว, `**` จับคู่หลายระดับ, `{}` จับคู่หลายตัวเลือก
-- ผลลัพธ์เรียงตามเวลาแก้ไข
-- แนะนำให้ใช้มากกว่าคำสั่ง `find` ของ Bash
+### ตัวอย่างที่ 3: ค้นหาแบบขนานก่อนงานใหญ่กว่า
+ในข้อความเดียว ออก `Glob` หลายตัว (เช่น หนึ่งสำหรับ `**/*.test.ts` และหนึ่งสำหรับ `**/fixtures/**`) เพื่อให้รันพร้อมกันและผลลัพธ์สามารถ correlate ได้
 
-## ข้อความต้นฉบับ
+## หมายเหตุ
 
-<textarea readonly>- Fast file pattern matching tool that works with any codebase size
-- Supports glob patterns like "**/*.js" or "src/**/*.ts"
-- Returns matching file paths sorted by modification time
-- Use this tool when you need to find files by name patterns
-- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
-- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>
+- ผลลัพธ์เรียงตามเวลาแก้ไขไฟล์ (ใหม่สุดก่อน) ไม่ใช่ตามตัวอักษร Sort ภายหลังหากต้องการการเรียงที่เสถียร
+- Pattern ถูก evaluate โดย tool ไม่ใช่ shell; คุณไม่จำเป็นต้อง quote หรือ escape เหมือนที่จะทำบน command line
+- สำหรับการสำรวจแบบเปิดกว้างที่ต้องใช้การค้นหาและเหตุผลหลายรอบ ให้ delegate ไปยัง `Agent` ด้วย Explore agent type แทนการ chain `Glob` หลายตัว
+- ชอบ `Glob` มากกว่าการ invoke `find` หรือ `ls` ผ่าน `Bash` สำหรับการค้นพบชื่อไฟล์; จัดการ permission อย่างสม่ำเสมอและส่ง output ที่มีโครงสร้าง
+- เมื่อหาเนื้อหาภายในไฟล์แทนที่จะเป็นชื่อไฟล์ ให้ใช้ `Grep` แทน

package/concepts/th/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## คำจำกัดความ
+ค้นหาเนื้อหาไฟล์โดยใช้ engine ripgrep รองรับ regular expression เต็มรูปแบบ, filter ตามประเภทไฟล์ และ output mode สามแบบเพื่อให้คุณสามารถแลกความแม่นยำกับความกระชับได้
 
-เครื่องมือค้นหาเนื้อหาที่ทรงพลังโดยใช้ ripgrep รองรับนิพจน์ทั่วไป การกรองตามประเภทไฟล์ และโหมดผลลัพธ์หลายแบบ
+## เมื่อใดควรใช้
+
+- ค้นหาทุก call site ของ function หรือทุก reference ของ identifier
+- ตรวจสอบว่า string หรือ error message ปรากฏที่ใดใน codebase หรือไม่
+- นับ occurrence ของ pattern เพื่อประเมินผลกระทบก่อน refactor
+- จำกัดการค้นหาเฉพาะประเภทไฟล์ (`type: "ts"`) หรือ glob (`glob: "**/*.tsx"`)
+- ดึง match ข้ามบรรทัด เช่น นิยาม struct หลายบรรทัดหรือ block JSX ด้วย `multiline: true`
 
 ## พารามิเตอร์
 
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `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 เสมอ
-
-## ข้อความต้นฉบับ
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>
+- `pattern` (string, required): regular expression ที่จะค้นหา ใช้ syntax ของ ripgrep ดังนั้น literal brace ต้อง escape (เช่น `interface\{\}` เพื่อหา `interface{}`)
+- `path` (string, optional): ไฟล์หรือ directory ที่จะค้นหา ค่าเริ่มต้นคือ working directory ปัจจุบัน
+- `glob` (string, optional): filter ชื่อไฟล์ เช่น `*.js` หรือ `*.{ts,tsx}`
+- `type` (string, optional): shortcut ประเภทไฟล์ เช่น `js`, `py`, `rust`, `go` มีประสิทธิภาพมากกว่า `glob` สำหรับภาษามาตรฐาน
+- `output_mode` (enum, optional): `files_with_matches` (ค่าเริ่มต้น, ส่ง path เท่านั้น), `content` (ส่งบรรทัดที่ match), หรือ `count` (ส่งจำนวน match)
+- `-i` (boolean, optional): match แบบไม่แยกตัวพิมพ์
+- `-n` (boolean, optional): รวมหมายเลขบรรทัดใน mode `content` ค่าเริ่มต้น `true`
+- `-A` (number, optional): จำนวนบรรทัด context แสดงหลังแต่ละ match (ต้องใช้ mode `content`)
+- `-B` (number, optional): จำนวนบรรทัด context ก่อนแต่ละ match (ต้องใช้ mode `content`)
+- `-C` / `context` (number, optional): จำนวนบรรทัด context ทั้งสองด้านของแต่ละ match
+- `multiline` (boolean, optional): ให้ pattern ข้าม newline ได้ (`.` match `\n`) ค่าเริ่มต้น `false`
+- `head_limit` (number, optional): จำกัดจำนวนบรรทัด, path ของไฟล์, หรือ count entry ที่ส่งกลับ ค่าเริ่มต้น 250; ส่ง `0` สำหรับไม่จำกัด (ใช้อย่างประหยัด)
+- `offset` (number, optional): ข้าม N ผลลัพธ์แรกก่อนใช้ `head_limit` ค่าเริ่มต้น `0`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: หา call site ทั้งหมดของ function
+ตั้ง `pattern: "registerHandler\\("`, `output_mode: "content"`, และ `-C: 2` เพื่อดูบรรทัดโดยรอบของแต่ละการเรียก
+
+### ตัวอย่างที่ 2: นับ match ข้ามประเภท
+ตั้ง `pattern: "TODO"`, `type: "py"`, และ `output_mode: "count"` เพื่อดูจำนวน TODO ต่อไฟล์ใน Python source
+
+### ตัวอย่างที่ 3: Multiline struct match
+ใช้ `pattern: "struct Config \\{[\\s\\S]*?version"` ด้วย `multiline: true` เพื่อจับ field ที่ประกาศห่างหลายบรรทัดเข้าไปใน struct ของ Go
+
+## หมายเหตุ
+
+- ชอบ `Grep` มากกว่าการรัน `grep` หรือ `rg` ผ่าน `Bash` เสมอ; tool นี้ optimize สำหรับ permission ที่ถูกต้องและ output ที่มีโครงสร้าง
+- Output mode เริ่มต้นคือ `files_with_matches` ซึ่งถูกที่สุด เปลี่ยนเป็น `content` เฉพาะเมื่อต้องการดูบรรทัดเอง
+- Context flag (`-A`, `-B`, `-C`) จะถูกละเลยเว้นแต่ `output_mode` เป็น `content`
+- ผลลัพธ์ขนาดใหญ่เผาผลาญ token ของ context ใช้ `head_limit`, `offset`, หรือ `glob`/`type` filter ที่แคบลงเพื่อรักษาการโฟกัส
+- สำหรับการค้นหาชื่อไฟล์ ให้ใช้ `Glob` แทน; สำหรับการสืบสวนแบบเปิดกว้างข้ามหลายรอบ ให้ dispatch `Agent` ด้วย Explore agent

package/concepts/th/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+เริ่มต้นตัวตรวจสอบที่ทำงานในเบื้องหลัง ซึ่งสตรีมเหตุการณ์จากสคริปต์ที่ทำงานยาวนาน ทุกบรรทัดของ stdout จะกลายเป็นการแจ้งเตือน — ทำงานต่อไปได้ขณะที่เหตุการณ์ปรากฏในแชท
+
+## เมื่อใดควรใช้
+
+- ติดตามข้อผิดพลาด คำเตือน หรือรูปแบบการล่มสลายในไฟล์บันทึกขณะที่การติดตั้งระบบกำลังดำเนินอยู่
+- สำรวจ API ระยะไกล PR หรือ CI pipeline ทุก 30 วินาทีเพื่อตรวจจับเหตุการณ์สถานะใหม่
+- เฝ้าดูการเปลี่ยนแปลงในไดเรกทอรีของระบบไฟล์หรือผลลัพธ์การสร้างในแบบเรียลไทม์
+- รอเงื่อนไขเฉพาะตลอดการวนซ้ำหลายครั้ง (เช่น จุดสำคัญของขั้นตอนการฝึกโมเดล หรือคิวที่ถูกเคลียร์)
+- **ไม่ใช้** สำหรับการ "รอจนเสร็จ" อย่างง่าย — ใช้ `Bash` กับ `run_in_background` แทน ซึ่งจะส่งการแจ้งเตือนเสร็จสิ้นครั้งเดียวเมื่อกระบวนการสิ้นสุด
+
+## พารามิเตอร์
+
+- `command` (สตริง, จำเป็น): คำสั่ง shell หรือสคริปต์ที่จะรัน ทุกบรรทัดที่เขียนไปยัง stdout จะกลายเป็นเหตุการณ์การแจ้งเตือนแยกต่างหาก ตัวตรวจสอบสิ้นสุดเมื่อกระบวนการสิ้นสุด
+- `description` (สตริง, จำเป็น): ป้ายกำกับสั้นที่อ่านได้ซึ่งแสดงในทุกการแจ้งเตือน ควรระบุให้เฉพาะเจาะจง — "ข้อผิดพลาดใน deploy.log" ดีกว่า "กำลังดูบันทึก" ป้ายกำกับนี้ระบุว่าตัวตรวจสอบใดถูกเรียกใช้
+- `timeout_ms` (ตัวเลข, ค่าเริ่มต้น `300000`, สูงสุด `3600000`): กำหนดเวลาบังคับสิ้นสุดเป็นมิลลิวินาที หลังจากระยะเวลานี้กระบวนการจะถูกยุติ ถูกละเว้นเมื่อ `persistent: true`
+- `persistent` (บูลีน, ค่าเริ่มต้น `false`): เมื่อเป็น `true` ตัวตรวจสอบจะทำงานตลอดช่วงเวลาของ session โดยไม่มี timeout หยุดอย่างชัดเจนด้วย `TaskStop`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ติดตามไฟล์บันทึกเพื่อหาข้อผิดพลาดและการล่มสลาย
+
+ตัวอย่างนี้ครอบคลุมทุกสถานะสุดท้าย: ตัวบ่งชี้ความสำเร็จ, traceback, คำสำคัญของข้อผิดพลาดทั่วไป, การยุติเนื่องจาก OOM และการออกจากกระบวนการที่ไม่คาดคิด
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+ใช้ `grep --line-buffered` ในทุก pipe หากไม่ใช้ OS จะบัฟเฟอร์ผลลัพธ์เป็นบล็อก 4 KB และเหตุการณ์อาจล่าช้าหลายนาที รูปแบบการสลับครอบคลุมทั้งเส้นทางสำเร็จ (`deployed`) และเส้นทางล้มเหลว (`Traceback`, `Error`, `FAILED`, `Killed`, `OOM`) ตัวตรวจสอบที่เฝ้าดูเฉพาะตัวบ่งชี้ความสำเร็จจะเงียบในระหว่างการล่มสลาย — ความเงียบไม่ต่างจาก "ยังคงทำงานอยู่"
+
+### ตัวอย่างที่ 2: สำรวจ API ระยะไกลทุก 30 วินาที
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` ป้องกันไม่ให้ความล้มเหลวของเครือข่ายชั่วคราวยุติลูป ช่วงเวลาการสำรวจ 30 วินาทีขึ้นไปเหมาะสมสำหรับ API ระยะไกลเพื่อหลีกเลี่ยงข้อจำกัดอัตรา ปรับรูปแบบ grep เพื่อจับทั้งการตอบสนองที่สำเร็จและล้มเหลว เพื่อไม่ให้ข้อผิดพลาดฝั่ง API ถูกปิดบังด้วยความเงียบ
+
+## หมายเหตุ
+
+- **ใช้ `grep --line-buffered` ใน pipe เสมอ** หากไม่ใช้ การบัฟเฟอร์ของ pipe จะทำให้เหตุการณ์ล่าช้าหลายนาที เพราะ OS จะรวบรวมผลลัพธ์จนเต็มบล็อก 4 KB `--line-buffered` บังคับให้ล้างบัฟเฟอร์หลังทุกบรรทัด
+- **ฟิลเตอร์ต้องครอบคลุมทั้งลายเซ็นของความสำเร็จและความล้มเหลว** ตัวตรวจสอบที่เฝ้าดูเฉพาะตัวบ่งชี้ความสำเร็จจะเงียบเมื่อเกิดการล่มสลาย การค้างหรือการออกที่ไม่คาดคิด ขยายการสลับ: รวม `Error`, `Traceback`, `FAILED`, `Killed`, `OOM` และตัวบ่งชี้สถานะสุดท้ายที่คล้ายกันควบคู่กับคำสำคัญของความสำเร็จ
+- **ช่วงเวลาการสำรวจ: 30 วินาทีขึ้นไปสำหรับ API ระยะไกล** การสำรวจบ่อยๆ บนบริการภายนอกเสี่ยงต่อข้อผิดพลาดจำกัดอัตราหรือการบล็อก สำหรับการตรวจสอบระบบไฟล์ในเครื่องหรือกระบวนการ 0.5–1 วินาทีเหมาะสม
+- **ใช้ `persistent: true` สำหรับตัวตรวจสอบตลอด session** ค่า `timeout_ms` เริ่มต้น 300,000 มิลลิวินาที (5 นาที) จะยุติกระบวนการ สำหรับตัวตรวจสอบที่ควรทำงานจนกว่าจะหยุดอย่างชัดเจน ให้ตั้ง `persistent: true` และเรียก `TaskStop` เมื่อเสร็จสิ้น
+- **หยุดอัตโนมัติเมื่อเหตุการณ์ล้นหลาม** ทุกบรรทัดของ stdout คือข้อความสนทนา หากฟิลเตอร์กว้างเกินไปและสร้างเหตุการณ์มากเกินไป ตัวตรวจสอบจะหยุดอัตโนมัติ รีสตาร์ทด้วยรูปแบบ `grep` ที่แคบกว่า บรรทัดที่มาถึงภายใน 200 มิลลิวินาทีจะถูกรวมเป็นการแจ้งเตือนเดียว

package/concepts/th/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## คำจำกัดความ
+แก้ไข cell เดียวใน Jupyter notebook (`.ipynb`) รองรับการแทนที่ source ของ cell, แทรก cell ใหม่, หรือลบ cell ที่มีอยู่ขณะรักษาโครงสร้างที่เหลือของ notebook
 
-แทนที่ แทรก หรือลบเซลล์เฉพาะใน Jupyter notebook (ไฟล์ .ipynb)
+## เมื่อใดควรใช้
+
+- แก้ไขหรืออัปเดต code cell ใน notebook การวิเคราะห์โดยไม่ต้องเขียนไฟล์ทั้งหมดใหม่
+- สลับ markdown cell เพื่อปรับปรุงเรื่องราวหรือเพิ่ม documentation
+- แทรก code หรือ markdown cell ใหม่ที่ตำแหน่งที่ทราบใน notebook ที่มีอยู่
+- ลบ cell ที่ล้าสมัยหรือเสียหายเพื่อให้ cell ปลายทางไม่ขึ้นกับมันอีกต่อไป
+- เตรียม notebook ที่ทำซ้ำได้โดยการ iterate ทีละ cell
 
 ## พารามิเตอร์
 
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `notebook_path` | string | ใช่ | พาธแบบสัมบูรณ์ของไฟล์ notebook |
-| `new_source` | string | ใช่ | เนื้อหาใหม่ของเซลล์ |
-| `cell_id` | string | ไม่ | ID ของเซลล์ที่จะแก้ไข ในโหมดแทรก เซลล์ใหม่จะถูกแทรกหลัง ID นี้ |
-| `cell_type` | enum | ไม่ | ประเภทเซลล์: `code` หรือ `markdown` จำเป็นในโหมดแทรก |
-| `edit_mode` | enum | ไม่ | โหมดแก้ไข: `replace` (ค่าเริ่มต้น), `insert`, `delete` |
+- `notebook_path` (string, required): Absolute path ไปยังไฟล์ `.ipynb` Path แบบ relative จะถูกปฏิเสธ
+- `new_source` (string, required): source ใหม่ของ cell สำหรับ `replace` และ `insert` จะกลายเป็นเนื้อหา cell; สำหรับ `delete` จะถูกละเลยแต่ยังคงต้องมีตาม schema
+- `cell_id` (string, optional): ID ของ cell เป้าหมาย ใน mode `replace` และ `delete`, tool จะทำงานบน cell นี้ ใน mode `insert`, cell ใหม่จะถูกแทรกหลัง cell ที่มี ID นี้ทันที; ละเว้นเพื่อแทรกที่ด้านบนของ notebook
+- `cell_type` (enum, optional): `code` หรือ `markdown` จำเป็นเมื่อ `edit_mode` เป็น `insert` เมื่อละเว้นระหว่าง `replace`, ประเภทของ cell ที่มีอยู่จะถูกรักษาไว้
+- `edit_mode` (enum, optional): `replace` (ค่าเริ่มต้น), `insert`, หรือ `delete`
 
-## สถานการณ์การใช้งาน
+## ตัวอย่าง
 
-**เหมาะสำหรับ:**
-- แก้ไขเซลล์โค้ดหรือ markdown ใน Jupyter notebook
-- เพิ่มเซลล์ใหม่ใน notebook
-- ลบเซลล์ใน notebook
+### ตัวอย่างที่ 1: แทนที่ code cell ที่มีบั๊ก
+เรียก `NotebookEdit` ด้วย `notebook_path` ตั้งเป็น absolute path, `cell_id` ตั้งเป็น ID ของ cell เป้าหมาย, และ `new_source` มี Python code ที่แก้แล้ว ปล่อย `edit_mode` เป็นค่าเริ่มต้น `replace`
 
-## ข้อควรระวัง
+### ตัวอย่างที่ 2: แทรกคำอธิบาย markdown
+เพื่อเพิ่ม markdown cell ทันทีหลัง cell `setup` ที่มีอยู่ ให้ตั้ง `edit_mode: "insert"`, `cell_type: "markdown"`, `cell_id` เป็น ID ของ setup cell, และใส่เนื้อหาใน `new_source`
 
-- `cell_number` เป็นดัชนีเริ่มจาก 0
-- โหมด `insert` แทรกเซลล์ใหม่ที่ตำแหน่งที่ระบุ
-- โหมด `delete` ลบเซลล์ที่ตำแหน่งที่ระบุ
-- พาธต้องเป็นแบบสัมบูรณ์
+### ตัวอย่างที่ 3: ลบ cell ที่ค้าง
+ตั้ง `edit_mode: "delete"` และจัดหา `cell_id` ของ cell ที่จะลบ จัดหา string ใดก็ได้สำหรับ `new_source`; จะไม่ถูกใช้
 
-## ข้อความต้นฉบับ
+## หมายเหตุ
 
-<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>
+- ส่ง absolute path เสมอ `NotebookEdit` ไม่ resolve relative path ตาม working directory
+- Tool เขียน cell ที่ targeted เท่านั้น; execution count, output, และ metadata ของ cell ที่ไม่เกี่ยวข้องยังคงไม่ถูกแตะ
+- การแทรกโดยไม่มี `cell_id` วาง cell ใหม่ที่จุดเริ่มต้นสุดของ notebook
+- `cell_type` จำเป็นสำหรับ insert สำหรับ replace ให้ละเว้นเว้นแต่คุณต้องการแปลง code cell เป็น markdown หรือกลับกัน
+- เพื่อตรวจสอบ cell และเอา ID ของมัน ให้ใช้ tool `Read` บน notebook ก่อน; มันจะส่งคืน cell พร้อมเนื้อหาและ output
+- ใช้ `Edit` ปกติสำหรับไฟล์ source ธรรมดา; `NotebookEdit` เฉพาะสำหรับ JSON `.ipynb` และเข้าใจโครงสร้าง cell