# imgtoc 图片图床 — 用户功能说明

本文档从 **论坛会员（发帖用户）** 的角度说明：能做什么、怎么用、有哪些限制。  
**管理员后台**（文件管理、报表统计、插件设置等）不在此文档范围。

---

## 一、插件是做什么的？

在论坛 **发表帖子或回复** 时，部分用户可以在编辑器里使用 **ImgToC 图床**：把图片传到图床，再把 **图片直链** 插入到帖子内容中。  
适合需要 **外链图片、CDN 加速** 或统一用图床托管图片的场景。

---

## 二、谁能用？

- 只有论坛管理员在插件设置里勾选的 **「可使用图床的用户组」** 中的会员，才会在发帖编辑器里看到 **图床按钮**。  
- 若您看不到该按钮，说明当前账号所在用户组未开通，需要联系站长或管理员，**普通用户无法自行开启**。  
- 使用图床前，管理员需已在后台配置好图床地址与 API；若未配置，即使看到入口，上传时也可能提示需要先完成后台设置。

---

## 三、在哪里使用？

1. 登录论坛。  
2. 进入 **发帖**、**编辑帖子** 或 **回复** 等带内容编辑器的页面。  
3. 在编辑器 **左侧控制区** 找到 **图床** 图标按钮（鼠标悬停可看到管理员设置的提示文字）。  
4. 点击后弹出 **浮层窗口**，里面有两个页签：  
   - **上传图片**  
   - **图片列表**

> 说明：若管理员开启了「隐藏系统自带附件/图片上传」，您可能只看到图床等入口，具体以站点显示为准。

---

## 四、「上传图片」页签

- **选择图片**：点击选择文件，或按页面提示 **把图片拖到指定区域**。  
- **支持格式**（以当前版本页面为准，常见包括）：如 png、jpg、jpeg、svg、webp、gif、bmp、tif 等图片类型。  
- **分片上传**：大文件会分片上传，由论坛服务器代为转发到图床，**您的浏览器里不会出现图床 API 密码**。  
- 上传成功后，一般会提示成功，并可切换到 **图片列表** 查看刚传的图。

若页面提示 **API 密钥未配置** 之类信息，属于站长后台未配好，需要联系管理员，用户侧无法解决。

---

## 五、「图片列表」页签

- 展示您在图床侧 **与我相关的图片**（具体范围由图床与接口决定，通常便于选图插入帖子）。  
- 可使用 **刷新** 更新列表。  
- **点击缩略图** 或通过界面上的 **插入帖子** 等操作，会把对应图片以合适的形式 **插入到当前编辑器光标位置**。  
- 插入后请像编辑普通帖子一样检查排版，再提交发帖。

---

## 六、发帖结果与平时有什么不同？

- 帖子里的图片以 **图床返回的链接** 形式存在，在论坛里显示为图片，实际文件托管在 ImgToC 图床站点。  
- 图床的 **空间、流量、保留策略** 等以图床账号与站长约定为准，论坛插件只负责对接与插入链接。

---

## 七、常见问题（用户视角）

| 现象 | 可能原因与处理 |
|------|----------------|
| 没有图床按钮 | 当前用户组未授权 → 联系管理员勾选用户组。 |
| 点上传没反应或报错 | 站长未配置图床或密钥、网络问题 → 联系管理员。 |
| 列表一直加载或为空 | 图床服务异常、权限或接口问题 → 联系管理员。 |
| 图片插入后帖子不显示 | 论坛是否允许外链图、图床是否允许外链、链接是否被拦截 → 联系管理员或查看论坛规则。 |

---

## 八、隐私与安全说明（简要）

- 上传行为会经过 **您所使用论坛的服务器** 再到达图床，请遵守论坛与图床的使用条款。  
- **API 密钥** 由管理员在后台保管，正常设计下不会显示在网页源码中供普通用户复制。  
- 若对图片版权、是否公开有要求，请自行确认后再上传。

---

如您需要 **卸载插件、统计报表、远程删文件** 等说明，请使用管理员提供的 **站长/插件文档**，或咨询论坛管理员。
