dsh-research-lab:面向 DeepSeek Harness 的研究室工具集

前言

在 DeepSeek Harness(DSH)里做研究类智能体,常见做法是散落的笔记、实验记录和评测结果各存一处,arXiv 跟踪与论文审阅靠临时脚本,写作润色又另开工具链。口径不统一时,很容易出现把 dev 与 test 分数混在一起对比这类问题。下面介绍社区插件 dsh-research-lab(GitHub:snow-The/dsh-research-lab),它把 wiki 中心的工作流、评测台账、文献检索与写作检查收进同一套 DSH 工具,数据落在项目目录下的 .rlab/ 中。

这是什么

dsh-research-lab 是 snow-The 维护的 DSH 插件包(npm 名 @snow-the/dsh-research-lab,当前资料中的版本为 0.2.3,MIT 许可证)。定位是 Research lab toolkit:从 AutoSci(wiki 为中心)、ASI-Bench(评测严谨性)、daily-arXiv-ai-enhanced(摘要)、ChatPaper(审稿)、nature-skills / research-writing-skill(学术写作)等实践里提炼的一套工具,并强调假设—结论闭环与 eval 口径纪律。

社区目录页:https://www.skillhub.cn/plugins/snow-The/dsh-research-lab。该目录与 DeepSeek / 幻方无官方从属关系;DSH 生态理念是「一切皆插件」,安装前请自行查看源码与许可证。

磁盘布局

插件不替代你的 Git 仓库,而是在当前项目根下维护固定结构:

<project>/.rlab/
  wiki/
    index.md            # 自动重建
    experiment/<id>.md  # 假设 → 结论
    literature/<id>.md  # 文献笔记(可与 digest 互链)
    decision/<id>.md    # ADR:为何选 X
    todo/<id>.md        # 待办
  related.db           # FTS5 语料与自构建词表(rlab_related)
  bench.jsonl           # 每行一条评测记录(JSON)
  digests/<date>.md     # arXiv 摘要

wiki 由 rlab_wiki 写入并重建索引;实验页由 rlab_experiment 按「假设 → 预测 → 证据 → 裁决 → 结论」组织;评测流水写入 bench.jsonl;检索库与摘要、审稿、写作检查分别对应下文各工具。

核心工具

README 中列出的工具如下(名称与用途以仓库文档为准):

工具 作用 思路来源(文档标注)
rlab_wiki 在 <project>/.rlab/wiki/ 下写 experiment / literature / decision / todo 页面并重建索引 AutoSci
rlab_experiment 实验页:hypothesis → prediction → evidence → verdict → conclusion AutoSci + 可证伪性
rlab_bench 项目级 eval 台账(bench.jsonl);标记口径不一致(如混用 test/dev) ASI-Bench
rlab_paper_review arXiv id → 对抗式 8 点审稿清单(也可用于自己的稿子) ChatPaper + ASI-Bench
rlab_arxiv_digest 按关键词抓取近期 arXiv → <project>/.rlab/digests/<date>.md daily-arXiv-ai-enhanced
rlab_writing 按行锚定的学术表达检查(被动语态、弱动词、模糊量词、 filler、术语一致性等) nature-skills, research-writing-skill
rlab_related 自构建关键词检索:NLP 分词 + SQLite FTS5,无预设词表;从文档 TF-IDF 挖掘(英文词 + 中文 n-gram),迭代「搜索 → 挖掘 → 合并」 hamuleite 式语料、Rocchio 相关反馈
rlab_status 一屏项目状态:wiki 计数、bench 报告、开放 TODO —

在 DSH Web 或对话中启用 bundle 后,由 Harness 按 Cordis patch 注册上述工具;具体调用方式以你当前 DSH 版本的工具 UI 为准。

Eval 口径(rlab_bench)

rlab_bench 要求每条记录写明 metric、split,MTEB 类任务还需 hf_subset。报告会在同一任务历史里混用不同 split 时给出警告——文档指出,用 test 与 dev 分数直接对比是论文与审稿中常见的自我误导方式。写台账时先固定协议再填数,比事后解释更省事。

安装与启用

资料中的安装步骤假定你已有 DSH 的 web profile,且插件源码位于 starter 的 plugins 目录(与 README 示例路径一致)。在 ~/.dsh/profiles/web 下执行:

pnpm add @snow-the/dsh-research-lab@file:../.dsh-starter/plugins/dsh-research-lab

随后在 profile 配置里把 dsh-research-lab 加入 dsh.profile.bundles,重启 dsh web。

兼容性(package.json): peer 依赖 @deepseek-ai/dsh 与 @deepseek-ai/dsh-tools 均 >=0.2.0-rc.1;engines.dsh 为 >=0.2.1-rc.2 <0.3.0-0;文档标注的 dshReleases 含 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2,verifiedAgainst 为 0.2.1-rc.2。版本不符时先对齐 DSH 再装插件。

从源码构建插件包(开发者):

pnpm install && pnpm build   # tsc 声明 + esbuild 打包 → dist/

典型用法(工作流层面)

README 未给出逐条 CLI 示例,但工具分工可组成一条可复现链路:

  1. 用 rlab_wiki / rlab_experiment 在新项目下建立 wiki 与第一条实验页,确认 wiki/index.md 已更新。
  2. 用 rlab_arxiv_digest 按领域关键词生成当日 digest,把值得跟进的论文记到 literature/<id>.md。
  3. 对重点论文或自己的 preprint 调用 rlab_paper_review(arXiv id),把结论写回 decision 或 experiment 页。
  4. 跑模型或复现基线时,经 rlab_bench 追加 bench.jsonl 行,填全 metric / split(及 MTEB 的 hf_subset),用报告检查是否混 split。
  5. 写作阶段用 rlab_writing 做表达检查;需要找项目内相关材料时用 rlab_related(会维护 related.db)。
  6. 用 rlab_status 查看 wiki 规模、bench 与开放 TODO,避免长时间不碰台账。

每一步的输入输出路径均在上文的 .rlab/ 布局中,便于与 Git 一并版本管理(是否提交 related.db 由团队自行约定)。

适用场景与注意

适合: 在 DSH 里做长期研究课题、需要 wiki + 实验记录 + 严格 eval 台账、并顺带做 arXiv 跟踪、审稿清单与英文写作检查的团队或个人。

注意:

  • 插件以当前 DSH 进程权限运行,可读写项目目录与插件逻辑所触及的路径;安装前请阅读仓库源码与 MIT 许可证。
  • 安装命令须使用 README 给出的 pnpm add ...@file:... 与 bundle 名 dsh-research-lab,不要凭仓库名臆造 dsh plugin add github:...。
  • arXiv、网络检索等能力是否可用取决于你的 DSH 环境与网络策略,本文不假设额外代理配置。

结尾

dsh-research-lab 把研究室常见的 wiki、评测台账、文献 digest、对抗式审稿与写作检查收成一组 DSH 工具,并把状态落在 .rlab/ 下,便于与「一切皆插件」的 Harness 工作方式对齐。进一步了解可看社区目录页 https://www.skillhub.cn/plugins/snow-The/dsh-research-lab 与 GitHub 仓库 https://github.com/snow-The/dsh-research-lab。

羽毛球分组比赛记分
小程序二维码

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

Xiaoye