dsh-openclaw-persona

改 md 即改 Persona，下一条消息生效。 把 OpenClaw 五件套 Persona 定义搬进 DeepSeek Harness——侧边栏直接编辑，保存即生效。

---

🖼️ 界面预览

侧边栏入口，点开即编辑，标签页切换五个文件，保存后下一条消息立即生效。

✨ 核心特性

• 🖊️ 即改即生效 — 聊到一半觉得 Agent 回答风格不对？点开侧边栏改两笔，下一条消息就按新设定来。不用重启、不用重载配置。
• 📐 五文件分层定义 — 借鉴 OpenClaw 的成熟范式：行为准则 / 身份设定 / 用户画像 / 长期记忆 / 工具备忘，各司其职，改哪块动哪块。
• 🎛️ Web GUI 编辑器 — 标签页切换 5 个文件，Markdown 直接写，保存即写入磁盘。也可以用你喜欢的编辑器直接改文件，效果完全一样。
• ⚡ mtime 缓存，KV-cache 友好 — 文件没变就复用缓存文本，不打乱模型端 KV-cache；文件改动立刻生效，两全其美。
• 🏗️ 两级回退 — 先找项目内 .dsh/persona/（每个仓库一套设定），找不到再回退到全局 ~/.dsh/persona/（默认设定）。项目覆盖全局，天经地义。
• 🔌 即插即用 — 一个命令装上，侧边栏自动出现入口；首次启动写入示例模板，绝不覆盖你已有的编辑。

🚀 一分钟上手

# 安装插件（web profile）
dsh plugin --profile web add @lynsucceed/dsh-openclaw-persona

# 重启 DSH Web
dsh web

重启后侧边栏会出现 「Custom Persona」 入口——点开就能编辑 5 个 Persona 文件。

也可以从 GitHub 安装：dsh plugin --profile web add github:lynsucceed/dsh-openclaw-persona

🧩 五文件体系

文件	管什么	组合顺序
SOUL.md	行为准则 — 语气、边界、价值观	1
IDENTITY.md	身份设定 — 角色定位、背景、说话方式	2
USER.md	用户画像 — 称呼、时区、相处之道	3
MEMORY.md	长期记忆 — 值得记住的信息	4
TOOLS.md	工具 / 环境备忘 — TTS 声线、设备别名等	5

五个文件按顺序拼接，替换 DSH 的 deployment:persona 提示段。任何一个文件都可以留空或删除——缺失的部分会被安静跳过，不会报错。

🎯 使用方式

在 Web GUI 里编辑（推荐）

1. 点击侧边栏 「Custom Persona」
2. 切换标签页，在对应的 Markdown 文件里写设定
3. 点 「保存」
4. 发下一条消息——Agent 已经按新设定应答了 ✨

直接改文件

编辑磁盘上的 ~/.dsh/persona/*.md（全局）或 <项目目录>/.dsh/persona/*.md（项目级），效果完全一样。mtime 缓存会自动检测变化。

项目级覆盖

想给某个项目单独配一套 Persona？在项目根目录下建 .dsh/persona/，把要覆盖的文件放进去就行。没放的文件仍然从全局读取。

⚙️ 配置（可选）

默认开箱即用。如果想自定义，可以在 cordis 配置里传参：

plugins:
  '@lynsucceed/dsh-openclaw-persona':
    dir: persona          # 目录名，默认 persona
    files:                # 文件列表 + 顺序，默认是下面这 5 个
      - SOUL.md
      - IDENTITY.md
      - USER.md
      - MEMORY.md
      - TOOLS.md

• dir — 在 .dsh/ 和 ~/.dsh/ 下查找的子目录名
• files — 自定义文件名和组合顺序，想用几个用几个

🛠️ 开发

pnpm install     # 安装依赖（devDependencies 直接从 npm 拉，不需要本地 DSH checkout）
pnpm build       # tsc 生成类型 + tsdown 打包（host ESM + client ModuleLoader）
pnpm typecheck   # 仅类型检查

运行时依赖通过 peerDependencies 由宿主 profile 注入，打包产物里不包含 cordis / dsh-* 包。

📄 许可

Apache-2.0