GeoResearch for DeepSeek Harness

English | 中文

GeoResearch is an evidence-grounded scientific research agent plugin for DeepSeek Harness. It turns a research question, a set of papers, source repositories, and scientific data into a persistent, auditable workflow for literature review, reproduction, geospatial experiments, validation, and manuscript preparation.

Current release: 0.1.0 is available from npm and the public GitHub repository. The release was built from the annotated v0.1.0 tag, and all 26 npm packages include registry provenance.

GeoResearch targets DeepSeek Harness 0.1.0-rc.5 and implements a DSH Standard Community v0.15 Host component. See the compatibility matrix for the exact supported environment.

What GeoResearch Does

GeoResearch is designed for research work that must remain inspectable after the conversation ends. It stores the important parts of a project as typed, versioned records instead of relying only on chat history.

Research brief
  -> literature, papers, files, and repositories
  -> reproduction plans and experiments
  -> independent validation
  -> user-approved claims
  -> writing packet and manuscript

The Coordinator can delegate bounded work to literature, experiment, review, and writing specialists, but Host services remain responsible for authoritative project state, formal runs, evidence, validation, claims, and final deliverables.

Core Capabilities

Automatic image and document-image understanding uses deepseek-v4-flash-vision-exp when a managed DEEPSEEK_API_KEY is available. Native-model vision and local OCR remain explicit fallbacks. Instructions found inside uploaded images are always treated as untrusted data.

Safety and Traceability

• Candidate work and authoritative records are separated. A specialist cannot silently turn its own output into accepted evidence, a formal result, or a scientific claim.
• Project records, artifacts, runs, evidence, reviews, claims, and writing packets are content-bound and checked before downstream use.
• Repository access is read-only. Experiment execution is bounded and runs through managed services instead of exposing a generic shell entry point.
• Installation, upgrade, recovery, verification, and uninstall are explicit operations. The installer does not use postinstall and does not modify the DeepSeek Harness source tree.
• Session telemetry is disabled in the managed GeoResearch runtime.

The exact permissions and standard component identity are documented in DSH Standard conformance.

Requirements

Close running DeepSeek Harness processes before installing, upgrading, recovering, or uninstalling GeoResearch. The default Harness home is %USERPROFILE%\.dsh; set DSH_HOME or pass --dsh-home to use another path.

Get GeoResearch

Install from npm

Use the exact installer version so the managed distribution remains pinned:

$dshHome = Join-Path $env:USERPROFILE '.dsh'
npx --yes @georesearch/dsh-installer@0.1.0 install --dsh-home $dshHome
npx --yes @georesearch/dsh-installer@0.1.0 verify --dsh-home $dshHome

The self-contained installer carries the complete GeoResearch distribution. It does not require this repository, a separate package installation, or a --distribution-dir. Release assets and checksums are available on the v0.1.0 release page.

Build from source

Clone the public repository if you are developing GeoResearch or need to audit the complete source and release gate:

Clone the repository with GitHub CLI:

gh repo clone georesearch-dsh/georesearch-dsh
cd georesearch-dsh

Or use Git directly after configuring GitHub authentication:

git clone https://github.com/georesearch-dsh/georesearch-dsh.git
cd georesearch-dsh

Prepare the workspace and build the managed distribution:

corepack enable
corepack prepare pnpm@11.7.0 --activate
pnpm install --frozen-lockfile
pnpm run distribution

Install and verify the locally built distribution:

$dshHome = Join-Path $env:USERPROFILE '.dsh'

node packages/installer/lib/cli.js install `
  --dsh-home $dshHome `
  --distribution-dir dist\distribution `
  --harness-root C:\path\to\deepseek-harness

node packages/installer/lib/cli.js verify --dsh-home $dshHome

Replace C:\path\to\deepseek-harness with the supported Harness source checkout. The installer integrates GeoResearch into every existing Web Profile that contains @deepseek-ai/dsh-web-app and also creates a managed georesearch diagnostic Profile.

First Run

Start an installed Web Profile:

dsh --profile web

You can also start the managed diagnostic Profile:

dsh --profile georesearch

In the Web UI:

1. Open Settings -> Models, configure a DeepSeek model and save the API credential.
2. Choose the workspace that will contain the research project and its deliverables.
3. Start a new session with the GeoResearch preset.
4. Describe the research question and attach any papers, datasets, images, or repositories that should form the initial evidence base.

Example requests:

Create a research brief for evaluating urban heat-island change from
multi-temporal satellite imagery. Identify the evidence and data still needed.

Search the literature for validation strategies for spatially autocorrelated
remote-sensing models, then register the strongest sources in this project.

Inspect the attached GeoTIFF files, compare their CRS and resolution, and
propose a reproducible experiment. Do not run it until I approve the plan.

Audit this paper and repository, build a reproduction plan, and separate
verified findings from claims that still require review.

Operations

The installer supports install, upgrade, verify, recover, and uninstall. Use verify after installation, after a Harness repair, and before an upgrade. Use recover after an interrupted mutating operation instead of manually deleting transaction files.

See Installation and Operations for the complete procedures and recovery rules.

Documentation

• Installation and Operations
• Compatibility Matrix
• Attachment and visual-model boundary
• DSH Standard conformance
• Provider extension guide
• Release gate and verification evidence
• v0.1.0 release notes

Development

pnpm install --frozen-lockfile
pnpm run build
pnpm test
pnpm run dsh-std:check

Maintainers can run the complete release-candidate gate from a clean Git worktree:

pnpm run release:gate

The gate performs deterministic tests, Windows functional probes, scientific golden tests, DSH Standard validation, live release evidence, package linting, and npm publish --dry-run for all release packages. It writes the release manifest and checksums but never publishes or uploads a package.

License

MIT