# 平台成稿检查

![平台成稿检查](assets/cover.png)

[English](README.en.md) · 中文

[![Release](https://img.shields.io/github/v/release/baocanmou/obsidian-platform-ready-check)](https://github.com/baocanmou/obsidian-platform-ready-check/releases/latest)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Node.js build](https://github.com/baocanmou/obsidian-platform-ready-check/actions/workflows/lint.yml/badge.svg)](https://github.com/baocanmou/obsidian-platform-ready-check/actions/workflows/lint.yml)
[![Gitee 镜像](https://img.shields.io/badge/Gitee-%E5%9B%BD%E5%86%85%E9%95%9C%E5%83%8F-c71d23.svg)](https://gitee.com/baocanmou/obsidian-platform-ready-check)

一个 Obsidian 插件，给在 Obsidian 里写稿、再发到公众号、小红书、知乎、头条、百家号、搜狐号的人用：粘贴之前按目标平台检查一遍，标题和正文字数、平台不支持的格式、还没写完的占位内容、文末落款是否齐全且是最新版本；检查完一键复制成可以直接粘贴的文本。

插件英文名 Platform Ready Check，插件 ID `platform-ready-check`。纯本地运行，不联网，不调用 AI。

## 适合谁、什么时候用

- **一个人运营多个平台**：同一套稿子要发好几个平台，每个平台的字数限制、格式支持和落款都不一样。
- **固定落款经常更新**：落款改过几版后，旧稿里新旧混用。插件识别旧版落款，提示更新，并在替换前列出会被替换的内容。
- **一篇笔记里不只有正文**：小红书稿常常同时写着封面说明、发布标题、正文、配图清单、标签和置顶评论。插件只检查和复制“正文”那一节。
- **发小红书、朋友圈这类纯文本平台**：Markdown 的 `#` 和 `**` 粘过去会原样显示，用“复制为纯文本”一次去掉。

## 能做什么

- **按平台检查**：标题和正文字数、待补内容（TODO、待补充、XXX 等）、本地图片、外部链接、Obsidian 专有写法，以及纯文本平台上会原样显示的 Markdown 符号。
- **文末落款**：每个平台设置一份固定落款，一键插入；重复、过期、旧版落款都会提示，并可一键更新。
- **安全更新**：更新前列出将被替换的每一行，确认后才执行；落款后面有小标题、脚注或较多内容时不自动更新；落款下方的图片（如二维码）会保留；可以撤销。
- **复制为纯文本**：去掉 `#`、`**`、表格竖线等符号，列表转成“•”，表格转成逐行文字，HTML 上标转成“®”。
- **复制为 Markdown**：保留标准 Markdown，转换双链、高亮、标注块等 Obsidian 专有写法。
- **只处理正文小节**：笔记里有“正文”“拟发布正文”“正文（直接复制）”这类小标题时，只检查和复制这一节；标题可以写在“发布标题”小节下。
- **自动识别平台**：按笔记属性或文件夹判断目标平台，也可以在面板里手动切换。

## 效果示例

下面是一篇**虚构的**小红书稿件，笔记里同时写着封面说明、发布标题、正文和配图清单。

![编辑器里是一篇包含封面、发布标题、正文、配图清单四个小节的小红书稿；右侧面板识别为小红书，只检查“正文（直接复制）”一节，提示标题 22 字超过 20 字、文中没有落款](assets/example-panel.png)

插件按属性识别出小红书，只检查“正文（直接复制）”这一节，所以封面说明里的“TODO 封面图待定”不算正文里的占位内容。发布标题 22 字，超过小红书的 20 字；文中没有落款。因为小红书只接受纯文本，“复制为纯文本”是主按钮。

点“插入落款”后，落款放在正文最后、话题标签之前：

![正文最后一段之后插入三行落款，话题标签仍在落款下方](assets/example-signature.png)

图中的落款是包参谋自己在小红书使用的落款，你的落款在设置里填写。

“复制为纯文本”的结果（插件实际输出，正文含一个表格）：

```text
社区面馆的菜单，最常见的问题是菜太多、名字太长，顾客站在门口半天点不下来。

改的时候按这个顺序想：

1. 先砍菜：只留卖得动的，其余放到"今日加推"。
2. 再分区：主食、小菜、饮品三块，一眼看完。
3. 最后标重点：每区标一个推荐，帮犹豫的人做决定。

区域｜推荐
主食｜牛肉拌面

改完以后，点单时间短了，推荐款的点单比例也上来了。

#菜单设计 #餐饮创业 #品牌设计
```

## 工作流程

![工作流程：识别目标平台、找到发布部分、按平台检查、插入或更新落款、一键复制、粘贴到平台后台](assets/workflow.zh.svg)

## 平台与预设

平台规则会变，插件只预设了能找到依据的数值，其余留空，由你按平台后台的实际提示填写。

| 平台 | 预设 | 依据 |
| --- | --- | --- |
| 微信公众号 | 标题 64 字，正文 20000 字符；外部链接读者不能点击 | 公众号后台的标题长度提示；微信开放文档“新增草稿”接口说明 |
| 小红书 | 标题 20 字，正文 1000 字；只接受纯文本 | 公开资料中普通笔记的常见限制；开通长文的账号正文可以更长 |
| 今日头条 | 标题 5 到 30 字 | 公开资料中常见的说法，未找到官方页面，以发文后台为准 |
| 知乎、百家号、搜狐号 | 未预设 | 公开资料说法不一 |
| 抖音、朋友圈 | 未预设；只接受纯文本 | — |

字数按去掉 Markdown 和空白后的字符计算，可能与平台的计法略有出入。每个平台的字数、识别名称、是否纯文本、链接能否点击都可以在设置里改。

## 安装

**插件市场**：上架 Obsidian 社区插件目录后，可在 **设置 → 第三方插件 → 浏览** 中搜索 “Platform Ready Check” 安装。

**手动安装**（上架前请用这种方式）：

1. 从 [Releases](https://github.com/baocanmou/obsidian-platform-ready-check/releases/latest) 下载 `main.js`、`manifest.json`、`styles.css` 三个文件。
2. 在你的库里新建文件夹 `.obsidian/plugins/platform-ready-check/`，把三个文件放进去。
3. 重启 Obsidian，在 **设置 → 第三方插件** 里启用 “Platform Ready Check”。

国内访问 GitHub 较慢时，可以从 Gitee 镜像获取源码后自行构建（需要 Node.js 18 以上），构建出的三个文件同样放进上面的文件夹：

```bash
git clone https://gitee.com/baocanmou/obsidian-platform-ready-check.git
cd obsidian-platform-ready-check
npm install
npm run build
```

## 使用方法

1. 在 **设置 → Platform Ready Check → 平台** 里，给常用平台填写文末落款。
2. 在稿件的笔记属性里写目标平台，例如 `platform: 小红书`；或者在设置里按文件夹指定平台。
3. 点击左侧纸飞机图标，或运行命令“打开检查面板”，按面板提示处理。
4. 点“插入落款”或“更新落款”，再点“复制为纯文本”或“复制为 Markdown”，粘贴到平台后台。

### 平台从哪里识别

按顺序：

1. 检查面板里手动选择的平台（只在本次打开 Obsidian 期间有效）。
2. 笔记属性 `platform`、`平台` 或 `发布平台`，例如 `platform: 小红书`。
3. 设置里的“按文件夹指定平台”，每行一条，例如 `内容/小红书 | 小红书`。

“头条”“头条号”“今日头条”都会被识别为今日头条；每个平台的识别名称可以在设置里增减。

### 文末落款

在 **设置 → Platform Ready Check → 平台 → 某个平台** 里填写：

- **文末落款**：每篇末尾固定使用的文字，可以用 Markdown。**第一行用来识别**文中已有的落款，请保持固定。
- **旧版落款**：以前用过的落款的第一行，每行一个。文中出现时会提示“文末是旧版落款”，更新时整段替换。
- **落款放在话题标签前**：文末有一行 `#话题` 时，落款放在它上面。

### 正文小节

默认识别这些小标题：`正文`、`发布正文`、`拟发布正文`、`正文（直接复制）`，小标题前的编号（如“三、”）会被忽略。属性里没有标题时，取 `发布标题` 小节下的第一行作为标题。两项都可以在设置里改。

### 命令

| 命令 | 作用 |
| --- | --- |
| 打开检查面板 | 在右侧栏显示检查结果和操作按钮 |
| 复制为纯文本 | 适合小红书、抖音、朋友圈 |
| 复制为 Markdown | 适合支持 Markdown 的编辑器 |
| 插入或更新落款 | 按当前平台的设置插入或更新文末落款 |

## 边界

- **不代替平台审核**：检查基于规则，不判断内容质量，也不判断是否违规。广告法风险可以配合[发布前合规检查](https://github.com/baocanmou/obsidian-ad-compliance-check)使用。
- **字数限制以平台后台为准**：平台调整规则后，请在设置里更新。
- **图片要手动上传**：复制的文字里不带本地图片，复制后会提示有几张需要在平台后台上传。嵌入的其他笔记不会被展开。
- **不做公众号排版**：样式和配色不在本插件范围内，可以配合专门的公众号排版插件使用。
- **落款更新偏保守**：落款后面有小标题、脚注或较多其他内容时，插件拒绝自动更新，请手动处理。

## 常见问题

**会上传我的稿件吗？**
不会。插件不联网，所有检查和转换在本机完成。

**更新落款会不会误删我的内容？**
更新前会列出将被替换的每一行，你确认后才执行，执行后可以撤销。落款后面有小标题、脚注或较多内容时，插件不会自动更新。

**我的平台不在列表里怎么办？**
可以把它加到最接近的平台的识别名称里，沿用那个平台的设置；目前不支持新增平台。

**为什么字数和平台显示的不一样？**
插件去掉 Markdown 符号和空白后计数，平台对英文、表情和空格的计法可能不同，以平台后台为准。

**手机上能用吗？**
插件没有使用桌面端专有接口，理论上可以在 Obsidian 移动端运行，但目前只在桌面端验证过。

## 版本与更新

当前版本 **0.1.0**。各版本的变化见 [Releases](https://github.com/baocanmou/obsidian-platform-ready-check/releases)。

参与开发：

```bash
npm install
npm run dev    # 监听构建
npm test       # 检查与转换测试
npm run lint
npm run build
```

## 许可与署名

**出品：包参谋 / BaoCanMou**  
**发起与产品方向：易慧庭 / Yi Huiting**

按 [MIT](LICENSE) 开源。

## 包参谋其他开源项目

| 项目 | 做什么 | 国内镜像 |
|---|---|---|
| [发布前合规检查](https://github.com/baocanmou/obsidian-ad-compliance-check) | Obsidian 插件：写作时标出广告法风险表达，给出依据和改法 | [Gitee](https://gitee.com/baocanmou/obsidian-ad-compliance-check) |
| [GEO 写作检查](https://github.com/baocanmou/obsidian-geo-writing-check) | Obsidian 插件：检查文章是否便于 AI 搜索理解和引用 | [Gitee](https://gitee.com/baocanmou/obsidian-geo-writing-check) |
| [餐饮广告语·十法三选](https://github.com/baocanmou/baocanmou-restaurant-slogan) | 按 10 种名家方法各写一条餐饮广告语，比较后推荐 3 条 | [Gitee](https://gitee.com/baocanmou/baocanmou-restaurant-slogan) |
| [策划资料变 PPT](https://github.com/baocanmou/baocanmou-plan-to-ppt) | 把简报和调研做成有来源、可编辑的提案 PPT | [Gitee](https://gitee.com/baocanmou/baocanmou-plan-to-ppt) |
| [GEO 效果优化](https://github.com/baocanmou/bcm-geo-optimizer) | 诊断品牌在 AI 搜索中的提及、引用和推荐，按证据排改进任务 | [Gitee](https://gitee.com/baocanmou/bcm-geo-optimizer) |
| [Open GEO SEO Console](https://github.com/baocanmou/open-geo-seo-console) | 可自行部署的 SEO 与 GEO 监控后台 | [Gitee](https://gitee.com/baocanmou/open-geo-seo-console) |
| [包参谋 AI 技能中心](https://github.com/baocanmou/baocanmou-ai-skill-center) | 盘点本机 AI Skill 并统一连接多种 AI 工具的桌面应用 | [Gitee](https://gitee.com/baocanmou/baocanmou-ai-skill-center) |

## 关于包参谋

包参谋，全称南昌包参谋品牌策划有限公司，2012 年创立于江西南昌，提供品牌定位、Logo/VI 设计、包装设计、品牌空间与传播内容服务，主要服务餐饮、连锁门店、食品快消和地方特色品牌。创始人易慧庭。官网：[www.bcmsj.com](https://www.bcmsj.com)。

我们先定位，后设计。这些开源工具来自我们在实际项目里反复做的工作，我们把判断标准写清楚，让 AI 按同样的标准做事。