DeepSeek Harness (DSH) 通过插件机制扩展功能。对于需要结构化工作流和特定工具的研究场景，dsh-researchcraft 提供了一个现成的配置方案。它将 ResearchCraft 的科学技能集、活体实验室笔记本和专业子智能体集成到 DSH 的 Web UI 和 Agent 中。
插件概览¶
- 名称：dsh-researchcraft
- 定位：工作流
- 维护者：raktim-mondol
- 许可证：MIT
安装与启用¶
在安装此插件前，需确保已正确安装并运行 DeepSeek Harness CLI (dsh)。
安装命令¶
执行以下命令添加插件，这会创建 researchcraft 配置文件（如果不存在）：
dsh plugin --profile researchcraft add github:raktim-mondol/dsh-researchcraft
更新与本地安装¶
若需更新到最新版本：
dsh plugin --profile researchcraft update dsh-researchcraft
若用于本地开发或调试，可直接添加本地路径：
dsh plugin --profile researchcraft add /path/to/dsh-plugin
配置文件要求¶
在配置 researchcraft profile 时，必须确保 @deepseek-ai/dsh-web-app 列于 dsh-researchcraft 之前。
核心功能¶
该插件主要提供以下能力：
-
ResearchCraft Agent 预设
包含特定的人格设定、研究系统提示词以及连接器配置。该预设集成了学术搜索、PaperMemory 和语义搜索等功能，但需在聊天中显式选择。 -
科学技能目录
集成了多个开源技能库：- 领域与方法论：140 个领域技能（化学、基因组学等）和 16 个研究方法论技能。
- 职业特定技能：503 个职业特定技能（加速器物理学家、动物学家、精算师等）。
- 专业技能：包含药物发现、数据科学管道、超参数优化、科学制图等特定技能。
-
工具集
提供以下工具：image_generate：生成科学概念图。sci_inspect：科学文件格式检查（化学、结构、质谱等）。latex_compile：编译 LaTeX 文件生成 PDF。pdf_to_markdown：将 PDF 转换为 Markdown。modal_run/runpod_run：远程 GPU/CPU 计算任务提交。workflows：工作流管理。
-
MCP 连接器
包含parallel_search（并行搜索）、consensus_search（共识搜索）和papermemory（文献记忆）。 -
活体实验室笔记本
提供笔记本工具，用于记录、读取和导出 JSONL 格式的实验日志，支持 Markdown 和 Zip 打包导出。
运行与使用¶
启动插件提供的 Web UI：
dsh --profile researchcraft
或使用共享启动器：
dsh-researchcraft
通常会在 http://127.0.0.1:3080 打开界面。
预设选择¶
安装插件后，Agent 预设选择器中会出现“ResearchCraft”选项，但该选项不会替换默认预设（如“Standard mode”或“PTC mode”）。新建会话时默认仍为旧预设，需手动切换：
- 开始新会话。
- 点击消息框顶部的预设选择器。
- 选择 ResearchCraft。
注意事项¶
- 单界面限制
dsh-web、dsh-tui、dsh-martty和dsh-researchcraft共享$DSH_HOME，包括端口 3080 和zvec-grep守护进程。一次只能运行一个 DSH 界面。若端口被占用，请先检查：
ss -ltnp | grep 3080
-
后台进程清理
直接使用Ctrl+C结束进程时，后台守护进程可能未完全退出。再次启动前建议运行zg server off停止守护进程，或使用共享启动器scripts/dsh-launch。 -
全局默认值清除
切换到其他 profile（如dsh-tui）会清除全局settings.yaml中保存的researchcraft默认值。若后续切回dsh-tui并使用该全局默认值，因dsh-tui未安装该插件，会导致 Agent 启动失败。
结语¶
dsh-researchcraft 为 DeepSeek Harness 用户提供了完整的科研工作流基础设施。通过集成的技能库、MCP 连接器和笔记本工具，可以在 DSH 环境中快速搭建专业的研究环境。
