DSH Prompt Presets：DeepSeek Harness 的版本化提示词配置文件编辑器与编译框架

前言¶

DeepSeek Harness (DSH) 的核心优势在于其插件化架构，但对于提示词（Prompt）的管理，往往缺乏结构化的版本控制和组合能力。现有的做法通常依赖文本编辑器，难以追踪变更历史或在不同场景间复用片段。

dsh-prompt-presets 是一个内容无关的提示词配置文件编辑器、版本化编译器以及导入/导出框架。它不提供故事卡片或角色扮演引擎，而是专注于将提示词管理从纯文本操作转变为结构化的配置管理，支持通过 JSON 进行版本控制和组合。

插件介绍¶

这是一个由 LiweiDonVee 维护的独立社区项目。它为 DSH 提供了一套管理提示词配置文件的机制：用户可以在 Web 界面中编辑、分组、排序提示词片段，并通过版本控制保存变更。同时，它提供了编译器接口，允许运行时根据配置文件生成最终的提示词内容。

核心功能¶

版本化提示词编辑：支持对提示词配置进行版本保存与回溯。
组合：允许将多个提示词片段组合在一起使用。
SillyTavern JSON 导入/导出：支持导入和导出 SillyTavern 格式的提示词数据。
配置文件编辑器：提供可视化的 Web 界面用于管理配置文件。
编译器/API：提供 compileForAgent 和 compileForRender 接口，供运行时调用以生成提示词。
HTTP API：提供基于环回访问的 RESTful API，用于读取配置、验证和会话管理。

安装与启用¶

本插件依赖 Node.js 24、npm 以及 DSH 0.1.7-rc.2。

克隆仓库并安装依赖：

    git clone https://github.com/LiweiDonVee/dsh-prompt-presets.git
    cd dsh-prompt-presets
    npm ci
    npm run check

将插件安装到 DSH Web 配置文件中：

    npx --yes @deepseek-ai/dsh@0.1.7-rc.2 plugin --profile web add .

启动 Web 服务：

    npx --yes @deepseek-ai/dsh@0.1.7-rc.2 web

安装完成后，重启 DSH 主机。打开打印出的认证 URL，在 Settings → Prompt Presets 中，可以选择 Create blank profile 创建空白配置文件，或导入现有的 JSON 文件。

使用方法¶

安装完成后，数据目录默认位于 $DSH_HOME/prompt-presets（即 ~/.dsh/prompt-presets）。

配置文件管理¶

在 Web 界面中，你可以创建空白配置文件或导入 JSON 文件。界面支持中英文导航，你可以对提示词条目进行增删改、调整顺序、设置分组或角色。

运行时集成¶

该插件本身不会自动替换 DSH 的当前系统提示词。你的运行时代码必须主动调用提供的编译服务。

定义 prompt-manifest.json 文件，指定需要使用的配置文件 ID：

    {
      "schemaVersion": 1,
      "baseProfiles": [],
      "cardProfiles": [],
      "optionalProfiles": [],
      "defaultOverlay": { "enabledEntries": [], "disabledEntries": [] }
    }

在运行时调用编译方法，传入配置文件的绝对路径 (manifestPath) 和会话 ID (sessionId)：

    // 伪代码示意
    const result = ctx.promptPresets.compileForAgent(manifestPath, sessionId);

处理返回结果：返回值包含 profileHash、narrativeContract、sections、diagnostics 和 blocked。如果结果被 blocked，必须严格遵循（例如拒绝生成内容）。

HTTP API¶

插件提供了认证的本地 API 端点（/prompt-presets/api），支持以下操作：
* GET /catalog：获取配置文件目录。
* GET /profiles/:id：读取指定配置文件。
* PUT /profiles/:id：更新配置文件。
* POST /validate：验证配置文件。
* 导入/导出路由以及会话有效覆盖层路由。

注意事项与限制¶

不自动替换系统提示词：编辑器仅管理配置文件，不会自动修改 DSH 正在使用的系统提示词。需要运行时代码显式调用编译接口。
运行环境要求：本地 API 需要用户已登录 DSH 且具备环回访问权限。远程主机访问不被支持。
数据保留：卸载插件会停止编辑器和服务，但会保留用户配置文件数据。会话日志不会通过此插件迁移。
无内置内容：该插件不捆绑任何故事卡片、角色、写作预设或示例提示词包。初始数据目录为空。
兼容性：导入的 SillyTavern 数据在导出时会被保留，但本地脚本和扩展数据在运行时不会被执行。

结语¶

DSH Prompt Presets 为 DeepSeek Harness 提供了基础的提示词工程框架。如果你正在构建一个需要版本控制和结构化提示词管理的智能体，这是一个轻量级的工具。插件详情与源码可参考 GitHub 仓库。