Skip to content

topmindspace/topmind-writing-skills / topmind-wechat-post

topmind-wechat-post

Verified

创作、整理和排版公众号文章;支持工具/插件推荐结构、产品实测评测、深度解读与叙事随笔,从选题或底稿到 Markdown,按需导出内联 HTML、预览与上传清单。公众号短文用 topmind-briefs,独立改稿用 topmind-revise。

FileKindSize
.gitignoreother31 B
README.en.mdmarkdown2.0 KB
README.mdmarkdown2.2 KB
SKILL.mdskill md5.5 KB
assets/themes/amber-review.jsonconfig979 B
assets/themes/graphite.jsonconfig971 B
assets/themes/md3-business-blue.jsonconfig895 B
assets/themes/minimal-ink.jsonconfig965 B
assets/themes/newsprint.jsonconfig936 B
assets/themes/tech-blue.jsonconfig957 B
examples/01-公众号-整理书架.mdmarkdown1.7 KB
examples/02-公众号-第一次养绿植.mdmarkdown1.8 KB
examples/README.mdmarkdown667 B
knowledge/README.mdmarkdown9.4 KB
knowledge/cards/atlas-local-fix.mdmarkdown781 B
knowledge/cards/brief-news-to-post.mdmarkdown3.0 KB
knowledge/cards/brief-news.mdmarkdown916 B
knowledge/cards/brief-paper.mdmarkdown760 B
knowledge/cards/brief-tools.mdmarkdown617 B
knowledge/cards/brief-value-first.mdmarkdown3.1 KB
knowledge/cards/cover-abstract.mdmarkdown1.3 KB
knowledge/cards/cover-brief.mdmarkdown1.3 KB
knowledge/cards/cover-collage.mdmarkdown1.3 KB
knowledge/cards/cover-color.mdmarkdown1.2 KB
knowledge/cards/cover-culture.mdmarkdown1013 B
knowledge/cards/cover-editorial.mdmarkdown1.2 KB
knowledge/cards/cover-material.mdmarkdown1.3 KB
knowledge/cards/cover-photo.mdmarkdown1.1 KB
knowledge/cards/cover-playful.mdmarkdown1.0 KB
knowledge/cards/cover-scene.mdmarkdown962 B
knowledge/cards/cover-series.mdmarkdown1017 B
knowledge/cards/cover-typography.mdmarkdown1.3 KB
knowledge/cards/creative-choice.mdmarkdown807 B
knowledge/cards/crop-independent.mdmarkdown719 B
knowledge/cards/de-ai-mechanisms.mdmarkdown3.6 KB
knowledge/cards/experience-loop.mdmarkdown801 B
knowledge/cards/format-fidelity.mdmarkdown501 B
knowledge/cards/format-layouts.mdmarkdown502 B
knowledge/cards/poster-paging.mdmarkdown726 B
knowledge/cards/poster-structure.mdmarkdown646 B
knowledge/cards/poster-voices.mdmarkdown530 B
knowledge/cards/reference-reading.mdmarkdown857 B
knowledge/cards/revise-depth.mdmarkdown677 B
knowledge/cards/revise-feedback.mdmarkdown609 B
knowledge/cards/revise-learn-from-edits.mdmarkdown3.1 KB
knowledge/cards/revise-preserve.mdmarkdown788 B
knowledge/cards/viral-mechanisms.mdmarkdown535 B
knowledge/cards/viral-observation.mdmarkdown544 B
knowledge/cards/viral-play-dumb.mdmarkdown2.8 KB
knowledge/cards/viral-replies.mdmarkdown722 B
knowledge/cards/visual-density-and-evidence.mdmarkdown2.8 KB
knowledge/cards/voice-peer-stance.mdmarkdown2.7 KB
knowledge/cards/wechat-decide.mdmarkdown746 B
knowledge/cards/wechat-explain.mdmarkdown820 B
knowledge/cards/wechat-plugin-and-review.mdmarkdown2.5 KB
knowledge/cards/wechat-story.mdmarkdown798 B
knowledge/cards/x-adapt.mdmarkdown643 B
knowledge/cards/x-argument.mdmarkdown770 B
knowledge/cards/x-evidence.mdmarkdown608 B
knowledge/index.jsonconfig39.9 KB
package.jsonmanifest464 B
references/case-notes.mdmarkdown1.9 KB
references/core-voice.mdmarkdown9.9 KB
references/creative-practice.mdmarkdown5.0 KB
references/de-ai-rules.mdmarkdown17.9 KB
references/element-spec.mdmarkdown9.7 KB
references/image-sourcing.mdmarkdown2.7 KB
references/information-design.mdmarkdown5.0 KB
references/knowledge-library.mdmarkdown5.5 KB
references/known-pits.mdmarkdown3.9 KB
references/platform-cover-specs.mdmarkdown7.4 KB
references/platform-operations.mdmarkdown12.2 KB
references/research-mode.mdmarkdown1.6 KB
references/revision-workflow.mdmarkdown5.9 KB
references/social-writing-principles.mdmarkdown7.7 KB
references/theme-map.mdmarkdown6.6 KB
references/typography-rules.mdmarkdown1.6 KB
references/wechat-constraints.mdmarkdown7.2 KB
references/workflow.mdmarkdown6.5 KB
references/workspace.mdmarkdown2.3 KB
references/writing-quality.mdmarkdown2.0 KB
references/x-delivery-contract.mdmarkdown3.6 KB
references/x-post-format.mdmarkdown2.5 KB
scripts/article_scaffold.pyscript5.6 KB
scripts/audit-provenance.pyscript14.9 KB
scripts/audit_css.pyscript1.1 KB
scripts/audit_docs.pyscript3.1 KB
scripts/audit_skill.pyscript3.1 KB
scripts/audit_styles.pyscript1.6 KB
scripts/check_article.pyscript13.9 KB
scripts/count_words.pyscript3.0 KB
scripts/de_ai_lint.pyscript41.5 KB
scripts/info_design_hints.pyscript14.2 KB
scripts/knowledge.pyscript11.8 KB
scripts/lint-wechat.pyscript18.5 KB
scripts/lint_x_post.pyscript20.0 KB
scripts/md2wechat.pyscript83.6 KB
scripts/negative_tests.pyscript24.9 KB
scripts/new-article.pyscript10.3 KB
scripts/package_skill.pyscript6.6 KB
scripts/push-to-topstream.pyscript9.7 KB
scripts/revise_check.pyscript15.2 KB
scripts/scan_ai_flavor.pyscript2.6 KB
scripts/scan_ai_flavor_builtin.pyscript6.5 KB
scripts/sync-mapping.pyscript8.4 KB
scripts/sync-status.pyscript6.9 KB
scripts/wechat_paths.pyscript4.7 KB

