人设配置 clf0913/dsh-peach-persona

dsh-peach-persona ·「人设」

给 DeepSeek Harness（DSH）加一个设置页：分段配置智能体的人设，并记录每一次注入。

- 设置 → 人设：12 个字段，分「身份 / 说话方式 / 行为准则」三组
- 保存后渲染成一段人设正文，作为系统提示词的一段注入到每次请求
- 注入记录：哪一次真的注入过、多少字、什么时间——「到底生效没有」不用再猜
- 看最终长什么样：不保存也能预览渲染结果

出厂不带任何人设。12 个字段默认为空，内容全由使用者自己填。

装

前提

- DSH 桌面版或 dsh web 版
- 知道自己的配置档名（桌面版是 desktop）

步骤

1) 拿到源码（放哪都行，下面路径只是示例）
git clone https://github.com/clf0913/dsh-peach-persona.git "$env:USERPROFILE\.dsh\plugins\dsh-peach-persona"

2) 以本地 link 方式装进 profile dsh.cmd 的路径按你的安装位置替换 & "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "link:$env:USERPROFILE\.dsh\plugins\dsh-peach-persona"

3) 重启应用（必须）

装完必须重启应用。 DSH 的 HMR 会把新 bundle 热挂进组成树，但插件自身的 JS 模块不会热加载。
上面这些命令是在 Windows 桌面版上验证过的形态；Linux / macOS 没有验证过。

第一次用

1. 设置 → 人设
2. 12 个字段都是空的，填你自己的
3. 最省事的起手：先填 名字、对你的称呼、共事约定，其余留空也行（空字段整行省略）
4. 点「看最终长什么样」预览，再点保存
5. 下一回合生效（正在跑的那一步不会变）
6. 想确认真的生效了：看底部注入记录，有记录就是真的装配过

字段

| 组 | 字段 | 说明 |
| 身份 | 名字 | 它会把自己叫这个名字 |
| 身份 | 简称 | 留空就不提简称 |
| 身份 | 对你的称呼 | 它怎么称呼你 |
| 身份 | 自称 | 跟你说话时它用哪个词指代自己（我 / 本人 / 俺）；名字是「别人怎么指代它」，两件事 |
| 身份 | 关系定位 | 接在「是」后面，如「你的工作搭子」 |
| 身份 | 语言 | 留空则整行省略 |
| 说话方式 | 说话基调 | 语气、要不要奉承、用不用语气词 |
| 说话方式 | 篇幅 | 回话长度和信息密度 |
| 说话方式 | 分歧时怎么办 | 它不同意你时怎么做 |
| 行为准则 | 小块标题 | 留空则无标题行 |
| 行为准则 | 共事约定 | 一条一行，建议自己编号 |
| 行为准则 | 禁忌 / 不做什么 | 留空则整段省略 |

字段族参考了两处公开资料：Character Card V2 规范（name / description / personality / system_prompt / post_history_instructions）与 ChatGPT custom instructions 的「关于你 + 该怎么回答」两分法。

文件都在哪

以 $DSH_HOME（通常 ~/.dsh）为根：

| 路径 | 内容 |
| persona/persona.json | 字段表，编辑源，设置页读写它 |
| persona/persona.md | 由字段渲染出来的产物，注入只读它 |
| persona/persona.md.bak | 每次保存前的上一版 |
| persona/inject.jsonl | 注入记录（只在渲染文本变化时追加一行） |

persona.md 中间那个 --- 行是分段约定：前段进系统提示词开头（人设前缀位），后段进第一方指导之后（相当于「最后说的话」）。

实现要点（二次开发的人会关心）

- 注入走 systemPrompt.section()，注册两段：peach:persona（order 1）与 peach:persona-tail（order 10201）。
- 必须声明 export const inject = ['systemPrompt', 'webServer']。
ctx.get(name) 只回答「此刻有没有」，不会等。不写 inject 的话，装包时靠 HMR 在已运行的树上激活能正常工作，冷启动时服务还没就绪 → 人设段和 HTTP 路由一起静默消失，而且没有任何报错。
- 渲染对空字段整行省略，所以「什么都没填」等于「什么都不注入」，不会渲染出「你是，是……」这类残句。
- 正文里的 {{model}} / {{provider}} / {{cwd}} 是宿主已注册的模板变量，原样保留；其他 {{xxx}} 会降级成 {xxx}——未注册的变量会让整轮渲染抛错。
- 保存是「临时文件 + rename」原子写，覆盖前留 .bak。

测试

自带测试，不依赖任何第三方库，不需要运行中的 DSH，也不碰你真实的 ~/.dsh（临时目录建在系统 temp 下，跑完删掉）。路径全部相对本包推导，换机器、换目录都能跑。

node test/run.mjs # 一次跑完
node test/render.mjs # 渲染器契约：空就是空、名字 ≠ 自称、空字段整行省略
node test/smoke-host.mjs # 宿主冒烟：假 ctx 跑通两段注册 + HTTP 接口 + 全新安装
node test/check-release.mjs # 发布检查：清单/补丁/本地化/图标/默认全空/不泄漏作者人设

装插件不需要这些文件——删掉 test/ 不影响插件运行，它们只是给想验证或二次开发的人看的。
check-release.mjs 里有一条 no author persona strings shipped：扫描整个包，看有没有作者自己的名字或自称。fork 后想加默认人设的话，先想清楚——那会一起发给所有使用者。

卸载

& "<dsh.cmd 路径>" plugin --profile desktop remove dsh-peach-persona

remove 子命令的写法以你的 DSH 版本为准。手动兜底：从 profiles/<profile>/package.json 的 dependencies 和 dsh.profile.bundles 里各删掉一行，再删 profiles/<profile>/node_modules/dsh-peach-persona，然后重启。

已知限制

- 只对提供 webServer 服务的 profile（web / desktop）生效
- 人设是全局一份，不按工作区区分；要「不同项目不同人格」，请用工作区各自的 AGENTS.md
- 手改 persona.md 不会回写到字段表；页面会提示「文件被外部改过」，你一保存就会按字段覆盖它
- 没有随包发布测试套件
- 仅在 Windows 桌面版上实际验证过

License

MIT