Skip to content
cccskills
FreePublished on GitHub

harmonyos-motion-vocabulary

把用户对 HarmonyOS、ArkUI、Canvas 或代码生成产品动效的模糊描述转换为准确术语、相近概念和可能的 ArkUI 能力,例如“松手像急刹车”“拖过头有阻力”“页面像从同一个卡片长出来”“后端没完成却显示成功”。用于命名、检索和编写提示词;不要用于完整设计审视、传统视频剪辑、镜头叙事、直接实现或构建问题。

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (1)

  • SKILL.md7.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

HarmonyOS 动效词汇

只做一件事:把模糊的视觉或手感描述转换为准确术语。

适用边界

  • 强适用:ArkUI 交互界面、Canvas/RenderNode 产品动效;
  • 部分适用:由代码明确控制时间、几何、排版和状态的非交互产品视频;
  • 不适用:传统剪辑、镜头叙事、实拍、生成式视频黑盒。

非交互视频可以使用节奏、连续性、错峰、形变、曲线等术语,但不要套用按下反馈、焦点、可打断输入等交互词汇。对缺少已核验官方资料的第三方工具,不对其具体能力作假设。

输出格式

**术语** — 一句话定义。

ArkUI 关联:`可能的 API 或能力`
边界:何时不是这个术语。

有多个可能时,先给最佳匹配,再给 1–2 个近义概念。

词汇表

输入与反馈

  • 按下反馈(Press feedback) — 在 Touch Down 时立即改变控件状态,证明输入已被接收。
  • 提交(Commit on release) — 抬起且仍位于有效目标内时执行动作。
  • 取消回拖(Cancel and re-enter) — 手指移出目标可取消,重新移入可恢复候选状态。
  • 焦点态(Focus state) — 键盘、遥控器或旋钮当前操作目标。
  • 悬停态(Hover state) — 光标到达可交互对象时的反馈。
  • 激活态(Active/selected state) — 控件或导航项已经被选择的持久状态。

连续手势

  • 跟手(Direct tracking) — 对象在手势过程中持续随手指或指针变化。
  • 速度继承(Velocity handoff) — 离手动画沿用离手前速度,不从零开始。
  • 动画衔接(Animation continuity) — 目标改变时从当前动画状态平滑进入新动画。
  • 可打断动画(Interruptible motion) — 动画中可被新输入接管、反向或重定向。
  • 边界阻尼(Boundary resistance) — 越过边界越难继续拖动,而不是硬停止。
  • 回稳(Settle) — 离手后向边界、吸附点或稳定状态运动。
  • 抛滑(Fling) — 离手带方向和速度的滑动。
  • 吸附(Snap) — 根据位置和速度选择离散目标点。

ArkUI 关联:

  • 跟手:curves.responsiveSpringMotion();
  • 回稳/速度衔接:curves.springMotion();
  • 显式物理:curves.interpolatingSpring()。

曲线

  • 标准曲线(Standard curve) — 对象前后都在屏内的加速—减速变化。
  • 减速曲线(Decelerate) — 开始快、结束慢,常用于进入视线。
  • 加速曲线(Accelerate) — 从静止逐渐加速,常用于退出视线。
  • 弹性曲线(Spring) — 由响应、阻尼或质量、刚度、速度决定的物理运动。
  • 临界阻尼(Critical damping) — 不振荡并尽快稳定。
  • 欠阻尼(Underdamped) — 越过目标并振荡后稳定。
  • 过阻尼(Overdamped) — 不越过目标,但更慢地接近稳定。

转场

  • 同层转场 — Tab、编辑模式等相同层级状态变化。
  • 上下层转场 — 父页面与子页面之间的进入和返回。
  • 跨层转场 — 应用或任务上下文之间的切换。
  • 共享元素转场 — 同一对象在两个页面之间连续移动和变化。
  • 共享容器转场 — 容器边界、大小、圆角连续变化,内部内容再切换。
  • 共享动势 — 无法直接共享对象时,保持位移、缩放或旋转的共同运动趋势。
  • 一镜到底 — 使用共享关系让转场看起来不中断。
  • 交叉淡化(Crossfade) — 一个状态淡出、另一个淡入。

ArkUI 关联:geometryTransition()、Navigation 默认或自定义转场。

