返回目录

文件与数据插件

dsh-hana-research

zhoupengyun572-cell/dsh-hana-research

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

查看仓库

Stars: 1
Forks: 0
Issues: 0
更新: 7 天前

PROJECT TOPICS

项目标签

academic-research deepseek-harness dsh-plugin literature-review pdf-annotation

INSTALL REFERENCE

安装参考

未验证

dsh plugin --profile web add github:zhoupengyun572-cell/dsh-hana-research

在 DSH 中安装

该命令指向仓库当前默认分支；尚无绑定当前 commit 的完整验证结果。

PROJECT README

README

DSH Hana Research

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

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

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

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

它解决什么问题

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

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

核心能力

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

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

界面预览

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

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

安装

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

dsh plugin --profile web add github:zhoupengyun572-cell/dsh-hana-research#v0.5.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

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

三分钟开始使用

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

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

本地数据与安全边界

数据默认存放在 $DSH_HOME/plugin-data/hana-research/，包括 SQLite research.db、PDF、翻译与项目笔记。
当前数据库为 schema v22；升级前会在需要时保留迁移快照。
新安装默认是空数据库，不自动携带作者项目或演示文献。
写入型 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 仍处开发者预览期，因此暂不承诺跨所有预览版本的稳定兼容。

文档

用户使用指南：快速上手、工作流、功能树、FAQ 与备份恢复
插件技术总览：架构、能力矩阵、数据模型、API 与 Agent 工具
更新日志
安全政策
贡献指南
第三方许可证

开发与验证

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，并验证发布包白名单和体积上限。

反馈与贡献

Bug：提交问题
功能建议：提交功能请求
安全问题：请遵循安全政策，不要在公开 Issue 中披露敏感细节。

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

License

CLASSIFICATION EVIDENCE

分类依据

项目类型插件

功能分类文件与数据

规则置信度高

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中： academic-research、literature-review、pdf-annotation。