前言¶
在 DeepSeek Harness(DSH)里做文献综述,常见做法是反复把 PDF 丢进会话,结论留在聊天记录里,写综述时很难回溯「这句话出自哪一篇」。DSH 的生态思路是「一切皆插件」:能力以插件形式挂载,社区目录在 SkillHub 等站点维护,与 DeepSeek / 幻方无官方从属关系。下面介绍维护者 zemyao7 发布的 dsh-academic-skills——四个面向真实科研工作流的学术技能,中文优先、模型无关,用目录里的 Markdown 文件把精读、格式、润色和大纲串起来,而不是再做一个聊天框。
这是什么¶
dsh-academic-skills 是给 DSH 的科研技能包:文献卡片、参考文献格式转换、期刊文风润色、综述大纲。简介概括为:Academic skills for DeepSeek Harness: literature cards, citation formatting, journal polishing, and review outlines. Chinese-first, model-agnostic, MIT.
在 SkillHub 上分类为工作流。当前 GitHub 星标为 0;npm 包版本 0.1.1,许可证 MIT。需要 DSH >= 0.2.0,不依赖网关或 API Key,DeepSeek、GPT、Claude、本地模型均可配合使用。
它解决什么问题¶
- 读了很多 PDF,最后只剩聊天?→ 每篇落成
cards/*.md,可检索、可 git、可交接。 - 综述写到最后不知道出处?→ 大纲里每个论点标注来源卡片。
- 模型补全缺信息?→ 缺失处强制标【原文未提及】,不猜、不编。
- 参考文献被导师按规范打回?→ 支持 GB/T 7714、APA 7、AMA、MLA 9 等整篇重排,并附变更清单。
设计强调:卡片是唯一数据源——后续技能只读卡片,不重读全文;扫描件读不出文字会停下提示,不会凭标题瞎写。
四个技能¶
| 技能 | 做什么 | 产出 |
|---|---|---|
literature-card |
精读论文,生成结构化文献卡片;多篇时做横向对比 | cards/*.md |
citation-format |
按目标规范重排整篇论文与参考文献,只改格式不改内容 | formatted/*.md |
journal-polish |
按目标期刊文风润色(语法纠错 / 学术升级 / 精简压缩) | polished/*.md |
review-outline |
基于卡片生成综述分层大纲,含可检验的研究缺口 | review/outline.md |
推荐的项目目录结构如下,四个技能靠文件衔接,不靠聊天历史:
你的项目/
├── papers/ 放 PDF、docx、txt
├── cards/ 技能生成的文献卡片
├── review/ 综述大纲与对照矩阵
├── formatted/ 格式转换后的论文
└── polished/ 润色后的段落
安装与启用¶
官方 README 给出的推荐安装方式为 npm:
dsh plugin add dsh-academic-skills
装完后新开一个会话,问一句「你现在有哪些技能」,确认四个技能已加载。
其它方式(资料原文):
- 本地包:在 GitHub Releases 下载
.tgz,在 DSH → 插件 → 添加插件中填写 tgz 的绝对路径。 - 不用插件系统:把仓库里
skills/*.md复制到~/.dsh/skills/(Windows:%USERPROFILE%\.dsh\skills\),重启会话。
插件以当前 DSH 进程的权限运行;安装前建议自行查看 GitHub 源码 与 MIT 许可证,确认符合你的环境与合规要求。
典型用法¶
以下示例来自 README,可直接改路径后复现。
批量精读
读
papers/下所有 PDF,每篇生成一张文献卡片放到cards/,做完写一份横向对比。
出综述大纲
基于
cards/里的卡片,按「背景 / 时间线 / 分支 / 争议 / 研究缺口 / 展望」生成综述大纲,每个观点标出来源。
投稿前
把
draft.md的参考文献按 GB/T 7714-2015 重排,正文格式一起改,输出变更清单。
若几篇论文主题不一致,技能会明确说明,不会硬凑对比;卡片会记录原始文件路径,便于回溯。
适用场景与注意¶
适合谁:硕博阶段需要系统读文献、写综述、改引用格式、按期刊文风改稿,且希望产出落在项目目录里、可版本管理的用户。
注意:
- 隐私原则:不记录学号、身份证号、手机号等与学术判断无关的个人信息。
- 兼容性以
package.json中engines.dsh为准:>= 0.2.0。 - 社区目录页与 GitHub 为事实来源;星标、版本会随仓库更新变化,以你安装时页面为准。
结尾¶
dsh-academic-skills 把「读论文 → 卡片 → 大纲 / 格式 / 润色」做成可交接的文件流水线,并约束模型在缺信息时不编造。若要安装或看更新说明,可访问 SkillHub 目录页 与 GitHub 仓库。