← Back to home@zhoupengyun572-cell

dsh-hana-research

A local literature review, PDF annotation, evidence synthesis, and research notes workbench for DeepSeek Harness.

Stars
1
Language
JavaScript
Created
Aug 28, 2026
Updated
Aug 29, 2026
Web UI
GitHub repo

Introduction

DSH Hana Research

为心理学与社会科学研究打造的本地优先文献工作台
在 DeepSeek Harness 中完成文献发现、PDF 精读、证据整理、系统综述与研究写作。

Release CI MIT License Node.js 22.13+ DeepSeek Harness plugin

中文 · English · 使用指南 · 问题反馈

Hana Research 阅读工作台：PDF、批注与结构化文献笔记

[!IMPORTANT] 当前版本为 0.4.0-beta.1，面向 DeepSeek Harness 开发者预览版。Windows 已完成真实端到端验收；Ubuntu/Windows × Node 22/24 已通过自动化 CI。

它解决什么问题

研究资料经常散落在检索网页、PDF 阅读器、表格和笔记软件中。Hana Research 把这些环节收进同一个可追溯工作流：

  1. 从 OpenAlex、Crossref、arXiv 和 PubMed 发现文献，或直接上传本地 PDF。
  2. 按研究问题建立项目，让每篇文献、批注、任务和笔记都有明确归属。
  3. 在三栏阅读器中精读 PDF，把高亮、原文摘录和研究者判断连接到具体页码。
  4. 需要系统综述时，再展开双阶段筛选、PRISMA、研究编码、偏倚风险和 GRADE。
  5. 导出项目笔记、证据矩阵、引文和带批注 PDF，并把当前上下文交给 Harness Agent 协作。

核心能力

工作阶段Hana Research 提供什么
文献发现四源并发检索、AI 解读、保存检索、新结果提醒、期刊同步、自定义期刊源
项目组织项目库、文献角色、阅读状态、优先级、研究任务、跨文献关系与下一步建议
PDF 精读目录/缩略图/搜索、彩色批注、逐页定位、阅读进度、结构化摘录与文献总结
系统综述纳排标准、题录/摘要与全文双阶段筛选、双人独立判断、冲突仲裁、PRISMA 2020
证据综合自定义研究编码、RoB 2 / ROBINS-I、GRADE、证据矩阵与论证链
导出与协作Markdown、DOCX、PDF、CSV、XLSX、BibTeX、RIS；20 个 Harness Agent 工具

系统综述工具采用渐进披露：如果你只想收藏、阅读和记笔记，可以跳过筛选、编码与质量评定。

界面预览

Hana Research 项目库
项目库：每个研究问题拥有独立的文献、PDF、任务和笔记空间。 		Hana Research 项目概览
项目概览：聚焦下一步、最近活动和证据缺口，避免把所有工具堆在首屏。
Hana Research 系统综述与项目文献
证据工作流：按需展开筛选、数据提取和质量评定。 		Hana Research PDF 阅读工作台
阅读工作台：原文、批注与结构化文献笔记保持同屏并可回到来源页。

截图使用合成演示 PDF 与公开书目信息，不包含真实用户项目或私人研究数据。

安装

需要已安装的 DeepSeek Harness 和 web Profile。推荐固定到已发布标签：

dsh plugin --profile web add github:zhoupengyun572-cell/dsh-hana-research#v0.4.0-beta.1

安装完成后重启 Harness。插件会通过包内 dsh.bundle 自动加入 web Profile，无需手工编辑配置。

也可以从 GitHub Release 下载 .tgz。发布包 SHA-256：

437495d420fdff5268d8fb5431a06b8f7afcb7702ae4aa7133531f6bd9b2a8e7

更新与卸载：

dsh plugin --profile web update dsh-hana-research
dsh plugin --profile web remove dsh-hana-research

卸载插件不会自动删除研究数据。

三分钟开始使用

  1. 打开“项目库”，新建一个研究项目。
  2. 在项目中上传 PDF，或从“文献中心”检索并导入开放文献。
  3. 打开 PDF，选中文字创建批注或摘录；在右侧总结模板中整理研究问题、方法、结果与局限。

完整流程、快捷键和系统综述说明见用户使用指南。

本地数据与安全边界

  • 数据默认存放在 $DSH_HOME/plugin-data/hana-research/，包括 SQLite research.db、PDF、翻译与项目笔记。
  • 当前数据库为 schema v19；升级前会在需要时保留迁移快照。
  • 新安装默认是空数据库，不自动携带作者项目或演示文献。
  • 写入型 Agent 工具需要用户确认，并由 Harness approval 与本地审计记录约束。
  • 联网检索、开放 PDF 下载、AI 解读与翻译的目标域名和限制见安全政策。
  • 生产依赖无已知高危/严重漏洞；剩余上游告警与平台验证边界在安全政策中如实披露。

兼容性与已知限制

  • Node.js >=22.13.0；Harness 实机基线为 @deepseek-ai/dsh-tools 0.1.0-rc.13，CI 使用可公开安装的 0.1.1-rc.2 回归。
  • Windows 已完成安装、阅读、批注、导出、更新和卸载闭环；Ubuntu 当前只有自动化 CI，没有完整 GUI 人工验收。
  • UI 当前以简体中文为主。
  • Harness 仍处开发者预览期，因此暂不承诺跨所有预览版本的稳定兼容。

文档

开发与验证

npm ci
node scripts/run-tests.mjs

cd web
npm ci
node --test tests/*.test.mjs
npm run build

完整测试基线：根测试 167/167、阅读器编辑器测试 13/13。公开 CI 覆盖 Ubuntu/Windows × Node 22/24，并验证发布包白名单和体积上限。

反馈与贡献

欢迎先阅读贡献指南。提交问题时请附 Harness/Node 版本、操作系统、复现步骤和必要的脱敏日志。

License

MIT © 2026 Hana Research contributors