前言¶
做 DSH 插件、工具或工作流演示時，常常需要把一次會話裏的關鍵操作整理成能放進 GitHub README 的短演示。傳統錄屏通常錄製的是屏幕像素，容易把密鑰、路徑、內部地址等敏感內容帶進公開素材；而 DSH 會話導出本身更接近結構化日誌，適合按內容生成演示。
下面介紹 dsh-session-showcase。它面向 DSH 會話導出，提供本地渲染路徑：讀入官方導出 ZIP、原始 session.jsonl 或 Zstandard 會話日誌，輸出 WebP/GIF 動圖、海報、社交預覽圖、README 片段和機器可讀 manifest，並默認啓用敏感信息替換。
這是什麼¶
dsh-session-showcase 是一個獨立社區項目，資料中顯示的 owner 是 STFQ，許可證爲 MIT。它用於把 DeepSeek Harness（DSH）會話變成 README 可用的紅acted 動圖演示，可以作爲本地 CLI 使用，也可以作爲 DSH 原生工具插件使用。
已覈實的核心定位包括：
- 讀取官方 DSH session export ZIP、原始
session.jsonl，或 Zstandard session log。 - 生成 animated WebP/GIF、poster、social preview、README snippet，以及 machine-readable manifest。
- 在本地運行，且 zero AI/model calls。
- 可作爲 standalone CLI，也可作爲 DSH tool plugin 運行。
- 作爲 DSH 插件時，會註冊
dsh_showcase工具。 - 敏感信息替換默認開啓。
- 要求 Node.js 22.19 或更高版本。
- 資料說明不需要 FFmpeg，也不需要 API key。
- 項目是獨立社區項目，不與 DeepSeek 存在從屬或背書關係。
另外，資料中出現 dsh-session-showcase 與 dsh-showcase 兩種名稱線索。本文以下面的安裝命令、CLI 命令和已覈實功能爲準；安裝前建議覈對倉庫、包名和命令的一致性。
核心功能¶
讀取 DSH 會話日誌¶
它支持三類輸入：
official DSH session export ZIP
raw session.jsonl
Zstandard session log
也就是說，如果你手裏已經是 DSH 官方導出的會話 ZIP，或者只是保存下來的 session.jsonl、壓縮後的 Zstandard 日誌，都可以作爲輸入。
生成 README 可用素材¶
經過上面的輸入後，它會生成一組演示素材：
- animated WebP/GIF
- poster
- social preview
- README snippet
- machine-readable manifest
這類輸出更適合放進 GitHub README、發佈說明或項目文檔裏，而不是隻留一段原始日誌。
默認進行敏感信息替換¶
資料說明 redaction 默認開啓，覆蓋以下常見敏感內容：
- common API keys
- GitHub tokens
- JWTs
- bearer tokens
- secret assignments
- email addresses
- credentialed URLs
- home-directory paths
同時，資料也明確說明 redaction 是 defense in depth，不是 guarantee。生成結果在公開前仍應人工檢查。
此外，reasoning blocks 和 request headers 不會被選爲 showcase scenes。
本地運行，不調用模型¶
它可以在本地運行，並且 zero AI/model calls。資料還說明：
- 不需要 FFmpeg
- 不需要 API key
對於只想把已有 DSH 會話整理成公開演示素材的場景，這屬於比較直接的本地工具路徑。
安裝與啓用¶
環境要求¶
要求 Node.js 22.19 或更高版本：
node -v
如果你準備在 DSH 中安裝插件，使用已覈實的插件安裝命令即可。這裏的 <profile> 替換成你實際使用的 DSH profile：
dsh plugin --profile <profile> add github:STFQ/dsh-showcase
安裝後，插件會在 DSH 中註冊 dsh_showcase 工具。
從源碼構建獨立 CLI¶
如果你先想本地試跑，可以克隆倉庫並構建：
git clone https://github.com/STFQ/dsh-showcase.git
cd dsh-showcase
npm install
npm run build
然後用示例日誌跑一次完整輸出：
node dist/cli.js examples/session.jsonl --output ./showcase --format both
這條命令會讀取 examples/session.jsonl，把 WebP 和 GIF 兩種格式的輸出寫到 ./showcase 目錄。
資料中還提到：npm install --global dsh-session-showcase 在下次 npm 發佈後可用。由於這裏不是當前已確認的可用發佈事實，建議以倉庫說明或 npm 實際可安裝狀態爲準。
典型用法¶
渲染 DSH 會話導出 ZIP¶
如果你有 DSH 會話導出 ZIP，可以執行：
dsh-showcase dsh-session-<id>.zip --output ./showcase
這裏的 dsh-session-<id>.zip 替換成你實際的導出文件名。
同時生成 WebP 和 GIF¶
如果希望同時輸出 WebP 和 GIF，可以指定 --format both。示例：
dsh-showcase session.jsonl --format both --theme midnight
這條命令會讀取 session.jsonl，並輸出兩種動圖格式。資料中的可選主題包含 deepsea、midnight、paper。
先檢查場景選擇和替換結果¶
如果不想立刻寫文件，可以先 dry-run：
dsh-showcase session.jsonl --dry-run --json
這條命令會解析並檢查，不直接生成最終文件，適合在發佈前確認 scene selection 和 redaction 結果。
使用更嚴格的敏感信息策略¶
默認是替換後繼續。如果你希望在檢測到敏感內容時直接失敗，可以使用 strict 模式：
dsh-showcase session.jsonl --redact strict
適合在自動化流程中使用，避免敏感素材被繼續生成到輸出目錄。
適用場景與注意¶
適合的場景¶
適合這些情況：
- 想把 DSH 會話整理成 GitHub README 裏的短演示。
- 已經拿到官方 DSH session export ZIP、
session.jsonl或 Zstandard 日誌。 - 需要默認進行敏感信息替換，並且希望輸出是本地文件。
- 需要在 DSH 內以工具形式調用，或單獨作爲 CLI 使用。
使用前注意¶
- 插件會在你運行 DSH 的本地環境中執行，使用當前
dsh進程可用的權限。安裝前建議檢查源碼、依賴和 MIT 許可證範圍。 - redaction 默認開啓，但它不是 guarantee。公開發布前仍要檢查生成的動圖、海報、README snippet 和 manifest。
- reasoning blocks 和 request headers 不會被選爲 showcase scenes，但這不等同於所有敏感信息都會被移除。
- 需要 Node.js 22.19 或更高版本。
- 資料說明不需要 FFmpeg，也不需要 API key。
- 該項目是獨立社區項目，不與 DeepSeek 存在從屬或背書關係。
- DSH 插件目錄屬於社區生態，不等於 DeepSeek 官方應用商店。
結尾¶
dsh-session-showcase 的價值比較具體：它把 DSH 會話導出或會話日誌整理成可直接放進 README 的動圖、海報、社交預覽和 README 片段，同時在本地運行、不調用模型，並默認處理常見敏感內容。
對於需要公開 DSH 會話演示，又不想把原始錄屏和敏感信息直接發佈出去的開發者，這是一個值得評估的本地工具路徑。
已覈實資料未給出可確認的目錄頁 URL；GitHub 倉庫地址爲：
https://github.com/STFQ/dsh-showcase
