@dsh-local/dsh-jupyter
适用于 dsh Web GUI 的 Jupyter notebook（.ipynb）查看器、编辑器和运行器：由主机文件系统服务驱动的原生右侧边栏标签页类型，配备仅使用标准库的 Python 内核桥接，并使用 dsh 内置的 Python。无原生依赖。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:kikulmj/dsh-jupyter#4a438039f2fcc0feb42f502ff384edf91260782a
Jupyter 以 @dsh-local/dsh-jupyter 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A Jupyter notebook (.ipynb) plugin for dsh: open, edit and run notebooks in the Web/Desktop GUI's right sidebar. Rebuilt for the dsh 0.2.x plugin model — plain JavaScript plus one Python script, with no native dependencies and no terminal.
.ipynb in the file tree opens it in the same tab system as the text preview. The tab strip, dragging, split view, fullscreen, layout persistence and theme all come from dsh; the plugin only contributes tab types..py, .js, .ts, .json, .yaml, .toml, .sh, .sql, .txt, .css, and more) are also handled by this plugin, with editing and saving in the right-sidebar tab. Markdown, HTML, CSV, images, PDF and Office documents stay with the official preview so their richer read-only views are preserved.! magic lines); Tab / Shift+Tab to indent and dedent; Enter keeps the current indentation and adds a level after :..ipynb opens as a new notebook; a file that is not valid notebook JSON shows an error with Reload / Open as empty notebook actions.~/.conda/environments.txt from the notebook toolbar. Switching restarts the kernel on that interpreter, and the choice is stored in the notebook metadata.DataFrame uses _repr_html_; PIL images and _repr_png_ / _repr_svg_ / _repr_json_ / _repr_markdown_ are rendered. matplotlib figures (when installed in that Python environment) are emitted as inline PNGs after the cell.From GitHub:
dsh plugin --profile web add github:kikulmj/dsh-jupyter
The Desktop app uses the desktop profile:
dsh plugin --profile desktop add github:kikulmj/dsh-jupyter
Local development (edit code → pnpm build → restart dsh):
dsh plugin --profile web add link:/path/to/dsh-jupyter
engines.dsh (this plugin declares >=0.2.0-0) and accepts 0.2.x runtimes.allowBuilds and no node-gyp are needed: the plugin has no native modules such as node-pty.dsh plugin --profile web remove @dsh-local/dsh-jupyter.Mod+P) and click any .ipynb.Shift+Enter to run a code cell and Ctrl/Cmd+S to save.!command (for example !pip list; pip / python resolve to the current kernel interpreter), %pip, %cd, %pwd..py, .json or .txt opens an editable tab; Ctrl/Cmd+S saves, with a version-conflict check.conda: binxing). !conda activate inside a cell only affects that shell subprocess and cannot change the kernel; the picker restarts the kernel on the chosen interpreter and stores the choice in the notebook metadata.examples/plot-demo.ipynb for a matplotlib demo and a dependency-free SVG fallback.$DSH_PRIMARY_RUNTIME/dependencies/python/… → $DSH_HOME/dsh-runtimes/dsh-primary-runtime/dependencies/python/… → python3 / python on PATH.~/.conda/environments.txt (and ~/.anaconda/environments.txt) appear in the picker. Selecting one runs its python directly and sets PATH / CONDA_PREFIX / CONDA_DEFAULT_ENV to approximate conda activate.jupyter_client or ipykernel.src/
index.ts Host half: /dsh-jupyter/* routes + agent announcement
core/types.ts Wire types
host/scope.ts Session workspace resolution + filesystem boundary checks
host/notebook-service.ts nbformat 4 parse/serialize, reads and writes through ctx.fs (version guard)
host/routes.ts read / write / raw / text-read / text-write / execute / interrupt / restart
host/python.ts Locate dsh's bundled Python and list conda environments
host/kernel.ts One persistent Python kernel process per notebook (JSONL stdio)
host/kernel_bridge.py Stdlib-only Python kernel bridge (persistent namespace, streaming, interrupt)
client/index.ts Register the `.ipynb` and text-file tab types and body slots
client/panel.tsx Notebook editor (native slot component)
client/text-editor.tsx Text/code file editor
client/code-editor.tsx Transparent textarea + highlight overlay
client/highlight.ts Python / JS / C / Shell / SQL tokenizer
client/api.ts /dsh-jupyter client
client/styles.ts Cell/output/editor styles over dsh's `--dsw-*` theme tokens
The browser half only requires react; the host half imports Node built-ins only. Every dsh service is declared as a peer dependency and provided by the profile at runtime.
ctx.fs.resolve + ctx.fs.contains, and written through dsh's sandboxed filesystem policy — the workspace limit is never bypassed.input() / stdin interaction is not supported.!conda activate only changes that one shell subprocess; it does not change the kernel. Use the toolbar's Kernel environment picker instead.!, %pip, %cd and %pwd are supported; %% cell magics and other IPython magics (%time, %run, …) are not.! commands run with the host user's privileges; output written directly to file descriptors by C extensions or subprocesses is shown once the cell finishes, not streamed live.lib/ is committed, so remote installs need no local build.pnpm install
pnpm build # tsc → tsdown → copy kernel_bridge.py