前言¶
在 DeepSeek Harness（DSH）里做 Agent 对话时，若希望模型在特定场景下按固定人设说话，而不是整段会话都挂着同一套系统提示，通常要在提示词或工作流里自己维护角色状态。yuanstarstar 维护的 dsh-maid（目录分类：趣味换装）把「女仆角色卡」做成插件：日常对话保持普通模式，只在导入、生成或切换角色时注入人设，并持久化到本地存储。
这是什么¶
dsh-maid 是 DSH 的一个 Bundle 插件，让 Agent 在激活后扮演带角色设定的女仆，使对话更贴近角色口吻与背景。维护者为 yuanstarstar，源码与说明见 GitHub，社区目录页为 SkillHub 插件页。package.json 中版本为 1.0.0，许可证为 MIT。
核心设计（README 原文）：日常对话保持普通模式；只有「导入女仆设定」或「生成女仆设定」时才进入女仆模式。
核心功能¶
下面介绍插件在资料中明确列出的能力。
角色扮演与默认关闭¶
- 将女仆角色卡（人设）注入系统提示词，Agent 按角色的口吻、性格、背景回应。
- 未触发导入或生成时，不进入女仆模式；可通过「退出女仆模式」或模式选择器回到标准对话。
切换、持久化与内置角色¶
- 可随时切换角色；说「退出女仆模式」即恢复普通对话。
- 角色库保存在 DSH 存储
~/.dsh/storages/maid.json，重启不丢失。 - 内置两个角色：酒狐（狐耳葡萄酒女仆，出自《车万女仆》模组酒狐二创）、大肥鱼（蓝色鲸鱼娘女仆，DeepSeek 吉祥物二创）。
Agent 工具¶
对话意图与 Host 侧工具对应关系如下（README 表格）：
| 意图 | 示例说法 | 工具 |
|---|---|---|
| 查看角色 / 当前状态 | 「列出女仆角色」 | maid_list |
| 导入并进入女仆模式 | 「导入这个女仆角色：{JSON}」 | maid_import |
| 生成并进入女仆模式 | 「生成一个傲娇的猫耳女仆」 | maid_generate |
| 切换角色 | 「切换成大肥鱼」 | maid_switch |
| 退出女仆模式 | 「退出女仆模式 / 关闭女仆模式」 | maid_switch（README FAQ 提及 maid_switch ""） |
| 导出角色卡 | 「导出酒狐的角色卡」 | maid_export |
| 删除角色 | 「删除大肥鱼」 | maid_delete |
设置页与模式选择器¶
- 新建对话时，左上角「模式」选择器可选「女仆 · 酒狐 / 大肥鱼」或「标准」。
- DSH「设置 → 女仆模式」页提供简要使用说明（由
client.js注入设置 UI）。
安装与启用¶
先做环境准备：本机已安装并可运行 DSH（Web profile 用于方式一）。
方式一：命令行一键安装（README 推荐，需插件已发布到 npm）
dsh plugin --profile web add dsh-maid
方式二：本地目录安装（开发或未发布 npm 时）
将 dsh-maid 目录放到固定路径后，在 DSH 中让 Agent 执行：
plugin_manager install_bundle <dsh-maid 目录的绝对路径>
安装后若修改 index.js（Host）需重启 DSH；修改 client.js（设置页）刷新页面即可。
典型用法¶
用自然语言驱动¶
按 README 对话表操作即可，例如：
- 进入女仆模式：在模式选择器选「女仆 · 酒狐」，或说「生成一个傲娇的猫耳女仆」。
- 切换：「切换成大肥鱼」。
- 退出：「退出女仆模式」或模式选「标准」。
导入自定义角色卡¶
角色卡 JSON 格式（仅 name 必填，其余可省略，导入时会补默认值）：
{
"name": "角色名",
"avatar": "🦊",
"title": "身份称呼，例如「狐耳女仆」",
"personality": "性格",
"speech": "说话风格与口癖",
"background": "背景故事",
"greeting": "开场白",
"rules": "服务准则",
"extra": "补充设定（形象、能力等）"
}
导入示例说法：「导入这个女仆角色：{JSON}」。
常见问题（README）¶
- 日常对话仍是女仆口吻：重启 DSH 后确认是否已「退出女仆模式」。
- 生成角色失败：需先在 DSH 中配置好默认模型。
适用场景与注意¶
适合谁：希望在 DSH 里做轻量角色扮演、又不想全局常驻女仆人设的开发者或玩家；需要可导入 JSON、可 prompt 生成、可切换与导出的角色库时，该插件路径清晰。
权限与安全：插件以当前 DSH 进程权限运行，会读写 ~/.dsh/storages/maid.json 并向 Agent 注入系统提示。安装前建议阅读 仓库源码（index.js 负责 Host 与工具注册）并确认 MIT 许可证是否符合你的合规要求。SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系，不宜当作官方应用商店。
生态背景：DSH 主张「一切皆插件」；dsh-maid 通过 cordis.patch.yml 挂载 Bundle，Web 端注入 @deepseek-ai/dsh-client-ui-settings-general 设置入口。
结尾¶
dsh-maid 把女仆模式做成「按需激活 + 本地持久化 + 工具化操作」，日常对话与角色扮演可以分开。进一步细节以 README 为准：
- 目录页：https://www.skillhub.cn/plugins/yuanstarstar/dsh-maid
- GitHub：https://github.com/yuanstarstar/dsh-maid
