用途:用于指导选择、安装与编写 Aries Tools 的 actor 相关包,涵盖六个 actor-kit 包、四个 @ariestools/cli-kit* 与五个 @ariestools/browser-kit* 包,以及从 @ariestools/actor-system、host-kit 1.x、已退役 @ariestools/actor-cli 和 npm 已弃用 @xyo-network/actor-cli-kit* 垫片的迁移。核心模型是一个与宿主无关的引擎 @ariestools/actor-engine,负责编译配置、解析单一 provider 图、构造并监督 actor;领域代码依赖 actor 与 actor-engine,不依赖宿主套件。cli-kit 增加 Node 进程边界并使监督变为顺序式;browser-kit 增加领域边界并保留引擎默认的并行方式。两个 2.x 宿主套件仍需旁边的已弃用 actor-system 别名。
主要能力与要点:用 await X.create(params) 在 @creatable() 下创建 actor(new 会抛错);name 是品牌化 CreatableName,需强制转换。引擎启动的 actor 默认没有 logger、meter 或 tracer,AccountProviderActor 缺少 logger 会抛错,需通过 provisioner 提供 locatorContext。actor-engine 不重新导出 actor 类,应从 @ariestools/actor 导入 Actor、PeriodicActor、ProviderActor,从 @ariestools/provider 导入 NoProviderConnection。查找未声明的 moniker 会抛 ActorEngineDependencyAccessError,tryGetInstance 不绕过检查。已编译引擎或浏览器系统持有工厂且不跨领域,只有 BrowserSystemManifest 可跨。运行时以 Node 26 为下限(@ariestools/cli-kit-daemon 为 26.9),actor-kit 声明的 >=18 偏低。
用法:本技能基于 xy-development、xy-toolchain 和 ariestools-sdk,按任务加载参考(概览与安装、 Actors、Providers 与解析、Actor 引擎、CLI 宿主、浏览器宿主、迁移、相关技能)。安装命令:npx skills add ariestools/ariestools-skills --skill ariestools-actor;在 xy 仓库中可用 pnpm xy skills pick --skill ariestools-actor,或在 10.1.3 及之前用 pnpm xy skills add ariestools/ariestools-skills --skill ariestools-actor -y。
限制:不覆盖 @ariestools/sdk 工具(见 ariestools-sdk)、构建与 lint 等(见 xy-toolchain)、@ariestools/sdk-react* 的 React UI、XL1 特化(见 xyo-skills);@ariestools/cli 是产品而非套件,也不在范围内。源码为私有仓库,其 README 常滞后于代码。其他细节暂未提供。