自媒体平台适配 (Platform Adaptation)

概述

将标准文章模板（如 DOCX 或 MD 格式的 R 语言科研绘图教程）适配到不同自媒体平台。

核心流程：分析原文 → 选择平台 → 按规则适配 → 去 AI 味润色（中文平台推荐） → 代码实测验证 → 输出归档

启动语: "我正在使用platform-adaptation skill进行自媒体平台适配。"

发布策略（2026-08 起）

• 主阵地平台（每期必发）：公众号、知乎、小红书。
• 已暂停平台：简书、B站图文、CSDN、掘金、抖音图文、Medium、Dev.to——默认不生成草稿。规则已归档至 references/legacy-platforms.md，仅当用户明确要求适配某归档平台时才按其规则执行。

输入要求

标准文章模板应包含：

• 标题 — 文章核心主题
• 章节结构 — 分节内容
• R代码块 — 可运行的R代码片段
• 表格 — 数据或参数表格
• 图片点位 — 图表插入位置说明
• 核心观点 — 关键结论或技巧提示
• 文末引导 — 互动引导文案（点赞/关注/收藏/评论），不涉及数据分析/科研绘图等商业服务

核心适配原则

工作流程

Phase 1: 分析原文结构

• 提取标题和副标题
• 列出所有章节标题（层级结构）
• 标记所有R代码块位置和内容
• 标记所有表格（内容+格式）
• 标记所有图片插入点，配图文件位于工作目录下，命名格式为 配图2.pdf/.tif、配图3.pdf/.tif……（配图1为数据结构截图，由用户自行准备）
• 提取核心观点/技巧提示
• 提取文末引导/作者信息

Phase 2: 确定目标平台 → 选择适配规则

根据用户需求选择平台，参照 references/platform-rules.md（按需读取对应平台规则）。

各平台速查索引表 见 references/platform-rules.md 开头，可快速对比格式/语气/字数/代码方式/标签数量。

Phase 3: 逐项适配

按 references/platform-rules.md 中的对应平台规则逐一检查：

