agent-robot-avatar 0.5.2 → 0.7.0

package/docs/README.ru.md

@@ -1,186 +0,0 @@
-# Agent Robot Avatar
-
-<p align="center">
-  <img src="../assets/readme/agent-robot-avatar-header.jpg" alt="Agent Robot Avatar">
-</p>
-
-[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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Русский](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ru.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.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) | [日本語](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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md)
-
-![Version](https://img.shields.io/badge/version-v0.5.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
-
-![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square)
-
-Лёгкий и выразительный Web Component с роботом-аватаром для AI-агентов и интерактивных приложений.
-
-Его можно использовать в AI-ассистентах, интерфейсах агентов, настольных компаньонах, виртуальных питомцах, цифровых маскотах, аватарах чат-ботов и других интерактивных персонажах.
-
-Подходит для интерфейсов AI-ассистентов и агентов, включая продукты и сценарии, похожие на ChatGPT, Claude, Codex, Cursor, Grok Bot, Gemini CLI и OpenCode.
-
-Компонент построен на SVG и vanilla JavaScript, работает как нативный Custom Element и не имеет runtime-зависимостей.
-
-Agent Robot Avatar также можно использовать как слой визуальной обратной связи для интерфейсов агентов в стиле AG-UI.
-
-<p align="center">
-  <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Интерактивная анимационная демонстрация Agent Robot Avatar" width="560">
-</p>
-
-## Демонстрация в реальном времени
-
-[Открыть интерактивную демонстрацию](https://cx-artlab.github.io/agent-robot-avatar/?lang=ru)
-
-## Основные возможности
-
-- Нативный Web Component
-- SVG-рендеринг + vanilla JavaScript
-- Ноль runtime-зависимостей
-- Автоматическое моргание и лёгкое idle-поведение
-- Следование глазами за указателем и инерционное движение головы
-- Локальная jelly-деформация при перетаскивании с упругим возвратом
-- Сжатие при удержании и перетаскиваемая пружинящая антенна
-- Программное управление состояниями и выражениями Agent
-- Обратная связь для waiting, success, failure, warning, review, blocked и system error
-- Поддержка reduced motion
-- Настраиваемое поведение сна
-- Регулируемое скругление головы
-- Опциональное мигание антенны для статуса
-- TypeScript-декларации включены
-
-## Установка
-
-```bash
-npm install agent-robot-avatar
-```
-
-```js
-import 'agent-robot-avatar';
-```
-
-Также можно напрямую загрузить исходный код из репозитория:
-
-```html
-<script type="module" src="./agent-robot-avatar.js"></script>
-```
-
-Затем добавьте компонент:
-
-```html
-<agent-robot-avatar id="avatar"></agent-robot-avatar>
-```
-
-Инициализация не требуется. Аватар автоматически переходит в стандартное состояние idle.
-
-## Базовое использование
-
-```js
-const avatar = document.querySelector('#avatar');
-
-avatar.play('success');
-avatar.play('warning');
-avatar.play('error');
-
-avatar.reset();
-```
-
-Доступные действия:
-
-`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `send` · `success` · `failure` · `warning` · `inspect` · `blocked` · `error` · `surprise` · `love` · `random` · `sleep` · `wake`
-
-`failure` означает, что задача завершилась неуспешно; `error` предназначен для ошибок соединения, сервиса или системы.
-
-`love` выражает симпатию или благодарность: два глаза наклоняются друг к другу и образуют одно сердце, трижды бьются и возвращаются в исходное состояние.
-
-`random` проигрывает вращение игрового автомата: каждый глаз катится по барабану, затем левый глаз замедляется, подпрыгивает и останавливается, следом правый. `slot` — псевдоним.
-
-Типичный жизненный цикл запроса Agent:
-
-```js
-avatar.startWaiting();
-
-// Второй вариант ожидания: глаза уходят с одной стороны и возвращаются с другой.
-avatar.startWaiting({ variant: 'wrap' });
-
-try {
-  const result = await runAgentRequest();
-  await avatar.play(result.ok ? 'success' : 'failure');
-} catch (error) {
-  await avatar.play('error');
-}
-```
-
-## Часто используемые параметры
-
-```html
-<agent-robot-avatar
-  size="160"
-  color="#08090b"
-  auto-sleep="30000"
-  wake-on="activity"
-  motion="auto">
-</agent-robot-avatar>
-```
-
-| Атрибут | Назначение |
-| --- | --- |
-| `size` | Размер аватара в пикселях |
-| `color` | Основной цвет аватара |
-| `auto-sleep` | Время бездействия до автоматического сна; `0` отключает его |
-| `wake-on` | Политика автоматического пробуждения: `activity`, `interaction` или `manual` |
-| `motion` | Политика движения: `auto`, `reduce` или `full` |
-| `press-squeeze` | Удержание центра для сжатия; `false` отключает жест |
-| `antenna-drag` | Перетаскивание и пружинящий возврат антенны с сердитой реакцией; `false` отключает жест |
-
-Часто используемые runtime-настройки:
-
-```js
-avatar.setPointerFollow(false);
-avatar.setHeadRoundness(75);
-avatar.setAntennaFlash(true);
-avatar.setPressSqueeze(true);
-avatar.setAntennaDrag(true);
-```
-
-Удержание центра запускает сжатие. После перемещения более чем на 4 CSS-пикселя тот же жест переходит в существующее перетаскивание головы. Для антенны действует тот же предел расстояния, а после возврата запускается существующая сердитая реакция.
-
-## События и интеграция
-
-Компонент отправляет `face-state` при изменениях визуального состояния и `action-state` при семантических изменениях жизненного цикла действий.
-
-Для интеграции с host-приложением и доступного статусного текста предпочтительнее `action-state`. Рабочий пример жизненного цикла запроса находится в [`examples/accessibility.html`](../examples/accessibility.html).
-
-Минимальный пример интеграции доступен в [`examples/basic.html`](../examples/basic.html).
-
-## Совместимость
-
-Рассчитан на современные браузеры с поддержкой ES Modules, Custom Elements, SVG, Pointer Events, Web Animations API, `IntersectionObserver`, `ResizeObserver` и `matchMedia`.
-
-Автоматизированные тесты покрывают Chromium, Firefox и WebKit.
-
-## Участие в разработке
-
-Issues и Pull Requests приветствуются. Перед отправкой изменений прочитайте [`CONTRIBUTING.md`](../CONTRIBUTING.md).
-
-## Статус проекта
-
-**Текущая публичная версия: v0.5.2**
-
-Публичный API намеренно остаётся компактным, пока проект развивается к будущему обязательству стабильности `1.0.0`.
-
-Agent Robot Avatar разрабатывается независимо и не аффилирован, не одобрен и не представляет какую-либо AI-платформу или бренд.
-
-## Дизайн персонажа и визуальная идентичность
-
-Персонаж Agent Robot Avatar, включая внешний вид робота и визуальную идентичность, является оригинальной разработкой CX ArtLab.
-
-MIT License применяется к программному обеспечению и исходному коду. Она разрешает использовать, изменять и распространять аватар как часть приложений, но не передаёт права собственности на название Agent Robot Avatar, идентичность персонажа или визуальную идентичность и не даёт права представлять их как оригинального персонажа или самостоятельный бренд другой стороны.
-
-Названия сторонних продуктов, упомянутые в проекте, используются только для описания возможных сценариев применения и не означают аффилированность или одобрение.
-
-## Лицензия
-
-MIT License. См. [`LICENSE`](../LICENSE).
-
----
-
-Если этот проект оказался полезен, вы можете угостить меня кофе.
-
-<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.zh-CN.md

@@ -1,190 +0,0 @@
-# Agent Robot Avatar
-
-<p align="center">
-  <img src="../assets/readme/agent-robot-avatar-header.jpg" alt="Agent Robot Avatar">
-</p>
-
-[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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Русский](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ru.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.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) | [日本語](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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md)
-
-![Version](https://img.shields.io/badge/version-v0.5.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
-
-![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square)
-
-一个轻量、富表现力的机器人头像 Web Component，适用于 AI Agent 与交互式应用。
-
-可用于 AI 助手、Agent 界面、桌面伙伴、虚拟宠物、数字吉祥物、聊天机器人头像及其他交互角色体验。
-
-可用于 AI 助手、Agent 界面，包括类似 ChatGPT、Claude、Codex、Cursor、Grok Bot、Gemini CLI 和 OpenCode 的产品与体验。
-
-使用 SVG 与原生 JavaScript 构建，以原生 Custom Element 运行，运行时零依赖。
-
-Agent Robot Avatar 还可作为 AG-UI 风格 Agent 界面的视觉反馈层。
-
-<p align="center">
-  <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 交互动画演示" width="560">
-</p>
-
-## 在线 Demo
-
-[打开交互 Demo](https://cx-artlab.github.io/agent-robot-avatar/?lang=zh-CN)
-
-## 特点
-
-- 原生 Web Component
-- SVG 渲染 + 原生 JavaScript
-- 运行时零依赖
-- 自动眨眼与轻微待机动作
-- 眼睛跟随指针与头部惯性运动
-- 果冻式局部拖拽形变与弹性恢复
-- 按住挤压与可拖动的弹簧天线交互
-- 可通过程序控制 Agent 状态与表情
-- 支持 waiting、success、failure、warning、review、blocked、system error 等反馈
-- 支持减少动态效果
-- 可配置自动睡眠行为
-- 可调头部圆角
-- 可选天线状态闪烁
-- 内置 TypeScript 类型声明
-
-## 安装
-
-```bash
-npm install agent-robot-avatar
-```
-
-```js
-import 'agent-robot-avatar';
-```
-
-也可以直接加载仓库源码：
-
-```html
-<script type="module" src="./agent-robot-avatar.js"></script>
-```
-
-然后添加组件：
-
-```html
-<agent-robot-avatar id="avatar"></agent-robot-avatar>
-```
-
-无需初始化代码，头像会自动进入默认待机状态。
-
-## 基础用法
-
-```js
-const avatar = document.querySelector('#avatar');
-
-avatar.play('success');
-avatar.play('warning');
-avatar.play('error');
-
-avatar.reset();
-```
-
-可用动作：
-
-`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `send` · `success` · `failure` · `warning` · `inspect` · `blocked` · `error` · `surprise` · `love` · `random` · `sleep` · `wake`
-
-`failure` 用于表示任务执行完成但结果失败；`error` 用于连接、服务或系统错误。
-
-`love` 用于表达喜欢或感谢：两只眼睛向中间靠拢合成一颗爱心，跳动三下后恢复。
-
-`random` 播放老虎机式的转动：两只眼睛各自在滚筒上滚动，随后左眼减速、弹跳着停下，右眼稍后停下。`slot` 是它的别名。
-
-一个典型的 Agent 请求流程：
-
-```js
-avatar.startWaiting();
-
-// 第二种等待：眼睛从一侧转出，再从另一侧转入。
-avatar.startWaiting({ variant: 'wrap' });
-
-try {
-  const result = await runAgentRequest();
-  await avatar.play(result.ok ? 'success' : 'failure');
-} catch (error) {
-  await avatar.play('error');
-}
-```
-
-## 常用选项
-
-```html
-<agent-robot-avatar
-  size="160"
-  color="#08090b"
-  auto-sleep="30000"
-  wake-on="activity"
-  motion="auto">
-</agent-robot-avatar>
-```
-
-| 属性 | 用途 |
-| --- | --- |
-| `size` | 头像像素尺寸 |
-| `color` | 头像主色 |
-| `auto-sleep` | 自动睡眠前的空闲时间；`0` 为关闭 |
-| `wake-on` | 自动唤醒策略：`activity`、`interaction` 或 `manual` |
-| `motion` | 动态效果策略：`auto`、`reduce` 或 `full` |
-| `press-squeeze` | 按住头像中心进行挤压；设为 `false` 可关闭 |
-| `antenna-drag` | 拖动天线、弹簧复原并接愤怒表情；设为 `false` 可关闭 |
-
-常用运行时控制：
-
-```js
-avatar.setPointerFollow(false);
-avatar.setHeadRoundness(75);
-avatar.setAntennaFlash(true);
-avatar.setPressSqueeze(true);
-avatar.setAntennaDrag(true);
-```
-
-按住头像中心会开始挤压；移动超过 4 个 CSS 像素后，同一次指针操作会切换为原有的头部拖动。拖动天线沿用头部拖动的距离限制，复原后接原有的愤怒反应。
-
-## 事件与集成
-
-组件通过 `face-state` 报告视觉状态变化，通过 `action-state` 报告语义动作生命周期变化。
-
-宿主应用集成和无障碍状态播报优先使用 `action-state`。可查看 [`examples/accessibility.html`](../examples/accessibility.html) 中的请求生命周期示例。
-
-最小集成示例位于 [`examples/basic.html`](../examples/basic.html)。
-
-## 兼容性
-
-面向支持 ES Modules、Custom Elements、SVG、Pointer Events、Web Animations API、`IntersectionObserver`、`ResizeObserver` 和 `matchMedia` 的现代浏览器。
-
-自动浏览器测试覆盖 Chromium、Firefox 和 WebKit。
-
-## 参与贡献
-
-欢迎提交 Issue 和 Pull Request。提交修改前请阅读 [`CONTRIBUTING.md`](../CONTRIBUTING.md)。
-
-## 项目状态
-
-**当前公开版本：v0.5.2**
-
-公开 API 会在未来 `1.0.0` 稳定性承诺前继续保持精简并谨慎演进。
-
-Agent Robot Avatar 为独立开发的开源项目，不隶属于、代表或获得任何 AI 平台或品牌的官方背书。
-
-## 角色设计与视觉标识
-
-Agent Robot Avatar 角色，包括机器人外观与视觉标识，均为 CX ArtLab 的原创设计。
-
-MIT License 适用于软件和源代码，允许在应用中使用、修改和分发该头像，但不会转移 Agent Robot Avatar 名称、角色身份或视觉标识的所有权，也不授予将其作为其他方原创角色或独立品牌进行展示的权利。
-
-本项目提及的第三方产品名称仅用于说明可能的使用场景，不代表任何关联或官方认可。
-
-## 许可证
-
-MIT License。详见 [`LICENSE`](../LICENSE)。
-
----
-
-## 请我喝杯咖啡
-
-如果这个项目对你有帮助，也可以请我喝杯咖啡：
-
-| Ko-fi | 支付宝 | 微信支付 |
-| --- | --- | --- |
-| <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="支付宝收款码" width="160"> | <img src="../assets/support/wechat-pay.png" alt="微信支付收款码" width="160"> |

package/docs/README.zh-TW.md

@@ -1,186 +0,0 @@
-# Agent Robot Avatar
-
-<p align="center">
-  <img src="../assets/readme/agent-robot-avatar-header.jpg" alt="Agent Robot Avatar">
-</p>
-
-[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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Русский](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ru.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.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) | [日本語](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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md)
-
-![Version](https://img.shields.io/badge/version-v0.5.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
-
-![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square)
-
-一個輕量、富有表現力的機器人頭像 Web Component，適用於 AI Agent 與互動式應用。
-
-可用於 AI 助理、Agent 介面、桌面夥伴、虛擬寵物、數位吉祥物、聊天機器人頭像，以及其他互動角色體驗。
-
-適用於 AI 助理與 Agent 介面，包括類似 ChatGPT、Claude、Codex、Cursor、Grok Bot、Gemini CLI 與 OpenCode 的產品與體驗。
-
-使用 SVG 與原生 JavaScript 建構，以原生 Custom Element 運作，執行階段零依賴。
-
-Agent Robot Avatar 也可作為 AG-UI 風格 Agent 介面的視覺回饋層。
-
-<p align="center">
-  <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 互動動畫示範" width="560">
-</p>
-
-## 線上 Demo
-
-[開啟互動 Demo](https://cx-artlab.github.io/agent-robot-avatar/?lang=zh-TW)
-
-## 特點
-
-- 原生 Web Component
-- SVG 渲染 + 原生 JavaScript
-- 執行階段零依賴
-- 自動眨眼與輕微待機動作
-- 眼睛跟隨指標與頭部慣性移動
-- 果凍式局部拖曳形變與彈性復原
-- 按住擠壓與可拖曳的彈簧天線互動
-- 可透過程式控制 Agent 狀態與表情
-- 支援 waiting、success、failure、warning、review、blocked、system error 等回饋
-- 支援減少動態效果
-- 可設定自動睡眠行為
-- 可調整頭部圓角
-- 可選天線狀態閃爍
-- 內含 TypeScript 型別宣告
-
-## 安裝
-
-```bash
-npm install agent-robot-avatar
-```
-
-```js
-import 'agent-robot-avatar';
-```
-
-也可以直接載入儲存庫原始碼：
-
-```html
-<script type="module" src="./agent-robot-avatar.js"></script>
-```
-
-接著加入元件：
-
-```html
-<agent-robot-avatar id="avatar"></agent-robot-avatar>
-```
-
-不需要初始化程式碼，頭像會自動進入預設待機狀態。
-
-## 基本用法
-
-```js
-const avatar = document.querySelector('#avatar');
-
-avatar.play('success');
-avatar.play('warning');
-avatar.play('error');
-
-avatar.reset();
-```
-
-可用動作：
-
-`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `send` · `success` · `failure` · `warning` · `inspect` · `blocked` · `error` · `surprise` · `love` · `random` · `sleep` · `wake`
-
-`failure` 用於表示任務執行完成但結果失敗；`error` 用於連線、服務或系統錯誤。
-
-`love` 用於表達喜歡或感謝：兩隻眼睛向中間靠攏合成一顆愛心，跳動三下後恢復。
-
-`random` 播放老虎機式的轉動：兩隻眼睛各自在滾筒上滾動，隨後左眼減速、彈跳著停下，右眼稍後停下。`slot` 是它的別名。
-
-典型的 Agent 請求流程：
-
-```js
-avatar.startWaiting();
-
-// 第二種等待：眼睛從一側轉出，再從另一側轉入。
-avatar.startWaiting({ variant: 'wrap' });
-
-try {
-  const result = await runAgentRequest();
-  await avatar.play(result.ok ? 'success' : 'failure');
-} catch (error) {
-  await avatar.play('error');
-}
-```
-
-## 常用選項
-
-```html
-<agent-robot-avatar
-  size="160"
-  color="#08090b"
-  auto-sleep="30000"
-  wake-on="activity"
-  motion="auto">
-</agent-robot-avatar>
-```
-
-| 屬性 | 用途 |
-| --- | --- |
-| `size` | 頭像像素尺寸 |
-| `color` | 頭像主色 |
-| `auto-sleep` | 自動睡眠前的閒置時間；`0` 為關閉 |
-| `wake-on` | 自動喚醒策略：`activity`、`interaction` 或 `manual` |
-| `motion` | 動態效果策略：`auto`、`reduce` 或 `full` |
-| `press-squeeze` | 按住頭像中心進行擠壓；設為 `false` 可關閉 |
-| `antenna-drag` | 拖曳天線、彈簧復原並接憤怒表情；設為 `false` 可關閉 |
-
-常用執行階段控制：
-
-```js
-avatar.setPointerFollow(false);
-avatar.setHeadRoundness(75);
-avatar.setAntennaFlash(true);
-avatar.setPressSqueeze(true);
-avatar.setAntennaDrag(true);
-```
-
-按住頭像中心會開始擠壓；移動超過 4 個 CSS 像素後，同一次指標操作會切換為原有的頭部拖曳。拖曳天線沿用頭部拖曳的距離限制，復原後接原有的憤怒反應。
-
-## 事件與整合
-
-元件透過 `face-state` 回報視覺狀態變化，透過 `action-state` 回報語意動作生命週期變化。
-
-宿主應用整合與無障礙狀態播報建議優先使用 `action-state`。可查看 [`examples/accessibility.html`](../examples/accessibility.html) 中的請求生命週期範例。
-
-最小整合範例位於 [`examples/basic.html`](../examples/basic.html)。
-
-## 相容性
-
-面向支援 ES Modules、Custom Elements、SVG、Pointer Events、Web Animations API、`IntersectionObserver`、`ResizeObserver` 和 `matchMedia` 的現代瀏覽器。
-
-自動瀏覽器測試涵蓋 Chromium、Firefox 和 WebKit。
-
-## 參與貢獻
-
-歡迎提交 Issue 和 Pull Request。提交修改前請閱讀 [`CONTRIBUTING.md`](../CONTRIBUTING.md)。
-
-## 專案狀態
-
-**目前公開版本：v0.5.2**
-
-公開 API 會在未來 `1.0.0` 穩定性承諾前繼續保持精簡並謹慎演進。
-
-Agent Robot Avatar 為獨立開發的開源專案，不隸屬、代表或獲得任何 AI 平台或品牌的官方背書。
-
-## 角色設計與視覺識別
-
-Agent Robot Avatar 角色，包括機器人外觀與視覺識別，均為 CX ArtLab 的原創設計。
-
-MIT License 適用於軟體和原始碼，允許在應用中使用、修改和散布該頭像，但不會轉移 Agent Robot Avatar 名稱、角色身分或視覺識別的所有權，也不授予將其作為其他方原創角色或獨立品牌展示的權利。
-
-本專案提及的第三方產品名稱僅用於說明可能的使用情境，不代表任何關聯或官方認可。
-
-## 授權條款
-
-MIT License。詳見 [`LICENSE`](../LICENSE)。
-
----
-
-## 請我喝杯咖啡
-
-<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>