在 DeepSeek Harness (DSH) 的开发与调试过程中，调整智能体（Agent）的 Persona 往往需要重启进程或重载配置。这不仅中断了当前会话，还可能打乱模型端的 KV-cache，导致推理效率下降。dsh-openclaw-persona 插件借鉴了 OpenClaw 的成熟范式，将这套五文件 Persona 定义系统引入 DSH，并提供了一个 Web GUI 编辑器，支持即改即生效。
插件定位¶
该插件由用户 lynsucceed 维护，属于「趣味换装」类别。它允许用户复用 SOUL/IDENTITY/USER/MEMORY/TOOLS.md 这五个文件作为 DSH 的 Agent 定义，通过侧边栏或磁盘文件直接修改，并在下一条消息中立即生效。
核心功能¶
- 即改即生效：修改配置后，无需重启 DSH，发送下一条消息即可应用新设定。
- 五文件分层定义：使用 OpenClaw 的标准结构，包括行为准则（SOUL）、身份设定（IDENTITY）、用户画像（USER）、长期记忆（MEMORY）和工具备忘（TOOLS）。
- Web GUI 编辑器：在侧边栏提供标签页界面，直接编辑 Markdown 文件，保存后写入磁盘。
- mtime 缓存：利用文件修改时间（mtime）检测变更，仅在文件变动时重新发送，保持 KV-cache 稳定。
- 两级回退机制：优先读取项目级配置（
<项目目录>/.dsh/persona/*.md），找不到时回退到全局配置（~/.dsh/persona/*.md）。 - 即插即用：安装后侧边栏自动出现「Custom Persona」入口。
安装¶
该插件仅支持 Web Profile。
dsh plugin --profile web add @lynsucceed/dsh-openclaw-persona
安装完成后，重启 DSH Web 服务。
典型用法¶
- Web 界面编辑：重启后，点击侧边栏的「Custom Persona」入口。在标签页中切换编辑五个 Markdown 文件（如 SOUL.md 或 IDENTITY.md）。点击「保存」后，发送下一条消息，Agent 将按照新设定的 Persona 应答。
- 文件编辑：也可以直接编辑磁盘上的配置文件。全局配置位于
~/.dsh/persona/*.md，项目级配置位于<项目目录>/.dsh/persona/*.md。
注意事项¶
- 容错性：任何文件都可以留空或删除，缺失的部分会被安静跳过，不会报错。
- 缓存策略：文件未修改时复用缓存文本，文件修改后立即生效。
- 覆盖规则：项目目录下的
.dsh/persona/会覆盖全局~/.dsh/persona/的同名文件。 - 首次启动：首次运行时会写入示例模板，不会覆盖用户已有的编辑。
总结¶
dsh-openclaw-persona 提供了一种低侵入、高效率的方式来管理 DSH 的智能体设定。它结合了文件系统的灵活性和 Web 界面的便捷性，特别适合需要频繁调整角色风格或进行实验性开发的场景。
- GitHub 仓库：lynsucceed/dsh-openclaw-persona
- 社区目录：dsh-openclaw-persona
