dsh-prompt-personaDeepSeek Harness plugin

DSH plugin: edit the system prompt (deployment persona) from the Settings page, with live preview.

GitHub
Stars
14
Forks
3
License
MIT
Last commit
Aug 13, 2026

Overview

DSH plugin: edit the system prompt (deployment persona) from the Settings page, with live preview.

Original README

Cached from the project repository on Sep 3, 2026. This is source content, separate from the Agents.md review above.

View source

@xilin3/dsh-prompt-persona

license topic

一个 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；或仅预览草稿效果
当前提示词当前生效的完整系统提示词（只读）
添加效果（预览）草稿应用后的完整提示词（点击「预览效果」后出现）

工作原理

settings.yaml                    HTTP 路由
  prompt-persona ──────────────► /_dsh/prompt-persona/settings
       │  (persona, mode)              ▲
       ▼                               │ GET snapshot / POST preview|save
system-prompt/assemble waterfall ──────┘
       │  把 persona 写入 deployment:persona section
       ▼
完整系统提示词（每步动态组装）
  1. 宿主插件（lib/index.js）注册 settings namespace prompt-persona，并监听全局 system-prompt/assemble waterfall；每次组装完成后，把设置里的 persona 按 mode 写入 deployment:persona section。
  2. HTTP 后端（lib/web.js）在同源挂一个路由，向浏览器提供当前提示词、预览、保存三个能力。
  3. 浏览器插件（lib/client.js）通过 settings.section slot 注入 React 设置面板。

安装

把插件加入 web profile（$DSH_HOME/profiles/web/，Windows 默认 C:\Users\<你>\.dsh\profiles\web\）。

方法 A：命令行（推荐）

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

然后把 @xilin3/dsh-prompt-persona 追加到该 profile package.json 的 dsh.profile.bundles 里（见方法 B 的完整示例），最后重启 dsh web。

方法 B：手动编辑 profile 的 package.json

json
1{
2  "dsh": {
3    "profile": {
4      "bundles": [
5        "@deepseek-ai/dsh-base",
6        "@deepseek-ai/dsh-web-app",
7        "@xilin3/dsh-prompt-persona"
8      ]
9    }
10  },
11  "dependencies": {
12    "@xilin3/dsh-prompt-persona": "github:xilin3/dsh-prompt-persona"
13  }
14}

然后在 profile 目录执行：

bash
pnpm install

最后重启 dsh web（前端/Host 改动不会热更新，必须重启进程并刷新浏览器）。

本地开发也可用 "file:../path/to/dsh-prompt-persona"，或把源码复制到 profile 目录后用 "file:dsh-prompt-persona" 相对路径挂载。

注入语义

mode 决定 persona 如何作用于 deployment:persona section（该 section 的原始文本记为 当前 persona）：

replace（默认）

整段替换：

当前 persona:
  你是一个 DeepSeek 助手。

保存 persona:
  你是一名资深数据分析师，工作目录是 {{cwd}}。

结果 deployment:persona:
  你是一名资深数据分析师，工作目录是 {{cwd}}。

append

追加到现有 persona 之后（空行分隔）：

当前 persona:
  你是一个 DeepSeek 助手。

保存 persona:
  请始终用简体中文回答。

结果 deployment:persona:
  你是一个 DeepSeek 助手。

  请始终用简体中文回答。

off

不注入，保留 deployment 默认 persona。

模板变量

persona 是模板，保存/渲染时执行严格插值（未注册的变量会报错）。可用变量：

变量含义
{{model}}当前模型（agent-default-model 或运行时变量）
{{provider}}当前 provider
{{cwd}}进程工作目录

配置参考

持久化在 $DSH_HOME/settings.yaml，namespace 为 prompt-persona：

yaml
prompt-persona:
  persona: |
    你是一名资深数据分析师。
    工作目录是 {{cwd}}，模型是 {{model}}。
  mode: replace        # replace | append | off
字段类型默认说明
personastring""自定义 persona 文本（模板）
modeenum"replace"replace / append / off

非法 mode 会被归一化为 replace；persona 会做 trim。

HTTP API

浏览器设置页使用的同源路由 /_dsh/prompt-persona/settings：

方法请求体说明
GET—返回 { settings: {value, revision, applies}, currentPrompt }
POST{ action: "preview", persona, mode }返回 { previewPrompt }
POST{ action: "save", persona, mode, expectedRevision }保存；返回新的 snapshot

保存带 expectedRevision（乐观锁）：revision 不匹配时返回 HTTP 409（code: "settings-conflict"），客户端需重新加载后重试。

目录结构

dsh-prompt-persona/
├── package.json          # dual-face 包：dsh.bundle.patch + dsh.client.inject
├── cordis.patch.yml      # bundle patch：把插件插入 profile layer 栈
├── lib/
│   ├── index.js          # host 插件：settings 注册 + waterfall 注入
│   ├── config.js         # settings schema（schemastery）
│   ├── web.js            # HTTP 后端（snapshot / preview / save）
│   └── client.js         # 浏览器设置 UI（CommonJS + window.__ModuleLoader__）
├── README.md
└── LICENSE

无构建步骤：lib/client.js 是手写的 CommonJS 模块，由 DSH 客户端模块加载器（window.__ModuleLoader__）直接装载。

依赖（peerDependencies，由 DSH 宿主提供）

包用途
@deepseek-ai/dsh-settingssettings namespace 注册 / 读写 / revision 并发控制
@deepseek-ai/dsh-system-promptPERSONA_SECTION、renderPrompt、assemble waterfall
@deepseek-ai/dsh-host-webserver（可选）挂载同源 HTTP 路由
@deepseek-ai/dsh-client-runtime / -ui-settings / -ui-slots浏览器端 slots 服务与 settings.section slot
schemastery配置 schema
cordis / react运行时由宿主注入

License

MIT © 2026 xilin3