前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。在研讀論文對應的開源代碼時，論文結構通常固定，但代碼倉庫千差萬別，往往讓人不知從何入手。dsh-code-reading-coach 是一個 Agent 預設插件，通過「五段研讀法」提供交互式引導，幫助你從「不知道從哪入手」到「講得出整個系統的故事」。
插件定位¶
這是一個基於 DeepSeek Harness 的 Agent 預設插件，由 TobySUN 維護，採用 MIT 許可證。它的核心價值在於將抽象的代碼閱讀過程結構化，通過逐條映射論文主張與代碼實現，降低研讀門檻。
核心功能¶
該插件通過一套固定的流程引導閱讀，主要包括以下五個階段：
- 錨定：將論文內容蒸餾成 3–5 條核心主張，形成代碼需要回答的問題清單。
- 地形：掃描代碼語言、框架/架構、依賴清單、目錄樹及測試佈局，形成地形圖。
- 入口：定位可運行的入口點，追蹤頂層執行流。
- 核心映射：閱讀核心模塊，逐條覈對論文主張，生成映射表。
- 閉環：運行最小測試、手推數據流、修改代碼觀察結果，並進行費曼複述。
除了流程控制，它還具備以下能力：
- 倉庫類型自適應：針對訓練框架、內核庫、模型倉庫等不同類型，自動調整閱讀路徑。
- 深度三檔切換：提供概覽、追蹤、深潛三個檔位，默認從追蹤開始，避免一開始就陷入細節。
- 費曼檢查點：在深潛前要求用戶用自己的話複述，講不通則降檔重講。
- 矛盾顯式標記：當代碼實現與論文主張不符時，顯式標記出來。
- 產出物沉澱：研讀筆記會持續沉澱到工作區，生成
<倉庫名>-notes.md文件，支持跨會話繼續閱讀。
安裝與啓用¶
使用官方安裝命令添加插件。安裝後必須重啓 dsh 進程才能生效。
dsh plugin --profile web add github:tobysunsun/dsh-code-reading-coach
重啓後，新建會話，在預設選擇器中選擇「代碼研讀教練」即可開始。
典型用法¶
選擇預設後，可以直接輸入以下指令：
- 「我想讀 FlashAttention 的代碼」—— 插件會先告知項目技術棧，再帶你一步步閱讀。
- 貼上一篇論文鏈接或 PDF —— 插件會先蒸餾論文主張，再逐一對照代碼驗證。
- 只有倉庫、沒有論文 —— 直接說「幫我搞懂這個倉庫」，插件會將此作爲學習目標。
適用場景與注意¶
該插件依賴 @deepseek-ai/cordis 和 @deepseek-ai/dsh-tools 環境。
源碼與維護：插件源碼結構簡單，僅包含 lib/index.js 和 preset/ 三個文件，可自行審閱。
卸載說明：使用 remove 命令卸載時，不會自動刪除預設目錄（避免誤刪用戶修改過的文件）。如需手動移除：
rm -rf ~/.dsh/.agent-presets/code-reading-coach
生態背景：此插件發佈於社區目錄，與 DeepSeek 或幻方無官方從屬關係。
總結¶
如果你需要系統化地閱讀 AI 或軟件領域的論文代碼，dsh-code-reading-coach 提供了一套經過驗證的流程和交互模式。通過 MIT 許可證開源，你可以放心查看其實現細節。
