[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81083":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":14,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":15,"starSnapshotCount":15,"syncStatus":14,"lastSyncTime":26,"discoverSource":27},81083,"thai-token-optimizer","kittimasak\u002Fthai-token-optimizer","kittimasak","A Thai token optimization tool for AI coding agents that keeps commands, code, and technical details accurate.",null,"JavaScript",44,5,42,2,0,1,43.03,"MIT License",false,"main",true,[],"2026-06-11 04:07:23","\u003C!--\n============================================================================\nThai Token Optimizer v2.0\n============================================================================\nคำอธิบาย :\nเครื่องมือเพิ่มประสิทธิภาพ token ภาษาไทยสำหรับ AI coding agents ที่ยังคงรักษาความถูกต้องของคำสั่ง โค้ด และรายละเอียดทางเทคนิค\n\nผู้เขียน     : Dr.Kittimasak Naijit\nRepository  : https:\u002F\u002Fgithub.com\u002Fkittimasak\u002Fthai-token-optimizer\n\nCopyright (c) 2026 Dr.Kittimasak Naijit\n\nหมายเหตุ:\n- ห้ามลบการรักษาส่วนสำคัญแบบ code-aware, การตรวจสอบความปลอดภัย หรือพฤติกรรม rollback\n- ไฟล์นี้เป็นส่วนหนึ่งของระบบ Thai Token Optimizer แบบ local-first สำหรับ CLI\u002Fhook\n============================================================================\n-->\n\n# Thai Token Optimizer\n\n\u003C!-- Responsive images: local SVG diagrams use HTML \u003Cimg> tags with width=\"100%\" and max-width:100% so they fit browser\u002FGitHub containers. -->\n\n\n\u003Cdiv align=\"center\">\n\n## ภาษาไทยแบบกระชับสำหรับ AI Coding Agents\n\n**Thai Token Optimizer (TTO) v2.0** คือระบบแบบ local-first ในรูปแบบ `CLI + hooks + adapters` สำหรับลดการใช้ token ภาษาไทย พร้อมรักษาความถูกต้องทางเทคนิค ข้อจำกัดด้านความปลอดภัย และความสามารถในการทำซ้ำผลลัพธ์\n\n```text\n┌────────────────────────────────────────────────────────────────────────────┐\n│ Thai Token Optimizer v2.0                                                 │\n│ package version: 2.0.0                                                    │\n│ principle: reduce token without losing safety\u002Fcorrectness\u002Fconstraints     │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\n![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-v2.0-blue)\n![Package](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpackage-2.0.0-green)\n![Node](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D18-brightgreen)\n![UI](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FUI-Terminal%20CLI-orange)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-lightgrey)\n\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Ftto-hero.svg\" alt=\"Thai Token Optimizer Hero\" width=\"100%\" style=\"max-width: 100%; height: auto; display: block;\" loading=\"lazy\">\n\u003C\u002Fp>\n\n\u003C\u002Fdiv>\n\n---\n\n## สารบัญ\n\n```text\n┌─ เริ่มต้นที่นี่ ──────────────────────────────────────────────────────────┐\n│ 1) คุณค่าหลักของระบบ     4) การติดตั้ง          5) เส้นทางเริ่มต้นเร็ว │\n│ 2) ตารางการผสานระบบ     6) ชุดคำสั่ง            7) Workflow แบบภาพ    │\n│ 3) สถาปัตยกรรมระบบ      8) โหมดและโปรไฟล์       9) การปรับเฉพาะบุคคล │\n├─ ขั้นสูง ─────────────────────────────────────────────────────────────────┤\n│ 10) MTP \u002F Speculative     11) Fleet Analytics      12) Backup\u002FRollback   │\n│ 13) Terminal UI           14) Policy and Config    15) CI Pipeline        │\n├─ การปฏิบัติการ ───────────────────────────────────────────────────────────┤\n│ 16) การลด token จริง      17) Runtime Artifacts    18) การแก้ปัญหา      │\n│ 19) การพัฒนา              20) Safety Checklist     22) Shell Proxy Mode │\n│ 21) License                                                                │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\n## 1) คุณค่าหลักของระบบ\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Ftto-value-flow.svg\" alt=\"TTO Value Flow\" width=\"100%\" style=\"max-width: 100%; height: auto; display: block;\" loading=\"lazy\">\n\u003C\u002Fp>\n\n```text\n┌────────────────────────────── ก่อนใช้ ────────────────────────────────────┐\n│ prompt\u002Fคำตอบภาษาไทยยาว ซ้ำ เปลืองค่าใช้จ่าย และปะปนกับคำสั่ง            │\n└───────────────────────────────────┬────────────────────────────────────────┘\n                                    v\n┌─────────────────────────────── TTO v2 ─────────────────────────────────────┐\n│ ภาษาไทยกระชับ + รักษาโค้ดแบบ code-aware + safety mode + วินัย rollback │\n└───────────────────────────────────┬────────────────────────────────────────┘\n                                    v\n┌────────────────────────────── หลังใช้ ────────────────────────────────────┐\n│ token น้อยลง โดยคำสั่ง path version และ constraints ยังถูกต้องครบถ้วน   │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\nTTO ลด token ที่สูญเปล่า พร้อมปกป้องสิ่งต่อไปนี้:\n\n- คำสั่งที่ต้องตรงทุกตัวอักษร\n- code fences และ inline code\n- path และ URL\n- version และ config keys\n- hard constraints\n- คำสั่งที่สำคัญด้านความปลอดภัย\n- ความสามารถในการ rollback เพื่อทำซ้ำได้\n\nกฎหลัก:\n\n```text\nลด token ได้ แต่ห้ามลดความถูกต้อง ความปลอดภัย หรือเงื่อนไขสำคัญ\n```\n\n---\n\n## แผนที่ความสามารถ\n\n```text\n┌─ การบีบอัด ───────────────┬─ ความปลอดภัย ────────────┬─ การปฏิบัติการ ───┐\n│ ลบคำฟุ่มเฟือย             │ ตัวจำแนกประเภทงาน        │ doctor            │\n│ ลบความหมายซ้ำ             │ safe mode                 │ quality score     │\n│ Aggressive Log Dedup      │ hard-constraint lock      │ coach mode        │\n│ Dynamic Masking           │ preservation checker      │ ops scan          │\n│ Sequence Detection        │ rollback-first workflow   │ fleet audit       │\n│ Smart Middle-Truncation   │ budget optimizer          │ context audit     │\n│ MTP speculative candidates │                           │ tto proxy (ใหม่)  │\n└────────────────────────────┴──────────────────────────┴──────────────────┘\n```\n\n---\n\n## 2) ตารางการผสานระบบ\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Ftto-integration-matrix.svg\" alt=\"TTO Integration Matrix\" width=\"100%\" style=\"max-width: 100%; height: auto; display: block;\" loading=\"lazy\">\n\u003C\u002Fp>\n\n| เป้าหมาย | ประเภทการผสานระบบ | คำสั่งติดตั้ง |\n|---|---|---|\n| Codex | hooks + AGENTS injection | `tto install codex` |\n| Claude Code | hooks ใน settings | `tto install claude` |\n| Gemini CLI | extension + hooks | `tto install gemini` |\n| OpenCode | native plugin + config | `tto install opencode` |\n| OpenClaw | managed hook + config | `tto install openclaw` |\n| Hermes Agent | shell hooks + plugin hooks + config | `tto install hermes` |\n| Cursor | rule adapter | `tto install cursor` |\n| Aider | rule adapter | `tto install aider` |\n| Cline | rule adapter | `tto install cline` |\n| Roo Code | rule adapter | `tto install roo` |\n\nติดตั้งทั้งหมด:\n\n```bash\ntto install all\n```\n\n---\n\n## 3) สถาปัตยกรรมระบบ (v2)\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Ftto-architecture.svg\" alt=\"TTO System Architecture\" width=\"100%\" style=\"max-width: 100%; height: auto; display: block;\" loading=\"lazy\">\n\u003C\u002Fp>\n\n```text\n┌────────────────────────────────────────────────────────────────────────────┐\n│                           USER \u002F AGENT INPUT                              │\n│  prompt text | hook payload | file input | benchmark corpus | session log  │\n└───────────────────────────────────┬────────────────────────────────────────┘\n                                    v\n┌────────────────────────────────────────────────────────────────────────────┐\n│                         CONTROL AND RISK LAYER                             │\n│  mode tracker -> profile selector -> safety classifier -> policy defaults  │\n└───────────────────────────────────┬────────────────────────────────────────┘\n                                    v\n┌────────────────────────────────────────────────────────────────────────────┐\n│                         COMPRESSION PIPELINE                               │\n│  code-aware parser                                                         │\n│  semantic analyzer                                                         │\n│  personalization dictionary                                                │\n│  semantic dedup + repeated phrase collapse                                 │\n│  selective window + budget optimizer                                       │\n│  MTP speculative candidate families                                        │\n└───────────────────────────────────┬────────────────────────────────────────┘\n                                    v\n┌────────────────────────────────────────────────────────────────────────────┐\n│                         VERIFICATION LAYER                                 │\n│  constraint locker -> preservation checker -> safety fallback -> reports   │\n└───────────────────────────────────┬────────────────────────────────────────┘\n                                    v\n┌────────────────────────────────────────────────────────────────────────────┐\n│                         OUTPUT AND OPERATIONS                              │\n│  CLI text\u002Fjson\u002Fpretty | hook context | dashboard | fleet | ci artifacts    │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\nไฟล์ runtime หลัก:\n\n- `bin\u002Fthai-token-optimizer.js`\n- `hooks\u002Ftto-compressor.js`\n- `hooks\u002Ftto-budget-compressor.js`\n- `hooks\u002Ftto-code-aware-parser.js`\n- `hooks\u002Ftto-constraint-locker.js`\n- `hooks\u002Ftto-preservation-checker.js`\n- `hooks\u002Ftto-safety-classifier.js`\n- `hooks\u002Ftto-ui.js`\n- `hooks\u002Ftto-runtime-analytics.js`\n- `hooks\u002Ftto-fleet-audit.js`\n\n---\n\n## 4) การติดตั้ง\n\n### ข้อกำหนด\n\n- Node.js `>=18`\n\n### ติดตั้งแบบ local\n\n```bash\nnpm install\nnpm test\n```\n\n### รันผ่าน node\n\n```bash\nnode bin\u002Fthai-token-optimizer.js status --pretty\n```\n\n### คำสั่ง global แบบเลือกใช้ได้\n\n```bash\nnpm link\ntto status --pretty\n```\n\n---\n\n## 5) เส้นทางเริ่มต้นเร็ว\n\n```text\n┌────────────┐   ┌────────────┐   ┌───────────────┐   ┌────────────┐\n│  backup    │ > │  install   │ > │ install-agents│ > │   doctor   │\n└────────────┘   └────────────┘   └───────────────┘   └──────┬─────┘\n                                                               v\n                                                        ┌────────────┐\n                                                        │  tto auto  │\n                                                        └──────┬─────┘\n                                                               v\n                                                        ┌────────────┐\n                                                        │ agent chat │\n                                                        └────────────┘\n```\n\n```bash\ntto backup all\ntto install all\ntto install-agents\ntto doctor --pretty\ntto auto\n```\n\nใน chat\u002Fsession:\n\n```text\ntoken thai auto\n```\n\n---\n\n## 6) ชุดคำสั่ง\n\n```text\nMODE\n  on|auto | lite | full | safe | off|stop\n\nSTATUS\u002FUI\n  status [--pretty]\n  ui\n  dashboard [--view overview|quality|waste|trend|agents|doctor|fleet]\n\nCOMPRESSION\n  compress [--pretty] [--level auto|lite|full|safe] [--budget N]\n           [--target codex|claude] [--check] [--speculative|--no-speculative]\n           [--diagnostics] [text|file]\n  rewrite\n  estimate [--target codex|claude] [--exact] \u003Ctext>\n  preserve \u003CoriginalFile> \u003CoptimizedFile>\n  classify [--pretty] \u003Ctext>\n\nHEALTH \u002F QUALITY\n  doctor [target] [--pretty]\n  quality [--pretty]\n  coach [--pretty] [--apply quick|safe]\n\nOPS \u002F FLEET\n  ops [--pretty] | scan|audit|context|quality|drift|validate [options]\n  fleet [--roots dir1,dir2] [--pretty] [--doctor]\n        [--doctor-target all|codex|claude|gemini|opencode|openclaw|hermes]\n        [--calibration] [--calibration-limit N] [--session-scan]\n  context [--pretty]\n\nCALIBRATION \u002F CHECKPOINT \u002F CACHE\n  calibration status|record|from-stats|clear [--pretty]\n  checkpoint status|list|capture|restore|precompact|postcompact [--pretty]\n  cache stats|clear [--pretty]\n\nBACKUP \u002F INSTALL\n  backup [target]\n  backups\n  rollback [latest|id|target] [--dry-run]\n  install \u003Ctarget|all>\n  uninstall \u003Ctarget|all>\n  install-agents [codex]\n\nPERSONALIZATION\n  keep \u003Cword>\n  forget \u003Cword>\n  dictionary\n\nBENCHMARK\n  benchmark [--pretty] [--strict] [--default-policy] [--mtp]\n```\n\n---\n\n## 7) Workflow แบบภาพ\n\n### 7.1 เส้นทางการบีบอัด\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Ftto-compression-workflow.svg\" alt=\"TTO Compression Workflow\" width=\"100%\" style=\"max-width: 100%; height: auto; display: block;\" loading=\"lazy\">\n\u003C\u002Fp>\n\n```text\n┌────────┐   ┌──────────┐   ┌──────────────────┐   ┌──────────────┐   ┌────────┐\n│ input  │ > │ classify │ > │ compress \u002F MTP   │ > │ preservation │ > │ output │\n└────────┘   └──────────┘   └──────────────────┘   └──────────────┘   └────────┘\n```\n\n```bash\ntto compress --pretty --level auto --target codex --budget 500 --check prompt.txt\n```\n\n```bash\ntto compress --speculative --diagnostics \"...\"\n```\n\n```bash\ntto compress --no-speculative \"...\"\n```\n\n### 7.2 เส้นทางความปลอดภัย\n\n```bash\ntto classify --pretty \"DROP TABLE users production secret\"\n```\n\n### 7.3 เส้นทางตรวจสุขภาพ\n\n```bash\ntto doctor --pretty\ntto doctor codex --pretty\ntto doctor --ci\n```\n\n### 7.4 เส้นทาง benchmark\n\n```bash\ntto benchmark --pretty --strict --default-policy --mtp\n```\n\n### 7.5 เส้นทาง fleet\n\n```bash\ntto fleet --pretty --roots \u002Fpath\u002FrepoA,\u002Fpath\u002FrepoB --doctor --calibration --session-scan\n```\n\n### 7.6 เส้นทาง ops\n\n```bash\ntto ops --pretty\ntto ops scan --pretty\n```\n\n### 7.7 เส้นทาง calibration\n\n```bash\ntto calibration status --pretty\ntto calibration record --estimated 1000 --real 1200 --target codex\ntto calibration from-stats --real-total 24000 --samples 20 --target codex\n```\n\n### 7.8 เส้นทาง checkpoint และ cache\n\n```bash\ntto checkpoint status --pretty\ntto checkpoint capture --pretty \"before major rewrite\"\ntto checkpoint restore latest --pretty\n\ntto cache stats --pretty\ntto cache clear\n```\n\n---\n\n## 8) โหมดและโปรไฟล์\n\nโหมด:\n\n- `auto`: ค่าเริ่มต้นแบบปรับตัวได้\n- `lite`: กระชับ แต่มีคำอธิบายเพิ่มเล็กน้อย\n- `full`: ผลลัพธ์แน่นขึ้นสำหรับงานความเสี่ยงต่ำ\n- `safe`: ผลลัพธ์ที่ให้ความปลอดภัยเป็นอันดับแรก\n- `off`: ปิดพฤติกรรม optimizer\n\nคำสั่ง:\n\n```bash\ntto auto\ntto lite\ntto full\ntto safe\ntto off\n```\n\nโปรไฟล์:\n\n```bash\ntto profile list\ntto profile show\ntto profile coding\n```\n\n---\n\n## 9) การปรับเฉพาะบุคคล (Adaptive Compression Learning)\n\n```text\nUser dictionary = คำที่ห้ามถูกบีบอัดหรือตัดออก\n```\n\n```bash\ntto keep \"คำเฉพาะของทีม\"\ntto forget \"คำเฉพาะของทีม\"\ntto dictionary\n```\n\nพฤติกรรม:\n\n- dictionary แบบ local ที่ถูกบันทึกคงอยู่\n- ผสานกับการปกป้องแบบ code-aware\n- รองรับอักขระพิเศษได้อย่างปลอดภัย\n\n---\n\n## 10) MTP \u002F Speculative Decoding\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Ftto-mtp-selection.svg\" alt=\"TTO MTP Selection\" width=\"100%\" style=\"max-width: 100%; height: auto; display: block;\" loading=\"lazy\">\n\u003C\u002Fp>\n\nกลุ่ม candidate:\n\n- `baseline`\n- `semantic_dedup`\n- `selective_window`\n- `dedup_plus_selective`\n\n```text\n┌────────────┐  ┌────────────────┐  ┌──────────────────┐  ┌──────────────────────┐\n│ baseline   │  │ semantic_dedup │  │ selective_window │  │ dedup_plus_selective │\n└─────┬──────┘  └────────┬───────┘  └────────┬─────────┘  └──────────┬───────────┘\n      └──────────────────┴──────────────────┴───────────────────────┘\n                                  v\n                    ┌─────────────────────────────┐\n                    │ preservation + budget score │\n                    └──────────────┬──────────────┘\n                                   v\n                    ┌─────────────────────────────┐\n                    │ selected candidate + reason │\n                    └─────────────────────────────┘\n```\n\nพฤติกรรมสำคัญ:\n\n- ลำดับความสำคัญของ `--speculative` และ `--no-speculative`\n- diagnostics พร้อม selected family\u002Flevel\u002Freason\n- กรณีคะแนน preservation เท่ากัน จะให้ความสำคัญกับ `dedup_plus_selective`\n- benchmark gates สำหรับ preservation, hit-rate, slowdown, enhanced gain, fixture guard, action routing\n\nคำสั่ง:\n\n```bash\ntto compress --speculative --diagnostics \"...\"\ntto benchmark --strict --default-policy --mtp\n```\n\n---\n\n## 11) Fleet และ Session Analytics\n\n`fleet` รวมสัญญาณข้ามโปรเจกต์:\n\n- สถานะ benchmark\n- สุขภาพจาก doctor\n- ช่องว่าง calibration\n- ผลรวม session scan\n- สิ่งที่ detector พบ และ waste\u002Fcost โดยประมาณ\n\nadapter สำหรับ parser ของ session:\n\n- Codex\n- Claude\n- OpenClaw\n- Hermes\n- OpenCode\n\nสคริปต์ที่เกี่ยวข้อง:\n\n```bash\nnpm run fleet:fixtures\nnpm run fleet:history\nnpm run fleet:gate\n```\n\n---\n\n## 12) Backup \u002F Rollback \u002F Uninstall\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Ftto-safety-rollback-loop.svg\" alt=\"TTO Safety Rollback Loop\" width=\"100%\" style=\"max-width: 100%; height: auto; display: block;\" loading=\"lazy\">\n\u003C\u002Fp>\n\n```bash\ntto backup all\ntto backup codex\n```\n\n```bash\ntto backups\n```\n\n```bash\ntto rollback latest --dry-run\ntto rollback latest\ntto rollback codex\n```\n\n```bash\ntto uninstall codex\ntto uninstall all\n```\n\n---\n\n## 13) Terminal UI (ไม่มี Web Dashboard)\n\n```text\ntto ui\n  ├─ overview\n  ├─ quality\n  ├─ waste\n  ├─ trend\n  ├─ agents\n  ├─ doctor\n  └─ fleet\n```\n\nตัวอย่างรูปแบบ dashboard:\n\n```text\n┌────────────────────────────────────────────────────────────────────────────┐\n│ Thai Token Optimizer v2.0.0                                                │\n├────────────────────────────────────────────────────────────────────────────┤\n│ Mode      auto        Profile   coding        Safety   strict              │\n│ Doctor    PASS\u002FWARN   Quality   S\u002FA\u002FB\u002FC\u002FF     MTP      PASS\u002FFAIL           │\n│ Saving    tokens reduced while preserving commands, paths, versions        │\n├────────────────────────────────────────────────────────────────────────────┤\n│ Commands   tto doctor --pretty | tto benchmark --strict --default-policy   │\n│ Views      overview | quality | waste | trend | agents | doctor | fleet    │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\n```bash\ntto ui\ntto dashboard --view overview\ntto dashboard --view quality\ntto dashboard --view waste\ntto dashboard --view trend\ntto dashboard --view agents\ntto dashboard --view doctor\ntto dashboard --view fleet\n```\n\n### 13.1 ตัวอย่าง UI จริง\n\nตัวอย่างต่อไปนี้มาจากการรันคำสั่งจริงของ TTO v2 ผ่าน terminal renderer ปัจจุบัน ไม่ใช่ mock UI ค่าในแต่ละเครื่องอาจเปลี่ยนตาม local state, adapter ที่ติดตั้ง, benchmark artifacts และ policy ที่ใช้งาน\n\n#### Status UI\n\nใช้ตรวจสถานะเร็วที่สุดว่า TTO เปิดอยู่หรือไม่ อยู่ mode\u002Fprofile\u002Fsafety ใด และควรรันคำสั่งถัดไปอะไร\n\n```bash\ntto status --pretty\n```\n\n```text\n╭──────────────────────────────────────────────────────────────────────╮\n│ ⚡ Thai Token Optimizer v2.0.0                                        │\n├──────────────────────────────────────────────────────────────────────┤\n│ Compact Thai responses for AI coding agents                          │\n│                                                                      │\n│ Status        ● ACTIVE                                               │\n│ Mode          auto                                                   │\n│ Profile       coding                                                 │\n│ Safety        strict                                                 │\n│ Version       2.0.0                                                  │\n│                                                                      │\n│ Token Saving  ░░░░░░░░░░░░░░░░░░░░    0%                             │\n│                                                                      │\n│ Quick Commands                                                       │\n│ tto auto       tto compress --pretty --budget 500 prompt.txt         │\n│ tto doctor     tto benchmark --pretty --strict --default-policy      │\n╰──────────────────────────────────────────────────────────────────────╯\n```\n\n#### Quality UI\n\nใช้หลัง benchmark หรือ CI เพื่อดูคะแนนคุณภาพรวม พร้อมสถานะ strict gate, MTP gate, routing gate, weak signals และ suggested actions\n\n```bash\ntto quality --pretty\n```\n\n```text\n╭────────────────────────────────────────────────────────────────────────────────╮\n│ 🧠 TTO Quality Score                                                            │\n├────────────────────────────────────────────────────────────────────────────────┤\n│ Score         ███████████████░ 95.8\u002F100                                        │\n│ Grade         S                                                                │\n│ Strict Gate   PASS                                                             │\n│ MTP Gate      PASS                                                             │\n│ Routing Gate  PASS                                                             │\n│                                                                                │\n│ Weak Signals                                                                   │\n│ • low_saving_cluster                                                           │\n│ • tool_cascade                                                                 │\n│                                                                                │\n│ Suggested Actions                                                              │\n│ • add_tool_circuit_breaker: After 2 consecutive tool failures, stop retri…     │\n│ • tune_selective_window: Increase selective-window aggressiveness for low…     │\n╰────────────────────────────────────────────────────────────────────────────────╯\n```\n\n#### Compression UI\n\nใช้เมื่ออยากเห็นผลบีบอัดแบบอ่านง่าย มี token ก่อน\u002Fหลัง, จำนวน token ที่ประหยัด, preservation score, risk และตัวอย่าง optimized prompt\n\n```bash\ntto compress --pretty --level auto --target codex --budget 120 --check \"...\"\n```\n\n```text\n╭────────────────────────────────────────────────────────────────────────────────╮\n│ ✂️  Prompt Compression Result                                                  │\n├────────────────────────────────────────────────────────────────────────────────┤\n│ Target        codex                                                            │\n│ Mode          auto                                                             │\n│ Budget        120 tokens                                                       │\n│                                                                                │\n│ Before        53 tokens                                                        │\n│ After         48 tokens                                                        │\n│ Saved         5 tokens                                                         │\n│ Ratio         ██░░░░░░░░░░░░░░░░░░   9.4%                                      │\n│                                                                                │\n│ Preservation  ████████████████████   100%                                      │\n│ Risk          low                                                              │\n│ Missing       0                                                                │\n│                                                                                │\n│ Optimized                                                                      │\n│   อธิบายวิธีใช้งาน Thai Token Optimizer v2.0 ละเอียด โดยต้องคงคำสั่ง tto doct… │\n╰────────────────────────────────────────────────────────────────────────────────╯\n```\n\n#### Benchmark UI\n\nใช้เป็นหน้าจอหลักสำหรับ release\u002FCI confidence เพราะรวม strict regression gate และ MTP comparison ในจุดเดียว\n\n```bash\ntto benchmark --pretty --strict --default-policy --mtp\n```\n\n```text\n╭────────────────────────────────────────────────────────────────────────────────╮\n│ 📊 Thai Token Optimizer v2.0.0 Benchmark                                        │\n├────────────────────────────────────────────────────────────────────────────────┤\n│ Samples       8                                                                │\n│ Average Save  ██░░░░░░░░░░░░░░░░░░    12%                                      │\n│ Preservation  ████████████████████   100%                                      │\n│ Strict Gate   PASS                                                             │\n│                                                                                │\n│ MTP Compare  ON                                                                │\n│ Normal ms    1.3 (p95 3.7)                                                     │\n│ Spec ms      11.3 (p95 16)                                                     │\n│ Delta ms     10                                                                │\n│ Spec Hits    7\u002F8 (87.5%)                                                       │\n│ MTP Gate     PASS                                                              │\n╰────────────────────────────────────────────────────────────────────────────────╯\n```\n\n#### Fleet UI\n\nใช้ audit หลายโปรเจกต์หรือหลาย agent พร้อมดู benchmark, calibration, session scan, detector, cost และ coverage ในมุมองค์กร\n\n```bash\ntto fleet --pretty --calibration --session-scan\n```\n\n```text\n╭────────────────────────────────────────────────────────────────────────────────╮\n│ 🌐 Fleet \u002F Organization View                                                    │\n├────────────────────────────────────────────────────────────────────────────────┤\n│ Projects      1                                                                │\n│ Benchmarks    1                                                                │\n│ Strict PASS   1                                                                │\n│ MTP PASS      1                                                                │\n│ Route PASS    1                                                                │\n│ Avg Quality   90                                                               │\n│ Avg Saving    12%                                                              │\n│ Waste total   2                                                                │\n│ Calibration   ON (limit 50)                                                    │\n│ SessionScan   ON                                                               │\n│ Runs\u002FCost     0 runs | input 0 | cost ~$0                                      │\n│ Detectors    0 findings | waste 0 tok | ~$0\u002Fmo                                 │\n│                                                                                │\n│ Coverage      Codex:1 Claude:1 CI:1                                            │\n╰────────────────────────────────────────────────────────────────────────────────╯\n```\n\n#### Coach UI\n\nใช้เมื่อระบบยังผ่านคุณภาพรวม แต่มี weak signals หรือ anti-patterns ที่ควรแก้ต่อแบบมีแผน ไม่ต้องเดาเองจากตัวเลขดิบ\n\n```bash\ntto coach --pretty\n```\n\n```text\n╭────────────────────────────────────────────────────────────────────────────────╮\n│ 🧭 TTO Coach Mode (Guided Remediation)                                          │\n├────────────────────────────────────────────────────────────────────────────────┤\n│ Health Score  ███████████████░ 95.8\u002F100                                        │\n│ Health Grade  S                                                                │\n│ Summary       grade=S; weak=2; antiPatterns=2                                  │\n│                                                                                │\n│ Anti-patterns                                                                  │\n│ • tool_cascade | medium | agent-runtime-owner | Repeated tool cycles may add … │\n│ • low_saving_cluster | medium | compression-engine-owner | Low-value narrativ… │\n│                                                                                │\n│ Fix Plan                                                                       │\n│ • step-1 | medium | developer | Run `tto quality --pretty` and `tto…           │\n│ • step-2 | medium | developer | Capture checkpoint before optimizat…          │\n│ • step-3b | medium | agent-runtime-owner | After repeated tool cycles, stop a… │\n│ • step-3d | medium | compression-engine-owner | Tune selective compression fo… │\n│                                                                                │\n│ Applied       NO                                                               │\n│ • no auto-remediation                                                          │\n╰────────────────────────────────────────────────────────────────────────────────╯\n```\n\n---\n\n## 14) Policy และ Config\n\n```bash\ntto config path\ntto config get\ntto config set benchmarkStrict.mtpRepeats 9\n```\n\npolicy controls ประกอบด้วย:\n\n- strict saving gate\n- MTP preservation\u002Fhit-rate\u002Fslowdown thresholds\n- enhanced corpus minimum gain\n- detector thresholds สำหรับ routing\n\n---\n\n## 15) CI Pipeline\n\n```bash\nnpm run ci\n```\n\nลำดับ CI ปัจจุบันจาก `package.json`:\n\n```text\n1) npm run test:ci\n2) node bin\u002Fthai-token-optimizer.js benchmark --strict --default-policy --mtp\n3) node bin\u002Fthai-token-optimizer.js doctor --ci\n```\n\n---\n\n## 16) Snapshot การลด token จริง\n\nการเปรียบเทียบจริงล่าสุดในเครื่อง (`without TTO` เทียบกับ `with TTO`, 18 กรณี):\n\n```text\n┌──────────────────────┬────────┬───────────────┬──────────────┐\n│ Mode                 │ Tokens │ Saved         │ Preservation │\n├──────────────────────┼────────┼───────────────┼──────────────┤\n│ without TTO          │ 1789   │ baseline      │ n\u002Fa          │\n│ with TTO normal      │ 1344   │ -445 \u002F -24.9% │ 100% min     │\n│ with TTO MTP\u002Fspec    │ 1334   │ -455 \u002F -25.4% │ 100% min     │\n└──────────────────────┴────────┴───────────────┴──────────────┘\n```\n\n### ตารางเปรียบเทียบการลด Token\n\n```text\n┌──────────────────┬────────────────────────────────┬────────────────────────────────────────────────┬───────────────────────────────────────────┐\n│ หัวข้อเปรียบเทียบ    │ ภาษาไทย (Thai)                 │ ภาษาอังกฤษ (English)                            │ Mixed Language (ไทยผสมอังกฤษ)              │\n├──────────────────┼────────────────────────────────┼────────────────────────────────────────────────┼───────────────────────────────────────────┤\n│ อัตราการลดเฉลี่ย    │ 30% - 50%                      │ 15% - 98% (Logs\u002FALD)                           │ 25% - 60%                                 │\n│ กลไกหลัก          │ Filler Removal \u002F สรุปความประโยค │ Aggressive Log Dedup \u002F Sequence Detection      │ Technical Anchor Compression              │\n│ สิ่งที่ถูกลดออก     │ คำสุภาพ, คำเชื่อม, วลีเกริ่นนำ   │ Repeated Logs, Timestamps, Stack Traces        │ ภาษาไทยรอบข้าง Technical terms             │\n│ สิ่งที่ถูกรักษาไว้    │ ใจความสำคัญ, ตัวเลข, หน่วย      │ Code, Paths, Versions, JSON Keys               │ Technical terms และ Constraints ทั้ง 2 ภาษา │\n└──────────────────┴────────────────────────────────┴────────────────────────────────────────────────┴───────────────────────────────────────────┘\n```\n\n#### Aggressive Log Deduplication (ALD) [v2.0+]\nระบบบีบอัด Log ขั้นสูงที่สามารถลด Token ได้ถึง **98%++** สำหรับข้อมูลเชิงเทคนิค:\n- **Dynamic Masking:** ปกปิดข้อมูลตัวแปร (Timestamp, UUID, Hex, IPs) อัตโนมัติเพื่อให้เห็นโครงสร้างที่แท้จริง\n- **Sequence Detection:** ตรวจจับชุดลำดับบรรทัดที่ซ้ำกัน (เช่น `[RUN]` ตามด้วย `[PASS]`) แม้ข้อมูลภายในจะเปลี่ยน\n- **Maximum Capacity:** สามารถลด Log ปริมาณมหาศาล (1,000+ บรรทัด) เหลือเพียง 1-2 บรรทัดสรุป\n\n#### Smart Middle-Truncation (SMT) [v2.0+]\nเทคนิคการจัดการ Token เมื่อข้อมูลยาวเกินงบประมาณ (Budget) โดยไม่ใช้วิธีตัดท้ายทิ้งเพียงอย่างเดียว:\n- **Head-Tail Preservation:** รักษา \"จุดประสงค์\" (ตอนต้น) และ \"ผลลัพธ์\" (ตอนท้าย) ไว้เสมอ\n- **Context Continuity:** เจาะรูเฉพาะส่วนกลางที่เป็นรายละเอียดปลีกย่อย ช่วยให้ AI Agent ไม่เสียตรรกะการทำงาน\n- **Iterative Pruning:** ย่อรายละเอียดแบบเป็นลำดับขั้นเพื่อให้พอดีกับ Budget ที่จำกัดมากที่สุด\n\n---\n\nหมายเหตุ:\n\n- prompt ที่เข้มงวดด้านเทคนิค\u002Fความปลอดภัย อาจตั้งใจลด token ได้น้อย\n- estimator อาจเป็นแบบ heuristic เว้นแต่ติดตั้ง exact tokenizer dependencies แล้ว\n\n---\n\n## 17) Runtime Files และ Artifacts\n\n```text\n┌─ Local State ──────────────────────────────────────────────────────────────┐\n│ state.json              mode\u002Fprofile\u002Fspeculative flags                     │\n│ stats.jsonl             runtime stats                                      │\n│ dictionary.json          personalization words from tto keep               │\n│ policy.json              benchmark and compression policy                  │\n├─ Runtime Analytics ────────────────────────────────────────────────────────┤\n│ checkpoint JSONL         checkpoint lifecycle                              │\n│ cache read log           repeated read analytics                           │\n│ calibration JSONL        estimated vs real token gap                       │\n├─ Benchmark Artifacts ──────────────────────────────────────────────────────┤\n│ benchmarks\u002Fregression_report.md                                            │\n│ benchmarks\u002Fregression_report.json                                          │\n│ benchmarks\u002Fregression_history.jsonl                                        │\n│ benchmarks\u002Ffleet_history.jsonl                                             │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 18) การแก้ปัญหา\n\n### ปัญหา Hook JSON: UserPromptSubmit\n\n```text\nUserPromptSubmit hook failed\nerror: hook returned invalid user prompt submit JSON output\n```\n\n```bash\ntto doctor codex --pretty\nnode --test tests\u002Ftest_codex_triggers.js tests\u002Ftest_tracker.js\n```\n\n### ปัญหา Hook JSON: Stop\n\n```text\nStop hook failed\nerror: hook returned invalid stop hook JSON output\n```\n\n```bash\ntto doctor --pretty\nnode --test tests\u002Ftest_activate.js tests\u002Ftest_pretty_ui.js\n```\n\n### CI timeout หรือ flaky gate\n\n```bash\nnpm run test:ci\n```\n\nตรวจสอบ artifacts:\n\n- `benchmarks\u002Fregression_report.md`\n- `benchmarks\u002Fregression_report.json`\n\n---\n\n## 19) Quick Reference สำหรับการพัฒนา\n\nไดเรกทอรีสำคัญ:\n\n```text\nthai-token-optimizer\u002F\n├── bin\u002F          CLI entrypoint\n├── hooks\u002F        core engine, hooks, analytics, UI\n├── adapters\u002F     integration installers\n├── benchmarks\u002F   corpora, reports, gates\n├── tests\u002F        regression and integration tests\n├── .codex-plugin\u002F\n├── .claude-plugin\u002F\n├── .github\u002F\n├── README.md\n├── AGENTS.md\n├── MANUAL.md\n├── package.json\n└── LICENSE\n```\n\nการรันทดสอบแบบเจาะจง:\n\n```bash\nnode --test tests\u002Ftest_mtp_speculative.js tests\u002Ftest_mtp_benchmark.js tests\u002Ftest_mtp_detectors.js\nnode --test tests\u002Ftest_pretty_ui.js tests\u002Ftest_fleet_auditor.js\n```\n\n---\n\n## 20) Safety Checklist (สำหรับการทำงานที่มีความเสี่ยง)\n\n```text\n[1] classify risk\n[2] backup first\n[3] dry-run when available\n[4] apply change\n[5] verify result\n[6] keep rollback ready\n```\n\nตัวอย่าง:\n\n```bash\ntto backup all\ntto rollback latest --dry-run\ntto doctor --pretty\n```\n\n---\n\n## 22) Shell Proxy Mode (TTO-Proxy)\n\nTTO-Proxy ใช้ครอบคำสั่ง Shell เพื่อบีบอัด Output ภาษาไทยหรือ Log ที่ซ้ำซ้อนก่อนที่ AI Agent จะได้อ่าน ช่วยประหยัด Input Token ตั้งแต่ \"ต้นน้ำ\"\n\n### 22.1 การใช้งานพื้นฐาน\n\n```bash\ntto proxy \u003Ccommand> [args...]\ntto run \u003Ccommand> [args...]\n```\n\nตัวอย่าง:\n\n```bash\ntto proxy npm run test\ntto run git status\n```\n\n### 22.2 การผสานกับ AI Agents\n\nคุณสามารถตั้งค่าให้ Agent เรียกใช้ TTO-Proxy อัตโนมัติสำหรับคำสั่ง Bash (เช่นใน `.claude\u002Fsettings.json`):\n\n```json\n{\n  \"tools\": {\n    \"BashCommand\": {\n      \"wrapper\": \"tto proxy --silent --\"\n    }\n  }\n}\n```\n\n### 22.3 Specialized Command Lenses (การบีบอัดแบบเข้าใจบริบท)\n\nTTO-Proxy มาพร้อมกับฟีเจอร์ \"Lenses\" หรือฟิลเตอร์เฉพาะทางสำหรับแต่ละคำสั่ง (เช่น `git`, `docker`, `npm`) เพื่อการบีบอัดที่แม่นยำยิ่งขึ้น:\n*   **Git Lens:** รู้วิธีอ่านและแปล Output ของ `git status` ภาษาไทยที่ยาวและเป็นทางการ ให้กลายเป็นสัญลักษณ์ทางเทคนิคที่สั้นกระชับ (เช่น `ไฟล์ที่ถูกแก้ไขแต่ยังไม่ได้จัดเตรียมสำหรับการ commit` → `[!] ไม่ได้ stage:` หรือ `[M]`)\n*   **ความแม่นยำสูง:** ตัด \"น้ำ\" ออกจากคำสั่งเฉพาะทางก่อนที่จะส่งให้ ALD\u002FSMT ช่วยลด Token ได้กว่า 90%\n*   **รองรับ Mixed Language:** ทำงานได้อย่างสมบูรณ์แบบไม่ว่า Tool จะพ่น Output ออกมาเป็นภาษาไทย, ภาษาอังกฤษ, หรือผสมกัน โดยยังคงรักษา Path และข้อมูลเทคนิคไว้ 100%\n\n---\n\n## 21) License\n\nMIT License\n\nดู [LICENSE](LICENSE)\n","Thai Token Optimizer 是一个专为AI编码助手设计的泰语文本优化工具，旨在保持命令、代码和技术细节的准确性。其核心功能包括通过减少不必要的泰语token来优化文本，同时确保安全性和技术正确性不受影响。该工具采用CLI（命令行界面）形式，支持本地优先的工作流程，并具备rollback等高级特性。它特别适合需要高效处理泰语文本且对技术细节有高要求的应用场景，如自动化编程辅助、代码审查等。基于JavaScript开发，遵循MIT许可证，易于集成和扩展。","2026-06-11 04:03:26","CREATED_QUERY"]