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