在 DeepSeek Harness (DSH) 的生态中，为智能体 (Agent) 配置固定的昵称、回复风格和语调是常见需求。手动拼接 System Prompt 既繁琐，又容易出错。dsh-soul 插件提供了一个可视化的配置入口，用于管理 Agent 的人格设定，并支持通过命令行进行快速修改。
插件简介¶
dsh-soul 是一个由 Aliuyanfeng 维护的 DSH 插件，分类为“趣味换装”。它通过 Web UI 和命令行工具，帮助用户统一配置 Agent 的昵称、语调、回复风格及自定义指令。
核心功能¶
Web UI 配置¶
插件内置 Web UI，提供中英双语文案。
* 设置页体验：包含 dirty 检测（无改动时禁用保存）、保存结果提示、提示词预览只读面板。
* 「关于你」：设置用户昵称、职业和介绍。
* 风格与语调：支持专业严谨、轻松自然、幽默风趣、吐槽达人、高效干练。
* 特质微调：在风格基础上叠加标题和列表（default/more/less）、表情符号、表格的呈现方式。
* 回复长度偏好：concise（简洁）、normal（适中）、detailed（详尽）。
* 语言与指令：选择输出语言（中文/English），提示词会随语言本地化。支持输入自定义指令。
人设预设与工具¶
- 人设预设：提供 7 个内置人设（苏格拉底式提问者、极简主义者、资深架构师、教学型讲解者、严格代码审阅者、头脑风暴伙伴、自驱型协作者），支持用户保存、切换和删除自建人设。预设仅包含人格维度（风格、特质等），不影响“关于你”。
- 工具调用：Agent 可调用工具
set_persona在对话中直接调整人设。开启确认模式后，需通过/soul confirm确认变更。 - 输入框光轨：提供纯外观的输入框光轨效果（颜色、流动速度、光带粗细、渐隐拖尾）。
健壮性与可观测性¶
- 配置持久化：支持字段白名单、类型、长度上限（昵称/职业 50、介绍 500、自定义指令 2000）及十六进制颜色校验。写入采用原子替换，配置损坏时支持备份与重置。
安装¶
使用以下命令安装插件：
dsh plugin --profile <profile> add dsh-soul
典型用法¶
Web 界面操作¶
启动 DSH 后，进入设置页面的「个性化设置」栏目，修改配置并点击「保存设置」。
命令行操作¶
插件提供了一套斜杠命令用于管理配置：
/soul show 查看当前配置（含确认模式、预设数量与送达状态）
/soul set k=v 修改配置项（如 /soul set style=humorous language=en）
/soul save <名> 保存当前人设为预设
/soul use <名> 应用人设预设
/soul list 查看人设预设
/soul del <名> 删除人设预设
/soul confirm 应用待确认的人设变更
/soul reject 拒绝待确认的人设变更
/soul reset 重置配置（配置损坏时这是逃生口）
/soul enable 启用个性化设置
/soul disable 禁用个性化设置
/soul <昵称> 设置昵称
配置保存后会同步到所有活动 Agent，变更检测机制确保仅在影响 Agent 行为的配置实际变化时刷新提示词。
注意事项¶
- 依赖与兼容性：插件不打包 DSH 运行时包，全部由宿主提供。peerDependencies 检查针对 DSH 运行时版本（
@deepseek-ai/dsh-app-boot），支持 DSH 0.1.x 与 0.2.x（含 prerelease 版本）。 - 提示词插值：提示词插值已关闭，自定义指令里的
{{…}}按字面保留，不会触发装配失败。 - 光轨配置：输入框光轨字段属纯外观配置，只落盘、不进入 system prompt、不触发会话注入。
- 配置损坏：配置损坏时，插件会拒绝覆写，用户可使用
/soul reset功能（保留人设预设库）进行修复。
dsh-soul 通过结构化的配置管理和健壮的存储机制，解决了 DSH 中 Agent 人设定制繁琐的问题。对于需要批量管理 Agent 风格或快速切换人设的场景，该插件提供了可靠的解决方案。
