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