前言¶

在 DSH「一切皆插件」的擴展方式下，一個常見需求是讓智能體執行代碼、查看圖、按反饋修改並再次運行。如果腳本、圖、參數和環境信息分散存放，後續很難判斷某張圖由哪個 cell、哪些輸入和哪個 seed 產生。

dsh-science-workbench 是一個面向 DeepSeek Harness 的可復現科學工作臺插件。它把 agent-driven cells、內嵌圖、反饋重跑、manifest 來源記錄和環境快照組織到同一套插件能力中。

這是什麼¶

dsh-science-workbench 由 poplarity 維護，倉庫地址爲：

https://github.com/poplarity/dsh-science-workbench

package.json 中聲明的名稱是 dsh-science-workbench，許可證爲 MIT。插件定位爲 DeepSeek Harness 的 science workbench，核心是讓代碼運行、圖形預覽、反饋修改、重跑和來源記錄形成一個可追溯、可重放的閉環。

核心能力¶

智能體驅動的可復現 cell¶

插件提供面向智能體的 bio_* 工具，支持以自包含 cell 的方式運行代碼，並把生成的圖以內嵌方式展示在工作臺中。

爲了保持可復現，插件會記錄 SHA-256 輸入/輸出哈希，並配合固定 seed。環境側通過 environment.lock 保存環境快照。

反饋與重畫¶

當圖中有問題時，可以先給某個產物添加結構化反饋，再用 bio_rerun_cell 重新運行一個派生版本。

示例鏈路如下：

feedback → redraw/rerun
bio_rerun_cell → derived version

例如從 cell_0001 生成 cell_0001_v2，併產生新的圖。

manifest.json 作爲單一事實源¶

manifest.json 記錄項目的 cells、artifacts、provenance 和 feedback，是查看分析過程時的主要入口。

本地 Git 版本記錄¶

每個項目會自動執行本地 git init，並在各步驟自動提交。插件不會推送這些提交，倉庫只用於本地版本追蹤。

瀏覽器工作臺¶

插件包含九個面向智能體的 bio_* 工具，以及一個瀏覽器工作臺。工作臺提供內嵌圖預覽、可搜索項目選擇、cell 搜索、原生目錄選擇器和 mark-as-final badge。

出圖技能¶

插件附帶兩個 publication-grade 出圖技能：figure-style 和 figure-composer。這兩個技能改編自 Claude Science，許可證爲 Apache-2.0。

跨平臺支持¶

插件支持 macOS/Linux 與 Windows 的 shell 差異，並處理 python 與 python3 的解釋器解析。

安裝與啓用¶

安裝前建議檢查源碼、依賴和許可證，因爲它會在當前 dsh 進程權限下執行代碼、訪問文件並調用解釋器。

從 npm 安裝：

dsh plugin --profile web add dsh-science-workbench

本地開發安裝：

dsh plugin --profile web add file:/path/to/dsh-science-workbench

安裝完成後，重啓 dsh web。啓用後，bio_* 工具全局可用，插件會顯示在 Settings → Plugins 下。

package.json 聲明的依賴爲：

@deepseek-ai/cordis: ^4.0.1
@deepseek-ai/dsh-tools: ^0.1.0-rc.6

包內還聲明：

dsh.bundle.patch: ./cordis.patch.yml

典型用法¶

安裝並重啓後，可以直接用自然語言讓智能體操作，例如：

幫我用 demo_tss 項目畫一個 TSS 附近的信號熱圖。

等價的手動流程是：

1. bio_init_project { name: "demo_tss" }
2. bio_run_cell { title: "TSS profile", code: "..." }   # writes figures/*.png
3. bio_add_feedback { artifactPath, text: "把配色改成 Blues" }
4. bio_rerun_cell { cellId: "cell_0001", editedCode: "..." }  # → cell_0001_v2 + new figure

第 1 步創建項目。項目的來源與環境快照分別落在 manifest.json 和 environment.lock。第 2 步運行一個 cell，並把寫入 figures/ 的圖登記爲產物。第 3 步爲某個產物添加反饋。第 4 步用修改後的代碼重跑，生成派生 cell 和新圖。

這些步驟會寫入 manifest.json，並提交到項目的本地 git 倉庫。

適用場景與注意¶

適合在 DSH 中運行可復現分析、圖形迭代和來源追蹤的開發者。特別是當你希望智能體不只是執行代碼，還要保留反饋歷史、版本血緣和環境快照時，這個插件比直接散寫腳本更容易維護。

需要注意：

• 插件以當前 dsh 進程權限運行，執行代碼、讀寫文件和調用 shell/Python 的能力取決於宿主環境。
• 自動 git 只保留在本地，不會推送。
• 插件本身許可證爲 MIT；隨附的 figure-style 與 figure-composer 技能改編自 Claude Science，許可證爲 Apache-2.0。
• 依賴需要滿足 @deepseek-ai/cordis 與 @deepseek-ai/dsh-tools 的對應版本範圍。

結尾¶

dsh-science-workbench 的價值在於把 cell、圖、反饋、重跑、manifest.json 和 environment.lock 放到同一套可追溯的工作臺中。

倉庫地址：

https://github.com/poplarity/dsh-science-workbench