DeepSeek Harness Plugin

863683348/dsh-plugin-academic-writing

Stars ★ 2 Downloads (30d) 2,054 Category Tools & Capabilities Added 2026-08-17 npm dsh-plugin-academic-writing

Academic writing toolkit for DSH agents: paper outlines, title and abstract skeletons, GB/T 7714 / APA / MLA citations, phrasing QA, and a pre-submission checklist.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-plugin-academic-writing

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:863683348/dsh-plugin-academic-writing

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

An academic writing toolkit for DeepSeek Harness agents. The model composes the prose; the plugin supplies structure, formats, and deterministic checks.

Compatibility

Tool schemas are validated against the @deepseek-ai/dsh-tools value-schema DSL at plugin load (checked against dsh-tools 0.1.0-rc.6 and 0.1.1-rc.2). Earlier releases used JSON-Schema required at the root of output.schema and closed nested objects without declared properties, which made the host abort the whole profile boot with unsupported JSON schema: schema.required is not supported by the value schema DSL and could reject the tool's own results. Current releases fix both; if an affected version left your DSH unable to start, remove the plugin from the profile (or upgrade) — no data is lost.

Install

dsh plugin --profile <profile> add dsh-plugin-academic-writing

Restart DSH. The academic_writing tool is registered host-wide.

Tool

action purpose
outline Paper outline skeleton (research / review / proposal / essay), optional section cap
title Title variants from style templates (descriptive, question, declarative, colon)
abstract Structured abstract skeleton — background / methods / results / conclusion
citation Reference entry formatted as GB/T 7714, APA 7, or MLA 9
check Phrasing QA on a passage (passive voice, first person, hedging, sentence length)
checklist Pre-submission checklist (ethics, conflict of interest, data, funding, formatting)
references Reference list from citation entries — deduplicated and sorted (GB/T 7714 / APA / MLA)
latex LaTeX snippets: booktabs table, equation (inline/display/align), code listing, thebibliography
structure Manuscript structure check — heading levels, paragraph budget, outline coverage
glossary Term/abbreviation glossary with first-occurrence definitions

Config

All optional, on the composition row's config:

key default meaning
personaSection true register the academic prompt-guidance section
sectionOrder 6 prompt section order (persona is 0, ascending)

Design

Pure logic (lib/academic.js) has zero DSH/Cordis imports and is unit-tested in isolation; lib/index.js is the thin Cordis plugin wiring the tool and the prompt section. No filesystem access — everything is deterministic and side-effect free.

License

MIT

Roadmap

See ROADMAP.md — next five versions (v0.2.0 – v0.6.0): reference management, structure QA, expression risk, journal adaptation, review workflow.

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.