Upload dsh-plugin/compaction-agentframe/README.md with huggingface_hub

dsh-plugin/compaction-agentframe/README.md

@@ -0,0 +1,51 @@
+# dsh-compaction-agentframe
+
+AgentFrame 压缩后端插件 —— 把 DeepSeek Harness 的默认 LLM 摘要压缩替换为
+**语义 + 物理双轨压缩**（35.6x KV 压缩思路）。
+
+## 为什么替换默认压缩
+
+默认 `compaction-basic` 用 LLM 摘要（有损总结旧对话），每次压缩都要一次
+LLM 调用，且摘要可能丢细节。
+
+AgentFrame 的思路：
+- **语义轨**：MemoryDirector 判断哪些 token 值得保留（去闲聊、留关键）
+- **物理轨**：吸收式 MLA + INT4 量化（270KB→7.6KB/token，28.4x）
+- **效果**：保留关键信息 + 大幅省 token + 不额外调用 LLM
+
+## 使用
+
+在 profile 的 `cordis.patch.yml` 中把 `compaction-basic` 替换为：
+
+```yaml
+- id: compaction-agentframe
+  name: '@deepseek-ai/dsh-compaction-agentframe'
+  config:
+    semantic: true
+    retainRatio: 0.2
+    physical: true
+```
+
+## 配置
+
+| 字段 | 默认 | 说明 |
+|------|------|------|
+| `semantic` | true | 语义压缩（保留高信息行） |
+| `retainRatio` | 0.2 | 压缩后保留比例 |
+| `physical` | true | 物理压缩记账（bytes/token） |
+| `bytesPerToken` | 7776 | INT4 压缩后每 token 字节 |
+| `auto` | true | 自动压缩 |
+
+## 实现
+
+继承 `CompactionEngine`（compaction seam），实现三个抽象方法：
+- `compactIfNeeded` — 自动压力触发
+- `compactNow` — 手动 /compact 命令
+- `compactRegion` — 指定范围压缩
+
+保持 dsh 的 surface/事件/持久化契约（compaction/start → replace → compaction/end），
+只替换"如何压缩"。
+
+## License
+
+GPL-3.0 © Cloud LTE Studio / AgentFrame