在 DeepSeek Harness (DSH) 中構建智能體或研究流程時，腳本、終端輸出、圖片和半成品文件往往會散落在各個目錄。當需要回溯某個決策的依據或重構實驗過程時，這種碎片化的狀態很難快速定位。Runbook 試圖將 DSH 的會話、Git 倉庫和觀測到的輸出，統一投影到一個持久化、Git 版本控制的研究工作面上。
Runbook 是一個爲 DeepSeek Harness 設計的插件。它提供了一個類似 Jupyter Notebook 的研究界面，核心是構建一個持久化且基於 Git 的研究工作空間。該界面整合了會話血緣、腳本執行記錄和可視化證據，讓研究問題、腳本修改和輸出結果保持一致。
核心功能¶
Runbook 的設計核心是將研究單元映射爲 Git 中的實體，而非單純的文件系統層級。
- 研究羅盤：位於界面頂部，展示當前的研究問題、決策狀態以及下一步判別步驟。其來源是項目中的
README.md和STATUS.md等文檔。 - 穩定的腳本嘗試單元格：同一腳本對應界面上的一個 Attempt 單元格。重跑腳本不會創建新的頁面或目錄，而是增加該單元格下的執行歷史和 Evidence 生成。
- 會話血緣投影：界面展示當前 DSH 會話及其祖先的執行記錄，旁支的會話記錄會被保留但默認摺疊，確保視線聚焦於當前研究路徑。
- 可視化證據與工件：界面會展示最新的圖片、PDF 和 HTML 輸出。生成這些證據的對話回合旁邊也會顯示縮略圖，避免證據與上下文分離。
- 安全重跑：在執行腳本前，Runbook 會生成清單並展示預覽，要求用戶確認後才執行，避免誤操作。
- Agent 感知的 Git 作者身份：支持區分 Agent 和人類貢獻者，Agent 在提交時不會覆蓋人類集成者的身份。
安裝與啓用¶
安裝該插件需要使用 DSH 的插件管理命令。
dsh plugin --profile web add zhan-tz/dsh-plugin-runbook
安裝完成後，重啓選定的 DSH 界面，並在對話中選擇 Runbook / 運行本 即可進入工作空間。
典型用法¶
在 Runbook 工作面中，研究者可以按照以下步驟進行操作：
- 打開與定位：在 DSH 對話中打開 Runbook 界面，先閱讀頂部的「研究羅盤」，明確當前的研究目標和下一步判別步驟。
- 腳本複用與改進：如果研究問題未變，直接改進現有的 Attempt 單元格腳本以添加歷史記錄；僅在問題、數據或輸出契約真正不同時，才考慮創建新分支。
- 執行與確認：運行支持的入口腳本，在查看執行計劃後進行確認。
- 證據對比：確認執行後，在界面中對比新生成的 Evidence 與之前的生成結果，以及對應的對話回合。
- 版本控制：將經過驗證的檢查點保存到 Git。
適用場景與注意事項¶
適用場景：適合需要長期維護研究腳本、依賴 Git 版本控制、需要清晰追溯實驗證據鏈的研究項目。
注意事項：
* 瀏覽器請求被綁定在持久化的 DSH 會話上，路徑被限制在該會話的工作空間內。
* 內聯媒體目前有 6 MiB 的限制，超過限制的文件會顯示但需用系統應用打開。
* 重跑操作使用主機的 runner，並需要確認步驟。
* 終端文本僅作爲備選觀測手段，並非完美的生產者/消費者溯源證據。
* 靜態 I/O 檢查僅爲提示，不能證明任意動態 I/O。
* 插件不暴露任意的瀏覽器 Shell，也不會執行從文件中剪切的非結構化代碼片段。
Runbook 提供了一個聚焦於研究過程本身的結構化視圖。它不替代文件瀏覽器，而是將 DSH 的運行事實、Git 歷史和項目文檔映射爲一個可追溯、可復現的工作面。對於希望在 DSH 中進行 Git 化協作和證據鏈管理的開發者，這是一個直接可用的工具。
