dsh-notebook-capture
Manifest validNotebook 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
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.
English · 简体中文
What it does
nb_analyze— parses the notebook and reports: kernel/language/version, code vs markdown cells, execution counts (out-of-orderandnever 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/
.pyconversion..ipynbonly; usejupyter nbconvertfirst if needed.
Structural checks
| Code | Severity | Meaning |
|---|---|---|
out_of_order | warning | execution counts are not increasing |
unexecuted_cells | warning | code cells without an execution count |
runtime_install | warning | packages installed inside the notebook |
no_seed | warning | code cells but no seed literal |
absolute_paths | warning | /home/…, /Users/…, C:\… literals |
outputs_missing | info | no cell carries saved output |
no_kernel | warning | metadata has no kernel/language |
no_imports | info | no import statement found |
| missing env declaration | warning | reported 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 Harness | dsh-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 dependencies | zero |
dsh plugin --profile <name> add @perrylink/dsh-research-core dsh-notebook-capture
dsh --profile <name> --dump-config | grep dsh-notebook-capture
Configuration
| Key | Default | Meaning |
|---|---|---|
enabled | true | false mounts nothing |
root | .notebook-capture | store/record root |
workspaceRoot | process.cwd() | notebook paths must resolve inside it |
maxBytes | 10485760 | notebook file or text cap (fails, never truncates) |
persist | true | store notebook as REP evidence + record |
Security boundaries
- Read-only on the notebook; writes only under
root. realpathcontainment; 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
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.
★ 6
↓ 566/wk
MIT
JavaScript
Nov 5, 2026
dsh plugin --profile web add @beihaizb/dsh-notebookby 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)
★ 0
MIT
TypeScript
Nov 1, 2026
dsh plugin --profile web add @snow-the/dsh-lib-analyzerby 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
★ 0
MIT
Python
Oct 20, 2026
dsh plugin --profile web add dsh-context-extractA notebook inside DeepSeek Harness: one page, typeset as you write, with suggestions, structure and translation at the edge of the page.
★ 0
MIT
JavaScript
dsh plugin --profile web add @tyouter/dsh-notesby BrambleXu
Reusable Markdown prompt profiles for DeepSeek Harness with per-turn model selection, argument substitution, and state restoration.
★ 1
MIT
TypeScript
Oct 10, 2026
dsh plugin --profile web add dsh-prompt-profileCross-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-
★ 0
dsh plugin --profile web add dsh-tmcra-memory