编排与微动效

  • 错峰(Stagger) — 多个元素以小间隔依次出现。
  • 数值脉冲(Value pulse) — 数字变化时短暂缩放或透明度反馈。
  • 图标抬升(Icon lift) — 选中图标轻微位移以表达激活。
  • 状态形变(State morph) — 同一对象在两个状态间连续改变形状或容器。
  • 微动效(Micro-interaction) — 小范围、短时、承担反馈或状态说明的运动。

这些通常是 House Style,不是统一官方要求。

异步状态

  • 本地确认(Acknowledged) — 客户端已收到输入,但远端尚未完成。
  • 处理中(Pending) — 操作正在等待后端、设备或耗时任务。
  • 真实确认(Confirmed) — 业务结果已经被权威状态确认。
  • 乐观更新(Optimistic UI) — 在远端确认前先更新界面,并准备失败回滚。
  • 回滚(Rollback) — 乐观结果失败后恢复先前真实状态。
  • 虚假完成(False completion) — 动效或播报暗示成功,但真实状态尚未确认。
  • 响应乱序(Out-of-order response) — 旧请求比新请求晚返回并可能覆盖新状态。

用户说“动画在撒谎”时,最佳匹配通常是 虚假完成 或 异步状态不真实,不是简单的缓动问题。

适配与可访问性

  • 交互归一 — 同一任务在触摸、鼠标、键盘、遥控器等输入下使用符合习惯的方式完成。
  • 多态控件 — 同一控件针对不同设备、输入和场景呈现不同形态与状态。
  • 自适应布局 — 元素随容器连续拉伸、缩放、延伸、隐藏或折行。
  • 响应式布局 — 布局在断点处变为缩进、挪移、重复或分栏。
  • 语义 Token — 用用途命名而不是用具体数值命名的设计参数。
  • 永恒基础层(Evergreen Foundation) — 预期跨多个视觉版本成立的反馈、连续性、层级、可读性和真实性原则。
  • 版本化平台层(Versioned Platform Layer) — 随 HarmonyOS/OpenHarmony/ArkUI 版本更新的组件、视觉语言、API 和默认行为。
  • 项目覆盖层(Project Overlay) — 品牌、业务风险和 House Style 对平台的产品化表达。
  • 无障碍分组 — 将相关节点作为一个语义整体播报。
  • 虚拟无障碍节点 — 为自绘内容提供辅助工具可识别的结构。

示例

用户:

卡片拖出去以后,松手那一下像突然刹车,然后才回去。

输出:

**速度继承(Velocity handoff)缺失** — 离手后的回稳动画没有沿用手势最后速度,因此在松手点产生速度断层。

ArkUI 关联:跟手阶段检查 `responsiveSpringMotion()`,离手回稳检查 `springMotion()`。
边界:若卡顿来自掉帧而不是速度归零,则属于性能长帧,不是速度继承。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

审视、设计、从零启动或改进 HarmonyOS、OpenHarmony 与 ArkUI 产品界面。用于检查 ArkTS UI、建立新项目设计基线、区分永恒原则与当前平台视觉语言、规划跨手机/平板/折叠屏/PC 的导航和布局、多输入控件状态、animateTo、transition、geometryTransition、springMotion、手势跟手与可打断动效、异步状态真实性、视觉分层参数、无障碍或动画性能,或建立鸿蒙 Motion Token 时。不要用于签名、构建、网络、存储、权限、数据库等纯工程问题,也不要用于通用视频剪辑或其他移动平台的设计规范评审。

The English summary is being prepared. Showing the original description.

dososo/HarmonyOS-Design38Updated Jul 15, 2026

严格审视 HarmonyOS、OpenHarmony 与 ArkUI 产品或代码,只报告有证据的设计、导航、跨设备适配、输入状态、动效、异步状态真实性、无障碍和动画性能问题,并给出规则 ID、ArkUI 落点与通过结论。用于用户明确要求 review、audit、审查、验收或评估鸿蒙 UI;不要用于从零设计、直接实现功能、修复构建签名或审查非界面代码。

The English summary is being prepared. Showing the original description.

dososo/HarmonyOS-Design38Updated Jul 15, 2026

See all skills by dososo

Report a problem with this skill