前言¶
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 是一個爲畢業設計全流程提供結構化支持的工具。它通過嚴格的關卡控制和本地化檢查，幫助開發者從材料到成品論文進行閉環管理。對於需要處理大量文獻、代碼和規範文檔的論文場景，它提供了可復現的工作流路徑。
