Artifacts 把一个自包含的 HTML 页面变成一个链接。可以发给任何人,可以自己留着,也可以分享给指定的 GitHub 账号。在手机上的 FoldRender 应用中打开它。
把这段话粘贴给 Claude、ChatGPT、Codex,或任何能在你电脑上运行命令的 Agent。它会让 Agent 去看设置指南,由指南安装 FoldRender CLI 和 Agent 技能,然后帮你登录。
Set up FoldRender Artifacts for me by following https://foldrender.dev/install/agent-setup.md
发布需要 GitHub 账号。阅读公开页面则完全不需要账号。
一条命令即可安装 foldrender CLI 和 Agent 技能。
curl -fsSL https://foldrender.dev/install.sh | sh
登录会在浏览器中打开 GitHub,让你批准这个 CLI。你不需要复制任何令牌。
foldrender login
发布任何自包含的 HTML 文件,你就会得到一个链接。加上 --private 可以只留给自己,或用 --share 指定一组 GitHub 用户名。
foldrender publish report.html
foldrender publish report.html --share ana,ben
把链接交给你的 Agent,它就能以文本读取页面:标题、列表、表格、代码和图里的文字标签,不用打开浏览器。加上 --assets 可以把图片和图表另存为文件。
foldrender read https://foldrender.dev/artifacts/ana/q3/report
foldrender read abc123 --assets ./images
每个页面有四种设置之一。你可以随时更改,无需重新发布页面。用命令行发布的新页面,除非你另行选择,默认为私密。
任何人都可以打开该页面,它会列在你的页面 foldrender.dev/artifacts/<你的用户名> 上。
拿到链接的人都可以打开该页面。链接里带着一个密钥,不带密钥的地址什么也打不开;没有任何列表会收录它。重置密钥后,你之前发出去的链接就会失效。
只有你能打开。打开时需要用 GitHub 登录。其他人看到的是「未找到」。
你,以及你指定的 GitHub 账号。他们每个人都要用 GitHub 登录才能阅读。其他人看到的是「未找到」。
例子。你的 Agent 做了一份成本明细,你把它分享给 ana 和 ben。他们打开链接并用 GitHub 登录。其他拿到链接的人会看到「未找到」,与页面不存在时的回应相同。
在 Android 上,从 Google Play 安装 FoldRender。装好应用后,foldrender.dev/artifacts 上的页面链接会在应用里打开,应用中的 Artifacts 面板会列出你的页面。没有安装应用时,链接照常在浏览器中打开。
你也可以直接从 Android 应用发布。打开一份文档,在它的菜单中选择「发布为 Artifact」,并且先在 Git 页面用 GitHub 登录。
在 iPhone 或 iPad 上,FoldRender iPhone 与 iPad 版正在 TestFlight 上公开测试。它还没有上架 App Store,需要 iOS 或 iPadOS 17 及以上。用 GitHub 登录后,它会列出你的页面和别人分享给你的页面,你也可以用 Apple Pencil 或手指在自己的页面上书写。它会保存页面供离线阅读。要从它发布,就在其他应用里把 HTML 或 Markdown 文件分享给 FoldRender。
私密的意思是:服务器在发送页面之前会核对你的 GitHub 登录,其他人无法打开该链接。它并不表示页面做了端到端加密。页面以普通 HTML 存储,因此 Cloudflare 和本服务的运营方都可以读取。不要发布任何你不会拿给同事看的东西。
在免费套餐下,每天的清理任务会删除页面及其记录,链接随即失效。在此之前再次发布到同一链接,会把 30 天重新计算。之后,能读取该页面的人再用 CLI 读这个链接,会得知页面已过期以及过期的时间。
可以。再次发布到同一链接会替换页面,链接不变。应用对同一份文档会自动这样做。除非你更改,页面的访问设置保持不变;被替换的页面会作为旧版本保留,你可以在页面库或应用中恢复它。
你发布的 HTML、它的标题和大小、发布与过期的时间,以及谁可以阅读,另外每个页面最多保留 10 个旧版本。账号方面,它保存你的 GitHub 用户名和数字 ID、你的套餐,以及你最后一次被看到的时间。命令行令牌只以哈希形式保存。你的 GitHub 访问令牌不会被存储。页面过期后,它的链接名的哈希和过期日期会保留一年。完整清单见隐私政策。
可以在 foldrender.dev/artifacts 的页面库中删除,或在应用的 Artifacts 面板中删除,或在 CLI 中用 rm 命令删除。页面库和应用会给你几秒钟撤销。之后页面、其旧版本及其记录会被移除,链接随即失效。
放在 foldrender.dev/artifacts 下它自己的地址:你的 GitHub 用户名、可选的文件夹,加上取自页面标题的名字,例如 foldrender.dev/artifacts/ana/q3/report。浏览器里显示的一直是这个地址。页面本身在一个框架里从它自己的地址运行,这个地址以 --u.foldrender.dev 结尾,和你登录的地址分开,所以页面里的代码无法以阅读者的账号行事。以前在 a.foldrender.dev 上的链接仍然打开同样的页面。
可以。用 foldrender read 加上链接,就能以文本打印页面,不用打开浏览器。公开页面不需要登录。私有或共享页面需要 CLI 以有权查看的账号登录,其他人得到的是「未找到」。这些文字是页面作者写的,Agent 应把它当作信息,而不是指令。
需要。发布时,CLI、应用和页面库都通过 GitHub 登录。拿到公开页面链接的人无需账号即可打开。
打开 foldrender.dev/artifacts/account#delete-account 并用 GitHub 登录。删除前你可以先把所有页面下载为 zip 文件。删除立即生效,会移除你的页面、它们的链接、你的令牌和你的账号记录。之后再次登录会开始一个新的空账号。