← 返回开发时间线

常识笔记 v1.7.1:本地 CMS - 图片资产嵌入与生命周期管理

常识笔记本地 CMS 支持粘贴嵌入图片,并按领域管理图片路径、同步改名、实时渲染和无引用清理。

常识笔记 v1.7.1 为本地 CMS 补齐 Markdown 图片资产的完整生命周期:从剪贴板粘贴上传,到按领域建立目录、语义化改名、实时渲染与删除清理。

图片粘贴与上传

  • 在 Markdown 编辑区直接使用右键粘贴或 Command + V,CMS 拦截剪贴板图片并将 Markdown 图片引用插入当前光标位置。
  • 上传接口限制单张图片不超过 2 MB;超过时提示“大于这个尺寸,请进行压缩处理”。
  • 图片按常识笔记领域和文章稳定标识存放,上传文件初始使用 UUID 文件名,并保留图片类型校验。

路径与改名同步

  • 后台编辑 Markdown 图片文件名时,同步修改本地图片路径;图片目录仍由集合类型和文章标识决定,避免改名时误移动到其他文章目录。
  • 文件名为空或引用不完整时阻止保存并显示兼容提示;无法通过正常状态推断原文件时,使用同目录唯一孤立文件进行恢复。

删除与渲染

  • 每次保存或删除文章时扫描全部 Markdown 引用;只有最后一处引用移除后,图片才移入系统废纸篓,避免误删仍被其他文章使用的资源。
  • 开发服务器直接提供动态创建的图片目录,粘贴后不需要重启 Astro 即可预览。

验收

  • 覆盖多处引用保留、最后一处引用清理、文章删除清理和改名后的图片渲染,并通过常识笔记生产构建。