UGT: Use the Geek Thing

你在 GitHub 上找到了它。现在就用起来。

粘贴你想使用的项目的 GitHub 链接。
UGT 帮你在电脑上安装并运行它，还会告诉你如何再次使用。
免费且开源。支持 Windows、Mac 和 Linux。

工作原理 · 开始使用 · 你可以用它做什么 · 为什么不直接问你的 Agent？ · 目录 · 分享你的配方 · 规则

工作原理

1. 从 GitHub 链接开始。 你也可以补充遇到的错误，或说明想用该项目做什么。
2. 按照适用于你电脑的安装说明操作。 UGT 会寻找现成的配置或项目自带的安装程序。如果需要进一步检查，你的 AI 应用会使用同一个链接和详细信息继续处理。配方是经过他人验证的安装配置；如果项目没有配方，你的 Agent 可以创建一个。
3. 使用生成的内容。 打开生成的文件或应用。文件任务会检查输出结果；停止并重新打开应用时，已保存的数据也会保留。如果运行失败，可以针对这次运行寻求帮助，无需重新开始对话。
4. 如果愿意，可以分享。 项目运行正常后，UGT 可以将你的配方提交到目录，让下一个人更快上手。

开始使用

将你的 GitHub 项目粘贴到 UGT。只需提供链接。如果你已经尝试安装，也可以附上遇到的错误。

UGT 会检查如何在你的电脑上使用该项目。如果它提供 在 UGT 中打开，就打开它；如果需要文件，请选择文件，然后运行。文件准备就绪后，UGT 会显示其所在文件夹。应用会在自己的地址打开。

如果项目需要进一步查看，请在桌面 AI 应用中继续操作。网站会将你的链接和备注带到项目消息中。如果需要安装 UGT，网站会显示设置方法。UGT 没有订阅费用；你的 AI 应用自身的使用限制和定价仍然适用。

GitHub 是世界上最大的免费软件宝库，但其中大多数项目都没能惠及需要它们的人，因为它们以代码而非应用的形式发布。UGT 能把任何项目变成你只需开口就能使用的工具。

_{以上是部分精选示例。你不需要目录中的配置方案：没有配置方案时，你的 Agent 会在首次运行时摸索出项目的用法。配置方案只是让过程更快，因为有人已经做好了。}

为什么不直接让 Agent 来做？

你的 Agent 能读取代码，但通常无法替你运行代码，而且每次都得从头开始。

• GitHub 上的大多数项目都假定使用 Linux。 在 Windows 和 Mac 上，你的 Agent 往往会碰壁。UGT 自带专用 Linux 引擎，一步即可设置，Linux 上也能使用：无需 Docker Desktop、无需账号，也无需学习新东西。在 Intel Mac 上，它会驱动你已有的引擎。
• 一次验证，之后人人都能快速上手。 第一个成功运行项目的 Agent，可能要花一小时来构建和修复问题：内存限制、架构错误的二进制文件、缺失的系统库、无法访问互联网的解析器。留下的配置方案能让下一个人直接下载运行。
• 验证结果，而非仅仅“启动了”。 容器启动不代表任务完成。每个配置方案都附带一项检查，只有实际输出符合要求才会通过：字幕时长与录音匹配、视频时长符合要求、网格模型确实可以打印。
• 你的机器，你的文件。 项目在沙盒中运行，只能访问其配置方案声明的文件和权限。目录会在收录配置方案前审查其访问权限；本地创建的配置方案若要访问常规沙盒范围之外的内容，UGT 会先征求你的同意。使用云计算需要你的同意，并会说明费用。

目录

配方是捷径，不是必需品。 每个配方都是某人已经用来完成一项工作的项目，并分享出来，让其他人不必再从头摸索。配方是 recipes/ 中任何人都能查看的一个文件夹：compose.yaml 包含所有运行所需的内容，recipe.json 则说明它的用途。一个项目可以有多个配方，每项工作对应一个。

你可以在 usegeekthing.com/recipes 浏览，也可以在 recipes/ 中阅读源文件。每个配方在收录前都已在干净的机器上验证过；新配方一经收录，所有人便可立即使用，无需更新 UGT。

_{验证意味着每项服务都按说明在干净的 amd64 和 arm64 机器上运行，并通过两项检查；而且这两项检查都能拒绝故意构造的错误输出。精选配方的镜像就是经过验证的镜像；其他配方则会在你的机器上基于相同的固定提交和基础镜像构建。}

recipes/openai/whisper/subtitles/
  compose.yaml    everything that runs: build, limits, mounts, network, and the four services
  recipe.json     what it is: project, commit, task, settings, the access it needs, licence
  Dockerfile      fetches the pinned source itself, so the build needs no clone
  check/          the check scripts

分享你的配方

有能完成实用任务的项目吗？分享出来，让下一个人能快速上手，而不必再从头摸索。

告诉你的 AI：“Use the Geek Thing: share this recipe”，或运行 ugt recipe submit。UGT 会从头重新检查项目能否运行，确保不会连同任何个人信息一起提交（你的文件、路径和密钥），并以你的身份创建拉取请求。随后，配方会在没有可用密钥的干净机器上接受验证；通过后便会收录。任何超出沙箱范围的配方都会先由维护者审核。

_{即将随 UGT 应用推出。在此之前，请从源代码运行：}

go install github.com/usegeekthing/ugt/cmd/ugt@latest
ugt recipe new <owner>/<repo> <task>     # start one, or adopt the project's own Compose file
ugt recipe verify <folder>               # until it passes
ugt login                                # once: approve a code in your browser
ugt recipe submit <folder>               # opens the pull request as you

ugt recipe submit --dry-run 会先准确显示将要提交的内容。CONTRIBUTING.md 和目录规则中有详细说明。

维护项目？“Run with UGT”徽章即将推出：将它放入你的 README，用户只需点击一次，就能在 UGT 中打开你的项目。

基本规则

• 你的文件仍归你所有。 输入文件会被复制。除非配方说明了原因且经维护者审核，或你明确同意，否则不会将你的主文件夹、密钥和容器引擎交给项目。
• 可以运行任何内容，但不隐藏任何事项。 配方可能需要互联网、文件夹、设备或其他资源。它必须逐项声明，UGT 会拒绝任何未声明的内容。目录收录配方前，维护者会先行审核；来自其他来源的配方则会在接触你的计算机之前征求你的同意。
• 没有证明，就不算完成。 没有检查，就没有成功。
• 由你决定。 安装、管理员权限提示、大型下载、账户、密钥和云计算都由你决定；在执行前都会明确征求你的同意。
• 密钥绝不会经由你的 Agent 传递。 UGT 会自行向你索取密钥，一次即可，并将它们保存在系统钥匙串中。
• 代码自带署名。 每个配方都会记录其所属项目的许可证，而从上游改编的文件也会保留原许可证。
• 你的文件绝不会离开你的计算机。 UGT 会向其目录查询项目包含哪些配方，下载配方所需的内容，并仅在你同意时发送运行报告：报告会记录运行了哪个配方以及运行结果，但绝不会包含你的文件、路径或输出。更多信息请见隐私政策。

许可证

Apache-2.0。每个打包项目都保留其自身的许可证。UGT 名称和徽标不在许可范围内；请参阅 NOTICE。UGT 独立运营，与 GitHub 无隶属关系。安全问题请提交至 SECURITY.md。

_{由 auscaster 制作}