毒蛇会话复盘superrabbit123/dsh-viper-recap

dsh-viper-recap 🐍

毒蛇复盘 — 根据真实事件日志，吐槽（或夸夸）你的 DeepSeek Harness 会话。

viper_recap 是一个面向模型的工具：把当前会话日志折叠成轮数、步数、工具调用、失败次数与输出 token，再渲染成确定性的中文复盘。同时注册一个 viperRecap 投影把同样数字推给客户端，composer 里的 🐍 按钮会弹出浮动复盘卡。不额外调用模型、无需 API key。

Install · 安装

从 GitHub 安装（git 安装会运行 prepare 构建，需按提示在 profile 的 pnpm-workspace.yaml 里 allowBuild）：

dsh plugin --profile demo add github:superrabbit123/dsh-viper-recap

从本地检出安装：

dsh plugin --profile demo add ./dsh-viper-recap

从 npm 或 tarball 安装：

dsh plugin --profile demo add dsh-viper-recap                # npm
dsh plugin --profile demo add ./dsh-viper-recap-0.1.0.tgz    # tarball

先验证层，再启动：

dsh --profile demo --dump-config
dsh --profile demo web

Usage · 使用

工具对模型可见，直接说即可：

- 用 viper_recap 毒舌复盘一下这一局。 — 吐槽这一局
- 用 viper_recap 夸夸我这一局。 — 夸夸这一局

或显式传 tone 参数：

| tone | 效果 |
|---|---|
| roast | 毒舌吐槽（默认）/ 毒舌复盘（默认） |
| toast | 夸夸鼓励 / 温和复盘 |

复盘文案由会话里已有的数字本地计算得出，不会外发任何内容。

🐍 按钮

composer 右侧操作区有一个 🐍 按钮；点击弹出浮动卡片，读取主机计算的 viperRecap 投影，可切换毒舌/夸夸、复制文案、关闭。

它读什么

全部从会话事件日志折叠、本地计算：

- turns 轮数 — turn/end 事件
- steps 步数 — step/end 事件
- toolCalls 工具调用 — tool/call 事件
- toolFailures 失败 — 携带 error 的 tool/result 事件
- outputTokens 输出 token — assistant/message.usage.outputTokens
- topTools 最爱工具 — 调用次数最多的工具名

结构

src/
├── index.ts       # 主机插件：viper_recap 工具 + viperRecap 投影
├── types.ts       # RecapStats / RecapState + viperRecap 投影键
├── stats.ts       # 纯不可变折叠（工具与投影共用）
├── recap.ts       # 纯渲染（毒舌/夸夸文案）
├── projection.ts  # viperRecap 投影单元
└── client/        # 浏览器端：🐍 按钮 + 浮动卡片

构建

pnpm run build（以及 git 安装时运行的 prepare 脚本）会用 tsdown 构建两端：
- 主机 lib/index.mjs（+ lib/index.d.mts）——工具与投影
- 客户端 lib/client.js —— window.__ModuleLoader__.load 闭包（由 tsdown.client.ts 构建，是 harness 客户端打包的自包含复刻）

无需 harness 检出：构建只需要 tsdown + lightningcss，两者都是普通的 npm 依赖。 · pnpm run build（以及 git 安装时运行的 prepare）用 tsdown 同时构建两半：主机 lib/index.mjs、客户端 lib/client.js。构建是自包含的（tsdown.client.ts 复刻了 harness 的客户端打包），只需 tsdown + lightningcss 两个普通 npm 依赖，无需 harness 检出。

已知限制

- 复盘文案仅中文。
- 输出由会话数字确定生成，不会调用模型写出更"新鲜"的吐槽。
- 暂未实现"存图"；卡片当前提供切换、复制、关闭。

许可证

MIT