介绍
# Token Saver v3
> **💡 你知道吗？** 每次 API 调用都会随你的消息一起发送工作区文件（SOUL.md、USER.md、MEMORY.md、AGENTS.md 等）。这些文件计入你的上下文窗口，会减慢响应速度，并且每条消息都会花费真金白银。
Token Saver v3 是**模型感知的**——它知道你的模型的上下文窗口并相应地调整建议。使用 Gemini 的 1M 上下文？预设会自动放大。在 GPT-4o 的 128K 上？预设会自动缩小。
## v3 新功能
| 功能 | v2 | v3 | |---------|----|----| | 压缩预设 | 固定 (80K/120K/160K) | 动态（模型上下文的百分比） | | 模型检测 | 脆弱，仅限环境变量 | 健壮的回退链 | | 上下文窗口 | 未跟踪 | 完整注册表（9 个模型） | | 模型信息 | 硬编码定价 | JSON 注册表，易于更新 | | 已优化文件 | 重新压缩 | 智能绕过 |
## 命令
| 命令 | 功能 | |---|---| | `/optimize` | 完整仪表板 —— 文件、模型、上下文使用百分比 | | `/optimize tokens` | 压缩工作区文件（自动备份） | | `/optimize compaction` | 聊天压缩控制（模型感知） | | `/optimize compaction balanced` | 应用平衡预设（上下文的 60%） | | `/optimize compaction 120` | 自定义阈值（在 120K 时压缩） | | `/optimize models` | 包含注册表的详细模型审计 | | `/optimize revert` | 恢复备份，禁用持久模式 |
## 功能
### 📊 模型感知仪表板 显示当前模型、上下文窗口和使用百分比： ``` 🤖 Model: Claude Opus 4.5 (200K context) Detected: openclaw.json
📊 Context Usage: [████████░░░░░░░░░░░░] 42% (84K/200K) ```
### 📁 工作区文件压缩 扫描所有 `.md` 文件，显示 token 数量和潜在节省。智能绕过会跳过已优化的文件。
**文件感知压缩：** - **SOUL.md** — 轻度压缩，保留个性语言 - **AGENTS.md** — 中度压缩，密集指令 - **USER.md / MEMORY.md** — 重度压缩，key:value 格式 - **PROJECTS.md** — 不压缩（保留用户结构）
### 💬 动态压缩预设 预设会根据你的模型的上下文窗口自动调整：
| 预设 | 上下文百分比 | Claude 200K | GPT-4o 128K | Gemini 1M | |--------|--------------|-------------|-------------|-----------| | 激进 | 40% | 80K | 51K | 400K | | 平衡 | 60% | 120K | 77K | 600K | | 保守 | 80% | 160K | 102K | 800K | | 关闭 | 95% | 190K | 122K | 950K |
### 🤖 模型注册表 24+ 模型，包含上下文窗口、定价和别名： - **Claude:** Opus 4.6 (1M), Opus 4.5, Sonnet 4.5, Sonnet 4, Haiku 4.5, Haiku 3.5 (200K) - **OpenAI:** GPT-5.2, GPT-5.1, GPT-5-mini, GPT-5-nano (256K), GPT-4.1, GPT-4o (128K), o1, o3, o4-mini - **Gemini:** 3 Pro (2M), 2.5 Pro, 2.0 Flash (1M) - **其他:** DeepSeek V3 (64K), Kimi K2.5 (128K), Llama 3.3 70B, Mistral Large
### 🔍 健壮的模型检测 检测优先级： 1. 运行时注入 (`--model=...`) 2. 环境变量 (`SKILL_MODEL`, `OPENCLAW_MODEL`) 3. 配置文件 (`~/.openclaw/openclaw.json`) 4. 文件推断 (TOOLS.md, MEMORY.md 提及) 5. 回退：Claude Sonnet 4（安全默认值）
**未知模型处理：** - 严格版本匹配 —— `opus-6.5` 不会模糊匹配到 `opus-4.5` - 未知模型获得安全默认值（200K 上下文）+ 警告 - 易于在 `scripts/models.json` 中添加新模型
### 📝 持久模式 向 AGENTS.md 添加写作指南以保持 token 效率：
| 文件 | 写作风格 | |------|---------------| | SOUL.md | 富有表现力，塑造个性 | | AGENTS.md | 密集指令，允许符号 | | USER.md | Key:value 事实 | | MEMORY.md | 超密集数据 |
## 安全性
- **自动备份** — 所有修改的文件都会添加 `.backup` 后缀 - **完整性 > 大小** — 绝不为了更小的 token 而牺牲含义 - **智能绕过** — 跳过已优化的文件 - **随时回退** — `/optimize revert` 恢复一切 - **无外部调用** — 所有分析均在本地运行
## 安装
``` clawhub install token-saver --registry "https://www.clawhub.ai" ```
## 版本历史 - **3.0.0** — 模型注册表，动态预设，健壮检测，智能绕过 - **2.0.1** — 聊天压缩，文件感知压缩，持久模式 - **1.0.0** — 初始发布