前言¶
在 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
