dsh-soul-md

在 DeepSeek Harness 里注入 soul.md 风格人设卡 的插件：把一份 markdown 人设文件渲染成系统提示词段落（soul:persona，order 0），让 Agent 边干活边角色扮演，增加乐趣。

• 文件变更热重载（fs.watch + 防抖），改完 soul.md 保存即生效，无需重启
• 注册在全局提示词层，进程内所有 Agent（web / headless / 子代理）都能看到
• 与部署级人设（deployment:persona）不冲突：使用独立段落名
• 支持提示词变量：{{model}}、{{cwd}} 在渲染时解析

配置

字段	默认值	含义
path	必填	soul.md 路径；绝对路径，或相对 dsh home（$DSH_HOME）的路径
fallback	''	文件缺失/不可读时使用的人设文本；空串 = 不注册段落
order	0	提示词段落顺序（0 = 紧跟部署 persona 槽位）
complete	false	true 时人设卡成为唯一系统提示词（高级用法，会丢弃其他所有段落）
watch	true	是否监听文件变更热重载
debounceMs	300	变更防抖毫秒数

挂载

在 profile 的 cordis.patch.yml（如 $DSH_HOME/profiles/web/cordis.patch.yml）里 insert：

- insert:
    - id: soul-md
      name: './plugins/dsh-soul-md/index.js'
      config:
        path: 'J:/Workspace/soul.md'

name 用相对路径时以 profile 目录为基准；插件依赖（@deepseek-ai/dsh-tools 等）从 $DSH_HOME/profiles/node_modules 解析。

注意事项

• 不要在人设文本里写 {{ / }}：它们是提示词变量语法，未知变量会在渲染时报错（目前没有转义语法）。
• 段落文本在 Agent 生命周期内不变（前缀稳定、KV Cache 友好）；编辑 soul.md 会重注册段落，从下一次组装开始生效。
• 人设是"调味料"：建议在人设卡里写清工作准则（如"任务质量优先"），避免角色扮演影响干活质量。

与 dsh-persona 的区别

dsh-persona 是单 Agent 作用域的人设行（挂在 preset 内、遮蔽部署人设，且必须挂进 agent scope）。 本插件是进程全局的 soul.md 文件驱动人设：挂在 profile patch 层即可，适合"给我这台机器上所有 Agent 加个有趣的人设"的场景。