用 dsh-scholar 給 DeepSeek Harness 接上可追溯的學術科研工作臺

DeepSeek Harness 插件 DeepSeek DSH dsh-scholar 記憶插件 文獻檢索 2026-08-17 98 閱讀

前言

用 DeepSeek Harness 做科研相關任務時，常見的斷裂點不在「能不能搜到一篇論文」，而在後續怎麼把檢索、方案、實驗和結論串起來。對話裏總結了幾篇文獻，實驗腳本卻在另一個目錄；模型給出了準確率數字，卻說不清它來自哪一次運行、用了哪份數據和哪個隨機種子；手稿寫到一半，項目狀態已經對不上。智能體循環很適合把這些步驟往前推，但如果缺少可恢復的項目狀態和人工關卡，結論很容易變成一次無法複查的聊天記錄。

DeepSeek Harness（以下簡稱 DSH）把「一切皆插件」當作架構原則：模型、工具、會話、界面都可以替換或疊加。社區目錄裏的 dsh-scholar 正是沿着這條路，把文獻調研和後續的受控實驗、證據賬本、TeX 手稿放進同一個可恢復項目。目錄頁把它歸在「記憶」類，短簡介強調「在智能體循環裏直接檢索、閱讀和總結文獻」；倉庫 README 則把它寫成面向純計算研究的 AI 科研工作臺。兩者並不矛盾：文獻檢索是其中一段，項目級狀態纔是它真正要記住的東西。

本文按社區目錄頁、GitHub 倉庫 README / 中文說明、宿主集成文檔和 package.json 覈對後整理：這個插件是什麼、當前能做什麼、怎麼安裝、典型流程怎麼走，以及使用邊界。社區插件目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不要把它當成官方應用商店。

這是什麼

