artifact-site

artifact-site

English | 简体中文 | 日本語 | Deutsch | Français | Español

如今可供选择的 AI Agent 越来越多，但它们的输出散落在你的电脑、聊天记录和不同平台的云端，很难整理、分享和回顾。

artifact-site 是面向个人和团队的可自托管工作空间，类似 Claude Artifacts 或 OpenAI Sites。 你使用的各种 Agent 负责创建内容；artifact-site 将这些内容汇集起来，把页面和文档转化为链接，方便分享、评论和反馈，并提供访问控制和版本历史。你现有的 Agent 可以继续通过命令行或 MCP 编辑、发布、搜索和更新这些内容。

你可以自行托管 artifact-site，也可以使用 Lexmount 托管的云版本。

使用云版本 — 由 Lexmount 托管，无需部署。拖放文件即可发布并获取可分享的链接。无需登录即可上传；或者使用 Google 或 GitHub 登录，以保留你的网站、将其整理到文件夹中，并控制谁可以打开每个链接。

匿名上传会在几天后过期。

_{拖入文件，获取链接，分享出去。 在线查看已发布的内容，并在分享设置中选择谁可以打开。}

为什么选择 artifact-site

• 将内容集中在一处。 将页面和文档整理到文件夹中，并通过全文搜索（包括中文）查找内容。团队成员和 Agent 可以找到他们有权访问的内容。
• 拖入即可分享。 上传 HTML、构建文件夹、ZIP 文件或文档，即可获取链接。大型网站会分块上传。你可以与所有人、已登录用户、指定人员或持有密码的人分享。
• 持续改进已发布的内容。 在浏览器中编辑 HTML 文本或源代码，或让 Agent 更新整个网站。每次更改都会保留一个版本，你可以回滚或另存为副本。
• 让 Agent 接续之前的工作。 通过指南、CLI 或 MCP 发布和更新内容，然后按内容搜索并读取可提取的文本。例如，找到之前的报告，并在原地址更新，让团队查看。

对比

¹ Office 文档在线预览需要 Gotenberg。artifact-site 托管已完成的文件；它不会运行应用后端或构建任务。

Claude Artifacts 和 ChatGPT Sites 将内容创作与托管分享结合在一起。artifact-site 则通过在你自己的基础设施上提供共享空间，为不同工具生成的页面和文档补充这些工作流。

产品范围和分享功能会因套餐而异，并不断演进；请参阅官方指南：Claude Artifacts 和 ChatGPT Sites。

目录

• 可发布的内容
• 快速开始（本地部署）
• 连接编码 Agent
• 为团队部署
• 工作原理
• 文档
• 参与贡献
• 许可证

可发布的内容

上传前，请先将 Web 项目构建为静态文件；该平台不会运行应用后端或构建任务。PDF 和 Office 文档不支持可视化 HTML 编辑，扫描图片也不会自动进行 OCR。

托管页面在沙箱中运行，无法使用该平台的登录会话。外部 API 连接需要加入来源允许列表。请参阅运行时限制和安全设计。

快速开始（本地部署）

无需安装即可使用云版本。如需本地部署，请运行以下三条命令。你需要 Git、Make、Bash、Docker 24+ 和 Compose 插件 2.24+。在 macOS 上，请使用 Docker Desktop；在 Windows 上，请在 WSL2 中运行命令，并启用 Docker Desktop 的 WSL 集成。无需安装 Node，也不需要域名或身份提供商。

git clone https://github.com/lexmount/artifact-site.git && cd artifact-site
cp .env.example .env
make build up

启动后，打开 **http://127.0.0.1:4300**，然后拖入 HTML、静态网站文件夹或 PDF，即可查看你的内容。新建网站默认设为私有；分享前，请在“共享”中更改主链接的访问权限。

首次运行会下载依赖项并构建镜像，然后启动应用和 Postgres。请在全新克隆的仓库中使用这些命令。默认情况下，服务仅限本地访问；make down 会停止服务并保留数据。若要让团队能够访问，请参阅为团队部署。

printf '<!doctype html><meta charset="utf-8"><title>Hello</title><h1>Hello, artifact-site!</h1>' > hello.html

选择适合你的 Agent 的入口：

• Skill：npx skills add lexmount/artifact-site — 安装 Agent 技能，并向 Agent 提供你的服务 URL。
• CLI：npm install -g @artifact-site/cli — 需要 Node 24+；使用下方的命令。
• MCP：https://your-server/mcp — 通过服务的 OAuth 登录，将 ChatGPT、Claude 或其他 MCP 客户端连接到服务；无需安装 CLI。只能启动本地 MCP 服务的客户端可以改为运行 CLI 的 artifact-site mcp。

