pi-deepseek-cache

DeepSeek prefix-cache extension for pi — hit-rate telemetry, prefix guard, and cache-friendly compaction.

Packages

Package details

extension

Install pi-deepseek-cache from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-deepseek-cache
Package
pi-deepseek-cache
Version
0.1.0
Published
May 31, 2026
Downloads
not available
Author
ruanbw
License
MIT
Types
extension
Size
30.6 KB
Dependencies
3 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-deepseek-cache

English | 中文

DeepSeek 前缀缓存扩展，为 pi 提供命中率遥测、前缀守卫、缓存友好的 compaction。

功能

  • P1 命中率遥测 — 实时显示缓存命中率，支持持久化存储
  • P2 前缀守卫 — 剥离 volatile-scratch 消息，保护缓存前缀稳定性
  • P3 缓存友好的 compaction — 用 deepseek-v4-flash 做确定性摘要（temperature: 0）
  • Overlay 弹窗 — /cache-stats 和 /cache-graph 在弹窗中展示（ESC 关闭）

安装

npm（推荐）

pi install npm:pi-deepseek-cache

Git

pi install git:github.com/ruanbw/pi-deepseek-cache

手动

mkdir -p ~/.pi/agent/extensions/deepseek-cache
cp index.ts ~/.pi/agent/extensions/deepseek-cache/

使用

export DEEPSEEK_API_KEY=sk-...
pi --model deepseek/deepseek-chat

在会话中输入：

/cache-stats   → 弹窗显示命中率、read/miss/write、轮次
/cache-graph   → 弹窗显示 ASCII 趋势图

工作原理

层 说明
P1 在 message_end 事件中累计 cacheRead / input / cacheWrite / turns，持久化到 ~/.pi/agent/extensions/deepseek-cache/stats.json
P2 在 context 钩子中过滤 customType="volatile-scratch" 的消息，防止易变内容破坏字节前缀
P3 在 session_before_compact 时用 deepseek-v4-flash（temperature: 0）做摘要，按 SHA-256 hash 缓存，保证字节稳定

测试

npm test              # 28 个测试（18 单元 + 10 集成）

许可证

MIT