内容
<div align="center">
# ⚡ Token Saver Desktop
### 中立的 AI 智能体令牌效率控制平面
**诊断浪费。匹配正确的压缩策略。验证成功任务的成本。**
[](LICENSE)
[](docs/V1.md)
[](src-tauri)
[](#privacy)
[](https://github.com/SiruGao/token-saver/actions/workflows/ci.yml)
[开始使用](#get-started) · [策略中心](docs/STRATEGY_HUB.md) · [V1 范围](docs/V1.md) · [基准测试](docs/BENCHMARKS.md) · [路线图](ROADMAP.md)
[English](README.md) · [中文说明](README_CN.md)
</div>
---
Token Saver 是一款本地优先的桌面应用程序，用于诊断 AI 智能体令牌浪费，并通过一个界面协调兼容的第三方压缩策略。
它并不试图拥有所有的压缩算法。该产品是围绕它们的控制循环：
```text
医生 → 策略 → 适配器 → 验证
```
- **医生** 确定重复的上下文、过大的输出、缓存漂移和可能的返工。
- **策略中心** 将这些发现映射到兼容的外部引擎。
- **更新中心** 跟踪上游版本，而不静默安装它们。
- **验证** 将比较令牌、重试、延迟、任务质量和实际提供商成本。
主要指标是：
```text
成功任务的成本
= 所有模型成本、重试、重新读取和修复回合
÷ 成功完成的任务
```
## 桌面版 V1
V1 是一个可用的只读桌面分析器和策略注册表。
- **仪表盘** — 令牌使用、估计成本、可避免的输入、任务信号和智能体分解。
- **医生** — 六条确定性的浪费规则，带有证据和补救措施。
- **策略中心** — 中立的注册表、医生驱动的推荐、风险标签、兼容性元数据、发布检查和用户选择。
- **会话** — 任务使用、事件时间线和链接的发现。
- **集成** — 检测 Claude Code、Codex、OpenClaw、Hermes、OpenCode 和 Cursor 安装。
- **显式导入** — 分析用户选择的 JSON、JSONL 或文本记录。
- **本地工作区** — 本地持久性、JSON 报告导出、数据删除和安全的演示工作区。
V1 不会自动执行第三方策略或修改提示、命令、工作区或智能体配置。
## 初始策略注册表
| 策略 | 角色 | 许可证 | V1 集成级别 |
|---|---|---|---|
| RTK | 命令、测试、Git 和日志输出过滤 | Apache-2.0 | 注册表、推荐、发布跟踪 |
| Headroom | 代理、包装器、库、MCP、缓存对齐、可逆检索 | Apache-2.0 | 注册表、推荐、发布跟踪 |
| Claw Compactor | 工作区和记录压缩，带有干运行基准测试 | MIT | 注册表、推荐、发布跟踪 |
每个项目都保留其自己的许可证、发布渠道、安全模型和运行时。注册表包含并不意味着所有权、认可或捆绑。
## 为什么这可以变得有防御性
一份压缩工具列表很容易复制。更难的资产是：
- 跨智能体的一个标准化的事件和任务模型；
- 将医生的发现与策略结果联系起来的证据；
- 跨策略、版本、智能体、模型和内容类型的兼容性矩阵；
- 分段更新、健康检查、回滚和固定的发布；
- 质量调整的测量，而不是原始压缩百分比；
- 隐私保护的路由数据，显示哪种策略适用于哪个任务。
阅读 [docs/STRATEGY_HUB.md](docs/STRATEGY_HUB.md)。
## 医生规则
| 规则 | 检测 |
|---|---|
| 重复文件读取 | 在一个任务中多次加载相同的路径 |
| 重复工具结果 | 相同的输出被多次注入 |
| 大型工具输出 | 日志或结果主导上下文 |
| 长指令 | 大型持久系统或指令块 |
| 提示前缀漂移 | 系统前缀在会话之间变化 |
| 可能的返工 | 工具被异常频繁调用 |
医生的推荐是短列表，而不是自动执行顺序。
## 开始使用
要求：Node.js 20+、npm 和 Tauri 2 平台原生桌面开发的先决条件。
```bash
npm install
npm run dev # 网页预览
npm run desktop:dev # 桌面开发
npm run desktop:build
```
原生捆绑包位于：
```text
src-tauri/target/release/bundle/
```
## 架构
```text
用户选择的记录
│
医生
│ 发现 + 证据
策略策略
│ 兼容的短列表
外部适配器
RTK · Headroom · 其他
│
验证
令牌 · 成本 · 返工 · 质量
```
当前的 V1 在外部执行之前停止。适配器执行通过观察、预览、应用恢复和自动路由安全级别进行。
## 隐私
- 不需要账户；
- 没有遥测数据；
- 记录分析在本地运行；
- 原生检测不读取智能体文件；
- 上游更新检查仅请求公共发布元数据；
- 导入的数据可以从设置中导出或删除。
## 当前限制
V1 尚未执行策略适配器、安装上游工具、自动提取记录、代理提供商、应用压缩、协调计费、运行质量重放或提供签名的公共安装程序。
## 产品方向
```text
V1 医生 + 策略注册表 + 发布可见性
V1.1 运行时检测、干运行适配器、SQLite 账本
V1.2 固定执行、健康检查、回滚、可逆策略
V2 自动策略路由、隔离、质量重放、验证的成功率
```
## OpenClaw 集成
```bash
openclaw skills install token-saver
```
原始技能仍然是一个可选的行为策略集成。
## 许可证
MIT — 见 [LICENSE](LICENSE)。
MCP 市场