deepseekplugins

DeepSeek Harness plugin

dsh-prompt-persona

DSH 插件：在设置页可视化编辑系统提示词（deployment persona），支持实时预览与保存。

Tools & Capabilities
Jump to install

Source facts

Repository
Xilin3/dsh-prompt-persona
Latest update
Aug 13, 2026
Category
Tools & Capabilities
GitHub stars
11
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Xilin3/dsh-prompt-persona
Plugin: dsh-prompt-persona
Author: Xilin3

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

@xilin3/dsh-prompt-persona

![license](./LICENSE) ![topic](https://github.com/topics/dsh-plugin)

一个 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：命令行（推荐）

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

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@xilin3/dsh-prompt-persona"
      ]
    }
  },
  "dependencies": {
    "@xilin3/dsh-prompt-persona": "github:xilin3/dsh-prompt-persona"
  }
}

然后在 profile 目录执行：

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：

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](./LICENSE) © 2026 xilin3

Back to searchOpen GitHub repository

More related plugins

View category