MingoZhou/dsh-replay 预览 preview

MingoZhou/dsh-replay

Agent 会话的时光机。一个 DeepSeek Harness 插件,将 append-only 会话日志变为可交互回放:可播放的时间线 + 逐步 token 账单、安全审计视图、fork 血缘树、双会话对比 —— 全部内嵌于 Harness 的 Web UI 中。

Project Overview项目介绍

dsh-replay is a native plugin built exclusively for DeepSeek Harness (DSH), designed as a time machine for DSH agent sessions. It adds a full set of session analysis tools directly into DSH’s built-in web UI, including timeline replay, rule-based security audit, token cost estimation, fork tree visualization, and side-by-side session comparison. DSH stores all session logs natively in append-only format but does not include a built-in interactive viewer for these logs, and dsh-replay fills this gap by turning every common question about a completed session into a one-click answer.

After installation, users get two dedicated entry points to dsh-replay within DSH: a “Session Replay” button added to the bottom-left of the DSH sidebar, and a dedicated “Replay” tab inside every open conversation. Users can scrub through the timeline to view details of every turn, model message, and tool call, or check the overview dashboard to see cumulative token usage and ranked tool time consumption. This plugin is built for all developers who regularly run agent tasks via DSH, helping them trace execution, audit actions, and debug unexpected outcomes.

dsh-replay is released under the permissive MIT license, and prebuilt versions are published to npm for one-click installation via DSH’s official plugin command. No local build is required for the released version, but if you install from a cloned source repository, you must run npm install and npm run build to generate the required build artifacts before the plugin will work. The core session analysis logic is dependency-free and can be imported separately to process DSH session logs outside of DSH.

dsh-replay是专为DeepSeek Harness(DSH)开发的原生插件,定位是DSH agent会话的“时光机”,提供会话回放、安全审计、token成本统计、会话分支树、多会话对比等功能,全部功能集成在DSH原生网页界面内。它填补了DSH只保存会话日志但不提供可视化查看分析工具的空白,让用户可以一键解答关于会话消耗、操作内容的各类疑问。

安装完成后,用户可以在DSH侧边栏左下角找到“会话回放”入口,也可以在每个打开的对话中看到专属的回放标签页。用户可以拖拽时间线查看每一步的模型调用、工具执行细节,也可以在总览面板查看token消耗统计和成本估算。这个插件适合所有日常使用DSH运行agent任务的开发者,帮助他们追踪任务过程、排查运行问题。

该插件以MIT许可证开源,发布版已经预构建完成,不需要用户本地重新编译,可通过DSH官方的dsh plugin命令一键安装到指定配置文件。如果从源码克隆安装,需要先执行npm install和npm run build生成构建产物,否则插件无法启动。核心分析逻辑不依赖DSH,可单独导入用于处理DSH会话日志。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 13 stars - an early-stage project星标 13,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @mingozhou/dsh-replay

把 MingoZhou/dsh-replay 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

Jing Xiaoshen (鲸小深), the dsh-replay mascot

dsh-replay

Time machine for your agent sessions.
Replay · Audit · Cost · Fork tree · Compare — inside the DeepSeek Harness web UI.

ci license dsh-plugin PRs welcome

🎮 Live demo · 中文文档 · Install · FAQ

overview dashboard dsh‑replay operation demo

😫 Sound familiar?

You kick off an agent task, come back after dinner, and:

  • "It ran for 5 hours and burned 18M tokens — on WHAT?"
  • "Which tool call ate all that wall-clock time? Was it stuck?"
  • "Did it touch my .env? Did it rm -rf anything? Who approved that?"
  • "How much did this session actually cost me?"
  • "I forked the session yesterday — where exactly did the two histories diverge?"
  • "I want to show a teammate this hilarious failure — do they need to install the whole harness?"

DeepSeek Harness keeps a beautiful append-only log where everything that reached the model is reconstructible — but ships no viewer for it. dsh-replay is that viewer. One plugin, and every question above becomes one click.

✨ What you get

⏪ Timeline replay Scrub through every turn, step, message and tool call; play back at 1–16×; click any event for raw prompt/args/results/durations
📊 Overview dashboard Hero stats, cumulative token chart with crosshair, tool-time ranking — where the time and tokens actually went
💰 Cost estimate ≈ dollar cost from disjoint token accounting (cache-aware); editable pricing table, DeepSeek / Claude / OpenAI / Gemini defaults
🛡️ Security audit Rules-based scan: dangerous shell (rm -rf, sudo, curl-pipe…), sensitive paths (.env, ~/.ssh…), sandbox/permission changes, denied approvals — ranked, clickable, extensible
🌿 Fork tree The whole session lineage as a clickable tree, fork boundaries labeled, subagents marked
⚖️ Compare Any two sessions side by side: stats, tool mix, token deltas, exact divergence seq for forks
📤 One-click HTML export Bake a session into a single offline .html — attach it to a bug report or send to a teammate; they get the full interactive replay with zero installs
🔍 Filter & search Free-text search across messages/args/results + kind filters, right in the playback bar
🌏 EN / 中文 Whole UI switches language (findings and meta labels included); auto-detected, one-click toggle

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-ocr-plugin 下一个 Next dsh-lan-access →