toonify-mcp 0.2.3 → 0.3.1

package/README.vi.md

@@ -0,0 +1,270 @@
+# 🎯 Toonify MCP
+
+**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
+
+Máy chủ MCP + Plugin Claude Code cung cấp tối ưu hóa token tự động cho dữ liệu có cấu trúc.
+Giảm 30-65% việc sử dụng token của Claude API **tùy thuộc vào cấu trúc dữ liệu** thông qua chuyển đổi định dạng TOON minh bạch, với mức tiết kiệm điển hình **50-55%** cho dữ liệu có cấu trúc.
+
+## Tính năng mới trong v0.3.0
+
+✨ **Tối ưu hóa token đa ngôn ngữ!**
+- ✅ Đếm token chính xác cho hơn 15 ngôn ngữ (Trung, Nhật, Hàn, Tây Ban Nha, Ả Rập, v.v.)
+- ✅ Hệ số nhân token nhận biết ngôn ngữ (2x cho tiếng Trung, 2.5x cho tiếng Nhật, 3x cho tiếng Ả Rập)
+- ✅ Hỗ trợ phát hiện tự động văn bản hỗn hợp nhiều ngôn ngữ
+- ✅ Cải thiện độ chính xác tối ưu hóa dựa trên kiểm tra chuẩn thực tế
+- ✅ Tuyên bố tiết kiệm token được hỗ trợ bởi dữ liệu (phạm vi 30-65%, thường 50-55%)
+
+## Tính năng
+
+- **Giảm 30-65% token** (thường 50-55%) cho dữ liệu JSON, CSV, YAML
+- **Hỗ trợ đa ngôn ngữ** - Đếm token chính xác cho hơn 15 ngôn ngữ
+- **Hoàn toàn tự động** - Hook PostToolUse chặn kết quả công cụ
+- **Không cần cấu hình** - Hoạt động ngay lập tức với các giá trị mặc định hợp lý
+- **Chế độ kép** - Hoạt động như plugin (tự động) hoặc máy chủ MCP (thủ công)
+- **Chỉ số tích hợp** - Theo dõi tiết kiệm token cục bộ
+- **Dự phòng im lặng** - Không bao giờ làm gián đoạn quy trình làm việc của bạn
+
+## Cài đặt
+
+### Tùy chọn A: Plugin Claude Code (Khuyến nghị) ⭐
+
+**Tối ưu hóa token tự động không cần gọi thủ công:**
+
+```bash
+# 1. Cài đặt toàn cục
+npm install -g toonify-mcp
+
+# 2. Thêm làm plugin (chế độ tự động)
+claude plugin add toonify-mcp
+
+# 3. Xác minh cài đặt
+claude plugin list
+# Nên hiển thị: toonify-mcp ✓
+```
+
+**Xong! ** Hook PostToolUse bây giờ sẽ tự động chặn và tối ưu hóa dữ liệu có cấu trúc từ Read, Grep và các công cụ tệp khác.
+
+### Tùy chọn B: Máy chủ MCP (chế độ thủ công)
+
+**Cho kiểm soát rõ ràng hoặc các máy khách MCP không phải Claude Code:**
+
+```bash
+# 1. Cài đặt toàn cục
+npm install -g toonify-mcp
+
+# 2. Đăng ký làm máy chủ MCP
+claude mcp add toonify -- toonify-mcp
+
+# 3. Xác minh
+claude mcp list
+# Nên hiển thị: toonify: toonify-mcp - ✓ Connected
+```
+
+Sau đó gọi các công cụ rõ ràng:
+```bash
+claude mcp call toonify optimize_content '{"content": "..."}'
+claude mcp call toonify get_stats '{}'
+```
+
+## Cách hoạt động
+
+### Chế độ plugin (tự động)
+
+```
+Người dùng: Đọc tệp JSON lớn
+  ↓
+Claude Code gọi công cụ Read
+  ↓
+Hook PostToolUse chặn kết quả
+  ↓
+Hook phát hiện JSON, chuyển đổi sang TOON
+  ↓
+Nội dung đã tối ưu hóa được gửi đến Claude API
+  ↓
+Đạt được mức giảm token điển hình 50-55% ✨
+```
+
+### Chế độ máy chủ MCP (thủ công)
+
+```
+Người dùng: Gọi rõ ràng mcp__toonify__optimize_content
+  ↓
+Nội dung được chuyển đổi sang định dạng TOON
+  ↓
+Trả về kết quả đã tối ưu hóa
+```
+
+## Cấu hình
+
+Tạo `~/.claude/toonify-config.json` (tùy chọn):
+
+```json
+{
+  "enabled": true,
+  "minTokensThreshold": 50,
+  "minSavingsThreshold": 30,
+  "skipToolPatterns": ["Bash", "Write", "Edit"]
+}
+```
+
+### Tùy chọn
+
+- **enabled**: Bật/tắt tối ưu hóa tự động (mặc định: `true`)
+- **minTokensThreshold**: Token tối thiểu trước khi tối ưu hóa (mặc định: `50`)
+- **minSavingsThreshold**: Phần trăm tiết kiệm tối thiểu yêu cầu (mặc định: `30%`)
+- **skipToolPatterns**: Công cụ không bao giờ tối ưu hóa (mặc định: `["Bash", "Write", "Edit"]`)
+
+### Biến môi trường
+
+```bash
+export TOONIFY_ENABLED=true
+export TOONIFY_MIN_TOKENS=50
+export TOONIFY_MIN_SAVINGS=30
+export TOONIFY_SKIP_TOOLS="Bash,Write"
+export TOONIFY_SHOW_STATS=true  # Hiển thị thống kê tối ưu hóa trong đầu ra
+```
+
+## Ví dụ
+
+### Trước khi tối ưu hóa (142 token)
+
+```json
+{
+  "products": [
+    {"id": 101, "name": "Laptop Pro", "price": 1299},
+    {"id": 102, "name": "Magic Mouse", "price": 79}
+  ]
+}
+```
+
+### Sau khi tối ưu hóa (57 token, -60%)
+
+```
+[TOON-JSON]
+products[2]{id,name,price}:
+  101,Laptop Pro,1299
+  102,Magic Mouse,79
+```
+
+**Tự động áp dụng ở chế độ plugin - không cần gọi thủ công!**
+
+## Mẹo sử dụng
+
+### Khi nào tối ưu hóa tự động được kích hoạt?
+
+Hook PostToolUse tự động tối ưu hóa khi:
+- ✅ Nội dung là JSON, CSV hoặc YAML hợp lệ
+- ✅ Kích thước nội dung ≥ `minTokensThreshold` (mặc định: 50 token)
+- ✅ Tiết kiệm ước tính ≥ `minSavingsThreshold` (mặc định: 30%)
+- ✅ Công cụ KHÔNG có trong `skipToolPatterns` (ví dụ: không phải Bash/Write/Edit)
+
+### Xem thống kê tối ưu hóa
+
+```bash
+# Ở chế độ plugin
+claude mcp call toonify get_stats '{}'
+
+# Hoặc kiểm tra đầu ra Claude Code để xem thống kê (nếu TOONIFY_SHOW_STATS=true)
+```
+
+## Khắc phục sự cố
+
+### Hook không kích hoạt
+
+```bash
+# 1. Kiểm tra plugin đã được cài đặt
+claude plugin list | grep toonify
+
+# 2. Kiểm tra cấu hình
+cat ~/.claude/toonify-config.json
+
+# 3. Bật thống kê để xem các lần thử tối ưu hóa
+export TOONIFY_SHOW_STATS=true
+```
+
+### Tối ưu hóa không được áp dụng
+
+- Kiểm tra `minTokensThreshold` - nội dung có thể quá nhỏ
+- Kiểm tra `minSavingsThreshold` - tiết kiệm có thể < 30%
+- Kiểm tra `skipToolPatterns` - công cụ có thể nằm trong danh sách bỏ qua
+- Xác minh nội dung là JSON/CSV/YAML hợp lệ
+
+### Vấn đề hiệu suất
+
+- Giảm `minTokensThreshold` để tối ưu hóa tích cực hơn
+- Tăng `minSavingsThreshold` để bỏ qua các tối ưu hóa biên
+- Thêm nhiều công cụ hơn vào `skipToolPatterns` nếu cần
+
+## So sánh: Plugin vs Máy chủ MCP
+
+| Tính năng | Chế độ Plugin | Chế độ Máy chủ MCP |
+|-----------|--------------|-------------------|
+| **Kích hoạt** | Tự động (PostToolUse) | Thủ công (gọi công cụ) |
+| **Tương thích** | Chỉ Claude Code | Bất kỳ máy khách MCP nào |
+| **Cấu hình** | Tệp cấu hình plugin | Công cụ MCP |
+| **Hiệu suất** | Không có chi phí | Chi phí gọi |
+| **Trường hợp sử dụng** | Quy trình làm việc hàng ngày | Kiểm soát rõ ràng |
+
+**Khuyến nghị**: Sử dụng chế độ plugin cho tối ưu hóa tự động. Sử dụng chế độ máy chủ MCP cho kiểm soát rõ ràng hoặc các máy khách MCP khác.
+
+## Gỡ cài đặt
+
+### Chế độ plugin
+```bash
+claude plugin remove toonify-mcp
+rm ~/.claude/toonify-config.json
+```
+
+### Chế độ máy chủ MCP
+```bash
+claude mcp remove toonify
+```
+
+### Gói
+```bash
+npm uninstall -g toonify-mcp
+```
+
+## Liên kết
+
+- **GitHub**: https://github.com/kevintseng/toonify-mcp
+- **Issues**: https://github.com/kevintseng/toonify-mcp/issues
+- **NPM**: https://www.npmjs.com/package/toonify-mcp
+- **Tài liệu MCP**: https://code.claude.com/docs/mcp
+- **Định dạng TOON**: https://github.com/toon-format/toon
+
+## Đóng góp
+
+Đóng góp được chào đón! Vui lòng xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết hướng dẫn.
+
+## Giấy phép
+
+Giấy phép MIT - xem [LICENSE](LICENSE)
+
+## Nhật ký thay đổi
+
+### v0.3.0 (2025-12-26)
+- ✨ **Tối ưu hóa token đa ngôn ngữ** - đếm chính xác cho hơn 15 ngôn ngữ
+- ✨ Hệ số nhân token nhận biết ngôn ngữ (2x Trung, 2.5x Nhật, 3x Ả Rập, v.v.)
+- ✨ Phát hiện và tối ưu hóa văn bản hỗn hợp nhiều ngôn ngữ
+- ✨ Kiểm tra chuẩn toàn diện với thống kê thực tế
+- 📊 Tuyên bố tiết kiệm token được hỗ trợ bởi dữ liệu (phạm vi 30-65%, thường 50-55%)
+- ✅ Hơn 75 kiểm tra đã vượt qua, bao gồm các trường hợp biên đa ngôn ngữ
+- 📝 Các phiên bản README đa ngôn ngữ
+
+### v0.2.0 (2025-12-25)
+- ✨ Đã thêm hỗ trợ plugin Claude Code với hook PostToolUse
+- ✨ Tối ưu hóa token tự động (không cần gọi thủ công)
+- ✨ Hệ thống cấu hình plugin
+- ✨ Chế độ kép: Plugin (tự động) + Máy chủ MCP (thủ công)
+- 📝 Cập nhật tài liệu toàn diện
+
+### v0.1.1 (2024-12-24)
+- 🐛 Sửa lỗi và cải tiến
+- 📝 Cập nhật tài liệu
+
+### v0.1.0 (2024-12-24)
+- 🎉 Phát hành ban đầu
+- ✨ Triển khai máy chủ MCP
+- ✨ Tối ưu hóa định dạng TOON
+- ✨ Theo dõi chỉ số tích hợp

