前言¶

DeepSeek Harness（DSH）把智能體配置拆分成插件與預設。若你想讓 DSH 扮演科研助手，需要一套完整的 persona、技能清單、實驗筆記本和子代理體系。Academic Harness 正是爲這類場景提供的 DSH profile 插件。

是什麼¶

Academic Harness 是一個 DSH profile 插件，將科研流程打包成預設：研究 persona、科學技能目錄、實驗筆記本和專家子代理。它依賴 DeepSeek Harness 0.2.1 或更高版本。

核心功能¶

• Academic Harness 預設：包含 persona、研究系統提示詞（實驗筆記本紀律、專家名單、連接器指引）和學術搜索連接器。
• 學術搜索連接器：mcp__parallel__、parallel_search、mcp__firecrawl__、mcp__scite__、consensus_search、PaperMemory（mcp__papermemory__）、workspace 語義搜索（mcp__zvec_grep__zvec_grep_search）、paper_mcp、citation、manuscript_citations、review（系統綜述賬本）、clinicaltrials/openfda、dataset_search/journal_policy/funder_policy。
• 通用工具：notebook、image_generate、sci_inspect、latex_compile、mermaid_render、pdf_to_markdown、modal_run/runpod_run、workflow（註冊在插件/ bundle 層）。
• 科學技能目錄：從開源目錄打包進 skills/，無需額外 checkout：
• 140 個領域技能（化學、基因組學/生物信息學、成像、統計、機器學習、寫作等）
• 16 個研究方法論技能（問題框架、預註冊、驗證先於斷言、紅隊審查等）
• 503 個職業特定專家推理技能（加速器物理學家、動物學家、精算師等）
• 23 個小分子/蛋白質治療技能（AutoDock-Vina、逆合成、蛋白質結合物設計等）
• docx-editor-zotero 技能（不破壞 Zotero 引用的 .docx 編輯）
• agentic-data-science-pipeline 技能（大任務的多階段計劃/審查/實施/驗證/反思循環）
• hyperparameter-optimization 技能（預註冊流程等）

安裝與啓用¶

Academic Harness 0.22.0 要求 DeepSeek Harness 0.2.1 或更高。先安裝 DSH：

npm install -g @deepseek-ai/dsh
dsh --version   # 應報告 0.2.1 或更高

方式一：通過 DSH Web UI 安裝（推薦）
1. 啓動 DSH Web UI：dsh web
2. 打開 Plugins → Add plugin
3. 在 package 字段粘貼以下之一：
- GitHub（推薦）：github:raktim-mondol/academic-harness
- npm registry：academic-harness（v0.16.0 未發佈，建議從 GitHub 或本地 checkout 安裝）
- 本地 checkout：絕對路徑，例如 /home/you/academic-harness
4. 點擊 Install。Academic Harness 安裝到當前 profile，默認啓用，出現在 Installed plugins 中。
5. 新建對話，確認預設選擇器顯示 Academic Harness。

方式二：通過 CLI 安裝專用 profile

dsh plugin --profile academic-harness add github:raktim-mondol/academic-harness

此命令會創建 academic-harness profile（如不存在），並將 Academic Harness 加入其中。啓動：

dsh --profile academic-harness

更新 profile：

dsh plugin --profile academic-harness update academic-harness

本地開發也支持絕對路徑 checkout：

dsh plugin --profile academic-harness add /absolute/path/to/academic-harness

典型用法¶

啓動 Academic Harness profile 後，新建對話，預設選擇器顯示 Academic Harness。學術搜索、PaperMemory、語義搜索等連接器會自動可用。系統提示詞包含筆記本紀律、專家名單和連接器指引。通用工具（notebook、latex_compile 等）在所有預設中可用。

適用場景與注意¶

• 適合需要完整科研工作流的 DSH 用戶，包括文獻檢索、數據管理、寫作與審閱。
• 插件以當前 DSH 進程權限運行，安裝前建議查看源碼與許可證。
• Academic Harness profile 的 bundle patch 會設置 agent-preset-registry default: academic-harness，並插入 preset-academic-harness。新對話默認使用此預設，且不再讀取 $DSH_HOME/.agent-presets/。
• 一個 DSH surface 同時只能激活一個：dsh-web、dsh-tui、dsh-martty、academic-harness 共享 $DSH_HOME（包括端口 3080 和 zvec-grep daemon）。Ctrl+C 不一定等待它們退出，啓動另一個 launcher 前應先清理殘留進程。
• 在 v0.16.0 中，項目從 dsh-researchcraft / ResearchCraft 重命名爲 Academic Harness。舊命令 dsh-researchcraft 仍作爲過渡別名保留，profile 名稱從 researchcraft 變更爲 academic-harness。

結尾¶

Academic Harness 把科研流程整合進 DSH，提供從文獻檢索到寫作審閱的一站式能力。相關資料與源碼見：
- 目錄頁：https://www.skillhub.cn/plugins/raktim-mondol/academic-harness
- GitHub：https://github.com/raktim-mondol/academic-harness