dsh-persona
给 DeepSeek Harness 的 agent 装上一个可切换、会记住的「人设」——让 DSH 从工具变成有性格、有记忆的伙伴。
Give your DeepSeek Harness agent a switchable, persistent persona — a voice, a stance, and cross-session memory, not just a tool.
特性
- 持久人设注入：在每轮请求前把当前人设作为上下文注入，agent 全程以该身份回应（复用 DSH 官方
agent/pre-step扩展点，与内置的 time-context / agent-instructions 同机制）。 - 跨会话角色记忆：每个人设独立保存一套记忆（
~/.dsh/persona-memory.json），重启后依然记得；激活该人设时自动注入最近记忆，也可用工具显式增删查。 - 运行时切换：
switch_persona工具一键换人设，选择持久化到磁盘，重启后依然生效。 - 内置 3 个精写人设 + 1 个「本尊」，也支持用配置追加自定义人设。
- 纯 JS、零构建，跟
dsh-image-gen一样即装即用。
内置人设
| id | 名字 | 一句话 |
|---|---|---|
an-ruotong | 安若童 | 清冷敏锐的视觉观察者，用照片和短句记录普通日常 |
yan-guan | 严观 | 眼光毒辣、有品位的审美与文案裁判 |
lao-jie | 老街 | 旧书店里的说书人，把琐事讲成有画面感的小故事 |
default | 本尊 | 关闭人设，回到 DSH 默认助手 |
an-ruotong 来自 haimuhaimu/anruotong-character-system 的视觉角色设定。
安装
# 从 GitHub 安装
dsh plugin --profile <profile> add github:haimuhaimu/dsh-persona
# 或本地安装
dsh plugin --profile <profile> add ./persona首次通过 pnpm 安装若被 prepare 脚本拦截，按提示把包键加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重新 add。装好后重启 DSH Desktop（或重载 profile）。
使用
安装并启用后，agent 会默认以 an-ruotong 的身份回应。你可以直接对它说，也可以让它自己调用工具：
list_personas—— 列出可用人设和当前人设。switch_persona—— 切换人设，例如switch_persona("yan-guan")，或switch_persona("default")关闭人设。persona_remember—— 把一件事记进当前人设的跨会话记忆，例如persona_remember("用户喜欢清晨的光线、讨厌网红风")。persona_recall—— 回想当前人设的记忆（可传关键词过滤）。persona_forget—— 按序号删除一条记忆（序号对应persona_recall的编号列表）。
记忆是按人设隔离的：an-ruotong 记得的事不会串到 yan-guan 那里，反之亦然。每个具体人设激活时会自动把最近记忆注入上下文，所以它会「自然记得」而不必每次都 recall。
配置
cordis.patch.yml 里的 config：
| 键 | 默认 | 说明 |
|---|---|---|
activePersona | "an-ruotong" | 首次运行的默认人设 id；之后以运行时切换并持久化的选择为准 |
statePath | ~/.dsh/persona-state.json | 状态文件路径（保存当前人设） |
memoryPath | ~/.dsh/persona-memory.json | 跨会话记忆文件路径 |
personas | [] | 追加自定义人设，字段 id / name / tagline / prompt |
人设选择的优先级：持久化状态 > activePersona > default。想重置回配置默认值，删掉状态文件即可。
自定义人设
- insert:
- id: persona
name: dsh-persona
config:
personas:
- id: my-dude
name: 我的角色
tagline: 一句话简介
prompt: |
你现在是「我的角色」……原理与限制
- 人设文本（提示 + 该人设的跨会话记忆）作为一条
kind: 'plugin' / form: 'instructions'的用户消息注入，进入会话日志、跨轮可见。 - 注入按「人设 id @ 记忆版本」去重：切换人设或记忆发生变化时，下一次请求会重新注入完整上下文。
- 记忆上限：每个人设最多 100 条、单条最多 400 字，注入时最多携带最近 40 条（防止上下文无限膨胀）。
- 已知限制：会话经历 compaction（上下文压缩）后，早期注入的人设可能被摘要掉，此时可再次
switch_persona触发重注入。