dsh-persona-reflect
Verifieddsh-persona-reflect · v0.1.0 · MIT
Persona reflection for DSH: distill real chat memory into a role card's growth section, so a long-lived character's personality grows from experience instead of a fixed prompt.
Install
dsh plugin add dsh-persona-reflect Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Creators
Readme
dsh-persona-reflect
给 DeepSeek Harness 的人格复盘插件:把一个长期角色(QQ 机器人、陪伴 agent、主播人格等)的真实聊天记忆, 蒸馏成角色卡里的一小段成长记录,让性格从经历里长出来,而不是靠固定提示词。
Persona reflection for DSH: distill real chat memory into the
persona-growthsection of a role card, with backups and rollback. Ships a skill + 4 tools + an optional qq-bridge auto-reflection patch.
解决的问题
长期角色很容易变成「每天重复同一套口头禅的模板」:人设是写死的,经历没有沉淀。 本插件的做法是:
真实聊天/记忆 → 定期复盘 → 模型改写角色卡的「成长段」 → 下一轮对话自动注入
- 只改角色卡里
<!-- persona-growth:begin/end -->之间的内容,人设与说话规则逐字不动; - 每次写入前备份到
roles/.history/,保留最近 10 份,可一键回滚; - 素材没变化时可以跳过(时间/内容哈希由 qq-bridge 定时脚本负责)。
工具
| 工具 | 作用 |
|---|---|
persona_reflect_status |
qq-bridge 路径、角色卡、当前成长段、上次复盘、备份数、记忆信号统计 |
persona_reflect_signals |
读出最近聊天、话题、对群友的印象、想说未说的话(≤6000 字) |
persona_reflect_apply |
把写好的成长段写入角色卡(80–900 字,自动备份,支持 dry_run) |
persona_reflect_rollback |
回滚到最近/指定备份 |
另外注册一个 skill persona-reflect,教 agent 完整流程(读状态 → 读信号 → 写 → 预览 → 落卡 → 校验)。
安装
从插件市场
插件 → 发现 → 搜索 dsh-persona-reflect → 安装 → 重启 DSH。
本地安装(开发)
cp -R dsh-persona-reflect ~/.dsh/plugins/dsh-persona-reflect
# ~/.dsh/profiles/desktop/package.json:
# dependencies 加 "dsh-persona-reflect": "link:/Users/<you>/.dsh/plugins/dsh-persona-reflect"
# dsh.profile.bundles 加 "dsh-persona-reflect"
cd ~/.dsh/profiles/desktop && pnpm install
# 重启 DSH
配置
按优先级:工具参数 > $DSH_HOME/persona-reflect/config.json > 环境变量 > 自动探测。
// ~/.dsh/persona-reflect/config.json
{ "qqBridgeDir": "/Users/you/qq-bridge", "role": "小肥鱼" }
环境变量:DSH_PERSONA_QQ_BRIDGE(qq-bridge 目录)、DSH_PERSONA_ROLE(角色名,默认 小肥鱼)。
自动探测会依次看 ~/Documents/deepseek-harness/default-workspace/qq-bridge、~/qq-bridge、当前目录下的 qq-bridge。
配合 qq-bridge 自动复盘(可选)
bridge-patch/ 里带一个安装器,给 qq-bridge 加上每天定时自动复盘(脚本 + LaunchAgent):
node bridge-patch/apply.mjs /path/to/qq-bridge # 默认每天 10:30
node bridge-patch/apply.mjs /path/to/qq-bridge --time=03:30
node bridge-patch/apply.mjs /path/to/qq-bridge --no-schedule # 只装脚本,不定时
node bridge-patch/apply.mjs /path/to/qq-bridge --uninstall # 卸载定时任务
它会:复制 persona-reflect.mjs 到 qq-bridge/scripts/、写
~/Library/LaunchAgents/com.local.qq-persona-reflect.plist、launchctl bootstrap 加载。
手动验证:cd /path/to/qq-bridge && node scripts/persona-reflect.mjs --dry-run。
安全与边界
- 只允许改
persona-growth标记之间的内容,其他内容逐字保留; - 写入前自动备份,保留最近 10 份;
- 成长段长度限制 80–900 字,避免把整篇设定塞进角色卡;
- 复盘素材来自 qq-bridge 本地记忆(
state/social-v2.json),不上传任何地方。
已知限制
- 角色卡必须是 Markdown,且包含
<!-- persona-growth:begin -->/<!-- persona-growth:end -->标记; persona_reflect_signals读取的是 qq-bridge 的记忆结构;其他客户端需要提供同等结构的state/social-v2.json;- 自动复盘脚本依赖 qq-bridge 的
src/dsh-client.js与本地 DSH 在线(与桥接同一条离线鉴权链路)。
License
MIT