ATRI for DSH

《ATRI -My Dear Moments-》亚托莉（アトリ）智能助手，DeepSeek Harness 插件。

海边的她：Live2D 立绘（动作表情系统）+ 日语语音（亚托莉原声可选）+ 长期记忆 + 主动搭话 + AI 聊天。

受 amadeus-for-dsh 与 Open-LLM-VTuber-ATRI 启发。

✨ 功能

• Live2D 亚托莉（动作表情系统）：模型来自 atri.exe 内嵌的 atri_8（Live2D Cubism 3，4096 纹理）。聊天时 LLM 输出情绪 + 动作指令，她真的会点头 / 挥手 / 歪头 / 思考 / 惊讶 / 跳舞；待机时也有随机小动作（伸腰/歪头/视线游移），腮红、眉毛、嘴型随情绪平滑过渡。
• 日语语音（三通道可切换）：
  • Edge TTS（默认）：微软云端日语合成，安装即用，无需任何部署；
  • GPT-SoVITS（亚托莉原声）：训练自游戏原声 112 分钟的专属音色，设置页一键部署（自动 clone 官方仓库 + 装依赖 + 放入权重 + 启动）；
  • 浏览器日语语音：系统自带，需安装日语语音包。
• AI 聊天：亚托莉人格（礼貌元气、自称高性能、偶尔ポンコツ，称呼你「夏生さん」），回复以中文显示、日语朗读；可独立 OpenAI 兼容 API，也可用 DSH 默认模型。
• 长期记忆：历史 + 事实抽取 + 摘要落盘，跨会话、跨重启。
• 主动搭话 / 事件播报：长时间无互动时亚托莉会先开口；目标完成、工作流结束、子代理汇报、错误等都会播报。
• CRT 终端面板：人物占主屏 + 海天背景（可用自己的图替换 assets/img/background.png）+ 聊天区（深浅跟随 DSH 主题）。

🚀 安装（Windows，三种方式任选）

方式一 · 在线一行命令（PowerShell 或 CMD 粘贴，无需下载任何文件）：

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/Starmeteo/atri-for-dsh/main/install-online.ps1 | iex"

方式二 · 发行包：GitHub Releases 下载 ATRI-for-DSH.zip → 解压 → 双击 Atri-OneClick.bat。

方式三 · 源码：

git clone https://github.com/Starmeteo/atri-for-dsh.git
cd atri-for-dsh
.\Atri-OneClick.bat        # 或 .\install-atri.ps1

安装器会询问 TTS 通道（默认 Edge TTS）并自动探测 Profile（Desktop/Web 版）。装完重启 DSH。

参数速查：

.\install-atri.ps1 -Profile web -Channel edge        # 指定 Profile 与 TTS 通道
.\install-atri.ps1 -Uninstall                         # 卸载（保留数据）

📁 文件位置（全部统一在 %DSH_HOME%，默认 C:\Users\<你>\.dsh）

• 安装 = 复制插件到 node_modules + 插入 patch 行 + 初始化数据目录；
• 卸载 = 移除 patch 行 + 删除插件目录（数据保留，重装不丢）；
• 卸载/重装不影响 GPT-SoVITS 部署与参考音频（都在 %DSH_HOME%\atri\）。

🎙 TTS 通道

权重说明（重要）：ATRI 权重（atri_e25_s5250.pth + atri-e10.ckpt）与参考音频（wav）为粉丝训练/提取素材，不随插件分发（版权与体积原因），请自行获取（如 HuggingFace: 2DIPW/ATRI_GPT-SoVITS，含权重和参考音频）。

部署与导入流程（设置页「亚托莉原声」卡片）：

1. 部署：点「一键部署」自动 clone 官方仓库 + 装依赖 + 启动 API（约 2GB / 20~60 分钟）。部署位置默认 %DSH_HOME%\atri\gptsovits\，可在卡片「部署位置」输入框改成任意目录并「保存位置」；
2. 导入权重：把下载解压出的模型文件夹（含 atri_e25_s5250.pth、atri-e10.ckpt 与参考音频 wav）路径填到「导入权重」输入框，点「导入」——权重会自动复制到部署目录的 GPT_weights\ / SoVITS_weights\，参考音频复制到 %DSH_HOME%\atri\refs\，随后自动重启 API；
3. 启用：在「语音合成」页把 TTS 通道切到 GPT-SoVITS，即可听到亚托莉原声。

部署时若权重已放在以下任一位置也会被自动识别（无需手动导入）：项目源码目录旁的 ATRI_GPT-SoVITS\、%DSH_HOME%\atri\refs\、或环境变量 ATRI_MODEL_DIR 指向的文件夹。

部署 GPT-SoVITS 详见 docs/gptsovits-setup.md。

🎨 自定义背景

把喜欢的图片命名为 background.png 放到插件目录 assets\img\（%DSH_HOME%\profiles\<profile>\node_modules\atri-for-dsh\assets\img\）替换默认图，刷新面板即可。

🛠 开发

npm install --no-save esbuild        # 仅打包客户端时需要
node tools/build_static.mjs          # plugin/src/* → package/host.mjs + client.mjs
node tools/build_client.mjs          # client.mjs → package/client.js（__ModuleLoader__ bundle）
node tools/smoke-test.mjs            # 受限环境冒烟测试
powershell -ExecutionPolicy Bypass -File tools/make_dist.ps1   # 生成发行 zip

• 动态源（会话内热更新）：plugin/src/host.js、plugin/src/client.js、plugin/web/*。
• 情绪/动作配置表：plugin/web/emotion.js（FACE 表情 / GESTURE 说话幅度 / MOTIONS 动作——加动作只需在表里加一行）。
• 架构说明见 docs/design.md。

版权

角色形象/声音/台词归 Frontwing / ANIPLEX.EXE 所有；Live2D模型：https://www.bilibili.com/video/BV1Rs4y187rJ；TTS模型：https://www.bilibili.com/video/BV11u4m1w71A