PlayMac 文章自动补全 WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

仓库地址使用英文 playmac-article-autofill-plugin，以确保 GitHub Release 更新链接稳定；插件名称和说明保持中文。

在 WordPress 文章编辑页顶部粘贴 Steam 商店链接或 Macked 软件介绍链接，插件会在正式网站内生成并保存草稿，不依赖本机电脑、控制台或外部文章助手。耗时处理由服务器常驻组件完成，不占用 WordPress 页面请求。

• Steam：补全游戏标题、正文、分类、标签、资源信息和 SEO；“关于游戏”完整使用简体中文商店的 about_the_game 原文，保留原标题级别、段落、换行和列表，不截断、不改写、不使用综合介绍替代，缺少原文时停止保存；分类只选择二级或三级；固定下载五张商店截图并上传千帆，资源语言只读取字幕语言；Steam 无法提供成品版本、大小与价格，因此明确列为“待填写”。
• Macked：补全软件标题、正文、分类、标签、版本、大小、系统要求、芯片信息和 SEO。
• 图片：封面和五张独立商店截图仍上传并验证千帆外链；“关于游戏”内的图片（包括 GIF/动态 AVIF）和视频保留 Steam 原链接，不转存、不转码。
• 视频：仅对“关于游戏”内的视频强制静音、自动播放、行内播放、隐藏播放控件并禁止右键，不影响文章其他视频。浏览器省电/用户策略可能阻止自动播放，右键限制不等于防下载。
• 排版：固定正文按提供的样稿写入经典编辑器，保留标题、段落和短代码换行；仅“关于游戏”独立保护 Steam 原文，不再用整篇 HTML 区块或整段强制换行样式。
• 编辑保护：可视化编辑器中的“关于游戏”为只读原文，普通保存及自动保存不会改变其标题、段落或媒体结构；其余文章内容可正常编辑，更新 Steam 原文请重新获取资料。
• 适用范围：新导入或主动重新补全的文章；不自动改写历史文章，不改价格和下载链接。编辑已有文章时仍须确认覆盖标题和正文。
• 千帆：在插件设置页获取官方二维码，用小红书 APP 扫码登录；账号密码登录仅作为备用。登录会话保存在独立数据卷中。
• Macked：插件直接读取并解析；无法可靠读取时不会保存草稿，也不会使用旧缓存替代。
• 安全：插件不自动发布，不覆盖已有价格和下载链接。

安装后：

1. 在服务器运行 docker compose up -d 启动常驻组件。
2. 打开“设置 → PlayMac 文章自动补全”，点击“测试服务器组件”。
3. 在同一页面获取二维码，并使用小红书 APP 扫码登录千帆图片空间。
4. 新建文章，粘贴 Steam 或 Macked 链接并保存草稿。

GitHub 更新

插件会读取本仓库的 GitHub Release。发布新版本时推送 v版本号 标签，GitHub 会自动生成安装包和 Release；已安装的网站会在 WordPress 插件更新页提示更新，也可以在插件列表点击“检查 GitHub 更新”，立即清除旧缓存并刷新更新状态。

服务器常驻组件

常驻组件只监听服务器本机 127.0.0.1:18990。千帆会话和未完成任务保存在独立数据卷中，更新 WordPress 插件不会删除。

docker compose pull
docker compose up -d

每次推送版本标签时，GitHub 会同时发布 WordPress 安装包和 ghcr.io/summer0607/playmac-article-autofill-runtime 容器镜像。

升级 3.1.6 时需要同时更新插件和常驻组件（建议固定使用同版本镜像标签）。数据卷无需更换，保留千帆会话和任务；正在处理的任务应完成后再更新服务。只更新 WordPress 插件不会更新服务器的 Steam 提取逻辑。

3.1.9 正文格式修复需要同时更新插件和常驻组件。只改变正文排版，不改其他文章字段；保留现有千帆会话、图片去重记录和任务数据卷。

测试

常规检查：python3 -m unittest discover -s tests -v、node --test tests/frontend.test.cjs、php -l playmac-article-importer.php、php tests/editor-preservation.test.php。

已有 PlayMac 本地站和 Playwright 测试环境可运行 python3 tests/smoke_frontend.py，读取真实 Steam 内容并验证可视化编辑器再次保存、前端排版、原始媒体链接和视频实际播放；测试仅允许写入本地站，结束后删除自身创建的测试文章及临时登录会话，不操作正式站或千帆。

发布新版本

1. 更新插件文件头中的版本号和 CHANGELOG.md。
2. 提交并推送代码。
3. 推送同名标签，例如 v3.1.0。
4. GitHub 会自动发布 WordPress 安装包和常驻组件镜像。