# dsh-session-showcase

> Local, zero-token conversion of DeepSeek Harness sessions into redacted, README-ready animated WebP/GIF demos and posters, packaged as a standalone CLI and DSH tool plugin.

This is an independent community project, not an official DeepSeek product. It never executes session tools, uploads data, or calls a model. Redaction is enabled by default but generated artifacts still require human review before publication.

## Start here

- [Bilingual README](README.md): product overview, DSH plugin install, CLI quick start, privacy, and examples
- [CLI reference](docs/cli.md): flags, stdout/stderr contract, outputs, and exit codes
- [Security model](docs/security.md): guarantees, limits, and responsible disclosure

## Install

```bash
dsh plugin --profile <profile> add github:STFQ/dsh-showcase
```

The plugin registers `dsh_showcase`. It reads a local DSH session export through `ctx.fs`, writes generated artifacts to the local workspace, and enables automatic redaction by default.

For the standalone CLI from a source checkout:

```bash
npm install
npm run build
node dist/cli.js examples/session.jsonl --output ./showcase --format both
```

The CLI is local-only: it does not upload sessions, execute session tools, or call a model. The npm package name is `dsh-session-showcase`; its standalone binary remains `dsh-showcase`.

## Technical reference

- [DSH session compatibility](docs/session-format.md): verified rc.8 JSONL, Zstandard, packed-row, and export-ZIP contracts
- [Result JSON Schema](schemas/result.schema.json): `--json` machine-output contract
- [Manifest JSON Schema](schemas/manifest.schema.json): generated showcase manifest contract
- [Plugin result JSON Schema](schemas/plugin-result.schema.json): canonical `dsh_showcase` output contract
- [Design sources](docs/design.md): pinned upstream contracts and mature CLI/recording references
- [Plugin contract](docs/plugin.md): DSH tool name, arguments, filesystem boundaries, and installation modes

## Examples and contribution

- [Synthetic session fixture](examples/session.jsonl): safe official-shaped input
- [Contributor instructions](CONTRIBUTING.md): setup and pull-request expectations
- [Agent contributor guide](AGENTS.md): invariants, repository map, and documentation synchronization