dsh-shelf
DeepSeek Harness 会话生命周期管理：为您的 dsh 会话库提供导出、归档、恢复、移至回收站、搜索和统计功能。零依赖，默认只读。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zoahdev/dsh-shelf#fc96277ae39654949ea8c2cb6b7c7d0c50004695Shelf 以 dsh-shelf 发布，当前版本为 0.7.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →Session lifecycle for DeepSeek Harness: export, archive, restore, trash, search, and stats for your dsh session library. Zero dependencies, read-only by default.
Every dsh user accumulates hundreds of sessions and has no way to manage them (#1990, #1991). dsh-shelf is the missing shelf.
npx dsh-shelf list # every session with id + path
npx dsh-shelf stats # counts, compressed/plain, bytes
npx dsh-shelf search "parser bug" # header + body search (plain sessions)
npx dsh-shelf export <id> --format md # Markdown transcript to stdout
npx dsh-shelf export --all --format jsonl --out all-sessions.jsonl
npx dsh-shelf archive <id> # move to sessions-archive (never deletes)
npx dsh-shelf restore <id> # move it back
npx dsh-shelf trash <id> # move to sessions-trash (recoverable)
npx dsh-shelf restore-trash <id>
npx dsh-shelf report # weekly session digest (Markdown)
npx dsh-shelf report 30 --format json # 30-day digest as JSON
npx dsh-shelf report 14 --format html --out shelf-report.html # offline dashboard
npx dsh-shelf verify # session health check (orphan tool calls, unfinished, empty)
npx dsh-shelf rescue <id> # export an un-resumable session's content
npx dsh-shelf archive-old 30 # dry run: sessions older than 30 days
npx dsh-shelf archive-old 30 --yes # move them to sessions-archive
npx dsh-shelf tree # session fork lineage
npx dsh-shelf tree <id> # message tree (pi /tree)
npx dsh-shelf web # local web panel at http://127.0.0.1:4174
DSH plugin mode (panel bound to the active profile):
dsh plugin --profile web add github:zoahdev/dsh-shelf
# panel at http://127.0.0.1:4174 (committed lib/, no build at install)
Roots: --root overrides; default is $DSH_SESSIONS or ~/.dsh/sessions. Archive/trash roots default to sessions-archive / sessions-trash next to the root.
/tree)Slim clone of pi /tree (double-Esc). DSH stores branches between sessions (parentSession + seedLength), so the tree is reconstructed from fork lineage rather than an in-file entry graph. Labels, fold, and branch summarization are not copied.
Filter (default no-tool; cycle o in the panel, or --filter / /nav user): no-tool (user + assistant text), user, all (includes tool calls).
| Surface | How |
|---|---|
| CLI | dsh-shelf tree (session lineage) / dsh-shelf tree <id> (messages) |
| Web panel | Double-Esc or the Tree button. ↑/↓ move, Enter preview / open, Esc close |
| Host plugin | /nav on dsh --profile pi-tui only. dsh web / --profile web is not supported (its question form is not a tree UI). |
Selecting a user message forks before that turn (resubmit). Selecting an assistant message forks through its completed turn (continue from there). The handler prints a /resume hint; it does not switch the TUI.
jsonl path preserved).node --test tests/*.test.mjs
node scripts/shelf.mjs list --root <fixtures>
report) + auto-archive (archive-old, dry-run by default)dsh-shelf web) - list/search/export/archive/trash + daily chart from the browserreport --format html) - shareable per-day bars + largest sessionsdsh plugin add github:zoahdev/dsh-shelf opens the panel)verify) + rescue export for un-resumable sessions (#1959/#2034 family)tree, double-Esc in the web panel, /nav on the host) — slim clone of pi /treeMIT