artifact-site

artifact-site 是什么\nartifact-site 是一个自托管的工作空间，为个人和团队提供一个集中存放 AI 代理生成页面与文档的地方，定位类似于自托管版的 Claude Artifacts 或 OpenAI Sites。目前可选的 AI 代理很多，但它们的产出往往散落在本地电脑、聊天记录和不同平台的云端，难以整理、分享和回顾。artifact-site 把各类代理的作品汇聚起来，将页面和文档变成可分享、可评论、可控制访问并带有版本历史的链接。\n\n主要能力\n- 集中管理：用文件夹组织页面和文档，通过全文搜索（包括中文）查找。团队成员和代理只能找到自己有权访问的内容。\n- 一键发布与分享：上传 HTML、构建文件夹、ZIP 或文档即可获得链接。大型站点支持分块上传。可以分享给所有人、已登录用户、指定人员或持有密码的人。\n- 持续改进：在浏览器中编辑 HTML 文本或源码，也可以让代理更新整个站点。每次更改都会保留一个版本，支持回滚和另存副本。\n- 代理协作：通过 CLI 或 MCP 发布和更新，按内容搜索并读取可提取的文本。例如找到之前的报告，在同一地址更新后供团队查看。\n- 发布类型：可发布 HTML、构建文件夹、ZIP 和 PDF 等文件。网页项目需先构建为静态文件再上传；平台不运行应用后端或构建任务。PDF 和 Office 文档不支持可视化 HTML 编辑，扫描图片不会自动 OCR。\n\n使用方式\n云版本：由 Lexmount 托管，无需部署。拖拽文件即可发布并获得分享链接。可以不登录上传，也可以用 Google 或 GitHub 登录以保留站点、用文件夹组织并控制每个链接的访问权限。匿名上传会在几天后过期。\n本地部署：需要 Git、Make、Bash、Docker 24+ 和 Compose 插件 2.24+。macOS 使用 Docker Desktop；Windows 需在 WSL2 中运行并启用 Docker Desktop 的 WSL 集成。无需安装 Node、域名或身份提供商。在全新克隆的仓库中运行三条命令（首次会下载依赖并构建镜像，然后启动应用和 Postgres），打开 http://127.0.0.1:4300，拖入 HTML、静态站点文件夹或 PDF 即可查看。新站点默认私有，在 Sharing 中更改主链接访问权限后再分享。服务默认仅本地可访问，make down 停止并保留数据。\n连接编码代理：可选择三种入口。\n- Skill：npx skills add lexmount/artifact-site，安装代理技能并将服务器地址交给代理。\n- CLI：npm install -g @artifact-site/cli，需要 Node 24+。\n- MCP：https://your-server/mcp，通过服务器自带 OAuth 登录连接 ChatGPT、Claude 或其他 MCP 客户端，无需安装 CLI。只支持本地 MCP 服务器的客户端可运行 CLI 的 artifact-site mcp。\nCLI 和 MCP 默认创建私有工件，不生成独立分享链接。当用户要求分享主链接时，使用 artifact-site visibility <slug> unlisted 或 MCP 的 artifact_site_set_visibility。\n给编码代理的指令示例：使用 /for-agents.md 代理指南、CLI 或 MCP 服务器，"发布这个并给我一个链接" 就是一条指令，站点也可以通过同样方式更新、搜索和读取。\n\n团队部署与配置\n从 .env.example 开始，按照 SELFHOST.md 进行生产部署。ARTIFACT_PUBLIC_URL 需使用稳定的公开地址，登录回调、请求来源检查和提供给代理的地址都由此派生。可配置反向代理，或设置 ARTIFACT_WITH_CADDY=on 和 ARTIFACT_DOMAIN 以启用 Caddy 和自动证书。\n发布策略可选：login 要求 OIDC；token 为脚本或代理提供 Bearer 令牌；open 让任何能访问服务的人发布，适合受信任的内部网络。匿名发布支持单独的配额和过期时间。\n可连接 Google 或 OIDC 提供商（如 Keycloak、Logto、Authentik、Okta、Auth0）。账户拥有站点和文件夹；代理可通过设备登录获得长期令牌。默认 ARTIFACT_ENFORCE_OWNERSHIP=on 在配置 OIDC 后启用基于账户的访问控制。将管理员的已验证登录邮箱加入 ARTIFACT_ADMIN_EMAILS 即可启用管理控制台。\n设置 ARTIFACT_WITH_GOTENBERG=on 启用 Office 预览。管理控制台可管理下架、配额、匿名站点过期和策略开关，选择默认可见性并安排备份。\n应用以单个 Docker 镜像发布，单主机方案内置 Postgres。使用预构建镜像可设置 ARTIFACT_IMAGE 并运行 make pull。make doctor 检查配置；make backup 和 make restore 处理备份与恢复。多副本、外部 Postgres 和 S3 兼容存储参见 DEPLOY.md。\n\n技术要点与限制\n- 应用与存储：Next.js 提供 UI 和 API，Postgres 存储元数据，文件存放在本地磁盘或 S3 兼容存储。外部数据库和对象存储支持多个应用副本。\n- 不可变版本：每次上传或编辑都会写入新文件版本，保留历史内容。乐观锁（expected_version）检测并发更新冲突。\n- 内容隔离：预览使用不带 allow-same-origin 的沙盒 iframe 和严格 CSP，将上传内容与平台隔离。路径检查和解压限制防御路径穿越和 ZIP 炸弹。\n- 托管页面在沙盒中运行，无法使用平台登录会话。外部 API 连接需要来源允许列表。\n- 平台托管成品文件，不运行应用后端或构建任务；PDF 和 Office 文档不支持可视化 HTML 编辑；扫描图片不会自动 OCR。\n- 云代理无法直接访问用户电脑上的 127.0.0.1。\n- 首次运行会下载依赖并构建镜像，需要较长时间。\n\n适用场景\nartifact-site 适合个人或团队集中管理多个 AI 代理产出的页面与文档，需要统一分享、评论、访问控制和版本管理时使用。也适合希望在自己的基础设施上托管这些作品、同时让代理通过 CLI 或 MCP 持续更新的场景。本地开发需要 Node 24+ 和 Docker，贡献流程、DCO 签署和 CI 要求参见 CONTRIBUTING.md。项目在 Apache License 2.0 或 MIT 许可下双许可发布。