mcpField
T
tesseract-editor

tesseract-editor

github.com/mirage-hq开发1621.3k 次安装1 天前更新
代码仓库

关于 tesseract-editor

tesseract-editor 是用于构建基于浏览器的 Tesseract `.tsrct` 项目编辑器的技能,介绍如何通过浏览器运行时在本地打开、预览、编辑和保存项目,并说明该运行时不支持视频导出。

主要功能

  1. 01在本地打开并预览 `.tsrct` 项目
  2. 02通过浏览器引擎 API 编辑
  3. 03将文档及原始资源保存为 Blob
  4. 04使用引擎动作和分组编辑
  5. 05确保运行时资源与版本一致

适用场景

  1. 01构建静态 HTML Tesseract 编辑器
  2. 02添加播放和选择控件
  3. 03在本地保存编辑后的项目文档

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mirage-hq/tesseract --skill tesseract-editor

安装后在 Claude Code 中输入/tesseract-editor确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
icon.svg
examples/bouncing-ball/
app.js
ball.tsrct
index.html
motion.js
README.md
style.css
examples/timeline-editor/
app.js
index.html
README.md
style.css
references/
browser-api.md
cli-version.txt
conversion.md
installation.md
versions.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。刷新页面会丢弃未保存的编辑。

评论

支持 Markdown