前言¶
在 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
