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.
