素材库：图片与文件都存在哪、怎么被引用

一句话

你在编辑器里插入的图片、生成的封面、上传的文件，都会自动进入本机的「资源管理」，成为可复用的素材。

在哪打开

侧栏「管理」分组 →「资源管理」。编辑器里另有一个右侧素材面板，标题也是「资源管理」，带「添加资源」按钮。编辑器工具栏的「从资源库添加」会弹出居中的选择窗。资源管理页顶栏依次是标签分页、「未被引用」分页、「本机存储，未远程存储」提示与「刷新」按钮。

主要动作

• 添加资源：选本地文件 → 逐个导入，成功的一个个进库（单个文件失败不影响其它文件）。
• 插入：点卡片上的「插入」，图片以 <img> 写进正文、非图片以 <a> 链接写进正文。
• 扫描编辑器图片：把正文里已经写了本地路径、但还没进库的图片补登记。
• + 补登记为正式资源：磁盘上有文件却没有入库记录（「未登记」角标）时补一条记录，不重新压缩也不复制文件。
• 删除：删除素材与它的入库记录。被稿件引用的素材会被拒绝，报「该资源正被 N 篇稿件引用，请先移除引用再删除」。
• 按标签筛选 / 「未被引用」筛选：两个分页都带动量数字，点一下只看该类。

字段 / 状态说明

名称	含义	什么时候用
文件名	导入时的原始文件名（originalName）	在卡片或选择窗里认图
大小 / 宽×高	入库后的真实体积与像素（fileSize / width / height）	判断是否够清晰、是否超出平台上限
标签	素材的标签数组（tags）	顶栏标签分页筛选；生图产物自动带 generated
「未被引用」	正文、素材列表、封面三处都没引用过（referenced === false）	想清理磁盘时先看这一栏
「未登记」	文件在资源目录里、但没有入库记录（untracked）	显示为黄色角标，可补登记或直接删文件
「已用」	当前正文里已经引用了这张素材（编辑器面板）	避免重复插入同一张

与其它功能的关系

素材是全局的，不绑定任何一篇稿件。「引用」只发生在三个地方：稿件正文（Markdown 图片／链接、HTML <img>）、稿件的素材列表 media_paths、封面 cover_image。「生成图片」页生成的图也会入资源库，并在资源卡片上显示标题、提示词与「在生成图片中查看」入口。发布时，素材会按目标平台的上传能力被压缩后上传到该平台。

限制与注意

• 素材只存本机，界面明写「本机存储，未远程存储」。
• 入库时图片会被压缩后存盘，不保留原图：最长边 1920、JPEG 质量 80；只有 JPEG／BMP／TIFF／WebP 会被重编码为 JPEG，PNG（透明通道）与 GIF（动图）保留原格式，避免透明变黑底、动图变静图。
• 删除被引用的素材是被有意拦下的闸门，不是 bug；它保护的是历史文章里的图片不会失效。

常见问题

Q：为什么这个素材删不掉？ A：它正在被稿件引用。报错会写明被几篇稿件引用；点顶栏「未被引用」分页能看到真正可以安全删的那批。

Q：磁盘上有文件，资源管理里却是「未登记」？ A：这份文件在资源目录里、但没有入库记录。点「+ 补登记为正式资源」补一条记录即可，或直接删掉这个文件。

Q：为什么插入资源后正文里是本地路径？ A：素材以本机绝对路径写入正文；发布时由发布流程按平台上传并替换为平台地址。

Q：能自己给素材打标签吗？ A：目前的标签来自生图产物（自动打 generated）与入库记录；界面提供的是标签筛选，没有独立的标签编辑入口。