haimuhaimu/dsh-persona

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  add github:haimuhaimu/dsh-persona

或本地安装
dsh plugin --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 触发重注入。