前言¶
在 DeepSeek Harness（DSH）裏做「長期陪聊、帶人設和記憶」的智能體，常見做法是接 QQ、Telegram 等 IM，或自己寫一套 Web 殼。IM 路線要應付平臺風控；純聊天窗口又往往缺心情、空間、語音和分片存檔。維護者 hsushjk 的 dsh-aurachat 是 DSH 生態裏的客戶端類插件：在 DSH 進程內跑 Node 服務，用瀏覽器或可選原生客戶端對話，模型走 DSH 模型列表，不直連任意 /v1。README 寫明項目已歸檔，後續重心在 AuraLife（dsh-auralife）；下文功能與安裝仍以當前倉庫文檔爲準，便於已有部署對照或自行 fork。
這是什麼¶
dsh-aurachat（npm 包名 dsh-aurachat，版本 1.0.0，MIT）是掛在 DSH 上的 AI 夥伴插件。自述仿照 dsh-aurabot-qq，區別是不依賴 QQ。實現人格（markdown 人設）、0~100 心情與四塊記憶，支持看圖、收發語音與表情包、寫日記、逛空間回評論、閒置搭話與自驅便籤；功能按 src/features/ 等目錄模塊化，可本地改代碼擴展。社區目錄頁：skillhub.cn/plugins/hsushjk/dsh-aurachat；源碼：github.com/hsushjk/dsh-aurachat。
核心功能¶
入口與賬號¶
默認監聽 0.0.0.0:2332，瀏覽器可直接訪問；IP 與端口可在設置裏改。DSH 左側欄「自動化任務」下的 AuraChat 與 Web 功能基本一致，但無法發送語音。主人建號，客人在「設置 → 客人」創建，不能自助註冊；客人可選「只聊天日記」或「完全權限」——只聊天時碰不到電腦上的 DSH 工具。模型與思考強度從 DSH 模型列表選擇。
聊天與會話¶
連發合併：連續幾條消息合併後再回復；輸入框仍在輸入時不回。提示音可單獨開關；語音支持按鍵錄音鬆手發送，或上傳音頻當語音條。聊天記錄文字與媒體分目錄存放，分片與翻頁邏輯見 README「數據」一節；保留天數由 history.keepDays（1–365，默認 7）控制。
Ta：人設、心情、記憶與空間¶
人設文件在 personas/，內置兩套，嚮導或設置裏可增刪改。心情偏離常態後按半衰期回落，影響話量與表情、語音頻率。記憶分人物小檔案、相處經驗、說話方式、全部記憶，面板可編輯。「空間」按計劃發動態，主人與客人可評論，每小時回訪新評論。閒置搭話帶免打擾與每日上限；自驅功能讀寫共享便籤 selfdrive.md，做完會通知。
多模態¶
朗讀（TTS）支持自動、edge-tts、本地 CosyVoice / GPT-SoVITS、OpenAI 兼容 /audio/speech、任意 HTTP、Windows 自帶等七種後端。聽寫（STT）用 DSH 自帶 SenseVoice（README 稱主要在 DSH 桌面版可用）。生圖支持 OpenAI 兼容接口、SD WebUI、ComfyUI 或自定義代碼。
可選客戶端¶
aurachat-client-android、aurachat-client-win 用於後臺、消息提示、繞過部分 SSL 限制；不能用客戶端跳過 Web/DSH 內的初始化流程。
HTTP API¶
固定端口根路徑即 API 根；GET /api/state 免登錄探活。登錄 POST /api/login 後帶 Authorization: Bearer 或 ?token=。消息、SSE GET /api/stream、媒體與配置等接口見 README「客戶端預留接口」——第三方客戶端只需 base URL + token，不依賴 DSH 路徑與 cookie。
安裝與啓用¶
需要 DeepSeek Harness 桌面版（官方）。插件以當前 DSH 進程權限運行；安裝前建議閱讀源碼與 MIT 許可證。社區插件目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
從 npm 安裝（推薦）¶
dsh plugin --profile desktop add dsh-aurachat
將 desktop 換成你的 profile 名。裝完重啓 DSH，側欄出現入口，或瀏覽器打開 http://127.0.0.1:2332/。
從本地目錄安裝（改代碼時）¶
- 將整個項目目錄放到本地，例如
D:\dsh-aurachat。 - 在 DSH profile 的
dependencies中登記：
{
"dependencies": {
"dsh-aurachat": "file:D:/dsh-aurachat"
}
}
- 重啓 DSH，同樣可通過側欄或
http://127.0.0.1:2332/訪問。
若要讓 Ta 在 DSH 裏使用改文件、跑命令等工具，需在 DSH 側授予完全權限；僅聊天則不必。
典型用法¶
首次配置¶
第一次打開走初始化嚮導：起名 → 稱呼 → 人設與頭像 → 模型與思考強度 → 主人賬號。完成後自動登錄；之後在「設置」修改，右上角「保存設置」立即生效。
端口與 HTTPS¶
外網或反代時自行記住監聽地址；nginx 示例見 README（proxy_pass 末尾不帶 /，且需 proxy_buffering off）。麥克風、剪貼板在非 127.0.0.1 / localhost 訪問時需要 HTTPS；DSH 桌面版側欄內嵌頁無法使用麥克風。
數據位置¶
數據目錄：~/.dsh/plugins-data/aurachat/（Windows 爲 C:\Users\<用戶名>\.dsh\plugins-data\aurachat\）。主要含 config.json、users.json、chats/、media/、memories.json、diary.json、personas/ 等；密鑰單獨存儲，不回傳前端。運行日誌僅內存環形緩衝，重啓丟失。
聯網與權限¶
README FAQ：edge-tts、OpenAI 兼容 TTS/生圖及自填地址會聯網；其餘以本地爲主；SenseVoice 本地推理。每個客人只能看自己的會話；空間動態按可見性過濾。
適用場景與注意¶
適合希望在 DSH 內獲得「夥伴感」交互、又不願綁 QQ 等 IM 的開發者；README 也提到無網環境下搭配本地大模型使用的動機。項目已聲明停止維護，長期需求可關注 dsh-auralife。升級章節寫明暫無官方升級計劃，有用者可 fork 自行迭代。語音輸入需 DSH 桌面版並在「設置 → 插件 → 實驗性插件」開啓「語音輸入」；模型不回話時查插件「日誌」頁與 DSH 模型、會話權限。
結尾¶
dsh-aurachat 把人格、心情、記憶、空間與多模態收進一個可自託管的 Web/API 入口，並可選 Android / Windows 客戶端做通知與後臺。歸檔狀態下仍可作爲 DSH「一切皆插件」思路下的參考實現。
- 目錄頁：https://www.skillhub.cn/plugins/hsushjk/dsh-aurachat
- GitHub：https://github.com/hsushjk/dsh-aurachat
- 後繼插件：https://github.com/hsushjk/dsh-auralife
