dsh-plugin-academic-writing: DeepSeek Harness 学术写作工具包

前言¶

DeepSeek Harness (DSH) 的设计理念是「一切皆插件」，旨在通过模块化扩展智能体的能力。针对智能体在处理学术写作时，往往缺乏结构化辅助、引用格式不规范以及语言风格校验缺失的痛点，dsh-plugin-academic-writing 插件应运而生。该插件不负责生成最终段落，而是为模型提供论文骨架、格式规范和确定性检查逻辑，帮助开发者构建更规范的 Agent 工作流。

这是什么¶

这是一个为 DeepSeek Harness 智能体提供的学术写作工具包。由用户 863683348 维护，采用 MIT 许可证。它的核心价值在于将论文写作中的结构规划、引用格式化、LaTeX 代码生成以及语言风格校验封装为可复用的工具，解决智能体在撰写论文时缺乏标准模板和校验手段的问题。

核心功能¶

插件提供了十个核心工具，覆盖论文撰写的全流程：

大纲骨架 (outline)：生成论文大纲，支持 research、review、proposal、essay 等类型。
标题变体 (title)：根据风格模板生成标题（描述性、疑问句、陈述句、冒号式）。
摘要骨架 (abstract)：生成结构化摘要框架（背景、方法、结果、结论）。
引用格式化 (citation)：将参考文献条目格式化为 GB/T 7714、APA 7 或 MLA 9 标准。
语言风格校验 (check)：检查文本中的被动语态、第一人称使用、限定词和句子长度。
提交前检查清单 (checklist)：提供伦理、利益冲突、数据、资金和格式等方面的预审清单。
参考文献列表 (references)：根据条目生成参考文献列表，支持去重和排序。
LaTeX 代码片段 (latex)：提供 booktabs 表格、公式（行内/行间/对齐）、代码 listing 和 thebibliography 环境。
手稿结构检查 (structure)：检查标题层级、段落篇幅和大纲覆盖率。
术语表 (glossary)：生成术语和缩写表，包含首次出现的定义。

安装与启用¶

安装插件需要使用 DSH 的 CLI 工具：

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

安装完成后，必须重启 DSH 才能将 academic_writing 工具注册到全局。

典型用法¶

在 DSH 的 Composition Row 中，可以通过 config 参数调整行为，默认值如下：

{
  "config": {
    "personaSection": true,
    "sectionOrder": 6
  }
}

personaSection: 默认为 true，用于注册学术提示词引导部分。
sectionOrder: 默认为 6，控制提示词部分的顺序（persona 为 0，升序排列）。

调用时，智能体可以使用上述提到的 outline、title、citation 等工具进行协作。

设计原理与注意¶

插件核心逻辑位于 lib/academic.js，这是一个纯逻辑文件，不依赖 DSH 或 Cordis 的导入，且经过独立的单元测试。lib/index.js 仅作为 Cordis 插件的薄封装。

兼容性：工具模式已通过 @deepseek-ai/dsh-tools value-schema DSL 验证。早期版本在处理 JSON schema 的 required 属性时与 value-schema DSL 不兼容，可能导致 DSH 启动失败（报错 unsupported JSON schema: schema.required is not supported by the value schema DSL）。当前版本已修复此问题。如果受影响版本导致 DSH 无法启动，请移除插件或升级版本，数据不会丢失。
权限与副作用：插件运行时无文件系统访问权限，所有操作均为确定性的无副作用执行。

生态与结尾¶

DeepSeek Harness 强调插件化生态，本插件收录于社区目录 SkillHub，与 DeepSeek 或幻方官方无从属关系。

源码与文档: GitHub
目录页: SkillHub Catalog