提示词预设编辑器LiweiDonVee/dsh-prompt-presets

DSH 提示词预设 — 空框架

为 DeepSeek Harness 提供版本化的提示词编辑、组合以及 SillyTavern JSON 导入/导出。不捆绑或安装任何故事卡、角色、写作预设、示例提示词包或美术资源。 全新的数据目录以零配置文件开始。架构默认值是编辑器设置，而非预写的叙事内容。

安装

需要 Node.js 24、npm 和 DSH 0.1.2-rc.1。更高版本的主机未经验证。

git clone https://github.com/LiweiDonVee/dsh-prompt-presets.git
cd dsh-prompt-presets
npm ci
npm run check
npx --yes @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add .
npx --yes @deepseek-ai/dsh@0.1.2-rc.1 web

安装后重启主机，如果以本地链接方式安装则保留克隆，并打开其打印出的认证 URL。在 设置 → 提示词预设 中，选择 创建空白配置文件 或导入你有权使用的 JSON 文件。添加你自己的条目，编辑排序/分组/角色并保存为一个版本。界面包含英文和中文导航；在此预览版中，部分详细编辑标签仍为中文。

数据位于 $DSH_HOME/prompt-presets，默认为 ~/.dsh/prompt-presets。将此空框架安装到现有数据目录会保留用户创建/导入的配置文件；不会将其删除。升级前请备份该目录。

框架集成

此编辑器不会自动替换 DSH 的活动系统提示词。用户编写的 agent 运行时必须在提示词组装期间调用所提供的 ctx.promptPresets.compileForAgent() 服务，并在其单独的渲染阶段调用 compileForRender()，然后使用返回的各部分内容。本仓库提供该编译器/API，而非角色扮演引擎或完整的两阶段 agent。

运行时可以提供包含其自身配置文件 ID 的 prompt-manifest.json：

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

将其绝对路径 manifestPath、sessionId 以及任何 parentSessionId/模板变量传递给 compileForAgent。输出包含 profileHash、narrativeContract、sections、诊断信息和 blocked。严格调用方必须遵守被阻止的结果。会话会固定配置文件版本；覆盖层会影响下一次编译。一旦运行时创建了绑定，会话抽屉就会出现。没有绑定或配置文件意味着不会自动注入内容。

位于 /prompt-presets/api 的经过认证的环回 HTTP API 包括 GET /catalog、GET /profiles/:id、PUT /profiles/:id、POST /validate、导入/导出路由以及会话生效/覆盖路由。写入使用 expectedRevision；过期写入返回 409。完整的请求格式请参见 src/host/http.js 和测试。

兼容性与边界

- ST 提示词条目、禁用条目、顺序和未处理的扩展数据会被保留以支持往返转换。分组推断是启发式的，并非完整的 ST 运行时模拟。
- 支持有界标识符/变量宏。导入的 JavaScript、正则脚本和 Tavern Helper 数据会保留以供导出，但不会被执行。
- 本地 API 需要 DSH 登录以及回环访问。这些自定义端点不支持远程主机使用。
- 运行时代码必须自行强制实施其状态可见性，并正确使用返回的渲染安全区段；编辑器本身并非沙箱。
- 本插件不会迁移会话日志。卸载会停止编辑器/服务，但会保留用户配置文件数据。

npx --yes @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web remove dsh-prompt-presets

开发

npm run check 运行确定性的合成夹具测试并构建 lib/。测试覆盖空启动、首次用户保存、无内容打包契约、组合、固定版本、覆盖层、导入和 HTTP 身份验证。测试字符串为人工数据，并被排除在安装归档之外。CI 覆盖 Windows/Ubuntu 与 Node 24。无需私有工作区、第三方提示词包或模型账户。

MIT。独立社区项目；参见 NOTICE、SECURITY 和 CONTRIBUTING。