package/README.zh-CN.md

@@ -0,0 +1,270 @@
+# 🎯 Toonify MCP
+
+**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
+
+MCP 服务器 + Claude Code 插件，提供结构化数据的自动 token 优化。
+通过透明的 TOON 格式转换，**根据数据结构减少 30-65% 的 Claude API token 使用量**，结构化数据的典型节省率为 **50-55%**。
+
+## v0.3.0 新功能
+
+✨ **多语言 Token 优化！**
+- ✅ 精确计算 15+ 种语言的 token（中文、日文、韩文、西班牙文、阿拉伯文等）
+- ✅ 语言感知的 token 倍数（中文 2 倍、日文 2.5 倍、阿拉伯文 3 倍）
+- ✅ 支持混合语言文本的自动检测
+- ✅ 基于真实基准测试改进优化准确性
+- ✅ 数据支持的 token 节省声明（30-65% 范围，通常 50-55%）
+
+## 功能特色
+
+- **30-65% Token 减少**（通常 50-55%）适用于 JSON、CSV、YAML 数据
+- **多语言支持** - 精确计算 15+ 种语言的 token
+- **完全自动** - PostToolUse hook 拦截工具结果
+- **零配置** - 开箱即用，采用合理预设值
+- **双模式** - 作为插件（自动）或 MCP 服务器（手动）
+- **内建指标** - 在本地追踪 token 节省
+- **静默回退** - 永不中断您的工作流程
+
+## 安装
+
+### 选项 A：Claude Code 插件（推荐）⭐
+
+**零手动调用的自动 token 优化：**
+
+```bash
+# 1. 全局安装
+npm install -g toonify-mcp
+
+# 2. 添加为插件（自动模式）
+claude plugin add toonify-mcp
+
+# 3. 验证安装
+claude plugin list
+# 应显示：toonify-mcp ✓
+```
+
+**完成！** PostToolUse hook 现在会自动拦截并优化来自 Read、Grep 和其他文件工具的结构化数据。
+
+### 选项 B：MCP 服务器（手动模式）
+
+**用于明确控制或非 Claude Code MCP 客户端：**
+
+```bash
+# 1. 全局安装
+npm install -g toonify-mcp
+
+# 2. 注册为 MCP 服务器
+claude mcp add toonify -- toonify-mcp
+
+# 3. 验证
+claude mcp list
+# 应显示：toonify: toonify-mcp - ✓ Connected
+```
+
+然后明确调用工具：
+```bash
+claude mcp call toonify optimize_content '{"content": "..."}'
+claude mcp call toonify get_stats '{}'
+```
+
+## 运作原理
+
+### 插件模式（自动）
+
+```
+用户：读取大型 JSON 文件
+  ↓
+Claude Code 调用 Read 工具
+  ↓
+PostToolUse hook 拦截结果
+  ↓
+Hook 检测 JSON，转换为 TOON
+  ↓
+优化后的内容发送到 Claude API
+  ↓
+达成 50-55% 典型 token 减少 ✨
+```
+
+### MCP 服务器模式（手动）
+
+```
+用户：明确调用 mcp__toonify__optimize_content
+  ↓
+内容转换为 TOON 格式
+  ↓
+返回优化结果
+```
+
+## 配置
+
+创建 `~/.claude/toonify-config.json`（可选）：
+
+```json
+{
+  "enabled": true,
+  "minTokensThreshold": 50,
+  "minSavingsThreshold": 30,
+  "skipToolPatterns": ["Bash", "Write", "Edit"]
+}
+```
+
+### 选项
+
+- **enabled**：启用/停用自动优化（预设：`true`）
+- **minTokensThreshold**：优化前的最小 token 数（预设：`50`）
+- **minSavingsThreshold**：所需的最小节省百分比（预设：`30%`）
+- **skipToolPatterns**：永不优化的工具（预设：`["Bash", "Write", "Edit"]`）
+
+### 环境变量
+
+```bash
+export TOONIFY_ENABLED=true
+export TOONIFY_MIN_TOKENS=50
+export TOONIFY_MIN_SAVINGS=30
+export TOONIFY_SKIP_TOOLS="Bash,Write"
+export TOONIFY_SHOW_STATS=true  # 在输出中显示优化统计
+```
+
+## 示例
+
+### 优化前（142 tokens）
+
+```json
+{
+  "products": [
+    {"id": 101, "name": "Laptop Pro", "price": 1299},
+    {"id": 102, "name": "Magic Mouse", "price": 79}
+  ]
+}
+```
+
+### 优化后（57 tokens，-60%）
+
+```
+[TOON-JSON]
+products[2]{id,name,price}:
+  101,Laptop Pro,1299
+  102,Magic Mouse,79
+```
+
+**在插件模式下自动应用 - 无需手动调用！**
+
+## 使用技巧
+
+### 何时触发自动优化？
+
+PostToolUse hook 在以下情况下自动优化：
+- ✅ 内容是有效的 JSON、CSV 或 YAML
+- ✅ 内容大小 ≥ `minTokensThreshold`（预设：50 tokens）
+- ✅ 预估节省 ≥ `minSavingsThreshold`（预设：30%）
+- ✅ 工具不在 `skipToolPatterns` 中（例如，不是 Bash/Write/Edit）
+
+### 查看优化统计
+
+```bash
+# 在插件模式下
+claude mcp call toonify get_stats '{}'
+
+# 或检查 Claude Code 输出的统计（如果 TOONIFY_SHOW_STATS=true）
+```
+
+## 故障排除
+
+### Hook 未触发
+
+```bash
+# 1. 检查插件是否已安装
+claude plugin list | grep toonify
+
+# 2. 检查配置
+cat ~/.claude/toonify-config.json
+
+# 3. 启用统计以查看优化尝试
+export TOONIFY_SHOW_STATS=true
+```
+
+### 未应用优化
+
+- 检查 `minTokensThreshold` - 内容可能太小
+- 检查 `minSavingsThreshold` - 节省可能 < 30%
+- 检查 `skipToolPatterns` - 工具可能在跳过列表中
+- 验证内容是有效的 JSON/CSV/YAML
+
+### 性能问题
+
+- 降低 `minTokensThreshold` 以更积极地优化
+- 提高 `minSavingsThreshold` 以跳过边际优化
+- 如需要，将更多工具添加到 `skipToolPatterns`
+
+## 比较：插件 vs MCP 服务器
+
+| 功能 | 插件模式 | MCP 服务器模式 |
+|------|---------|--------------|
+| **激活** | 自动（PostToolUse） | 手动（调用工具） |
+| **兼容性** | 仅 Claude Code | 任何 MCP 客户端 |
+| **配置** | 插件配置文件 | MCP 工具 |
+| **性能** | 零开销 | 调用开销 |
+| **使用情境** | 日常工作流程 | 明确控制 |
+
+**建议**：使用插件模式进行自动优化。使用 MCP 服务器模式进行明确控制或其他 MCP 客户端。
+
+## 卸载
+
+### 插件模式
+```bash
+claude plugin remove toonify-mcp
+rm ~/.claude/toonify-config.json
+```
+
+### MCP 服务器模式
+```bash
+claude mcp remove toonify
+```
+
+### 包
+```bash
+npm uninstall -g toonify-mcp
+```
+
+## 链接
+
+- **GitHub**：https://github.com/kevintseng/toonify-mcp
+- **Issues**：https://github.com/kevintseng/toonify-mcp/issues
+- **NPM**：https://www.npmjs.com/package/toonify-mcp
+- **MCP 文档**：https://code.claude.com/docs/mcp
+- **TOON 格式**：https://github.com/toon-format/toon
+
+## 贡献
+
+欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。
+
+## 授权
+
+MIT 授权 - 请参阅 [LICENSE](LICENSE)
+
+## 更新日志
+
+### v0.3.0（2025-12-26）
+- ✨ **多语言 token 优化** - 精确计算 15+ 种语言
+- ✨ 语言感知的 token 倍数（中文 2 倍、日文 2.5 倍、阿拉伯文 3 倍等）
+- ✨ 混合语言文本检测和优化
+- ✨ 使用真实统计数据进行全面基准测试
+- 📊 数据支持的 token 节省声明（30-65% 范围，通常 50-55%）
+- ✅ 75+ 测试通过，包括多语言边缘情况
+- 📝 多语言 README 版本
+
+### v0.2.0 (2025-12-25)
+- ✨ 添加 Claude Code 插件支持和 PostToolUse hook
+- ✨ 自动 token 优化（无需手动调用）
+- ✨ 插件配置系统
+- ✨ 双模式：插件（自动）+ MCP 服务器（手动）
+- 📝 全面文档更新
+
+### v0.1.1 (2024-12-24)
+- 🐛 错误修复和改进
+- 📝 文档更新
+
+### v0.1.0 (2024-12-24)
+- 🎉 初始发布
+- ✨ MCP 服务器实现
+- ✨ TOON 格式优化
+- ✨ 内建指标追踪

