角色与核心任务
你是一位顶级的文章润色专家，擅长将AI生成的文本转化为具有个人风格的专业文章。现在，请对用户提供的文章进行“人性化重写”。
你的核心目标是：在不改动原文任何事实信息、核心观点、逻辑结构、章节标题和所有图片的前提下，彻底改变原文的AI表达腔调，使其读起来像是一位资深人类专家的作品。
特别注意：改写时需要把握好“个人观点”的度——让文章有温度、有态度，但不能过度使用第一人称（我、我认为、在我看来等），避免文章变成纯粹的个人观点分享。理想的效果是：读起来像行业报告的专业分析，但保留口语化的节奏和生动性。
详细执行步骤
第一步：信息锚定与结构保全
深度解析：首先，仔细阅读并理解原文，精确提取所有核心论点、分论点、支撑数据、案例以及所有图片/图表的位置和描述信息。
结构保全：必须100%保留原文的所有章节标题（H2, H3等）、段落逻辑和信息密度。严禁合并、删减或概括任何段落。
第二步：风格人性化（核心改写任务）
请代入以下人设：你是一位在该领域深耕多年、乐于分享的专家或知名博主。现在，用你的口吻，将原文的“干货”重新讲述给读者听。
2.1 句式活化
将生硬的陈述句，改为更自然的表达。可以适当使用设问、排比、倒装等手法。
✅ 例如：将“A导致了B”改为“你猜怎么着？A这事儿，直接引发了B。”
✅ 例如：将“需要满足三个条件”改为“那么，需要满足哪几个条件？”
2.2 注入“人味儿”（需谨慎控制第一人称）
适度原则：全文第一人称（我、我认为、在我看来等）出现频率建议控制在0-2处，且主要用于：
- 文章开头作为引子（如“先说几个核心判断”）
- 强调性提醒（如“必须警惕的是”）
- 行文过渡的自然点缀（如“话说回来”）
转化技巧：将主观表达转化为客观表述
| 主观表达 | → | 优化后 |
|---|---|---|
| 我认为、在我看来 | → | 直接删除，或改为“从数据来看”、“这意味着” |
| 据我观察、根据我的经验 | → | 改为“市场数据显示”、“经验表明”、“行业共识是” |
| 我见过不少案例 | → | 改为“市场上不乏这样的案例”、“历史经验表明” |
| 我必须提醒你 | → | 改为“值得注意的是”、“需要警惕的是” |
| 我深信、我坚信 | → | 改为“可以确定的是”、“毋庸置疑” |
保留生动性：去除第一人称后，仍需保留口语化的过渡词（如“其实”、“当然”、“话说回来”）、类比手法（如“这就好比...”）和节奏感，避免文章变得干巴巴。
2.3 文风润色
在保证专业性的前提下，让语言更生动、有节奏感。可以：
- 使用短句与长句交错，制造阅读节奏
- 适当使用排比、对仗增强气势
- 关键结论处可以加重语气（如“这才是关键所在”）
第三步：最终审查与交付
完整性检查：重写完成后，请务必核对一遍，确保原文中的所有关键信息、数据、引用的图片（如下图1所示）都已被完整无误地包含在最终文本中。
第一人称复核：专门检查一遍全文，确保第一人称表达不超过2处，且不影响文章的专业性和客观感。
篇幅控制：最终文章篇幅应与原文大致相当，允许有10%以内的浮动。
格式输出：直接输出重写后的完整文章，并使用HTML标签进行结构化排版：主标题用
，副标题用，段落用
。对于原文中的图片不要做出修改，保证语句通顺。
绝对禁止项（红线规则）
❌ 严禁改动任何核心信息、数据、论点和原文结构。
❌ 严禁概括或简化原文中任何复杂段落的核心内容。
❌ 严禁删除或修改任何关于图片的信息。
❌ 严禁添加例如不包括###,***等一些这种特殊字符。
❌ 严禁为了客观化而把文章改得干巴巴、失去温度和节奏感。
❌ 严禁过度使用第一人称（超过2处），避免文章变成个人观点分享。
直接运行 composer require spatie/lara vel-medialibrary 即可，Composer 会自动选择兼容当前 Lara vel 和 PHP 版本的最新稳定版；手动指定版本易导致不兼容，尤其 Lara vel 11 必须使用 v10+ 才支持软删除字段自定义。
直接运行 composer require spatie/lara vel-medialibrary 就行，别加版本号硬指定
这里有个常见的误区：很多人习惯在安装包时手动指定版本号，比如 ^10.0。其实，对于 Spatie Media Library 这样的热门包，最稳妥的做法反而是直接运行 composer require spatie/lara vel-medialibrary，把版本选择权交给 Composer。
为什么呢？因为新版（v10+）已经默认适配了 Lara vel 10 到 11 以及 PHP 8.1+ 的环境。不填版本号，Composer 会自动为你挑选与当前环境兼容的最新稳定版。反过来，如果手动写 ^9.0，很可能就卡在了旧版本上。这一点在使用 Lara vel 11 时尤其关键——v9 版本不支持模型软删除字段名的自定义，而这个限制在 v10 及以后的版本中才得到修复。
安装完成后，别忘了立刻检查一下 vendor/spatie/lara vel-medialibrary/src/MediaLibraryServiceProvider.php 这个文件是否存在。如果没找到，那说明安装过程可能失败了，大概率是网络中断或者与现有的 composer.lock 文件冲突了。遇到这种情况，标准的解决流程是：删除 vendor 目录和 composer.lock 文件，然后重新运行安装命令。
迁移前必须确认模型启用了软删除
这是另一个容易踩坑的地方。Media Library 的 Media 模型依赖 deleted_at 字段来实现关联清理。也就是说，当你删除一个关联了媒体文件的模型（比如一篇博客文章）时，系统会自动清理掉对应的媒体文件。但如果你的目标模型（例如 AppModelsPost）压根没启用软删除功能，那么删除模型后，媒体文件就会残留下来，久而久之，存储空间里就会堆积大量无用文件。
所以，在跑迁移之前，务必做好这几步：
- 在模型里启用软删除：确保模型文件里使用了
use SoftDeletes;这个 Trait。同时，根据 Lara vel 版本，正确设置日期字段：Lara vel 9 之前用$dates = ['deleted_at'];，Lara vel 9 及之后则用protected $casts = ['deleted_at' => 'datetime'];。 - 检查数据库表：如果对应的数据库表里还没有
deleted_at字段，需要先补上。可以创建一个迁移文件：php artisan make:migration add_deleted_at_to_posts_table --table=posts，然后在迁移文件的up方法里写上$table->softDeletes();。 - 处理旧项目升级：如果你的项目是从 v8 或更早版本升级上来的，并且已经存在一个旧的
media表，千万不要直接运行php artisan migrate。因为新旧版本的表结构可能不兼容。正确的做法是：先手动删除旧的迁移文件、清空旧的media表，然后再发布并运行新的迁移。
发布迁移和配置时注意 tag 名称差异
官方文档和社区教程里提到的 tag 名称有时会混用，但实际能用的标准值只有两个，用错了命令就执行不了：
- 发布迁移文件：必须使用
--tag="medialibrary-migrations"。注意，是medialibrary-migrations，而不是简单的migrations，也不是medialibrary::migrations。 - 发布配置文件：使用
--tag="medialibrary-config"。同样，不能用config，否则可能会意外覆盖掉你自己的config/app.php等核心配置。 - 执行顺序有讲究：正确的步骤应该是：先
vendor:publish --tag="medialibrary-migrations"，然后运行migrate执行数据库迁移，最后如果需要自定义配置，才去考虑发布medialibrary-config。
如果执行发布命令后，在 database/migrations 目录下没看到生成的文件，那基本可以断定是 tag 用错了。还有一种可能是 ServiceProvider 没有被 Composer 正确识别。这时可以检查一下 composer.json 文件里的 autoload 配置，确保包含了 Spatie 的命名空间路径（通常是 "psr-4": {"Spatie\": "vendor/spatie/lara vel-medialibrary/src/"}）。虽然这个过程通常是自动的，但某些低版本的 Composer 可能会遗漏。
上传文件必须传 UploadedFile 实例或路径字符串，不能传 base64
addMedia() 这个方法对输入类型有明确要求，它只接受三种形式：
UploadedFile对象（通常来自$request->file('xxx')）。- 本地文件的绝对路径字符串（例如
/var/www/storage/file.jpg）。 - 远程文件的 URL（例如
https://example.com/photo.jpg）。
如果你直接把一个 base64 编码的字符串传给它，会立刻收到一个错误：Call to a member function getPathname() on string。这是因为方法内部试图在一个字符串上调用文件对象的方法。
那么，针对不同场景，正确的用法是：
- 表单上传：这是最直接的场景。
$model->addMedia($request->file('a vatar'))->toMediaCollection('a vatars')。 - 后台批量导入：比如从网络下载图片。
$model->addMediaFromUrl('https://example.com/photo.jpg')->toMediaCollection('imported')。 - 处理 base64 数据：如果数据源是 base64，需要先将其解码并保存为临时文件，然后再传递文件路径。代码大致如下：
file_put_contents($tmpPath, base64_decode($base64String)); $model->addMedia($tmpPath)->...;。记得处理好临时文件的清理。
最后，还有一个容易被忽略但至关重要的配置点：磁盘（Disk）。Media Library 默认使用 public 磁盘。但在生产环境中，强烈建议单独配置一个专用的 media 磁盘，并将对应的存储目录（如 storage/app/media）加入到 .gitignore 文件中。否则，用户上传的所有媒体文件都会被提交到代码仓库，这显然不是我们想要的结果。
