dsh-prompt-persona DSH 插件

本插件在 DSH Web 设置页新增「系统提示词」区块，允许直接编辑 `deployment:persona` 片段。支持替换、追加、关闭三种注入模式，可实时查看当前完整提示词和草稿效果。保存时使用乐观并发控制，避免冲突。persona 支持 `{{model}}`、`{{cwd}}`、`{{provider}}` 等模板变量。

ui-productivity

如何安装 dsh-prompt-persona DSH 插件

dsh plugin --profile web add github:xilin3/dsh-prompt-persona

复制不会执行命令。安装 dsh-prompt-persona DSH 插件前请核对仓库和版本。

dsh-prompt-persona DSH 插件数据来源

dsh-prompt-persona DSH 插件快照日期：2026年8月16日

discovered

dsh-prompt-persona DSH 插件能做什么

在设置页提供可视化编辑区域，直接编辑 persona 文本。
三种注入模式：替换（默认）、追加、关闭。
实时显示当前生效的完整系统提示词，以及草稿应用后的预览效果。
基于 revision 的乐观并发保存，冲突时返回 HTTP 409 并提示重新加载。
模板变量严格插值，支持 `{{model}}`、`{{cwd}}`、`{{provider}}`。

dsh-prompt-persona DSH 插件适合哪些场景

无需手动编辑配置文件，通过 GUI 自定义系统提示词。
快速切换注入模式，例如关闭 persona 或追加额外指令。
在保存前预览修改后的完整提示词，确认效果。
多人协作时避免覆盖他人同时修改的配置。
利用模板变量动态插入模型名称、工作目录等上下文信息。

dsh-prompt-persona DSH 插件适合谁

使用 DSH Web 配置文件的用户，希望以图形界面管理系统提示词。
需要频繁调整 persona 内容的部署作者，提升迭代效率。

dsh-prompt-persona DSH 插件的限制

仅适用于 DSH Web 配置（`$DSH_HOME/profiles/web/`）。
前端/Host 改动不会热更新，必须重启 `dsh web` 进程并刷新浏览器。
依赖 DSH 宿主提供的若干 peer 包（如 `@deepseek-ai/dsh-settings`、`@deepseek-ai/dsh-system-prompt`）。
模板变量为严格插值，未注册的变量会导致错误。

dsh-prompt-persona DSH 插件的仓库 README 摘录

以下文字摘自 dsh-prompt-persona DSH 插件的上游仓库 Xilin3/dsh-prompt-persona 的 README，版权归原作者，仅作引用。

一个 **DeepSeek Harness（DSH）插件**：在 Web 设置页里可视化编辑系统提示词（`deployment:persona`），并实时预览改动效果。即「给 Harness 加系统提示词」的**方法 1 —— 改部署 persona**。 > 在 Harness 的系统提示词组装模型里，`deployment:persona` 是唯一一段「由配置/部署作者撰写」的片段（order `0`）。本插件接管这段片段，把它变成设置页里可直接编辑、可预览、可持久化的内容，而无需改动 Harness 本体或手写 `cordis.patch.yml`。 --- ## 特性 - 🎛️ **可视化编辑**：设置页新增「系统提示词」区块，直接写 persona 文本。 - 🔀 **三种注入模式**：`replace`（替换）/ `append`（追加）/ `off`（关闭）。 - 👁️ **当前提示词**：实时显示当前生效的**完整系统提示词**（persona + harness 身份 + 工具引导等所有 section）。 - ✨ **添加效果（预览）**：把草稿应用到一份副本上，点「预览效果」即可看到**保存后的完整提示词**，不落盘、不污染当前状态。 - 💾 **乐观并发保存**：基于 settings revision 的冲突检测（`SETTINGS_CONFLICT` → HTTP 409），避免覆盖他人同时的修改。 - 🧩 **模板变量**：persona 支持 `{{model}}` / `{{cwd}}` / `{{provider}}` 严格插值。 --- ## 界面设置页（Settings）里会多出一个「系统提示词」section，包含： | 区块 | 说明 | | --- | --- | | 注入模式 | 下拉选择替换 / 追加 / 关闭 | | 自定义提示词 | 多行文本域，persona 内容，支持模板变量 | | 保存并应用 / 预览效果 | 持久化到 `settings.yaml`；或仅预览草稿效果 | | 当前提示词 | 当前生效的完整系统提示词（只读） | | 添加效果（预览） | 草稿应用后的完整提示词（点击「预览效果」后出现） | --- ## 工作原理 ```text settings.yaml HTTP 路由 prompt-persona ──────────────► /_dsh/prompt-persona/settings │ (persona, mode) ▲ ▼ │ GET snapshot / POST previ

阅读完整 README仓库许可: MIT

dsh-prompt-persona DSH 插件常见问题

如何安装 prompt-persona 插件？

在终端执行 `dsh plugin --profile web add github:xilin3/dsh-prompt-persona`，然后将 `@xilin3/dsh-prompt-persona` 添加到 profile 的 `package.json` 中的 `dsh.profile.bundles` 数组里。最后运行 `pnpm install` 并重启 `dsh web`。

插件支持哪几种注入模式？分别怎么用？

支持三种模式：`replace`（默认）替换整个 deployment:persona 段；`append` 在现有 persona 后追加内容；`off` 关闭注入。你可以在设置页的下拉菜单中切换模式。

保存之前能预览修改效果吗？

可以。点击「预览效果」按钮，可以看到草稿应用后的完整系统提示词，不会保存也不会影响当前状态。预览结果仅在 UI 中显示。

保存时提示「settings-conflict」错误怎么办？

这说明其他用户在你加载页面后修改了相同的设置。插件使用 revision 乐观并发控制，你需要刷新页面获取最新版本，然后重新应用修改并保存。

插件支持热更新吗？

不支持。由于涉及前端/Host 插件，修改插件代码或设置后，必须重启 `dsh web` 进程并刷新浏览器才能生效。