← Back to home@Starmeteo

atri-for-dsh

No description

Stars
0
Language
JavaScript
Created
Aug 23, 2026
Updated
Aug 23, 2026
FunWeb UI
GitHub repo

Introduction

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）

内容路径
插件本体%DSH_HOME%\profiles\<desktop|web>\node_modules\atri-for-dsh\
运行数据（配置/记忆/参考音频/临时）%DSH_HOME%\atri\{config,memory,refs,tmp}\
GPT-SoVITS 部署（设置页一键部署）%DSH_HOME%\atri\gptsovits\
加载配置%DSH_HOME%\profiles\<desktop|web>\cordis.patch.yml（安装器自动插入，备份 .bak-*）
  • 安装 = 复制插件到 node_modules + 插入 patch 行 + 初始化数据目录；
  • 卸载 = 移除 patch 行 + 删除插件目录（数据保留，重装不丢）；
  • 卸载/重装不影响 GPT-SoVITS 部署与参考音频（都在 %DSH_HOME%\atri\）。

🎙 TTS 通道

通道需要什么效果
Edge TTS（默认）Python 3.9+ + edge-tts（安装器自动装）微软云端日语（Nanami 等 5 声线），开箱即用
GPT-SoVITS设置页「亚托莉原声」卡片一键部署 + 导入权重（需 git + Python + 网络，约 2GB / 20~60 分钟）亚托莉专属音色；可随时「清除」释放空间
浏览器日语语音系统日语语音包（Windows：设置 → 语言 → 日本語 → 下载语音）无需 Python

权重说明（重要）：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