CLI 和 MCP 默认创建私有资源，不提供独立的分享链接。 用户要求分享主链接时，请使用 artifact-site visibility <slug> unlisted 或 MCP artifact_site_set_visibility。

_{也可以让编码 Agent 来完成。 配合 Agent 指南（/for-agents.md）、CLI 或 MCP 服务，只需一句“发布这个并给我一个链接”，就能完成操作 — 网站也可以用同样的方式更新、搜索和读取。}

将以下指令提供给 Claude Code、Cursor、Codex 或其他能够读取 URL 的编码 Agent，并使用它可以访问的服务地址。主页还提供了一个复制按钮，其中已填入你的服务地址：

Publish this project's output to artifact-site. Publishing guide: https://your-server/for-agents.md

CLI 示例（login 需要 OIDC）：

artifact-site login --base https://your-server        # one-time device sign-in
artifact-site publish dist/ --title "Q3 dashboard"    # publish and return links
artifact-site find "quota"                           # search by content
artifact-site read YOUR_SITE_SLUG                    # replace with a site slug to read its text

从 .env.example 开始，并按照 SELFHOST.md 进行生产环境部署。为 ARTIFACT_PUBLIC_URL 使用稳定的公共地址：登录回调、请求来源检查以及提供给 Agent 的地址都由此生成：

• 设置可访问的 ARTIFACT_PUBLIC_URL 并配置反向代理，或者设置 ARTIFACT_WITH_CADDY=on 和 ARTIFACT_DOMAIN，以启用 Caddy 和自动证书。
• 选择发布策略。login 要求使用 OIDC；token 可通过 Bearer 令牌为脚本或 Agent 提供服务；open 允许任何能够访问服务的人发布，适用于可信的内部网络。匿名发布支持单独的配额和过期时间。
• 连接 Google 或 Keycloak、Logto、Authentik、Okta、Auth0 等 OIDC 提供方。账户拥有站点和文件夹；Agent 可通过设备登录获取长期令牌。配置 OIDC 后，默认启用的 ARTIFACT_ENFORCE_OWNERSHIP=on 会开启基于账户的访问控制。将管理员已验证的登录邮箱添加到 ARTIFACT_ADMIN_EMAILS，以启用管理控制台。
• 设置 ARTIFACT_WITH_GOTENBERG=on，以启用 Office 预览。管理控制台可管理下架、配额、匿名站点过期时间和策略开关。选择默认可见性并安排备份。

该应用以单个 Docker 镜像的形式提供，在单主机配置中内置 Postgres。要使用可用的预构建镜像，请设置 ARTIFACT_IMAGE 并运行 make pull。make doctor 会检查配置；make backup 和 make restore 用于备份和恢复。有关多副本、外部 Postgres 和兼容 S3 的存储，请参阅 DEPLOY.md。

工作原理

• 应用和存储。 Next.js 提供 UI 和 API，Postgres 存储元数据，文件则存放在本地磁盘或兼容 S3 的存储中。外部数据库和对象存储支持运行多个应用副本。
• 不可变版本。 每次上传或编辑都会写入一个新文件版本，以保留历史内容。乐观锁（expected_version）可检测并发更新冲突。
• 内容隔离。 预览使用沙盒 iframe，不启用 allow-same-origin，并采用限制性 CSP，以隔离上传内容与平台。路径检查和解压缩限制可防范路径遍历和 ZIP 炸弹。

有关架构、数据模型和请求流程，请参阅 ARCHITECTURE.md。

文档

参与贡献

本地开发需要 Node 24+ 和 Docker：

npm install
make dev          # start a disposable Postgres and the development server
npm test          # unit tests, no external services needed

有关贡献流程、DCO 签署和 CI 要求，请参阅 CONTRIBUTING.md。请在 issues 中报告错误和提出想法；如有疑问，请在 discussions 中提问。

如果 artifact-site 对你有帮助，点个 ⭐ 就能让更多人发现它。你正在和团队一起使用吗？欢迎在 Discussions 中打个招呼——我们很乐意将你们列出来。

许可证

可选择以下任一许可证：

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT license (LICENSE-MIT)

除非你明确另行声明，否则你有意提交以纳入本项目的任何贡献均按上述双重许可进行许可，且不附加任何条款或条件。

© 2025–2026 LexMount。第三方组件列于 NOTICE。