用途:该技能面向 @xyo-network/dapp-kit* 应用契约层,用于构建可移植、无头的 XL1 dApp 运行时。UI、CLI 与 HTTP 均视为客户端;索引与投影可重建,已最终化的 XL1 是规范排序基底。它位于 xl1-patterns 之上、xl1-knowledge 之下,属于 XYO 技能栈第 6 层,上承 xy-development、xy-toolchain、xyo-knowledge、xl1-knowledge、xl1-patterns,下接 xl1-testing、xl1-scaffold、xl1-build。
主要能力:覆盖定义、配置、计划、化身、宿主、引擎与系统等词汇;区分 xl1.dapp.json 与 xl1.deploy.json 两个清单;提供 xl1-dapp CLI(init、validate、inspect、build、plan、dev、test);支持分阶段 XL1 效果与效果日志、预备 sidecar、中立的 plan/reconcile/recover 辅助以及 SIGKILL 安全恢复;提供 WebSocket / MessagePort 上的类型化命令、查询、状态与管理帧及固定 /_xl1/* 路径;涉及 Event Kit 唤醒、持久事件与订阅游标;覆盖 Node 与浏览器宿主、Vercel/Cloudflare 组合、xl1-dapp-vercel CLI,以及仅 schema 的 Kubernetes/Proxmox 目标计划与失败关闭策略;并定义 L1–L9 证据阶梯与运行器证据标签。
使用方式与限制:@xyo-network/dapp-kit* 已在 npm 发布(3.x 线,公共访问,LGPL-3.0-only;2.1.1 之前版本为 UNLICENSED),存在本地 UC-01..03 与适配器。其源码仓库为私有,docs/STATE.md、DAPP_KIT_CONTRACT.md 等为 XYO 内部资料,外部以各发布包 npm README 为准。需要定义/计划/端口/恢复/一致性而非仅 Vite UI 时再迁移。本地一致性建议使用 @xyo-network/dapp-kit-vitest-config 与本地 dapp-kit 栈,不能以本地测试声称托管资格。生产或托管证据门可能因消费方而仍开放,需检查部署证据标签。每个计划、确认与完成摘要中应按 xl1-dapp-kit v<version> 报告。