静态资源 接入指南

1直接引用（最快）

所有资源通过统一 URL 对外暴露，复制即用。路径格式：

复制# 通用格式
https://cdn.aiyun.top/assets/<分类>/<文件名>

# 真实示例
https://cdn.aiyun.top/assets/js/axios.min.js

引用后即可在任意项目 / 页面 / 文档中使用，URL 永久有效（同名更新采用原子替换，绝不破坏外链）。

2三种引用格式

在公共资源库打开任意资源卡片，可一键复制三种格式：

复制# HTML 引用（CSS）
<link rel="stylesheet" type="text/css" href="https://cdn.aiyun.top/assets/css/xxx.css">

# HTML 引用（JS）
<script src="https://cdn.aiyun.top/assets/js/xxx.min.js"></script>

# Markdown 引用（图片）
![xxx](https://cdn.aiyun.top/assets/images/xxx.png)

3资源分类

4上传资源

方式一（推荐）：登录管理后台「上传文件」页拖拽上传（>20MB 自动分片续传），或「远程添加」填入下载 URL 自动拉取校验入库。

方式二（CI/CD / 其它系统）：通过开放 API（后台「API 令牌」生成 write 令牌，自动归类 / 支持应用空间）：

复制# 上传（不填分类自动按扩展名归类）
curl -H "Authorization: Bearer <TOKEN>" -F "file=@./app.js" https://cdn.aiyun.top/api/upload.php

# 上传到指定应用空间
curl -H "Authorization: Bearer <TOKEN>" -F "app=my-app" -F "category=js" -F "file=@./app.js" https://cdn.aiyun.top/api/upload.php

# 终端直传（presign 凭证，无需长期令牌）
curl -F "ticket=<TICKET>" -F "file=@./photo.png" https://cdn.aiyun.top/api/upload.php

5缓存刷新

更新同名文件后，边缘缓存可能未失效。后台「缓存刷新」页提交 URL（或 API 触发）：

• EdgeOne 通道：调用腾讯云边缘刷新接口，节点缓存真实失效（推荐，需配置密钥）
• 本地通道：重新回源抓取覆盖本地文件（无需密钥）

复制# API 刷新（入队异步执行）
curl -X POST -H "Authorization: Bearer <TOKEN>" -H "Content-Type: application/json" \
  -d '{"urls":["https://cdn.aiyun.top/assets/js/app.js"],"channel":"edgeone"}' \
  https://cdn.aiyun.top/api/refresh.php

刷新任务由后台 worker 自动处理，可在页面查看进度与结果；支持批量提交与 Webhook 事件通知。

6常见问题