package/README.zh-TW.md

@@ -1,26 +1,28 @@
 # 🎯 Toonify MCP
 
-**[English](README.md) | [繁體中文](README.zh-TW.md)**
+**[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
 
-MCP 伺服器 + Claude Code 插件，提供結構化數據的自動 token 優化。
-透過透明的 TOON 格式轉換，**平均減少 60%+ 的 Claude API token 使用**。
+MCP 伺服器 + Claude Code 外掛程式，提供結構化數據的自動 token 優化。
+透過透明的 TOON 格式轉換，**根據數據結構減少 30-65% 的 Claude API token 使用量**，結構化數據的典型節省率為 **50-55%**。
 
-## v0.2.0 新功能
+## v0.3.0 新功能
 
-✨ **現在是完整的 Claude Code 插件！**
-- ✅ 自動 PostToolUse hook 攔截
-- ✅ 無需手動調用
-- ✅ 透明優化
-- ✅ 仍可作為獨立 MCP 伺服器使用
+✨ **多語言 Token 優化！**
+- ✅ 精確計算 15+ 種語言的 token（中文、日文、韓文、西班牙文、阿拉伯文等）
+- ✅ 語言感知的 token 倍數（中文 2 倍、日文 2.5 倍、阿拉伯文 3 倍）
+- ✅ 支援混合語言文本的自動偵測
+- ✅ 基於真實基準測試改進優化準確性
+- ✅ 數據支持的 token 節省聲明（30-65% 範圍，通常 50-55%）
 
 ## 功能特色
 
-- **60%+ Token 減少** - 針對 JSON、CSV、YAML 數據
-- **完全自動** - PostToolUse hook 自動攔截工具結果
-- **零配置** - 開箱即用，預設值合理
-- **雙模式** - 插件模式（自動）+ MCP 伺服器模式（手動）
-- **內建指標** - 本地追蹤 token 節省
-- **靜默降級** - 永不中斷工作流程
+- **30-65% Token 減少**（通常 50-55%）適用於 JSON、CSV、YAML 數據
+- **多語言支援** - 精確計算 15+ 種語言的 token
+- **完全自動** - PostToolUse hook 攔截工具結果
+- **零配置** - 開箱即用，採用合理預設值
+- **雙模式** - 作為外掛程式（自動）或 MCP 伺服器（手動）
+- **內建指標** - 在本地追蹤 token 節省
+- **靜默回退** - 永不中斷您的工作流程
 
 ## 安裝方式
 
@@ -79,7 +81,7 @@ Hook 偵測 JSON，轉換為 TOON
   ↓
 優化後的內容發送到 Claude API
   ↓
-實現 60% token 減少 ✨
+達成 50-55% 典型 token 減少 ✨
 ```
 
 ### MCP 伺服器模式（手動）
@@ -241,6 +243,15 @@ MIT License - 請參閱 [LICENSE](LICENSE)
 
 ## 更新日誌
 
+### v0.3.0（2025-12-26）
+- ✨ **多語言 token 優化** - 精確計算 15+ 種語言
+- ✨ 語言感知的 token 倍數（中文 2 倍、日文 2.5 倍、阿拉伯文 3 倍等）
+- ✨ 混合語言文本偵測和優化
+- ✨ 使用真實統計數據進行全面基準測試
+- 📊 數據支持的 token 節省聲明（30-65% 範圍，通常 50-55%）
+- ✅ 75+ 測試通過，包括多語言邊緣情況
+- 📝 多語言 README 版本
+
 ### v0.2.0 (2025-12-25)
 - ✨ 新增 Claude Code 插件支援與 PostToolUse hook
 - ✨ 自動 token 優化（無需手動調用）

package/dist/metrics/metrics-collector.d.ts

@@ -12,6 +12,8 @@ export interface OptimizationMetric {
     wasOptimized: boolean;
     format?: string;
     reason?: string;
+    wasCached?: boolean;
+    cacheSavings?: number;
 }
 export declare class MetricsCollector {
     private statsPath;

package/dist/metrics/metrics-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../../src/metrics/metrics-collector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAS;;IAW1B;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BvD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAIrC;;OAEG;YACW,SAAS;IAoBvB;;OAEG;YACW,SAAS;IAQvB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;CAiBzC"}
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../../src/metrics/metrics-collector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAS;;IAW1B;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCvD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAIrC;;OAEG;YACW,SAAS;IAyBvB;;OAEG;YACW,SAAS;IAQvB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;CAyCzC"}