Cache Bricks for DeepSeek Harness

DeepSeek Harness 的缓存命中率与模型请求活动可视化插件。 每次真实模型请求对应一块砖，查看缓存读数、请求详情，并定位到对应对话。

当前推荐：完整版 v0.1.5。 默认分支 main 提供完整功能。

下载完整版 · 安装 · 更新说明 · 反馈问题

Cache Bricks is a DeepSeek Harness web plugin for prompt-cache hit-rate visualization and model-request inspection. The default main branch ships the full edition: request details, comparison, conversation navigation, activity view and paged history. DSH 0.1.7-rc.2 is the current tested baseline; compatibility with other versions is unverified and not guaranteed.

使用说明图

用户提供的流程示意图。图中黄色 99.8% 等例子不是 0.1.5 的实际配色阈值：当前 ≥90% 绿、70%–90% 黄、<70% 红；灰色还包括 prompt 小于 1000 token 的请求。颜色表示命中率，不单独判断异常原因。详情、翻面、定位和对比属于完整版功能，Lite 不包含这些功能。

能做什么

一块砖对应一次模型请求 attempt，重试产生另一块砖。宿主采集不可用时，降级记录按 step 折叠，并标为估算。插件观察已有请求，不修改模型请求或提示词。

0.1.5 更新了什么

• 拖动棋盘时减少重复计算和重建，长会话回看更流畅。
• 优化历史分页和已看内容的缓存，减少重复读取、扫描与数据处理。
• 优化落砖及整列平移动画，减少动画期间的页面布局开销。
• 恢复请求出现、读数结算时的两次落砖反馈，修复虚线位置与棋盘不同步。
• 修复系统开启“减少动态效果”时，落砖动画消失的问题。

本次整合本地 0.1.4.a–f 的累计改进，缓存配色阈值保持不变。发布依据与兼容性

安装

目前公开测试使用基线为 DeepSeek Harness 0.1.7-rc.2 的 Web profile。其他版本未经本次兼容性测试，不保证兼容。

安装包不再将 DSH 客户端 peer 依赖锁定为 rc.2；开发构建仍使用该版本。放宽安装声明不代表其他版本已经验证。

dsh plugin --profile web add github:3289192-bot/dsh-cache-bricks#v0.1.5

也可下载完整版安装包，替换为本地文件路径：

dsh plugin --profile web add file:/path/to/dsh-cache-bricks-0.1.5.tgz

任务空闲时重启对应 DSH Web 服务并刷新页面。若同一 profile 曾安装旧包 dsh-cache-badge，先执行 dsh plugin --profile web remove dsh-cache-badge，避免出现两套棋盘。

卸载：

dsh plugin --profile web remove dsh-cache-bricks

如何读缓存颜色

命中率按 缓存读取 token / (未缓存输入 + 缓存读取 + 缓存写入) 计算。

未报告缓存字段时显示 n/a；读数保留一位小数并向下取整。颜色表达缓存读取比例，不直接断言缓存下降的原因。

数据与使用边界

• 插件读取本机 DSH 的请求观测记录和会话日志，完整版可能展示其中的请求、对话与工具内容。
• 插件采集内容保存在进程内存中，通过受保护的本机接口提供给界面；插件自身不将这些内容写入磁盘，没有第三方上传或分析端点。DSH 原有会话日志由宿主管理。
• 重启会清空内存中的采集内容；历史回看能恢复的字段以会话日志实际记录为准。
• 定位依赖宿主加载并渲染目标行；对话旁空白不足时棋盘会隐藏。

文档与开发

砖块与数据定义 · 历史加载设计 · 运行时接口 · 验证记录 · 历史开发记录

pnpm install --frozen-lockfile
pnpm run typecheck
pnpm run build
pnpm test

可选精简版

dsh plugin --profile web add github:3289192-bot/dsh-cache-bricks#v0.1.5-lite