references/platform-operations.md

View on GitHub
# 平台操作参考

按需查阅目录、脚本与导出细节。写法与质量判断见 SKILL.md 和共享经验;平台技术限制与审美选择分开处理。

## 封面与图文形态

普通文章宽封面、方形小图、正文头图与公众号图片消息分别处理,见 [平台封面参考](platform-cover-specs.md)。900×383 是本包预设,不是已核实的统一上传限制;宽图、方图、列表与分享预览按当前编辑器检查。

## 脚本(真源)


| 脚本 | 用途 |
|------|------|
| `scripts/new-article.py` | 建文章文件夹:默认调用 `article_scaffold.py` 建新结构;`--legacy` 建旧交付包 |
| `scripts/article_scaffold.py` | (共享脚本)新建 `<文章名>/<文章名>.md` + images/cover/raw/out/参考 + 骨架.md + 素材来源.md(frontmatter 带多环境字段,见 references/workspace.md 第 5 条);已存在就报错,不覆盖 |
| `scripts/check_article.py` | (共享脚本)文章文件夹体检:五项 frontmatter、H1 = title = 文件名、图片存在且编号跟出现顺序一致、无容器 / callout / `![[ ]]`;草稿期占位截图只给 W4、定稿才算错;E 级退出码 1 |
| `scripts/sync-status.py` | 状态 ⇄ 字数(新结构只改 frontmatter;旧交付包保留 `-released` 改名) |
| `scripts/sync-mapping.py` | 映射一致性(frontmatter + 目录 + 可选 notes + topic 总表),新旧结构都认 |
| `scripts/push-to-topstream.py` | 可选回推:公众号稿降级为纯 Markdown notes |
| `scripts/lint-wechat.py` | 排版体检 + 自动修正(中英文间距、段长、AI 腔…);源稿出现 `:::` 报错(旧交付包 `公众号稿.md` 只告警) |
| `scripts/md2wechat.py` | Markdown → 全内联 HTML 到 `out/`;需要内嵌图片时加 `--embed-images`,粘贴后带图需实测;手写小标题序号原样保留 |
| `scripts/de_ai_lint.py` | 去 AI 味检查(公众号稿默认用它):W 警告(W9、W14–W21)+ H 提示(语境词等,只供判断);规则见 `references/de-ai-rules.md` |
| `scripts/lint_x_post.py` | 派生 X 版时检查格式残留与图片占位;文字列表、正文链接和来源默认可保留,链接分离仅在显式选择时检查;去 AI 味部分复用 `de_ai_lint.py`(`--md` 等同 `de_ai_lint.py`) |
| `scripts/count_words.py` | 统一口径字数(改前 / 改后、单段最长) |
| `scripts/revise_check.py` | 改稿保真比对(数字、引语、专名、确定性词)+ 过度改稿检查 |
| `scripts/info_design_hints.py` | (共享脚本)信息设计提示 I1–I9,只供判断;`lint-wechat.py`、`de_ai_lint.py` 也会附带显示 |
| `scripts/scan_ai_flavor.py` | 中文去 AI 味打分入口:默认跑随包 `scan_ai_flavor_builtin.py`(词面分);`$TOPMIND_AI_SCAN` 指向外部扫描脚本时转发过去;`--which` 查实际执行哪份 |
| `scripts/audit-provenance.py` | (共享脚本)**改稿保真审计**:双向逐段溯源(本稿→源稿 / 源稿→本稿),抓悄悄扩写与被落下的段。同构派生稿可用;全面重组时按主张与数字核对 |
| `scripts/wechat_paths.py` | 路径解析模块(被上面脚本导入):不写死个人路径、类别编号与年份 |

```bash
# 路径解析:CLI --base / --workspace → env TOPMIND_WECHAT_BASE / TOPMIND_WORKSPACE;解析不到就报错
export TOPMIND_WORKSPACE=/path/to/workspace   # 推荐
python3 scripts/new-article.py --title "文章名"                 # → <专题>/文章名/文章名.md
python3 scripts/check_article.py <专题>/文章名/
python3 scripts/lint-wechat.py --input <专题>/文章名/文章名.md --fix
python3 scripts/scan_ai_flavor.py <专题>/文章名/文章名.md      # 诊断参考;不设定稿分数门槛
python3 scripts/md2wechat.py --input <专题>/文章名/文章名.md --embed-images   # 按需 → out/
python3 scripts/sync-status.py --set 定稿 <专题>/文章名 --apply  # 只改 frontmatter,目录名不变
```

细节见 [`references/workflow.md`](workflow.md) · [`references/known-pits.md`](known-pits.md)。

## 路径默认

| 用途 | 解析 |
|------|------|
| 文章文件夹的上级(专题目录) | `--base` → `TOPMIND_WECHAT_BASE` → 工作区里按**名称**发现的「长文」类别(兼容旧名「创作」「专题」)+ `{当年}-公众号`;`TOPMIND_WECHAT_CATEGORY` / `TOPMIND_WECHAT_TOPIC` 可覆盖;都解析不到就报错 |
| 工作区 | `--workspace` → `TOPMIND_WORKSPACE` |
| 底稿/回推 | `--topstream` → `TOPSTREAM_ROOT` → 可选;没有则跳过 notes 校验(`push-to-topstream.py` 必须给) |
| 终稿交付 | 可 `save-output` 拷贝到 role:delivery 类别(以 `topmind.yaml` 实际目录为准,如 `88-输出/`),文章文件夹仍留在长文类专题 |

编号和年份都不写死:工作区类别以 `topmind.yaml` 与磁盘实际目录名为准(当前模板为 `00-收件箱 / 10-动态 / 20-长文 / 30-短文 / 40-小说 / 60-参考素材 / 70-已发布 / 88-输出 / 99-归档`,以后改编号也不影响脚本)。

## 三条路径

### forward(底稿 → 公众号)

```
底稿 notes/*.md → 审校改写 → 质量三关 → 定稿 → 排版 → 发布
```

`new-article.py --title "文章名" --direction forward --source-file notes/xxx.md`

### reverse(选题原创)

```
选题包 → 调研素材 → 多轮改稿 → 三关 → 定稿 → 排版 → 发布 →(可选)push-to-topstream
```

`new-article.py --title "文章名"`(reverse 是默认;要对接 topstream 时加 `--source-file`,会写入可选字段 `target_file: pending`)

### 站外拉取(转载整合 / 在线精选站)

源不在本工作区、也不在 topstream `notes/` 时,**仍落 `reverse` + `target_file: pending`**。
**不要用 `forward`**:它要求 `source_file` 以 `notes/` 开头且文件真实存在,站外源必然过不了 `sync-mapping.py`。

```bash
python3 scripts/new-article.py --title "<标题>" --direction reverse
```

取源注意(RSC 载荷、图片 hash 映射、`md5` 去重、截图裁切)见 `references/workflow.md`「站外拉取取源注意」;差异与口径写进文章文件夹的 `素材来源.md`。

**回推规则**:notes 保持纯 Markdown(源稿本来就不用 `:::` 容器;旧交付包里的容器 / 徽章 / `==高亮==` 回推时去掉);回推**务必带 `--assets`**(否则 GitHub 上 `images/` 死链)。命令串见 `references/workflow.md`「收尾」。

## 文章文件夹与状态

```text
<文章名>/                        # 文件夹名 = 文章名,不随状态改
├── <文章名>.md                  # 唯一源稿,唯一改稿入口
├── images/                      # 01-xxx.png、02-xxx.png…,按正文出现顺序编号
├── cover/                       # 封面
├── 素材来源.md                  # 私有:图源、承重事实来源、未核实条目
├── raw/                         # 原始素材(不发布);改稿备份放 raw/备份-<时间戳>/
└── out/                         # 按需生成,可随时重建,不手改
    ├── <文章名>-公众号版.html   # 浏览器打开 → 复制正文 → 粘贴后台
    ├── 图片上传清单.md  images/
    └── 改稿报告.md              # topmind-revise 的完整报告
```

**frontmatter(固定五项 + 可选字段)**

```yaml
title: 文章名           # = H1 = 文件名(check_article.py 校验)
date: 2026-10-18
status: 草稿            # 草稿 | 定稿 | 已发布
tags: [AI, Agent]
cover: cover/cover-1500x600.png   # 草稿期封面还没做 → check_article W5;定稿时 → E7
subtitle: 从一个插件被下架说起    # 可选:副标题,md2wechat 写进图片上传清单的「摘要」,正文不重复;留空即可
# 以下为可选字段:对接 topstream 时才写,有就维护,没有不报错
direction: reverse      # forward | reverse
source_file: ""         # forward 填 notes/xxx.md
target_file: pending    # reverse:pending | notes/xxx.md
word_count: 0           # 纯中文字数,sync-status 维护
```

**交付**:发布/分享时直接用 `out/` 里的 HTML 原文件原样呈现,
不临时重新生成版本;`<文章名>.md` 是唯一改稿入口,改稿后重建 `out/` 再交付。

状态**不要手改目录名**,用脚本改 frontmatter:

```bash
python3 scripts/sync-status.py --set 定稿 <专题>/<文章名> --apply
```

**旧交付包(只读兼容,不自动迁移)**:`YYYY-MM-DD-<短名>[-released]/公众号稿.md` 照旧能
lint、排版、同步状态(`-released` 改名逻辑只对旧包生效);`new-article.py --legacy` 仍能建旧包。

## 排版与导出(必读)

