863683348/dsh-plugin-academic-writing

DeepSeek Harness智能体的学术写作工具包:论文大纲、标题/摘要框架、GB/T 7714/APA/MLA引文格式、措辞质量检查,以及投稿前检查清单。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), designed as an academic writing toolkit that provides structure, formatting rules, and deterministic checks for LLM-generated academic text. To install the plugin, you run the command dsh plugin --profile <profile> add dsh-plugin-academic-writing via DSH's CLI, then restart DSH to activate the globally registered academic_writing tool. The current release fixes a JSON schema compatibility bug that caused DSH to fail to boot in older versions, so users experiencing startup issues just need to upgrade or remove the old version to resolve the problem.

The plugin is targeted at students and researchers who need to write academic papers, literature reviews, research proposals, or essays, and supports assistance through the entire process from initial outline to pre-submission checks. It offers a wide range of tools including outline generation for different academic document types, title variant generation from style templates, structured abstract skeletons, formatted citations, phrasing QA, pre-submission checklists, and more. Users can pick and choose the tools they need at each stage of their writing project to standardize output and meet common academic publishing requirements.

The plugin is structured to separate pure business logic from DSH integration code: the core logic in lib/academic.js has zero DSH or Cordis imports and is unit-tested in isolation, while lib/index.js acts as a thin Cordis plugin that wires the tool and prompt section to DSH. It has no filesystem access at all, all operations are deterministic and completely side-effect free. All configuration options are optional, so users can choose whether to enable the academic prompt guidance section and adjust its display order as needed. The plugin is released under the permissive open-source MIT license, with no restrictions on personal or commercial use.

这是一个专为 DeepSeek Harness(DSH)打造的原生插件,是面向学术写作的工具包,核心作用是为大语言模型生成学术文本提供结构化框架、格式规范和确定性校验。用户可以通过 DSH 命令行工具执行一键安装命令,将插件添加到指定配置文件中,重启 DSH 后就会全局注册 academic_writing 工具供调用。当前版本已经修复了旧版本存在的JSON schema兼容性问题,不会导致DSH启动失败。

该插件面向需要撰写学术论文、综述、开题报告或课程论文的学生与科研人员,支持从大纲骨架生成到终稿提交前全流程的辅助写作工作。用户可以按需生成不同类型的大纲骨架、多种风格的标题变体、结构化摘要框架,还能按照GB/T 7714、APA 7、MLA 9三种格式生成参考文献条目和整理去重排序后的参考文献列表。此外还可对文本措辞进行质量检查,生成投稿前的合规检查清单。

插件核心逻辑完全独立,没有引入DSH或Cordis相关依赖,并且做了单元测试,仅通过一层薄薄的Cordis插件代码完成工具和提示区域的绑定,没有文件系统访问操作,全程无副作用、结果确定。所有配置均为可选,用户可以自行选择是否开启学术提示引导部分,也可调整提示区域的排序。插件采用MIT许可协议开源,免费供个人和商业使用。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 863683348/dsh-plugin-academic-writing 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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.

← 上一个 Prev dsh-skills-viewer 下一个 Next dsh-context-provenance →