前言¶

在 DeepSeek Harness 插件生態中，通用寫作技能往往難以在本地可靠地維護論文寫作的規則和全局狀態。dsh-thesis 旨在解決這一語境限制問題，爲本地論文寫作提供結構化的狀態管理和嚴格的權限驗證。

插件介紹¶

這是一個用於論文輔助寫作的 DeepSeek Harness 插件。它由 haoyuan-sjtu 維護，旨在通過項目級語境管理、結構化 JSON 捕獲與審查命令，以及全局狀態維護，輔助完成論文寫作任務。

核心功能¶

• 論文輔助寫作語境管理：維護項目範圍內的寫作規則和上下文。
• 結構化 JSON 捕獲與審查：提供 /thesisflow-capture 和 /thesisflow-review 命令，用於提交數據和審查候選記錄。
• 項目級語境與全局狀態：在項目範圍內保持狀態一致性。
• 隔離記錄狀態：新記錄默認以 quarantine（隔離）狀態寫入。
• 嚴格範圍與隱私驗證：對訪問權限和隱私策略進行校驗。

安裝與啓用¶

安裝插件到指定的 DSH profile 後需要重啓該 profile。

1. 安裝插件：
   使用官方安裝命令將倉庫添加到 profile：

    dsh plugin --profile web add https://github.com/haoyuan-sjtu/dsh-thesis.git

若需在 headless profile 中安裝，請將 `web` 替換爲 `headless`。

2. 配置項目文件：
   在啓動 profile 的環境變量中設置 THESISFLOW_PROJECT_CONFIG，指向 thesisflow.yaml 的絕對路徑。該文件包含非敏感元數據和項目相對的註冊表路徑。

典型用法¶

配置完成後，可通過以下方式使用插件：

1. 項目配置示例：
   在 thesisflow.yaml 中配置項目元數據：

    projectId: thesis-2026-example
    language: zh-CN
    field: computer-science
    chapterIds: [ch1, ch2, ch3]
    defaultScope: project
    privacyPolicy: project_confidential
    contextTokenBudget: 1200
    registryPath: .thesisflow/registry.json

2. 任務路由：
   使用 /thesisflow-route <task description> 命令對任務進行分類，獲取論文建議、所需輸入及預期輸出。

3. 數據捕獲：
   使用 /thesisflow-capture <JSON candidate> 命令提交結構化數據。

4. 記錄審查：
   使用 /thesisflow-review <JSON action> 命令對隊列中的記錄進行批准、拒絕或撤銷等操作。

適用場景與注意¶

• 適用場景：適合需要在本地環境中嚴格管理論文寫作上下文、規則和狀態的用戶。
• 權限限制：批准命令默認禁用。只有當 Host 在插件配置中提供了 principalResolver 時，批准命令纔會啓用。principalResolver 必須返回經過 Host 驗證的身份，否則失敗閉包。
• 狀態變更限制：自由文本、模型輸出以及未經驗證的實體無法更改記錄狀態。
• 功能邊界：該插件不支持 Web UI、團隊/用戶範圍、雲同步、外部命令執行、學校提交或 Humanize 集成。
• 安全警告：插件以 DSH 進程權限運行。在安裝前，請務必檢查源碼與許可證。

結語¶

dsh-thesis 通過提供結構化的命令接口和嚴格的權限管理，幫助開發者處理論文寫作中的複雜狀態邏輯。插件目錄：https://www.skillhub.cn/plugins/haoyuan-sjtu/dsh-thesis。源碼倉庫：https://github.com/haoyuan-sjtu/dsh-thesis。