前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」，这为构建垂直领域的专业工具提供了基础。论文写作与答辩是一个高度依赖流程管控与事实核查的复杂任务。传统的生成式工具往往忽略格式规范、查重率与实验数据的真实性，导致产出物无法直接使用。
dsh-thesis 是 DSH 的一个单一插件，旨在通过结构化的工作流与人工关卡，解决「材料杂乱、流程断裂、假文献与假数据泛滥」的问题。它不提供通用的写作辅助，而是提供一套完整的论文工程化解决方案。
插件简介¶
名称：dsh-thesis
维护者：Paloma966
许可证：MIT
核心价值：把一堆材料变成一篇经得起查重与答辩的论文，和一个讲得清自己系统的你。
该插件将论文写作拆解为九个阶段：选题 → 开题 → 文献 → 设计 → 实现 → 测试 → 论文 → 合规 → 答辩。全程强制执行「零假文献」与「零假数据」原则，并要求用户在关键节点（G1-G4）进行人工确认。
核心功能¶
插件覆盖论文全生命周期的工具链，主要包含以下能力：
- 材料与意图处理：材料摄取（支持 docx/xlsx/pptx/pdf/md/csv 代码）、逐题追问（
thesis_intake）、工作区初始化。 - 进度与关卡管理：进度台账、G1-G4 人工闸门（不可跳过）、决定日志记录。
- 真实文献与合规：真实文献检索（Semantic Scholar/DBLP/arXiv/Crossref）、文献管理（GB/T 7714）、章节与全文检查、原创性自查（本地估算）。
- 产出物生成：Word 文档生成（内置生成器或 pandoc）、答辩幻灯生成（Marp 兼容）、代码演练（
defense_code_*）。 - 跨会话记忆：通过 SQLite 事实库记住学校规范、导师要求与写作偏好。
工作流¶
插件采用「先追问、再动手」的策略，避免方向性错误。
- 材料摄取 (
thesis_ingest)：读取用户提供的论文材料、学校模板、实验数据与代码，生成材料清单与文本摘要。 - 逐题追问 (
thesis_intake)：一次只问一个问题，确保意图规格（00-管理/意图规格.md）清晰、可证伪。材料中已能读出的信息不再重复提问。 - 工作区初始化 (
thesis_init)：根据意图规格建立论文工作区，包含九阶段目录结构、台账、技能包。 - 九阶段流水线：按顺序推进论文写作，每一步都生成留痕记录。
- 最终产出：生成 Word 论文、答辩幻灯、原创性自查报告及代码演练脚本。
安装与启用¶
安装该插件需要环境中有 pnpm。
# 安装插件
dsh plugin --profile web add dsh-thesis
# 重启 DSH 进程
# ...
安装完成后，重启 DSH，插件会注册三个命名空间：
* thesis_*：论文工作区操作
* fact_*：跨会话事实记忆
* defense_code_*：答辩代码演练
典型用法¶
在 DSH 对话中，通过自然语言触发工作流：
这是我的论文材料，帮我做毕业设计
随后，工具会自动执行以下步骤：
1. 读取材料。
2. 进入 thesis_intake 模式，逐题询问缺失信息（如字数要求、查重阈值、时间线）。
3. 生成 00-管理/意图规格.md。
4. 初始化论文工作区。
工作区定位：多数工具会向上探测 00-管理/进度台账.md 来定位工作区。建议将会话目录设为论文根目录，或通过配置显式指定。
命令与工具¶
插件提供 21 个工具及 9 个斜杠命令。主要工具如下：
论文工作区 (thesis_*)¶
thesis_progress：管理进度台账与 G1-G4 闸门。thesis_check：全文检查（引用一致性、字数、图表编号）。thesis_build：生成 Word 文档，支持内置零依赖生成器。thesis_originality：本地原创性自查与改写建议。thesis_defense/thesis_slides：准备答辩素材与幻灯片。
跨会话事实 (fact_*)¶
fact_remember/fact_context：将学校规范、导师要求存入 SQLite 事实库，并在相关对话中自动注入上下文。
代码演练 (defense_code_*)¶
- 提供一系列命令（
status,next,update）将系统拆解为模块，通过真实验证门逐个走通，确保答辩时能讲清实现细节。
红线与限制¶
为了保证产出质量，插件内置了多项硬性约束：
- 零假文献：正文引用仅允许来自
thesis_lit_search的真实检索缓存，thesis_lit_save拒绝缓存外的 ID。 - 零假数据：实验数据与运行结果必须来自真实运行，不支持伪造。
- 人工关卡强制：G1-G4 阶段闸门必须通过，不可跳过，确保用户对每一步负责。
- 格式兼容性：PDF 抽取为尽力而为，扫描版或加密 PDF 可能无法读取；旧格式（.doc/.xls/.ppt）不支持，需另存为新格式。
- 原创性自查范围：本地估算，不接收费查重系统（知网/维普），结果仅供参考，需自行送检。
结语¶
dsh-thesis 不是简单的文本生成器，而是一个强制规范、拒绝幻觉的论文工程化插件。它通过结构化的流程与严格的事实核查，将论文写作从「拼凑」转变为「构建」。如果你需要一份逻辑严密、数据真实且符合规范的论文产出，该插件提供了必要的约束与工具。
