前言¶
DeepSeek Harness (DSH) 采用了插件化架构，旨在通过单一插件解决特定领域的复杂工作流。在学术写作领域，从零散材料到一篇经得起查重与答辩的论文，往往涉及大量琐碎的步骤和跨会话的信息管理。dsh-thesis 是一个由 Paloma966 维护的毕业论文全流程插件。它不直接生成论文，而是通过“先追问、再动手”的逻辑，把模糊的论文要求转化为可证伪的《意图规格》，并按九个阶段推进选题、开题、文献、设计、实现、测试、论文、合规、答辩。
该插件的核心价值在于“留痕”与“控制”。它要求每一步决定必须由用户拍板，通过九阶段目录、进度台账、决定日志、检索记录和检查报告，确保论文生成过程的可追溯性。它不依赖云端查重系统，所有检查均在本地完成。
核心功能¶
插件提供了一系列命名空间下的工具，覆盖论文全生命周期：
- 材料与意图：
thesis_ingest负责将 docx/xlsx/pptx/pdf/md/csv 及代码等材料转化为文本与结构摘要；thesis_intake逐题追问，将材料转化为意图规格。 - 工作流管理：
thesis_init建立工作区；thesis_progress生成九阶段目录与台账；thesis_decide记录决定日志与关卡，未通过 G1-G4 关卡禁止推进。 - 文献检索：
thesis_lit_search执行检索；thesis_lit_save保存结果；thesis_lit_note记录笔记。插件严格限制引用来源，只认真实检索缓存。 - 写作与合规：
thesis_review逐章评审；thesis_check进行全文五项检查；thesis_stylecheck进行去 AI 味自查；thesis_build生成 Word 文档；thesis_originality进行本地原创性自查与降重。 - 答辩准备：
thesis_defense进行答辩演练；thesis_slides生成 Marp 兼容幻灯；defense_code_*提供代码演练能力。 - 跨会话记忆：
fact_search、fact_remember、fact_context利用 SQLite 数据库记住学校规范、导师要求和写作偏好，并在相关时自动回填上下文。
安装与启用¶
从源码安装时，需要先克隆仓库并构建，因为 DSH 不支持直接加载 TypeScript 源码：
git clone https://github.com/Paloma966/dsh-thesis.git && cd dsh-thesis && npm install && npm run build
构建完成后，可以通过 DSH 的插件管理器安装，或在配置文件中引用构建后的目录：
dsh plugin --profile web add "$PWD"
注意：升级 DSH 后可能出现“装了但没反应”的情况，这是因为宿主会校验 package.json 中的 peerDependencies，不满足时会静默禁用插件。本插件声明依赖 >=0.2.0-rc.2 <0.3.0-0。
使用示例¶
安装并重启 DSH 后，即可开始使用。
- 初始化对话：在对话中输入指令启动工作流。
这是我的论文材料，帮我做毕业设计
插件会自动执行 `thesis_ingest`（读材料）、`thesis_intake`（追问成意图规格）、`thesis_init`（建工作区）。
- 工作区定位：为了省事，建议将 DSH 的会话目录（cwd）直接设置在论文项目的根目录下。插件会自动向上探测
00-管理/进度台账.md来定位工作区。也可以在配置中显式指定：
{ "workspace": "/path/to/你的论文" }
- 阶段性推进：在九个阶段（选题 → 开题 → 文献 → 设计 → 实现 → 测试 → 论文 → 合规 → 答辩）中，通过调用对应工具或斜杠命令（如
/thesis-decide）来推进进度。
限制与边界¶
插件在设计上设定了若干护栏，以防止误用和生成虚假内容：
- 零假文献与数据：引用只能来自真实检索缓存；实验数据必须来自真实运行；
thesis_originality明确禁止为降重而改动数据与结论。 - 规范为准：所有规范以学校文件为准。如果模板缺失，会使用内置过渡模板并显式标注「非学校模板」，绝不假装合规。
- 数据安全：读取失败时工具会抛错并保持原文件不动，绝不用默认值覆盖，不静默销毁数据。
- 技术限制：
- PDF：是尽力而为，扫描版或加密 PDF 可能无法提取文字。
- 旧格式：不支持
.doc/.xls/.ppt，需先另存为新格式。 - 幻灯生成：不自研生成器，只产出 Marp 兼容 Markdown。
- 子进程：pandoc/marp/git 等子进程不可取消，有超时但无信号传递。
- 代码演练：内置语言矩阵为 Go/TS/Python/Rust，其余语言需在配置中补全
gates。
配置¶
所有配置项都有默认值，可以在 cordis.patch.yml 中覆盖。以下是一个关键配置示例：
- id: paper
name: dsh-thesis
config:
workspace: /path/to/thesis
memoryPath: /path/to/paper-memory.db
similarity: { shingle: 4, threshold: 0.3 }
ppt: { engine: auto }
writingGate: true
destructiveGate: true
总结¶
dsh-thesis 是一个为毕业设计全流程提供结构化支持的工具。它通过严格的关卡控制和本地化检查，帮助开发者从材料到成品论文进行闭环管理。对于需要处理大量文献、代码和规范文档的论文场景，它提供了可复现的工作流路径。
