Pupmclaw Lossless

Name: Pupmclaw Lossless
Rating: 3.5 (1 reviews)
Author: pupmme

By pupmme 👁 6 views ▲ 0 votes

OpenClaw LCM plugin: martian upstream + enhanced CJK token estimation + stability fixes

Homepage GitHub

Configuration Example

{
  "plugins": {
    "entries": {
      "lossless-claw": {
        "enabled": true
      }
    }
  }
}

README

# pupmclaw-lossless

**OpenClaw LCM（长期上下文管理）插件** — 基于 [martian-engineering/lossless-claw](https://github.com/martian-engineering/lossless-claw) 最新上游，合并 [win4r/lossless-claw-enhanced](https://github.com/win4r/lossless-claw-enhanced) 的 CJK 优化。

---

## 与上游的区别

本仓库是 **martian 最新版 + enhanced CJK 优化** 的合并版本：

| 特性 | martian | enhanced（已合并）|
|---|---|---|
| CJK Token 估算 | `Math.ceil(len/4)` ❌ | `estimate-tokens.ts` ✅（1.5 token/字）|
| Emoji 估算 | 低估 4x | ✅ 2 token/emoji |
| Auth 误报中断压缩 | ❌ | ✅ 修复 |
| Session 轮换后压缩失效 | ❌ | ✅ 修复 |
| 空消息堆积死循环 | ❌ | ✅ 修复 |
| CJK FTS trigram 搜索 | ❌ | ✅ OR semantics |
| 已有数据库 CJK recount | ❌ | ✅ 自动迁移 |
| CLI doctor 命令 | ✅ | ❌ |
| SQLite transaction mutex | ✅ | ❌ |
| FTS5 recency/relevance 排序 | ✅ | ❌ |
| prune 数据保留清理 | ✅ | ❌ |

---

## 默认配置调优（相比 martian）

| 参数 | martian | 本仓库 | 效果 |
|---|---|---|---|
| `freshTailCount` | 64 | **32** | 压缩更早触发 |
| `leafTargetTokens` | 2400 | **1200** | 摘要更精简 |
| `incrementalMaxDepth` | 1 | **0** | 减少增量压缩深度 |

---

## 安装

```bash
openclaw extensions add pupmme/pupmclaw-lossless
```

或手动：

```bash
cd ~/.openclaw/extensions
git clone https://github.com/pupmme/pupmclaw-lossless.git lossless-claw
```

## 配置

```json
{
  "plugins": {
    "entries": {
      "lossless-claw": {
        "enabled": true
      }
    }
  }
}
```

完整配置项参见 [openclaw.plugin.json](openclaw.plugin.json)。

tools