dsh-plugin-academic-writing

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.