前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。在本地研究中，资料常散落在检索网页、PDF 阅读器、表格和笔记软件中。Hana Research 将这些环节收进同一个可追溯工作流，为心理学与社会科学研究提供本地优先的文献发现、PDF 精读、证据整理与系统综述支持。
这是什么¶
Hana Research 是一个本地文献综述、PDF 注释、证据综合和研究笔记工作台。
- 版本：当前为 0.5.0-beta.1（开发者预览版）。
- 维护者：zhoupengyun572-cell。
- 定位：解决研究资料分散、难以追溯的问题，提供从文献发现到系统综述的一站式方案。
核心能力¶
Hana Research 涵盖了从文献管理到学术写作的全流程：
- 文献发现：支持 OpenAlex、Crossref、arXiv 和 PubMed 四大来源检索，支持 AI 解读、保存检索与期刊同步。
- 项目组织：提供项目库、文献角色、阅读状态与优先级管理，支持跨文献关系与下一步建议。
- PDF 精读：三栏阅读器，支持目录/缩略图/搜索、彩色批注、逐页定位与结构化摘录。
- 系统综述：内置 PRISMA、GRADE、RoB 2 等系统综述工具，支持双阶段筛选、双人独立判断与冲突仲裁。
- 证据综合：支持自定义研究编码、RoB 2/ROBINS-I、GRADE、证据矩阵与论证链。
- 导出与协作：支持导出 Markdown、DOCX、PDF、CSV、BibTeX 等格式，提供 21 个 Harness Agent 工具。
安装与启用¶
使用该插件需要 DeepSeek Harness 的 web Profile，以及 Node.js 环境版本 >= 22.13.0。
安装命令如下：
dsh plugin --profile web add github:zhoupengyun572-cell/dsh-hana-research#v0.5.0-beta.1
安装完成后重启 Harness。插件会自动加入 web Profile。数据默认存储在 $DSH_HOME/plugin-data/hana-research/。
注意：卸载插件不会自动删除研究数据。
典型用法¶
以下是完成一个文献项目的基本步骤：
- 打开“项目库”，新建一个研究项目。
- 在项目中上传 PDF，或从“文献中心”检索并导入开放文献。
- 打开 PDF，选中文字创建批注或摘录；在右侧总结模板中整理研究问题、方法、结果与局限。
适用场景与注意¶
Hana Research 特别适合需要进行系统综述或证据综合的研究者。
- 系统综述：如果需要进行严谨的系统综述，该插件提供的 PRISMA、GRADE 和 RoB 2 工具能辅助完成筛选、编码与质量评定。
- 本地优先：所有数据默认存储在本地，适合对数据隐私有要求的场景。
- 平台限制：Windows 已完成完整支持；Ubuntu 仅有自动化 CI，暂无完整 GUI 人工验收。
当前版本为 beta 版，插件以 DSH 进程权限运行，安装前建议检查源码与许可证（MIT）。
