DSH | dsh-showcase | Turn session exports into redacted README demos

[STFQ]

Unofficial community project, independently developed and maintained. Not reviewed or endorsed by DeepSeek.

dsh-showcase

Project: https://github.com/STFQ/dsh-showcase
Release: https://github.com/STFQ/dsh-showcase/releases/tag/v0.1.1

dsh-showcase turns a DeepSeek Harness session export into a short, redacted animation for a GitHub README, release, issue, or plugin launch. It renders semantic events rather than recording the screen and makes zero model/API calls.

How it integrates with DSH

This is a standalone companion CLI, not a DSH bundle. It consumes DSH's official /export Session Log ZIP, raw session.jsonl, or the default concatenated-frame session.jsonl.zstd. The adapter is documented and pinned against DSH dsh-v0.1.0-rc.8 / commit 141eb6f.

# In DSH Web, run /export, then:
npx --yes --package=https://github.com/STFQ/dsh-showcase/releases/download/v0.1.1/dsh-showcase-0.1.1.tgz dsh-showcase dsh-session.zip

You can also try the included synthetic fixture without a DSH account:

npx --yes --package=https://github.com/STFQ/dsh-showcase/releases/download/v0.1.1/dsh-showcase-0.1.1.tgz dsh-showcase examples/session.jsonl --output showcase --format both

Outputs include hero.webp or hero.gif, poster.png, social-preview.png, a README snippet, and a machine-readable manifest.

Privacy and limits

• Local-only runtime: no uploads, telemetry, model calls, or execution of session tools.
• Common keys, tokens, credential assignments, emails, credentialed URLs, and home paths are redacted by default.
• Reasoning blocks and request headers are excluded from selected scenes.
• Redaction is not a guarantee; artifacts still need review before publication.
• v0.1 renders the root session and reports, but does not yet render, subagent logs.

The README is bilingual (English / 简体中文), and the repository includes agent-friendly CLI docs, llms.txt, AGENTS.md, JSON Schemas, synthetic fixtures, and CI across Windows, macOS, and Linux.

I'd especially value feedback on which DSH event shapes or showcase scenes should be supported next.

---

中文简介

dsh-showcase 是一个独立的 DSH 配套命令行工具：读取官方 /export 会话 ZIP 或 JSONL/Zstandard 日志，在本地自动挑选提示词、工具调用、代码差异和最终结果，默认脱敏后生成 README 动图、封面和机器可读清单。它不上传数据、不执行会话工具，也不会调用模型或消耗 Token。