关于 tesseract-editor
tesseract-editor 是用于构建基于浏览器的 Tesseract `.tsrct` 项目编辑器的技能,介绍如何通过浏览器运行时在本地打开、预览、编辑和保存项目,并说明该运行时不支持视频导出。
主要功能
- 01在本地打开并预览 `.tsrct` 项目
- 02通过浏览器引擎 API 编辑
- 03将文档及原始资源保存为 Blob
- 04使用引擎动作和分组编辑
- 05确保运行时资源与版本一致
适用场景
- 01构建静态 HTML Tesseract 编辑器
- 02添加播放和选择控件
- 03在本地保存编辑后的项目文档
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mirage-hq/ tesseract --skill tesseract-editor安装后在 Claude Code 中输入/tesseract-editor确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlassets/icon.svgexamples/bouncing-ball/app.jsball.tsrctindex.htmlmotion.jsREADME.mdstyle.cssexamples/timeline-editor/app.jsindex.htmlREADME.mdstyle.cssreferences/browser-api.mdcli-version.txtconversion.mdinstallation.mdversions.md详细介绍
构建 Tesseract 编辑器
如果编辑器需要导入或导出其他工具的项目格式,例如 Premiere Pro 或 After Effects,请阅读转换。打开共享或较旧的 .tsrct 文件、更新工具,或调查加载/渲染差异时,请阅读版本与兼容性。
浏览器引擎可在本地打开、预览、编辑和保存 .tsrct 项目。静态 HTML 应用即可满足需求;无需后端或原生 CLI。浏览器运行时不支持导出视频。
浏览器 API 参考介绍了初始化、操作、播放和保存。示例:常规图层控制和控制捆绑项目。
运行时与服务
如果存在 references/cli-version.txt,其中也指定了浏览器运行时版本。安装参考列出了发布仓库。浏览器资源文件为 tesseract-<VERSION>-web.zip 及其 .sha256 文件;使用前请验证校验和。压缩包包含 runtime/,示例中会将其与 index.html 放在一起。生成的 JavaScript、类型定义和 WASM 必须来自同一版本。无需安装 npm。version() 会返回运行时版本。
编辑器需要通过 HTTP 提供服务,并且浏览器需支持 GPU/媒体功能。其 HTML 依赖运行时文件;附件查看器可能无法执行 WASM。CLI 或技能更新无需升级现有编辑器的运行时。
编辑与保存
actionSchema() 描述引擎支持的操作。UI 控件、播放调度和选择手势由应用负责。等待渲染完成,以免帧相互重叠;编辑组会将连续更改合并为一条历史记录。
TesseractEngine.create(file) 接受 File 或 Blob。toBlob() 会将当前文档及其原始资源打包,但不会写入磁盘。覆盖源文件可能导致资源读取失效;API 参考介绍了如何重新打开保存的 Blob。刷新页面会丢弃未保存的编辑。