dsh-scholar（產品名 DSH Scholar）是由 lzszq 維護的社區開源插件，託管在 GitHub 倉庫 lzszq/dsh-scholar，許可證爲 MIT，主要語言是 TypeScript。根包名是 @dsh-scholar/research-plugin，當前版本號爲 0.1.0，private: true，@dsh-scholar/* 包尚未發佈到公共 npm。GitHub 倉庫帶有 dsh、dsh-plugin 主題；2026-08-17 覈對時倉庫爲 20 星，社區目錄頁仍顯示 15 星。

它要解決的不是再做一個獨立的論文搜索框，而是把下面這些內容放進同一個可恢復項目：

  • 研究資料與文獻快照
  • 項目對話
  • 代碼與數據
  • 實驗運行
  • 證據賬本
  • TeX 手稿

可以從一個新問題開始，也可以把已經進行到一半的研究接進來。默認治理模式是 gate-only：Agent 不能批准 Human Gate、不能僞造 accepted Evidence，也不能繞過實驗合同。倉庫 README 明確寫了「加急開發適配中」，中文 README 給出的安裝兼容性驗證基線是 @deepseek-ai/dsh@0.1.0-rc.6。

核心功能

文獻檢索只是第一段

社區目錄的短簡介把它定位成學術論文搜索與理解插件。倉庫裏對應的是 Scholar / Curator 這一組能力：literature_search、paper_resolve、corpus_snapshot、passage_lookup。@dsh-scholar/scholar-connectors 的說明是受控學術連接器，覆蓋 OpenAlex、Crossref、arXiv，帶緩存、去重和不可變查詢快照。Chat 裏可以用 /survey 做文獻調研；調研本身不是 Runner Job，成功後會提交 Corpus Snapshot，項目進入調研就緒狀態，下一步纔是生成 Idea。

也就是說，檢索、解析論文、凍結語料快照，是後續 Idea Gate 和實驗合同的輸入，而不是插件的全部。

帶人工 Gate 的研究流程

README 給出的典型階段是：

創建/接入項目 → Grill Me → Scope Gate → 文獻調研 → Idea Gate
→ Baseline → Experiment Contract → 實驗運行 → Evidence 與 Claim
→ TeX 寫作與評審 → 私有導出 → Release Gate

關鍵節點由人類 Gate 把關，覆蓋 Scope、Idea、Experiment Contract，再到 Evidence、Claim 和 Release。Research Kernel 保存權威狀態、NextAction、審批軌跡和產物引用。Overview 和 Chat 都讀取這份權威下一步，說明原因、執行者和阻斷項。

進入工作臺有三種方式：

  1. Init：填寫項目名，在 Chat 裏通過 Grill Me 補全研究 Brief，確認後才創建 Scope Gate。
  2. Resume：打開已有項目，恢復階段、會話、文件和任務。
  3. Upload：上傳論文、代碼、數據或日誌。上傳內容先進入隔離 Intake，不會自動成爲 Evidence。

受控實驗和可追溯證據

正式實驗必須綁定不可變的代碼 / 數據快照和固定執行環境，由受控 Runner 執行。Runner 可以跑在本機 Docker，也可以跑在受控遠端機器，並記錄日誌、狀態與產物。沒有 Runner 時仍可管理項目和文件，但實驗 Job 會保持排隊。

論文主張要能追溯到受控 Run、Artifact 和經評審的 Evidence。Chat、普通 stdout 和 Interactive Terminal 的輸出不會自動成爲正式 Evidence。倉庫用 cnn-mnist-digits 演示了這條鏈路：研究問題是「帶逐通道歸一化的雙卷積 CNN，是否比單卷積 CNN 基線更準確」；數據與指標爲 mnist_subset_v1 / test_accuracy；隨機種子 11 / 23 / 47；文檔中的結果是 test_accuracy = 96.8%，相對基線 +4.4 個百分點，並給出 bootstrap 95% 平均差置信區間 [1.2, 8.6]（n=3）。這是倉庫文檔裏的示例，不是本文實測。

一體化工作臺

Chat、Workspace、Terminal、Manuscript、Trajectory 和 Settings 共用同一項目上下文。插件向 DSH 提供 Agent tools、slash commands、Skills、配置卡和 dsh Scholar 頁籤；頁籤複用已啓動的獨立工作臺，不另做一套業務 UI。DSH 與獨立工作臺共享 127.0.0.1:7412 的 Research Kernel 和 ~/.dsh/research-kernel 數據目錄，因此兩邊操作的是同一批項目。瀏覽器 Token、會話和顯示偏好仍單獨放在獨立工作臺的 BFF 目錄裏。

插件還帶四個源 Skill：research-core、domain-machine-learning、domain-data-science、venue-templates。領域和會議模板由項目 Brief 的 domain、target_venue 決定注入，而不是指望模型自己去翻文檔。

安裝與啓用

社區目錄頁給出的安裝命令是：

dsh plugin add github:lzszq/dsh-scholar

如需可復現安裝，按目錄頁說明固定 commit 哈希：

dsh plugin add github:lzszq/dsh-scholar#commit

把 #commit 換成實際提交哈希。插件以當前 dsh 進程的權限運行，安裝時可能執行代碼；安裝前應檢查源代碼倉庫和許可證。

倉庫當前的說明更細：@dsh-scholar/* 尚未發佈，完整集成推薦從本地倉庫構建後，把絕對路徑加入 DSH 的 web profile。本地體驗需要 Linux、Node.js 24、pnpm 11.20.0；正式實驗、TeX 編譯和 clean-room 復現還需要 Docker Engine。

先在本倉庫安裝並構建：

pnpm install --frozen-lockfile
pnpm run build

只跑獨立工作臺、不接入 DSH Agent 時：

bash scripts/start-standalone-ui.sh

默認頁面是 http://127.0.0.1:18610/。首次打開時，粘貼下面這個權限爲 0600 的訪問令牌文件內容：

~/.dsh-scholar-standalone/research-ui-standalone/standalone-token

獨立工作臺不要求 DSH，但不會包含 Agent tools、slash commands、Skills、配置卡和 dsh Scholar 頁籤。要獲得完整集成，倉庫建議使用 pnpm 安裝並構建最新 DSH 源碼，再從該源碼倉庫運行 DSH，然後把 Scholar 倉庫的絕對路徑加進 web profile：

cd /path/to/dsh-source
pnpm install
pnpm run build
pnpm dsh plugin --profile web add /absolute/path/to/dsh-scholar
pnpm dsh plugin --profile web why @dsh-scholar/research-plugin
pnpm dsh web

這裏的 /path/to/dsh-source 是最新 DSH 源碼倉庫，/absolute/path/to/dsh-scholar 是本倉庫。更新時先在 Scholar 倉庫重新 pnpm run build，再執行同一條 add。卸載：

pnpm dsh plugin --profile web remove @dsh-scholar/research-plugin

需要在本機 Docker 裏跑實驗時，另開一個終端啓動 Runner：

export DSH_SCHOLAR_KERNEL_TOKEN="$(< ~/.dsh/research-kernel/kernel-token)"
export DSH_SCHOLAR_SERVICE_TOKEN="$(< ~/.dsh/research-kernel/service-token)"
node workers/runner-gateway/lib/bin/runner.js \
  --kernel http://127.0.0.1:7412 \
  --mode docker

安裝插件後，在 DSH 中打開 設置 → 插件配置 → dsh Scholar。保存的修改會在下一次重啓 DSH 後生效。文檔中的配置項如下：

配置項 默認值 說明
默認治理模式 gate-only 新建項目未顯式指定 mode 時使用。full-auto 僅適合已配置 FixtureProfile 的低風險沙箱
無人值守運行 關閉 不繞過人工 Gate；遇到 Gate 時暫停項目
Standalone 地址 http://127.0.0.1:18610/ 插件頁籤和「在新頁面打開」的目標。僅允許 HTTPS 或 loopback HTTP
新頁面快捷鍵 Alt+Shift+S 可禁用；正在輸入或使用輸入法時不會觸發

Standalone 地址不允許憑據、查詢參數或 URL 片段，令牌不應放進 URL。若 DSH Web 不在默認的本機 3080 端口，啓動獨立工作臺前要用 DSH_SCHOLAR_STANDALONE_FRAME_ANCESTORS 配置允許嵌入的精確 origin。

典型用法

以倉庫 README 和《使用指南》爲準。在 DSH Chat 裏可以直接說「創建研究項目 …」「繼續調研」「現在到哪一步了」；Harness 會走 Scholar 的受控會話入口 dsh_scholar。沒有關聯項目時，整句肯定創建指令加上原文中的完整項目名會創建 name-only Init 並綁定當前 session；缺名稱會追問。Gate、Brief 確認、外部材料採納和發佈決定仍要由人完成。

Chat 也支持一級 slash command，README 列出的常用命令是：

/new  /status  /survey  /ideas  /gates  /contract  /run
/evidence  /claims  /write  /review  /release-bundle  /release

使用指南里還有 /list、/jobs、/reproduce、/help。DSH Web 已佔用 /export 下載 Session 日誌，所以 Scholar 用 /release-bundle 生成私有發佈包。不要給這些命令再加一層聚合前綴。

一個按文檔可以復現的最小路徑：

  1. 啓動獨立工作臺，必要時再啓動 Runner，並按上一節把插件加入 DSH web profile。
  2. 用自然語言創建項目，或執行 /new 項目名。在 Chat 裏回答 Grill 問題，確認 Brief 後纔會出現 Scope Gate。
  3. Scope 審批後執行 /survey "你的研究問題"。檢查 Corpus Snapshot 是否提交，再執行 /ideas。
  4. 選定 Idea 並完成 Idea Gate 後，登記代碼和數據快照，提交 Baseline 與 Experiment Contract。
  5. 用 /run 跑正式對照；在 Run Terminal 查看只讀日誌。需要交互調試時用 Interactive Terminal，但其輸出不會自動變成 Evidence。
  6. 用 /evidence、/claims 把指標、效應量、置信區間和 Run / Artifact 綁到主張上，經評審後才能標記爲 accepted。
  7. 在 Manuscript 中編輯 paper.tex 和 main.bib，用 /write、/review 推進手稿；對外發布前仍要批准 Release Gate。

cnn-mnist-digits 就是這條路徑的文檔示例：Chat 推進任務，Gate 鎖定範圍和合同，基線與正式方案以獨立 Job 執行，失敗記錄保留並可重試，最後把證據寫進手稿。

適用場景與注意事項

適合把 DSH 當作研究宿主、並且需要項目級狀態而不是一次性問答的人。倉庫把產品範圍限定在機器學習、數據科學、生物信息學等純計算研究。可以用來做文獻調研、受控對照實驗、把主張追溯到 Run / Artifact，以及在固定 TeX Live 環境裏寫手稿。

下面這些邊界是文檔寫明的，不要自行放寬：

  • DSH Scholar 輔助研究，不代替研究者承擔科學判斷、審批、署名和發佈責任。
  • 默認 gate-only。Agent 不能批准 Human Gate，不能把 Chat 或終端輸出直接寫成正式 Evidence。
  • 不適用於臨牀決策、人體試驗、溼實驗或其他高風險研究。
  • 使用指南寫明產品仍在開發中；能力只有在倉庫的 hardening 狀態文檔標爲「已驗收」並綁定當前 CI 證據後，才應用於正式科研。
  • 插件以當前 dsh 進程的權限運行。安裝前檢查 源碼倉庫 和 MIT 許可證；生產環境優先固定 commit，而不是跟蹤浮動的默認分支。
  • 獨立工作臺的訪問令牌、Kernel token、Runner token 都是本地密鑰，不要放進 URL，也不要提交到倉庫。

小結

dsh-scholar 把文獻檢索接到 DSH 的智能體循環裏，同時用 Research Kernel 記住項目階段、審批和產物。目錄頁看到的是「記憶」類插件和論文搜索簡介；打開倉庫後，它更像一個帶人工關卡的計算科研工作臺。當前仍在加急適配 DSH，完整集成需要本地構建，不能按已經發布的 npm 包來理解。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-scholar/

GitHub：https://github.com/lzszq/dsh-scholar

相關文章

快速從零部署一個DeepSeek-R1服務 2025-04-05 使用 dsh-anchored-standard 爲 DeepSeek Harness 配置兩階段 Agent 預設 2026-08-17 用 dsh-web-ui 把 DeepSeek Harness 網頁界面補成工作臺 2026-08-17 用 modlens 給 DeepSeek Harness 的純文本模型補上視覺 2026-08-17 用 dsh-TUI 給 DeepSeek Harness 補上全屏終端界面 2026-08-17
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