[Feature] 图片文件按文件夹归档

[cunyu1943]

类别

文章管理

问题或动机

当前所有图片文件均位于 post-images 目录下，文章一多不好管理，希望位于此文件夹下按照 post-images/文章名/xxx.png 归档，方便管理

期望的方案

不同文章图片按照文件夹归档

考虑过的替代方案

No response

参考资料

No response

检查清单

• 我已搜索过现有 Issue 和 Discussions，确认此功能尚未被提出过。

[Tespera]

接着聊一下这个功能，我站在用户角度把能想到的问题都列出来，动手之前先对齐一下会省很多后续的返工。

一、文件夹用什么来命名？

现在说的是 post-images/文章名/xxx.png，但"文章名"到底取哪个字段，直接决定了后面所有坑的严重程度：

• 用文章标题：好看、可读性高，但标题可以是中文、可以带空格、冒号、问号、斜杠、emoji，有些部署环境不一定都能正确处理，而且两篇同名文章会打架，改一次标题文件夹就要跟着动一次
• 用 slug（短链 ID）：更稳定，大部分人写完就不会改，但有的用户压根没设过，得有默认生成规则
• 用文章 ID 或日期：最稳定、永不冲突，但文件夹名不直观

倾向建议：用 slug，并在设置里把这个文件夹名对用户可见。

二、改标题 / 改 slug 的时候怎么办？

用户随手把"我的第一篇博客"改成"开篇之作"，这时候：

• 原来的图片文件夹要不要跟着改名？
• 文章里已经写好的图片引用路径要不要自动跟着换？
• 不换的话，改完名一堆断图
• 换的话，用户会不会担心"我只是改了个标题，怎么一堆文件都动了"

建议：自动跟着改，但每次都给一个温和的提示，让用户心里有数。

三、还没保存的新文章，图片往哪儿放？

这是最容易被忽视的场景：

• 新建一篇文章，还没起标题，直接就粘了张图进来
• 这时候"文章名"还不存在，图放哪？
• 用户写到一半直接关软件，下次打开这些临时图还在不在？
• 如果用户经常新建又不保存，这些孤儿图会不会越攒越多？

建议：先放到一个临时目录（比如 _draft/），文章首次保存时再整理过去；同时要有一个"清理无主临时图"的入口。

四、一张图被多篇共用怎么办？

非常常见：博主头像、公众号二维码、赞赏码、签名图、常用的示意图 —— 几乎每篇都在用。

• 分桶后这张图该归属到哪篇？
• 如果只归到 A 文章，等 A 被删的时候，B 里的引用就全挂了
• 如果给每篇都复制一份，占磁盘不说，改的时候还要改 N 处

建议：开一个专门的"共享图片"目录（比如 post-images/_common/），上传时让用户自己选"仅本文用"还是"共享"。

五、文章被删了，里面的图怎么办？

三种处理方式都有人喜欢：

• 跟着一起删：干净，但误删了哭都来不及
• 一起保留：安全，但日积月累一堆无主图
• 先进回收站，过一段时间再真删，而且能一键恢复（推荐默认行为）

建议：默认进回收站，同时允许用户在设置里改成"立即删"或"永不删"。

六、已有的图片要不要自动"搬家"？

老用户最关心这个：

• 我已经有几百张图了，升级后它们会被自动整理吗？
• 万一自动整理把我搞乱了怎么办？
• 如果不整理，新文章用新结构、老文章用老结构，两套并存很别扭

建议：

1. 不要在升级时自动触发，必须用户手动点
2. 提供一个"一键整理"按钮，但点之前要有预览：告诉用户"我要把这几张图移到这里去"
3. 执行之前自动备份一次
4. 允许用户只整理某几篇，不强制一刀切

七、图床 / 云存储用户的情况

不少用户把图片同步到七牛云、阿里云 OSS、GitHub 图床等：

• 分桶后远端的路径也要跟着变
• 已经上传到图床的老图要不要一并迁移？
• 路径层级变深了会不会影响图床配置或计费
• 万一远端迁移一半挂了（断网、权限问题），本地和远端对不上怎么办

建议：本地归档和图床同步解耦，给图床用户一个明确的选项"我的图床我自己管，不要动"。

八、发布后的旧链接会不会 404？（⚠️ 必须解决）

这是我认为不能省的一环：

• 老读者收藏过的、搜索引擎索引过的链接，全是旧格式 post-images/xxx.png
• 分桶后生成的博客变成 post-images/slug/xxx.png
• 旧链接直接打开就是 404
• SEO 会掉、老读者体验会差、评论区会有人来问

建议：发布时在旧位置留一份"路标"（可以是文件副本，也可以是重定向规则），这事没做的话这个功能上线了会挨骂。

九、多台电脑同步 / 多人协作的冲突

用 Git 或网盘把博客仓库同步到两台电脑：

• A 电脑改了文章标题（目录跟着改名）
• B 电脑改了同一篇文章的内容
• 合并的时候 Git 对"重命名 + 修改同时发生"的处理并不总是靠谱
• 用网盘同步更危险，可能直接留下两份重复的目录

建议：文档里明确说清这个风险，而且优先用 slug 做目录名，因为 slug 改动频率远低于标题。

十、用了一段时间不喜欢，能不能回到扁平结构？

尊重用户反悔的权利：

• 应该有一个"切回扁平结构"的开关
• 切回时同样走"预览 → 确认 → 备份 → 执行"
• 这件事做得到位，用户升级才敢放心点

十一、主题模板兼容性

有些第三方主题可能硬写了旧的图片路径格式：

• 新结构下主题可能显示不出图
• 要么提前通知主题作者，要么这个功能默认关闭、让用户手动打开
• 最好在"切换"的界面里给一句提示："如果你用的是第三方主题，打开前建议先确认兼容性"

十二、一些零碎的小问题

• 同名文件：同一篇里上传两张都叫 screenshot.png，自动改名规则是什么？加时间戳还是加序号？
• 剪贴板粘贴无名图：自动生成的文件名规则是什么？截图-时间戳.png？中文还是英文？
• 文件夹名含中文 / emoji：Windows 资源管理器没问题，部署到某些老服务器可能乱码，得有"只保留 ASCII"的开关
• 跨文章复制内容：从 A 文章复制一段带图的内容粘到 B 文章，图片跟不跟着走？
• 图片管理界面：分桶后在"媒体库"里怎么找图？建议有"按文章分组"和"全部平铺"两种视图可切换
• 顺便能做的好事：既然分桶了，可以加一个"每篇文章占多少磁盘"的统计，对长期博主很实用

---

动手前建议先对齐这三件事

1. 文件夹名用什么（slug / 标题 / ID 三选一）
2. 老数据怎么处理（手动一键整理 + 预览 + 备份，不自动跑）
3. 发布后的旧链接兼容方案（这条不能省）

这三点定下来，其他细节基本都能顺着解；定不下来就容易做到一半推倒重来。

如果方向上大家认可，我可以再把这份清单拆成具体的交付节奏（分几个小版本、每个版本管哪几件事），方便排期。