topmindspace/topmind-writing-skills / topmind-wechat-post
topmind-wechat-post
Verified创作、整理和排版公众号文章;支持工具/插件推荐结构、产品实测评测、深度解读与叙事随笔,从选题或底稿到 Markdown,按需导出内联 HTML、预览与上传清单。公众号短文用 topmind-briefs,独立改稿用 topmind-revise。
references/known-pits.md
View on GitHub# 已知问题(实测出现过,写入质检与操作纪律)
## 1. `--embed-images` 不加 = 粘贴丢图
链路:HTML `src="images/xx.png"` → 浏览器复制序列化成 `file://` → 公众号后台取不到 → **整张 `<img>` 消失**(不是裂图)。
**修法**:`md2wechat.py --embed-images`(base64 内嵌)。`images/` 仍导出作占位符兜底。
自检:
```bash
grep -c 'src="images/' <包>/*-公众号版.html # 期望 0
grep -c 'src="data:image/' <包>/*-公众号版.html # 期望 = 正文图数
```
## 2. 图片 basename 撞名 → 链式全挂
`resolve_image()` 按 **basename** 复制到 `images/`。`images/bare/01.png` 与 `images/01.png` 同名 → 产出 `01-1.png` → 删副本 = HTML 图全挂。
**怎么避免**:
- 正文只引用 `images/XX.png`,包内只放正文那一套
- 多套用不同前缀(`full-` / `bare-`),不要靠子目录区分
- `-1` 副本不是垃圾,是 HTML 正在引用的文件
自检:
```bash
find <包> -name "*-1.*" # 不应有任何结果
```
## 3. 同一文件并行 Edit 只落盘一部分
同一条消息多个 Edit:工具可能都回 Successfully,**只有部分落盘**。
**纪律**:改完必须 `grep` 关键词复核;多处改动合成一个脚本一次写完,或串行分轮。
## 4. `::: stat` 非管道行被静默丢弃(旧交付包)
容器内每行必须 `数值 | 说明`。不带 `|` 的行整块消失且无报错。生成 HTML 后抽查容器内容。
## 5. 表格单元格 `|` 要转义
生成 markdown 表时 `.replace(/\|/g, '\\|')`。JS 模板字符串里写 `\\\\|` 才得到 `\\|`。
## 6. 代码块长行被 `break-all` 词中切断
JSON 示例行宽压到 ~55 字符;真实节选注明「节选」,字段值不得改写。
## 7. 图文两套同名 + 清理 `bare/`
完整版与纯图形版共处包内必撞名。完整版放研究层;交付包只留正文用的一套。
## 8. 外部工具改稿的数字漂移
「比值对但绝对值错」= 从别的口径倒推。先脚本回溯 `results/*.json`,再改文字。
## 9. 表格手抄必漂移
从数据源生成(脚本直出)。同一文档两份拷贝时 `md5` 比对;派生汇总字段也是数据,要回填。
## 10. 去 AI 味扫描误报别改坏
「排比三段式」可能误报数据变化(从 A 到 B)→ **保留**;专有名词「复盘」→ 不改。
## 11. 满分仍「太 AI」
词面 100 分只证明无套话。再查四症状:段末金句癖 / 节奏过分整齐 / 没有「我」与场景 / 报告体标注。改写手法见 `writing-quality.md`。动词套话的「复盘」要改,专有名词的「复盘」不改。
## 12. 加「人味」用力过猛
社交垫词(「先说个好消息」「说白了」)不是人味。判据:删掉后读者少知道了什么?
## 13. 长文零视觉锚点 = 视觉窒息
源稿不再用容器(单源 Markdown),视觉锚点靠原图、数据图、加粗短句、引用块:每 1500–2500 字至少一处。8000 字纯段落是反面教材。
## 14. 复制依赖 `execCommand`
Safari 可能失败 → 手动全选复制。Desktop/移动端提供按钮 + 失败提示。
## 15. 合规自检误报
- 正文 `<h2>` 是有意设计(不用 h1)
- `pre` 会命中英文单词;只在 `<article>` 内按标签形式匹配
## 16. 手写序号又开 `--auto-number` = 重号
`--auto-number` 会剥掉手写序号再统一编号;默认模式下手写「一、」原样保留。部分标题写序号、部分不写时,手写的那几节会和自动编号对不上——要么全写,要么全不写。
## 17. 新旧结构混放
同一专题里新结构 `<文章名>/<文章名>.md` 和旧交付包 `YYYY-MM-DD-名/公众号稿.md` 可以共存,`sync-status.py` / `sync-mapping.py` 都认;但旧包不会被自动迁移,也不要手工把 `公众号稿.md` 改名塞进新结构(frontmatter 字段、图片编号都要按 `check_article.py` 重新过一遍)。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |