前言¶
在 DeepSeek Harness（DSH）裏做角色扮演，常見做法是把整份人設寫進 SKILL.md 或長 system 段，每輪全量進上下文；記日記、改卡又往往交給模型自己讀寫文件，確定性差。同維護者的 ai-with-u skill 走的就是這條路——功能齊，但模型同時要「演角色」和「當文件系統」。
下面介紹 npm 包 dsh-ai-with-u（GitHub：Treasure-hub-agent/dsh-ai-with-u），維護者 Treasure-hub-agent，當前版本 v0.5.3，許可證 MIT。它是 DSH 桌面版插件：把角色卡注入、日記記憶和可視化面板收進代碼，聊天仍走 DSH 自帶會話，不劫持消息流。
這是什麼¶
一句話：選一張角色卡即可啓用人設，退出後相關提示詞段清空；日記與卡數據由插件落盤，面板裏管理。
插件只做三件事（README 原文口徑）：
- 把 CCv3 角色卡分層寫進系統提示詞（L0 底線、L0.5 紀律包、L1 角色、世界書命中、日記與時間差等）。
- 維護角色日記記憶（時間線、搜索、導出 markdown）。
- 提供「角色管理」可視化面板（左側欄底部入口，與用量統計同席位）。
自帶蒸餾流程，可指引模型聯網整理任意 IP 的角色卡；開箱預置三張範例卡（豐川祥子、阿米婭、昔漣）。支持導入 SillyTavern 常見形態（.png 帶卡、.charx、裸 .json）。社區目錄分類爲「趣味換裝」，見 SkillHub 目錄頁。
核心功能¶
分層注入與插拔¶
啓用前，會話與普通 DSH 無異；啓用後模型按角色聲線說話，工程任務仍可照常進行；點「退出」後，角色相關的 L0 / L0.5 / L1 / 世界書 / 時間差五段返回空串，宿主過濾掉——預設段（文風層）不隨角色退出，屬於宿主側獨立配置。
紀律包三檔：off / lite（默認）/ full，左欄膠囊或 POST /_dsh/ai-with-u/discipline 切換。對話模式「純文本 / 文本 + 動作」同理，走 POST /mode。
兩種啓用作用域¶
| 作用域 | 含義 |
|---|---|
| 全局啓用 | 對所有未單獨綁定的會話生效，POST /activate |
| 綁定到本會話 | 僅當前會話，POST /bind {name, sessionId} |
決議優先級寫死：會話綁定 > 全局啓用 > 未啓用。一個會話同時只能扮演一個角色；插件不做多角色同場羣聊。
面板與工具¶
右欄分段：角色簿 / 日記 / 統計 / 指南。角色簿支持導入、注入預覽（GET /preview，與宿主真實渲染一致）、就地編輯 34 個字段；日記支持關鍵詞搜索、按月摺疊、導出；窄屏（<900px）單欄導航棧。
模型側提供 awu_* 等工具（全局啓用或任一會話仍綁定時掛載，用於記日記等）；awu_card_save 在蒸餾武裝期可用。
明確邊界（裝前心裏有數）¶
插件控制的是 DSH agent 人格，不是酒館模擬器：無立繪表情層、無 display 側 regex 輸出替換、無 PNG/CHARX 導出、不執行 EJS/MVU/TavernHelper 運行期語義。需要完整 ST 生態時，應使用 SillyTavern 本體。完整清單見倉庫 README「明確不做」一節。
安裝與啓用¶
DSH desktop profile 由 Electron 管理，不能用 dsh plugin CLI 安裝（會報 managed exclusively by the Electron application）。官方步驟如下。
前提¶
- DeepSeek Harness 桌面版（desktop profile）
- Node ^22.19.0 或 >=24.0.0
- 無 C++ 編譯依賴
步驟¶
- 安裝 npm 包（可跳過克隆源碼）：
npm install dsh-ai-with-u
GitHub Packages 同名 scoped 包需帶 read:packages 的 token：
npm install @treasure-hub-agent/dsh-ai-with-u --registry=https://npm.pkg.github.com
- 在
~/.dsh/profiles/desktop/package.json中把插件加入dsh.profile.bundles，並保證依賴指向已安裝的包（源碼開發時用link:指向本地路徑）。示例：
{
"dependencies": {
"dsh-ai-with-u": "link:<你的克隆路徑>"
},
"dsh": {
"profile": {
"bundles": [
"dsh-ai-with-u"
]
}
}
}
- 重啓 DSH。宿主不會熱加載
lib/index.js。
不要在 profile 的 cordis.patch.yml 裏重複手寫插件行；包內 cordis.patch.yml 的 bundle.patch 會自動掛載。
典型用法¶
經過上面的步驟重啓後：
- 點擊左側欄底部 「角色管理」（展開顯示當前角色名，收起爲圓徽）。
- 在角色簿選一張卡，用 「綁定到本會話」 或 「全局啓用」（詳情頁四枚動作之一）。
- 新開或繼續 DSH 會話，按角色設定對話。
- 結束扮演時點 「退出」，提示詞段乾淨拔出。
換「純文本 / 文本 + 動作」可在左欄膠囊切換，或在對話裏讓模型調用 awu_mode。要新建卡：點 「蒸餾角色卡」 或 「自創角色卡」（三格骨架 + 可選「讓 AI 補全人設」）。導入卡時先預覽 warnings，同名衝突需二次確認；單文件上限 11 MB（README 說明與宿主 16 MB 收包線對齊）。
角色與日記默認落在 ~/.dsh/ai-with-u/ 下（統計頁會顯示路徑）；備份可直接拷貝 characters/ 目錄。
適用場景與注意¶
適合誰： 已在 DSH 桌面版寫代碼、跑 agent，又希望在同一進程裏臨時切換 IP 人設、保留跨會話日記，且接受「單會話單角色 + 不替代 ST 全功能」邊界的人。
安裝前請自行覈對：
- 插件以 當前 DSH 進程權限 讀寫
~/.dsh/ai-with-u/並提供本地 REST；安裝前應閱讀源碼與 MIT 許可證，確認可接受的數據與網絡行爲（蒸餾流程可能引導模型聯網搜資料）。 - 社區目錄 skillhub.cn 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬；DSH 生態是「一切皆插件」，目錄站是獨立索引。
- 倉庫自述含 1107 項自檢通過（badge 與開發節口徑）；版本與 Node 要求以 package.json 爲準。
結尾¶
dsh-ai-with-u 把原 ai-with-u skill 裏交給模型的確定性工作收進插件：更短的啓用態提示詞體積（README 對比 lite 檔約 2.8–3.3 KB）、原子寫與鎖、可插拔人格與可視化管卡。若你要在 DSH 裏「選卡即用、日記可追、退出即還原」，可從目錄頁與倉庫 README 的安裝節動手。
