前言¶
在 DeepSeek Harness (DSH) 中，默认行为是打开 .ipynb 文件时显示其原始 JSON。dsh-ipynb-preview 插件通过将文件作为笔记本渲染来解决这个问题，包括语法高亮、LaTeX 和可缩放图片。
这是什么¶
这是一款 DeepSeek Harness 插件，用于在 DSH 的文档预览窗口中渲染 Jupyter .ipynb 文件。
核心价值是将 .ipynb 的原始 JSON 显示替换为可读的笔记本视图，包括代码高亮、数学公式和交互式图片。
核心功能¶
- 代码语法高亮：支持 Python、JavaScript/TypeScript、JSON、Bash 和 INI 语言的语法高亮。
- LaTeX 数学渲染：内置离线 KaTeX 引擎，支持行内（
$...$）和块级（$$...$$）数学公式。 - Markdown 子集支持：支持标题、列表、表格、引用、任务列表、代码块、链接及粗体斜体样式。
- 交互式图片：点击图片可打开预览，支持缩放（
+/-）、平移、自适应（0）及保存为 PNG。 - 输出结果渲染：支持渲染执行流、
display_data、execute_result以及错误堆栈跟踪。
安装与启用¶
使用官方命令安装插件：
dsh plugin --profile <your-profile> add github:WuShichao/dsh-ipynb-preview
安装完成后，必须重启 DSH。这是一个客户端渲染插件，重启是必要的，而不是刷新页面。
典型用法¶
安装并重启 DSH 后，打开一个 .ipynb 文件，预览窗口将显示格式化的笔记本内容。无需网络连接即可使用内置的 KaTeX 引擎渲染数学公式。
注意事项¶
- 客户端渲染：插件运行在浏览器端，依赖于 DSH 启动时计算出的客户端包版本。
- 离线工作：KaTeX 引擎及其字体已内联到客户端包中，支持离线使用。
- 依赖关系：React 不是此插件的依赖项，它由 DSH Shell 的模块加载器提供。
短结尾¶
此插件通过将 JSON 视图转换为结构化的笔记本视图，解决了在 DSH 中查看 Jupyter 文件的痛点。对于需要处理大量数据分析或实验记录的开发者，它提供了更直观的预览体验。
GitHub: https://github.com/WuShichao/dsh-ipynb-preview
