dsh-hana-research

DSH Hana Research

A local-first literature workspace for psychology and social-science research
Discover papers, read and annotate PDFs, organize evidence, conduct systematic reviews, and collaborate with a DeepSeek Harness agent.

中文 · English · User guide (Chinese) · Issues

[!IMPORTANT] 0.5.0-beta.1 targets the DeepSeek Harness developer preview. The full workflow has been validated on Windows; automated CI covers Ubuntu/Windows with Node.js 22 and 24.

What it does

Hana Research keeps literature discovery, PDFs, notes, screening decisions, and evidence exports in one traceable workspace:

1. Search OpenAlex, Crossref, arXiv, and PubMed, or upload a local PDF.
2. Create a project for each research question so papers, tasks, and notes have a clear home.
3. Read in a three-pane PDF workspace where annotations and researcher interpretations remain linked to a page.
4. Expand systematic-review tools only when needed: two-stage screening, PRISMA, structured coding, risk of bias, and GRADE.
5. Export notes, evidence matrices, citations, and annotated PDFs, or hand the current structured context to a Harness agent.

Capability map

The systematic-review modules use progressive disclosure. You can skip them when you only need a paper library, reader, and notes.

Product tour

The screenshots use a synthetic demonstration PDF and public bibliographic metadata. They contain no private user projects or research data. The current UI is Chinese-first.

Install

Install DeepSeek Harness first, then pin the plugin to the published tag:

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

Restart Harness after installation. The packaged dsh.bundle activates Hana Research in the web profile without manual configuration edits.

The same package is available from the GitHub Release. SHA-256:

437495d420fdff5268d8fb5431a06b8f7afcb7702ae4aa7133531f6bd9b2a8e7

Update or remove it with:

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

Removing the package does not delete the research database.

Data and security

• Data stays under $DSH_HOME/plugin-data/hana-research/: SQLite research.db, PDFs, translations, and project-note files.
• The current database is schema v22. Migrations preserve a snapshot when required.
• A new installation starts empty; author projects and demonstration papers are never seeded by default.
• Agent write tools require user confirmation and remain subject to Harness approval and local audit records.
• Network destinations, PDF download restrictions, and remaining dependency risks are documented in SECURITY.md.

Compatibility and limitations

• Node.js >=22.13.0; Harness baseline @deepseek-ai/dsh-tools 0.1.0-rc.13, with public CI against 0.1.1-rc.2.
• Windows has completed the install/read/annotate/export/update/remove workflow. Ubuntu currently has automated CI coverage but no full GUI acceptance pass.
• The UI is currently Simplified Chinese-first.
• DeepSeek Harness remains a developer preview, so compatibility across every preview build is not guaranteed.

Documentation

• User guide — quick start, workflows, feature tree, FAQ, backup and recovery (Chinese)
• Plugin overview — architecture, capabilities, data model, APIs, and agent tools (Chinese)
• Changelog
• Security policy
• Contributing
• Third-party notices

Development

npm ci
node scripts/run-tests.mjs

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

The current baseline is 167/167 root tests and 13/13 reader-editor tests. CI also verifies the release-package allowlist and size budget.

Support and contribution

• Report a bug
• Request a feature
• For vulnerabilities, follow SECURITY.md and do not disclose sensitive details in a public issue.

Please include the Harness and Node versions, operating system, reproduction steps, and sanitized logs when reporting a problem.

License

MIT © 2026 Hana Research contributors