[PR #399] [CLOSED] docs: add dsh-session-export integration guide #402

Closed
opened 2026-10-26 09:48:52 +00:00 by bsakaguchi · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/deepseek-ai/awesome-deepseek-agent/pull/399
Author: @kittimzhe
Created: 8/23/2026
Status: ❌ Closed

Base: main ← Head: docs/add-dsh-session-export-guide


📝 Commits (4)

  • 5bbdf0c docs: add dsh-session-export integration guide
  • cce2ef6 Add source repo link to guide
  • 6a7e5cb Add source repo link to guide
  • 2e6e8cd docs: document /archive (v0.2.0) in dsh-session-export guide

📊 Changes

4 files changed (+100 additions, -0 deletions)

View changed files

📝 README.md (+1 -0)
📝 README.zh-CN.md (+1 -0)
➕ docs/dsh_session_export.md (+49 -0)
➕ docs/dsh_session_export.zh-CN.md (+49 -0)

📄 Description

What

Adds an integration guide for dsh-session-export — an open-source out-of-tree plugin for DeepSeek Harness. It ships two commands: /transcript exports a session as a human-readable Markdown/JSON transcript to a host path, and /archive (v0.2.0) writes raw session logs as per-session ZIP backups.

Why

DeepSeek Harness's CONTRIBUTING encourages ecosystem growth via out-of-tree plugins. The shipped @deepseek-ai/dsh-session-log-export is browser-download-only and JSONL-only (its README lists these under "Known Limitations"); this plugin writes to a host path and works with any ctx.sessionQuery backend. /archive specifically covers the SQLite gap: SQLite persistence declares supportsRawArtifacts: false, so the official /export cannot read it, while /archive reads through sessionQuery.readSession.

Verification

/transcript (v0.1.0): every command in the guide was executed and verified locally against real sessions — npm install → auto-activation via dsh.bundle → /transcript in the web UI with --json/--full/--out/--id variants.

/archive (v0.2.0): parser + execution path covered by 46 unit tests, and ZIP output validated with a real unzip -t (CRC32 + deflate + UTF-8 round-trip). The SQLite claim is pinned at the source — session-persistence-sqlite/src/index.ts:55 (supportsRawArtifacts = false) vs the official exporter's readRaw at session-log-export/src/archive.ts:243.

Plugin source: https://github.com/kittimzhe/dsh-session-export (MIT).

Checklist

  • Bilingual guide in a single PR
  • README table entries in both READMEs, alphabetical order
  • One tool per PR
  • Only verified configuration documented

Disclosure: I'm the plugin's author; it's MIT-licensed. /transcript was verified live in the web UI; /archive is covered by unit tests + real ZIP validation (end-to-end UI run pending a fresh API key).


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/deepseek-ai/awesome-deepseek-agent/pull/399 **Author:** [@kittimzhe](https://github.com/kittimzhe) **Created:** 8/23/2026 **Status:** ❌ Closed **Base:** `main` ← **Head:** `docs/add-dsh-session-export-guide` --- ### 📝 Commits (4) - [`5bbdf0c`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/5bbdf0c20f8ce24b2b5c11b2490398eaf9f8ae39) docs: add dsh-session-export integration guide - [`cce2ef6`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/cce2ef6ecfee7f85ea38ecbfdbc54ab84ade2d41) Add source repo link to guide - [`6a7e5cb`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/6a7e5cb2ad550056a79ae3e7fa80bb9e6357b6be) Add source repo link to guide - [`2e6e8cd`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/2e6e8cdf6306cb844b12149fb84d080f80e8f385) docs: document /archive (v0.2.0) in dsh-session-export guide ### 📊 Changes **4 files changed** (+100 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+1 -0) 📝 `README.zh-CN.md` (+1 -0) ➕ `docs/dsh_session_export.md` (+49 -0) ➕ `docs/dsh_session_export.zh-CN.md` (+49 -0) </details> ### 📄 Description ## What Adds an integration guide for **dsh-session-export** — an open-source out-of-tree plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). It ships two commands: `/transcript` exports a session as a human-readable Markdown/JSON transcript to a host path, and `/archive` (v0.2.0) writes raw session logs as per-session ZIP backups. ## Why DeepSeek Harness's CONTRIBUTING encourages ecosystem growth via out-of-tree plugins. The shipped `@deepseek-ai/dsh-session-log-export` is browser-download-only and JSONL-only (its README lists these under "Known Limitations"); this plugin writes to a host path and works with any `ctx.sessionQuery` backend. `/archive` specifically covers the SQLite gap: SQLite persistence declares `supportsRawArtifacts: false`, so the official `/export` cannot read it, while `/archive` reads through `sessionQuery.readSession`. ## Verification `/transcript` (v0.1.0): every command in the guide was executed and verified locally against real sessions — npm install → auto-activation via `dsh.bundle` → `/transcript` in the web UI with `--json`/`--full`/`--out`/`--id` variants. `/archive` (v0.2.0): parser + execution path covered by 46 unit tests, and ZIP output validated with a real `unzip -t` (CRC32 + deflate + UTF-8 round-trip). The SQLite claim is pinned at the source — `session-persistence-sqlite/src/index.ts:55` (`supportsRawArtifacts = false`) vs the official exporter's `readRaw` at `session-log-export/src/archive.ts:243`. Plugin source: https://github.com/kittimzhe/dsh-session-export (MIT). ## Checklist - [x] Bilingual guide in a single PR - [x] README table entries in both READMEs, alphabetical order - [x] One tool per PR - [x] Only verified configuration documented *Disclosure: I'm the plugin's author; it's MIT-licensed. `/transcript` was verified live in the web UI; `/archive` is covered by unit tests + real ZIP validation (end-to-end UI run pending a fresh API key).* --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
bsakaguchi 2026-10-26 09:48:52 +00:00
Sign in to join this conversation.
No labels
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
deepseek-ai/awesome-deepseek-agent#402
No description provided.