Yuji AI Avatar — 3D Digital Human Chat Widget

开发者	yujitech
更新时间	2026年6月5日 10:53
PHP版本:	7.4 及以上
WordPress版本:	7.0
版权:	GPLv2 or later
版权网址:	版权信息

下载

1.0.0

详情介绍:

Most WordPress AI chatbots are text boxes. AI Avatar gives your visitors a real 3D digital human they can talk to with voice — the avatar lip-syncs in real time and replies with natural-sounding speech. Two ways to use

Demo mode (this plugin's default) — Quick evaluation with our hosted demo LLM. Paste the API Key, the chat bubble shows up. No coding required. Ideal for evaluating the 3D avatar quality and the conversation UX.
Production mode — Plug in your own LLM (OpenAI, Claude, internal API) via our JavaScript SDK in external mode. You keep full control over the conversation logic and data flow; the plugin / SDK only handles the 3D avatar rendering, lip-sync, and voice I/O.

Most production deployments use Production mode so visitor messages never touch our LLM and stay within your existing chat / support stack. The plugin's bundled chat exists for fast first-impression demos. Why a 3D avatar?

More engaging than text — visitors talk longer, ask more questions, convert better
Voice in / voice out — natural conversation, not typing
Real-time lip-sync — the avatar's mouth matches the speech, not a cheap GIF
Drop-in — one API Key in settings, the bubble shows up in 3 minutes

Features

One-click embed via WordPress admin — no code editing
Configurable position (4 corners), theme (light/dark/auto), primary color, size
[yuji_ai_avatar] shortcode for per-page placement
Site-wide auto-inject with per-page exclusion list
Auto-detects WordPress site language — UI follows your site's locale
Bundled English + Simplified Chinese translations
Async script loading — does not slow down your site
No tracking, no admin nags, no "Upgrade to Pro" popups

How it works

Install and activate the plugin
Sign up at avataraisdk.com and create an avatar
Paste your API Key into Settings → AI Avatar
Done — the chat bubble appears in the corner of your site

Pricing The plugin is free and open source (GPLv2). The AI Avatar service has a free tier; paid plans scale with conversation volume. See pricing.

安装:

Upload the yuji-ai-avatar folder to /wp-content/plugins/, or search "Yuji AI Avatar" in Plugins → Add New
Activate the plugin
Go to Settings → AI Avatar and enter your API Key (sign up free at avataraisdk.com)
Add your site's domain to the API Key's allowed-origin whitelist in the AI Avatar console (one-time setup)
Visit your site's frontend — the chat bubble should appear in the bottom-right corner

屏幕截图:

升级注意事项:

1.0.0 Initial release.

常见问题:

Can I use my own LLM (OpenAI, Claude, internal API)?

Yes — and that's the recommended path for production. The bundled chat in this plugin uses our hosted demo LLM to let you try the 3D avatar in minutes, but for real deployments you should switch to the JavaScript SDK in external mode:

npm install @ai-avatar/embed-sdk
Render the avatar with <AIAvatar token="..." llmMode="external" chatPanel="hidden" /> (React/Vue) or AIAvatar.init({ behavior: { llmMode: 'external' } }) (vanilla JS)
Listen for the userInput event → call your LLM → reply with avatar.replyText(text) or avatar.replyAudio(text, audioUrl)

This way visitor messages stay in your stack and only the rendered text / audio is sent to AI Avatar for TTS + lip-sync. The same swap pattern works for Claude / Gemini / Ollama / your own backend — call your LLM in the userInput handler and reply with replyText() or replyAudio(). See the npm package documentation for full usage and a runnable example. npm package docs: https://www.npmjs.com/package/@ai-avatar/embed-sdk.

The avatar isn't showing on my site — what now?

Check three things:

Is the API Key entered correctly in Settings → AI Avatar?
Is your domain added to the API Key's allowed-origin whitelist in the AI Avatar console?
Open the browser console (F12) — any red errors? Common: Origin not in whitelist (fix in console), Missing apiKey (re-paste key).

Can I show the avatar only on specific pages?

Yes. Uncheck "Site-wide auto-inject" in settings, then add the [yuji_ai_avatar] shortcode to any post or page where you want the avatar.

What shortcode attributes are supported?

[yuji_ai_avatar position="bottom-left" theme="dark"] — overrides global settings for that placement.

Will this slow down my site?

No. The SDK is enqueued with async strategy and only loaded on pages where the avatar is shown. 3D assets are loaded on demand when the visitor opens the chat.

What languages does the chat UI support?

English and Simplified Chinese out of the box. The widget auto-detects your WordPress site language and follows it. Adding more locales requires translation files (PRs welcome).

Does this work with caching plugins?

Yes. The SDK is registered via wp_enqueue_script, so it works with WP Rocket, W3 Total Cache, LiteSpeed Cache, and CDN providers. No cache exclusion needed.

What gets deleted when I uninstall?

Only the plugin's own settings option (yuji_ai_avatar_settings). Your AI Avatar account and conversation data on the AI Avatar service remain — manage those at avataraisdk.com.

Is this plugin GPL?

Yes. The plugin itself is GPLv2 or later. The AI Avatar service it connects to is a separate SaaS with its own terms.

更新日志: