john
60 lines
2.8 KiB
Markdown
60 lines
2.8 KiB
Markdown
# 公众号草稿推送格式标准
|
||
|
||
版本：`2026-09-11`（代码常量 `WECHAT_DRAFT_PUBLICATION_STANDARD_VERSION`）
|
||
|
||
本规范随公众号推送能力与 MindSpace 发布链路演进**持续更新完善**；版本号标识当前快照，发现规范缺口或实现偏差时，应同步修订本文档、校验用例与代码常量。
|
||
|
||
## 适用范围
|
||
|
||
所有 MindSpace 页面推送到**用户绑定公众号草稿箱**的流程，包括：
|
||
|
||
- 页面详情「推送到公众号草稿箱」
|
||
- **公开页右下角「公众号」按钮**（页面 owner 登录后可见，服务端注入）
|
||
- 公开页 quick API（`mindspace-chat-wechat-draft.mjs`）
|
||
- 后续新增的页面级草稿推送入口
|
||
|
||
**必须**走 `mindspace-wechat-page-draft.mjs` → `pushPageDraft()`，禁止旁路拼装 HTML 或直接调用微信 draft API。
|
||
|
||
每日新闻早报定时推送（`wechat-news-morning-draft.mjs`）复用同一套底部 layout（阅读原文 + 关注区），栏目正文保持早报专用结构。
|
||
|
||
## 正文 layout（MindSpace 页面）
|
||
|
||
自上而下：
|
||
|
||
1. **Hero 实图**（若有）：与页面 `mindspace-cover.cover` / hero 背景 / 侧车缩略图同源，经 `uploadimg` 上传
|
||
2. **页面正文**：按 profile 转换（诗页 / 散文 / 技能模板 / 通用语义提取）
|
||
3. **阅读原文**：位于正文末尾、关注区之前；有 `publicUrl` 时必须出现。使用虚线引导卡片 + 上下箭头 + 主色按钮（文案仍为「阅读原文」，禁止回退旧版「点击阅读原文」大按钮）
|
||
4. **欢迎关注 TKMind 智趣** + 服务号二维码（约 120px，静态资源 `/assets/mp-follow-qrcode.png`，推送时优先 uploadimg 到微信 CDN）
|
||
|
||
正文超过 `maxContentChars`（20000）时，**先给阅读原文和关注区留额度，再截正文**，禁止先拼再整体 `slice` 把页脚裁掉。公开页失败弹窗必须展示服务端真实原因，不能用「请先登录 MindSpace」兜底掩盖校验失败。
|
||
|
||
## 封面（thumb_media_id）
|
||
|
||
优先级：
|
||
|
||
1. **Hero 位图**（webp/png/jpeg 等，与正文顶部 hero 同源）
|
||
2. `{页面}.thumbnail.png` 侧车图（仅当无 hero 时）
|
||
3. `{页面}.thumbnail.svg` 矢量侧车图（无 PNG 时，推送前转为 PNG）
|
||
4. TKMind 占位图
|
||
|
||
无 AI 生成图时，正文 Hero 与封面均可回退到 PNG/SVG 侧车缩略图。
|
||
|
||
## 校验
|
||
|
||
本地/CI：
|
||
|
||
```bash
|
||
npm run verify:mindspace-wechat-mp
|
||
```
|
||
|
||
核心断言见 `wechat-draft-publication-standard.test.mjs`。
|
||
|
||
## 相关文件
|
||
|
||
| 文件 | 职责 |
|
||
|------|------|
|
||
| `wechat-draft-publication-standard.mjs` | 标准常量 + 合规校验 |
|
||
| `wechat-draft-article-layout.mjs` | 阅读原文 + 底部关注区 |
|
||
| `mindspace-wechat-page-draft.mjs` | 转换、封面上传、`pushPageDraft` |
|
||
| `mindspace-chat-wechat-draft.mjs` | 公开页 quick 推送（委托 `pushPageDraft`） |
|