DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-notebook-capture

P

dsh-notebook-capture

Manifest valid

Notebook reproducibility capture for DeepSeek Harness: reads .ipynb JSON without executing it, reports kernel/language, code vs markdown cells, execution order (out-of-order and never-run cells), impo

hasBundlePatch

dsh-notebook-capture

A notebook that runs on your machine is not yet reproducible. Capture what the saved file actually says.

Reads .ipynb JSON without executing it: kernel, execution order, imports, runtime installs, seeds, absolute paths, output state, and hashes of the notebook plus its environment declarations — as REP evidence and a Markdown card.

License Node

English · 简体中文


What it does

  • nb_analyze — parses the notebook and reports: kernel/language/version, code vs markdown cells, execution counts (out-of-order and never run), imports (Python and R), runtime installs (!pip install, %conda install, install.packages), seed literals, absolute paths, and whether outputs were saved.
  • nb_capture — hashes the notebook and every environment declaration next to it (requirements.txt, environment.yml, pyproject.toml, renv.lock, Pipfile, Dockerfile, …), stores the notebook as immutable REP evidence, and writes a record whose artifacts are the notebook and environment hashes.
  • nb_card — Markdown card + SARIF 2.1.0.

What it does not do

  • No execution. Nothing is run; the card is about the saved file.
  • No guarantee of reproducibility. A clean card means the file is self-describing, not that the results can be regenerated.
  • No dependency resolution. It records environment files; it does not check they are complete or installable.
  • No hidden-state detection. Kernel memory that a cell relied on but never recorded is invisible here.
  • No HTML/.py conversion. .ipynb only; use jupyter nbconvert first if needed.

Structural checks

CodeSeverityMeaning
out_of_orderwarningexecution counts are not increasing
unexecuted_cellswarningcode cells without an execution count
runtime_installwarningpackages installed inside the notebook
no_seedwarningcode cells but no seed literal
absolute_pathswarning/home/…, /Users/…, C:\… literals
outputs_missinginfono cell carries saved output
no_kernelwarningmetadata has no kernel/language
no_importsinfono import statement found
missing env declarationwarningreported in the capture's warnings

Tools

nb_analyze

{ text? | path? } → { ok, analysis }.

nb_capture

{ path, persist? } → { ok, capture, evidenceId?, recordPath? }.

nb_card

{ capture } → { ok, markdown, sarif }.

Error codes

INVALID_INPUT · NOT_FOUND · PATH_ESCAPE · NOT_A_FILE · TOO_LARGE · NOT_NOTEBOOK · INVALID_JSON · STORE_ERROR

Compatibility & install

DeepSeek Harnessdsh-v0.2.1-rc.5 (verified 2026-11-08); peer >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0
Node^22.19.0 || >=24.9.0 (tested 24.22.1), ESM only
Peers@perrylink/dsh-research-core ^0.1.0, @deepseek-ai/cordis ^4.0.5-alpha.1, @deepseek-ai/dsh-tools, @deepseek-ai/schemastery ^3.18.5-alpha.1
Runtime dependencieszero
dsh plugin --profile <name> add @perrylink/dsh-research-core dsh-notebook-capture
dsh --profile <name> --dump-config | grep dsh-notebook-capture

Configuration

KeyDefaultMeaning
enabledtruefalse mounts nothing
root.notebook-capturestore/record root
workspaceRootprocess.cwd()notebook paths must resolve inside it
maxBytes10485760notebook file or text cap (fails, never truncates)
persisttruestore notebook as REP evidence + record

Security boundaries

  • Read-only on the notebook; writes only under root.
  • realpath containment; symlink escapes rejected.
  • Size cap fails loudly; malformed JSON is refused with a stable code.
  • Notebook JSON is treated as data; cell source is never executed.

Evaluation

16 tests: source-array joining, invalid JSON/non-notebook/malformed-cell rejection, cell counting, out-of-order detection, never-run cells, imports/installs/seeds/absolute paths (one seed finding per call), kernel metadata, capture with environment hash + valid REP record (notebook + env artifacts), analyze from text and file, file/text size caps, traversal/symlink/invalid/oversize rejection, tool schemas, analyze→capture→card end-to-end, malformed-capture rejection, failure branches, plugin contract, package contract. The synthetic notebook fixture lives in test/fixtures.ts, so importing it does not re-register another suite's tests.

No benchmark is claimed: these are structural checks on a file format, pinned by fixtures; there is no labelled corpus of reproducibility outcomes.

Known limitations (v0.1)

  • Import/seed/path detection is regex-based over cell source; unusual code shapes can be missed.
  • Environment files are only looked for next to the notebook (not the repo root).
  • Execution order uses saved execution_count; a notebook cleared of counts looks like "never run".
  • The card cannot know whether a figure came from the saved code at all.

License

Apache-2.0. No third-party runtime code.

Comments

Loading…

Similar plugins

@beihaizb/dsh-notebook

by beihzb

A stateful, Agent-controllable Jupyter workspace for DeepSeek Harness: a persistent ipykernel runtime the DSH agent can read, edit, execute, and inspect, with VS Code-aligned cell UI and .ipynb save/load.

Development & InfrastructureTerminal & ClientsManifest valid

★ 6

↓ 566/wk

MIT

JavaScript

Nov 5, 2026

dsh plugin --profile web add @beihaizb/dsh-notebook

by snow-The

Library absorption analysis for DeepSeek Harness: scan reference corpora, drive absorption-report batches (tasks.jsonl to out/*.md), validate report discipline (file:line evidence, comparison markers)

Manifest valid

★ 0

MIT

TypeScript

Nov 1, 2026

dsh plugin --profile web add @snow-the/dsh-lib-analyzer

by zirscard

Registers one `context_extract` tool for DeepSeek Harness: it compresses a long raw document (financial report, contract, ledger) into dense structured Markdown plus JSON — key metrics, tables, number

Tools & CapabilitiesManifest valid

★ 0

MIT

Python

Oct 20, 2026

dsh plugin --profile web add dsh-context-extract

A notebook inside DeepSeek Harness: one page, typeset as you write, with suggestions, structure and translation at the edge of the page.

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add @tyouter/dsh-notes

by BrambleXu

Reusable Markdown prompt profiles for DeepSeek Harness with per-turn model selection, argument substitution, and state restoration.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 1

MIT

TypeScript

Oct 10, 2026

dsh plugin --profile web add dsh-prompt-profile

Cross-app project memory for DeepSeek Harness with role-separated writeback, a visual knowledge workspace, confirmed corrections, session controls, local Writer and organizer settings, and an account-

Memory & ContextManifest valid

★ 0

dsh plugin --profile web add dsh-tmcra-memory