agent-robot-avatar 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +39 -0
- package/README.md +193 -33
- package/agent-robot-avatar.js +11 -1
- package/docs/README.de.md +22 -8
- package/docs/README.es.md +19 -11
- package/docs/README.fr.md +21 -11
- package/docs/README.ja.md +19 -11
- package/docs/README.ko.md +19 -11
- package/docs/README.pt.md +19 -11
- package/docs/README.zh-CN.md +202 -92
- package/docs/README.zh-TW.md +19 -11
- package/index.d.ts +30 -0
- package/package.json +3 -2
- package/src/agent-robot-avatar-actions.js +8 -2
- package/src/agent-robot-avatar-antenna.js +24 -45
- package/src/agent-robot-avatar-core.js +80 -17
- package/src/agent-robot-avatar-extension-host.js +6 -1
- package/src/agent-robot-avatar-failure.js +5 -1
- package/src/agent-robot-avatar-geometry.js +40 -0
- package/src/agent-robot-avatar-head-roundness.js +2 -35
- package/src/agent-robot-avatar-inspect.js +41 -30
- package/src/agent-robot-avatar-runtime-fixes.js +178 -0
- package/src/agent-robot-avatar-runtime.js +744 -0
- package/src/agent-robot-avatar-version.js +1 -1
package/docs/README.fr.md
CHANGED
|
@@ -6,18 +6,30 @@
|
|
|
6
6
|
|
|
7
7
|
[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
|
+
|
|
11
|
+
      
|
|
10
12
|
|
|
11
13
|
Un Web Component léger et expressif d’avatar robot pour les agents IA et d’autres applications interactives.
|
|
12
14
|
|
|
15
|
+
Il convient aux interfaces d’assistants IA et d’Agents, notamment aux produits et expériences similaires à ChatGPT, Claude, Codex, Cursor, Grok Bot, Gemini CLI et OpenCode.
|
|
16
|
+
|
|
17
|
+
Il peut également être utilisé pour les desktop pets, animaux virtuels, compagnons de bureau, mascottes numériques, avatars de chatbots et autres expériences de personnages interactifs.
|
|
18
|
+
|
|
19
|
+
Agent Robot Avatar peut également servir de couche de retour visuel pour les interfaces d’Agents de style AG-UI.
|
|
20
|
+
|
|
13
21
|
Agent Robot Avatar est construit avec SVG et JavaScript natif, sans framework d’animation tiers. Il fonctionne comme un Custom Element natif et propose une API compacte pour les expressions, les états d’interaction, le suivi du pointeur, l’attente et la forme de la tête.
|
|
14
22
|
|
|
15
|
-
**Version publique actuelle : v0.
|
|
23
|
+
**Version publique actuelle : v0.3.0**
|
|
16
24
|
|
|
17
25
|
<p align="center">
|
|
18
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Démonstration animée interactive d’Agent Robot Avatar" width="560">
|
|
19
27
|
</p>
|
|
20
28
|
|
|
29
|
+
## Démo en ligne
|
|
30
|
+
|
|
31
|
+
Essayez la démo interactive : [Ouvrir Agent Robot Avatar](https://cx-artlab.github.io/agent-robot-avatar/?lang=fr)
|
|
32
|
+
|
|
21
33
|
## Points forts
|
|
22
34
|
|
|
23
35
|
- SVG + JavaScript natif
|
|
@@ -55,7 +67,7 @@ avatar.play('success');
|
|
|
55
67
|
avatar.play('failure');
|
|
56
68
|
avatar.play('warning');
|
|
57
69
|
avatar.play('inspect');
|
|
58
|
-
avatar.play('
|
|
70
|
+
avatar.play('blocked');
|
|
59
71
|
avatar.play('error');
|
|
60
72
|
|
|
61
73
|
avatar.reset();
|
|
@@ -74,7 +86,7 @@ avatar.reset();
|
|
|
74
86
|
| Failure | `failure` | Tâche terminée sans succès |
|
|
75
87
|
| Warning | `warning` | Action importante nécessitant confirmation |
|
|
76
88
|
| Inspect | `inspect` | Examiner, contrôler ou vérifier un résultat |
|
|
77
|
-
| Blocked | `
|
|
89
|
+
| Blocked | `blocked` | Requête bloquée ou impossible à poursuivre |
|
|
78
90
|
| System error | `error` | Erreur de connexion, de service ou système |
|
|
79
91
|
| Surprise | `surprise` | Événement ou résultat inattendu |
|
|
80
92
|
| Sleep | `sleep` | Entrer en veille |
|
|
@@ -89,7 +101,7 @@ avatar.play('failed');
|
|
|
89
101
|
avatar.play('fail');
|
|
90
102
|
avatar.play('verify');
|
|
91
103
|
avatar.play('review');
|
|
92
|
-
avatar.play('
|
|
104
|
+
avatar.play('angry'); // même expression visuelle que blocked
|
|
93
105
|
avatar.play('policy-blocked');
|
|
94
106
|
avatar.play('system-error');
|
|
95
107
|
avatar.play('connection-error');
|
|
@@ -168,6 +180,8 @@ Lors du glisser, la tête se déforme localement autour du point d’interaction
|
|
|
168
180
|
- Forte poussée vers le centre : déclenche `success` après le retour
|
|
169
181
|
- Petit glisser : déformation uniquement
|
|
170
182
|
|
|
183
|
+
Ces expressions de glisser ne s’appliquent à l’état idle que lorsqu’aucune action programmée ne contrôle l’avatar. Pendant `waiting`, `input`, `inspect` et les autres actions actives, la déformation reste visible mais l’expression de glisser est supprimée et n’est pas rejouée ensuite. `pointercancel` restaure uniquement la forme sans déclencher success ni angry.
|
|
184
|
+
|
|
171
185
|
## Demo interactive
|
|
172
186
|
|
|
173
187
|
`demo/index.html` contient tous les états publics, le suivi du pointeur, le glisser type gelée, le cycle waiting, le réglage de l’arrondi, les contrôles de couleur et de comportement et une simulation de conversation Agent. Le JavaScript propre à la Demo reste dans `demo/` et n’est pas inclus dans le runtime npm réutilisable.
|
|
@@ -198,7 +212,7 @@ Issues et Pull Requests sont les bienvenus. Consultez [`CONTRIBUTING.md`](../CON
|
|
|
198
212
|
|
|
199
213
|
## État du projet
|
|
200
214
|
|
|
201
|
-
v0.
|
|
215
|
+
v0.3.0 est la version publique actuelle. v0.1.0 reste disponible comme première version publique. L’API publique reste volontairement limitée afin d’évoluer avec prudence avant un futur engagement de stabilité `1.0.0`.
|
|
202
216
|
|
|
203
217
|
Agent Robot Avatar est un projet open source développé indépendamment ; il n’est affilié, approuvé ni représentatif d’aucune plateforme ou marque d’IA.
|
|
204
218
|
|
|
@@ -208,8 +222,4 @@ MIT License. Voir [`LICENSE`](../LICENSE).
|
|
|
208
222
|
|
|
209
223
|
## Offrez-moi un café
|
|
210
224
|
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
| Ko-fi | Alipay | WeChat Pay |
|
|
214
|
-
| --- | --- | --- |
|
|
215
|
-
| <a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a> | <img src="../assets/support/alipay.png" alt="QR code Alipay" width="160"> | <img src="../assets/support/wechat-pay.png" alt="QR code WeChat Pay" width="160"> |
|
|
225
|
+
<a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>
|
package/docs/README.ja.md
CHANGED
|
@@ -6,20 +6,30 @@
|
|
|
6
6
|
|
|
7
7
|
[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
13
13
|
AI エージェントやその他のインタラクティブなアプリケーションで使える、軽量で表情豊かなロボットアバター Web Component です。
|
|
14
14
|
|
|
15
|
+
AI アシスタントや Agent のインターフェースに適しており、ChatGPT、Claude、Codex、Cursor、Grok Bot、Gemini CLI、OpenCode に似た製品や体験で利用できます。
|
|
16
|
+
|
|
17
|
+
デスクトップペット、バーチャルペット、デスクトップコンパニオン、デジタルマスコット、チャットボットのアバターなど、さまざまなインタラクティブキャラクター体験にも利用できます。
|
|
18
|
+
|
|
19
|
+
Agent Robot Avatar は、AG-UI スタイルの Agent インターフェースにおける視覚的なフィードバックレイヤーとしても利用できます。
|
|
20
|
+
|
|
15
21
|
Agent Robot Avatar は SVG と Vanilla JavaScript だけで構築され、サードパーティー製アニメーションフレームワークに依存しません。ネイティブ Custom Element として動作し、表情、状態、ポインター追従、待機フィードバック、頭部形状をシンプルな API で制御できます。
|
|
16
22
|
|
|
17
|
-
**現在の公開バージョン：v0.
|
|
23
|
+
**現在の公開バージョン：v0.3.0**
|
|
18
24
|
|
|
19
25
|
<p align="center">
|
|
20
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar インタラクティブアニメーションデモ" width="560">
|
|
21
27
|
</p>
|
|
22
28
|
|
|
29
|
+
## ライブデモ
|
|
30
|
+
|
|
31
|
+
インタラクティブデモを試す：[Agent Robot Avatar を開く](https://cx-artlab.github.io/agent-robot-avatar/?lang=ja)
|
|
32
|
+
|
|
23
33
|
## 特長
|
|
24
34
|
|
|
25
35
|
- SVG + Vanilla JavaScript
|
|
@@ -57,7 +67,7 @@ avatar.play('success');
|
|
|
57
67
|
avatar.play('failure');
|
|
58
68
|
avatar.play('warning');
|
|
59
69
|
avatar.play('inspect');
|
|
60
|
-
avatar.play('
|
|
70
|
+
avatar.play('blocked');
|
|
61
71
|
avatar.play('error');
|
|
62
72
|
|
|
63
73
|
avatar.reset();
|
|
@@ -76,7 +86,7 @@ avatar.reset();
|
|
|
76
86
|
| Failure | `failure` | タスク自体が失敗 |
|
|
77
87
|
| Warning | `warning` | 危険・破壊的な操作の確認 |
|
|
78
88
|
| Inspect | `inspect` | 結果の確認・検証 |
|
|
79
|
-
| Blocked | `
|
|
89
|
+
| Blocked | `blocked` | リクエストが拒否・停止された状態 |
|
|
80
90
|
| System error | `error` | 接続・サービス・システム障害 |
|
|
81
91
|
| Surprise | `surprise` | 予期しない結果 |
|
|
82
92
|
| Sleep | `sleep` | スリープへ移行 |
|
|
@@ -91,7 +101,7 @@ avatar.play('failed');
|
|
|
91
101
|
avatar.play('fail');
|
|
92
102
|
avatar.play('verify');
|
|
93
103
|
avatar.play('review');
|
|
94
|
-
avatar.play('
|
|
104
|
+
avatar.play('angry'); // blocked と同じ表情
|
|
95
105
|
avatar.play('policy-blocked');
|
|
96
106
|
avatar.play('system-error');
|
|
97
107
|
avatar.play('connection-error');
|
|
@@ -170,6 +180,8 @@ API を呼ばなくても、ランダムなまばたき、視線移動、近く
|
|
|
170
180
|
- 強く中心へ押す：復帰後に `success`
|
|
171
181
|
- 小さなドラッグ：変形のみ
|
|
172
182
|
|
|
183
|
+
これらのドラッグ表情は、プログラム制御のアクションがアバターを使用していない idle 時にのみ適用されます。`waiting`、`input`、`inspect` などの実行中は変形だけを残し、ドラッグ表情は抑制して後から再生しません。`pointercancel` では形状だけを復元し、成功・怒りの表情は発生しません。
|
|
184
|
+
|
|
173
185
|
## インタラクティブ Demo
|
|
174
186
|
|
|
175
187
|
`demo/index.html` には全公開状態、ポインター追従、ゼリー風ドラッグ、waiting ライフサイクル、頭部丸み調整、色・挙動設定、Agent 会話シミュレーションが含まれます。Demo 専用 JavaScript は `demo/` に分離され、再利用用 npm runtime には含まれません。
|
|
@@ -200,7 +212,7 @@ Issue と Pull Request を歓迎します。提出前に [`CONTRIBUTING.md`](../
|
|
|
200
212
|
|
|
201
213
|
## プロジェクトの状態
|
|
202
214
|
|
|
203
|
-
v0.1.0
|
|
215
|
+
v0.3.0 は現在の公開バージョンです。v0.1.0 は最初の公開バージョンとして引き続き利用できます。将来の `1.0.0` に向けて慎重に進化できるよう、公開 API は意図的に小さく保っています。
|
|
204
216
|
|
|
205
217
|
Agent Robot Avatar は独立して開発されたオープンソースプロジェクトであり、特定の AI プラットフォームやブランドとは提携・公式承認関係にありません。
|
|
206
218
|
|
|
@@ -210,8 +222,4 @@ MIT License。詳細は [`LICENSE`](../LICENSE) を参照してください。
|
|
|
210
222
|
|
|
211
223
|
## コーヒーで支援
|
|
212
224
|
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
| Ko-fi | Alipay | WeChat Pay |
|
|
216
|
-
| --- | --- | --- |
|
|
217
|
-
| <a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a> | <img src="../assets/support/alipay.png" alt="Alipay QR code" width="160"> | <img src="../assets/support/wechat-pay.png" alt="WeChat Pay QR code" width="160"> |
|
|
225
|
+
<a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>
|
package/docs/README.ko.md
CHANGED
|
@@ -6,20 +6,30 @@
|
|
|
6
6
|
|
|
7
7
|
[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
13
13
|
AI 에이전트와 다양한 인터랙티브 애플리케이션에서 사용할 수 있는 가볍고 표현력 있는 로봇 아바타 Web Component입니다.
|
|
14
14
|
|
|
15
|
+
ChatGPT, Claude, Codex, Cursor, Grok Bot, Gemini CLI, OpenCode와 유사한 제품과 경험을 포함해 AI 어시스턴트 및 Agent 인터페이스에 적합합니다.
|
|
16
|
+
|
|
17
|
+
데스크톱 펫, 가상 펫, 데스크톱 컴패니언, 디지털 마스코트, 챗봇 아바타 및 기타 인터랙티브 캐릭터 경험에도 사용할 수 있습니다.
|
|
18
|
+
|
|
19
|
+
Agent Robot Avatar는 AG-UI 스타일 Agent 인터페이스의 시각적 피드백 레이어로도 사용할 수 있습니다.
|
|
20
|
+
|
|
15
21
|
Agent Robot Avatar는 SVG와 Vanilla JavaScript로만 구성되어 있으며 타사 애니메이션 프레임워크에 의존하지 않습니다. 네이티브 Custom Element로 동작하고 표정, 상호작용 상태, 포인터 추적, 대기 피드백, 머리 형태를 제어하는 간결한 API를 제공합니다.
|
|
16
22
|
|
|
17
|
-
**현재 공개 버전: v0.
|
|
23
|
+
**현재 공개 버전: v0.3.0**
|
|
18
24
|
|
|
19
25
|
<p align="center">
|
|
20
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 인터랙티브 애니메이션 데모" width="560">
|
|
21
27
|
</p>
|
|
22
28
|
|
|
29
|
+
## 라이브 데모
|
|
30
|
+
|
|
31
|
+
인터랙티브 데모 체험: [Agent Robot Avatar 열기](https://cx-artlab.github.io/agent-robot-avatar/?lang=ko)
|
|
32
|
+
|
|
23
33
|
## 주요 특징
|
|
24
34
|
|
|
25
35
|
- 순수 SVG + Vanilla JavaScript
|
|
@@ -57,7 +67,7 @@ avatar.play('success');
|
|
|
57
67
|
avatar.play('failure');
|
|
58
68
|
avatar.play('warning');
|
|
59
69
|
avatar.play('inspect');
|
|
60
|
-
avatar.play('
|
|
70
|
+
avatar.play('blocked');
|
|
61
71
|
avatar.play('error');
|
|
62
72
|
|
|
63
73
|
avatar.reset();
|
|
@@ -76,7 +86,7 @@ avatar.reset();
|
|
|
76
86
|
| Failure | `failure` | 작업 결과 실패 |
|
|
77
87
|
| Warning | `warning` | 위험하거나 파괴적인 동작 확인 |
|
|
78
88
|
| Inspect | `inspect` | 결과 검토 / 확인 / 검증 |
|
|
79
|
-
| Blocked | `
|
|
89
|
+
| Blocked | `blocked` | 요청이 차단되거나 진행 불가 |
|
|
80
90
|
| System error | `error` | 연결, 서비스 또는 시스템 오류 |
|
|
81
91
|
| Surprise | `surprise` | 예상하지 못한 결과 |
|
|
82
92
|
| Sleep | `sleep` | 수면 상태 진입 |
|
|
@@ -91,7 +101,7 @@ avatar.play('failed');
|
|
|
91
101
|
avatar.play('fail');
|
|
92
102
|
avatar.play('verify');
|
|
93
103
|
avatar.play('review');
|
|
94
|
-
avatar.play('
|
|
104
|
+
avatar.play('angry'); // blocked와 동일한 표정
|
|
95
105
|
avatar.play('policy-blocked');
|
|
96
106
|
avatar.play('system-error');
|
|
97
107
|
avatar.play('connection-error');
|
|
@@ -170,6 +180,8 @@ avatar.addEventListener('face-state', (event) => {
|
|
|
170
180
|
- 강하게 중심으로 밀기: 복귀 후 `success`
|
|
171
181
|
- 작은 드래그: 변형만 적용
|
|
172
182
|
|
|
183
|
+
이 드래그 표정은 프로그램 제어 액션이 아바타를 사용하지 않는 idle 상태에서만 적용됩니다. `waiting`, `input`, `inspect` 등이 실행 중일 때는 변형은 유지되지만 드래그 표정은 억제되며 나중에 재생되지 않습니다. `pointercancel`은 형태만 복구하고 성공/화남 표정을 발생시키지 않습니다.
|
|
184
|
+
|
|
173
185
|
## 인터랙티브 Demo
|
|
174
186
|
|
|
175
187
|
`demo/index.html`에는 모든 공개 상태, 포인터 추적, 젤리 드래그, waiting 라이프사이클, 머리 둥글기 조절, 색상 / 동작 설정, Agent 대화 시뮬레이션이 포함됩니다. Demo 전용 JavaScript는 `demo/`에 분리되어 재사용 가능한 npm runtime에는 포함되지 않습니다.
|
|
@@ -200,7 +212,7 @@ Issue와 Pull Request를 환영합니다. 제출 전 [`CONTRIBUTING.md`](../CONT
|
|
|
200
212
|
|
|
201
213
|
## 프로젝트 상태
|
|
202
214
|
|
|
203
|
-
v0.1.0은 첫 공개
|
|
215
|
+
v0.3.0은 현재 공개 버전입니다. v0.1.0은 첫 공개 버전으로 계속 제공됩니다. 향후 `1.0.0` 안정성 약속 이전에 신중하게 발전시킬 수 있도록 공개 API를 의도적으로 작게 유지하고 있습니다.
|
|
204
216
|
|
|
205
217
|
Agent Robot Avatar는 독립적으로 개발된 오픈 소스 프로젝트이며 특정 AI 플랫폼이나 브랜드와 제휴하거나 공식 승인을 받은 프로젝트가 아닙니다.
|
|
206
218
|
|
|
@@ -210,8 +222,4 @@ MIT License. 자세한 내용은 [`LICENSE`](../LICENSE)를 참조하세요.
|
|
|
210
222
|
|
|
211
223
|
## 커피 한 잔으로 후원하기
|
|
212
224
|
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
| Ko-fi | Alipay | WeChat Pay |
|
|
216
|
-
| --- | --- | --- |
|
|
217
|
-
| <a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a> | <img src="../assets/support/alipay.png" alt="Alipay QR code" width="160"> | <img src="../assets/support/wechat-pay.png" alt="WeChat Pay QR code" width="160"> |
|
|
225
|
+
<a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>
|
package/docs/README.pt.md
CHANGED
|
@@ -6,20 +6,30 @@
|
|
|
6
6
|
|
|
7
7
|
[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
13
13
|
Um Web Component leve e expressivo de avatar robótico para agentes de IA e outras aplicações interativas.
|
|
14
14
|
|
|
15
|
+
É adequado para interfaces de assistentes e agentes de IA, incluindo produtos e experiências semelhantes a ChatGPT, Claude, Codex, Cursor, Grok Bot, Gemini CLI e OpenCode.
|
|
16
|
+
|
|
17
|
+
Também pode ser usado em desktop pets, pets virtuais, companheiros de desktop, mascotes digitais, avatares de chatbot e outras experiências com personagens interativos.
|
|
18
|
+
|
|
19
|
+
Agent Robot Avatar também pode funcionar como uma camada de feedback visual para interfaces de agentes no estilo AG-UI.
|
|
20
|
+
|
|
15
21
|
Agent Robot Avatar é construído com SVG e JavaScript puro, sem dependência de frameworks de animação de terceiros. Funciona como um Custom Element nativo e oferece uma API compacta para expressões, estados de interação, seguimento do ponteiro, feedback de espera e formato da cabeça.
|
|
16
22
|
|
|
17
|
-
**Versão pública atual: v0.
|
|
23
|
+
**Versão pública atual: v0.3.0**
|
|
18
24
|
|
|
19
25
|
<p align="center">
|
|
20
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Demonstração animada interativa do Agent Robot Avatar" width="560">
|
|
21
27
|
</p>
|
|
22
28
|
|
|
29
|
+
## Demo ao vivo
|
|
30
|
+
|
|
31
|
+
Experimente a demo interativa: [Abrir Agent Robot Avatar](https://cx-artlab.github.io/agent-robot-avatar/?lang=pt)
|
|
32
|
+
|
|
23
33
|
## Principais recursos
|
|
24
34
|
|
|
25
35
|
- SVG + JavaScript puro
|
|
@@ -57,7 +67,7 @@ avatar.play('success');
|
|
|
57
67
|
avatar.play('failure');
|
|
58
68
|
avatar.play('warning');
|
|
59
69
|
avatar.play('inspect');
|
|
60
|
-
avatar.play('
|
|
70
|
+
avatar.play('blocked');
|
|
61
71
|
avatar.play('error');
|
|
62
72
|
|
|
63
73
|
avatar.reset();
|
|
@@ -76,7 +86,7 @@ avatar.reset();
|
|
|
76
86
|
| Failure | `failure` | Tarefa concluída sem sucesso |
|
|
77
87
|
| Warning | `warning` | Ação arriscada ou destrutiva exige confirmação |
|
|
78
88
|
| Inspect | `inspect` | Revisar, conferir ou verificar um resultado |
|
|
79
|
-
| Blocked | `
|
|
89
|
+
| Blocked | `blocked` | Solicitação bloqueada ou impossibilitada de continuar |
|
|
80
90
|
| System error | `error` | Falha de conexão, serviço ou sistema |
|
|
81
91
|
| Surprise | `surprise` | Evento ou resultado inesperado |
|
|
82
92
|
| Sleep | `sleep` | Entrar em repouso |
|
|
@@ -91,7 +101,7 @@ avatar.play('failed');
|
|
|
91
101
|
avatar.play('fail');
|
|
92
102
|
avatar.play('verify');
|
|
93
103
|
avatar.play('review');
|
|
94
|
-
avatar.play('
|
|
104
|
+
avatar.play('angry'); // mesma expressão visual de blocked
|
|
95
105
|
avatar.play('policy-blocked');
|
|
96
106
|
avatar.play('system-error');
|
|
97
107
|
avatar.play('connection-error');
|
|
@@ -170,6 +180,8 @@ Ao arrastar, a cabeça se deforma localmente ao redor do ponto de interação, e
|
|
|
170
180
|
- Empurrão forte para o centro: ativa `success` após retornar
|
|
171
181
|
- Arraste pequeno: apenas deformação
|
|
172
182
|
|
|
183
|
+
Essas expressões de arraste só se aplicam em idle quando nenhuma ação programática controla o avatar. Durante `waiting`, `input`, `inspect` e outras ações ativas, a deformação é preservada, mas a expressão de arraste é suprimida e não é reproduzida depois. `pointercancel` restaura apenas a forma, sem acionar success ou angry.
|
|
184
|
+
|
|
173
185
|
## Demo interativo
|
|
174
186
|
|
|
175
187
|
`demo/index.html` inclui todos os estados públicos, seguimento do ponteiro, arraste tipo gelatina, ciclo de waiting, ajuste do arredondamento, controles de cor e comportamento e simulação de conversa com Agent. O JavaScript exclusivo do Demo fica isolado em `demo/` e não faz parte do runtime reutilizável do npm.
|
|
@@ -200,7 +212,7 @@ Issues e Pull Requests são bem-vindos. Leia [`CONTRIBUTING.md`](../CONTRIBUTING
|
|
|
200
212
|
|
|
201
213
|
## Status do projeto
|
|
202
214
|
|
|
203
|
-
v0.
|
|
215
|
+
v0.3.0 é a versão pública atual. v0.1.0 continua disponível como a primeira versão pública. A API pública é mantida deliberadamente pequena para evoluir com cuidado antes de um futuro compromisso de estabilidade `1.0.0`.
|
|
204
216
|
|
|
205
217
|
Agent Robot Avatar é um projeto independente de código aberto e não é afiliado, endossado nem representa nenhuma plataforma ou marca de IA.
|
|
206
218
|
|
|
@@ -210,8 +222,4 @@ MIT License. Consulte [`LICENSE`](../LICENSE).
|
|
|
210
222
|
|
|
211
223
|
## Pague-me um café
|
|
212
224
|
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
| Ko-fi | Alipay | WeChat Pay |
|
|
216
|
-
| --- | --- | --- |
|
|
217
|
-
| <a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a> | <img src="../assets/support/alipay.png" alt="QR code do Alipay" width="160"> | <img src="../assets/support/wechat-pay.png" alt="QR code do WeChat Pay" width="160"> |
|
|
225
|
+
<a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>
|