图床使用指南
图床是 Raricy.com 提供的图片托管服务：上传图片后获得一个 10 位图片 ID，可生成直链在任意页面使用，也可以直接嵌入博客文章。图片会由服务器自动压缩处理，节省空间。
前置条件
使用图床需要已登录且通过邀请码认证（Core 用户及以上角色）。如果尚未认证，请先联系站长获取邀请码。
一、主页面
访问地址：/image
顶部标题下方提供"使用指南"入口（即你正在阅读的文档）。主页面自上而下依次是：
- 配额条：显示"已用 X MB / 上限 Y MB"及百分比，超过 80% 后进度条变色提醒。
- 上传区：拖拽图片到此处，或点击选择文件。
- 图片网格：你上传的全部图片，最新上传的排在前面。
配额按账号累计：Core / 管理员为 50 MB，站长为 100 MB。删除图片可以释放配额。
二、上传图片
支持 PNG / JPEG / GIF / WebP / SVG 五种格式，单文件上限 10 MB。
上传前有一个默认勾选的开关：
- 压缩图片（减小文件体积，轻微损失画质）：勾选（默认）时，服务器会把超过 2000px 的图片等比缩小，并对位图重新压缩（JPEG/WebP 质量约 85，PNG 无损压缩）；GIF 与 SVG 不压缩。如果压缩后体积反而更大，会保留原图。
- 取消勾选：原样存储，不做任何压缩。
上传时页面会显示进度条；上传成功后网格自动刷新，新图片出现在列表最前面。
服务端会校验文件内容与声明的格式是否一致（防止改扩展名混入非图片文件），伪装的文件会被拒绝。上传频率限制为每小时 200 次（一次传多张时按张数计）。
三、图片网格与操作
每张图片卡片显示：缩略图、文件名、文件大小（KB）、10 位图片 ID。悬停在卡片上可看到三个操作按钮：
| 按钮 | 说明 |
|---|---|
| 复制 ID | 把 10 位图片 ID 复制到剪贴板，按钮短暂变成对勾 |
| 新窗口打开 | 在新标签页打开图片原图直链 |
| 删除 | 确认后删除（软删除，见下文） |
点击缩略图会打开大图预览，支持点击遮罩或按 Esc 关闭；预览中同样可以复制图片 ID。
四、分享与嵌入
直链
每张图片都有固定直链：
/api/images/<图片ID>/raw
例如 ID 为 AbCdEf1234 的图片，直链为 /api/images/AbCdEf1234/raw。
本站 2026 年改版时图片直链变过一次：老地址是
/image/i/<图片ID>。 老地址仍然可用（服务端做了转发），旧文章里写死的图不会碎。唯一例外是正文里 写死了http://116.62.179.232:22822/...这类老 IP 的链接 —— 那串地址存在正文里， 与本站域名无关，改不了，只能手动编辑那几篇文章。
在 Markdown 中使用图片：
直链的特征：
- 公开图片无需登录即可访问，分享给任何人。
- 浏览器每次使用前都会回来验证一次（
no-cache+ ETag）：没变化时只回一个 304、不下发图片字节，所以重复浏览几乎不费流量；而图一旦删除，直链立刻变 404。 这样「删掉的图」不会在访客的屏幕上继续挂着。 - 删除图片后直链返回 404（图片裂图）。
- SVG 出于安全考虑以附件下载方式打开，不会在浏览器内直接内联渲染。
嵌入博客
在博客正文中写入 [@图片ID]，发布后会自动替换为图片，图片支持点击放大：
这是图片示例：
[@AbCdEf1234]
图片 ID 为 10 位，与 6 位收藏夹、8 位剪贴板、9 位投票都不同；长度不符的
[@...]不会被处理。
编辑器直传
博客与剪贴板编辑器工具栏的图片按钮会上传到图床，插入的即是上面的直链格式。可以一次选多张（也可以直接拖进去），会一起传上去、依次插入；单次合计不超过约 11 MB，超了会提示分批。
工具栏还有一颗「插入引用」按钮，打开后能在图床那一档挑一张已经传过的图插进正文 —— 插进去的是同一种直链格式，与上传那条路没有区别。
只收位图（PNG / JPEG / GIF / WebP）——SVG 请先在本页上传，再用 [@图片ID] 引用。
iPhone 用户：相机默认的 HEIC 格式会在这几处（图床页、编辑器、讨论 / 评论选图）
自动转成 JPEG 再上传，不用先手动转。实况照片（Live Photo）传的是其中的静帧，
.MOV 那段动态部分不会被上传（图床只收静态图片）。
五、删除与配额
- 删除（普通）：删除图片后它从你的列表中消失，直链变为 404。删除为软删除——占用配额会立即释放。
- 站长永久删除：站长在图床管理页可以"永久删除"任何图片，会同时删除磁盘文件与记录，不可恢复，并会给图片上传者发送站内通知。
📌 删掉的图，为什么「之前看过的人还看得见」？ 那是浏览器缓存，不是服务端 还在发：图在服务端已经软删、直链真的 404 了。直链现在的策略是「每次使用前先验证」 （
no-cache+ ETag），所以在这之后删除的图，访客下次打开文章就会变成裂图。 但在这次调整之前已经被浏览器按旧策略（一年长缓存）存下的副本，服务端收不回来 —— 只能请那位访客清一次缓存（或换浏览器 / 无痕窗口）才会消失。这是浏览器缓存的 固有性质，换到谁的站点上都一样。
六、限制一览
| 限制项 | 数值 |
|---|---|
| 存储配额（Core/管理员） | 50 MB（站长 100 MB） |
| 单文件大小 | ≤ 10 MB |
| 支持格式 | PNG / JPEG / GIF / WebP / SVG（iPhone 的 HEIC 在网页里自动转 JPEG） |
| 上传频率 | 每小时 200 张（一次传多张按张数计） |
| 压缩 | 位图 >2000px 缩放 + 有损/无损重压缩，可关闭 |
| 图片 ID | 10 位（大小写字母 + 数字，区分大小写） |
七、常见问题
Q: 上传提示"不支持的文件格式"？
图床只接受 PNG / JPEG / GIF / WebP / SVG。HEIC（iPhone 默认格式）会在网页里自动转成
JPEG；AVIF、BMP、TIFF 这类请先用 /tool/convert 转成 JPEG 或 PNG 再传。
Q: 上传提示"文件内容与声明的格式不匹配"？
这句话的意思是文件内容认不出是受支持的图片（常见于文件已损坏、下载不完整，或把
别的文件改了扩展名）。扩展名/格式声明写错已经不会再报这句了 —— 服务端按文件内容
纠正类型（x.jpg 的 PNG 会被存成 x.png）。iPhone 的 HEIC 与实况照片的 .MOV
各有单独的提示，见上一问。
Q: 上传提示"存储空间不足"？
你的账号配额已用完。删除部分图片释放空间后即可继续上传（删除为软删除，配额立即释放）。
Q: 别人能看我的图片吗？
能。目前上传的图片默认公开，任何人拿到直链都能查看——请勿上传隐私或敏感内容。历史遗留的私有图片会按访问权限校验，具体接口规则见 docs/bot/image-bot.md §6.2。
Q: 图片在博客里裂图了？
图片可能已被删除（直链返回 404）。请到 /image 重新上传并更新引用。
Q: 为什么 SVG 点开是下载而不是显示？
防止 SVG 中嵌入脚本造成安全风险，图床的 SVG 一律以附件形式下载，这是有意设计。