EasyTwin(EasyTwin DevKit 插件)
EasyTwin 第三方应用开发工具集的 VSCode 插件(薄壳,零业务逻辑,所有能力来自 @easytwin/devkit lib,devkit 已随本插件打包,离线可用)。
功能
- 配置向导:UI 收集 App ID / App Secret / Base URL,生成
.easytwin/easytwin.config.json(自动加入 .gitignore)。
- 场景树视图:侧边栏列出凭据可见的场景,点击打开预览;刷新列表时把场景 id/名称等摘要写入
.easytwin/easytwin.config.json.scenes;展开场景时拉取快照并写入 .easytwin/scenes/<id>.scene.json。
- 场景预览 webview:三维场景页。script 从官方 OSS 引入 twin runtime,本地打包 apps/host;提供铺满面板的 DOM 根节点由 runtime 注册 canvas;系统库(draco/basis/webp)与组件脚本从官方 OSS(可用 ossUrl 覆盖)在线加载。右下角有调试日志 / 开发者工具。
- 上传:以工作区根为目录、不弹选文件夹;跳过插件产物与相关文件;全量覆盖警告(不可逆)→ lib 对照远端区分新增/更新/删除,进度回调驱动进度条。
- skills sync:命令面板命令;检测到工作区含
.easytwin/easytwin.config.json 且 skills 缺失/过期时提示一次。
使用
- 命令面板(Ctrl+Shift+P)搜索
EasyTwin。
- 首次使用:先运行 EasyTwin: 初始化配置 填写凭证。
- 场景树出现在活动栏 EasyTwin 图标下。
- 预览失败时:点 webview 右下角 调试日志,或命令 EasyTwin: 显示预览调试日志(Output 通道「EasyTwin Preview」);开发者工具对应 VSCode 的
Developer: Open Webview Developer Tools。
要求
- VSCode ≥ 1.90
- 需要打开一个工作区文件夹(配置与 skills 同步以项目根为锚点)
- 场景预览需要网络可达官方 OSS(系统库与组件脚本按 ossUrl 在线加载)及 API 服务端(拉场景)
| |