不需要显卡服务器，不需要 npm install，一条命令启动。

文末附免费领 1000 积分（价值 100 元）的攻略，足够你玩很久。

一、先看效果

这是我最近开源的项目「笃行其道数字人助手」：一个跑在浏览器里的 3D 数字人——超写实级别，实时说话、有口型、有手势，你随时可以打断她。

她的"嘴巴和身体"来自魔珐星云（具身智能 3D 数字人开放平台），"大脑"可以随便换：DeepSeek、豆包、Kimi，或者你本地的 Ollama。

二、目前实现的功能

• 3D 超写实数字人：浏览器端实时渲染（WebGL 端渲染，官方号称首响 1200ms 内），你的电脑不需要 GPU 服务器

• 边生成边开口：大模型流式输出，第一句话生成完数字人就开始说，不傻等

• 语音同步字幕：字幕按真实语音进度逐句放映，不是跟着文本流乱跳

• 随时打断：她说话时你可以直接打断，像跟真人对话

• 语音输入：点麦克风直接说话提问（Chrome 内置识别，零配置）

• 大脑可插拔：内置演示模式（无需任何密钥）→ OpenAI 兼容大模型（DeepSeek/豆包/Kimi/Ollama）→ Dify 知识库编排，页面上点几下就能切换

• 页面内设置面板：AppID、密钥、大脑配置全在页面上填，不用碰配置文件

• 零依赖启动：只要装了 Node.js，一条命令跑起来，无需 npm install

三、它是怎么工作的

你说话/打字
   ↓
大脑（DeepSeek 等大模型，流式生成回答）
   ↓ 逐句切分
魔珐星云 SDK（生成语音+表情+口型+动作，浏览器本地渲染）
   ↓
数字人开口，字幕同步

整套代码开源（MIT 协议），核心封装 avatar-core 可以复用到任何 Web 系统里——这也是这个系列的目标：给若依、客服系统、教育系统这些开源项目都装上数字人（后续文章陆续更新）。

四、第一步：注册魔珐星云，领 1000 积分

数字人的渲染和语音是魔珐星云提供的，按使用时长消耗积分（基础音色约 0.5 积分/分钟）。所以第一步是注册拿积分：

1. 打开官网：https://xingyun3d.com/

2. 注册时 填写邀请码 JM4AWPDQT3，直接免费到账 1000 积分（官网价值 100 元）

—— 不填邀请码只送 100 积分，差 10 倍，别亏

3. 已经注册过的老用户也有份：登录后进入 「福利中心」 ，输入邀请码 JM4AWPDQT3，同样能领 1000 积分

1000 积分够用多久？按基础音色 0.5 积分/分钟算，约等于 2000 分钟的数字人互动时长，个人体验和开发调试完全够用。

领完积分，在控制台创建一个应用：

1. 登录后台后，切换左侧菜单栏至**【应用管理】**；

2. 点击**【开始创建】**按钮，弹出应用创建弹窗；

3. 自定义填写应用名称（任意名称均可），确认后点击**【创建】**；

4. 自定义填写应用名称（任意名称均可），确认后点击**【创建】**；

5. 页面展示App ID、App Secret两组密钥，完整复制保存下来。

五、第二步：下载代码

项目开源在 Gitee：
https://gitee.com/xiongwenhao6/awesome-xingyun-integrations

两种方式任选：

# 方式一：git 克隆
git clone https://gitee.com/xiongwenhao6/awesome-xingyun-integrations.git
cd awesome-xingyun-integrations

或者在 Gitee 页面点「克隆/下载 → 下载 ZIP」，解压即可。

六、第三步：一条命令启动

唯一的前置要求：装有 Node.js 18 或更高版本（没有的去 nodejs.org 下载安装，一路下一步）。

检查版本：

node -v

启动（注意：不需要 npm install，零依赖）：

node server.mjs

看到这个就成了：

┌──────────────────────────────────────────────────────┐
│  魔珐星云 × 开源系统 · 通用接入演示                  │
└──────────────────────────────────────────────────────┘
  演示页    http://localhost:8787

浏览器打开 http://localhost:8787——此时还没配凭证，但已经可以和内置的演示大脑文字聊天了。

七、第四步：填上凭证，见到数字人

1. 点页面右上角的设置按钮（滑杆图标）

2. 把第一步拿到的 AppID、AppSecret 粘进去

3. 点「保存并应用」，页面自动刷新

4. 等资源加载完——你的 3D 数字人就站在左边了

发一句"你好"试试：她会开口说话、有口型、带手势，说话时下方有同步字幕，说到一半点「打断」立刻停。

写在最后

• 源码（MIT 开源，欢迎 star）：https://gitee.com/xiongwenhao6/awesome-xingyun-integrations

• 注册魔珐星云记得填邀请码 JM4AWPDQT3——新用户注册时填，老用户在「福利中心」填，都是免费领 1000 积分（价值 100 元）

有问题评论区见，跑通了的欢迎回来晒图。