前言¶
在 DeepSeek Harness（DSH）里跑对话时，系统提示词往往只有一份全局设定：换角色要改配置，不同会话也很难各自保留「是谁、该怎么说话、要记住什么」。若把角色、准则和记忆都写进单段 prompt，维护成本高，切换也不直观。
下面介绍社区插件 dsh-agent-profiles（维护者 MoYu-CN，分类：记忆）。它在 DSH 中提供多套 智能体配置（角色设定、性格、说话习惯、行为准则、长期记忆），并作为 system-prompt 段落 注入；支持全局默认与单对话覆盖，切换只影响之后的回合，不改动历史消息。
这是什么¶
dsh-agent-profiles 是 DSH 的 npm 插件，中文界面名「智能体配置」。一句话定位：为 DSH 准备多套 Agent profile——每套含 persona、duties、头像与长期记忆摘要/条目，组装提示词时注入模型可见的系统提示词段落。
插件采用 MIT 许可证，当前资料中的包版本为 0.7.0。设置界面跟随宿主语言（内置中英词典）；面向模型的提示词段落按设计保持中文。社区目录页：skillhub.cn/plugins/MoYu-CN/dsh-agent-profiles；源码与说明：GitHub — MoYu-CN/dsh-agent-profiles。
DSH 生态强调「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
两层作用范围¶
| 层 | 在哪改 | 作用范围 |
|---|---|---|
| 全局当前配置 | 设置 →「智能体配置」 | 未做专属设定的对话均使用 |
| 每个对话的配置 | 输入框左侧下拉 + ⚙ 面板 | 仅该对话；可固定某套配置，并写本对话专属补充设定与记忆 |
无论哪一层，切换 立即生效且只影响之后的对话，历史记录不会被改写。
核心功能¶
配置内容与界面¶
每套配置可编辑：角色设定、性格特点、说话习惯、行为准则、长期记忆摘要、长期记忆条目（逐条编辑/删除）。设置页左栏为配置列表（新建、复制、导入、导出），右栏编辑名称、头像与上述字段。
输入框左侧 快速切换器 可为当前对话选择配置；选「跟随全局」即使用设置页里当前启用的一套。回合消息在官方「已完成 …」行 上方 增加一行「[头像] 配置名」，官方行保留不变。
长期记忆界面会显示占用字数（资料示例：746 / 5000 字）；超过上限会自动提炼压缩。
注入与切换机制¶
插件向 DSH 注册名为 agent-profiles:persona 的 system-prompt 段落（order 860），text 为函数，每次组装提示词时读取当前 active 配置，因此切换后下一回合即生效。空配置（仅有名称、无实质内容）不注入；关闭记忆注入时相关块整段不出现，避免占用上下文。
每个对话还可通过 agent 作用域同名段落 覆盖全局：有会话绑定时用该对话的配置与专属设定；否则回落全局。出厂默认启用「通用助手」，并预填行为准则（实事求是、简洁直白等）；若希望零注入，将该套四个内容字段清空即可。
长期记忆¶
用户可选 模型主动存 + 插件定期兜底：
- 工具 memory_save：模型认为值得长期记住时写入当前对话生效的那套配置。
- 后台提炼：每 5 回合、在
agent/status变为 idle 后，插件读取对话并调用模型提炼要点写入记忆。 - 超限压缩：长期记忆超过 5000 字时，由插件调用模型合并为摘要与精简条目。
写入目标按会话 id 当场解析（会话绑定优先，否则全局当前），避免中途切换配置写错位置。后台逻辑遵循不抛错到调用方、同会话不并发、对话摘录上限 6000 字等约束。
其他能力¶
- 记忆注入开关、导入 / 导出、恢复默认。
- Host 提供
/__ap/*等 HTTP API；数据持久化为profiles.json（原子写）。
安装与启用¶
推荐从 npm 安装（使用包名，不要手抄 tarball 地址）：
dsh plugin add dsh-agent-profiles
安装完成后按提示 重启 DSH（Host 半）；浏览器客户端 刷新页面 后生效。
备选方式（资料原文）：
# tarball
dsh plugin add https://registry.npmjs.org/dsh-agent-profiles/-/dsh-agent-profiles-0.7.0.tgz
本地开发可 clone 后使用 dsh plugin add "link:<你的目录>/dsh-agent-profiles" 软链目录，改代码立即生效。
package.json 要求 Node ^22.19.0 || >=24.0.0。插件硬依赖 webServer（无则无法提供设置界面）；长期记忆相关能力依赖 sessionQuery、llm、tools 等，缺失时会在装载阶段告警而非静默失败。
典型用法¶
- 执行上述安装命令并重启 / 刷新后，打开 设置 → 智能体配置，新建或复制一套配置，填写角色与准则，在列表中设为全局当前。
- 在新对话中，若需专用人格，在输入框左侧选择该配置或「跟随全局」；在 ⚙ 面板中可固定配置并添加 本对话专属 设定与记忆。
- 需要备份或迁移时，在设置页使用 导出 / 导入；误改可用 恢复默认。
- 若不希望某套配置参与提示词，清空其内容字段或关闭记忆注入（视需求而定）。
适用场景与注意¶
适合：需要在同一 DSH 实例下切换多种助手人格；希望按会话绑定不同角色与记忆；要把 persona 与长期记忆从手写 system prompt 里拆出来统一管理。
注意：
- 插件在 当前 dsh 进程权限 下运行，安装前请自行查阅 源码仓库 与 MIT 许可证，确认符合你的安全与合规要求。
- 记忆提炼与压缩会额外调用模型，产生 token 与费用；对话摘录有 6000 字上限。
- 非 agent 组装或无法取得
agent.ctx时会降级为全局段落并记 warning，该对话专属设定可能不生效。
结尾¶
dsh-agent-profiles 把「角色 + 准则 + 长期记忆」做成可切换、可 per-session 覆盖的配置集，并通过 DSH 的 system-prompt 段落机制注入，切换即时生效且不改历史。需要安装与字段说明时，以 README 为准：
- 目录页：https://www.skillhub.cn/plugins/MoYu-CN/dsh-agent-profiles
- GitHub：https://github.com/MoYu-CN/dsh-agent-profiles
