前言¶

在 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。