Sjkhx/yukinoDigital 预览 preview

Sjkhx/yukinoDigital

Project Overview项目介绍

This repository is a native DSH plugin that adds a voice-activated AI assistant based on the character Yukino Yukinoshita to the DSH web interface. It bundles the full source code and assets for the assistant, including a Live2D rendered avatar, Japanese voice pack, character persona, and long-term memory support. The plugin integrates directly with DSH's task flow, listening for completed DSH tasks and automatically generating a spoken summary of the task output for the user. It can run embedded as a compact side panel in DSH or opened as a standalone full-page voice conversation window, giving users flexible interaction options. To install the plugin into DSH, you add it to your local DSH profile via pnpm and enable it in your cordis.patch.yml configuration file.

This plugin is designed for DSH users who want a conversational AI companion that also helps automate post-task summaries after DSH completes coding or project work. In compact mode, the assistant loads as a 1/4 width vertical panel on the right side of the DSH interface, with the Live2D avatar on top and the conversation input below. You can hide the panel any time, or pop it out into a separate full-screen window for longer voice conversations. Both voice and text input are supported in the same conversation session, so you can switch between input methods seamlessly as you interact with the assistant.

The code for the project is released under the MIT license, and all character and voice assets are used through authorized user channels. Full voice functionality requires WSL2 with an NVIDIA GPU to run the GPT-SoVITS text-to-speech model, but the Live2D avatar rendering works locally without a GPU. For first-time setup, you can follow the step-by-step WSL2 installation guide in the repository docs, which walks you through creating a virtual environment, installing dependencies, and starting the three required assistant services. After setup, you can access the assistant either directly through the DSH interface or at http://127.0.0.1:8000 in your browser.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,用于将带有 Live2D 形象的雪之下雪乃 AI 语音助手接入 DSH web 端。插件集成了完整的雪乃语音助手功能,包括日语音色、人设、对话记忆,既支持主动发起语音或文字对话,也能监听 DSH 任务完成状态,自动对任务结果做总结并语音播报。插件既可嵌入 DSH 右侧作为陪伴面板,也可独立打开全屏语音对话页面使用。

适合喜欢二次元陪伴、需要在 DSH 开发完成后自动获取任务总结语音播报的用户使用。基础使用模式下,可将雪乃面板固定在 DSH 右侧 1/4 屏,支持隐藏面板、一键切换全屏,语音和文字输入可在同一会话混用。DSH 完成任务后,插件会自动将任务总结发送给雪乃,由雪乃生成日语点评并附带译文展示。

完整语音功能需要 WSL2 环境加 NVIDIA GPU 运行 GPT-SoVITS,仅基础 Live2D 展示可无 GPU 本地渲染。项目采用 MIT 许可证,素材来自授权渠道。安装需要先配置 DSH profile,用 pnpm 安装依赖后在配置文件启用插件,首次启动可参考仓库内的 WSL2 安装指南操作。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:Sjkhx/yukinoDigital

把 Sjkhx/yukinoDigital 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

yukino-dsh · 把雪之下雪乃接入 DSH

把「雪之下雪乃」——一个会主动开口的 AI 语音助手——接进 DSH(DeepSeek Harness)web 的插件仓库。 雪乃有 Live2D 形象、日语音色、人设、记忆与对话历史五位一体;既能主动发起对话(语音 / 打字皆可), 也能监听 DSH 任务完成:任务一跑完,自动总结并语音播报给你听。既可嵌入 DSH 右侧做陪伴面板, 也可独立打开全屏语音对话页。

  • 插件本体(lib/):注入 DSH web,新增 /yukino 路由 + 右侧基础面板,DSH 任务完成时把总结交给雪乃点评。
  • 雪乃服务(yukino/ 子目录):完整数字人语音助手源码与素材(Python orchestrator + Live2D 前端 + 配置 + 人设 + 技能)。
  • 当前版本:0.1.0 · MIT License。

yukinoDsh 效果图

功能

  • 双模式
    • 基础模式:嵌入 DSH 右侧 1/4 屏竖屏面板 —— 上部 Live2D、下部对话 + 打字输入;面板可隐藏、可一键跳出到独立页(新窗口)。
    • 完整模式:/yukino 全屏路由或独立打开 http://127.0.0.1:8000/,语音对话。
  • 语音 + 打字:语音走麦克风(VAD→STT→LLM→TTS),打字走文本进同一会话,可混用。
  • DSH 任务完成点评:DSH 会话跑完,插件把任务总结 POST 给 orchestrator,雪乃用日语评论(先日语后译文)。
  • 项目背景注入:yukino/log/project_context.md 描述项目本身,每次会话注入雪乃上下文,被问"这项目做了什么"有依据。
  • Live2D 雪乃:Cubism 4 前端本地渲染(avatar.backend=2dlive),无需后端 GPU;待机姿势自动轮换、情绪动作、口型同步。
  • 记忆与历史:mem0 长期记忆(LLM 抽取 + qdrant 向量库)+ SQLite 对话历史(/history 管理页)。

目录结构

yukino-dsh-plugin/
├── lib/                        # DSH 插件本体(client.js 注入 / index.js 入口)
├── cordis.patch.yml            # DSH profile 补丁(启用 yukino-dsh)
├── package.json                # npm 包声明(DSH 发现的入口)
├── yukino/                     # ★ VoxEMW 雪乃完整源码+素材(本仓库主体)
│   ├── voxemw/                 #   Python 核心包(orchestrator / s2s 管线 / avatar)
│   ├── web/                    #   Live2D 前端(无构建纯静态,iframe 内容源)
│   ├── scripts/                #   启动/安装/工具脚本
│   ├── configs/assistant.yaml  #   唯一配置(七积木选型 + 服务端口)
│   ├── personas/ skills/ assets/
│   ├── docs/                   #   SETUP_WSL / wsl2-troubleshooting / upgrade-regression / MODEL_DOWNLOAD
│   ├── tests/                  #   纯逻辑单测
│   ├── requirements.txt
│   └── docs/README.md          #   VoxEMW 自身文档
└── CLAUDE.md                   # 项目约定(AI 协作用)

快速开始(WSL2,含完整语音)

环境要求:WSL2 + NVIDIA GPU(GPT-SoVITS 需 CUDA)。首次安装见 yukino/docs/SETUP_WSL.md,之后:

cd yukino
bash scripts/setup_wsl.sh             # 首次:建 .venv、装依赖、生成 .env.local(幂等)
bash scripts/start_assistant_wsl.sh   # 启动三服务:GPT-SoVITS(:8899) → s2s(:8765) → orchestrator(:8000)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-pet-ronaldo 下一个 Next DeepSeek-Harness-Desktop →