用户要公众号版时才跑(产物缺省进 `<文章名>/out/`,`--slug` 缺省文件名,`--asset-root` 缺省文章文件夹):

```bash
python3 scripts/md2wechat.py --input <文章名>/<文章名>.md --embed-images --preview \
  [--theme assets/themes/minimal-ink.json]
# 旧交付包:--input <包>/公众号稿.md --out-dir <包> --slug <slug> --asset-root <素材根>
```

1. **永远 `--embed-images`**,否则粘贴丢图(相对路径被序列化成 file://)
   **图文预览(交付前必做)**:`--preview` 用无头 Chrome 把页面按手机宽度截成 `out/预览.png`;交付前自己先看一遍(图序、图注、列表、表格),交付说明里附上预览图。没有 Chrome 时脚本会提示,改用浏览器打开 HTML 自己看。
2. **图片 basename 一致(硬约束)**:正文引用名 = `images/` 目标名;禁止两套同名图共处
3. 合规自检出现 `✗` 改生成器,不要手改 HTML
4. **配图位置**:图片必须紧跟它证明的那段文字
   (最多隔一段);改稿移动段落时图片行一起搬。构建后必跑:嵌入图数量=文档图数量、
   嵌入图顺序=文档出现顺序(逐张解码与源文件比对);每张图前后 6 行做主题关键词
   邻近检查,不通过则人工核对。
5. **双版一致性校验**:同一选题出 X 版后,
   核对 X 与公众号内嵌图的内容、映射与顺序;有压缩、重采样或平台裁切时不要求字节或像素完全相同,实际内容差异需说明。
   两版都直接读同一份 `<文章名>.md` 的 `![]()`,禁止手工拼 `--images`
   (曾因文件名排序 ≠ 文档顺序,导致 X 版从某一节起整段配图错位);`check_article.py` 校验编号跟出现顺序一致。

已知问题清单:[`references/known-pits.md`](known-pits.md)。

## 主题

| 文件 | 风格 | 适用 |
|------|------|------|
| `assets/themes/md3-business-blue.json`(默认) | MD3 商务蓝:Material Design 3 设计语言,大圆角,tonal 配色 | 通用 / 商务 / AI 技术 |
| `assets/themes/minimal-ink.json` | 黑白灰 + 砖红 | 深度研析 / 观点 / 随笔 |
| `assets/themes/tech-blue.json` | 科技蓝 | AI/技术 |
| `assets/themes/newsprint.json` | 报纸衬线 | 人文评论 |
| `assets/themes/graphite.json` | 石墨克制 | 严肃报告 |
| `assets/themes/amber-review.json` | 琥珀评测 | 产品评测 |

`md2wechat.py --list-themes` 看全部;`--theme genre:评测` 可按题材自动选。
渲染规格见 [`references/element-spec.md`](element-spec.md) · 主题映射见 [`references/theme-map.md`](theme-map.md)。

**本包保守兼容策略**(平台行为变化时实际验证;详见 [`references/wechat-constraints.md`](wechat-constraints.md)):禁 `div`/`pre`/`h1`/`figure`/`thead`/flex/float/gradient/shadow;表格 `table-layout` 不写 fixed;列数 ≥4 转卡片。

## 与 Desktop「公众号创作」

topmind Desktop 的「公众号创作」插件是本技能的可视化工作流伴面(若有):包列表 → 改稿 → 三关 → 预览 → 导出。导出时它优先调用本技能的 `scripts/md2wechat.py`,脚本语义以本技能为准。本技能已取代 topmind-skills 包里旧的 `topmind-wechat`(4.15.2 起删除)。

## 外部依赖

无必需的外部技能。去 AI 味规则与检查随包自带(`references/core-voice.md`、`references/de-ai-rules.md`、`scripts/de_ai_lint.py`、`scripts/scan_ai_flavor.py`);推荐同时安装 `topmind-revise` 执行质量三关,没装时按随包的 `references/revision-workflow.md` 手动走;
想接入自己的扫描脚本时设 `$TOPMIND_AI_SCAN=/path/to/script.py`,参数与退出码原样转发。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall