技能介绍

解决什么问题

在本地通过 Agent 生成了 HTML/CSS/JS 静态网页，或者画出了交互原型之后，往往需要立刻把成果展示给别人看。但在本地起一个 HTTP 服务器要么受网络环境限制，要么不够便捷。这个技能提供了一条更快的路：直接把静态文件托管到云端，立刻拿到一个干净的公开 URL。它把“从写代码到上线预览”的链路缩短为一次上传，专门针对单页面或小规模静态产物的分享场景。

核心机制与工作流

整个服务围绕 Device ID 注册机制 与 项目（Project）模型 展开：

注册与凭证管理：首次使用 Agent 会基于主机名或会话标识生成 device_id 进行注册，换取永久的 api_key。凭证必须本地持久化到 ~/.config/artifact-share/config.yml，后续所有操作都从此读取。
上传与路径映射：创建项目时可以上传单个文件或 ZIP 包。关键逻辑在于，URL 的末尾直接保留了文件在本地的原始名称（如 index.html），不需要额外配置路由。
无感重写与访问：HTML 中的相对资源引用会被自动解析到同一个路径前缀下，图片、CSS 和 JS 无需重写路径即可正常工作。

适用边界与注意点

适用范围：

HTML/CSS/JS 单页应用、交互原型、设计稿的在线预览。
静态资源文件的快速分发。

限制与坑点：

白名单机制：仅支持 html/css/js/png/jpg/jpeg/gif/svg/webp 等常见静态格式，不支持视频、音频及二进制可执行文件。
配额限制：免费版限制为 1 个项目，单项目 不超过 5 个文件，总大小 不超过 5MB（单次上传限制 3MB）。
凭证安全：API Key 不会过期，且丢失后无法找回。不要将其提交到公共代码仓库中。
静态托管：不能用于部署需要服务端逻辑的动态应用。