• 语言：中文平台用中文（临时适配归档英文平台时才用英文）
• 标题：按平台风格调整，每个平台用不同标题，忌千篇一律。知乎问题式/教育感、公众号亲切吸睛（悬念/利益/问题式标题）、小红书精简突出结果。归档平台的标题风格见 references/legacy-platforms.md
• 语气：按平台规则调整
• 目录：按平台要求处理
• 代码块：格式与展示方式（``` 块 / 缩进 / 截图）
• 表格：格式适配（md表格 / 纯文本对齐 / 截图）
• 图片：标注插入点，配图文件在工作目录下以 配图2、配图3……命名（配图1为数据结构截图，用户自备）。各平台仅支持 JPG/PNG，使用 配图X.png 上传到编辑器（每张配图均有 PDF/TIFF/PNG 三种版本，PDF/TIFF 用于论文和投稿，PNG 用于平台插图）。海外平台用英文标注
• 元数据：YAML front-matter / Tags 按平台限制
• 版权声明：主阵地 3 平台不需要（临时适配归档平台时按该平台规则，如 CSDN 需 CC 4.0 BY-SA，见 references/legacy-platforms.md）
• 文末引导：定制互动引导（点赞/关注/收藏/评论），不提及任何数据分析/科研绘图等商业服务
• 下期预告钩子：文末 CTA 前加 1~2 句「下一期预告」。主题来源优先级：标准文章自带的下期预告段 → 读取 <你的内容规划文件> 的下一期标题 → 询问用户。小红书按拆篇钩子规则（篇1 一句话预告篇2，篇2 预告下一期）
• 作者简介：所有平台均不需要（已统一取消）
• 文字-代码对应检查：文中每项技术描述必须有对应代码块
• 配图编号与内容一致性检查：打开每个配图X.png文件，确认视觉内容与文章对该配图的描述完全一致。特别排查：文章说5个但图中有6个、配图编号错位（配图2描述的内容实际在配图3.png中）等最容易出错的地方
• 交叉引用检查：正文中无「（配图X）」字眼，图片仅通过点位标注引用
• 内部路径引用检查：正文中不得出现「文件夹」「本地路径」「本文文件见 XX 文件夹」「配图 X 在同一文件夹」等对平台读者无意义的内部引用字眼。所有配图通过点位标注插入，不提及配图编号或文件路径
• 数据文件表述检查：平台文章无法附带数据文件，正文不得写「数据文件随文章提供，可直接下载使用」「数据文件可在同一目录找到」等表述。示例数据均为仿真生成，读者已知晓，无需强调；代码 read.csv() 处仅按数据结构说明读者如何准备自己的数据即可
• 不重复仿真声明：文章在数据准备段已告知"示例数据为仿真生成"，此后不得再反复强调仿真性。删除「数据是按这个方向仿真的，用于演示分析方法，不代表对真实生态规律的重新验证」「本数据为仿真生成，不构成对真实生态规律的验证」「本数据为仿真生成的教程数据，不代表任何真实实验的结果」「这一模式源于仿真数据的设定，并非从真实观测中归纳得出」等重复声明。保留功能性表述（如"仿真数据的规律设定：氮添加降低多样性"解释数据设计依据）与「数据文件可在同一目录找到」这类真实信息（仅当本地确实提供文件时才写）
• 公众号内容源自查：公众号所有内容必须严格来自标准文章，不得自行增补代码块、方法、分析步骤。标准文章已以 3000 字为目标，公众号适配时对齐到 3000 字（下限 2500）。适配时仅做格式转换和排版美化，不增加标准文章中没有的科学内容
• 公众号摘要准备：为公众号文章撰写 ≤120 字摘要（单独以文字形式交付，不嵌入 DOCX/HTML）。⚠️ 交付公众号成品时，必须把摘要文字直接呈现在回复公屏上（用户一眼可见，可直接复制），而不是只写进文件或等用户索要。摘要在标题下方，概括文章解决什么问题、适合谁读，不含"本文""这篇文章"等冗余词。用户在公众号编辑器发布时手动粘贴到摘要栏

Phase 3.5: 去 AI 味润色【中文平台推荐】

所有中文平台（主阵地：公众号/知乎/小红书；若临时适配归档中文平台也适用）建议在适配完成后、代码验证前执行此步骤。

对全文进行 AI 痕迹去除（若有对应的去 AI 味润色技能则调用，否则按下列清单人工/LLM 直改）。重点检查：

• 三段式法则 — "三步走""三要素""三个关键"等工整结构 → 改为自然叙述
• 宣传性语言 — "顶级""神级""搞定所有""必备"等夸大用词 → 直接陈述事实
• 内联标题垂直列表 — **标题：** 内容 或 🔷 标题 — 内容 模式 → 改为自然段落
• AI词汇 — "此外""至关重要""深入探讨""格局""体现""彰显"等 → 删除或替换
• 否定式排比 — "不仅仅……更是……""不是……而是……" → 直接说结论
• 破折号过度使用 — 正文中连续破折号 → 改为逗号或句号
• 过度使用emoji — 标题和正文中堆砌emoji → 精简点缀
• 通用积极结论 — "未来可期""激动人心"等模糊结尾 → 替换为具体信息
• 缺乏个人语气 — 纯中立报道感 → 适当加入"我""我自己"等第一人称

⚠️ 重要平衡：去 AI 味润色不要破坏平台风格。 去 AI 痕迹的目标是去掉模板腔，不是让风格统一变成"口语聊天"。润色时必须保留各平台的固有风格基调：

• 小红书 → 教程型短内容（有讲解有代码，简洁实用，非闲聊）
• 知乎 → 专业正式（信息密度高，结构清晰）
• 公众号 → 亲切教学（手把手，但不等于过度口语化）
• 归档平台（CSDN/掘金/简书/B站图文等）→ 若临时适配，保留其原风格基调（见 references/legacy-platforms.md）

正确做法：去掉三段式/宣传语/AI词汇，但保留该平台应有的正式度、信息密度和专业感。不要为了让文字"像人写的"就把教程写成闲聊。润色后通读一遍，确认读起来像该平台的优质创作者，而非像私人聊天。

如果当前环境没有对应的去 AI 味润色技能，或用户主动要求跳过此步骤，需确认后执行。

Phase 4: 代码实测验证【强制】

这是最重要的步骤，绝对不可跳过。

⚠️ 真实教训：小红书聚类分析文章因跳过此步骤，未发现K-means代码块中 cmdscale() 缺 eig=TRUE 参数，读者复制会直接报错。恢复只需2秒，但跳过会丧失读者信任。

详情见 references/code-verification.md。关键步骤：

• 逐段检查每个代码块的前置依赖（包、变量、函数）
• 编写测试脚本模拟读者逐段复制运行
• 用 Rscript "D:/路径/测试脚本.R" 运行验证
• 检查 exit code、warning、图形输出、中文字体
• 完整脚本兜底测试
• 全部通过前不报告完成

Phase 4.5: 交付前代码核查门【新增，不可跳过】

在 Phase 5 归档之前执行此关卡。未通过则退回 Phase 4：

• 确认已运行逐段代码验证脚本（验证脚本文件路径：__________）
• 所有代码块 exit code = 0
• 文章中所有代码块均已包含在验证中（无遗漏）
• 发现的bug已修复并重新验证通过
• 已同步更新所有平台的对应代码块（bug修复一处，全平台同步）

外部依赖安装：

• python-docx（公众号 DOCX 生成需要）：pip install python-docx lxml → 校验：python -c "import docx; from lxml import etree; print('OK')"
• R 4.5.2：确认 Rscript 存在 → 校验：Rscript -e "version$version.string"

Phase 5: 输出归档

• 按平台格式保存文件
• 按命名规范命名（平台_主题.txt 或 平台_主题.md）
• 保存到 <工作目录>/<主题>/ 目录
• 公众号默认用 HTML 输出：运行 python gen_wechat_html.py --input 标准文章.md --theme green-simple 生成带 inline CSS 的 HTML，打开 → Ctrl+A → Ctrl+C → 粘贴到公众号编辑器。已内置：一二级标题居中、代码后井号前无空格（自动规范化）。⚠️ 若标准文章配图是 **配图X** 文字说明，需先转成 ![描述](配图X.png) 语法（配图1 无文件应跳过）才能嵌入
• 备选 DOCX（仅当用户明确要 Word 文档时）：用增强版 gen_docx.py 生成，在文章目录编写 gen_wechat_beautified.py，导入 gen_docx 模块调用美化函数；可在开头 gen_docx.set_theme("主题名") 切换视觉风格（详见"公众号 DOCX / HTML 主题系统"）。代码块已内置"无段落缩进"处理（避免导入 Word 产生行尾空格）
• 向用户输出完整文章，等待用户确认"可以发布"后才执行发布操作
• 告知用户文件路径和关键适配点

输出文件规范

命名规则

平台_文章主题.txt/md

示例（主阵地平台）：

公众号_<主题>.md        # 或 .html
知乎_<主题>.md
小红书_<主题>_篇1.txt
小红书_<主题>_篇2.txt

已暂停平台（简书/B站图文/CSDN/掘金/抖音图文/Medium/Dev.to）的历史文件保留原命名，规则见 references/legacy-platforms.md。

保存路径

<工作目录>/<主题>/

公众号 DOCX / HTML 主题系统

gen_docx.py 和 gen_wechat_html.py 共享同一套视觉主题数据，确保同一主题下 DOCX 与 HTML 视觉效果一致。

使用方式（在 gen_wechat_beautified.py 中）：

import gen_docx
gen_docx.set_theme("green-simple")           # 切换主题
# 之后所有 add_* 调用使用新主题，函数签名不变

# 可用主题列表
print(gen_docx.get_theme_names())

可用主题：default / green-simple / blue-tech / warm-paper 四套，色值、字号、适用场景见 references/docx-themes.md。

HTML 输出（独立脚本）：

python gen_wechat_html.py --input 标准文章_聚类分析.md --theme green-simple

输出与输入同目录的 .html 文件，所有样式使用 inline CSS（适配 WeChat 编辑器粘贴）。打开 HTML → Ctrl+A → Ctrl+C → 粘贴到公众号编辑器。

HTML 脚本参考：scripts/gen_wechat_html.py DOCX 生成器：scripts/gen_docx.py 主题色板参考：references/docx-themes.md

常见陷阱

文件夹命名规范

自媒体的文章按主题存放在 <工作目录>/ 下，遵循以下命名规范：

序号-主题名/

示例：

01-<主题A>/
02-<主题B>/
03-<主题C>/

规则：

• 序号：按创作顺序递增（01, 02, 03...）
• 主题名：中文，概括分析类型或图表类型
• 主题名不加"标准""教程"等修饰词
• 如果主题以"图"结尾，可加"图"字（如"相关分析图"）
• 统一用中划线 - 连接序号和主题名

主题示例（按你的实际系列填写）：

• 01-<分析类型A> — 例如：散点图+线性回归
• 02-<分析类型B> — 例如：箱线图（单因素/双因素）
• 03-<分析类型C> — 例如：相关性分析+corrplot

文件管理

<工作目录>/<序号-主题>/
├── 标准文章_<主题>.md          # 标准文章
├── <R脚本>.R                   # 完整R脚本
├── <数据文件>.csv
├── dendrogram.pdf/.tif         # 通用命名图（供读者直接使用）
├── kmeans_clusters.pdf/.tif
├── 配图2.pdf/.tif/.png         # 文章配图（PDF/TIFF 用于论文和投稿，PNG 用于平台）
├── 配图3.pdf/.tif/.png
├── 配图4.pdf/.tif/.png
├── 公众号_<主题>.md            # 主阵地平台
├── 知乎_<主题>.md
├── 小红书_<主题>_篇1.txt
└── 小红书_<主题>_篇2.txt
# 已暂停平台（简书/B站图文/CSDN/掘金/抖音图文/Medium/Dev.to）不生成新草稿；
# 历史文件保留，规则见 references/legacy-platforms.md

参考文件索引

按需读取，不要全量加载：